docs: some manpage fixes
Some editorial changes so the man pages follow the standards. References: procps#173
This commit is contained in:
69
ps/ps.1
69
ps/ps.1
@@ -4,7 +4,7 @@
|
||||
.\" Quick hack conversion by Albert Cahalan, 1998.
|
||||
.\" Licensed under version 2 of the Gnu General Public License.
|
||||
.\"
|
||||
.TH PS 1 2018-08-08 "procps-ng" "User Commands"
|
||||
.TH PS "1" "2020-06-04" "procps-ng" "User Commands"
|
||||
.\"
|
||||
.\" To render this page:
|
||||
.\" groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
|
||||
@@ -34,7 +34,7 @@ ps \- report a snapshot of the current processes.
|
||||
.B ps
|
||||
displays information about a selection of the active processes. If you want
|
||||
a repetitive update of the selection and the displayed information, use
|
||||
.IR top (1)
|
||||
.B top
|
||||
instead.
|
||||
.P
|
||||
This version of
|
||||
@@ -58,14 +58,14 @@ implementations that this
|
||||
.B ps
|
||||
is compatible with.
|
||||
.P
|
||||
Note that "\fBps \-aux\fR" is distinct from "\fBps\ aux\fR". The POSIX and
|
||||
UNIX standards require that "\fBps\ \-aux\fR" print all processes owned by a
|
||||
user named "x", as well as printing all processes that would be selected by
|
||||
Note that \fBps \-aux\fR is distinct from \fBps\ aux\fR. The POSIX and
|
||||
UNIX standards require that \fBps\ \-aux\fR print all processes owned by a
|
||||
user named \fIx\fR, as well as printing all processes that would be selected by
|
||||
the
|
||||
.B \-a
|
||||
option. If the user named "x" does not exist, this
|
||||
option. If the user named \fIx\fR does not exist, this
|
||||
.B ps
|
||||
may interpret the command as "\fBps\ aux\fR" instead and print a warning.
|
||||
may interpret the command as \fBps\ aux\fR instead and print a warning.
|
||||
This behavior is intended to aid in transitioning old scripts and habits. It
|
||||
is fragile, subject to change, and thus should not be relied upon.
|
||||
.P
|
||||
@@ -740,14 +740,15 @@ Show threads, possibly with SPID column.
|
||||
.SH "OTHER INFORMATION"
|
||||
.TP
|
||||
.BI \-\-help \ section
|
||||
Print a help message. The section argument can be one of
|
||||
\fIs\fRimple,
|
||||
\fIl\fRist,
|
||||
\fIo\fRutput,
|
||||
\fIt\fRhreads,
|
||||
\fIm\fRisc or
|
||||
\fIa\fRll.
|
||||
The argument can be shortened to one of the underlined letters as in: s|l|o|t|m|a.
|
||||
Print a help message. The \fIsection\fR argument can be one of
|
||||
.IR s imple,
|
||||
.IR l ist,
|
||||
.IR o utput,
|
||||
.IR t hreads,
|
||||
.IR m "isc, or"
|
||||
.IR a ll.
|
||||
The argument can be shortened to one of the underlined letters as in:
|
||||
s\^|\^l\^|\^o\^|\^t\^|\^m\^|\^a.
|
||||
.TP
|
||||
.B \-\-info
|
||||
Print debugging info.
|
||||
@@ -795,18 +796,18 @@ will be destroyed by
|
||||
if the parent process exits.
|
||||
.PP
|
||||
If the length of the username is greater than the length of the display
|
||||
column, the username will be truncated. See the -o and -O formatting
|
||||
options to customize length.
|
||||
column, the username will be truncated. See the \fB\-o\fR and \fB\-O\fR
|
||||
formatting options to customize length.
|
||||
.PP
|
||||
Commands options such as
|
||||
.B ps \-aux
|
||||
are not recommended as it is a confusion of two different standards.
|
||||
According to the POSIX and UNIX standards, the above command asks to
|
||||
display all processes with a TTY (generally the commands users are
|
||||
running) plus all processes owned by a user named "x". If that user
|
||||
running) plus all processes owned by a user named \fIx\fR. If that user
|
||||
doesn't exist, then
|
||||
.B ps
|
||||
will assume you really meant "\fBps\fR \fIaux\fR".
|
||||
will assume you really meant \fBps aux\fR.
|
||||
.SH "PROCESS FLAGS"
|
||||
The sum of these values is displayed in the "F" column,
|
||||
which is provided by the
|
||||
@@ -1157,8 +1158,8 @@ fully destroyed by its parent. The output in this column may contain spaces.
|
||||
(alias
|
||||
.BR ucmd , \ ucomm ).
|
||||
See also the
|
||||
.B args format keyword,
|
||||
the
|
||||
.B args
|
||||
format keyword, the
|
||||
.B \-f
|
||||
option, and the
|
||||
.B c
|
||||
@@ -1326,7 +1327,9 @@ format is displayed. (alias
|
||||
T}
|
||||
|
||||
ipcns IPCNS T{
|
||||
Unique inode number describing the namespace the process belongs to. See namespaces(7).
|
||||
Unique inode number describing the namespace the process belongs to.
|
||||
See
|
||||
.IR namespaces (7).
|
||||
T}
|
||||
|
||||
label LABEL T{
|
||||
@@ -1377,11 +1380,15 @@ The number of minor page faults that have occurred with this process.
|
||||
T}
|
||||
|
||||
mntns MNTNS T{
|
||||
Unique inode number describing the namespace the process belongs to. See namespaces(7).
|
||||
Unique inode number describing the namespace the process belongs to.
|
||||
See
|
||||
.IR namespaces (7).
|
||||
T}
|
||||
|
||||
netns NETNS T{
|
||||
Unique inode number describing the namespace the process belongs to. See namespaces(7).
|
||||
Unique inode number describing the namespace the process belongs to.
|
||||
See
|
||||
.IR namespaces (7).
|
||||
T}
|
||||
|
||||
ni NI T{
|
||||
@@ -1405,7 +1412,7 @@ T}
|
||||
|
||||
numa NUMA T{
|
||||
The node assocated with the most recently used processor.
|
||||
A -1 means that NUMA information is unavailable.
|
||||
A \fI\-1\fR means that NUMA information is unavailable.
|
||||
T}
|
||||
|
||||
nwchan WCHAN T{
|
||||
@@ -1458,7 +1465,9 @@ a number representing the process ID (alias
|
||||
T}
|
||||
|
||||
pidns PIDNS T{
|
||||
Unique inode number describing the namespace the process belongs to. See namespaces(7).
|
||||
Unique inode number describing the namespace the process belongs to.
|
||||
See
|
||||
.IR namespaces (7).
|
||||
T}
|
||||
|
||||
pmem %MEM T{
|
||||
@@ -1817,11 +1826,15 @@ see
|
||||
T}
|
||||
|
||||
userns USERNS T{
|
||||
Unique inode number describing the namespace the process belongs to. See namespaces(7).
|
||||
Unique inode number describing the namespace the process belongs to.
|
||||
See
|
||||
.IR namespaces (7).
|
||||
T}
|
||||
|
||||
utsns UTSNS T{
|
||||
Unique inode number describing the namespace the process belongs to. See namespaces(7).
|
||||
Unique inode number describing the namespace the process belongs to.
|
||||
See
|
||||
.IR namespaces (7).
|
||||
T}
|
||||
|
||||
uunit UUNIT T{
|
||||
|
Reference in New Issue
Block a user