1 --- procps-3.1.8.orig/ps/ps.1
2 +++ procps-3.1.8/ps/ps.1
5 +.\" (The preceding line is a note to broken versions of man to tell
7 .\" Quick hack conversion by Albert Cahalan, 1998.
8 .\" Licensed under version 2 of the Gnu General Public License.
10 .\" invented this crap in 1973. Oh yeah, they did. Sorry.
12 .TH PS 1 "July 5, 1998" "Linux" "Linux User's Manual"
14 -ps \- report process status
16 +ps \- report a snapshot of the current processes.
31 ps gives a snapshot of the current processes. If you want
32 a repetitive update of this status, use top. This man
33 page documents the /proc-based version of ps, or tries to.
37 +.SH "COMMAND-LINE OPTIONS"
39 This version of ps accepts several kinds of options.
42 when options are preceeded by a dash. The PS_PERSONALITY environment
43 variable (described below) provides more detailed control of ps behavior.
45 -SIMPLE PROCESS SELECTION
46 +.SH "SIMPLE PROCESS SELECTION"
49 -A select all processes
51 -a select all with a tty except session leaders
53 r restrict output to running processes
54 x select processes without controlling ttys
55 --deselect negate selection
58 -PROCESS SELECTION BY LIST
59 +.SH "PROCESS SELECTION BY LIST"
62 -C select by command name
63 -G select by RGID (supports names)
64 -U select by RUID (supports names)
66 --user select by effective user name or ID
70 -OUTPUT FORMAT CONTROL
72 +.SH "OUTPUT FORMAT CONTROL"
77 -c different scheduler info for -l option
79 --format user-defined format
80 --context (SELinux only) Display security context format; implies --secsid
81 --secsid (SELinux only) Display Security ID
85 +.SH "OUTPUT MODIFIERS"
88 -H show process hierarchy (forest)
92 --rows set screen height
93 --sort specify sorting order
94 --width set screen width
103 L list all format specifiers
105 --help print help message
106 --info print debugging info
107 --version print version
115 A increases the argument space (DecUnix)
116 M use alternate core (try -n or N instead)
117 W get swap info from ... not /dev/drum (try -n or N instead)
118 k use /vmcore as c-dumpfile (try -n or N instead)
126 The "-g" option can select by session leader OR by group name.
127 Selection by session leader is specified by many standards,
128 @@ -226,15 +244,19 @@
129 will be destroyed by init(8) if the parent process exits.
137 FORKNOEXEC 1 forked but didn't exec
138 SUPERPRIV 2 used super-user privileges
139 DUMPCORE 4 dumped core
144 +.SH "PROCESS STATE CODES"
148 D uninterruptible sleep (usually IO)
149 R runnable (on run queue)
151 @@ -242,23 +264,30 @@
154 Z a defunct ("zombie") process
157 For BSD formats and when the "stat" keyword is used, additional
158 letters may be displayed:
160 -W has no resident pages
161 -< high-priority process
163 -L has pages locked into memory (for real-time and custom IO)
165 +has no resident pages
167 +high-priority process
171 +has pages locked into memory (for real-time and custom IO)
177 Note that the values used in sorting are the internal values ps uses and not
178 the `cooked' values used in some of the output format fields. Pipe ps
179 output into the sort(1) command if you want to sort the cooked values.
181 -KEY LONG DESCRIPTION
184 +\fBKEY LONG DESCRIPTION\fR
185 c cmd simple name of executable
186 C cmdline full command line
187 f flags flags as in long format F field
188 @@ -285,14 +314,15 @@
190 v vsize total VM size in kB
191 y priority kernel scheduling priority
195 -AIX FORMAT DESCRIPTORS
196 +.SH "AIX FORMAT DESCRIPTORS"
198 This ps supports AIX format descriptors, which work somewhat like the
199 formatting codes of printf(1) and printf(3). For example, the normal
200 default output can be produced with this: ps -eo "%p %y %x %c"
207 @@ -309,14 +339,16 @@
214 -STANDARD FORMAT SPECIFIERS
215 +.SH "STANDARD FORMAT SPECIFIERS"
217 These may be used to control both output format and sorting.
218 For example: ps -eo pid,user,args --sort user
227 @@ -438,25 +470,51 @@
233 +.SH "ENVIRONMENT VARIABLES"
237 -ENVIRONMENT VARIABLES
238 The following environment variables could affect ps:
239 - COLUMNS Override default display width.
240 - LINES Override default display height.
241 - PS_PERSONALITY Set to one of posix,old,linux,bsd,sun,digital...
242 - CMD_ENV Set to one of posix,old,linux,bsd,sun,digital...
243 - I_WANT_A_BROKEN_PS Force obsolete command line interpretation.
244 - LC_TIME Date format.
245 - PS_COLORS Not currently supported.
246 - PS_FORMAT Default output format override.
247 - PS_SYSMAP Default namelist (System.map) location.
248 - PS_SYSTEM_MAP Default namelist (System.map) location.
249 - POSIXLY_CORRECT Don't find excuses to ignore bad "features".
250 - UNIX95 Don't find excuses to ignore bad "features".
251 - _XPG Cancel CMD_ENV=irix non-standard behavior.
255 +Override default display width.
258 +Override default display height.
261 +Set to one of posix,old,linux,bsd,sun,digital...
264 +Set to one of posix,old,linux,bsd,sun,digital...
266 +.B I_WANT_A_BROKEN_PS
267 +Force obsolete command line interpretation.
273 +Not currently supported.
276 +Default output format override.
279 +Default namelist (System.map) location.
282 +Default namelist (System.map) location.
285 +Don't find excuses to ignore bad "features".
288 +Don't find excuses to ignore bad "features".
291 +Cancel CMD_ENV=irix non-standard behavior.
293 In general, it is a bad idea to set these variables. The one exception
294 is CMD_ENV or PS_PERSONALITY, which could be set to Linux for normal
296 of the Unix98 standard.
303 390 like the S/390 OpenEdition ps
305 bsd like FreeBSD ps (totally non-standard)
315 To see every process on the system using standard syntax:
317 To see every process on the system using BSD syntax:
318 @@ -502,13 +562,13 @@
319 Print only the process IDs of syslogd:
320 ps -C syslogd -o pid=
323 -top(1) pgrep(1) pstree(1) proc(5)
325 +.BR top (1), pgrep (1), pstree (1), proc (5).
329 This ps conforms to version 2 of the Single Unix Specification.
333 ps was originally written by Branko Lankester <lankeste@fwi.uva.nl>. Michael
334 K. Johnson <johnsonm@redhat.com> re-wrote it significantly to use the proc
335 filesystem, changing a few things in the process. Michael Shields
337 <acahalan@cs.uml.edu> rewrote ps for full Unix98 and BSD support, along with
338 some ugly hacks for obsolete and foreign syntax.
340 -Please send bug reports to <acahalan@cs.uml.edu>
341 +Please send bug reports to <procps-feedback@lists.sf.net>.
342 --- procps-3.1.8.orig/ps/module.mk
343 +++ procps-3.1.8/ps/module.mk
345 TARFILES += $(PSSRC) $(addprefix ps/,$(PS_X))
347 ps/ps: $(PSOBJ) $(LIBPROC)
348 - $(CC) $(LDFLAGS) -o $@ $^
349 + $(CC) $(LDFLAGS) -o $@ $^ $(SELIB)
351 # This just adds the stacktrace code
352 ps/debug: $(PSOBJ) stacktrace.o $(LIBPROC)
353 --- procps-3.1.8.orig/proc/readproc.c
354 +++ procps-3.1.8/proc/readproc.c
357 PT = openproc(flags);
361 do { /* read table: */
362 tab = xrealloc(tab, (n+1)*sizeof(proc_t*));/* realloc as we go, using */
363 tab[n] = readproc_direct(PT, NULL); /* final null to terminate */
364 --- procps-3.1.8.orig/Makefile
365 +++ procps-3.1.8/Makefile
366 @@ -155,13 +155,13 @@
367 ############ prog.o --> prog
369 pmap w uptime tload free sysctl vmstat utmp pgrep skill: % : %.o $(LIBPROC)
370 - $(CC) $(LDFLAGS) -o $@ $^
371 + $(CC) $(LDFLAGS) -o $@ $^ $(SELIB)
373 top: % : %.o $(LIBPROC)
374 - $(CC) $(LDFLAGS) -o $@ $^ $(CURSESLIB)
375 + $(CC) $(LDFLAGS) -o $@ $^ $(CURSESLIB) $(SELIB)
378 - $(CC) $(LDFLAGS) -o $@ $^ $(CURSESLIB)
379 + $(CC) $(LDFLAGS) -o $@ $^ $(CURSESLIB) $(SELIB)
381 ############ progX --> progY
383 --- procps-3.1.8.orig/skill.1
384 +++ procps-3.1.8/skill.1
387 .TH SKILL 1 "March 12, 1999" "Linux" "Linux User's Manual"
389 -skill, snice \- report process status
390 +skill \- Terminate or signal processes based on selection criteria
391 +snice \- Change processes priority based on selection criteria
395 --- procps-3.1.8.orig/kill.1
396 +++ procps-3.1.8/kill.1
398 .\" Michael K. Johnson
399 .TH KILL 1 "November 21, 1999" "Linux" "Linux User's Manual"
401 -kill \- report process status
402 +kill \- Terminate or signal a process