summaryrefslogtreecommitdiffstats
path: root/bin
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-03-23 08:14:27 +0000
committerru <ru@FreeBSD.org>2001-03-23 08:14:27 +0000
commitd3cb88445526b280f12e44d131808c5793f0c34b (patch)
treef0752ea34c2a6fc5f80d025b1b05add77e1126c2 /bin
parent329b146b7408b979c00cb25c2323f188ff43479a (diff)
downloadFreeBSD-src-d3cb88445526b280f12e44d131808c5793f0c34b.zip
FreeBSD-src-d3cb88445526b280f12e44d131808c5793f0c34b.tar.gz
mdoc(7) police: fix markup and some spelling.
Diffstat (limited to 'bin')
-rw-r--r--bin/getfacl/getfacl.145
-rw-r--r--bin/setfacl/setfacl.1120
2 files changed, 99 insertions, 66 deletions
diff --git a/bin/getfacl/getfacl.1 b/bin/getfacl/getfacl.1
index 20d0906..c78418a 100644
--- a/bin/getfacl/getfacl.1
+++ b/bin/getfacl/getfacl.1
@@ -30,20 +30,20 @@
.Os
.Sh NAME
.Nm getfacl
-.Nd Get ACL Information
+.Nd get ACL Information
.Sh SYNOPSIS
-.Nm getfacl
+.Nm
.Op Fl d
-.Op Ar file ...
+.Op Ar
.Sh DESCRIPTION
The
.Nm
utility writes discretionary access control information associated with
the specified file(s) to standard output.
If the
-.Xr getconf 8
+.Xr getconf 1
utility indicates that
-.Va {_POSIX_ACL_EXTENDED}
+.Eq { } Va _POSIX_ACL_EXTENDED
is not in effect for a
.Ar file
then the standard discretionary access permissions are interpreted as
@@ -54,8 +54,8 @@ The following option is available:
.It Fl d
The operation applies to the default ACL of a directory instead of the
access ACL.
-An error shall be generated if a default ACL cannot be associated with
-.Op Ar file .
+An error is generated if a default ACL cannot be associated with
+.Ar file .
.El
.Pp
The following operand is available:
@@ -63,24 +63,27 @@ The following operand is available:
.It Ar file
A pathname of a file whose ACL shall be retrieved.
If
-.Op Ar file
+.Ar file
is not specified, or a
-.Op Ar file
-is specified as "-", then
+.Ar file
+is specified as
+.Fl ,
+then
.Nm
-shall read a list of pathnames, each terminated by one <newline> character,
+reads a list of pathnames, each terminated by one newline character,
from the standard input.
.El
-.Pp
.Sh EXAMPLES
-.Pp
.Dl getfacl /
.Pp
-Retrieve ACL for the directory "/".
+Retrieve ACL for the directory
+.Pa / .
.Pp
.Dl getfacl -d /
.Pp
-Retrieve the default ACL for the directory "/", if any.
+Retrieve the default ACL for the directory
+.Pa / ,
+if any.
.Sh SEE ALSO
.Xr setfacl 1 ,
.Xr acl 3 ,
@@ -91,10 +94,14 @@ Retrieve the default ACL for the directory "/", if any.
.Sh STANDARDS
The
.Nm
-utility is expected to be IEEE Std 1003.2c compliant.
+utility is expected to be
+.Tn IEEE
+Std 1003.2c compliant.
.Sh HISTORY
Extended Attribute and Access Control List support was developed as part
-of the TrustedBSD Project and introduced in
-.Fx 5.0
+of the
+.Tn TrustedBSD
+Project and introduced in
+.Fx 5.0 .
.Sh AUTHORS
-Robert N M Watson
+.An Robert N M Watson
diff --git a/bin/setfacl/setfacl.1 b/bin/setfacl/setfacl.1
index fe28f86..d84d8b0 100644
--- a/bin/setfacl/setfacl.1
+++ b/bin/setfacl/setfacl.1
@@ -30,15 +30,15 @@
.Os
.Sh NAME
.Nm setfacl
-.Nd Set ACL Information
+.Nd set ACL Information
.Sh SYNOPSIS
-.Nm setfacl
+.Nm
.Op Fl bdkn
.Op Fl m Ar entries
.Op Fl M Ar file1
.Op Fl x Ar entries
.Op Fl X Ar file1
-.Op Ar file ...
+.Op Ar
.Sh DESCRIPTION
The
.Nm
@@ -57,7 +57,7 @@ default ACL's.
Delete any default ACL entries on the specified files. It
is not considered an error if the specified files do not have
any default ACL entries. An error will be reported if any of
-the specified files cannot have a default entry (i.e.
+the specified files cannot have a default entry (i.e.\&
non-directories).
.It Fl m Ar entries
Modify the ACL entries on the specified files by adding new
@@ -71,7 +71,9 @@ entries specified in the file
.Ar file .
If
.Ar file
-is "-", the input is taken from stdin.
+is
+.Fl ,
+the input is taken from stdin.
.It Fl n
Do not recalculate the permissions associated with the ACL
mask entry.
@@ -88,70 +90,89 @@ from the access or default ACL of the specified files.
The above options are evaluated in the order specified
on the command-line.
.Pp
-Multiple ACL entries specified on the command line shall be
+Multiple ACL entries specified on the command line are
separated by commas.
.Sh ACL ENTRIES
-An ACL entry shall contain three colon-separated fields:
+An ACL entry contains three colon-separated fields:
an ACL tag, an ACL qualifier, and discretionary access
permissions:
-.Pp
.Bl -tag -width indent
-.It Ar ACL tag
-The ACL tag specifies the ACL entry type and shall consist of
-one of the following: ``user'' or ``u'' specifying the access
-granted to the owner of the file or a specified user; ``group''
-or ``g'' specifying the access granted to the file owning group
-or a specified group; ``other'' or ``o'' specifying the access
+.It Ar "ACL tag"
+The ACL tag specifies the ACL entry type and consists of
+one of the following:
+.Dq Li user
+or
+.Ql u
+specifying the access
+granted to the owner of the file or a specified user;
+.Dq Li group
+or
+.Ql g
+specifying the access granted to the file owning group
+or a specified group;
+.Dq Li other
+or
+.Ql o
+specifying the access
granted to any process that does not match any user or group
-ACL entry; ``mask'' or ``m'' specifying the maximum access
+ACL entry;
+.Dq Li mask
+or
+.Ql m
+specifying the maximum access
granted to any ACL entry except the
-.Ar user
+.Dq Li user
ACL entry for the file owner and the
-.Ar other
+.Dq Li other
ACL entry.
-.Pp
-.It Ar ACL qualifier
+.It Ar "ACL qualifier"
The ACL qualifier field describes the user or group associated with
the ACL entry. It may consist of one of the following: uid or
user name, gid or group name, or empty. For
-.Ar user
-ACL entries, an empty field shall specify access granted to the
+.Dq Li user
+ACL entries, an empty field specifies access granted to the
file owner. For
-.Ar group
-ACL entries, an empty field shall specify access granted to the
+.Dq Li group
+ACL entries, an empty field specifies access granted to the
file owning group.
-.Ar mask
+.Dq Li mask
and
-.Ar other
+.Dq Li other
ACL entries do not use this field.
-.Pp
-.It Ar access permissions
-The access permissions field shall contain up to one of each of
-the following: ``r'', ``w'', and ``x'' to set read, write, and
+.It Ar "access permissions"
+The access permissions field contains up to one of each of
+the following:
+.Ql r ,
+.Ql w ,
+and
+.Ql x
+to set read, write, and
execute permissions, respectively. Each of these may be excluded
-or replaced with a ``-'' character to indicate no access.
+or replaced with a
+.Ql -
+character to indicate no access.
.El
.Pp
A
-.Ar mask
+.Dq Li mask
ACL entry is required on a file with any ACL entries other than
the default
-.Ar user ,
-.Ar group ,
+.Dq Li user ,
+.Dq Li group ,
and
-.Ar other
+.Dq Li other
ACL entries. If the
.Fl n
option is not specified and no
-.Ar mask
+.Dq Li mask
ACL entry was specified, the
.Nm
utility
will apply a
-.Ar mask
+.Dq Li mask
ACL entry consisting of the union of the permissions associated
with all
-.Ar group
+.Dq Li group
ACL entries in the resulting ACL.
.Pp
ACL entries applied from a file using the
@@ -159,21 +180,22 @@ ACL entries applied from a file using the
or
.Fl X
options shall be of the following form: one ACL entry per line, as
-previously specified; whitespace is ignored; any text after a # is
-ignored (comments).
+previously specified; whitespace is ignored; any text after a
+.Ql #
+is ignored (comments).
.Pp
When ACL entries are evaluated, the access check algorithm checks
the ACL entries in the following order: file owner,
-.Ar user
+.Dq Li user
ACL entries, file owning group,
-.Ar group
+.Dq Li group
ACL entries, and
-.Ar other
+.Dq Li other
ACL entry.
-.Sh RETURN VALUES
+.Sh DIAGNOSTICS
The
.Nm
-utility returns 0 on success and > 0 if an error occurs.
+utility returns 0 on success and >0 if an error occurs.
.Sh EXAMPLES
.Dl setfacl -m u::rwx,g:mail:rw file
.Pp
@@ -213,14 +235,18 @@ to
.Xr getextattr 8 ,
.Xr setextattr 8 ,
.Xr acl 9 ,
-.Xr extattr 9 .
+.Xr extattr 9
.Sh STANDARDS
The
.Nm
-utility is expected to be IEEE Std 1003.2c compliant.
+utility is expected to be
+.Tn IEEE
+Std 1003.2c compliant.
.Sh HISTORY
Extended Attribute and Access Control List support was developed
-as part of the TrustedBSD Project and introduced in
+as part of the
+.Tn TrustedBSD
+Project and introduced in
.Fx 5.0 .
.Sh AUTHORS
The
OpenPOWER on IntegriCloud