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 |