docs: Minor manpage fixes

References:
 procps-ng/procps#230
This commit is contained in:
Craig Small 2023-01-16 18:29:50 +11:00
parent dbde44b528
commit aa461df0a7
8 changed files with 68 additions and 48 deletions

View File

@ -5,7 +5,7 @@
.\" Licensed under version 2 of the GNU General Public License. .\" Licensed under version 2 of the GNU General Public License.
.\" Written by Albert Cahalan; converted to a man page by .\" Written by Albert Cahalan; converted to a man page by
.\" Michael K. Johnson .\" Michael K. Johnson
.TH KILL 1 "2021-05-18" "procps-ng" "User Commands" .TH KILL 1 "2023-01-16" "procps-ng" "User Commands"
.SH NAME .SH NAME
kill \- send a signal to a process kill \- send a signal to a process
.SH SYNOPSIS .SH SYNOPSIS
@ -46,13 +46,13 @@ manual page.
.TP .TP
\fB\-q\fR, \fB\-\-queue \fIvalue\fP \fB\-q\fR, \fB\-\-queue \fIvalue\fP
Use Use
.BR sigqueue(3) .BR sigqueue (3)
rather than rather than
.BR kill(2) .BR kill (2)
and the value argument is used to specify and the value argument is used to specify
an integer to be sent with the signal. If the receiving process has an integer to be sent with the signal. If the receiving process has
installed a handler for this signal using the SA_SIGINFO flag to installed a handler for this signal using the SA_SIGINFO flag to
.BR sigaction(2) , .BR sigaction (2),
then it can obtain this data via the si_value field of the then it can obtain this data via the si_value field of the
siginfo_t structure. siginfo_t structure.
.TP .TP

View File

@ -7,7 +7,7 @@
.\" 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" "2022-11-01" "procps-ng" "User Commands" .TH PGREP "1" "2023-01-16" "procps-ng" "User Commands"
.SH NAME .SH NAME
pgrep, pkill, pidwait \- look up, signal, or wait for processes based on name and other attributes pgrep, pkill, pidwait \- look up, signal, or wait for processes based on name and other attributes
.SH SYNOPSIS .SH SYNOPSIS
@ -172,7 +172,9 @@ match the
.TP .TP
\fB\-F\fR, \fB\-\-pidfile\fR \fIfile\fR \fB\-F\fR, \fB\-\-pidfile\fR \fIfile\fR
Read \fIPID\fRs from \fIfile\fR. This option is more useful for Read \fIPID\fRs from \fIfile\fR. This option is more useful for
.BR pkill or pidwait .B pkill
or
.B pidwait
than than
.BR pgrep . .BR pgrep .
.TP .TP
@ -207,18 +209,18 @@ 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:
ipc, mnt, net, pid, user,uts. ipc, mnt, net, pid, user, uts.
.TP .TP
\fB\-q\fR, \fB\-\-queue \fIvalue\fP \fB\-q\fR, \fB\-\-queue \fIvalue\fP
Use Use
.BR sigqueue(3) .BR sigqueue (3)
rather than rather than
.BR kill(2) .BR kill (2)
and the value argument is used to specify and the value argument is used to specify
an integer to be sent with the signal. If the receiving process has an integer to be sent with the signal. If the receiving process has
installed a handler for this signal using the SA_SIGINFO flag to installed a handler for this signal using the SA_SIGINFO flag to
.BR sigaction(2) .BR sigaction (2),
, then it can obtain this data via the si_value field of the then it can obtain this data via the si_value field of the
siginfo_t structure. siginfo_t structure.
.TP .TP
\fB\-V\fR, \fB\-\-version\fR \fB\-V\fR, \fB\-\-version\fR
@ -260,7 +262,11 @@ $ renice +4 $(pgrep chrome)
.PD 0 .PD 0
.TP .TP
0 0
One or more processes matched the criteria. For pkill and pidwait, one or more One or more processes matched the criteria. For
.B pkill
and
.BR pidwait ,
one or more
processes must also have been successfully signalled or waited for. processes must also have been successfully signalled or waited for.
.TP .TP
1 1
@ -288,7 +294,7 @@ match.
.PP .PP
The The
.B \-O \-\-older .B \-O \-\-older
option will silently fail if /proc is mounted with the \fIsubset=pid\fR option. option will silently fail if \fI/proc\fR is mounted with the \fIsubset=pid\fR option.
.SH BUGS .SH BUGS
The options The options
.B \-n .B \-n
@ -314,7 +320,7 @@ system call which first appeared in Linux 5.3.
.BR skill (1), .BR skill (1),
.BR kill (1), .BR kill (1),
.BR kill (2), .BR kill (2),
.BR cgroups (8) .BR cgroups (8).
.SH AUTHOR .SH AUTHOR
.UR kjetilho@ifi.uio.no .UR kjetilho@ifi.uio.no
Kjetil Torgrim Homme Kjetil Torgrim Homme

