« back to all changes in this revision
Viewing changes to debian/patches/20_ps.1.dpatch
- browse files at revision 2
- compare with another revision
- download diff
- download tarball
- view history from revision 2
- Committer: Bazaar Package Importer
- Author(s): Craig Small
- Date: 2004-04-13 07:59:25 UTC
- Revision ID: james.westby@ubuntu.com-20040413075925-p912qrtzn1b8cc3x
Tags: 1:3.2.1-2
* Fix Makefile patch so it works with newer patch packages
Closes: #242574
* Changed the way SHARED is used in Makefiles
* init script looks nicer when setting multiple variables Closes: #241721
Closes: #242574
* Changed the way SHARED is used in Makefiles
* init script looks nicer when setting multiple variables Closes: #241721
- files added:
- debian
- debian/patches
added
removed
debian/patches/20_ps.1.dpatch
1
#! /bin/sh -e
2
## 20_ps.1.dpatch by Craig Small <csmall@debian.org>
3
##
4
## All lines beginning with `## DP:' are a description of the patch.
5
## DP: Fix ps manual page
6
7
[ -f debian/patches/00patch-opts ] && . debian/patches/00patch-opts
8
patch_opts="${patch_opts:--f --no-backup-if-mismatch}"
9
10
if [ $# -ne 1 ]; then
11
echo >&2 "`basename $0`: script expects -patch|-unpatch as argument"
12
exit 1
13
fi
14
case "$1" in
15
-patch) patch $patch_opts -p1 < $0;;
16
-unpatch) patch $patch_opts -p1 -R < $0;;
17
*)
18
echo >&2 "`basename $0`: script expects -patch|-unpatch as argum
19
ent"
20
exit 1;;
21
esac
22
23
exit 0
24
@DPATCH@
25
--- procps/ps/ps.1.orig Thu Apr 1 22:20:02 2004
26
+++ procps/ps/ps.1 Thu Apr 1 22:23:09 2004
27
@@ -1,3 +1,5 @@
28
+'\" t
29
+.\" (The preceding line is a note to broken versions of man to tell
30
.\" Man page for ps.
31
.\" Quick hack conversion by Albert Cahalan, 1998.
32
.\" Licensed under version 2 of the Gnu General Public License.
33
@@ -10,8 +12,8 @@
34
.\" invented this crap in 1973. Oh yeah, they did. Sorry.
35
.\"
36
.TH PS 1 "July 5, 1998" "Linux" "Linux User's Manual"
37
-.SH \fRNAME\fR
38
-ps \- report process status
39
+.SH NAME
40
+ps \- report a snapshot of the current processes.
41
.ad r
42
.na
43
.ss 12 0
44
@@ -19,17 +21,17 @@
45
.nh
46
.nf
47
48
-SYNOPSIS
49
+.SH SYNOPSIS
50
ps [options]
51
52
53
-DESCRIPTION
54
+.SH DESCRIPTION
55
ps gives a snapshot of the current processes. If you want
56
a repetitive update of this status, use top. This man
57
page documents the /proc-based version of ps, or tries to.
58
59
60
-COMMAND-LINE OPTIONS
61
+.SH "COMMAND-LINE OPTIONS"
62
63
This version of ps accepts several kinds of options.
64
65
@@ -43,7 +45,9 @@
66
when options are preceeded by a dash. The PS_PERSONALITY environment
67
variable (described below) provides more detailed control of ps behavior.
68
69
-SIMPLE PROCESS SELECTION
70
+.SH "SIMPLE PROCESS SELECTION"
71
+.TS
72
+l l.
73
-A select all processes
74
-N negate selection
75
-a select all with a tty except session leaders
76
@@ -55,8 +59,11 @@
77
r restrict output to running processes
78
x select processes without controlling ttys
79
--deselect negate selection
80
+.TE
81
82
-PROCESS SELECTION BY LIST
83
+.SH "PROCESS SELECTION BY LIST"
84
+.TS
85
+l l.
86
-C select by command name
87
-G select by RGID (supports names)
88
-U select by RUID (supports names)
89
@@ -78,8 +85,10 @@
90
--user select by effective user name or ID
91
-123 implied --sid
92
123 implied --pid
93
-
94
-OUTPUT FORMAT CONTROL
95
+.TE
96
+.SH "OUTPUT FORMAT CONTROL"
97
+.TS
98
+l l.
99
-O is preloaded "-o"
100
-F extra full format
101
-M add column for security data
102
@@ -100,8 +109,10 @@
103
v display virtual memory format
104
--format user-defined format
105
--context display security context format (NSA SELinux, etc.)
106
-
107
-OUTPUT MODIFIERS
108
+.TE
109
+.SH "OUTPUT MODIFIERS"
110
+.TS
111
+l l.
112
-H show process hierarchy (forest)
113
-n set namelist file
114
-w wide output
115
@@ -125,31 +136,40 @@
116
--rows set screen height
117
--sort specify sorting order
118
--width set screen width
119
-
120
-THREAD DISPLAY
121
+.TE
122
+.SH "THREAD DISPLAY"
123
+.TS
124
+l l.
125
-L show threads, possibly with LWP and NLWP columns
126
-T show threads, possibly with SPID column
127
-m show threads after processes
128
H show threads as if they were processes
129
m show threads after processes
130
+.TE
131
132
-INFORMATION
133
+.SH INFORMATION
134
+
135
+.TS
136
+l l.
137
-V print version
138
L list all format specifiers
139
V show version info
140
--help print help message
141
--info print debugging info
142
--version print version
143
+.TE
144
+
145
+.SH OBSOLETE
146
147
-OBSOLETE
148
+.TS
149
+l l.
150
A increases the argument space (DecUnix)
151
M use alternate core (try -n or N instead)
152
W get swap info from ... not /dev/drum (try -n or N instead)
153
k use /vmcore as c-dumpfile (try -n or N instead)
154
-
155
-
156
-
157
-NOTES
158
+.TE
159
+
160
+.SH NOTES
161
162
User-defined format options ("o", "-o", "O", and "-O") offer
163
a way to specify individual output columns. Headers may be
164
@@ -251,14 +271,17 @@
165
will be destroyed by init(8) if the parent process exits.
166
167
168
-PROCESS FLAGS
169
-
170
+.SH "PROCESS FLAGS"
171
+.TS
172
+l l l.
173
FORKNOEXEC 1 forked but didn't exec
174
SUPERPRIV 4 used super-user privileges
175
+.TE
176
177
+.SH "PROCESS STATE CODES"
178
179
-PROCESS STATE CODES
180
-
181
+.TS
182
+l l.
183
D uninterruptible sleep (usually IO)
184
R runnable (on run queue)
185
S sleeping
186
@@ -266,23 +289,31 @@
187
W paging (2.4 kernels and older only)
188
X dead
189
Z a defunct ("zombie") process
190
+.TE
191
192
For BSD formats and when the "stat" keyword is used, additional
193
characters may be displayed:
194
195
-< high-priority task
196
-N low-priority task
197
-L has pages locked into memory (for real-time and custom IO)
198
-s is a session leader
199
-+ is in the foreground process group
200
+.IP <
201
+high-priority task
202
+.IP N
203
+low-priority task
204
+.IP L
205
+has pages locked into memory (for real-time and custom IO)
206
+.IP s
207
+is a session leader
208
+.IP +
209
+is in the foreground process group
210
211
-SORT KEYS
212
+.SH "SORT KEYS"
213
214
Note that the values used in sorting are the internal values ps uses and not
215
the `cooked' values used in some of the output format fields. Pipe ps
216
output into the sort(1) command if you want to sort the cooked values.
217
218
-KEY LONG DESCRIPTION
219
+.TS
220
+l l l.
221
+\fBKEY LONG DESCRIPTION\fR
222
c cmd simple name of executable
223
C cmdline full command line
224
f flags flags as in long format F field
225
@@ -309,14 +340,15 @@
226
u user user name
227
v vsize total VM size in kB
228
y priority kernel scheduling priority
229
+.TE
230
231
-
232
-AIX FORMAT DESCRIPTORS
233
+.SH "AIX FORMAT DESCRIPTORS"
234
235
This ps supports AIX format descriptors, which work somewhat like the
236
formatting codes of printf(1) and printf(3). For example, the normal
237
default output can be produced with this: ps -eo "%p %y %x %c"
238
-
239
+.TS
240
+l l l.
241
CODE NORMAL HEADER
242
%C pcpu %CPU
243
%G group GROUP
244
@@ -333,14 +365,16 @@
245
%x time TIME
246
%y tty TTY
247
%z vsz VSZ
248
+.TE
249
250
-
251
-STANDARD FORMAT SPECIFIERS
252
+.SH "STANDARD FORMAT SPECIFIERS"
253
254
These may be used to control both output format and sorting.
255
For example: ps -eo pid,user,args --sort user
256
257
-CODE HEADER
258
+.TS
259
+l l.
260
+\fBCODE HEADER\fR
261
%cpu %CPU
262
%mem %MEM
263
alarm ALARM
264
@@ -461,25 +495,51 @@
265
vsize VSZ
266
vsz VSZ
267
wchan WCHAN
268
+.TE
269
270
+.SH "ENVIRONMENT VARIABLES"
271
272
-
273
-
274
-ENVIRONMENT VARIABLES
275
The following environment variables could affect ps:
276
- COLUMNS Override default display width.
277
- LINES Override default display height.
278
- PS_PERSONALITY Set to one of posix,old,linux,bsd,sun,digital...
279
- CMD_ENV Set to one of posix,old,linux,bsd,sun,digital...
280
- I_WANT_A_BROKEN_PS Force obsolete command line interpretation.
281
- LC_TIME Date format.
282
- PS_COLORS Not currently supported.
283
- PS_FORMAT Default output format override.
284
- PS_SYSMAP Default namelist (System.map) location.
285
- PS_SYSTEM_MAP Default namelist (System.map) location.
286
- POSIXLY_CORRECT Don't find excuses to ignore bad "features".
287
- UNIX95 Don't find excuses to ignore bad "features".
288
- _XPG Cancel CMD_ENV=irix non-standard behavior.
289
+
290
+.TP
291
+.B COLUMNS
292
+Override default display width.
293
+.TP
294
+.B LINES
295
+Override default display height.
296
+.TP
297
+.B PS_PERSONALITY
298
+Set to one of posix,old,linux,bsd,sun,digital...
299
+.TP
300
+.B CMD_ENV
301
+Set to one of posix,old,linux,bsd,sun,digital...
302
+.TP
303
+.B I_WANT_A_BROKEN_PS
304
+Force obsolete command line interpretation.
305
+.TP
306
+.B LC_TIME
307
+Date format.
308
+.TP
309
+.B PS_COLORS
310
+Not currently supported.
311
+.TP
312
+.B PS_FORMAT
313
+Default output format override.
314
+.TP
315
+.B PS_SYSMAP
316
+Default namelist (System.map) location.
317
+.TP
318
+.B PS_SYSTEM_MAP
319
+Default namelist (System.map) location.
320
+.TP
321
+.B POSIXLY_CORRECT
322
+Don't find excuses to ignore bad "features".
323
+.TP
324
+.B UNIX95
325
+Don't find excuses to ignore bad "features".
326
+.TP
327
+.B _XPG
328
+Cancel CMD_ENV=irix non-standard behavior.
329
330
In general, it is a bad idea to set these variables. The one exception
331
is CMD_ENV or PS_PERSONALITY, which could be set to Linux for normal
332
@@ -487,7 +547,9 @@
333
of the Unix98 standard.
334
335
336
-PERSONALITY
337
+.SH "PERSONALITY"
338
+.TS
339
+l l.
340
390 like the S/390 OpenEdition ps
341
aix like AIX ps
342
bsd like FreeBSD ps (totally non-standard)
343
@@ -509,9 +571,9 @@
344
unix standard
345
unix95 standard
346
unix98 standard
347
+.TE
348
349
-
350
-EXAMPLES
351
+.SH "EXAMPLES"
352
To see every process on the system using standard syntax:
353
ps -e
354
To see every process on the system using BSD syntax:
355
@@ -525,13 +587,13 @@
356
Print only the process IDs of syslogd:
357
ps -C syslogd -o pid=
358
359
-SEE ALSO
360
-top(1) pgrep(1) pstree(1) proc(5)
361
+.SH "SEE ALSO"
362
+.BR top (1), pgrep (1), pstree (1), proc (5).
363
364
-STANDARDS
365
+.SH STANDARDS
366
This ps conforms to version 2 of the Single Unix Specification.
367
368
-AUTHOR
369
+.SH AUTHOR
370
ps was originally written by Branko Lankester <lankeste@fwi.uva.nl>. Michael
371
K. Johnson <johnsonm@redhat.com> re-wrote it significantly to use the proc
372
filesystem, changing a few things in the process. Michael Shields
373
@@ -543,4 +605,4 @@
374
<acahalan@cs.uml.edu> rewrote ps for full Unix98 and BSD support, along with
375
some ugly hacks for obsolete and foreign syntax.
376
377
-Please send bug reports to <acahalan@cs.uml.edu>
378
+Please send bug reports to <procps-feedback@lists.sf.net>.
Loggerhead is a web-based interface for Breezy
Version: 2.0.1