mdoc(7) police: fix markup and some spelling.
This commit is contained in:
parent
468255abf1
commit
03035079c0
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=74676
@ -30,20 +30,20 @@
|
|||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm getfacl
|
.Nm getfacl
|
||||||
.Nd Get ACL Information
|
.Nd get ACL Information
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Nm getfacl
|
.Nm
|
||||||
.Op Fl d
|
.Op Fl d
|
||||||
.Op Ar file ...
|
.Op Ar
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility writes discretionary access control information associated with
|
utility writes discretionary access control information associated with
|
||||||
the specified file(s) to standard output.
|
the specified file(s) to standard output.
|
||||||
If the
|
If the
|
||||||
.Xr getconf 8
|
.Xr getconf 1
|
||||||
utility indicates that
|
utility indicates that
|
||||||
.Va {_POSIX_ACL_EXTENDED}
|
.Eq { } Va _POSIX_ACL_EXTENDED
|
||||||
is not in effect for a
|
is not in effect for a
|
||||||
.Ar file
|
.Ar file
|
||||||
then the standard discretionary access permissions are interpreted as
|
then the standard discretionary access permissions are interpreted as
|
||||||
@ -54,8 +54,8 @@ The following option is available:
|
|||||||
.It Fl d
|
.It Fl d
|
||||||
The operation applies to the default ACL of a directory instead of the
|
The operation applies to the default ACL of a directory instead of the
|
||||||
access ACL.
|
access ACL.
|
||||||
An error shall be generated if a default ACL cannot be associated with
|
An error is generated if a default ACL cannot be associated with
|
||||||
.Op Ar file .
|
.Ar file .
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
The following operand is available:
|
The following operand is available:
|
||||||
@ -63,24 +63,27 @@ The following operand is available:
|
|||||||
.It Ar file
|
.It Ar file
|
||||||
A pathname of a file whose ACL shall be retrieved.
|
A pathname of a file whose ACL shall be retrieved.
|
||||||
If
|
If
|
||||||
.Op Ar file
|
.Ar file
|
||||||
is not specified, or a
|
is not specified, or a
|
||||||
.Op Ar file
|
.Ar file
|
||||||
is specified as "-", then
|
is specified as
|
||||||
|
.Fl ,
|
||||||
|
then
|
||||||
.Nm
|
.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.
|
from the standard input.
|
||||||
.El
|
.El
|
||||||
.Pp
|
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
.Pp
|
|
||||||
.Dl getfacl /
|
.Dl getfacl /
|
||||||
.Pp
|
.Pp
|
||||||
Retrieve ACL for the directory "/".
|
Retrieve ACL for the directory
|
||||||
|
.Pa / .
|
||||||
.Pp
|
.Pp
|
||||||
.Dl getfacl -d /
|
.Dl getfacl -d /
|
||||||
.Pp
|
.Pp
|
||||||
Retrieve the default ACL for the directory "/", if any.
|
Retrieve the default ACL for the directory
|
||||||
|
.Pa / ,
|
||||||
|
if any.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr setfacl 1 ,
|
.Xr setfacl 1 ,
|
||||||
.Xr acl 3 ,
|
.Xr acl 3 ,
|
||||||
@ -91,10 +94,14 @@ Retrieve the default ACL for the directory "/", if any.
|
|||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility is expected to be IEEE Std 1003.2c compliant.
|
utility is expected to be
|
||||||
|
.Tn IEEE
|
||||||
|
Std 1003.2c compliant.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
Extended Attribute and Access Control List support was developed as part
|
Extended Attribute and Access Control List support was developed as part
|
||||||
of the TrustedBSD Project and introduced in
|
of the
|
||||||
.Fx 5.0
|
.Tn TrustedBSD
|
||||||
|
Project and introduced in
|
||||||
|
.Fx 5.0 .
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
Robert N M Watson
|
.An Robert N M Watson
|
||||||
|
@ -30,15 +30,15 @@
|
|||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm setfacl
|
.Nm setfacl
|
||||||
.Nd Set ACL Information
|
.Nd set ACL Information
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Nm setfacl
|
.Nm
|
||||||
.Op Fl bdkn
|
.Op Fl bdkn
|
||||||
.Op Fl m Ar entries
|
.Op Fl m Ar entries
|
||||||
.Op Fl M Ar file1
|
.Op Fl M Ar file1
|
||||||
.Op Fl x Ar entries
|
.Op Fl x Ar entries
|
||||||
.Op Fl X Ar file1
|
.Op Fl X Ar file1
|
||||||
.Op Ar file ...
|
.Op Ar
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
@ -57,7 +57,7 @@ default ACL's.
|
|||||||
Delete any default ACL entries on the specified files. It
|
Delete any default ACL entries on the specified files. It
|
||||||
is not considered an error if the specified files do not have
|
is not considered an error if the specified files do not have
|
||||||
any default ACL entries. An error will be reported if any of
|
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).
|
non-directories).
|
||||||
.It Fl m Ar entries
|
.It Fl m Ar entries
|
||||||
Modify the ACL entries on the specified files by adding new
|
Modify the ACL entries on the specified files by adding new
|
||||||
@ -71,7 +71,9 @@ entries specified in the file
|
|||||||
.Ar file .
|
.Ar file .
|
||||||
If
|
If
|
||||||
.Ar file
|
.Ar file
|
||||||
is "-", the input is taken from stdin.
|
is
|
||||||
|
.Fl ,
|
||||||
|
the input is taken from stdin.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
Do not recalculate the permissions associated with the ACL
|
Do not recalculate the permissions associated with the ACL
|
||||||
mask entry.
|
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
|
The above options are evaluated in the order specified
|
||||||
on the command-line.
|
on the command-line.
|
||||||
.Pp
|
.Pp
|
||||||
Multiple ACL entries specified on the command line shall be
|
Multiple ACL entries specified on the command line are
|
||||||
separated by commas.
|
separated by commas.
|
||||||
.Sh ACL ENTRIES
|
.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
|
an ACL tag, an ACL qualifier, and discretionary access
|
||||||
permissions:
|
permissions:
|
||||||
.Pp
|
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Ar ACL tag
|
.It Ar "ACL tag"
|
||||||
The ACL tag specifies the ACL entry type and shall consist of
|
The ACL tag specifies the ACL entry type and consists of
|
||||||
one of the following: ``user'' or ``u'' specifying the access
|
one of the following:
|
||||||
granted to the owner of the file or a specified user; ``group''
|
.Dq Li user
|
||||||
or ``g'' specifying the access granted to the file owning group
|
or
|
||||||
or a specified group; ``other'' or ``o'' specifying the access
|
.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
|
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
|
granted to any ACL entry except the
|
||||||
.Ar user
|
.Dq Li user
|
||||||
ACL entry for the file owner and the
|
ACL entry for the file owner and the
|
||||||
.Ar other
|
.Dq Li other
|
||||||
ACL entry.
|
ACL entry.
|
||||||
.Pp
|
.It Ar "ACL qualifier"
|
||||||
.It Ar ACL qualifier
|
|
||||||
The ACL qualifier field describes the user or group associated with
|
The ACL qualifier field describes the user or group associated with
|
||||||
the ACL entry. It may consist of one of the following: uid or
|
the ACL entry. It may consist of one of the following: uid or
|
||||||
user name, gid or group name, or empty. For
|
user name, gid or group name, or empty. For
|
||||||
.Ar user
|
.Dq Li user
|
||||||
ACL entries, an empty field shall specify access granted to the
|
ACL entries, an empty field specifies access granted to the
|
||||||
file owner. For
|
file owner. For
|
||||||
.Ar group
|
.Dq Li group
|
||||||
ACL entries, an empty field shall specify access granted to the
|
ACL entries, an empty field specifies access granted to the
|
||||||
file owning group.
|
file owning group.
|
||||||
.Ar mask
|
.Dq Li mask
|
||||||
and
|
and
|
||||||
.Ar other
|
.Dq Li other
|
||||||
ACL entries do not use this field.
|
ACL entries do not use this field.
|
||||||
.Pp
|
.It Ar "access permissions"
|
||||||
.It Ar access permissions
|
The access permissions field contains up to one of each of
|
||||||
The access permissions field shall contain up to one of each of
|
the following:
|
||||||
the following: ``r'', ``w'', and ``x'' to set read, write, and
|
.Ql r ,
|
||||||
|
.Ql w ,
|
||||||
|
and
|
||||||
|
.Ql x
|
||||||
|
to set read, write, and
|
||||||
execute permissions, respectively. Each of these may be excluded
|
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
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
A
|
A
|
||||||
.Ar mask
|
.Dq Li mask
|
||||||
ACL entry is required on a file with any ACL entries other than
|
ACL entry is required on a file with any ACL entries other than
|
||||||
the default
|
the default
|
||||||
.Ar user ,
|
.Dq Li user ,
|
||||||
.Ar group ,
|
.Dq Li group ,
|
||||||
and
|
and
|
||||||
.Ar other
|
.Dq Li other
|
||||||
ACL entries. If the
|
ACL entries. If the
|
||||||
.Fl n
|
.Fl n
|
||||||
option is not specified and no
|
option is not specified and no
|
||||||
.Ar mask
|
.Dq Li mask
|
||||||
ACL entry was specified, the
|
ACL entry was specified, the
|
||||||
.Nm
|
.Nm
|
||||||
utility
|
utility
|
||||||
will apply a
|
will apply a
|
||||||
.Ar mask
|
.Dq Li mask
|
||||||
ACL entry consisting of the union of the permissions associated
|
ACL entry consisting of the union of the permissions associated
|
||||||
with all
|
with all
|
||||||
.Ar group
|
.Dq Li group
|
||||||
ACL entries in the resulting ACL.
|
ACL entries in the resulting ACL.
|
||||||
.Pp
|
.Pp
|
||||||
ACL entries applied from a file using the
|
ACL entries applied from a file using the
|
||||||
@ -159,21 +180,22 @@ ACL entries applied from a file using the
|
|||||||
or
|
or
|
||||||
.Fl X
|
.Fl X
|
||||||
options shall be of the following form: one ACL entry per line, as
|
options shall be of the following form: one ACL entry per line, as
|
||||||
previously specified; whitespace is ignored; any text after a # is
|
previously specified; whitespace is ignored; any text after a
|
||||||
ignored (comments).
|
.Ql #
|
||||||
|
is ignored (comments).
|
||||||
.Pp
|
.Pp
|
||||||
When ACL entries are evaluated, the access check algorithm checks
|
When ACL entries are evaluated, the access check algorithm checks
|
||||||
the ACL entries in the following order: file owner,
|
the ACL entries in the following order: file owner,
|
||||||
.Ar user
|
.Dq Li user
|
||||||
ACL entries, file owning group,
|
ACL entries, file owning group,
|
||||||
.Ar group
|
.Dq Li group
|
||||||
ACL entries, and
|
ACL entries, and
|
||||||
.Ar other
|
.Dq Li other
|
||||||
ACL entry.
|
ACL entry.
|
||||||
.Sh RETURN VALUES
|
.Sh DIAGNOSTICS
|
||||||
The
|
The
|
||||||
.Nm
|
.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
|
.Sh EXAMPLES
|
||||||
.Dl setfacl -m u::rwx,g:mail:rw file
|
.Dl setfacl -m u::rwx,g:mail:rw file
|
||||||
.Pp
|
.Pp
|
||||||
@ -213,14 +235,18 @@ to
|
|||||||
.Xr getextattr 8 ,
|
.Xr getextattr 8 ,
|
||||||
.Xr setextattr 8 ,
|
.Xr setextattr 8 ,
|
||||||
.Xr acl 9 ,
|
.Xr acl 9 ,
|
||||||
.Xr extattr 9 .
|
.Xr extattr 9
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility is expected to be IEEE Std 1003.2c compliant.
|
utility is expected to be
|
||||||
|
.Tn IEEE
|
||||||
|
Std 1003.2c compliant.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
Extended Attribute and Access Control List support was developed
|
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 .
|
.Fx 5.0 .
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
The
|
The
|
||||||
|
Loading…
Reference in New Issue
Block a user