docs: some manpage fixes

Some editorial changes so the man pages follow the standards.

References:
 procps#173
This commit is contained in:
Craig Small 2020-06-04 22:25:26 +10:00
parent f0fb35b645
commit cc032cbd99
12 changed files with 88 additions and 67 deletions

18
pgrep.1
View File

@ -1,13 +1,13 @@
.\" .\"
.\" Copyright 2000 Kjetil Torgrim Homme .\" Copyright 2000 Kjetil Torgrim Homme
.\" 2017 Craig Small .\" 2017-2020 Craig Small
.\" .\"
.\" This program is free software; you can redistribute it and/or modify .\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by .\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or .\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version. .\" (at your option) any later version.
.\" .\"
.TH PGREP "1" "2020-04-24" "procps-ng" "User Commands" .TH PGREP "1" "2020-06-04" "procps-ng" "User Commands"
.SH NAME .SH NAME
pgrep, pkill \- look up or signal processes based on name and other attributes pgrep, pkill \- look up or signal processes based on name and other attributes
.SH SYNOPSIS .SH SYNOPSIS
@ -141,29 +141,27 @@ context. In
context this option is disabled. context this option is disabled.
.TP .TP
\fB\-x\fR, \fB\-\-exact\fR\fR \fB\-x\fR, \fB\-\-exact\fR\fR
Only match processes whose names (or command line if \-f is specified) Only match processes whose names (or command lines if \fB\-f\fR is specified)
.B exactly .B exactly
match the match the
.IR pattern . .IR pattern .
.TP .TP
\fB\-F\fR, \fB\-\-pidfile\fR \fIfile\fR \fB\-F\fR, \fB\-\-pidfile\fR \fIfile\fR
Read Read \fIPID\fRs from \fIfile\fR. This option is perhaps more useful for
.IR PID 's
from file. This option is perhaps more useful for
.B pkill .B pkill
than than
.BR pgrep . .BR pgrep .
.TP .TP
\fB\-L\fR, \fB\-\-logpidfile\fR \fB\-L\fR, \fB\-\-logpidfile\fR
Fail if pidfile (see -F) not locked. Fail if pidfile (see \fB\-F\fR) not locked.
.TP .TP
\fB\-r\fR, \fB\-\-runstates\fR \fID,R,S,Z,\fP... \fB\-r\fR, \fB\-\-runstates\fR \fID,R,S,Z,\fP...
Match only processes which match the process state. Match only processes which match the process state.
.TP .TP
\fB\-\-ns \fIpid\fP \fB\-\-ns \fIpid\fP
Match processes that belong to the same namespaces. Required to run as Match processes that belong to the same namespaces. Required to run as
root to match processes from other users. See \-\-nslist for how to limit root to match processes from other users. See \fB\-\-nslist\fR for how to
which namespaces to match. limit which namespaces to match.
.TP .TP
\fB\-\-nslist \fIname\fP,... \fB\-\-nslist \fIname\fP,...
Match only the provided namespaces. Available namespaces: Match only the provided namespaces. Available namespaces:
@ -234,7 +232,7 @@ Fatal error: out of memory etc.
.PD .PD
.SH NOTES .SH NOTES
The process name used for matching is limited to the 15 characters present in The process name used for matching is limited to the 15 characters present in
the output of /proc/\fIpid\fP/stat. Use the \-f option to match against the the output of /proc/\fIpid\fP/stat. Use the \fB\-f\fR option to match against the
complete command line, /proc/\fIpid\fP/cmdline. complete command line, /proc/\fIpid\fP/cmdline.
.PP .PP
The running The running

13
pidof.1
View File

