NAME    [Toc]    [Back]

       acl_set_fd  - Sets the ACL on the file or directory designated
 by the file descriptor

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       int acl_set_fd(
               int fd,
               acl_type_t type_d,
               acl_t acl_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       NOTE:  This function is based on Draft  13  of  the  POSIX
       P1003.6 standard.

       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.

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

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

       Security



                                                    acl_set_fd(3)