Click this button to go to the index for this section.

acl_get_fd(3)
NAME
  acl_get_fd - Retrieves the specified ACL associated with the specified
  object

LIBRARY
  Security Library (libpacl.a)

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

PARAMETERS
  fd	    Designates the file descriptor of the object to retrieve the
	    working storage internal representation copy of the ACL from.

  type_d    Designates the type of ACL to retrieve: ACL_TYPE_ACCESS,
	    ACL_TYPE_DEFAULT, or ACL_TYPE_DEFAULT_DIR.

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.

  The acl_get_fd() function retrieves an ACL for the given descriptor.	The
  acl_tag_t field designates if the ACL being retrieved is an access or
  default ACL.	Working storage is allocated as needed.

RETURN VALUES
  Upon successful completion, the acl_get_fd() function returns a pointer to
  the working storage internal representation copy of the ACL.	Otherwise, a
  value of NULL is returned and errno is set to indicate the error.

ERRORS
  If any of the following conditions occur, the acl_get_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 argument type_d is not a recognized ACL type.

  [ENOMEM]	 There is not enough memory available to the process to
		 allocate the working storage.

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




RELATED INFORMATION
  acl_get_file(3), acl_set_file(3), acl_set_fd(3),

  Security