acl_set_fd - Sets the ACL on the file or directory designated
by the file descriptor
acl_t acl_d );
Security Library (libpacl.a)
Refers to the open file descriptor of the file or directory
to set the ACL on. Designates the type of ACL to
set: ACL_TYPE_ACCESS, ACL_TYPE_DEFAULT, or
ACL_TYPE_DEFAULT_DIR. Working storage internal representation
of the ACL that is being set.
NOTE: This function is based on Draft 13 of the POSIX
Given a file descriptor to a file or directory, the
acl_set_fd() function sets the designated ACL. The type of
ACL being set is determined by the type_d parameter. If
acl_d is NULL then the designated ACL is removed from the
designated file or directory. The entry pointer used by
the acl_get_entry() function becomes undefined after a
call to the acl_set_fd() function.
Upon successful completion, the acl_set_fd() function
returns a value of 0 (zero). Otherwise, a value of -1 is
returned and errno is set to indicate the error.
If any of the following conditions occur, the acl_set_fd()
function sets errno to the corresponding value:
The required access to the file was denied. The fd argument
is not a valid file descriptor. The acl_d argument
does not contain a valid ACL. Argument type_d does not
contain a valid ACL type number. The directory or file
system that would contain the new ACL cannot be extended
or the file system is out of file allocation resources.
The argument type_d indicates a default ACL, and fd does
not point to a directory. The designated file or directory
resides on a file system that does not support ACLs.
The process does not have the appropriate permissions to
perform the operation. The setting and changing of ACLs
have been disabled by the system administrator. The designated
file or directory resides on a read-only file system.
acl_get_fd(3), acl_valid(3), acl_set_file(3)
[ Back ]