Index for Section 3

Alphabetical listing for A

Bottom of page

acl_get_file(3)
NAME
  acl_get_file - Given the pathname to a file or directory, retrieve the
  designated ACL

SYNOPSIS
  #include <sys/acl.h>

  acl_t acl_get_file(
	  char *path_p,
	  acl_type_t type_d );

LIBRARY
  Security Library (libpacl.a)

PARAMETERS
  path_p
      Designates the pathname to retrieve 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 acl_get_file() function retrieves the designated ACL via a pathname.
  The type of ACL being retrieved is designated in acl_type_t. Working system
  storage is allocated as needed.

RETURN VALUES
  Upon successful completion, the acl_get_file() function returns a pointer
  to the working storage internal representation copy of the ACL. If the
  specified ACL type is ACL_TYPE_DEFAULT or ACL_TYPE_DEFAULT_DIR and the
  specified ACL doesn't exist for the given file descriptor a value of NULL
  is returned.	If the specified ACL type is ACL_TYPE_ACCESS and the given
  file descriptor doesn't have an access ACL a pointer to the working storage
  internal representation copy of the permission bits in ACL format is
  returned. 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_file() function sets
  errno to the corresponding value:

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

  [EINVAL]
      The type_d argument is not a recognized ACL type.

  [ENAMETOOLONG]
      The path name is longer than allowed.

  [ENOENT]
      The object does not exist.

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

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

SEE ALSO
  acl_set_file(3), acl_get_entry(3), acl_get_file(3), acl_set_fd(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page