NAME
acl_delete_entry, acl_delete_entry_np – delete an ACL entry from an ACL
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#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);
DESCRIPTION
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.
SEE ALSO
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]⟩.