diff options
Diffstat (limited to 'man/man3/acl_cmp.3')
-rw-r--r-- | man/man3/acl_cmp.3 | 90 |
1 files changed, 47 insertions, 43 deletions
diff --git a/man/man3/acl_cmp.3 b/man/man3/acl_cmp.3 index aa8a333..d4af7f5 100644 --- a/man/man3/acl_cmp.3 +++ b/man/man3/acl_cmp.3 @@ -14,66 +14,70 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.TH ACL_CMP 3 "Linux ACL Library" "March 2002" "Access Control Lists" -.SH NAME -acl_cmp \- compare two ACLs -.SH LIBRARY +.Dd March 23, 2002 +.Dt ACL_CMP 3 +.Os "Linux ACL" +.Sh NAME +.Nm acl_cmp +.Nd compare two ACLs +.Sh LIBRARY Linux Access Control Lists library (libacl, \-lacl). -.SH C SYNOPSIS -.sp -.nf -.B #include <sys/types.h> -.B #include <sys/acl.h> -.sp -.B "int acl_cmp (acl_t \f2acl1\f3, acl_t \f2acl2\f3);" -.Op -.SH DESCRIPTION +.Sh SYNOPSIS +.In sys/types.h +.In acl/libacl.h +.Ft int +.Fn acl_cmp "acl_t acl1" "acl_t acl2" +.Sh DESCRIPTION The -.B acl_cmp +.Fn acl_cmp function compares the ACLs pointed to by the arguments -.I acl1 +.Va acl1 and -.I acl2 +.Va acl2 for equality. The two ACLs are considered equal if for each entry in -.I acl1 +.Va acl1 there is an entry in -.I acl2 +.Va acl2 with matching tag type, qualifier, and permissions, and vice versa. -.SH RETURN VALUE +.Sh RETURN VALUE If successful, the -.B acl_cmp -function returns 0 if the two ACLs -.I acl1 +.Fn acl_cmp +function returns +.Li 0 +if the two ACLs +.Va acl1 and -.I acl2 -are equal, and 1 if they differ. Otherwise, the value -1 +.Va acl2 +are equal, and +.Li 1 +if they differ. Otherwise, the value +.Li -1 is returned and the global variable -.B errno +.Va errno is set to indicate the error. -.SH ERRORS +.Sh ERRORS If any of the following conditions occur, the -.B acl_cmp -function returns -1 and sets -.B errno +.Fn acl_cmp +function returns +.Li -1 +and sets +.Va errno to the corresponding value: -.TP -.SM -\%[EINVAL] +.Bl -tag -width Er +.It Bq Er EINVAL The argument -.I acl1 +.Va acl1 is not a valid pointer to an ACL. -.TP -.SM -\%[EINVAL] +.Pp The argument -.I acl2 +.Va acl2 is not a valid pointer to an ACL. -.SH STANDARDS +.El +.Sh STANDARDS This is a non-portable, Linux specific extension to the ACL manipulation functions defined in IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned). -.SH AUTHOR +.Sh SEE ALSO +.Xr acl 5 +.Sh AUTHOR Written by -.I "Andreas Gruenbacher" -<a.gruenbacher@computer.org>. -.SH SEE ALSO -.BR acl (5) +.An "Andreas Gruenbacher" Aq a.gruenbacher@computer.org . |