summaryrefslogtreecommitdiff
path: root/ps/ps.1
diff options
context:
space:
mode:
Diffstat (limited to 'ps/ps.1')
-rw-r--r--ps/ps.169
1 files changed, 41 insertions, 28 deletions
diff --git a/ps/ps.1 b/ps/ps.1
index 1dbcbf2..df307e6 100644
--- a/ps/ps.1
+++ b/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{