emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

docs: Tidying of ps,kill and skill manpages

Browse Source 
Some minor tidying of these three man pages using more of the modern
(ish) macros that have been around for a while.

References:
 https://bugs.debian.org/893452
 https://bugs.debian.org/893457
 https://bugs.debian.org/894480

Signed-off-by: Craig Small <csmall@enc.com.au>
This commit is contained in:
Bjarni Ingi Gislason 2018-05-31 21:18:27 +10:00 committed by Craig Small
parent c51b329a32
commit 336d4ab90e
3 changed files with 189 additions and 176 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
kill.1
View File

@ -1,11 +1,12 @@
'\" t .ig
.\" (The preceding line is a note to broken versions of man to tell Written by Albert Cahalan, converted to a man page by Michael K. Johnson
.\" them to pre-process this man page with tbl)
.\" Man page for kill. This manpage is free software; you can redistribute it and/or modify
.\" Licensed under version 2 of the GNU General Public License. it under the terms of the GNU General Public License as published by the
.\" Written by Albert Cahalan; converted to a man page by Free Software Foundation; either version 2 of the License, or
.\" Michael K. Johnson (at your option) any later version.
.TH KILL 1 "October 2011" "procps-ng" "User Commands" ..
.TH KILL 1 "2018-05-31" "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
@ -64,7 +65,7 @@ Kill all processes you can kill.
.B kill \-l 11 .B kill \-l 11
Translate number 11 into a signal name. Translate number 11 into a signal name.
.TP .TP
.B kill -L .B kill \-L
List the available signal choices in a nice table. List the available signal choices in a nice table.
.TP .TP
.B kill 123 543 2341 3453 .B kill 123 543 2341 3453
@ -78,16 +79,16 @@ Send the default signal, SIGTERM, to all those processes.
.BR signal (7), .BR signal (7),
.BR skill (1) .BR skill (1)
.SH STANDARDS .SH STANDARDS
This command meets appropriate standards. The This command meets appropriate standards. The
.B \-L .B \-L
flag is Linux-specific. flag is Linux-specific.
.SH AUTHOR .SH AUTHOR
.UR albert@users.sf.net .MT albert@users.sf.net
Albert Cahalan Albert Cahalan
.UE .ME
wrote kill in 1999 to replace a bsdutils one that was not standards wrote kill in 1999 to replace a bsdutils one that was not standards
compliant. The util-linux one might also work correctly. compliant. The util-linux one might also work correctly.
.SH "REPORTING BUGS" .SH "REPORTING BUGS"
Please send bug reports to Please send bug reports to
.UR procps@freelists.org .MT procps@freelists.org
.UE .ME

