diff --git a/NEWS b/NEWS index a487278a..b0ecfc0d 100644 --- a/NEWS +++ b/NEWS @@ -9,6 +9,7 @@ procps-ng-NEXT * library: add support for accessing smaps_rollup issue #112, #201 * library: add support for accessing autogroups * 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 * pgrep: Add newline after regex error message merge #91 * 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: added two new autogroup fields * top: added long versions of command line options + * top: added 'start time' and 'cpu utilization' fields * uptime: print short/pretty format correctly issue #217 * vmstat: add -y option to remove first line merge !72 diff --git a/top/top.1 b/top/top.1 index 0f32807d..61d62fd3 100644 --- a/top/top.1 +++ b/top/top.1 @@ -59,7 +59,7 @@ memory statistics and data for other users requires root privileges . .\" Document ///////////////////////////////////////////////////////////// .\" ---------------------------------------------------------------------- -.TH TOP 1 "January 2022" "procps-ng" "User Commands" +.TH TOP 1 "March 2022" "procps-ng" "User Commands" .\" ---------------------------------------------------------------------- .nh @@ -636,6 +636,16 @@ those unseen children. \*(XT 4c. TASK AREA Commands, CONTENT for more information regarding 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 \fB%MEM \*(Em Memory Usage (RES) \fR 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 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 \fBSUID \*(Em Saved User Id \fR The\fI saved\fR user ID.