View File

@ -15,9 +15,9 @@
.\" 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 "2020-12-22" "" "User Commands" .TH PIDOF 1 "2023-01-16" "" "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 ]
@ -29,32 +29,32 @@ pidof -- find the process ID of a running program
.IR omitpid[,omitpid...]... ] .IR omitpid[,omitpid...]... ]
.RB [ \-S .RB [ \-S
.IR separator ] .IR separator ]
.B program .I program
.RB [ program... ] .IB [ 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
id's on the standard output. id's on the standard output.
.SH OPTIONS .SH OPTIONS
.IP \-s .IP \fB\-s\fP
Single shot - this instructs the program to only return one \fIpid\fP. Single shot - this instructs the program to only return one \fIpid\fP.
.IP \-c .IP \fB\-c\fP
Only return process ids that are running with the same root directory. Only return process ids that are running with the same root directory.
This option is ignored for non-root users, as they will be unable to check This option is ignored for non-root users, as they will be unable to check
the current root directory of processes they do not own. the current root directory of processes they do not own.
.IP \-q .IP \fB\-q\fP
Quiet mode, suppress any output and only sets the exit status accordingly. Quiet mode, suppress any output and only sets the exit status accordingly.
.IP \-w .IP \fB\-w\fP
Show also processes that do not have visible command line (e.g. kernel Show also processes that do not have visible command line (e.g. kernel
worker threads). worker threads).
.IP \-x .IP \fB\-x\fP
Scripts too - this causes the program to also return process id's of Scripts too - this causes the program to also return process id's of
shells running the named scripts. shells running the named scripts.
.IP "-o \fIomitpid\fP" .IP "\fB-o\fP \fIomitpid\fP"
Tells \fIpidof\fP to omit processes with that process id. The special Tells \fBpidof\fP to omit processes with that process id. The special
pid \fB%PPID\fP can be used to name the parent process of the \fIpidof\fP pid \fB%PPID\fP can be used to name the parent process of the \fBpidof\fP
program, in other words the calling shell or shell script. program, in other words the calling shell or shell script.
.IP "-S \fIseparator\fP" .IP "\fB-S\fP \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 \fB\-d\fR option is an alias for this option for sysvinit The \fB\-d\fR option is an alias for this option for sysvinit
@ -69,7 +69,7 @@ At least one program was found with the requested name.
No program was found with the requested name. No program was found with the requested name.
.SH BUGS .SH BUGS
When using the \fI\-x\fP option, When using the \fB\-x\fP option,
.B pidof .B pidof
only has a simple method for detecting scripts and will miss scripts that, only has a simple method for detecting scripts and will miss scripts that,
for example, use env. This limitation is due to how the scripts look in for example, use env. This limitation is due to how the scripts look in
@ -79,4 +79,6 @@ the proc filesystem.
.BR pgrep (1), .BR pgrep (1),
.BR pkill (1) .BR pkill (1)
.SH AUTHOR .SH AUTHOR
Jaromir Capik <jcapik@redhat.com> .UR jcapik@redhat.com
Jaromir Capik
.UE

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" "2023-01-15" "procps-ng" "User Commands" .TH PS "1" "2023-01-16" "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 &
@ -798,7 +798,7 @@ will be destroyed by
.IR init (8) .IR init (8)
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 width of the display
column, the username will be truncated. See the \fB\-o\fR and \fB\-O\fR column, the username will be truncated. See the \fB\-o\fR and \fB\-O\fR
formatting options to customize length. formatting options to customize length.
.PP .PP

View File

@ -21,15 +21,19 @@ skill, snice \- send a signal or report process status
.I expression .I expression
.SH DESCRIPTION .SH DESCRIPTION
These tools are obsolete and unportable. The command syntax is These tools are obsolete and unportable. The command syntax is
poorly defined. Consider using the killall, pkill, and pgrep poorly defined. Consider using the
.BR killall ,
.BR pkill ,
and
.B pgrep
commands instead. commands instead.
.PP .PP
The default signal for skill is TERM. Use \-l or \-L to list The default signal for \fBskill\fP is TERM. Use \fB\-l\fP or \fB\-L\fP to list
available signals. Particularly useful signals include HUP, INT, available signals. Particularly useful signals include HUP, INT,
KILL, STOP, CONT, and 0. Alternate signals may be specified in three KILL, STOP, CONT, and 0. Alternate signals may be specified in three
ways: \-9 \-SIGKILL \-KILL. ways: \fB\-9\fP \fB\-SIGKILL\fP \fB\-KILL\fP.
.PP .PP
The default priority for snice is +4. Priority numbers range from The default priority for \fBsnice\fP is +4. Priority numbers range from
+20 (slowest) to \-20 (fastest). Negative priority numbers are +20 (slowest) to \-20 (fastest). Negative priority numbers are
restricted to administrative users. restricted to administrative users.
.SH OPTIONS .SH OPTIONS
@ -82,7 +86,7 @@ The next expression is a command name.
Match the processes that belong to the same namespace as pid. Match the processes that belong to the same namespace as pid.
.TP .TP
\fB\-\-nslist \fIns,...\fR \fB\-\-nslist \fIns,...\fR
list which namespaces will be considered for the --ns option. list which namespaces will be considered for the \fB\-\-ns\fP option.
Available namespaces: ipc, mnt, net, pid, user, uts. Available namespaces: ipc, mnt, net, pid, user, uts.
.PD .PD
.SH SIGNALS .SH SIGNALS
@ -92,7 +96,7 @@ manual page.
.SH EXAMPLES .SH EXAMPLES
.TP .TP
.B snice -c seti -c crack +7 .B snice -c seti -c crack +7
Slow down seti and crack commands. +Slow down \fBseti\fP and \fBcrack\fP commands.
.TP .TP
.B skill \-KILL \-t /dev/pts/* .B skill \-KILL \-t /dev/pts/*
Kill users on PTY devices. Kill users on PTY devices.

View File

@ -95,7 +95,7 @@ The
.B slabtop .B slabtop
statistic header is tracking how many bytes of slabs are being 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. \fI/proc/meminfo\fR file is tracking information about used slab physical
.SH AUTHORS .SH AUTHORS
Written by Chris Rivera and Robert Love. Written by Chris Rivera and Robert Love.
.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 "8" "2021-03-29" "procps-ng" "System Administration" .TH SYSCTL "8" "2023-01-16" "procps-ng" "System Administration"
.SH NAME .SH NAME
sysctl \- configure kernel parameters at runtime sysctl \- configure kernel parameters at runtime
.SH SYNOPSIS .SH SYNOPSIS
@ -18,7 +18,7 @@ sysctl \- configure kernel parameters at runtime
.SH DESCRIPTION .SH DESCRIPTION
.B sysctl .B sysctl
is used to modify kernel parameters at runtime. The parameters available is used to modify kernel parameters at runtime. The parameters available
are those listed under /proc/sys/. Procfs is required for are those listed under \fI/proc/sys/\fR. Procfs is required for
.B sysctl .B sysctl
support in Linux. You can use support in Linux. You can use
.B sysctl .B sysctl
@ -57,9 +57,9 @@ Use this option to not display the values set to stdout.
Use this option when all arguments prescribe a key to be set. Use this option when all arguments prescribe a key to be set.
.TP .TP
\fB\-p\fR[\fIFILE\fR], \fB\-\-load\fR[=\fIFILE\fR] \fB\-p\fR[\fIFILE\fR], \fB\-\-load\fR[=\fIFILE\fR]
Load in sysctl settings from the file specified or /etc/sysctl.conf if none Load in \fBsysctl\fR settings from the file specified or \fI/etc/sysctl.conf\fR
given. Specifying \- as filename means reading data from standard input. if none given. Specifying \- as filename means reading data from standard
Using this option will mean arguments to input. Using this option will mean arguments to
.B sysctl .B sysctl
are files, which are read in the order they are specified. are files, which are read in the order they are specified.
The file argument may be specified as regular expression. The file argument may be specified as regular expression.
@ -159,7 +159,7 @@ are deprecated. The
.B sysctl .B sysctl
command does not allow changing values of these 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 \fB/proc\fR file system by other means. For example:
.PP .PP
echo 256 > /proc/sys/net/ipv6/neigh/eth0/base_reachable_time echo 256 > /proc/sys/net/ipv6/neigh/eth0/base_reachable_time
.SH FILES .SH FILES

View File

@ -1,4 +1,4 @@
.TH WATCH 1 "2021-04-24" "procps-ng" "User Commands" .TH WATCH 1 "2023-01-16" "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
@ -22,7 +22,7 @@ will show all changes since the first iteration.
\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
interval, in which the smaller values are converted. Both '.' and ',' work interval, in which the smaller values are converted. Both '.' and ',' work
for any locales. The WATCH_INTERVAL environment can be used to persistently for any locales. The \fBWATCH_INTERVAL\fR environment can be used to persistently
set a non-default interval (following the same rules and formatting). set a non-default interval (following the same rules and formatting).
.TP .TP
\fB\-p\fR, \fB\-\-precise\fR \fB\-p\fR, \fB\-\-precise\fR
@ -112,7 +112,7 @@ failed, or command exited up on error.
.B other .B other
The watch will propagate command exit status as child exit status. The watch will propagate command exit status as child exit status.
.SH ENVIRONMENT .SH ENVIRONMENT
The behaviour of The behavior of
.B watch .B watch
is affected by the following environment variables. is affected by the following environment variables.
@ -121,6 +121,7 @@ is affected by the following environment variables.
Update interval, follows the same rules as the Update interval, follows the same rules as the
.B \-\-interval .B \-\-interval
command line option. command line option.
.sp
.SH NOTES .SH NOTES
POSIX option processing is used (i.e., option processing stops at POSIX option processing is used (i.e., option processing stops at
the first non\-option argument). This means that flags after the first non\-option argument). This means that flags after
@ -128,6 +129,7 @@ the first non\-option argument). This means that flags after
don't get interpreted by don't get interpreted by
.BR watch .BR watch
itself. itself.
.sp
.SH BUGS .SH BUGS
Upon terminal resize, the screen will not be correctly repainted until the Upon terminal resize, the screen will not be correctly repainted until the
next scheduled update. All next scheduled update. All
@ -162,8 +164,9 @@ also can get into a state where it rapid-fires as many executions of
as it can to catch up from a previous executions running longer than as it can to catch up from a previous executions running longer than
.B \-\-interval .B \-\-interval
(for example, (for example,
.B netstat .BR netstat (8)
taking ages on a DNS lookup). taking ages on a DNS lookup).
.sp
.SH EXAMPLES .SH EXAMPLES
.PP .PP
To watch for mail, you might do To watch for mail, you might do
@ -201,3 +204,8 @@ watch uname \-r
isn't guaranteed to work across reboots, especially in the face of isn't guaranteed to work across reboots, especially in the face of
.B ntpdate .B ntpdate
(if present) or other bootup time-changing mechanisms) (if present) or other bootup time-changing mechanisms)
.sp
.SH "REPORTING BUGS"
Please send bug reports to
.UR procps@freelists.org
.UE