acl_cmp(3)

1ACL_CMP(3)               BSD Library Functions Manual               ACL_CMP(3)
2

NAME

4     acl_cmp — compare two ACLs
5

LIBRARY

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

SYNOPSIS

10     #include <sys/types.h>
11     #include <acl/libacl.h>
12
13     int
14     acl_cmp(acl_t acl1, acl_t acl2);
15

DESCRIPTION

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

RETURN VALUE

23     If successful, the acl_cmp() function returns 0 if the two ACLs acl1 and
24     acl2 are equal, and 1 if they differ. Otherwise, the value -1 is returned
25     and the global variable errno is set to indicate the error.
26

ERRORS

28     If any of the following conditions occur, the acl_cmp() function returns
29     -1 and sets errno to the corresponding value:
30
31     [EINVAL]           The argument acl1 is not a valid pointer to an ACL.
32
33                        The argument acl2 is not a valid pointer to an ACL.
34

STANDARDS

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

AUTHOR

43     Written by Andreas Gruenbacher <andreas.gruenbacher@gmail.com>.
44
45Linux ACL                       March 23, 2002                       Linux ACL