acl_delete_entry(3) — Linux manual page


ACL_DELETE_ENTRY(3)      Library Functions Manual    ACL_DELETE_ENTRY(3)

NAME         top

       acl_delete_entry — delete an ACL entry

LIBRARY         top

       Linux Access Control Lists library (libacl, -lacl).

SYNOPSIS         top

       <sys/types.h> <sys/acl.h> int acl_delete_entry(acl_t acl,
       acl_entry_t entry_d)

DESCRIPTION         top

       The acl_delete_entry() function removes the ACL entry indicated
       by the entry_d descriptor from the ACL pointed to by acl.  Any
       existing ACL entry descriptors that refer to entries in acl other
       than that referred to by entry_d continue to refer to the same
       entries. The argument entry_d and any other ACL entry descriptors
       that refer to the same ACL entry are undefined after this
       function completes. Any existing ACL pointers that refer to the
       ACL referred to by acl continue to refer to the ACL.

RETURN VALUE         top

       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         top

       If any of the following conditions occur, the acl_delete_entry()
       function returns -1 and sets errno to the corresponding value:

       [EINVAL]           The argument acl_p is not a valid pointer to
                          an ACL.

                          The argument entry_d is not a valid pointer to
                          an ACL entry.

STANDARDS         top

       IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)

SEE ALSO         top

       acl_copy_entry(3), acl_create_entry(3), acl_get_entry(3), acl(5)

AUTHOR         top

       Derived from the FreeBSD manual pages written by Robert N M
       Watson <>, and adapted for Linux by Andreas
       Gruenbacher <>.

COLOPHON         top

       This page is part of the acl (manipulating access control lists)
       project.  Information about the project can be found at  If you have a bug
       report for this manual page, see
       ⟨⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨git://⟩ on 2023-12-22.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-12-01.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

Linux ACL                    March 23, 2002          ACL_DELETE_ENTRY(3)