summaryrefslogtreecommitdiff
path: root/man/man3/acl_cmp.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3/acl_cmp.3')
-rw-r--r--man/man3/acl_cmp.390
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 .