@ -15,22 +15,22 @@
.\" along with this program; if not, write to the Free Software .\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
.\" .\"
.TH PIDOF 1 "2019-09-21" "" "User Commands" .TH PIDOF 1 "2020-06-04" "" "User Commands"
.SH NAME .SH NAME
pidof -- find the process ID of a running program. pidof -- find the process ID of a running program
.SH SYNOPSIS .SH SYNOPSIS
.B pidof .B pidof
.RB [ \-s ] .RB [ \-s ]
.RB [ \-c ] .RB [ \-c ]
.RB [ \-x ] .RB [ \-x ]
.RB [ \-o .RB [ \-o
.IR omitpid[,omitpid..] ] .IR omitpid[,omitpid...] ]
.RB [ \-o .RB [ \-o
.IR omitpid[,omitpid..].. ] .IR omitpid[,omitpid...]... ]
.RB [ \-S .RB [ \-S
.IR separator ] .IR separator ]
.B program .B program
.RB [ program.. ] .RB [ program... ]
.SH DESCRIPTION .SH DESCRIPTION
.B Pidof .B Pidof
finds the process id's (pids) of the named programs. It prints those finds the process id's (pids) of the named programs. It prints those
@ -52,7 +52,8 @@ program, in other words the calling shell or shell script.
.IP "-S \fIseparator\fP" .IP "-S \fIseparator\fP"
Use \fIseparator\fP as a separator put between pids. Used only when Use \fIseparator\fP as a separator put between pids. Used only when
more than one pids are printed for the program. more than one pids are printed for the program.
The \fI\-d\fR option is an alias for this option for sysvinit pidof The \fB\-d\fR option is an alias for this option for sysvinit
.B pidof
compatibility. compatibility.
.SH "EXIT STATUS" .SH "EXIT STATUS"
.TP .TP

10
pmap.1
View File

@ -5,14 +5,16 @@
.\" Licensed under version 2 of the GNU General Public License. .\" Licensed under version 2 of the GNU General Public License.
.\" Written by Albert Cahalan. .\" Written by Albert Cahalan.
.\" .\"
.TH PMAP "1" "September 2012" "procps-ng" "User Commands" .TH PMAP "1" "2020-06-04" "procps-ng" "User Commands"
.SH NAME .SH NAME
pmap \- report memory map of a process pmap \- report memory map of a process
.SH SYNOPSIS .SH SYNOPSIS
.B pmap .B pmap
[\fIoptions\fR] \fIpid\fR [...] [\fIoptions\fR] \fIpid\fR [...]
.SH DESCRIPTION .SH DESCRIPTION
The pmap command reports the memory map of a process or processes. The
.B pmap
command reports the memory map of a process or processes.
.SH OPTIONS .SH OPTIONS
.TP .TP
\fB\-x\fR, \fB\-\-extended\fR \fB\-x\fR, \fB\-\-extended\fR
@ -78,7 +80,9 @@ Did not find all processes asked for.
.BR ps (1), .BR ps (1),
.BR pgrep (1) .BR pgrep (1)
.SH STANDARDS .SH STANDARDS
No standards apply, but pmap looks an awful lot like a SunOS command. No standards apply, but
.B pmap
looks an awful lot like a SunOS command.
.SH "REPORTING BUGS" .SH "REPORTING BUGS"
Please send bug reports to Please send bug reports to
.UR procps@freelists.org .UR procps@freelists.org

50
ps/ps.1
View File

