acl_delete_entry(3) — Linux manual page

ACL_DELETE_ENTRY(3)      Library Functions Manual    ACL_DELETE_ENTRY(3)

NAME

       acl_delete_entry — delete an ACL entry

LIBRARY

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

SYNOPSIS

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

DESCRIPTION

       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

       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

       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

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

SEE ALSO

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

AUTHOR

       Derived from the FreeBSD manual pages written by Robert N M
       Watson <rwatson@FreeBSD.org>, and adapted for Linux by Andreas
       Gruenbacher <andreas.gruenbacher@gmail.com>.

COLOPHON

       This page is part of the acl (manipulating access control lists)
       project.  Information about the project can be found at
       http://savannah.nongnu.org/projects/acl.  If you have a bug
       report for this manual page, see
       ⟨http://savannah.nongnu.org/bugs/?group=acl⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨git://git.savannah.nongnu.org/acl.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-04-25.)  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
       man-pages@man7.org

Linux ACL                    March 23, 2002          ACL_DELETE_ENTRY(3)