acl_extended_file_np3
Checks if the file has extended acls set
Usage
#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);
Library
Standard C Library (libc, -lc)
Overview
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.
Releases
9 releases since FreeBSD 14.0-RELEASE; the text changed 1 time.