Manual Pages  — ACL_ADD_FLAG_NP

acl_add_flag_np – add flags to a flagset

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO STANDARDS HISTORY AUTHORS

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <sys/acl.h>

int
acl_add_flag_np(acl_flagset_t flagset_d, acl_flag_t flag);

The acl_add_flag_np() function is a non-portable call that adds the NFSv4 ACL flags contained in flags to the flagset flagset_d.

Note: it is not considered an error to attempt to add flags that already exist in the flagset.

Valid values are:

ACL_ENTRY_FILE_INHERIT	Will be inherited by files.
ACL_ENTRY_DIRECTORY_INHERIT	Will be inherited by directories.
ACL_ENTRY_NO_PROPAGATE_INHERIT	Will not propagate.
ACL_ENTRY_INHERIT_ONLY	Inherit-only.
ACL_ENTRY_INHERITED	Inherited from parent

The acl_add_flag_np function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

The acl_add_flag_np() function fails if:

[EINVAL]
	Argument flagset_d is not a valid descriptor for a flagset within an ACL entry. Argument flag does not contain a valid acl_flag_t value.

POSIX.1e is described in IEEE POSIX.1e draft 17.

POSIX.1e support was introduced in FreeBSD 4.0 . The acl_add_flag_np() function was added in FreeBSD 8.0 .

The acl_add_flag_np() function was written by Edward Tomasz Napierala <Mt trasz@FreeBSD.org>.