acl_add_flag_np(3)

acl_add_flag_np3

Add flags to a flagset

Usage

#include <sys/types.h>

#include <sys/acl.h>

int

acl_add_flag_np(acl_flagset_t flagset_d, acl_flag_t flag);

Library

Standard C Library (libc, -lc)

Overview

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_INHERITWill be inherited by files.
ACL_ENTRY_DIRECTORY_INHERITWill be inherited by directories.
ACL_ENTRY_NO_PROPAGATE_INHERITWill not propagate.
ACL_ENTRY_INHERIT_ONLYInherit-only.
ACL_ENTRY_INHERITEDInherited from parent

Return values

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.

Errors

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.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 25 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0–13.2
  26. 13.3–16.0

Standards

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

History

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

Authors

The acl_add_flag_np() function was written by Edward Tomasz Napierala ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.