← Back to branch summary

~ubuntu-branches/ubuntu/saucy/procps/saucy

« back to all changes in this revision

Viewing changes to ps/ps.1

  • Committer: Package Import Robot
  • Author(s): Oliver Grawert
  • Date: 2012-06-20 13:12:40 UTC
  • mfrom: (2.1.21 sid)
  • Revision ID: package-import@ubuntu.com-20120620131240-923p0d8q88bmk3ac
Tags: 1:3.3.3-2ubuntu1
* Merge from Debian unstable.  Remaining changes:
  - debian/sysctl.d (Ubuntu-specific):
    + 10-console-messages.conf: stop low-level kernel messages on console.
    + 10-kernel-hardening.conf: add the kptr_restrict setting
    + 10-keyboard.conf.powerpc: mouse button emulation on PowerPC.
    + 10-network-security.conf: enable rp_filter and SYN-flood protection.
    + 10-ptrace.conf: describe new PTRACE setting.
    + 10-zeropage.conf: safe mmap_min_addr value for graceful fall-back.
    + README: describe how this directory is supposed to work.
  - debian/upstart (Ubuntu-specific): upstart configuration to replace old
    style sysv init script

Show diffs side-by-side

added added

removed removed

Lines of Context:
ps/ps.1
4
4
.\" Quick hack conversion by Albert Cahalan, 1998.
5
5
.\" Licensed under version 2 of the Gnu General Public License.
6
6
.\"
7
 
.TH PS 1 "February 25, 2010" "Linux" "Linux User's Manual"
 
7
.TH PS 1 "December 2011" "procps-ng" "User Commands"
8
8
.\"
9
9
.\" To render this page:
10
10
.\"    groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
12
12
.\"    tbl ps.1 | troff -Ww -man -z
13
13
.\"    groff -t -man -Tps ps.1 | ps2pdf - - > ps.pdf
14
14
.\"
15
 
.\" The '70s called. They want their perfect justification,
16
 
.\" hyphenation, and double-spaced sentences back.
 
15
.\" Ragged-right text.
17
16
.na
 
17
.\" Disable hyphenation.
18
18
.nh
19
 
.if n .ss 12 0
20
 
.\"
21
19
.\"
22
20
.\" ColSize is used for the format spec table.
23
21
.\" It's the left margin, minus the right, minus
24
22
.\" the space needed for the 1st two columns.
25
23
.\" Making it messy: inches, ens, points, scaled points...
26
24
.\"
27
 
