acl_set_fd(3)acl_set_fd(3)NAMEacl_set_fd - Sets the ACL on the file or directory designated by the
file descriptor
SYNOPSIS
#include <sys/acl.h>
int acl_set_fd(
int fd,
acl_type_t type_d,
acl_t acl_d );
LIBRARY
Security Library (libpacl.a)
PARAMETERS
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.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan‐
dard.
Given a file descriptor to a file or directory, the acl_set_fd() func‐
tion 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.
RETURN VALUES
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.
ERRORS
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.
SEE ALSOacl_get_fd(3), acl_valid(3), acl_set_file(3)
Security
acl_set_fd(3)