doc: updated with new 'start time' & 'cpu utilization'

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2022-02-25 00:00:00 -06:00 committed by Craig Small
parent 7647e96b0a
commit a39f2bffdc
2 changed files with 18 additions and 1 deletions

2
NEWS
View File

@ -9,6 +9,7 @@ procps-ng-NEXT
* library: add support for accessing smaps_rollup issue #112, #201 * library: add support for accessing smaps_rollup issue #112, #201
* library: add support for accessing autogroups * library: add support for accessing autogroups
* library: add support for LIBPROC_HIDE_KERNEL env var merge #147 * library: add support for LIBPROC_HIDE_KERNEL env var merge #147
* library: add support for cpu utilization to pids i/f
* pkill: Check for lt- variants of program name issue #192 * pkill: Check for lt- variants of program name issue #192
* pgrep: Add newline after regex error message merge #91 * pgrep: Add newline after regex error message merge #91
* pgrep: Fix selection where uid/gid > 2^31 merge !146 * pgrep: Fix selection where uid/gid > 2^31 merge !146
@ -31,6 +32,7 @@ procps-ng-NEXT
* top: summary area memory lines can print two abreast * top: summary area memory lines can print two abreast
* top: added two new autogroup fields * top: added two new autogroup fields
* top: added long versions of command line options * top: added long versions of command line options
* top: added 'start time' and 'cpu utilization' fields
* uptime: print short/pretty format correctly issue #217 * uptime: print short/pretty format correctly issue #217
* vmstat: add -y option to remove first line merge !72 * vmstat: add -y option to remove first line merge !72

View File

@ -59,7 +59,7 @@ memory statistics and data for other users requires root privileges
. .
.\" Document ///////////////////////////////////////////////////////////// .\" Document /////////////////////////////////////////////////////////////
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.TH TOP 1 "January 2022" "procps-ng" "User Commands" .TH TOP 1 "March 2022" "procps-ng" "User Commands"
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.nh .nh
@ -636,6 +636,16 @@ those unseen children.
\*(XT 4c. TASK AREA Commands, CONTENT for more information regarding \*(XT 4c. TASK AREA Commands, CONTENT for more information regarding
the `V' and `v' toggles. the `V' and `v' toggles.
.TP 4
\fB%CUU \*(Em \*(PU Utilization \fR
A task's total \*(PU usage divided by its elapsed running time,
expressed as a percentage.
If a process currently displays high \*(PU usage, this field can help
determine if such behavior is normal.
Conversely, if a process has low \*(PU usage currently, %CUU may reflect
historically higher demands over its lifetime.
.TP 4 .TP 4
\fB%MEM \*(Em Memory Usage (RES) \fR \fB%MEM \*(Em Memory Usage (RES) \fR
A task's currently resident share of available \*(MP. A task's currently resident share of available \*(MP.
@ -969,6 +979,11 @@ By convention, this value equals the process ID (\*(Xa PID) of the first
member of the session, called the session leader, which is usually the member of the session, called the session leader, which is usually the
login shell. login shell.
.TP 4
\fBSTARTED \*(Em Start Time \fR
The length of time since system boot when a process started.
Thus, the most recently started task will display the largest time interval.
.TP 4 .TP 4
\fBSUID \*(Em Saved User Id \fR \fBSUID \*(Em Saved User Id \fR
The\fI saved\fR user ID. The\fI saved\fR user ID.