.nr ColSize ((\n(.lu-\n(.iu/\n(.Hu-26u)n)
28
 
.\"
29
 
.\" This is for command options
30
 
.nr OptSize (16u)
31
 
.\"
32
 
.\" l=\n(.l
33
 
.\" i=\n(.i
34
 
.\" o=\n(.o
35
 
.\" H=\n(.H
36
 
.\" s=\n(.s
37
 
.\" ColSize=\n[ColSize]
38
 
.\" 
39
 
.\" Macro for easy option formatting:   .opt \-x
40
 
.de opt              
41
 
.  TP \\n[OptSize]
42
 
.  BI \\$*
43
 
..
 
25
.nr ColSize ((\n[.l] - \n[.i]) / 1n - 29)
44
26
.\"
45
27
.SH NAME
46
28
ps \- report a snapshot of the current processes.
50
32
.PP
51
33
.SH DESCRIPTION
52
34
.B ps
53
 
displays information about a selection of the active processes.
54
 
If you want a repetitive update of the selection and the
55
 
displayed information, use\ \fItop\fR(1) instead.
 
35
displays information about a selection of the active processes.  If you want
 
36
a repetitive update of the selection and the displayed information, use
 
37
.IR top (1)
 
38
instead.
56
39
.P
57
 
This version of \fBps\fR accepts several kinds of options:
 
40
This version of
 
41
.B ps
 
42
accepts several kinds of options:
 
43
.IP
58
44
.PD 0
59
45
.IP 1 4
60
46
UNIX options, which may be grouped and must be preceded by a dash.
65
51
.PD
66
52
.PP
67
53
Options of different types may be freely mixed, but conflicts can appear.
68
 
There are some synonymous options, which are functionally identical, due
69
 
to the many standards and \fBps\fR implementations that this \fBps\fR is
70
 
compatible with.
71
 
.P
72
 
Note that "\fBps\ \-aux\fR" is distinct from "\fBps\ aux\fR".
73
 
The POSIX and UNIX standards require that "\fBps\ \-aux\fR" print all
74
 
processes owned by a user named "x", as well as printing all processes
75
 
that would be selected by the \fB\-a\fR option. If the user named "x" does
76
 
not exist, this \fBps\fR may interpret the command as "\fBps\ aux\fR"
77
 
instead and print a warning. This behavior is intended to aid in
78
 
transitioning old scripts and habits. It is fragile, subject to change,
79
 
and thus should not be relied upon.
80
 
.P
81
 
By default, \fBps\fR selects all processes
82
 
with the same effective user ID (euid=EUID) as the current user
83
 
and
84
 
associated with the same terminal as the invoker.
85
 
It displays the process ID (pid=PID),
86
 
the terminal associated with the process (tname=TTY),
87
 
the cumulated CPU time in [DD\-]hh:mm:ss format (time=TIME),
88
 
and the executable name (ucmd=CMD).
89
 
Output is unsorted by default.
 
54
There are some synonymous options, which are functionally identical, due to
 
55
the many standards and
 
56
.B ps
 
57
implementations that this
 
58
.B ps
 
59
is compatible with.
 
60
.P
 
61
Note that "\fBps \-aux\fR" is distinct from "\fBps\ aux\fR".  The POSIX and
 
62
UNIX standards require that "\fBps\ \-aux\fR" print all processes owned by a
 
63
user named "x", as well as printing all processes that would be selected by
 
64
the
 
65
.B \-a
 
66
option.  If the user named "x" does not exist, this
 
67
.B ps
 
68
may interpret the command as "\fBps\ aux\fR" instead and print a warning.
 
69
This behavior is intended to aid in transitioning old scripts and habits.  It
 
70
is fragile, subject to change, and thus should not be relied upon.
 
71
.P
 
72
By default,
 
73
.B ps
 
74
selects all processes with the same effective user ID (euid=EUID) as the
 
75
current user and associated with the same terminal as the invoker.  It
 
76
displays the process ID (pid=PID), the terminal associated with the process
 
77
(tname=TTY), the cumulated CPU time in [DD\-]hh:mm:ss format (time=TIME), and
 
78
the executable name (ucmd=CMD).  Output is unsorted by default.
90
79
.P
91
80
The use of BSD\-style options will add process state (stat=STAT) to the
92
81
default display and show the command args (args=COMMAND) instead of the
93
 
executable name. You can override this with the \fBPS_FORMAT\fR
 
82
executable name.  You can override this with the
 
83
.B PS_FORMAT
94
84
environment variable. The use of BSD\-style options will also change the
95
 
process selection to include processes on other terminals (TTYs) that
96
 
are owned by you; alternately, this may be described as setting the
97
 
selection to be the set of all processes filtered to exclude
98
 
processes owned by other users or not on a terminal. These effects
99
 
are not considered when options are described as being "identical" below,
100
 
so \fB\-M\fR will be considered identical to \fBZ\fR and so on.
 
85
process selection to include processes on other terminals (TTYs) that are
 
86
owned by you; alternately, this may be described as setting the selection to
 
87
be the set of all processes filtered to exclude processes owned by other
 
88
users or not on a terminal.  These effects are not considered when options
 
89
are described as being "identical" below, so
 
90
.B \-M
 
91
will be considered identical to \fBZ\fR and so on.
101
92
.P
102
 
Except as described below, process selection options are additive.
103
 
The default selection is discarded, and then the selected processes
104
 
are added to the set of processes to be displayed.
105
 
A\ process will thus be shown if it meets any of the given
106
 
selection criteria.
 
93
Except as described below, process selection options are additive.  The
 
94
default selection is discarded, and then the selected processes are added to
 
95
the set of processes to be displayed.  A process will thus be shown if it
 
96
meets any of the given selection criteria.
107
97
.PP
108
98
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
109
99
.SH "EXAMPLES"
147
137
.br
148
138
.B ps\ axo\ stat,euid,ruid,tty,tpgid,sess,pgrp,ppid,pid,pcpu,comm
149
139
.br
150
 
.B ps\ \-eopid,tt,user,fname,tmout,f,wchan
 
140
.B ps\ \-Ao\ pid,tt,user,fname,tmout,f,wchan
151
141
.TP
152
142
Print only the process IDs of syslogd:
153
143
.B ps\ \-C\ syslogd\ \-o\ pid=
158
148
.PP
159
149
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
160
150
.SH "SIMPLE PROCESS SELECTION"
161
 
 
162
 
.opt a
163
 
Lift the BSD\-style "only yourself" restriction, which is imposed upon
164
 
the set of all processes when some BSD\-style (without\ "\-") options
165
 
are used or when the \fBps\fR personality setting is BSD\-like.
166
 
The set of processes selected in this manner is
167
 
in addition to the set of processes selected by other means.
168
 
An alternate description is that this option causes \fBps\fR to
169
 
list all processes with a terminal (tty),
170
 
or to list all processes when used together with the \fBx\fR option.
171
 
 
172
 
.opt \-A
173
 
Select all processes.  Identical to \fB\-e\fR.
174
 
 
175
 
.opt \-a
176
 
Select all processes except both session leaders (see \fIgetsid\fR(2)) and
177
 
processes not associated with a terminal.
178
 
 
179
 
.opt \-d
 
151
.TP
 
152
.BR a
 
153
Lift the BSD\-style "only yourself" restriction, which is imposed upon the
 
154
set of all processes when some BSD\-style (without "\-") options are used or
 
155
when the
 
156
.B ps
 
157
personality setting is BSD\-like.  The set of processes selected in this
 
158
manner is in addition to the set of processes selected by other means.  An
 
159
alternate description is that this option causes
 
160
.B ps
 
161
to list all processes with a terminal (tty), or to list all processes when
 
162
used together with the
 
163
.B x
 
164
option.
 
165
.TP
 
166
.B \-A
 
167
Select all processes.  Identical to
 
168
.BR \-e .
 
169
.TP
 
170
.B \-a
 
171
Select all processes except both session leaders (see
 
172
.IR getsid (2))
 
173
and processes not associated with a terminal.
 
174
.TP
 
175
.B \-d
180
176
Select all processes except session leaders.
181
 
 
182
 
.opt \-\-deselect
 
177
.TP
 
178
.B \-\-deselect
183
179
Select all processes except those that fulfill the specified conditions
184
 
(negates the selection). Identical to \fB\-N\fR.
185
 
 
186
 
 
187
 
.opt \-e
188
 
Select all processes.  Identical to \fB\-A\fR.
189
 
 
 
180
(negates the selection).  Identical to
 
181
.BR \-N .
 
182
.TP
 
183
.B \-e
 
184
Select all processes.  Identical to
 
185
.BR \-A .
190
186
.\" Current "g" behavior: add in the session leaders, which would
191
187
.\" be excluded in the sunos4 personality. Supposed "g" behavior:
192
188
.\" add in the group leaders -- at least according to the SunOS 4
193
189
.\" man page on the FreeBSD site. Uh oh. I think I had tested SunOS
194
190
.\" though, so maybe the code is correct.
195
 
 
196
 
.opt g
 
191
.TP
 
192
.B g
197
193
Really all, even session leaders.  This flag is obsolete and may be
198
 
discontinued in a future release. It is normally implied by the \fBa\fR flag,
199
 
and is only useful when operating in the sunos4 personality.
200
 
 
201
 
.opt \-N
 
194
discontinued in a future release.  It is normally implied by the
 
195
.B a
 
196
flag, and is only useful when operating in the sunos4 personality.
 
197
.TP
 
198
.B \-N
202
199
Select all processes except those that fulfill the specified conditions
203
 
(negates the selection). Identical to \fB\-\-deselect\fR.
204
 
 
205
 
.opt T
 
200
(negates the selection).  Identical to
 
201
.BR \-\-deselect .
 
202
.TP
 
203
.B T
206
204
Select all processes associated with this terminal.  Identical to the
207
 
\fBt\fR option without any argument.
208
 
 
209
 
.opt r
 
205
.B t
 
206
option without any argument.
 
207
.TP
 
208
.B r
210
209
Restrict the selection to only running processes.
211
 
 
212
 
.opt x
213
 
Lift the BSD\-style "must have a tty" restriction, which is imposed upon
214
 
the set of all processes when some BSD\-style (without\ "\-") options
215
 
are used or when the \fBps\fR personality setting is BSD\-like.
216
 
The set of processes selected in this manner is
217
 
in addition to the set of processes selected by other means.
218
 
An alternate description is that this option causes \fBps\fR to
219
 
list all processes owned by you (same EUID as \fBps\fR),
220
 
or to list all processes when used together with the \fBa\fR option.
221
 
 
 
210
.TP
 
211
.B x
 
212
Lift the BSD\-style "must have a tty" restriction, which is imposed upon the
 
213
set of all processes when some BSD\-style (without "\-") options are used or
 
214
when the
 
215
.B ps
 
216
personality setting is BSD\-like.  The set of processes selected in this
 
217
manner is in addition to the set of processes selected by other means.  An
 
218
alternate description is that this option causes
 
219
.B ps
 
220
to list all processes owned by you (same EUID as
 
221
.BR ps ),
 
222
or to list all processes when used together with the
 
223
.B a
 
224
option.
222
225
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
223
226
.PD
224
227
.PP
225
228
.SH "PROCESS SELECTION BY LIST"
226
 
These options accept a single argument in the form of a blank\-separated
227
 
or comma\-separated list.  They can be used multiple times.
228
 
For\ example:\ \fBps\ \-p\ "1\ 2"\ \-p\ 3,4\fR
229
 
.P
230
 
 
231
 
.opt \-\fI123\fR
232
 
Identical to \fB\-\-sid\ \fI123\fR.
233
 
 
234
 
.opt \fI123\fR
235
 
Identical to \fB\-\-pid\ \fI123\fR.
236
 
 
237
 
.opt \-C \ cmdlist
238
 
Select by command name.
239
 
.br
240
 
This selects the processes whose executable name is given in
241
 
\fIcmdlist\fR.
242
 
 
243
 
.opt \-G \ grplist
244
 
Select by real group ID (RGID) or name.
245
 
.br
246
 
This selects the processes whose real group name or ID is in the
247
 
\fIgrplist\fR list.  The real group ID identifies the group of the user
248
 
who created the process, see \fIgetgid\fR(2).
249
 
 
250
 
.opt \-g \ grplist
251
 
Select by session OR by effective group name.
252
 
.br
253
 
Selection by session is specified by many standards,
254
 
but selection by effective group is the logical behavior that
255
 
several other operating systems use.
256
 
This \fBps\fR will select by session when the list
257
 
is completely numeric (as\ sessions\ are).
258
 
Group ID numbers will work only when some group names are also specified.
259
 
See the \fB\-s\fR and \fB\-\-group\fR options.
260
 
 
261
 
.opt \-\-Group \ grplist
262
 
Select by real group ID (RGID) or name.  Identical to \fB\-G\fR.
263
 
 
264
 
.opt \-\-group \ grplist
265
 
Select by effective group ID (EGID) or name.
266
 
.br
267
 
This selects the processes whose effective group name or ID is in
268
 
\fIgrouplist\fR.  The effective group ID describes the group whose file
269
 
access permissions are used by the process (see\ \fIgetegid\fR(2)).
270
 
The \fB\-g\fR option is often an alternative to\ \fB\-\-group\fR.
271
 
 
272
 
.opt p \ pidlist
273
 
Select by process ID.  Identical to \fB\-p\fR and\ \fB\-\-pid\fR.
274
 
 
275
 
.opt \-p \ pidlist
276
 
Select by PID.
277
 
.br
278
 
This selects the processes whose process ID numbers appear in
279
 
\fIpidlist\fR.  Identical to \fBp\fR and\ \fB\-\-pid\fR.
280
 
 
281
 
.opt \-\-pid \ pidlist
282
 
Select by process\ ID.  Identical to \fB\-p\fR\ and\ \fBp\fR.
283
 
 
284
 
.opt \-\-ppid \ pidlist
285
 
Select by parent process\ ID.
286
 
This selects the processes
287
 
with a parent\ process\ ID in \fIpidlist\fR.
288
 
That\ is, it selects processes that are children
289
 
of those listed in \fIpidlist\fR.
290
 
 
291
 
.opt \-s \ sesslist
292
 
Select by session ID.
293
 
.br
294
 
This selects the processes
295
 
with a session ID specified in\ \fIsesslist\fR.
296
 
 
297
 
.opt \-\-sid \ sesslist
298
 
Select by session\ ID.  Identical to\ \fB\-s\fR.
299
 
 
300
 
.opt t \ ttylist
301
 
Select by tty.  Nearly identical to \fB\-t\fR and \fB\-\-tty\fR,
302
 
but can also be used with an empty \fIttylist\fR to indicate
303
 
the terminal associated with \fBps\fR.
304
 
Using the \fBT\fR option is considered cleaner than using \fBt\fR with
305
 
an\ empty\ \fIttylist\fR.
306
 
 
307
 
.opt \-t \ ttylist
308
 
Select by tty.
309
 
.br
310
 
This selects the processes associated with the terminals
311
 
given in \fIttylist\fR.
 
229
These options accept a single argument in the form of a blank\-separated or
 
230
comma\-separated list.  They can be used multiple times.  For example:
 
231
\fBps\ \-p\ "1\ 2"\ \-p\ 3,4\fR
 
232
.TP
 
233
.RI \- 123
 
234
Identical to \fB\-\-pid\ \fI123\fR.
 
235
.TP
 
236
.I 123
 
237
Identical to \fB\-\-pid\ \fI123\fR.
 
238
.TP
 
239
.BI \-C \ cmdlist
 
240
Select by command name.  This selects the processes whose executable name is
 
241
given in
 
242
.IR cmdlist .
 
243
.TP
 
244
.BI \-G \ grplist
 
245
Select by real group ID (RGID) or name.  This selects the processes whose
 
246
real group name or ID is in the
 
247
.I grplist
 
248
list.  The real group ID identifies the group of the user who created the
 
249
process, see
 
250
.IR getgid (2).
 
251
.TP
 
252
.BI \-g \ grplist
 
253
Select by session OR by effective group name.  Selection by session is
 
254
specified by many standards, but selection by effective group is the logical
 
255
behavior that several other operating systems use.  This
 
256
.B ps
 
257
will select by session when the list is completely numeric (as\ sessions\
 
258
are).  Group ID numbers will work only when some group names are also
 
259
specified.  See the
 
260
.B \-s
 
261
and
 
262
.B \-\-group
 
263
options.
 
264
.TP
 
265
.BI \-\-Group \ grplist
 
266
Select by real group ID (RGID) or name.  Identical to
 
267
.BR \-G .
 
268
.TP
 
269
.BI \-\-group \ grplist
 
270
Select by effective group ID (EGID) or name.  This selects the processes
 
271
whose effective group name or ID is in
 
272
.IR grouplist .
 
273
The effective group ID describes the group whose file access permissions are
 
274
used by the process (see
 
275
.IR getegid (2)).
 
276
The
 
277
.B \-g
 
278
option is often an alternative to
 
279
.BR \-\-group .
 
280
.TP
 
281
.BI p \ pidlist
 
282
Select by process ID.  Identical to
 
283
.B \-p
 
284
and
 
285
.BR \-\-pid .
 
286
.TP
 
287
.BI \-p \ pidlist
 
288
Select by PID.  This selects the processes whose process ID numbers appear in
 
289
.IR pidlist .
 
290
Identical to
 
291
.B p
 
292
and
 
293
.BR \-\-pid .
 
294
.TP
 
295
.BI  \-\-pid \ pidlist
 
296
Select by process\ ID.  Identical to
 
297
.B \-p
 
298
and
 
299
.BR p .
 
300
.TP
 
301
.BI \-\-ppid \ pidlist
 
302
Select by parent process ID.  This selects the processes with a parent
 
303
process\ ID in
 
304
.IR pidlist .
 
305
That is, it selects processes that are children of those listed in
 
306
.IR pidlist .
 
307
.TP
 
308
.BI \-s \ sesslist
 
309
Select by session ID.  This selects the processes with a session ID specified
 
310
in
 
311
.IR sesslist .
 
312
.TP
 
313
.BI \-\-sid \ sesslist
 
314
Select by session\ ID.  Identical to
 
315
.BR \-s .
 
316
.TP
 
317
.BI t \ ttylist
 
318
Select by tty.  Nearly identical to
 
319
.B \-t
 
320
and
 
321
.BR \-\-tty ,
 
322
but can also
 
323
be used with an empty
 
324
.I ttylist
 
325
to indicate the terminal associated with
 
326
.BR ps .
 
327
Using the
 
328
.B T
 
329
option is considered cleaner than using
 
330
.B t
 
331
with an empty
 
332
.IR ttylist .
 
333
.TP
 
334
.BI \-t \ ttylist
 
335
Select by tty.  This selects the processes associated with the terminals
 
336
given in
 
337
.IR ttylist .
312
338
Terminals (ttys, or screens for text output) can be specified in several
313
 
forms: /dev/ttyS1, ttyS1, S1.
314
 
A\ plain "\-" may be used to select processes not attached to any terminal.
315
 
 
316
 
.opt \-\-tty \ ttylist
317
 
Select by terminal.  Identical to \fB\-t\fR and\ \fBt\fR.
318
 
 
319
 
.opt U \ userlist
320
 
Select by effective user ID (EUID) or name.
321
 
.br
322
 
This selects the processes whose effective user name
323
 
or ID is in \fIuserlist\fR.
324
 
The effective user\ ID describes the user whose file
325
 
access permissions are used by the process
326
 
(see\ \fIgeteuid\fR(2)).
327
 
Identical to \fB\-u\fR and\ \fB\-\-user\fR.
328
 
 
329
 
.opt \-U \ userlist
330
 
Select by real user ID (RUID) or name.
331
 
.br
332
 
It selects the processes whose real user name or ID is in the
333
 
\fIuserlist\fR list.
334
 
The real user ID identifies the user who created the process,
335
 
see\ \fIgetuid\fR(2).
336
 
 
337
 
.opt \-u \ userlist
338
 
Select by effective user ID (EUID) or name.
339
 
.br
340
 
This selects the processes whose effective user name or ID is in
341
 
\fIuserlist\fR.  The effective user ID describes the user whose file
342
 
access permissions are used by the process (see\ \fIgeteuid\fR(2)).
343
 
Identical to \fBU\fR and \fB\-\-user\fR.
344
 
 
345
 
.opt \-\-User \ userlist
346
 
Select by real user ID (RUID) or name.  Identical to \fB\-U\fR.
347
 
 
348
 
.opt \-\-user \ userlist
349
 
Select by effective user ID (EUID) or name.
350
 
Identical to \fB\-u\fR and\ \fBU\fR.
351
 
 
 
339
forms: /dev/ttyS1, ttyS1, S1.  A plain "\-" may be used to select processes
 
340
not attached to any terminal.
 
341
.TP
 
342
.BI \-\-tty \ ttylist
 
343
Select by terminal.  Identical to
 
344
.B \-t
 
345
and
 
346
.BR t .
 
347
.TP
 
348
.BI U \ userlist
 
349
Select by effective user ID (EUID) or name.  This selects the processes whose
 
350
effective user name or ID is in
 
351
.IR userlist .
 
352
The effective user ID describes the user whose file access permissions are
 
353
used by the process (see
 
354
.IR  geteuid (2)).
 
355
Identical to
 
356
.B \-u
 
357
and
 
358
.BR \-\-user .
 
359
.TP
 
360
.BI \-U \ userlist
 
361
Select by real user ID (RUID) or name.  It selects the processes whose real
 
362
user name or ID is in the
 
363
.I userlist
 
364
list.  The real user ID identifies the user who created the process, see
 
365
.IR getuid (2).
 
366
.TP
 
367
.BI \-u \ userlist
 
368
Select by effective user ID (EUID) or name.  This selects the processes whose
 
369
effective user name or ID is in
 
370
.IR userlist .
 
371
 
 
372
The effective user ID describes the user whose file
 
373
access permissions are used by the process (see
 
374
.IR geteuid (2)).
 
375
Identical to
 
376
.B U
 
377
and
 
378
.BR \-\-user .
 
379
.TP
 
380
.BI \-\-User \ userlist
 
381
Select by real user ID (RUID) or name.  Identical to
 
382
.BR \-U .
 
383
.TP
 
384
.BI \-\-user \ userlist
 
385
Select by effective user ID (EUID) or name.  Identical to
 
386
.B \-u
 
387
and
 
388
.BR U .
352
389
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
353
390
.PD
354
391
.PP
355
392
.SH "OUTPUT FORMAT CONTROL"
356
 
These options are used to choose the information displayed by \fBps\fR.
 
393
These options are used to choose the information displayed by
 
394
.BR ps .
357
395
The output may differ by personality.
358
396
.PP
359
 
 
360
 
.opt \-c
361
 
Show different scheduler information for the \fB\-l\fR option.
362
 
 
363
 
.opt \-\-context
364
 
Display security context format (for\ SE\ Linux).
365
 
 
366
 
.opt \-f
367
 
Do full\-format listing. This option can be combined with many
368
 
other UNIX\-style options to add additional columns. It also causes
369
 
the command arguments to be printed. When used with \fB\-L\fR, the
370
 
NLWP (number of threads) and LWP (thread ID) columns will be added.
371
 
See the \fBc\fR option, the format keyword \fBargs\fR, and the
372
 
format keyword \fBcomm\fR.
373
 
 
374
 
.opt \-F
375
 
Extra full format. See the \fB\-f\fR option, which \fB\-F\fR implies.
376
 
 
377
 
.opt \-\-format \ format
378
 
user\-defined format.  Identical to \fB\-o\fR and \fBo\fR.
379
 
 
380
 
.opt j
 
397
.TP
 
398
.B \-c
 
399
Show different scheduler information for the
 
400
.B \-l
 
401
option.
 
402
.TP
 
403
.B \-\-context
 
404
Display security context format (for SE Linux).
 
405
.TP
 
406
.B \-f
 
407
Do full\-format listing. This option can be combined with many other
 
408
UNIX\-style options to add additional columns.  It also causes the command
 
409
arguments to be printed.  When used with
 
410
.BR \-L ,
 
411
the NLWP (number of threads) and LWP (thread ID) columns will be added.  See
 
412
the
 
413
.B c
 
414
option, the format keyword
 
415
.BR args ,
 
416
and the format keyword
 
417
.BR comm .
 
418
.TP
 
419
.B \-F
 
420
Extra full format.  See the
 
421
.B \-f
 
422
option, which
 
423
.B \-F
 
424
implies.
 
425
.TP
 
426
.BI \-\-format \ format
 
427
user\-defined format.  Identical to
 
428
.B \-o
 
429
and
 
430
.BR o .
 
431
.TP
 
432
.B j
381
433
BSD job control format.
382
 
 
383
 
.opt \-j
384
 
Jobs format
385
 
 
386
 
.opt l
 
434
.TP
 
435
.B \-j
 
436
Jobs format.
 
437
.TP
 
438
.B l
387
439
Display BSD long format.
388
 
 
389
 
.opt \-l
390
 
Long format. The \fB\-y\fR option is often useful with this.
391
 
 
392
 
.opt \-M
393
 
Add a column of security data. Identical to \fBZ\fR (for\ SE\ Linux).
394
 
 
395
 
.opt O \ format
396
 
is preloaded \fBo\fR (overloaded).
397
 
.br
398
 
The BSD \fBO\fR option can act like \fB\-O\fR (user\-defined output
399
 
format with some common fields predefined) or can be used to specify
400
 
sort order.  Heuristics are used to determine the behavior of this
401
 
option. To ensure that the desired behavior is obtained (sorting or
402
 
formatting), specify the option in some other way
403
 
(e.g. with \fB\-O\fR or \fB\-\-sort\fR).
404
 
When used as a formatting option, it is identical to \fB\-O\fR, with the
405
 
BSD\ personality.
406
 
 
407
 
.opt \-O \ format
408
 
Like \fB\-o\fR, but preloaded with some default columns.
409
 
Identical to \fB\-o\ pid,\fIformat\fB,state,tname,time,command\fR
410
 
or \fB\-o\ pid,\fIformat\fB,tname,time,cmd\fR, see\ \fB\-o\fR\ below.
411
 
 
412
 
.opt o \ format
413
 
Specify user\-defined format.  Identical to \fB\-o\fR and
414
 
\fB\-\-format\fR.
415
 
 
416
 
.opt \-o \ format
 
440
.TP
 
441
.B \-l
 
442
Long format.  The
 
443
.B \-y
 
444
option is often useful with this.
 
445
.TP
 
446
.B \-M
 
447
Add a column of security data.  Identical to
 
448
.B Z
 
449
(for SE Linux).
 
450
.TP
 
451
.BI O \ format
 
452
is preloaded
 
453
.B o
 
454
(overloaded).  The BSD
 
455
.B O
 
456
option can act like
 
457
.B \-O
 
458
(user\-defined output format with some common fields predefined) or can be
 
459
used to specify sort order.  Heuristics are used to determine the behavior of
 
460
this option.  To ensure that the desired behavior is obtained (sorting or
 
461
formatting), specify the option in some other way (e.g.  with
 
462
.B \-O
 
463
or
 
464
.BR \-\-sort ).
 
465
When used as a formatting option, it is identical to
 
466
.BR \-O ,
 
467
with the BSD personality.
 
468
.TP
 
469
.BI \-O \ format
 
470
Like
 
471
.BR \-o ,
 
472
but preloaded with some default columns.  Identical to
 
473
\fB\-o\ pid,\:\fIformat\fB,\:state,\:tname,\:time,\:command\fR or
 
474
\fB\-o\ pid,\:\fIformat\fB,\:tname,\:time,\:cmd\fR,
 
475
see
 
476
.B \-o
 
477
below.
 
478
.TP
 
479
.BI o \ format
 
480
Specify user\-defined format.  Identical to
 
481
.B \-o
 
482
and
 
483
.BR \-\-format .
 
484
.TP
 
485
.BI \-o \ format
417
486
User\-defined format.
418
 
.br
419
 
\fIformat\fR is a single argument in the form of a
420
 
blank\-separated or comma\-separated list, which offers
421
 
a way to specify individual output columns.
422
 
The recognized keywords are described in the \fBSTANDARD FORMAT
423
 
SPECIFIERS\fR section below.
424
 
Headers may be
425
 
renamed (\fBps\ \-o\ pid,ruser=RealUser\ \-o\ comm=Command\fR) as desired.
426
 
If all column headers are empty (\fBps\ \-o\ pid=\ \-o\ comm=\fR) then the
427
 
header line will not be output. Column width will increase as
428
 
needed for wide headers; this may be used to widen up columns
429
 
such as WCHAN (\fBps\ \-o\ pid,wchan=WIDE\-WCHAN\-COLUMN\ \-o\ comm\fR).
430
 
Explicit width control (\fBps\ opid,wchan:42,cmd\fR) is offered too.
431
 
The behavior of \fBps\ \-o\ pid=X,comm=Y\fR varies with personality;
432
 
output may be one column named "X,comm=Y" or two columns
433
 
named "X" and "Y". Use multiple \fB\-o\fR options when in doubt.
434
 
Use the \fBPS_FORMAT\fR environment variable to specify a default
435
 
as desired; DefSysV and DefBSD are macros that may be used to
436
 
choose the default UNIX or BSD columns.
437
 
 
438
 
.opt s
439
 
Display signal format
440
 
 
441
 
.opt u
442
 
Display user\-oriented format
443
 
 
444
 
.opt v
445
 
Display virtual memory format
446
 
 
447
 
.opt X
 
487
.I format
 
488
is a single argument in the form of a blank\-separated or comma\-separated
 
489
list, which offers a way to specify individual output columns.  The
 
490
recognized keywords are described in the
 
491
.B STANDARD FORMAT SPECIFIERS
 
492
section below.  Headers may be renamed
 
493
.RB ( "ps \-o pid,\:ruser=RealUser \-o comm=Command" )
 
494
as desired.
 
495
If all column headers are empty
 
496
.RB ( "ps \-o pid= \-o comm=" )
 
497
then the header line will not be output.  Column width will increase as
 
498
needed for wide headers; this may be used to widen up columns such as WCHAN
 
499
.RB ( "ps \-o pid,\:wchan=\:WIDE\-\:WCHAN\-\:COLUMN \-o comm" ).
 
500
Explicit width
 
501
control
 
502
.RB ( "ps opid,\:wchan:42,\:cmd" )
 
503
is offered too.  The behavior of
 
504
.B ps -o pid=X,\:comm=Y
 
505
varies with personality; output may be one column named "X,\:comm=Y" or two
 
506
columns named "X" and "Y".  Use multiple
 
507
.B \-o
 
508
options when in doubt.  Use the
 
509
.B PS_FORMAT
 
510
environment variable to specify a default as desired; DefSysV and DefBSD are
 
511
macros that may be used to choose the default UNIX or BSD columns.
 
512
.TP
 
513
.B s
 
514
Display signal format.
 
515
.TP
 
516
.B u
 
517
Display user\-oriented format.
 
518
.TP
 
519
.B v
 
520
Display virtual memory format.
 
521
.TP
 
522
.B X
448
523
Register format.
449
 
 
450
 
.opt \-y
451
 
Do not show flags; show rss in place of addr.
452
 
This option can only be used with \fB\-l\fR.
453
 
 
454
 
.opt Z
455
 
Add a column of security data. Identical to \fB\-M\fR (for\ SE\ Linux).
456
 
 
 
524
.TP
 
525
.B \-y
 
526
Do not show flags; show rss in place of addr.  This option can only be used
 
527
with
 
528
.BR \-l .
 
529
.TP
 
530
.B Z
 
531
Add a column of security data.  Identical to
 
532
.B \-M
 
533
(for SE Linux).
457
534
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
458
535
.PD
459
536
.PP
460
537
.SH "OUTPUT MODIFIERS"
461
 
 
462
538
.\"  .TP
463
539
.\"  .B C
464
540
.\"  use raw CPU time for %CPU instead of decaying average
465
 
 
466
 
.opt c
467
 
Show the true command name. This is derived from the name of the
468
 
executable file, rather than from the argv value. Command arguments
469
 
and any modifications to them  are
470
 
thus not shown. This option
471
 
effectively turns the \fBargs\fR format keyword into the \fBcomm\fR
472
 
format keyword; it is useful with the \fB\-f\fR format option and with
473
 
the various BSD\-style format options, which all normally
474
 
display the command arguments.
475
 
See the \fB\-f\fR option, the format keyword \fBargs\fR, and the
476
 
format keyword \fBcomm\fR.
477
 
 
478
 
.opt \-\-cols \ n
479
 
Set screen width
480
 
 
481
 
.opt \-\-columns \ n
482
 
Set screen width
483
 
 
484
 
.opt \-\-cumulative
485
 
Include some dead child process data (as a sum with the parent)
486
 
 
487
 
.opt e
 
541
.TP
 
542
.B c
 
543
Show the true command name.  This is derived from the name of the executable
 
544
file, rather than from the argv value.  Command arguments and any
 
545
modifications to them are thus not shown.  This option effectively turns the
 
546
.B args
 
547
format keyword into the
 
548
.B comm
 
549
format keyword; it is useful with the
 
550
.B \-f
 
551
format option and with the various BSD\-style format options, which all
 
552
normally display the command arguments.  See the
 
553
.B \-f
 
554
option, the format
 
555
keyword
 
556
.BR args ,
 
557
and the format keyword
 
558
.BR comm .
 
559
.TP
 
560
.BI \-\-cols \ n
 
561
Set screen width.
 
562
.TP
 
563
.BI \-\-columns \ n
 
564
Set screen width.
 
565
.TP
 
566
.B \-\-cumulative
 
567
Include some dead child process data (as a sum with the parent).
 
568
.TP
 
569
.B e
488
570
Show the environment after the command.
489
 
 
490
 
.opt f
 
571
.TP
 
572
.B f
491
573
ASCII art process hierarchy (forest).
492
 
 
493
 
.opt \-\-forest
 
574
.TP
 
575
.B \-\-forest
494
576
ASCII art process tree.
495
 
 
496
 
.opt h
497
 
No header. (or, one header per screen in the BSD personality)
498
 
.br
499
 
The \fBh\fR option is problematic.  Standard BSD \fBps\fR uses
500
 
this option to print a header on each page of output, but older
501
 
Linux \fBps\fR uses this option to totally disable the header.
502
 
This version of \fBps\fR follows the Linux usage of not printing
503
 
the header unless the BSD personality has been selected, in which
504
 
case it prints a header on each page of output. Regardless of the
505
 
current personality, you can use the long options \fB\-\-headers\fR
506
 
and \fB\-\-no\-headers\fR to enable printing headers each page or
507
 
disable headers entirely, respectively.
508
 
 
509
 
.opt \-H
 
577
.TP
 
578
.B h
 
579
No header.  (or, one header per screen in the BSD personality).  The
 
580
.B h
 
581
option is problematic.  Standard BSD
 
582
.B ps
 
583
uses this option to print a header on each page of output, but older Linux
 
584
.B ps
 
585
uses this option to totally disable the header.  This version of
 
586
.B ps
 
587
follows the Linux usage of not printing the header unless the BSD personality
 
588
has been selected, in which case it prints a header on each page of output.
 
589
Regardless of the current personality, you can use the long options
 
590
.B \-\-headers
 
591
and
 
592
.B \-\-no\-headers
 
593
to enable printing headers each page or disable headers entirely,
 
594
respectively.
 
595
.TP
 
596
.B \-H
510
597
Show process hierarchy (forest).
511
 
 
512
 
.opt \-\-headers
 
598
.TP
 
599
.B \-\-headers
513
600
Repeat header lines, one per page of output.
514
 
 
515
 
.opt k \ spec
516
 
Specify sorting order. Sorting syntax is
 
601
.TP
 
602
.BI k \ spec
 
603
Specify sorting order.  Sorting syntax is
517
604
[\fB+\fR|\fB\-\fR]\fIkey\fR[,[\fB+\fR|\fB\-\fR]\fIkey\fR[,...]].
518
 
Choose a multi\-letter key from the \fBSTANDARD FORMAT SPECIFIERS\fR section.
519
 
The\ "+" is optional since default direction is increasing numerical or
520
 
lexicographic order. Identical to \fB\-\-sort\fR. Examples:
521
 
.br
522
 
\fBps\ jaxkuid,\-ppid,+pid\fR
523
 
.br
524
 
\fBps\ axk\ comm\ o\ comm,args\fR
525
 
.br
526
 
\fBps\ kstart_time\ \-ef\fR
527
 
 
528
 
.opt \-n \ namelist
529
 
Set namelist file.  Identical to \fBN\fR.
530
 
.br
531
 
The namelist file is needed for a proper WCHAN display, and must match
532
 
the current Linux kernel exactly for correct output.
533
 
Without this option, the default search path for the namelist is:
534
 
 
535
 
        $PS_SYSMAP
536
 
.br
537
 
        $PS_SYSTEM_MAP
538
 
.br
539
 
        /proc/*/wchan
540
 
.br
541
 
        /boot/System.map\-\`uname\ \-r\`
542
 
.br
543
 
        /boot/System.map
544
 
.br
545
 
        /lib/modules/\`uname\ \-r\`/System.map
546
 
.br
547
 
        /usr/src/linux/System.map
548
 
.br
549
 
        /System.map
550
 
 
551
 
.opt \-\-lines \ n
 
605
Choose a multi\-letter key from the
 
606
.B STANDARD FORMAT SPECIFIERS
 
607
section.  The "+" is optional since default direction is increasing
 
608
numerical or lexicographic order.  Identical to
 
609
.BR \-\-sort .
 
610
.RS 8
 
611
.IP
 
612
Examples:
 
613
.br
 
614
.B ps jaxkuid,\-ppid,+pid
 
615
.br
 
616
.B ps axk comm o comm,args
 
617
.br
 
618
.B ps kstart_time \-ef
 
619
.RE
 
620
.TP
 
621
.BI \-\-lines \ n
552
622
Set screen height.
553
 
 
554
 
.opt n
 
623
.TP
 
624
.BI \-n \ namelist
 
625
Set namelist file.  Identical to
 
626
.BR N .
 
627
The namelist file is needed for a proper WCHAN display, and must match the
 
628
current Linux kernel exactly for correct output.  Without this option, the
 
629
default search path for the namelist is:
 
630
.RS 8
 
631
.IP
 
632
$PS_SYSMAP
 
633
.br
 
634
$PS_SYSTEM_MAP
 
635
.br
 
636
/proc/*/wchan
 
637
.br
 
638
/boot/System.map\-$(uname\ \-r)
 
639
.br
 
640
/boot/System.map
 
641
.br
 
642
/lib/modules/$(uname\ \-r)/System.map
 
643
.br
 
644
/usr/src/linux/System.map
 
645
.br
 
646
/System.map
 
647
.RE
 
648
.TP
 
649
.B n
555
650
Numeric output for WCHAN and USER (including all types of UID and GID).
556
 
 
557
 
.opt N \ namelist
558
 
Specify namelist file.  Identical to \fB\-n\fR, see \fB\-n\fR above.
559
 
 
560
 
.opt O \ order
 
651
.TP
 
652
.BI N \ namelist
 
653
Specify namelist file.  Identical to
 
654
.BR \-n ,
 
655
see
 
656
.B \-n
 
657
above.
 
658
.TP
 
659
.B \-\-no\-headers
 
660
Print no header line at all.
 
661
.B \-\-no\-heading
 
662
is an alias for this option.
 
663
.TP
 
664
.BI O \ order
561
665
Sorting order (overloaded).
562
 
.br
563
 
The BSD \fBO\fR option can act like \fB\-O\fR (user\-defined output
564
 
format with some common fields predefined) or can be used to specify
565
 
sort order.  Heuristics are used to determine the behavior of this
566
 
option. To ensure that the desired behavior is obtained (sorting or
567
 
formatting), specify the option in some other way (e.g. with \fB\-O\fR
568
 
or \fB\-\-sort\fR).
569
 
 
570
 
For sorting, obsolete BSD \fBO\fR option syntax is
 
666
The BSD
 
667
.B O
 
668
option can act like
 
669
.B \-O
 
670
(user\-defined output format with some common fields predefined) or can be
 
671
used to specify sort order.  Heuristics are used to determine the behavior of
 
672
this option.  To ensure that the desired behavior is obtained (sorting or
 
673
formatting), specify the option in some other way (e.g.  with
 
674
.B \-O
 
675
or
 
676
.BR \-\-sort ).
 
677
.IP
 
678
For sorting, obsolete BSD
 
679
.B O
 
680
option syntax is
571
681
\fBO\fR[\fB+\fR|\fB\-\fR]\fIk1\fR[,[\fB+\fR|\fB\-\fR]\fIk2\fR[,...]].
572
682
It orders the processes listing according to the multilevel sort specified by
573
 
the sequence of one\-letter short keys \fIk1\fR, \fIk2\fR, ... described
574
 
in the \fBOBSOLETE SORT KEYS\fR section below.
575
 
The\ "+" is currently optional,
576
 
merely re\-iterating the default direction on a key,
577
 
but may help to distinguish an \fBO\fR sort from an \fBO\fR format.
578
 
The\ "\-" reverses direction only on the key it precedes.
579
 
 
580
 
.opt \-\-no\-headers
581
 
Print no header line at all. \fB\-\-no\-heading\fR is an alias for this
582
 
option.
583
 
 
584
 
.opt \-\-rows \ n
 
683
the sequence of one\-letter short keys
 
684
.IR k1 , k2 ", ..."
 
685
described in the
 
686
.B OBSOLETE SORT KEYS
 
687
section below.  The\ "+" is currently optional, merely re\-iterating the
 
688
default direction on a key, but may help to distinguish an
 
689
.B O
 
690
sort from an
 
691
.B O
 
692
format.  The "\-" reverses direction only on the key it precedes.
 
693
.TP
 
694
.BI \-\-rows \ n
585
695
Set screen height.
586
 
 
587
 
.opt S
588
 
Sum up some information, such as CPU usage, from dead child processes
589
 
into their parent. This is useful for examining a system where a
590
 
parent process repeatedly forks off short\-lived children to do work.
591
 
 
592
 
.opt \-\-sort \ spec
593
 
Specify sorting order. Sorting syntax is
594
 
[\fB+\fR|\fB\-\fR]\fIkey\fR[,[\fB+\fR|\fB\-\fR]\fIkey\fR[,...]].
595
 
Choose a multi\-letter key from the \fBSTANDARD FORMAT SPECIFIERS\fR section.
596
 
The\ "+" is optional since default direction is increasing numerical or
597
 
lexicographic order. Identical to\ \fBk\fR.
598
 
For example: \fBps\ jax\ \-\-sort=uid,\-ppid,+pid\fR
599
 
 
600
 
.opt w
601
 
Wide output. Use this option twice for unlimited width.
602
 
 
603
 
.opt \-w
604
 
Wide output. Use this option twice for unlimited width.
605
 
 
606
 
.opt \-\-width \ n
607
 
set screen width
608
 
 
 
696
.TP
 
697
.B S
 
698
Sum up some information, such as CPU usage, from dead child processes into
 
699
their parent.  This is useful for examining a system where a parent process
 
700
repeatedly forks off short\-lived children to do work.
 
701
.TP
 
702
.BI \-\-sort \ spec
 
703
Specify sorting order.  Sorting syntax is
 
704
[\fB+\fR|\fB\-\fR]\fIkey\fR[,[\fB+\fR|\fB\-\fR]\fIkey\fR[,...]].  Choose a
 
705
multi\-letter key from the
 
706
.B STANDARD FORMAT SPECIFIERS
 
707
section.  The "+" is optional since default direction is increasing numerical
 
708
or lexicographic order.  Identical to
 
709
.BR k .
 
710
For example:
 
711
.B ps jax \-\-sort=\:uid,\:\-ppid,\:+pid
 
712
.TP
 
713
.B w
 
714
Wide output.  Use this option twice for unlimited width.
 
715
.TP
 
716
.B \-w
 
717
Wide output.  Use this option twice for unlimited width.
 
718
.TP
 
719
.BI \-\-width \ n
 
720
Set screen width.
609
721
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
610
722
.PD
611
723
.PP
612
724
.SH "THREAD DISPLAY"
613
 
.PD 0
614
 
 
615
 
.opt H
 
725
.TP
 
726
.B H
616
727
Show threads as if they were processes.
617
 
 
618
 
.opt \-L
 
728
.TP
 
729
.B \-L
619
730
Show threads, possibly with LWP and NLWP columns.
620
 
 
621
 
.opt m
622
 
Show threads after processes.
623
 
 
624
 
.opt \-m
625
 
Show threads after processes.
626
 
 
627
 
.opt \-T
 
731
.TP
 
732
.B m
 
733
Show threads after processes.
 
734
.TP
 
735
.B \-m
 
736
Show threads after processes.
 
737
.TP
 
738
.B \-T
628
739
Show threads, possibly with SPID column.
629
 
 
630
740
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
631
741
.PD
632
742
.PP
633
743
.SH "OTHER INFORMATION"
634
 
.PD 0
635
 
 
636
 
.opt \-\-help
637
 
Print a help message.
638
 
 
639
 
.opt \-\-info
 
744
.TP
 
745
.BI \-\-help \ section
 
746
Print a help message.  The section argument can be one of
 
747
\fIs\fRimple,
 
748
\fIl\fRist,
 
749
\fIo\fRutput,
 
750
\fIt\fRhreads,
 
751
\fIm\fRisc or
 
752
\fIa\fRll.
 
753
The argument can be shortened to one of the underlined letters as in: s|l|o|t|m|a.
 
754
.TP
 
755
.B \-\-info
640
756
Print debugging info.
641
 
 
642
 
.opt L
 
757
.TP
 
758
.B L
643
759
List all format specifiers.
644
 
 
645
 
.opt V
646
 
Print the procps version.
647
 
 
648
 
.opt \-V
649
 
Print the procps version.
650
 
 
651
 
.opt \-\-version
652
 
Print the procps version.
653
 
 
 
760
.TP
 
761
.B V
 
762
Print the procps-ng version.
 
763
.TP
 
764
.B \-V
 
765
Print the procps-ng version.
 
766
.TP
 
767
.B \-\-version
 
768
Print the procps-ng version.
654
769
.\" """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
655
770
.PD
656
771
.PP
657
772
.SH NOTES
658
 
This \fBps\fR works by reading the virtual files in\ /proc.
659
 
This \fBps\fR does not need to be setuid kmem or have any privileges to run.
660
 
Do not give this \fBps\fR any special permissions.
661
 
 
662
 
This \fBps\fR needs access to namelist data for proper WCHAN display.
663
 
For kernels prior to 2.6, the System.map file must be installed.
664
 
 
665
 
CPU usage is currently expressed as the percentage of time spent
666
 
running during the entire lifetime of a process.
667
 
This is not ideal, and\ it does not conform to the
668
 
standards that \fBps\fR otherwise conforms\ to.
669
 
CPU\ usage is unlikely to add up to exactly\ 100%.
670
 
 
 
773
This
 
774
.B ps
 
775
works by reading the virtual files in /proc.  This
 
776
.B ps
 
777
does not need to be setuid kmem or have any privileges to run.  Do not give
 
778
this
 
779
.B ps
 
780
any special permissions.
 
781
.PP
 
782
This
 
783
.B ps
 
784
needs access to namelist data for proper WCHAN display.  For kernels prior to
 
785
2.6, the System.map file must be installed.
 
786
.PP
 
787
CPU usage is currently expressed as the percentage of time spent running
 
788
during the entire lifetime of a process.  This is not ideal, and\ it does not
 
789
conform to the standards that
 
790
.B ps
 
791
otherwise conforms to.  CPU usage is unlikely to add up to exactly 100%.
 
792
.PP
671
793
The SIZE and RSS fields don't count some parts of a process including the
672
 
page tables, kernel stack, struct thread_info, and struct task_struct.
673
 
This is usually at least 20\ KiB of memory that is always resident.
674
 
SIZE is the virtual size of the process (code+data+stack).
675
 
 
676
 
Processes marked <defunct> are dead processes (so\-called\ "zombies") that
677
 
remain because their parent has not destroyed them properly. These processes
678
 
will be destroyed by \fIinit\fR(8) if the parent process exits.
679
 
 
680
 
 
 
794
page tables, kernel stack, struct thread_info, and struct task_struct.  This
 
795
is usually at least 20 KiB of memory that is always resident.  SIZE is the
 
796
virtual size of the process (code+\:data+\:stack).
 
797
.PP
 
798
Processes marked <defunct> are dead processes (so\-called "zombies") that
 
799
remain because their parent has not destroyed them properly.  These processes
 
800
will be destroyed by
 
801
.IR init (8)
 
802
if the parent process exits.
 
803
.PP
 
804
If the length of the username is greater than the length of the display
 
805
column, the numeric user ID is displayed instead.
681
806
.SH "PROCESS FLAGS"
682
807
The sum of these values is displayed in the "F" column,
683
 
which is provided by the \fBflags\fR output specifier:
 
808
which is provided by the
 
809
.B flags
 
810
output specifier:
 
811
.IP
 
812
.RS 8
684
813
.PD 0
685
814
.TP 5
686
815
1
689
818
4
690
819
used super\-user privileges
691
820
.PD
 
821
.RE
692
822
.PP
693
823
.SH "PROCESS STATE CODES"
694
 
Here are the different values that the \fBs\fR, \fBstat\fR and
695
 
\fBstate\fR output specifiers (header\ "STAT"\ or\ "S") will display to
696
 
describe the state of a process:
 
824
Here are the different values that the
 
825
.BR s , \ stat \ and \ state
 
826
output specifiers (header "STAT" or "S") will display to describe the state
 
827
of a process:
 
828
.IP
 
829
.RS 8
697
830
.PD 0
698
831
.TP 5
699
832
D
700
 
uninterruptible sleep (usually\ IO)
 
833
uninterruptible sleep (usually IO)
701
834
.TP
702
835
R
703
 
running or runnable (on\ run\ queue)
 
836
running or runnable (on run queue)
704
837
.TP
705
838
S
706
839
interruptible sleep (waiting for an event to complete)
707
840
.TP
708
841
T
709
 
stopped, either by a job control signal or because it is being traced.
 
842
stopped, either by a job control signal or because it is being traced
710
843
.TP
711
844
W
712
845
paging (not valid since the 2.6.xx kernel)
715
848
dead (should never be seen)
716
849
.TP
717
850
Z
718
 
defunct ("zombie") process, terminated but not reaped by its parent.
 
851
defunct ("zombie") process, terminated but not reaped by its parent
719
852
.PD
 
853
.RE
720
854
.PP
721
 
For BSD formats and when the \fBstat\fR keyword is used, additional
722
 
characters may be displayed:
 
855
For BSD formats and when the
 
856
.B stat
 
857
keyword is used, additional characters may be displayed:
 
858
.IP
 
859
.RS 8
723
860
.PD 0
724
861
.TP 5
725
862
<
729
866
low\-priority (nice to other users)
730
867
.TP
731
868
L
732
 
has pages locked into memory (for real\-time and custom\ IO)
 
869
has pages locked into memory (for real\-time and custom IO)
733
870
.TP
734
871
s
735
872
is a session leader
736
873
.TP
737
874
l
738
 
is multi-threaded (using CLONE_THREAD, like NPTL pthreads\ do)
 
875
is multi-threaded (using CLONE_THREAD, like NPTL pthreads do)
739
876
.TP
740
877
+
741
 
is in the foreground process group.
 
878
is in the foreground process group
742
879
.PD
743
 
.PP
 
880
.RE
744
881
.PP
745
882
.SH "OBSOLETE SORT KEYS"
746
 
These keys are used by the BSD \fBO\fR option (when it is used for
747
 
sorting).  The GNU \fB\-\-sort\fR option doesn't use these keys, but the
748
 
specifiers described below in the \fBSTANDARD FORMAT SPECIFIERS\fR
749
 
section. Note that the values used in sorting are the internal
750
 
values \fBps\fR uses and not the "cooked" values used in some of
751
 
the output format fields (e.g. sorting on tty will sort into
752
 
device number, not according to the terminal name displayed).
753
 
Pipe \fBps\fR output into the \fIsort\fR(1) command if you want
754
 
to sort the cooked values.
755
 
 
 
883
These keys are used by the BSD
 
884
.B O
 
885
option (when it is used for sorting).  The GNU
 
886
.B \-\-sort
 
887
option doesn't use these keys, but the specifiers described below in the
 
888
.B STANDARD FORMAT SPECIFIERS
 
889
section.  Note that the values used in sorting are the internal values
 
890
.B ps
 
891
uses and not the "cooked" values used in some of the output format fields
 
892
(e.g.  sorting on tty will sort into device number, not according to the
 
893
terminal name displayed).  Pipe
 
894
.B ps
 
895
output into the
 
896
.BR sort (1)
 
897
command if you want to sort the cooked values.
756
898
.TS
757
899
l l lw(3i).
758
900
\fBKEY  LONG    DESCRIPTION\fR
779
921
T       start_time      time process was started
780
922
U       uid     user ID number
781
923
u       user    user name
782
 
v       vsize   total VM size in kB
 
924
v       vsize   total VM size in KiB
783
925
y       priority        kernel scheduling priority
784
926
.\"K    stime   system time (conflict, system vs. start time)
785
927
.TE
786
928
.PP
787
929
.PP
788
930
.SH "AIX FORMAT DESCRIPTORS"
789
 
This \fBps\fR supports AIX format descriptors, which work somewhat like the
790
 
formatting codes of \fIprintf\fR(1) and \fIprintf\fR(3). For example, the normal
791
 
default output can be produced with this:  \fBps\ \-eo\ "%p\ %y\ %x\ %c"\fR.
792
 
The\ \fBNORMAL\fR codes are described in the next section.
 
931
This
 
932
.B ps
 
933
supports AIX format descriptors, which work somewhat like the
 
934
formatting codes of
 
935
.IR printf (1)
 
936
and
 
937
.IR printf (3).
 
938
For example, the normal default output can be produced with this:
 
939
\fBps \-eo "%p %y %x %c"\fR.
 
940
The
 
941
.B NORMAL
 
942
codes are described in the next section.
793
943
.TS
794
944
l l l.
795
945
\fBCODE NORMAL  HEADER\fR
809
959
%y      tty     TTY
810
960
%z      vsz     VSZ
811
961
.TE
812
 
 
813
962
.SH "STANDARD FORMAT SPECIFIERS"
814
963
Here are the different keywords that may be used to control the output
815
 
format (e.g. with option \fB\-o\fR) or to sort the selected processes
816
 
with the GNU\-style \fB\-\-sort\fR option.
817
 
 
818
 
For example:  \fBps\ \-eo\ pid,user,args\ \-\-sort\ user\fR
819
 
 
820
 
This version of \fBps\fR tries to recognize most of the keywords used in
821
 
other implementations of \fBps\fR.
822
 
 
 
964
format (e.g. with option
 
965
.BR \-o )
 
966
or to sort the selected processes with the GNU\-style
 
967
.B \-\-sort
 
968
option.
 
969
.PP
 
970
For example:
 
971
.B ps \-eo pid,\:user,\:args \-\-sort user
 
972
.PP
 
973
This version of
 
974
.B ps
 
975
tries to recognize most of the keywords used in other implementations of
 
976
.BR ps .
 
977
.PP
823
978
The following user\-defined format specifiers may contain
824
 
spaces: \fBargs\fR, \fBcmd\fR, \fBcomm\fR, \fBcommand\fR, \fBfname\fR,
825
 
\fBucmd\fR, \fBucomm\fR,
826
 
\fBlstart\fR, \fBbsdstart\fR, \fBstart\fR.
827
 
 
 
979
spaces:
 
980
.BR args , \ cmd , \ comm , \ command , \ fname , \ ucmd , \ ucomm ,
 
981
.BR lstart , \ bsdstart , \ start .
 
982
.PP
828
983
Some keywords may not be available for sorting.
829
984
 
830
985
.\" #######################################################################
841
996
CODE    HEADER  DESCRIPTION
842
997
 
843
998
%cpu    %CPU    T{
844
 
cpu utilization of the process in "##.#" format.  Currently, it is the CPU time
845
 
used divided by the time the process has been running (cputime/realtime
846
 
ratio), expressed as a percentage. It will not add up to 100% unless you
847
 
are lucky.  (alias\ \fBpcpu\fR).
 
999
cpu utilization of the process in "##.#" format.  Currently, it is the CPU
 
1000
time used divided by the time the process has been running (cputime/realtime
 
1001
ratio), expressed as a percentage.  It will not add up to 100% unless you are
 
1002
lucky.  (alias
 
1003
.BR pcpu ).
848
1004
T}
849
1005
 
850
1006
%mem    %MEM    T{
851
 
ratio of the process's resident set size  to the physical memory on
852
 
the machine, expressed as a percentage.  (alias\ \fBpmem\fR).
 
1007
ratio of the process's resident set size  to the physical memory on the
 
1008
machine, expressed as a percentage.  (alias
 
1009
.BR pmem ).
853
1010
T}
854
1011
 
855
1012
args    COMMAND T{
856
1013
command with all its arguments as a string. Modifications to the arguments
857
 
may be shown. The output in this column may contain spaces.
858
 
A\ process marked <defunct> is partly dead, waiting
859
 
to be fully destroyed by its parent. Sometimes the process args
860
 
will be unavailable; when this happens, \fBps\fR will instead
861
 
print the executable name in brackets.
862
 
(alias\ \fBcmd\fR,\ \fBcommand\fR). See also the \fBcomm\fR format
863
 
keyword, the \fB\-f\fR option, and the \fBc\fR option.
 
1014
may be shown.  The output in this column may contain spaces.  A process
 
1015
marked <defunct> is partly dead, waiting to be fully destroyed by its parent.
 
1016
Sometimes the process args will be unavailable; when this happens,
 
1017
.B ps
 
1018
will instead print the executable name in brackets.  (alias
 
1019
.BR cmd , \ command ).
 
1020
See also the
 
1021
.B comm
 
1022
format keyword, the
 
1023
.B \-f
 
1024
option, and the
 
1025
.B c
 
1026
option.
864
1027
.br
865
 
When specified last, this column will extend to the edge of the display.
866
 
If \fBps\fR can not determine display width, as when output is redirected
867
 
(piped) into a file or another command, the output width is undefined
868
 
(it may be 80, unlimited, determined by the \fBTERM\fR variable, and so on).
869
 
The \fBCOLUMNS\fR environment variable or \fB\-\-cols\fR option may
870
 
be used to exactly determine the width in this case.
871
 
The \fBw\fR or \fB\-w\fR option may be also be used to adjust width.
 
1028
When specified last, this column will extend to the edge of the display.  If
 
1029
.B ps
 
1030
can not determine display width, as when output is redirected (piped) into a
 
1031
file or another command, the output width is undefined (it may be 80,
 
1032
unlimited, determined by the
 
1033
.B TERM
 
1034
variable, and so on).  The
 
1035
.B COLUMNS
 
1036
environment variable or
 
1037
.B \-\-cols
 
1038
option may be used to exactly determine the width in this case.  The
 
1039
.B w
 
1040
or
 
1041
.B \-w
 
1042
option may be also be used to adjust width.
872
1043
T}
873
1044
 
874
1045
blocked BLOCKED T{
875
 
mask of the blocked signals, see \fIsignal\fR(7).
876
 
According to the width of the field,
877
 
a\ 32 or 64\-bit mask in hexadecimal format is displayed.
878
 
(alias\ \fBsig_block\fR,\ \fBsigmask\fR).
 
1046
mask of the blocked signals, see
 
1047
.IR signal (7).
 
1048
According to the width of the field, a 32 or 64\-bit mask in hexadecimal
 
1049
format is displayed.  (alias
 
1050
.BR sig_block , \ sigmask ).
879
1051
T}
880
1052
 
881
1053
bsdstart        START   T{
882
 
time the command started.  If the process was started less
883
 
than 24 hours ago, the output format is "\ HH:MM",
884
 
else it is "Mmm\ dd"
885
 
(where Mmm is the three letters of the month).
886
 
See also \fBlstart\fR, \fBstart\fR, \fBstart_time\fR, and \fBstime\fR.
 
1054
time the command started.  If the process was started less than 24 hours ago,
 
1055
the output format is "\ HH:MM", else it is " Mmm:SS" (where Mmm is the three
 
1056
letters of the month).  See also
 
1057
.BR lstart , \ start , \ start_time ", and" \ stime .
887
1058
T}
888
1059
 
889
1060
bsdtime TIME    T{
890
 
accumulated cpu time, user\ +\ system.  The display format is usually
 
1061
accumulated cpu time, user + system.  The display format is usually
891
1062
"MMM:SS", but can be shifted to the right if the process used more than 999
892
1063
minutes of cpu time.
893
1064
T}
894
1065
 
895
1066
c       C       T{
896
 
processor utilization. Currently, this is the integer value of
897
 
the percent usage over the lifetime of the process.  (see\ \fB%cpu\fR).
 
1067
processor utilization. Currently, this is the integer value of the percent
 
1068
usage over the lifetime of the process.  (see
 
1069
.BR %cpu ).
898
1070
T}
899
1071
 
900
1072
caught  CAUGHT  T{
901
 
mask of the caught signals, see \fIsignal\fR(7).  According to the
902
 
width of the field, a 32 or 64 bits mask in hexadecimal format is
903
 
displayed.  (alias\ \fBsig_catch\fR,\ \fBsigcatch\fR).
 
1073
mask of the caught signals, see
 
1074
.IR signal (7).
 
1075
According to the width of the field, a 32 or 64 bits mask in hexadecimal
 
1076
format is displayed.  (alias
 
1077
.BR sig_catch , \ sigcatch ).
904
1078
T}
905
1079
 
906
1080
cgroup  CGROUP  T{
908
1082
T}
909
1083
 
910
1084
class   CLS     T{
911
 
scheduling class of the process.  (alias\ \fBpolicy\fR,\ \fBcls\fR).
 
1085
scheduling class of the process.  (alias
 
1086
.BR policy , \ cls ).
912
1087
Field's possible values are:
913
 
.br
 
1088
.IP "" 2
914
1089
\-      not reported
915
1090
.br
916
1091
TS      SCHED_OTHER
929
1104
T}
930
1105
 
931
1106
cls     CLS     T{
932
 
scheduling class of the process.  (alias\ \fBpolicy\fR,\ \fBclass\fR).
 
1107
scheduling class of the process.  (alias
 
1108
.BR policy , \ cls ).
933
1109
Field's possible values are:
934
 
.br
 
1110
.IP "" 2
935
1111
\-      not reported
936
1112
.br
937
1113
TS      SCHED_OTHER
950
1126
T}
951
1127
 
952
1128
cmd     CMD     T{
953
 
see \fBargs\fR.  (alias\ \fBargs\fR,\ \fBcommand\fR).
 
1129
see
 
1130
.BR args .
 
1131
(alias
 
1132
.BR args , \ command ).
954
1133
T}
955
1134
 
956
1135
comm    COMMAND T{
957
 
command name (only\ the executable\ name).  Modifications to the command
958
 
name will not be shown. A\ process marked <defunct> is partly dead, waiting
959
 
to be fully destroyed by its parent. The output in this
960
 
column may contain spaces.  (alias\ \fBucmd\fR,\ \fBucomm\fR).
961
 
See also the \fBargs\fR format
962
 
keyword, the \fB\-f\fR option, and the \fBc\fR option.
 
1136
command name (only the executable name).  Modifications to the command name
 
1137
will not be shown.  A process marked <defunct> is partly dead, waiting to be
 
1138
fully destroyed by its parent.  The output in this column may contain spaces.
 
1139
(alias
 
1140
.BR ucmd , \ ucomm ).
 
1141
See also the
 
1142
.B args format keyword,
 
1143
the
 
1144
.B \-f
 
1145
option, and the
 
1146
.B c
 
1147
option.
963
1148
.br
964
 
When specified last, this column will extend to the edge of the display.
965
 
If \fBps\fR can not determine display width, as when output is redirected
966
 
(piped) into a file or another command, the output width is undefined
967
 
(it may be 80, unlimited, determined by the \fBTERM\fR variable, and so on).
968
 
The \fBCOLUMNS\fR environment variable or \fB\-\-cols\fR option may
969
 
be used to exactly determine the width in this case.
970
 
The \fBw\fR or \fB\-w\fR option may be also be used to adjust width.
 
1149
When specified last, this column will extend to the edge of the display.  If
 
1150
.B ps
 
1151
can not determine display width, as when output is redirected (piped) into a
 
1152
file or another command, the output width is undefined (it may be 80,
 
1153
unlimited, determined by the
 
1154
.B TERM
 
1155
variable, and so on).  The
 
1156
.B COLUMNS
 
1157
environment variable or
 
1158
.B \-\-cols
 
1159
option may be used to exactly determine the width in this case.  The
 
1160
.BR w \ or \ \-w
 
1161
option may be also be used to adjust width.
971
1162
T}
972
1163
 
973
1164
command COMMAND T{
974
 
see \fBargs\fR.  (alias\ \fBargs\fR,\ \fBcmd\fR).
 
1165
See
 
1166
.BR args .
 
1167
(alias
 
1168
.BR args , \ command ).
975
1169
T}
976
1170
 
977
1171
cp      CP      T{
978
 
per\-mill (tenths of a percent) CPU usage.  (see\ \fB%cpu\fR).
 
1172
per\-mill (tenths of a percent) CPU usage.  (see
 
1173
.BR %cpu ).
979
1174
T}
980
1175
 
981
1176
cputime TIME    T{
982
 
cumulative CPU time, "[DD\-]hh:mm:ss" format.  (alias\ \fBtime\fR).
 
1177
cumulative CPU time, "[DD\-]hh:mm:ss" format.  (alias
 
1178
.BR time ).
983
1179
T}
984
1180
 
985
1181
egid    EGID    T{
986
 
effective group ID number of the process as a decimal integer.
987
 
(alias\ \fBgid\fR).
 
1182
effective group ID number of the process as a decimal integer.  (alias
 
1183
.BR gid ).
988
1184
T}
989
1185
 
990
1186
egroup  EGROUP  T{
991
 
effective group ID of the process.  This will be the textual group ID,
992
 
if it can be obtained and the field width permits, or a decimal
993
 
representation otherwise.  (alias\ \fBgroup\fR).
 
1187
effective group ID of the process.  This will be the textual group ID, if it
 
1188
can be obtained and the field width permits, or a decimal representation
 
1189
otherwise.  (alias
 
1190
.BR group ).
994
1191
T}
995
1192
 
996
1193
eip     EIP     T{
1002
1199
T}
1003
1200
 
1004
1201
etime   ELAPSED T{
1005
 
elapsed time since the process was started,
1006
 
in\ the form\ [[DD\-]hh:]mm:ss.
 
1202
elapsed time since the process was started, in the form [[DD\-]hh:]mm:ss.
 
1203
T}
 
1204
 
 
1205
etimes  ELAPSED T{
 
1206
elapsed time since the process was started, in seconds.
1007
1207
T}
1008
1208
 
1009
1209
euid    EUID    T{
1010
 
effective user\ ID (alias\ \fBuid\fR).
 
1210
effective user ID (alias
 
1211
.BR uid ).
1011
1212
T}
1012
1213
 
1013
1214
euser   EUSER   T{
1014
 
effective user\ name.  This will be the textual
1015
 
user\ ID, if\ it can be obtained and the field width permits,
1016
 
or\ a\ decimal representation otherwise.
1017
 
The\ \fBn\fR\ option can be used
1018
 
to force the decimal representation.
1019
 
(alias\ \fBuname\fR,\ \fBuser\fR).
 
1215
effective user name.  This will be the textual user ID, if it can be obtained
 
1216
and the field width permits, or a decimal representation otherwise.  The
 
1217
.B n
 
1218
option can be used to force the decimal representation.  (alias
 
1219
.BR uname , \  user ).
1020
1220
T}
1021
1221
 
1022
1222
f       F       T{
1023
 
flags associated with the process, see the \fBPROCESS FLAGS\fR section.
1024
 
(alias\ \fBflag\fR,\ \fBflags\fR).
 
1223
flags associated with the process, see the
 
1224
.B PROCESS FLAGS
 
1225
section.  (alias
 
1226
.BR flag , \ flags ).
1025
1227
T}
1026
1228
 
1027
1229
fgid    FGID    T{
1028
 
filesystem access group\ ID.  (alias\ \fBfsgid\fR).
 
1230
filesystem access group\ ID.  (alias
 
1231
.BR fsgid ).
1029
1232
T}
1030
1233
 
1031
1234
fgroup  FGROUP  T{
1032
 
filesystem access group\ ID.
1033
 
This will be the textual group\ ID, if\ it can be obtained
1034
 
and the field width permits,
1035
 
or\ a\ decimal representation otherwise.
1036
 
(alias\ \fBfsgroup\fR).
 
1235
filesystem access group ID.  This will be the textual group ID, if it can
 
1236
be obtained and the field width permits, or a decimal representation
 
1237
otherwise.  (alias
 
1238
.BR fsgroup ).
1037
1239
T}
1038
1240
 
1039
1241
flag    F       T{
1040
 
see\ \fBf\fR.  (alias\ \fBf\fR,\ \fBflags\fR).
 
1242
see
 
1243
.BR f .
 
1244
(alias
 
1245
.BR f , \ flags ).
1041
1246
T}
1042
1247
 
1043
1248
flags   F       T{
1044
 
see\ \fBf\fR.  (alias\ \fBf\fR,\ \fBflag\fR).
 
1249
see
 
1250
.BR f .
 
1251
(alias
 
1252
.BR f , \ flag ).
1045
1253
T}
1046
1254
 
1047
1255
fname   COMMAND T{
1048
 
first 8 bytes of the base name of the process's executable file.
1049
 
The output in this column may contain spaces.
 
1256
first 8 bytes of the base name of the process's executable file.  The output
 
1257
in this column may contain spaces.
1050
1258
T}
1051
1259
 
1052
1260
fuid    FUID    T{
1053
 
filesystem access user\ ID.  (alias\ \fBfsuid\fR).
 
1261
filesystem access user ID.  (alias
 
1262
.BR fsuid ).
1054
1263
T}
1055
1264
 
1056
1265
fuser   FUSER   T{
1057
 
filesystem access user\ ID.  This will be the textual user\ ID,
1058
 
if\ it can be obtained and the field width permits,
1059
 
or\ a\ decimal representation otherwise.
 
1266
filesystem access user ID.  This will be the textual user ID, if it can be
 
1267
obtained and the field width permits, or a decimal representation otherwise.
1060
1268
T}
1061
1269
 
1062
1270
gid     GID     T{
1063
 
see\ \fBegid\fR.  (alias\ \fBegid\fR).
 
1271
see
 
1272
.BR egid .
 
1273
(alias
 
1274
.BR egid ).
1064
1275
T}
1065
1276
 
1066
1277
group   GROUP   T{
1067
 
see\ \fBegroup\fR.  (alias\ \fBegroup\fR).
 
1278
see
 
1279
.BR egroup .
 
1280
(alias
 
1281
.BR egroup ).
1068
1282
T}
1069
1283
 
1070
1284
ignored IGNORED T{
1071
 
mask of the ignored signals, see \fIsignal\fR(7).  According to the
1072
 
width of the field, a\ 32 or 64\ bits mask in hexadecimal format
1073
 
is displayed.  (alias \fBsig_ignore\fR, \fBsigignore\fR).
 
1285
mask of the ignored signals, see
 
1286
.IR signal (7).
 
1287
According to the width of the field, a 32 or 64 bits mask in hexadecimal
 
1288
format is displayed.  (alias
 
1289
.BR sig_ignore , \ sigignore ).
1074
1290
T}
1075
1291
 
1076
1292
label   LABEL   T{
1077
 
security label, most commonly used for SE\ Linux context data.
1078
 
This is for the \fIMandatory Access Control\fR ("MAC") found on
1079
 
high\-security systems.
 
1293
security label, most commonly used for SE Linux context data.  This is for
 
1294
the
 
1295
.I Mandatory Access Control
 
1296
("MAC") found on high\-security systems.
1080
1297
T}
1081
1298
 
1082
1299
lstart  STARTED T{
1083
 
time the command started.
1084
 
See also \fBbsdstart\fR, \fBstart\fR, \fBstart_time\fR, and \fBstime\fR.
 
1300
time the command started.  See also
 
1301
.BR bsdstart , \ start , \ start_time ", and" \ stime .
1085
1302
T}
1086
1303
 
1087
1304
lwp     LWP     T{
1088
 
lwp (light weight process, or thread) ID of the lwp being reported.
1089
 
(alias\ \fBspid\fR,\ \fBtid\fR).
 
1305
light weight process (thread) ID of the dispatchable entity (alias
 
1306
.BR spid , \ tid ).
 
1307
See
 
1308
.B tid
 
1309
for additional information.
1090
1310
T}
1091
1311
 
1092
1312
maj_flt MAJFLT  T{
1093
 
The number of major page faults that have occured with this process.
 
1313
The number of major page faults that have occurred with this process.
1094
1314
T}
1095
1315
 
1096
1316
min_flt MINFLT  T{
1097
 
The number of minor page faults that have occured with this process.
 
1317
The number of minor page faults that have occurred with this process.
1098
1318
T}
1099
1319
 
1100
1320
ni      NI      T{
1101
 
nice value. This ranges from 19 (nicest) to \-20 (not\ nice to\ others),
1102
 
see\ \fInice\fR(1).  (alias\ \fBnice\fR).
 
1321
nice value. This ranges from 19 (nicest) to \-20 (not nice to others),
 
1322
see
 
1323
.IR nice (1).
 
1324
(alias
 
1325
.BR nice ).
1103
1326
T}
1104
1327
 
1105
1328
nice    NI      T{
1106
 
see\ \fBni\fR.  (alias\ \fBni\fR).
 
1329
see
 
1330
.BR ni .  (alias
 
1331
.BR ni ).
1107
1332
T}
1108
1333
 
1109
1334
nlwp    NLWP    T{
1110
 
number of lwps (threads) in the process.  (alias\ \fBthcount\fR).
 
1335
number of lwps (threads) in the process.  (alias
 
1336
.BR thcount ).
1111
1337
T}
1112
1338
 
1113
1339
nwchan  WCHAN   T{
1114
 
address of the kernel function where the process is sleeping
1115
 
(use \fBwchan\fR if you want the kernel function name).
1116
 
Running tasks will display a dash ('\-') in this column.
 
1340
address of the kernel function where the process is sleeping (use
 
1341
.B wchan
 
1342
if you want the kernel function name).  Running tasks will display a dash
 
1343
('\-') in this column.
1117
1344
T}
1118
1345
 
1119
1346
pcpu    %CPU    T{
1120
 
see\ \fB%cpu\fR.  (alias\ \fB%cpu\fR).
 
1347
see
 
1348
.BR %cpu .
 
1349
(alias
 
1350
.BR %cpu ).
1121
1351
T}
1122
1352
 
1123
1353
pending PENDING T{
1124
 
mask of the pending signals. See\ \fIsignal\fR(7).  Signals pending on
1125
 
the process are distinct from signals pending on individual threads.
1126
 
Use the \fBm\fR option or the \fB\-m\fR option to see both.
1127
 
According to the width of the field, a\ 32 or 64\ bits mask in
1128
 
hexadecimal format is displayed.  (alias\ \fBsig\fR).
 
1354
mask of the pending signals. See
 
1355
.IR signal (7).
 
1356
Signals pending on the process are distinct from signals pending on
 
1357
individual threads.  Use the
 
1358
.B m
 
1359
option or the
 
1360
.B \-m
 
1361
option to see both.  According to the width of the field, a 32 or 64 bits
 
1362
mask in hexadecimal format is displayed.  (alias
 
1363
.BR sig ).
1129
1364
T}
1130
1365
 
1131
1366
pgid    PGID    T{
1132
 
process group\ ID or, equivalently, the process\ ID of the
1133
 
process group leader.  (alias\ \fBpgrp\fR).
 
1367
process group ID or, equivalently, the process ID of the process group
 
1368
leader.  (alias
 
1369
.BR pgrp ).
1134
1370
T}
1135
1371
 
1136
1372
pgrp    PGRP    T{
1137
 
see\ \fBpgid\fR.  (alias\ \fBpgid\fR).
 
1373
see
 
1374
.BR pgid .
 
1375
(alias
 
1376
.BR pgid ).
1138
1377
T}
1139
1378
 
1140
1379
pid     PID     T{
1141
 
process\ ID number of the process.
 
1380
a number representing the process ID (alias
 
1381
.BR tgid ).
1142
1382
T}
1143
1383
 
1144
1384
pmem    %MEM    T{
1145
 
see\ \fB%mem\fR.  (alias\ \fB%mem\fR).
 
1385
see
 
1386
.BR %mem .
 
1387
(alias
 
1388
.BR %mem ).
1146
1389
T}
1147
1390
 
1148
1391
policy  POL     T{
1149
 
scheduling class of the process.  (alias\ \fBclass\fR,\ \fBcls\fR).
 
1392
scheduling class of the process.  (alias
 
1393
.BR class , \ cls ).
1150
1394
Possible values are:
1151
 
.br
 
1395
.IP "" 2
1152
1396
\-      not reported
1153
1397
.br
1154
1398
TS      SCHED_OTHER
1171
1415
T}
1172
1416
 
1173
1417
pri     PRI     T{
1174
 
priority of the process. Higher number means lower priority.
 
1418
priority of the process.  Higher number means lower priority.
1175
1419
T}
1176
1420
 
1177
1421
psr     PSR     T{
1183
1427
T}
1184
1428
 
1185
1429
rgroup  RGROUP  T{
1186
 
real group name.  This will be the textual group\ ID, if\ it can be
1187
 
obtained and the field width permits,
1188
 
or\ a\ decimal representation otherwise.
 
1430
real group name.  This will be the textual group ID, if it can be obtained
 
1431
and the field width permits, or a decimal representation otherwise.
1189
1432
T}
1190
1433
 
1191
1434
rss     RSS     T{
1192
 
resident set size, the non\-swapped physical memory that
1193
 
a task has used (in\ kiloBytes).
1194
 
(alias\ \fBrssize\fR,\ \fBrsz\fR).
 
1435
resident set size, the non\-swapped physical memory that a task has used (in\
 
1436
kiloBytes).  (alias
 
1437
.BR rssize , \ rsz ).
1195
1438
T}
1196
1439
 
1197
1440
rssize  RSS     T{
1198
 
see\ \fBrss\fR.  (alias\ \fBrss\fR,\ \fBrsz\fR).
 
1441
see
 
1442
.BR rss .
 
1443
(alias
 
1444
.BR rss , \ rsz ).
1199
1445
T}
1200
1446
 
1201
1447
rsz     RSZ     T{
1202
 
see\ \fBrss\fR.  (alias\ \fBrss\fR,\ \fBrssize\fR).
 
1448
see
 
1449
.BR rss .
 
1450
(alias
 
1451
.BR rss , \ rssize ).
1203
1452
T}
1204
1453
 
1205
1454
rtprio  RTPRIO  T{
1207
1456
T}
1208
1457
 
1209
1458
ruid    RUID    T{
1210
 
real user\ ID.
 
1459
real user ID.
1211
1460
T}
1212
1461
 
1213
1462
ruser   RUSER   T{
1214
 
real user\ ID.  This will be the textual user\ ID,
1215
 
if\ it can be obtained and the field width permits,
1216
 
or\ a\ decimal representation otherwise.
 
1463
real user ID.  This will be the textual user ID, if it can be obtained and
 
1464
the field width permits, or a decimal representation otherwise.
1217
1465
T}
1218
1466
 
1219
1467
s       S       T{
1220
 
minimal state display (one\ character).
1221
 
See\ section \fBPROCESS STATE CODES\fR for the different values.
1222
 
See\ also \fBstat\fR if you want additional
1223
 
information displayed.  (alias\ \fBstate\fR).
 
1468
minimal state display (one character).  See section
 
1469
.B PROCESS STATE CODES
 
1470
for the different values.  See also
 
1471
.B stat
 
1472
if you want additional information displayed.  (alias
 
1473
.BR state ).
1224
1474
T}
1225
1475
 
1226
1476
sched   SCH     T{
1227
1477
scheduling policy of the process.  The policies SCHED_OTHER (SCHED_NORMAL),
1228
1478
SCHED_FIFO, SCHED_RR, SCHED_BATCH, SCHED_ISO, and SCHED_IDLE are respectively
1229
 
displayed as 0,\ 1,\ 2,\ 3,\ 4,\ and\ 5.
 
1479
displayed as 0, 1, 2, 3, 4, and 5.
1230
1480
T}
1231
1481
 
1232
1482
sess    SESS    T{
1233
 
session\ ID or, equivalently, the process\ ID of the session\ leader.
1234
 
(alias\ \fBsession\fR,\ \fBsid\fR).
 
1483
session ID or, equivalently, the process ID of the session leader.  (alias
 
1484
.BR session , \ sid ).
1235
1485
T}
1236
1486
 
1237
1487
sgi_p   P       T{
1238
 
processor that the process is currently executing on.
1239
 
Displays "*" if the process is not currently running or runnable.
 
1488
processor that the process is currently executing on.  Displays "*" if the
 
1489
process is not currently running or runnable.
1240
1490
T}
1241
1491
 
1242
1492
sgid    SGID    T{
1243
 
saved group\ ID.
1244
 
(alias\ \fBsvgid\fR).
 
1493
saved group ID.  (alias
 
1494
.BR svgid ).
1245
1495
T}
1246
1496
 
1247
1497
sgroup  SGROUP  T{
1248
 
saved group\ name.  This will be the textual group\ ID,
1249
 
if\ it can be obtained and the field width permits,
1250
 
or\ a\ decimal representation otherwise.
 
1498
saved group name.  This will be the textual group ID, if it can be obtained
 
1499
and the field width permits, or a decimal representation otherwise.
1251
1500
T}
1252
1501
 
1253
1502
sid     SID     T{
1254
 
see\ \fBsess\fR.  (alias\ \fBsess\fR,\ \fBsession\fR).
 
1503
see
 
1504
.BR sess .
 
1505
(alias
 
1506
.BR sess , \ session ).
1255
1507
T}
1256
1508
 
1257
1509
sig     PENDING T{
1258
 
see\ \fBpending\fR.  (alias\ \fBpending\fR,\ \fBsig_pend\fR).
 
1510
see
 
1511
.BR pending .
 
1512
(alias
 
1513
.BR pending , \ sig_pend ).
1259
1514
T}
1260
1515
 
1261
1516
sigcatch        CAUGHT  T{
1262
 
see\ \fBcaught\fR.  (alias\ \fBcaught\fR,\ \fBsig_catch\fR).
 
1517
see
 
1518
.BR caught .
 
1519
(alias
 
1520
.BR caught , \ sig_catch ).
1263
1521
T}
1264
1522
 
1265
1523
sigignore       IGNORED T{
1266
 
see\ \fBignored\fR.  (alias\ \fBignored\fR,\ \fBsig_ignore\fR).
 
1524
see
 
1525
.BR ignored .
 
1526
(alias
 
1527
.BR ignored , \ sig_ignore ).
1267
1528
T}
1268
1529
 
1269
1530
sigmask BLOCKED T{
1270
 
see\ \fBblocked\fR.  (alias\ \fBblocked\fR,\ \fBsig_block\fR).
 
1531
see
 
1532
.BR blocked .
 
1533
(alias
 
1534
.BR blocked , \ sig_block ).
1271
1535
T}
1272
1536
 
1273
1537
size    SIZE    T{
1274
 
approximate amount of swap space that would be required
1275
 
if the process were to dirty all writable pages and then
1276
 
be swapped out.
1277
 
This number is very\ rough!
 
1538
approximate amount of swap space that would be required if the process were
 
1539
to dirty all writable pages and then be swapped out.  This number is very
 
1540
rough!
1278
1541
T}
1279
1542
 
1280
1543
spid    SPID    T{
1281
 
see \fBlwp\fR.  (alias\ \fBlwp\fR,\ \fBtid\fR).
 
1544
see
 
1545
.BR lwp .
 
1546
(alias
 
1547
.BR lwp , \ tid ).
1282
1548
T}
1283
1549
 
1284
1550
stackp  STACKP  T{
1286
1552
T}
1287
1553
 
1288
1554
start   STARTED T{
1289
 
time the command started.
1290
 
If the process was started less than 24 hours ago,
1291
 
the output format is "HH:MM:SS",
1292
 
else it is "\ \ <mm\ dd"
1293
 
(where Mmm is a three\-letter month\ name).
1294
 
See also \fBlstart\fR, \fBbsdstart\fR, \fBstart_time\fR, and \fBstime\fR.
 
1555
time the command started.  If the process was started less than 24 hours ago,
 
1556
the output format is "HH:MM:SS", else it is "\ \ Mmm\ dd" (where Mmm is a
 
1557
three\-letter month name).  See also
 
1558
.BR lstart , \ bsdstart , \ start_time ", and" \ stime .
1295
1559
T}
1296
1560
 
1297
1561
start_time      START   T{
1298
 
starting time or date of the process.
1299
 
Only the year will be displayed if the process was not
1300
 
started the same year \fBps\fR was invoked,
1301
 
or\ "MmmDD" if\ it was not started the same day,
1302
 
or\ "HH:MM" otherwise.
1303
 
See also \fBbsdstart\fR, \fBstart\fR, \fBlstart\fR, and \fBstime\fR.
 
1562
starting time or date of the process.  Only the year will be displayed if the
 
1563
process was not started the same year
 
1564
.B ps
 
1565
was invoked, or "MmmDD" if it was not started the same day, or "HH:MM"
 
1566
otherwise.  See also
 
1567
.BR bsdstart , \ start , \ lstart ", and" \ stime .
1304
1568
T}
1305
1569
 
1306
1570
stat    STAT    T{
1307
 
multi\-character process state.
1308
 
See\ section \fBPROCESS STATE CODES\fR
1309
 
for the different values meaning.
1310
 
See also \fBs\fR and \fBstate\fR if you just want
1311
 
the first character displayed.
 
1571
multi\-character process state.  See section
 
1572
.B PROCESS STATE CODES
 
1573
for the different values meaning.  See also
 
1574
.BR s \ and \ state
 
1575
if you just want the first character displayed.
1312
1576
T}
1313
1577
 
1314
1578
state   S       T{
1315
 
see\ \fBs\fR.  (alias\ \fBs\fR).
 
1579
see
 
1580
.BR s ". (alias" \ s ).
1316
1581
T}
1317
1582
 
1318
1583
suid    SUID    T{
1319
 
saved user\ ID.  (alias\ \fBsvuid\fR).
 
1584
saved user ID.  (alias
 
1585
.BR svuid ).
1320
1586
T}
1321
1587
 
1322
1588
supgid  SUPGID  T{
1323
 
gid of supplementary groups, see
 
1589
group ids of supplementary groups, if any.  See
1324
1590
.BR getgroups (2).
1325
1591
T}
1326
1592
 
1327
1593
supgrp  SUPGRP  T{
1328
 
names of supplementary groups, see
 
1594
group names of supplementary groups, if any.  See
1329
1595
.BR getgroups (2).
1330
1596
T}
1331
1597
 
1332
1598
suser   SUSER   T{
1333
 
saved user name.  This will be the textual user\ ID,
1334
 
if\ it can be obtained and the field width permits,
1335
 
or\ a\ decimal representation otherwise.
1336
 
(alias\ \fBsvuser\fR).
 
1599
saved user name.  This will be the textual user ID, if it can be obtained and
 
1600
the field width permits, or a decimal representation otherwise.  (alias
 
1601
.BR svuser ).
1337
1602
T}
1338
1603
 
1339
1604
svgid   SVGID   T{
1340
 
see\ \fBsgid\fR.  (alias\ \fBsgid\fR).
 
1605
see
 
1606
.BR sgid .
 
1607
(alias
 
1608
.BR sgid ).
1341
1609
T}
1342
1610
 
1343
1611
svuid   SVUID   T{
1344
 
see\ \fBsuid\fR.  (alias\ \fBsuid\fR).
 
1612
see
 
1613
.BR suid .
 
1614
(alias
 
1615
.BR suid ).
1345
1616
T}
1346
1617
 
1347
1618
sz      SZ      T{
1348
 
size in physical pages of the core image of the process.
1349
 
This includes text, data, and stack space.
1350
 
Device mappings are currently excluded; this is subject to change.
1351
 
See \fBvsz\fR and \fBrss\fR.
 
1619
size in physical pages of the core image of the process.  This includes text,
 
1620
data, and stack space.  Device mappings are currently excluded; this is
 
1621
subject to change.  See
 
1622
.BR vsz \ and \ rss .
 
1623
T}
 
1624
 
 
1625
tgid    TGID    T{
 
1626
a number representing the thread group to which a task belongs (alias
 
1627
.BR pid ).
 
1628
It is the process ID of the thread group leader.
1352
1629
T}
1353
1630
 
1354
1631
thcount THCNT   T{
1355
 
see \fBnlwp\fR.  (alias\ \fBnlwp\fR).
 
1632
see
 
1633
.BR nlwp .
 
1634
(alias
 
1635
.BR nlwp ).
1356
1636
number of kernel threads owned by the process.
1357
1637
T}
1358
1638
 
1359
1639
tid     TID     T{
1360
 
see\ \fBlwp\fR.  (alias\ \fBlwp\fR).
 
1640
the unique number representing a dispatacable entity (alias
 
1641
.BR lwp , \ spid ).
 
1642
This value may also appear as: a process ID (pid); a process group ID (pgrp);
 
1643
a session ID for the session leader (sid); a thread group ID for the thread
 
1644
group leader (tgid); and a tty process group ID for the process group leader
 
1645
(tpgid).
1361
1646
T}
1362
1647
 
1363
1648
time    TIME    T{
1364
 
cumulative CPU\ time, "[DD\-]HH:MM:SS" format.  (alias\ \fBcputime\fR).
 
1649
cumulative CPU\ time, "[DD\-]HH:MM:SS" format.  (alias
 
1650
.BR cputime ).
1365
1651
T}
1366
1652
 
1367
1653
tname   TTY     T{
1368
 
controlling tty (terminal).
1369
 
(alias\ \fBtt\fR,\ \fBtty\fR).
 
1654
controlling tty (terminal).  (alias
 
1655
.BR tt , \ tty ).
1370
1656
T}
1371
1657
 
1372
1658
tpgid   TPGID   T{
1373
 
ID of the foreground process group on the tty (terminal) that
1374
 
the process is connected to, or \-1 if the process is not connected
1375
 
to a tty.
 
1659
ID of the foreground process group on the tty (terminal) that the process is
 
1660
connected to, or \-1 if the process is not connected to a tty.
1376
1661
T}
1377
1662
 
1378
1663
tt      TT      T{
1379
 
controlling tty (terminal).  (alias\ \fBtname\fR,\ \fBtty\fR).
 
1664
controlling tty (terminal).  (alias
 
1665
.BR tname , \ tty ).
1380
1666
T}
1381
1667
 
1382
1668
tty     TT      T{
1383
 
controlling tty (terminal).  (alias\ \fBtname\fR,\ \fBtt\fR).
 
1669
controlling tty (terminal).  (alias
 
1670
.BR tname , \ tt ).
1384
1671
T}
1385
1672
 
1386
1673
ucmd    CMD     T{
1387
 
see \fBcomm\fR.  (alias\ \fBcomm\fR,\ \fBucomm\fR).
 
1674
see
 
1675
.BR comm .
 
1676
(alias
 
1677
.BR comm , \ ucomm ).
1388
1678
T}
1389
1679
 
1390
1680
ucomm   COMMAND T{
1391
 
see \fBcomm\fR.  (alias\ \fBcomm\fR,\ \fBucmd\fR).
 
1681
see
 
1682
.BR comm .
 
1683
(alias
 
1684
.BR comm , \ ucmd ).
1392
1685
T}
1393
1686
 
1394
1687
uid     UID     T{
1395
 
see \fBeuid\fR.  (alias\ \fBeuid\fR).
 
1688
see
 
1689
.BR euid .
 
1690
(alias
 
1691
.BR euid ).
1396
1692
T}
1397
1693
 
1398
1694
uname   USER    T{
1399
 
see \fBeuser\fR.  (alias\ \fBeuser\fR,\ \fBuser\fR).
 
1695
see
 
1696
.BR euser .
 
1697
(alias
 
1698
.BR euser , \ user ).
1400
1699
T}
1401
1700
 
1402
1701
user    USER    T{
1403
 
see \fBeuser\fR.  (alias\ \fBeuser\fR,\ \fBuname\fR).
 
1702
see
 
1703
.BR euser .
 
1704
(alias
 
1705
.BR euser , \ uname ).
1404
1706
T}
1405
1707
 
1406
1708
vsize   VSZ     T{
1407
 
see \fBvsz\fR.  (alias\ \fBvsz\fR).
 
1709
see
 
1710
.BR vsz .
 
1711
(alias
 
1712
.BR vsz ).
1408
1713
T}
1409
1714
 
1410
1715
vsz     VSZ     T{
1411
 
virtual memory size of the process in KiB (1024\-byte\ units).
1412
 
Device mappings are currently excluded; this is subject to change.
1413
 
(alias\ \fBvsize\fR).
 
1716
virtual memory size of the process in KiB (1024\-byte units).  Device
 
1717
mappings are currently excluded; this is subject to change.  (alias
 
1718
.BR vsize ).
1414
1719
T}
1415
1720
 
1416
1721
wchan   WCHAN   T{
1417
 
name of the kernel function in which the process is sleeping,
1418
 
a\ "\-"\ if the process is running,
1419
 
or a "*"\ if the process is multi\-threaded and
1420
 
\fBps\fR is not displaying threads.
 
1722
name of the kernel function in which the process is sleeping, a "\-" if the
 
1723
process is running, or a "*" if the process is multi\-threaded and
 
1724
.B ps
 
1725
is not displaying threads.
1421
1726
T}
 
1727
 
1422
1728
.TE
1423
1729
.\" #######################################################################
1424
1730
.PP
1425
1731
.PP
1426
1732
.SH "ENVIRONMENT VARIABLES"
1427
 
The following environment variables could affect \fBps\fR:
 
1733
The following environment variables could affect
 
1734
.BR ps :
1428
1735
.TP 3
1429
1736
.B COLUMNS
1430
1737
Override default display width.
1433
1740
Override default display height.
1434
1741
.TP
1435
1742
.B PS_PERSONALITY
1436
 
Set to one of posix, old, linux, bsd, sun, digital...
1437
 
(see\ section\ \fBPERSONALITY\fR\ below).
 
1743
Set to one of posix, old, linux, bsd, sun, digital...  (see section
 
1744
.B PERSONALITY
 
1745
below).
1438
1746
.TP
1439
1747
.B CMD_ENV
1440
 
Set to one of posix, old, linux, bsd, sun, digital...
1441
 
(see\ section\ \fBPERSONALITY\fR\ below).
 
1748
Set to one of posix, old, linux, bsd, sun, digital...  (see section
 
1749
.B PERSONALITY
 
1750
below).
1442
1751
.TP
1443
1752
.B I_WANT_A_BROKEN_PS
1444
1753
Force obsolete command line interpretation.
1451
1760
.TP
1452
1761
.B PS_FORMAT
1453
1762
Default output format override. You may set this to a format
1454
 
string of the type used for the \fB\-o\fR option.
1455
 
The \fBDefSysV\fR and \fBDefBSD\fR values are particularly useful.
 
1763
string of the type used for the
 
1764
.B \-o
 
1765
option.
 
1766
The
 
1767
.B DefSysV
 
1768
and
 
1769
.B DefBSD
 
1770
values are particularly useful.
1456
1771
.TP
1457
1772
.B PS_SYSMAP
1458
1773
Default namelist (System.map) location.
1464
1779
Don't find excuses to ignore bad "features".
1465
1780
.TP
1466
1781
.B POSIX2
1467
 
When set to "on", acts as \fBPOSIXLY_CORRECT\fR.
 
1782
When set to "on", acts as
 
1783
.BR POSIXLY_CORRECT .
1468
1784
.TP
1469
1785
.B UNIX95
1470
1786
Don't find excuses to ignore bad "features".
1471
1787
.TP
1472
1788
.B _XPG
1473
 
Cancel \fBCMD_ENV\fI=irix\fR non\-standard behavior.
1474
 
.PP
1475
 
In general, it\ is a bad idea to set these variables.
1476
 
The one exception is \fBCMD_ENV\fR or \fBPS_PERSONALITY\fR,
1477
 
which could be set to Linux for normal systems.
1478
 
Without that setting,
1479
 
\fBps\fR follows the useless and bad parts of the Unix98 standard.
1480
 
.PP
 
1789
Cancel \fBCMD_ENV\fR=\fIirix\fR non\-standard behavior.
 
1790
.PP
 
1791
In general, it is a bad idea to set these variables.  The one exception is
 
1792
.B CMD_ENV
 
1793
or
 
1794
.BR PS_PERSONALITY ,
 
1795
which could be set to Linux for normal systems.  Without that setting,
 
1796
.B ps
 
1797
follows the useless and bad parts of the Unix98 standard.
1481
1798
.PP
1482
1799
.SH "PERSONALITY"
1483
1800
.TS
1484
1801
l       l.
1485
1802
390     like the OS/390 OpenEdition \fBps\fR
1486
1803
aix     like AIX \fBps\fR
1487
 
bsd     like FreeBSD \fBps\fR (totally\ non\-standard)
 
1804
bsd     like FreeBSD \fBps\fR (totally non\-standard)
1488
1805
compaq  like Digital Unix \fBps\fR
1489
1806
debian  like the old Debian \fBps\fR
1490
1807
digital like Tru64 (was Digital\ Unix, was OSF/1) \fBps\fR
1492
1809
hp      like HP\-UX \fBps\fR
1493
1810
hpux    like HP\-UX \fBps\fR
1494
1811
irix    like Irix \fBps\fR
1495
 
linux   ***** RECOMMENDED *****
1496
 
old     like the original Linux \fBps\fR (totally\ non\-standard)
 
1812
linux   ***** \fBrecommended\fR *****
 
1813
old     like the original Linux \fBps\fR (totally non\-standard)
1497
1814
os390   like OS/390 Open Edition \fBps\fR
1498
1815
posix   standard
1499
1816
s390    like OS/390 Open Edition \fBps\fR
1500
1817
sco     like SCO \fBps\fR
1501
1818
sgi     like Irix \fBps\fR
1502
1819
solaris2        like Solaris 2+ (SunOS 5) \fBps\fR
1503
 
sunos4  like SunOS 4 (Solaris 1) \fBps\fR (totally\ non\-standard)
 
1820
sunos4  like SunOS 4 (Solaris 1) \fBps\fR (totally non\-standard)
1504
1821
svr4    standard
1505
1822
sysv    standard
1506
 
tru64   like Tru64 (was Digital\ Unix, was OSF/1) \fBps\fR
 
1823
tru64   like Tru64 (was Digital Unix, was OSF/1) \fBps\fR
1507
1824
unix    standard
1508
1825
unix95  standard
1509
1826
unix98  standard
1511
1828
.PP
1512
1829
.PP
1513
1830
.SH "SEE ALSO"
1514
 
\fItop\fR(1), \fIpgrep\fR(1), \fIpstree\fR(1), \fIproc\fR(5).
 
1831
.BR pgrep (1),
 
1832
.BR pstree (1),
 
1833
.BR top (1),
 
1834
.BR proc (5).
1515
1835
.PP
1516
1836
.PP
1517
1837
.SH STANDARDS
1518
 
This \fBps\fR conforms to:
 
1838
This
 
1839
.B ps
 
1840
conforms to:
1519
1841
.PP
1520
1842
.PD 0
1521
1843
.IP 1 4
1531
1853
.PD
1532
1854
.PP
1533
1855
.SH AUTHOR
1534
 
\fBps\fR was originally written by Branko Lankester <lankeste@fwi.uva.nl>. Michael
1535
 
K. Johnson <johnsonm@redhat.com> re\-wrote it significantly to use the proc
1536
 
filesystem, changing a few things in the process. Michael Shields
1537
 
<mjshield@nyx.cs.du.edu> added the pid\-list feature. Charles Blake
1538
 
<cblake@bbn.com> added multi\-level sorting, the dirent\-style library, the
1539
 
device name\-to\-number mmaped database, the approximate binary search
1540
 
directly on System.map, and many code and documentation cleanups. David
1541
 
Mossberger\-Tang wrote the generic BFD support for psupdate. Albert Cahalan
1542
 
<albert@users.sf.net> rewrote ps for full Unix98 and BSD support, along with
1543
 
some ugly hacks for obsolete and foreign syntax.
1544
 
 
1545
 
Please send bug reports to <procps\-feedback@lists.sf.net>.
1546
 
No\ subscription is required or suggested.
 
1856
.B ps
 
1857
was originally written by
 
1858
.UR lankeste@\:fwi.\:uva.\:nl
 
1859
Branko Lankester
 
1860
.UE .
 
1861
.UR johnsonm@\:redhat.\:com
 
1862
Michael K. Johnson
 
1863
.UE
 
1864
re\-wrote it significantly to use the proc filesystem, changing a few things
 
1865
in the process.
 
1866
.UR mjshield@\:nyx.\:cs.\:du.\:edu
 
1867
Michael Shields
 
1868
.UE
 
1869
added the pid\-list feature.
 
1870
.UR cblake@\:bbn.\:com
 
1871
Charles Blake
 
1872
.UE
 
1873
added multi\-level sorting, the dirent\-style library, the device
 
1874
name\-to\-number mmaped database, the approximate binary search directly on
 
1875
System.map, and many code and documentation cleanups.  David Mossberger\-Tang
 
1876
wrote the generic BFD support for psupdate.
 
1877
.UR albert@\:users.\:sf.\:net
 
1878
Albert Cahalan
 
1879
.UE
 
1880
rewrote ps for full Unix98 and BSD support, along with some ugly hacks for
 
1881
obsolete and foreign syntax.
 
1882
.PP
 
1883
Please send bug reports to
 
1884
.UR procps@\:freelists.\:org
 
1885
.UE .
 
1886
No subscription is required or suggested.