Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for acl_get_fd (redhat section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

ACL_GET_FD(3)			   BSD Library Functions Manual 		    ACL_GET_FD(3)

     acl_get_fd -- get an ACL by file descriptor

     Linux Access Control Lists library (libacl, -lacl).

     #include <sys/types.h>
     #include <sys/acl.h>

     acl_get_fd(int fd);

     The acl_get_fd() function retrieves the access ACL associated with the file referred to by
     fd.  The ACL is placed into working storage and acl_get_fd() returns a pointer to that stor-

     In order to read an ACL from an object, a process must have read access to the object's

     This function may cause memory to be allocated.  The caller should free any releasable mem-
     ory, when the new ACL is no longer required, by calling acl_free(3) with the (void*)acl_t
     returned by acl_get_fd() as an argument.

     Upon successful completion, this function shall return a pointer to the working storage.
     Otherwise, a value of (acl_t)NULL shall be returned, and errno shall be set to indicate the

     If any of the following conditions occur, the acl_get_fd() function returns a value of
     (acl_t)NULL and sets errno to the corresponding value:

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

     [ENOMEM]		The ACL working storage requires more memory than is allowed by the hard-
			ware or system-imposed memory management constraints.

     [ENOTSUP]		The file system on which the file identified by fd is located does not
			support ACLs, or ACLs are disabled.

     IEEE Std 1003.1e draft 17 ("POSIX.1e", abandoned)

     acl_free(3), acl_get_entry(3), acl_get_file(3), acl_set_fd(3), acl(5)

     Derived from the FreeBSD manual pages written by Robert N M Watson <rwatson@FreeBSD.org>,
     and adapted for Linux by Andreas Gruenbacher <a.gruenbacher@computer.org>.

Linux ACL				  March 23, 2002				Linux ACL
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 02:45 AM.