Reference

acl_delete(3)

delete an ACL from a file

NAME

acl_delete_fd_np, acl_delete_file_np acl_delete_link_np – delete an ACL from a file

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <sys/types.h>

#include <sys/acl.h>

int

acl_delete_fd_np(int filedes, acl_type_t type);

int

acl_delete_file_np(const char *path_p, acl_type_t type);

int

acl_delete_link_np(const char *path_p, acl_type_t type);

DESCRIPTION

The acl_delete_fd_np(), acl_delete_file_np(), and acl_delete_link_np() each allow the deletion of an ACL from a file. These functions are non-portable extensions that permit the deletion of arbitrary ACL types from a file/directory either by path name or file descriptor. The _file() variations follow a symlink if it occurs in the last segment of the path name; the _link() variations operate on the symlink itself.

RETURN VALUES

The acl_delete_fd_np() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

ERRORS

If any of the following conditions occur, these functions shall return -1 and set errno to the corresponding value:

[EACCES]

Search permission is denied for a component of the path prefix, or the object exists and the process does not have appropriate access rights.

[EBADF]

The fd argument is not a valid file descriptor.

[EINVAL]

The ACL type passed is invalid for this file object.

[ENAMETOOLONG]

A component of a pathname exceeded 255 characters, or an entire path name exceeded 1023 characters.

[ENOENT]

The named object does not exist, or the path_p argument points to an empty string.

[ENOMEM]

Insufficient memory available to fulfill request.

[ENOTDIR]

A component of the path prefix is not a directory.

Argument path_p must be a directory, and is not.

[EOPNOTSUPP]

The file system does not support ACL deletion.

[EPERM]

The process does not have appropriate privilege to perform the operation to delete an ACL.

[EROFS]

The file system is read-only.

SEE ALSO

acl(3), acl_get(3), acl_set(3), posix1e(3)

STANDARDS

POSIX.1e is described in IEEE POSIX.1e draft 17.

AUTHORS

Michael Smith Robert N M Watson