acl_cmp(3) — Linux manual page

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | STANDARDS | SEE ALSO | AUTHOR | COLOPHON

ACL_CMP(3)               Library Functions Manual             ACL_CMP(3)

NAME         top

       acl_cmp — compare two ACLs

LIBRARY         top

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

SYNOPSIS         top

       <sys/types.h> <acl/libacl.h> int acl_cmp(acl_t acl1, acl_t acl2)

DESCRIPTION         top

       The acl_cmp() function compares the ACLs pointed to by the
       arguments acl1 and acl2 for equality. The two ACLs are considered
       equal if for each entry in acl1 there is an entry in acl2 with
       matching tag type, qualifier, and permissions, and vice versa.

RETURN VALUE         top

       If successful, the acl_cmp() function returns 0 if the two ACLs
       acl1 and acl2 are equal, and 1 if they differ. 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_cmp() function
       returns -1 and sets errno to the corresponding value:

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

                          The argument acl2 is not a valid pointer to an
                          ACL.

STANDARDS         top

       This is a non-portable, Linux specific extension to the ACL
       manipulation functions defined in IEEE Std 1003.1e draft 17
       (“POSIX.1e”, abandoned).

SEE ALSO         top

       acl(5)

AUTHOR         top

       Written by Andreas Gruenbacher <andreas.gruenbacher@gmail.com>.

COLOPHON         top

       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 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
       man-pages@man7.org

Linux ACL                    March 23, 2002                   ACL_CMP(3)