Manual Page Result
0
Command: acl_extended_file_np | Section: 3 | Source: FreeBSD | File: acl_extended_file_np.3.gz
ACL_EXTENDED_FILE_NP(3) FreeBSD Library Functions Manual
NAME
acl_extended_file_np, acl_extended_file_nofollow_np, acl_extended_link_np
- checks if the file has extended ACLs set
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
int
acl_extended_file_np(const char* path_p);
int
acl_extended_file_nofollow_np(const char* path_p);
int
acl_extended_link_np(const char* path_p);
DESCRIPTION
The acl_extended_file_np() function is a non-portable call that checks if
the file or directory referred to by the argument path_p contains
extended access ACLs. The acl_extended_file_nofollow_np() function works
the same way, except it does not follow symlinks. The
acl_extended_link_np() function is a synonim to
acl_extended_file_nofollow_np() named in FreeBSD style. An ACL is
considered to be extended access one if it contains entries other than
the three required entries of tag types ACL_USER_OBJ, ACL_GROUP_OBJ and
ACL_OTHER.
RETURN VALUES
Upon successful completion, this function returns 0 if the file object
does not contain extended access ACLs and 1 in the other case.
Otherwise, the value -1 is returned, and errno indicates the error.
ERRORS
If any of the following conditions occur, the acl_extended_file_np()
function shall return a value of -1 and set errno to the corresponding
value:
[EACCES] Search permission is denied for a component of the
path prefix.
SEE ALSO
extattr_get_file(2), posix1e(3)
STANDARDS
POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion of the draft
continues on the cross-platform POSIX.1e implementation mailing list. To
join this list, see the FreeBSD POSIX.1e implementation page for more
information.
HISTORY
POSIX.1e support was introduced in FreeBSD 4.0, and development
continues.
AUTHORS
Gleb Popov
FreeBSD 14.1-RELEASE-p8 February 26, 2021 FreeBSD 14.1-RELEASE-p8