@ -4,7 +4,7 @@
.\" Quick hack conversion by Albert Cahalan, 1998. .\" Quick hack conversion by Albert Cahalan, 1998.
.\" Licensed under version 2 of the Gnu General Public License. .\" 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: .\" To render this page:
.\" groff -t -b -man -X -P-resolution -P100 -Tps ps.1 & .\" groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
@ -32,7 +32,7 @@ ps \- report a snapshot of the current processes.
.B ps .B ps
displays information about a selection of the active processes. If you want displays information about a selection of the active processes. If you want
a repetitive update of the selection and the displayed information, use a repetitive update of the selection and the displayed information, use
.IR top (1) .B top
instead. instead.
.P .P
This version of This version of
@ -56,14 +56,14 @@ implementations that this
.B ps .B ps
is compatible with. is compatible with.
.P .P
Note that "\fBps \-aux\fR" is distinct from "\fBps\ aux\fR". The POSIX and 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 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 user named \fIx\fR, as well as printing all processes that would be selected by
the the
.B \-a .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 .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 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. is fragile, subject to change, and thus should not be relied upon.
.P .P
@ -743,7 +743,7 @@ Show threads, possibly with SPID column.
.SH "OTHER INFORMATION" .SH "OTHER INFORMATION"
.TP .TP
.BI \-\-help \ section .BI \-\-help \ section
Print a help message. The section argument can be one of Print a help message. The \fIsection\fR argument can be one of
.IR s imple, .IR s imple,
.IR l ist, .IR l ist,
.IR o utput, .IR o utput,
@ -796,20 +796,18 @@ will be destroyed by
if the parent process exits. if the parent process exits.
.PP .PP
If the length of the username is greater than the length of the display 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 column, the username will be truncated. See the \fB\-o\fR and \fB\-O\fR
options to customize length. formatting options to customize length.
.PP .PP
Commands options such as Commands options such as
.B ps \-aux .B ps \-aux
are not recommended as it is a confusion of two different standards. are not recommended as it is a confusion of two different standards.
According to the POSIX and UNIX standards, the above command asks to According to the POSIX and UNIX standards, the above command asks to
display all processes with a TTY (generally the commands users are 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 doesn't exist, then
.B ps .B ps
will assume you really meant will assume you really meant \fBps aux\fR.
.RB """" ps
.IR aux """."
.SH "PROCESS FLAGS" .SH "PROCESS FLAGS"
The sum of these values is displayed in the "F" column, The sum of these values is displayed in the "F" column,
which is provided by the which is provided by the
@ -1163,8 +1161,8 @@ fully destroyed by its parent. The output in this column may contain spaces.
(alias (alias
.BR ucmd ", " ucomm ). .BR ucmd ", " ucomm ).
See also the See also the
.B args format keyword, .B args
the format keyword, the
.B \-f .B \-f
option, and the option, and the
.B c .B c
@ -1325,7 +1323,8 @@ T}
ipcns IPCNS T{ ipcns IPCNS T{
Unique inode number describing the namespace the process belongs to. Unique inode number describing the namespace the process belongs to.
See namespaces(7). See
.IR namespaces (7).
T} T}
label LABEL T{ label LABEL T{
@ -1377,12 +1376,14 @@ T}
mntns MNTNS T{ mntns MNTNS T{
Unique inode number describing the namespace the process belongs to. Unique inode number describing the namespace the process belongs to.
See namespaces(7). See
.IR namespaces (7).
T} T}
netns NETNS T{ netns NETNS T{
Unique inode number describing the namespace the process belongs to. Unique inode number describing the namespace the process belongs to.
See namespaces(7). See
.IR namespaces (7).
T} T}
ni NI T{ ni NI T{
@ -1407,7 +1408,7 @@ T}
numa NUMA T{ numa NUMA T{
The node assocated with the most recently used processor. 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} T}
nwchan WCHAN T{ nwchan WCHAN T{
@ -1463,7 +1464,8 @@ T}
pidns PIDNS T{ pidns PIDNS T{
Unique inode number describing the namespace the process belongs to. Unique inode number describing the namespace the process belongs to.
See namespaces(7). See
.IR namespaces (7).
T} T}
pmem %MEM T{ pmem %MEM T{
@ -1826,12 +1828,14 @@ T}
userns USERNS T{ userns USERNS T{
Unique inode number describing the namespace the process belongs to. Unique inode number describing the namespace the process belongs to.
See namespaces(7). See
.IR namespaces (7).
T} T}
utsns UTSNS T{ utsns UTSNS T{
Unique inode number describing the namespace the process belongs to. Unique inode number describing the namespace the process belongs to.
See namespaces(7). See
.IR namespaces (7).
T} T}
uunit UUNIT T{ uunit UUNIT T{

6
pwdx.1
View File

@ -3,7 +3,7 @@
.\" Copyright 2004 Nicholas Miell. .\" Copyright 2004 Nicholas Miell.
.\" Based on the pmap(1) man page by Albert Cahalan. .\" Based on the pmap(1) man page by Albert Cahalan.
.\" .\"
.TH PWDX "1" "June 2011" "procps-ng" "User Commands" .TH PWDX "1" "2020-06-04" "procps-ng" "User Commands"
.SH NAME .SH NAME
pwdx \- report current working directory of a process pwdx \- report current working directory of a process
.SH SYNOPSIS .SH SYNOPSIS
@ -20,7 +20,9 @@ Output help screen and exit.
.BR ps (1), .BR ps (1),
.BR pgrep (1) .BR pgrep (1)
.SH STANDARDS .SH STANDARDS
No standards apply, but pwdx looks an awful lot like a SunOS command. No standards apply, but
.B pwdx
looks an awful lot like a SunOS command.
.SH AUTHOR .SH AUTHOR
.UR nmiell@gmail.com .UR nmiell@gmail.com
Nicholas Miell Nicholas Miell

View File

@ -43,8 +43,9 @@ The following are valid sort criteria used to sort the individual slab caches
and thereby determine what are the "top" slab caches to display. The default and thereby determine what are the "top" slab caches to display. The default
sort criteria is to sort by the number of objects ("o"). sort criteria is to sort by the number of objects ("o").
.PP .PP
The sort criteria can also be changed while slabtop is running by pressing The sort criteria can also be changed while
the associated character. .B slabtop
is running by pressing the associated character.
.TS .TS
l l l. l l l.
\fBcharacter description header\fR \fBcharacter description header\fR
@ -89,7 +90,9 @@ requires a 2.4 or later kernel (specifically, a version 1.1 or later
.IR /proc/slabinfo ). .IR /proc/slabinfo ).
Kernel 2.2 should be supported in the future. Kernel 2.2 should be supported in the future.
.PP .PP
The slabtop statistic header is tracking how many bytes of slabs are being The
.B slabtop
statistic header is tracking how many bytes of slabs are being
used and is not a measure of physical memory. The 'Slab' field in the used and is not a measure of physical memory. The 'Slab' field in the
/proc/meminfo file is tracking information about used slab physical memory. /proc/meminfo file is tracking information about used slab physical memory.
.SH AUTHORS .SH AUTHORS

View File

@ -144,7 +144,9 @@ The
.B base_reachable_time .B base_reachable_time
and and
.B retrans_time .B retrans_time
are deprecated. The sysctl command does not allow changing values of these are deprecated. The
.B sysctl
command does not allow changing values of these
parameters. Users who insist to use deprecated kernel interfaces should push values parameters. Users who insist to use deprecated kernel interfaces should push values
to /proc file system by other means. For example: to /proc file system by other means. For example:
.PP .PP

View File

@ -6,7 +6,7 @@
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details." .\" GNU General Public License for more details."
.TH SYSCTL.CONF "5" "2020-02-27" "procps-ng" "File Formats" .TH SYSCTL.CONF "5" "2020-06-04" "procps-ng" "File Formats"
.SH NAME .SH NAME
sysctl.conf \- sysctl preload/configuration file sysctl.conf \- sysctl preload/configuration file
.SH DESCRIPTION .SH DESCRIPTION
@ -27,7 +27,7 @@ token = value
.PP .PP
Note that blank lines are ignored, and whitespace before and after a token or Note that blank lines are ignored, and whitespace before and after a token or
value is ignored, although a value can contain whitespace within. Lines which value is ignored, although a value can contain whitespace within. Lines which
begin with a # or ; are considered comments and ignored. begin with a \fI#\fR or \fI;\fR are considered comments and ignored.
If a line begins with a single \-, any attempts to set the value that fail will be If a line begins with a single \-, any attempts to set the value that fail will be
ignored. ignored.

View File

@ -1,7 +1,7 @@
.\" -*-Nroff-*- .\" -*-Nroff-*-
.\" This page Copyright (C) 1993 Matt Welsh, mdw@tc.cornell.edu. .\" This page Copyright (C) 1993 Matt Welsh, mdw@tc.cornell.edu.
.\" Freely distributable under the terms of the GPL .\" Freely distributable under the terms of the GPL
.TH TLOAD "1" "June 2011" "procps-ng" "User Commands" .TH TLOAD "1" "2020-06-04" "procps-ng" "User Commands"
.SH NAME .SH NAME
tload \- graphic representation of system load average tload \- graphic representation of system load average
.SH SYNOPSIS .SH SYNOPSIS
@ -11,7 +11,9 @@ tload \- graphic representation of system load average
.B tload .B tload
prints a graph of the current system load average to the specified prints a graph of the current system load average to the specified
.I tty .I tty
(or the tty of the tload process if none is specified). (or the tty of the
.B tload
process if none is specified).
.SH OPTIONS .SH OPTIONS
.TP .TP
\fB\-s\fR, \fB\-\-scale\fR \fInumber\fR \fB\-s\fR, \fB\-\-scale\fR \fInumber\fR

View File

@ -1,6 +1,6 @@
.\" This page Copyright (C) 1994 Henry Ware <al172@yfn.ysu.edu> .\" This page Copyright (C) 1994 Henry Ware <al172@yfn.ysu.edu>
.\" Distributed under the GPL, Copyleft 1994. .\" Distributed under the GPL, Copyleft 1994.
.TH VMSTAT 8 "September 2011" "procps-ng" "System Administration" .TH VMSTAT 8 "2020-06-04" "procps-ng" "System Administration"
.SH NAME .SH NAME
vmstat \- Report virtual memory statistics vmstat \- Report virtual memory statistics
.SH SYNOPSIS .SH SYNOPSIS
@ -98,19 +98,19 @@ b: The number of processes in uninterruptible sleep.
.PP .PP
.SS .SS
.B "Memory" .B "Memory"
These are affected by the \-\-unit option. These are affected by the \fB\-\-unit\fR option.
.nf .nf
swpd: the amount of virtual memory used. swpd: the amount of virtual memory used.
free: the amount of idle memory. free: the amount of idle memory.
buff: the amount of memory used as buffers. buff: the amount of memory used as buffers.
cache: the amount of memory used as cache. cache: the amount of memory used as cache.
inact: the amount of inactive memory. (\-a option) inact: the amount of inactive memory. (\fB\-a\fR option)
active: the amount of active memory. (\-a option) active: the amount of active memory. (\fB\-a\fR option)
.fi .fi
.PP .PP
.SS .SS
.B "Swap" .B "Swap"
These are affected by the \-\-unit option. These are affected by the \fB\-\-unit\fR option.
.nf .nf
si: Amount of memory swapped in from disk (/s). si: Amount of memory swapped in from disk (/s).
so: Amount of memory swapped to disk (/s). so: Amount of memory swapped to disk (/s).
@ -184,7 +184,7 @@ size: Size of each object
pages: Number of pages with at least one active object pages: Number of pages with at least one active object
.fi .fi
.SH NOTES .SH NOTES
.B "vmstat " .B vmstat
does not require special permissions. does not require special permissions.
.PP .PP
These reports are intended to help identify system bottlenecks. Linux These reports are intended to help identify system bottlenecks. Linux

10
w.1
View File

@ -1,6 +1,6 @@
.\" -*-Nroff-*- .\" -*-Nroff-*-
.\" .\"
.TH W "1" "May 2012" "procps-ng" "User Commands" .TH W "1" "2020-06-04" "procps-ng" "User Commands"
.SH NAME .SH NAME
w \- Show who is logged on and what they are doing. w \- Show who is logged on and what they are doing.
.SH SYNOPSIS .SH SYNOPSIS
@ -30,8 +30,12 @@ Don't print the header.
.TP .TP
\fB\-u\fR, \fB\-\-no\-current\fR \fB\-u\fR, \fB\-\-no\-current\fR
Ignores the username while figuring out the Ignores the username while figuring out the
current process and cpu times. To demonstrate this, do a "su" and do a "w" current process and cpu times. To demonstrate this, do a
and a "w \-u". .B su
and do a
.B w
and a
.BR "w \-u".
.TP .TP
\fB\-s\fR, \fB\-\-short\fR \fB\-s\fR, \fB\-\-short\fR
Use the short format. Don't print the login time, JCPU or PCPU times. Use the short format. Don't print the login time, JCPU or PCPU times.

13
watch.1
View File

@ -1,4 +1,4 @@
.TH WATCH 1 "2020-05-12" "procps-ng" "User Commands" .TH WATCH 1 "2020-06-04" "procps-ng" "User Commands"
.SH NAME .SH NAME
watch \- execute a program periodically, showing output fullscreen watch \- execute a program periodically, showing output fullscreen
.SH SYNOPSIS .SH SYNOPSIS
@ -13,10 +13,11 @@ allows you to watch the program output change over time. By default,
\fIcommand\fR is run every 2 seconds and \fBwatch\fR will run until interrupted. \fIcommand\fR is run every 2 seconds and \fBwatch\fR will run until interrupted.
.SH OPTIONS .SH OPTIONS
.TP .TP
\fB\-d\fR, \fB\-\-differences\fR [\fIpermanent\fR] .BR \-d ", " \-\-differences [ =permanent ]
Highlight the differences between successive updates. Option will read Highlight the differences between successive updates. If the optional
optional argument that changes highlight to be permanent, allowing to see what \fB=permanent\fR argument is specified then
has changed at least once since first iteration. .B watch
will show all changes since the first iteration.
.TP .TP
\fB\-n\fR, \fB\-\-interval\fR \fIseconds\fR \fB\-n\fR, \fB\-\-interval\fR \fIseconds\fR
Specify update interval. The command will not allow quicker than 0.1 second Specify update interval. The command will not allow quicker than 0.1 second
@ -124,7 +125,7 @@ next scheduled update. All
.B \-\-differences .B \-\-differences
highlighting is lost on that update as well. highlighting is lost on that update as well.
Non-printing characters are stripped from program output. Use "cat -v" as Non-printing characters are stripped from program output. Use \fBcat -v\fR as
part of the command pipeline if you want to see them. part of the command pipeline if you want to see them.
Combining Characters that are supposed to display on the character at the Combining Characters that are supposed to display on the character at the