NAME

acl_set_fd − Sets the ACL on the object designated by the file descriptor

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> int acl_set_fd(
int fd;
acl_type_t type_d;
acl_t acl_d);

PARAMETERS

fdRefers to the open file descriptor of the file or directory to set the ACL on. 

type_dDesignates the type of ACL to set: ACL_TYPE_ACCESS, ACL_TYPE_DEFAULT, or ACL_TYPE_DEFAULT_DIR. 

acl_dWorking storage internal representation of the ACL that is being set. 

DESCRIPTION

NOTE:  This function is based on Draft 13 of the POSIX P1003.6 standard. The function may change as the P1003.6 standard is finalized. 

Given a file descriptor to an object, the acl_set_fd() function sets the designated ACL. The type of ACL being set is determined by the acl_tag_t parameter.  If acl_d is NULL then the designated ACL will be removed from the designated object. 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:

[EACCES]The required access to the file was denied. 

[EBADF]The fd argument is not a valid file descriptor. 

[EINVAL]The acl_d argument does not contain a valid ACL.  Argument type_d does not contain a valid ACL type number. 

[ENOSPC]The directory or file system that would contain the new ACL cannot be extended or the file system is out of file allocation resources. 

[ENOTDIR]The argument type_d indicates a default ACL, and fd does not point to a directory object. 

[ENOTSUP]The designated object resides on a file system that does not support ACLs

[EPERM]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.

[EPERM]The designated object resides on a read-only file system. 

RELATED INFORMATION

acl_get_fd(3),acl_valid(3), acl_set_file(3)

Security