304
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-01-13 "procps-ng" "User Commands" .TH PS 1 2018-05-31 "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 &
@ -27,9 +27,7 @@
.SH NAME .SH NAME
ps \- report a snapshot of the current processes. ps \- report a snapshot of the current processes.
.SH SYNOPSIS .SH SYNOPSIS
\fBps\fR [\fIoptions\fR] \fBps\fR [\,\fIoptions\/\fR]
.PP
.PP
.SH DESCRIPTION .SH DESCRIPTION
.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
@ -81,7 +79,7 @@ The use of BSD\-style options will add process state (stat=STAT) to the
default display and show the command args (args=COMMAND) instead of the default display and show the command args (args=COMMAND) instead of the
executable name. You can override this with the executable name. You can override this with the
.B PS_FORMAT .B PS_FORMAT
environment variable. The use of BSD\-style options will also change the environment variable. The use of BSD\-style options will also change the
process selection to include processes on other terminals (TTYs) that are process selection to include processes on other terminals (TTYs) that are
owned by you; alternately, this may be described as setting the selection to owned by you; alternately, this may be described as setting the selection to
be the set of all processes filtered to exclude processes owned by other be the set of all processes filtered to exclude processes owned by other
@ -94,7 +92,6 @@ Except as described below, process selection options are additive. The
default selection is discarded, and then the selected processes are added to default selection is discarded, and then the selected processes are added to
the set of processes to be displayed. A process will thus be shown if it the set of processes to be displayed. A process will thus be shown if it
meets any of the given selection criteria. meets any of the given selection criteria.
.PP
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH "EXAMPLES" .SH "EXAMPLES"
.TP 3 .TP 3
@ -113,21 +110,21 @@ To see every process on the system using BSD syntax:
.B ps\ axu .B ps\ axu
.TP .TP
To print a process tree: To print a process tree:
.B ps\ -ejH .B ps\ \-ejH
.br .br
.B ps\ axjf .B ps\ axjf
.TP .TP
To get info about threads: To get info about threads:
.B ps\ -eLf .B ps\ \-eLf
.br .br
.B ps\ axms .B ps\ axms
.TP .TP
To get security info: To get security info:
.B ps\ -eo euser,ruser,suser,fuser,f,comm,label .B ps\ \-eo euser,ruser,suser,fuser,f,comm,label
.br .br
.B ps\ axZ .B ps\ axZ
.br .br
.B ps\ -eM .B ps\ \-eM
.TP .TP
To see every process running as root (real\ &\ effective\ ID) in user format: To see every process running as root (real\ &\ effective\ ID) in user format:
.B ps\ \-U\ root\ \-u\ root\ u .B ps\ \-U\ root\ \-u\ root\ u
@ -144,12 +141,10 @@ Print only the process IDs of syslogd:
.TP .TP
Print only the name of PID 42: Print only the name of PID 42:
.B ps\ \-q\ 42\ \-o\ comm= .B ps\ \-q\ 42\ \-o\ comm=
.PP
.PP
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH "SIMPLE PROCESS SELECTION" .SH "SIMPLE PROCESS SELECTION"
.TP .TP
.BR a .B a
Lift the BSD\-style "only yourself" restriction, which is imposed upon the Lift the BSD\-style "only yourself" restriction, which is imposed upon the
set of all processes when some BSD\-style (without "\-") options are used or set of all processes when some BSD\-style (without "\-") options are used or
when the when the
@ -224,17 +219,18 @@ or to list all processes when used together with the
option. option.
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.PD .PD
.PP
.SH "PROCESS SELECTION BY LIST" .SH "PROCESS SELECTION BY LIST"
These options accept a single argument in the form of a blank\-separated or These options accept a single argument in the form of a blank\-separated or
comma\-separated list. They can be used multiple times. For example: comma\-separated list. They can be used multiple times. For example:
\fBps\ \-p\ "1\ 2"\ \-p\ 3,4\fR .B ps\ \-p\ "1\ 2"\ \-p\ 3,4
.TP .TP
.RI \- 123 .RI \- 123
Identical to \fB\-\-pid\ \fI123\fR. Identical to
.BI \-\-pid\ 123 \fR.
.TP .TP
.I 123 .I 123
Identical to \fB\-\-pid\ \fI123\fR. Identical to
.BI \-\-pid\ 123 \fR.
.TP .TP
.BI \-C \ cmdlist .BI \-C \ cmdlist
Select by command name. This selects the processes whose executable name is Select by command name. This selects the processes whose executable name is
@ -312,13 +308,16 @@ and
.BR \-\-quick\-pid . .BR \-\-quick\-pid .
.TP .TP
.BI \-q \ pidlist .BI \-q \ pidlist
Select by PID (quick mode). This selects the processes whose process ID numbers appear in Select by PID (quick mode).
This selects the processes whose process ID numbers appear in
.IR pidlist . .IR pidlist .
With this option \fBps\fR reads the necessary info only With this option \fBps\fR reads the necessary info only
for the pids listed in the \fIpidlist\fR and doesn't apply for the pids listed in the
additional filtering rules. The order of pids is unsorted .I pidlist
and preserved. No additional selection options, sorting and doesn't apply additional filtering rules.
and forest type listings are allowed in this mode. The order of pids is unsorted and preserved.
No additional selection options,
sorting and forest type listings are allowed in this mode.
Identical to Identical to
.B q .B q
and and
@ -413,12 +412,10 @@ and
.BR U . .BR U .
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.PD .PD
.PP
.SH "OUTPUT FORMAT CONTROL" .SH "OUTPUT FORMAT CONTROL"
These options are used to choose the information displayed by These options are used to choose the information displayed by
.BR ps . .BR ps .
The output may differ by personality. The output may differ by personality.
.PP
.TP .TP
.B \-c .B \-c
Show different scheduler information for the Show different scheduler information for the
@ -429,7 +426,7 @@ option.
Display security context format (for SELinux). Display security context format (for SELinux).
.TP .TP
.B \-f .B \-f
Do full\-format listing. This option can be combined with many other Do full\-format listing. This option can be combined with many other
UNIX\-style options to add additional columns. It also causes the command UNIX\-style options to add additional columns. It also causes the command
arguments to be printed. When used with arguments to be printed. When used with
.BR \-L , .BR \-L ,
@ -495,8 +492,9 @@ with the BSD personality.
Like Like
.BR \-o , .BR \-o ,
but preloaded with some default columns. Identical to but preloaded with some default columns. Identical to
\fB\-o\ pid,\:\fIformat\fB,\:state,\:tname,\:time,\:command\fR or .BI \-o\ pid,\: format ,\:state,\:tname,\:time,\:command
\fB\-o\ pid,\:\fIformat\fB,\:tname,\:time,\:cmd\fR, or
.BI \-o\ pid,\: format ,\:tname,\:time,\:cmd \fR,
see see
.B \-o .B \-o
below. below.
@ -526,7 +524,7 @@ Explicit width
control control
.RB ( "ps opid,\:wchan:42,\:cmd" ) .RB ( "ps opid,\:wchan:42,\:cmd" )
is offered too. The behavior of is offered too. The behavior of
.B ps -o pid=X,\:comm=Y .B ps \-o pid=X,\:comm=Y
varies with personality; output may be one column named "X,\:comm=Y" or two varies with personality; output may be one column named "X,\:comm=Y" or two
columns named "X" and "Y". Use multiple columns named "X" and "Y". Use multiple
.B \-o .B \-o
@ -558,7 +556,6 @@ Add a column of security data. Identical to
(for SELinux). (for SELinux).
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.PD .PD
.PP
.SH "OUTPUT MODIFIERS" .SH "OUTPUT MODIFIERS"
.\" .TP .\" .TP
.\" .B C .\" .B C
@ -626,7 +623,10 @@ Repeat header lines, one per page of output.
.TP .TP
.BI k \ spec .BI k \ spec
Specify sorting order. Sorting syntax is Specify sorting order. Sorting syntax is
[\fB+\fR|\fB\-\fR]\fIkey\fR[,[\fB+\fR|\fB\-\fR]\fIkey\fR[,...]]. .RB [ + | \- ]\c
.I key\/\c
.RB [,[ + | \- ]\c
.IR key [,...]].
Choose a multi\-letter key from the Choose a multi\-letter key from the
.B STANDARD FORMAT SPECIFIERS .B STANDARD FORMAT SPECIFIERS
section. The "+" is optional since default direction is increasing section. The "+" is optional since default direction is increasing
@ -671,10 +671,13 @@ or
For sorting, obsolete BSD For sorting, obsolete BSD
.B O .B O
option syntax is option syntax is
\fBO\fR[\fB+\fR|\fB\-\fR]\fIk1\fR[,[\fB+\fR|\fB\-\fR]\fIk2\fR[,...]]. .BR O [ + | \- ]\c
.IR k1 [,[\c
.BR + | \- ]\c
.IR k2 [,...]].
It orders the processes listing according to the multilevel sort specified by It orders the processes listing according to the multilevel sort specified by
the sequence of one\-letter short keys the sequence of one\-letter short keys
.IR k1 , k2 ", ..." .IR k1 , k2 ", ...\&"
described in the described in the
.B OBSOLETE SORT KEYS .B OBSOLETE SORT KEYS
section below. The\ "+" is currently optional, merely re\-iterating the section below. The\ "+" is currently optional, merely re\-iterating the
@ -694,8 +697,11 @@ repeatedly forks off short\-lived children to do work.
.TP .TP
.BI \-\-sort \ spec .BI \-\-sort \ spec
Specify sorting order. Sorting syntax is Specify sorting order. Sorting syntax is
[\fB+\fR|\fB\-\fR]\fIkey\fR[,[\fB+\fR|\fB\-\fR]\fIkey\fR[,...]]. Choose a .RI [ + | \- ]\c
multi\-letter key from the .IR key [,[\c
.BR + | \- ]\c
.IR key [,...]].
Choose a multi\-letter key from the
.B STANDARD FORMAT SPECIFIERS .B STANDARD FORMAT SPECIFIERS
section. The "+" is optional since default direction is increasing numerical section. The "+" is optional since default direction is increasing numerical
or lexicographic order. Identical to or lexicographic order. Identical to
@ -713,7 +719,6 @@ Wide output. Use this option twice for unlimited width.
Set screen width. Set screen width.
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.PD .PD
.PP
.SH "THREAD DISPLAY" .SH "THREAD DISPLAY"
.TP .TP
.B H .B H
@ -731,19 +736,18 @@ Show threads after processes.
.B \-T .B \-T
Show threads, possibly with SPID column. Show threads, possibly with SPID column.
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.PD
.PP
.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 section argument can be one of
\fIs\fRimple, .IR s imple,
\fIl\fRist, .IR l ist,
\fIo\fRutput, .IR o utput,
\fIt\fRhreads, .IR t hreads,
\fIm\fRisc or .IR m "isc, or"
\fIa\fRll. .IR a ll.
The argument can be shortened to one of the underlined letters as in: s|l|o|t|m|a. The argument can be shortened to one of the underlined letters as in:
s\^|\^l\^|\^o\^|\^t\^|\^m\^|\^a.
.TP .TP
.B \-\-info .B \-\-info
Print debugging info. Print debugging info.
@ -760,8 +764,6 @@ Print the procps-ng version.
.B \-\-version .B \-\-version
Print the procps-ng version. Print the procps-ng version.
.\" """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.PD
.PP
.SH NOTES .SH NOTES
This This
.B ps .B ps
@ -772,7 +774,6 @@ this
.B ps .B ps
any special permissions. any special permissions.
.PP .PP
.PP
CPU usage is currently expressed as the percentage of time spent running CPU usage is currently expressed as the percentage of time spent running
during the entire lifetime of a process. This is not ideal, and\ it does not during the entire lifetime of a process. This is not ideal, and\ it does not
conform to the standards that conform to the standards that
@ -781,7 +782,7 @@ otherwise conforms to. CPU usage is unlikely to add up to exactly 100%.
.PP .PP
The SIZE and RSS fields don't count some parts of a process including the The SIZE and RSS fields don't count some parts of a process including the
page tables, kernel stack, struct thread_info, and struct task_struct. This page tables, kernel stack, struct thread_info, and struct task_struct. This
is usually at least 20 KiB of memory that is always resident. SIZE is the is usually at least 20\ KiB of memory that is always resident. SIZE is the
virtual size of the process (code+\:data+\:stack). virtual size of the process (code+\:data+\:stack).
.PP .PP
Processes marked <defunct> are dead processes (so\-called "zombies") that Processes marked <defunct> are dead processes (so\-called "zombies") that
@ -791,7 +792,7 @@ 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 \-o and \-O formatting
options to customize length. options to customize length.
.PP .PP
Commands options such as Commands options such as
@ -802,13 +803,15 @@ 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 "x". If that user
doesn't exist, then doesn't exist, then
.B ps .B ps
will assume you really meant "\fBps\fR \fIaux\fR". will assume you really meant
.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
.B flags .B flags
output specifier: output specifier:
.IP .PP
.RS 8 .RS 8
.PD 0 .PD 0
.TP 5 .TP 5
@ -819,13 +822,12 @@ forked but didn't exec
used super\-user privileges used super\-user privileges
.PD .PD
.RE .RE
.PP
.SH "PROCESS STATE CODES" .SH "PROCESS STATE CODES"
Here are the different values that the Here are the different values that the
.BR s , \ stat \ and \ state .BR s ", " stat " and " state
output specifiers (header "STAT" or "S") will display to describe the state output specifiers (header "STAT" or "S") will display to describe the state
of a process: of a process:
.IP .PP
.RS 8 .RS 8
.PD 0 .PD 0
.TP 5 .TP 5
@ -861,7 +863,7 @@ defunct ("zombie") process, terminated but not reaped by its parent
For BSD formats and when the For BSD formats and when the
.B stat .B stat
keyword is used, additional characters may be displayed: keyword is used, additional characters may be displayed:
.IP .PP
.RS 8 .RS 8
.PD 0 .PD 0
.TP 5 .TP 5
@ -884,7 +886,6 @@ is multi-threaded (using CLONE_THREAD, like NPTL pthreads do)
is in the foreground process group is in the foreground process group
.PD .PD
.RE .RE
.PP
.SH "OBSOLETE SORT KEYS" .SH "OBSOLETE SORT KEYS"
These keys are used by the BSD These keys are used by the BSD
.B O .B O
@ -931,8 +932,6 @@ v vsize total VM size in KiB
y priority kernel scheduling priority y priority kernel scheduling priority
.\"K stime system time (conflict, system vs. start time) .\"K stime system time (conflict, system vs. start time)
.TE .TE
.PP
.PP
.SH "AIX FORMAT DESCRIPTORS" .SH "AIX FORMAT DESCRIPTORS"
This This
.B ps .B ps
@ -942,7 +941,7 @@ formatting codes of
and and
.IR printf (3). .IR printf (3).
For example, the normal default output can be produced with this: For example, the normal default output can be produced with this:
\fBps \-eo "%p %y %x %c"\fR. .B ps \-eo """%p %y %x %c""\fR."
The The
.B NORMAL .B NORMAL
codes are described in the next section. codes are described in the next section.
@ -967,7 +966,7 @@ l l l.
.TE .TE
.SH "STANDARD FORMAT SPECIFIERS" .SH "STANDARD FORMAT SPECIFIERS"
Here are the different keywords that may be used to control the output Here are the different keywords that may be used to control the output
format (e.g. with option format (e.g., with option
.BR \-o ) .BR \-o )
or to sort the selected processes with the GNU\-style or to sort the selected processes with the GNU\-style
.B \-\-sort .B \-\-sort
@ -983,8 +982,8 @@ tries to recognize most of the keywords used in other implementations of
.PP .PP
The following user\-defined format specifiers may contain The following user\-defined format specifiers may contain
spaces: spaces:
.BR args , \ cmd , \ comm , \ command , \ fname , \ ucmd , \ ucomm , .BR args ", " cmd ", " comm ", " command ", " fname ", " ucmd ", " ucomm ,
.BR lstart , \ bsdstart , \ start . .BR lstart ", " bsdstart ", " start .
.PP .PP
Some keywords may not be available for sorting. Some keywords may not be available for sorting.
@ -997,8 +996,8 @@ Some keywords may not be available for sorting.
.\" .\"
.TS .TS
expand; expand;
lB1 lB1 lBw(\n[ColSize]n) l1B l1B lBw(\n[ColSize]n)
lB1 l1 l. l1B l1 l.
CODE HEADER DESCRIPTION CODE HEADER DESCRIPTION
%cpu %CPU T{ %cpu %CPU T{
@ -1016,13 +1015,15 @@ machine, expressed as a percentage. (alias
T} T}
args COMMAND T{ args COMMAND T{
command with all its arguments as a string. Modifications to the arguments command with all its arguments as a string.
may be shown. The output in this column may contain spaces. A process Modifications to the arguments may be shown.
marked <defunct> is partly dead, waiting to be fully destroyed by its parent. The output in this column may contain spaces.
A process marked <defunct> is partly dead,
waiting to be fully destroyed by its parent.
Sometimes the process args will be unavailable; when this happens, Sometimes the process args will be unavailable; when this happens,
.B ps .B ps
will instead print the executable name in brackets. (alias will instead print the executable name in brackets. (alias
.BR cmd , \ command ). .BR cmd ", " command ).
See also the See also the
.B comm .B comm
format keyword, the format keyword, the
@ -1053,14 +1054,14 @@ mask of the blocked signals, see
.IR signal (7). .IR signal (7).
According to the width of the field, a 32 or 64\-bit mask in hexadecimal According to the width of the field, a 32 or 64\-bit mask in hexadecimal
format is displayed. (alias format is displayed. (alias
.BR sig_block , \ sigmask ). .BR sig_block ", " sigmask ).
T} T}
bsdstart START T{ bsdstart START T{
time the command started. If the process was started less than 24 hours ago, time the command started. If the process was started less than 24 hours ago,
the output format is "\ HH:MM", else it is " Mmm:SS" (where Mmm is the three the output format is "\ HH:MM", else it is " Mmm:SS" (where Mmm is the three
letters of the month). See also letters of the month). See also
.BR lstart , \ start , \ start_time ", and" \ stime . .BR lstart ", " start ", " start_time ", and " stime .
T} T}
bsdtime TIME T{ bsdtime TIME T{
@ -1070,8 +1071,9 @@ minutes of cpu time.
T} T}
c C T{ c C T{
processor utilization. Currently, this is the integer value of the percent processor utilization.
usage over the lifetime of the process. (see Currently, this is the integer value of the percent usage over the
lifetime of the process. (see
.BR %cpu ). .BR %cpu ).
T} T}
@ -1080,7 +1082,7 @@ mask of the caught signals, see
.IR signal (7). .IR signal (7).
According to the width of the field, a 32 or 64 bits mask in hexadecimal According to the width of the field, a 32 or 64 bits mask in hexadecimal
format is displayed. (alias format is displayed. (alias
.BR sig_catch , \ sigcatch ). .BR sig_catch ", " sigcatch ).
T} T}
cgname CGNAME T{ cgname CGNAME T{
@ -1093,9 +1095,10 @@ T}
class CLS T{ class CLS T{
scheduling class of the process. (alias scheduling class of the process. (alias
.BR policy , \ cls ). .BR policy ", " cls ).
Field's possible values are: Field's possible values are:
.IP "" 2 .sp 1
.in +9n
\- not reported \- not reported
.br .br
TS SCHED_OTHER TS SCHED_OTHER
@ -1113,13 +1116,15 @@ IDL SCHED_IDLE
DLN SCHED_DEADLINE DLN SCHED_DEADLINE
.br .br
? unknown value ? unknown value
.in
T} T}
cls CLS T{ cls CLS T{
scheduling class of the process. (alias scheduling class of the process. (alias
.BR policy , \ cls ). .BR policy ", " cls ).
Field's possible values are: Field's possible values are:
.IP "" 2 .sp 1
.in +9n
\- not reported \- not reported
.br .br
TS SCHED_OTHER TS SCHED_OTHER
@ -1137,13 +1142,14 @@ IDL SCHED_IDLE
DLN SCHED_DEADLINE DLN SCHED_DEADLINE
.br .br
? unknown value ? unknown value
.in
T} T}
cmd CMD T{ cmd CMD T{
see see
.BR args . .BR args .
(alias (alias
.BR args , \ command ). .BR args ", " command ).
T} T}
comm COMMAND T{ comm COMMAND T{
@ -1151,7 +1157,7 @@ command name (only the executable name). Modifications to the command name
will not be shown. A process marked <defunct> is partly dead, waiting to be will not be shown. A process marked <defunct> is partly dead, waiting to be
fully destroyed by its parent. The output in this column may contain spaces. 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 format keyword,
the the
@ -1179,7 +1185,7 @@ command COMMAND T{
See See
.BR args . .BR args .
(alias (alias
.BR args , \ command ). .BR args ", " command ).
T} T}
cp CP T{ cp CP T{
@ -1240,14 +1246,14 @@ effective user name. This will be the textual user ID, if it can be obtained
and the field width permits, or a decimal representation otherwise. The and the field width permits, or a decimal representation otherwise. The
.B n .B n
option can be used to force the decimal representation. (alias option can be used to force the decimal representation. (alias
.BR uname , \ user ). .BR uname ", " user ).
T} T}
f F T{ f F T{
flags associated with the process, see the flags associated with the process, see the
.B PROCESS FLAGS .B PROCESS FLAGS
section. (alias section. (alias
.BR flag , \ flags ). .BR flag ", " flags ).
T} T}
fgid FGID T{ fgid FGID T{
@ -1266,14 +1272,14 @@ flag F T{
see see
.BR f . .BR f .
(alias (alias
.BR f , \ flags ). .BR f ", " flags ).
T} T}
flags F T{ flags F T{
see see
.BR f . .BR f .
(alias (alias
.BR f , \ flag ). .BR f ", " flag ).
T} T}
fname COMMAND T{ fname COMMAND T{
@ -1310,11 +1316,12 @@ mask of the ignored signals, see
.IR signal (7). .IR signal (7).
According to the width of the field, a 32 or 64 bits mask in hexadecimal According to the width of the field, a 32 or 64 bits mask in hexadecimal
format is displayed. (alias format is displayed. (alias
.BR sig_ignore , \ sigignore ). .BR sig_ignore ", " sigignore ).
T} T}
ipcns IPCNS 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 namespaces(7).
T} T}
label LABEL T{ label LABEL T{
@ -1326,7 +1333,7 @@ T}
lstart STARTED T{ lstart STARTED T{
time the command started. See also time the command started. See also
.BR bsdstart , \ start , \ start_time ", and" \ stime . .BR bsdstart ", " start ", " start_time ", and " stime .
T} T}
lsession SESSION T{ lsession SESSION T{
@ -1340,7 +1347,7 @@ T}
lwp LWP T{ lwp LWP T{
light weight process (thread) ID of the dispatchable entity (alias light weight process (thread) ID of the dispatchable entity (alias
.BR spid , \ tid ). .BR spid ", " tid ).
See See
.B tid .B tid
for additional information. for additional information.
@ -1365,15 +1372,18 @@ The number of minor page faults that have occurred with this process.
T} T}
mntns MNTNS 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 namespaces(7).
T} T}
netns NETNS 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 namespaces(7).
T} T}
ni NI T{ ni NI T{
nice value. This ranges from 19 (nicest) to \-20 (not nice to others), nice value.
This ranges from 19 (nicest) to \-20 (not nice to others),
see see
.IR nice (1). .IR nice (1).
(alias (alias
@ -1416,7 +1426,8 @@ see
T} T}
pending PENDING T{ pending PENDING T{
mask of the pending signals. See mask of the pending signals.
See
.IR signal (7). .IR signal (7).
Signals pending on the process are distinct from signals pending on Signals pending on the process are distinct from signals pending on
individual threads. Use the individual threads. Use the
@ -1447,7 +1458,8 @@ a number representing the process ID (alias
T} T}
pidns PIDNS 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 namespaces(7).
T} T}
pmem %MEM T{ pmem %MEM T{
@ -1459,9 +1471,10 @@ T}
policy POL T{ policy POL T{
scheduling class of the process. (alias scheduling class of the process. (alias
.BR class , \ cls ). .BR class ", " cls ).
Possible values are: Possible values are:
.IP "" 2 .sp 1
.in +9n
\- not reported \- not reported
.br .br
TS SCHED_OTHER TS SCHED_OTHER
@ -1479,6 +1492,7 @@ IDL SCHED_IDLE
DLN SCHED_DEADLINE DLN SCHED_DEADLINE
.br .br
? unknown value ? unknown value
.in
T} T}
ppid PPID T{ ppid PPID T{
@ -1504,22 +1518,22 @@ T}
rss RSS T{ rss RSS T{
resident set size, the non\-swapped physical memory that a task has used (in resident set size, the non\-swapped physical memory that a task has used (in
kiloBytes). (alias kilobytes). (alias
.BR rssize , \ rsz ). .BR rssize ", " rsz ).
T} T}
rssize RSS T{ rssize RSS T{
see see
.BR rss . .BR rss .
(alias (alias
.BR rss , \ rsz ). .BR rss ", " rsz ).
T} T}
rsz RSZ T{ rsz RSZ T{
see see
.BR rss . .BR rss .
(alias (alias
.BR rss , \ rssize ). .BR rss ", " rssize ).
T} T}
rtprio RTPRIO T{ rtprio RTPRIO T{
@ -1558,7 +1572,7 @@ T}
sess SESS T{ sess SESS T{
session ID or, equivalently, the process ID of the session leader. (alias session ID or, equivalently, the process ID of the session leader. (alias
.BR session , \ sid ). .BR session ", " sid ).
T} T}
sgi_p P T{ sgi_p P T{
@ -1580,35 +1594,35 @@ sid SID T{
see see
.BR sess . .BR sess .
(alias (alias
.BR sess , \ session ). .BR sess ", " session ).
T} T}
sig PENDING T{ sig PENDING T{
see see
.BR pending . .BR pending .
(alias (alias
.BR pending , \ sig_pend ). .BR pending ", " sig_pend ).
T} T}
sigcatch CAUGHT T{ sigcatch CAUGHT T{
see see
.BR caught . .BR caught .
(alias (alias
.BR caught , \ sig_catch ). .BR caught ", " sig_catch ).
T} T}
sigignore IGNORED T{ sigignore IGNORED T{
see see
.BR ignored . .BR ignored .
(alias (alias
.BR ignored , \ sig_ignore ). .BR ignored ", " sig_ignore ).
T} T}
sigmask BLOCKED T{ sigmask BLOCKED T{
see see
.BR blocked . .BR blocked .
(alias (alias
.BR blocked , \ sig_block ). .BR blocked ", " sig_block ).
T} T}
size SIZE T{ size SIZE T{
@ -1626,7 +1640,7 @@ spid SPID T{
see see
.BR lwp . .BR lwp .
(alias (alias
.BR lwp , \ tid ). .BR lwp ", " tid ).
T} T}
stackp STACKP T{ stackp STACKP T{
@ -1637,7 +1651,7 @@ start STARTED T{
time the command started. If the process was started less than 24 hours ago, time the command started. If the process was started less than 24 hours ago,
the output format is "HH:MM:SS", else it is "\ \ Mmm\ dd" (where Mmm is a the output format is "HH:MM:SS", else it is "\ \ Mmm\ dd" (where Mmm is a
three\-letter month name). See also three\-letter month name). See also
.BR lstart , \ bsdstart , \ start_time ", and" \ stime . .BR lstart ", " bsdstart ", " start_time ", and " stime .
T} T}
start_time START T{ start_time START T{
@ -1646,7 +1660,7 @@ process was not started the same year
.B ps .B ps
was invoked, or "MmmDD" if it was not started the same day, or "HH:MM" was invoked, or "MmmDD" if it was not started the same day, or "HH:MM"
otherwise. See also otherwise. See also
.BR bsdstart , \ start , \ lstart ", and" \ stime . .BR bsdstart ", " start ", " lstart ", and " stime .
T} T}
stat STAT T{ stat STAT T{
@ -1659,7 +1673,7 @@ T}
state S T{ state S T{
see see
.BR s ". (alias" \ s ). .BR s ".\& (alias" \ s ).
T} T}
suid SUID T{ suid SUID T{
@ -1720,7 +1734,7 @@ T}
tid TID T{ tid TID T{
the unique number representing a dispatchable entity (alias the unique number representing a dispatchable entity (alias
.BR lwp , \ spid ). .BR lwp ", " spid ).
This value may also appear as: a process ID (pid); a process group ID (pgrp); This value may also appear as: a process ID (pid); a process group ID (pgrp);
a session ID for the session leader (sid); a thread group ID for the thread a session ID for the session leader (sid); a thread group ID for the thread
group leader (tgid); and a tty process group ID for the process group leader group leader (tgid); and a tty process group ID for the process group leader
@ -1739,7 +1753,7 @@ T}
tname TTY T{ tname TTY T{
controlling tty (terminal). (alias controlling tty (terminal). (alias
.BR tt , \ tty ). .BR tt ", " tty ).
T} T}
tpgid TPGID T{ tpgid TPGID T{
@ -1748,31 +1762,32 @@ connected to, or \-1 if the process is not connected to a tty.
T} T}
trs TRS T{ trs TRS T{
text resident set size, the amount of physical memory devoted to executable code. text resident set size,
the amount of physical memory devoted to executable code.
T} T}
tt TT T{ tt TT T{
controlling tty (terminal). (alias controlling tty (terminal). (alias
.BR tname , \ tty ). .BR tname ", " tty ).
T} T}
tty TT T{ tty TT T{
controlling tty (terminal). (alias controlling tty (terminal). (alias
.BR tname , \ tt ). .BR tname ", " tt ).
T} T}
ucmd CMD T{ ucmd CMD T{
see see
.BR comm . .BR comm .
(alias (alias
.BR comm , \ ucomm ). .BR comm ", " ucomm ).
T} T}
ucomm COMMAND T{ ucomm COMMAND T{
see see
.BR comm . .BR comm .
(alias (alias
.BR comm , \ ucmd ). .BR comm ", " ucmd ).
T} T}
uid UID T{ uid UID T{
@ -1786,7 +1801,7 @@ uname USER T{
see see
.BR euser . .BR euser .
(alias (alias
.BR euser , \ user ). .BR euser ", " user ).
T} T}
unit UNIT T{ unit UNIT T{
@ -1798,15 +1813,17 @@ user USER T{
see see
.BR euser . .BR euser .
(alias (alias
.BR euser , \ uname ). .BR euser ", " uname ).
T} T}
userns USERNS 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 namespaces(7).
T} T}
utsns UTSNS 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 namespaces(7).
T} T}
uunit UUNIT T{ uunit UUNIT T{
@ -1836,8 +1853,6 @@ T}
.TE .TE
.\" ####################################################################### .\" #######################################################################
.PP
.PP
.SH "ENVIRONMENT VARIABLES" .SH "ENVIRONMENT VARIABLES"
The following environment variables could affect The following environment variables could affect
.BR ps : .BR ps :
@ -1849,12 +1864,12 @@ Override default display width.
Override default display height. Override default display height.
.TP .TP
.B PS_PERSONALITY .B PS_PERSONALITY
Set to one of posix, old, linux, bsd, sun, digital... (see section Set to one of posix, old, linux, bsd, sun, digital...\& (see section
.B PERSONALITY .B PERSONALITY
below). below).
.TP .TP
.B CMD_ENV .B CMD_ENV
Set to one of posix, old, linux, bsd, sun, digital... (see section Set to one of posix, old, linux, bsd, sun, digital...\& (see section
.B PERSONALITY .B PERSONALITY
below). below).
.TP .TP
@ -1868,8 +1883,8 @@ Date format.
Not currently supported. Not currently supported.
.TP .TP
.B PS_FORMAT .B PS_FORMAT
Default output format override. You may set this to a format Default output format override.
string of the type used for the You may set this to a format string of the type used for the
.B \-o .B \-o
option. option.
The The
@ -1889,7 +1904,10 @@ When set to "on", acts as
Don't find excuses to ignore bad "features". Don't find excuses to ignore bad "features".
.TP .TP
.B _XPG .B _XPG
Cancel \fBCMD_ENV\fR=\fIirix\fR non\-standard behavior. Cancel
.BR CMD_ENV =\c
.I irix
non\-standard behavior.
.PP .PP
In general, it is a bad idea to set these variables. The one exception is In general, it is a bad idea to set these variables. The one exception is
.B CMD_ENV .B CMD_ENV
@ -1898,7 +1916,6 @@ or
which could be set to Linux for normal systems. Without that setting, which could be set to Linux for normal systems. Without that setting,
.B ps .B ps
follows the useless and bad parts of the Unix98 standard. follows the useless and bad parts of the Unix98 standard.
.PP
.SH "PERSONALITY" .SH "PERSONALITY"
.TS .TS
l l. l l.
@ -1928,15 +1945,11 @@ unix standard
unix95 standard unix95 standard
unix98 standard unix98 standard
.TE .TE
.PP
.PP
.SH "SEE ALSO" .SH "SEE ALSO"
.BR pgrep (1), .BR pgrep (1),
.BR pstree (1), .BR pstree (1),
.BR top (1), .BR top (1),
.BR proc (5). .BR proc (5).
.PP
.PP
.SH STANDARDS .SH STANDARDS
This This
.B ps .B ps
@ -1954,36 +1967,35 @@ X/Open System Interfaces Extension [UP\ XSI]
.IP 5 4 .IP 5 4
ISO/IEC 9945:2003 ISO/IEC 9945:2003
.PD .PD
.PP
.SH AUTHOR .SH AUTHOR
.B ps .B ps
was originally written by was originally written by
.UR lankeste@\:fwi.\:uva.\:nl .MT lankeste@\:fwi.\:uva.\:nl
Branko Lankester Branko Lankester
.UE . .ME .
.UR johnsonm@\:redhat.\:com .MT johnsonm@\:redhat.\:com
Michael K. Johnson Michael K.\& Johnson
.UE .ME
re\-wrote it significantly to use the proc filesystem, changing a few things re\-wrote it significantly to use the proc filesystem, changing a few things
in the process. in the process.
.UR mjshield@\:nyx.\:cs.\:du.\:edu .MT mjshield@\:nyx.\:cs.\:du.\:edu
Michael Shields Michael Shields
.UE .ME
added the pid\-list feature. added the pid\-list feature.
.UR cblake@\:bbn.\:com .MT cblake@\:bbn.\:com
Charles Blake Charles Blake
.UE .ME
added multi\-level sorting, the dirent\-style library, the device added multi\-level sorting, the dirent\-style library, the device
name\-to\-number mmaped database, the approximate binary search directly on name\-to\-number mmaped database, the approximate binary search directly on
System.map, and many code and documentation cleanups. David Mossberger\-Tang System.map, and many code and documentation cleanups. David Mossberger\-Tang
wrote the generic BFD support for psupdate. wrote the generic BFD support for psupdate.
.UR albert@\:users.\:sf.\:net .MT albert@\:users.\:sf.\:net
Albert Cahalan Albert Cahalan
.UE .ME
rewrote ps for full Unix98 and BSD support, along with some ugly hacks for rewrote ps for full Unix98 and BSD support, along with some ugly hacks for
obsolete and foreign syntax. obsolete and foreign syntax.
.PP .PP
Please send bug reports to Please send bug reports to
.UR procps@\:freelists.\:org .MT procps@\:freelists.\:org
.UE . .ME .
No subscription is required or suggested. No subscription is required or suggested.

32
skill.1
View File

@ -1,19 +1,19 @@
'\" t .ig
.\" (The preceding line is a note to broken versions of man to tell Written by Albert Cahalan, converted to a man page by Michael K. Johnson
.\" them to pre-process this man page with tbl)
.\" Man page for skill and snice. This manpage is free software; you can redistribute it and/or modify
.\" Licensed under version 2 of the GNU General Public License. it under the terms of the GNU General Public License as published by the
.\" Written by Albert Cahalan, converted to a man page by Free Software Foundation; either version 2 of the License, or
.\" Michael K. Johnson (at your option) any later version.
.\" ..
.TH SKILL 1 "October 2011" "procps-ng" "User Commands" .TH SKILL 1 "2018-05-31" "procps-ng" "User Commands"
.SH NAME .SH NAME
skill, snice \- send a signal or report process status skill, snice \- send a signal or report process status
.SH SYNOPSIS .SH SYNOPSIS
.B skill .B skill
.RI [ signal ] .RI [ signal ]
.RI [ options ] .RI [ options ]
.I expression .I expression
.br .br
.B snice .B snice
.RI [ "new priority" ] .RI [ "new priority" ]
@ -81,7 +81,7 @@ The next expression is a command name.
\fB\-\-ns \fIpid\fR \fB\-\-ns \fIpid\fR
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,\,\fI...\/\fR
list which namespaces will be considered for the --ns option. list which namespaces will be considered for the --ns option.
Available namespaces: ipc, mnt, net, pid, user, uts. Available namespaces: ipc, mnt, net, pid, user, uts.
.PD .PD
@ -91,7 +91,7 @@ The behavior of signals is explained in
manual page. 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 seti and crack commands.
.TP .TP
.B skill \-KILL \-t /dev/pts/* .B skill \-KILL \-t /dev/pts/*
@ -110,12 +110,12 @@ Stop three users.
.SH STANDARDS .SH STANDARDS
No standards apply. No standards apply.
.SH AUTHOR .SH AUTHOR
.UR albert@users.sf.net .MT albert@users.sf.net
Albert Cahalan Albert Cahalan
.UE .ME
wrote skill and snice in 1999 as a replacement for a non-free wrote skill and snice in 1999 as a replacement for a non-free
version. version.
.SH "REPORTING BUGS" .SH "REPORTING BUGS"
Please send bug reports to Please send bug reports to
.UR procps@freelists.org .MT procps@freelists.org
.UE .ME