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.

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 <jedgar@fxp.org>.