acl_get_perm_np(3)

acl_get_perm_np3

Check if a permission is set in a permission set

Usage

#include <sys/types.h>

#include <sys/acl.h>

int

acl_get_perm_np(acl_permset_t permset_d, acl_perm_t perm);

Library

Standard C Library (libc, -lc)

Overview

The acl_get_perm_np() function is a non-portable function that checks if a permission is set in a permission set.

Return values

If the permission in perm is set in the permission set permset_d, a value of 1 is returned, otherwise a value of 0 is returned.

Errors

If any of the following conditions occur, the acl_get_perm_np() function will return a value of -1 and set global variable errno to the corresponding value:

[EINVAL]

Argument perm does not contain a valid ACL permission or argument permset_d is not a valid ACL permset.

Releases

56 releases since FreeBSD 5.0-RELEASE; the text changed 33 times.

  1. 5.0
  2. 5.1–6.3
  3. 6.4
  4. 7.0
  5. 7.1
  6. 7.2
  7. 7.3
  8. 7.4
  9. 8.0
  10. 8.1
  11. 8.2
  12. 8.3
  13. 8.4
  14. 9.0
  15. 9.1
  16. 9.2
  17. 9.3
  18. 10.0
  19. 10.1
  20. 10.2
  21. 10.3
  22. 10.4
  23. 11.0
  24. 11.1
  25. 11.2
  26. 11.3
  27. 11.4
  28. 12.0
  29. 12.1
  30. 12.2
  31. 12.3
  32. 12.4
  33. 13.0–13.2
  34. 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_get_perm_np() function was added in FreeBSD 5.0.

Authors

The acl_get_perm_np() function was written by Chris D. Faulhaber ⟨[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.