document the -o, o, -O, and O options

This commit is contained in:
albert 2003-05-24 03:53:51 +00:00
parent 7f48745f5e
commit bbf868e869
2 changed files with 12 additions and 0 deletions

1
NEWS
View File

@ -3,6 +3,7 @@ procps-3.1.8 --> procps-3.1.9
top: fix suspend/resume behavior
top: ditch warning until a GOOD interface is found #188271
kill: more info in the man page #182414
ps: document the -o, o, -O, and O options #169301
procps-3.1.7 --> procps-3.1.8

11
ps/ps.1
View File

@ -145,6 +145,17 @@ k use /vmcore as c-dumpfile (try -n or N instead)
NOTES
User-defined format options ("o", "-o", "O", and "-O") offer
a way to specify individual output columns. Headers may be
renamed ("ps -o pid,ruser=RealUser -o comm=Command") as desired.
If all column headers are empty ("ps -o pid= -o comm=") then the
header line will not be output. Column width will increase as
needed for wide headers; this may be used to widen up columns
such as WCHAN ("ps -o pid,wchan=WIDE-WCHAN-COLUMN -o comm").
The behavior of "ps -o pid=X,comm=Y" varies with personality;
output may be one column named "X,comm=Y" or two columns
named "X" and "Y". Use multiple -o options when in doubt.
The "-g" option can select by session leader OR by group name.
Selection by session leader is specified by many standards,
but selection by group is the logical behavior that several other