acl_delete_entry_np(3)

acl_delete_entry_np3

Delete an acl entry from an acl

Part of acl_delete_entry(3).

Usage

#include <sys/types.h>

#include <sys/acl.h>

int

acl_delete_entry(acl_t acl, acl_entry_t entry_d);

int

acl_delete_entry_np(acl_t acl, int index);

Library

Standard C Library (libc, -lc)

Overview

The acl_delete_entry() function is a POSIX.1e call that removes the ACL entry entry_d from ACL acl. The acl_delete_entry_np() function is a non-portable version that removes the ACL entry at position index from ACL acl. Positions are numbered starting from zero, i.e. calling acl_delete_entry_np() with index argument equal to zero will remove the first ACL entry.

Return values

The acl_delete_entry() 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_entry() function fails if:

[EINVAL]

Argument acl does not point to a valid ACL. Argument entry_d is not a valid descriptor for an ACL entry in acl. Argument index is out of bounds.

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_delete_entry() function was added in FreeBSD 5.0.

Authors

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