acl_delete_perm(3)

acl_delete_perm3

Delete permissions from a permission set

Usage

#include <sys/types.h>

#include <sys/acl.h>

int

acl_delete_perm(acl_permset_t permset_d, acl_perm_t perm);

Library

Standard C Library (libc, -lc)

Overview

The acl_delete_perm() function is a POSIX.1e call that removes specific permissions from permissions set perm.

Return values

The acl_delete_perm() 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_delete_perm() function fails if:

[EINVAL]

Argument permset_d is not a valid descriptor for a permission set. Argument perm does not contain a valid acl_perm_t value.

Releases

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

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

Authors

The acl_delete_perm() 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.