documentation: fix man pages due to refactor for wchan

This patch will bring three of our man pages into line
with the recent refactor of the libprocps wchan logic.

[ and also eliminates more damn eol whitespace which ]
[ snuck in our repo with the commit referenced below ]

Reference(s):
http://www.freelists.org/post/procps/WCHAN,11
commit cf4788c28d

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2015-06-18 00:00:00 -05:00 committed by Craig Small
parent 93666da62c
commit 3600f652e8
3 changed files with 4 additions and 55 deletions

View File

@ -102,9 +102,6 @@ read information from
read information from read information from
.IR /proc/#pid/stat .IR /proc/#pid/stat
.TP 0.5i .TP 0.5i
.B "PROC_FILLWCHAN"
do WCHAN lookup
.TP 0.5i
.B "PROC_FILLARG" .B "PROC_FILLARG"
equivalent to PROC_FILLCOM equivalent to PROC_FILLCOM
.TP 0.5i .TP 0.5i

42
ps/ps.1
View File

@ -646,41 +646,9 @@ Examples:
.BI \-\-lines \ n .BI \-\-lines \ n
Set screen height. Set screen height.
.TP .TP
.BI \-n \ namelist
Set namelist file. Identical to
.BR N .
The namelist file is needed for a proper WCHAN display, and must match the
current Linux kernel exactly for correct output. Without this option, the
default search path for the namelist is:
.RS 8
.IP
$PS_SYSMAP
.br
$PS_SYSTEM_MAP
.br
/proc/*/wchan
.br
/boot/System.map\-$(uname\ \-r)
.br
/boot/System.map
.br
/lib/modules/$(uname\ \-r)/System.map
.br
/usr/src/linux/System.map
.br
/System.map
.RE
.TP
.B n .B n
Numeric output for WCHAN and USER (including all types of UID and GID). Numeric output for WCHAN and USER (including all types of UID and GID).
.TP .TP
.BI N \ namelist
Specify namelist file. Identical to
.BR \-n ,
see
.B \-n
above.
.TP
.B \-\-no\-headers .B \-\-no\-headers
Print no header line at all. Print no header line at all.
.B \-\-no\-heading .B \-\-no\-heading
@ -804,10 +772,6 @@ this
.B ps .B ps
any special permissions. any special permissions.
.PP .PP
This
.B ps
needs access to namelist data for proper WCHAN display. For kernels prior to
2.6, the System.map file must be installed.
.PP .PP
CPU usage is currently expressed as the percentage of time spent running CPU usage is currently expressed as the percentage of time spent running
during the entire lifetime of a process. This is not ideal, and\ it does not during the entire lifetime of a process. This is not ideal, and\ it does not
@ -1882,12 +1846,6 @@ and
.B DefBSD .B DefBSD
values are particularly useful. values are particularly useful.
.TP .TP
.B PS_SYSMAP
Default namelist (System.map) location.
.TP
.B PS_SYSTEM_MAP
Default namelist (System.map) location.
.TP
.B POSIXLY_CORRECT .B POSIXLY_CORRECT
Don't find excuses to ignore bad "features". Don't find excuses to ignore bad "features".
.TP .TP

View File

@ -831,16 +831,10 @@ swapped out and pages that have been mapped but not used.
.TP 4 .TP 4
38.\fB WCHAN \*(Em Sleeping in Function \fR 38.\fB WCHAN \*(Em Sleeping in Function \fR
Depending on the availability of the kernel link map (System.map), this This field will show the name of the kernel function in which the task
field will show the name or the address of the kernel function in which the is currently sleeping.
task is currently sleeping.
Running tasks will display a dash (`\-') in this column. Running tasks will display a dash (`\-') in this column.
By displaying this field, \*(We's own working set could be increased by over
700Kb, depending on the kernel version.
Should that occur, your only means of reducing that overhead will be to stop
and restart \*(We.
.TP 4 .TP 4
39.\fB nDRT \*(Em Dirty Pages Count \fR 39.\fB nDRT \*(Em Dirty Pages Count \fR
The number of pages that have been modified since they were last The number of pages that have been modified since they were last