| ACL_GET(3) | Library Functions Manual | ACL_GET(3) | 
acl_get_fd, acl_get_fd_np,
  acl_get_file, acl_get_link_np
  —
#include <sys/types.h>
#include <sys/acl.h>
acl_t
  
  acl_get_fd(int
    fd);
acl_t
  
  acl_get_fd_np(int
    fd, acl_type_t
    type);
acl_t
  
  acl_get_file(const
    char *path_p, acl_type_t
    type);
acl_t
  
  acl_get_link_np(const
    char *path_p, acl_type_t
    type);
acl_get_fd(),
  acl_get_file(),
  acl_get_link_np(), and
  acl_get_fd_np() each allow the retrieval of an ACL
  from a file. The acl_get_fd() is a POSIX.1e call that
  allows the retrieval of an ACL of type ACL_TYPE_ACCESS from a file descriptor.
  The acl_get_fd_np() function is a non-portable form of
  acl_get_fd() that allows the retrieval of any type of
  ACL from a file descriptor. The acl_get_file()
  function is a POSIX.1e call that allows the retrieval of a specified type of
  ACL from a file by name; acl_get_link_np() is a
  non-portable variation on acl_get_file() which does
  not follow a symlink if the target of the call is a symlink.
These functions may cause memory to be allocated. The caller should free any releasable memory, when the new ACL is no longer required, by calling acl_free(3) with the (void *)acl_t as an argument.
The ACL in the working storage is an independent copy of the ACL associated with the object referred to by fd. The ACL in the working storage shall not participate in any access control decisions.
Valid values for the type argument are:
| ACL_TYPE_ACCESS | POSIX.1e access ACL | 
| ACL_TYPE_DEFAULT | POSIX.1e default ACL | 
| ACL_TYPE_NFS4 | NFSv4 ACL | 
The ACL returned will be branded accordingly.
acl_get_fd() function shall return a value of
  (acl_t)NULL and set errno to the
  corresponding value:
EACCES]EBADF]EINVAL]ENAMETOOLONG]ENOENT]ENOMEM]EOPNOTSUPP]| June 25, 2009 | NetBSD 10.0 |