summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorJim Warner <james.warner@comcast.net>2023-03-16 00:00:00 -0500
committerCraig Small <csmall@dropbear.xyz>2023-03-21 22:11:29 +1100
commitbb7e161d5a06f1bbd5a98cf868eab356c6c1bac2 (patch)
tree9b967d7dcbccb75809815e041d750a2b927469f7 /man
parent411eaa1aa7d511aba6fb4df1cdb4335e838efdb5 (diff)
downloadprocps-ng-bb7e161d5a06f1bbd5a98cf868eab356c6c1bac2.tar.gz
top: address the missing 'guest' tics for summary area
Well this is embarrassing. After repeatedly flogging a horse (represented by issue #274) I was certain it was dead. But, it turns out that the darn thing yet lived. In fact, the bug that was patched was not even the one the poster experienced. Now merge request #173 finally penetrated my foggy brain and explicated the real bug. Since forever (linux 2.6), top has ignored those guest and guest_nice fields in /proc/stat. When many virtual machines were running that overhead went unrecognized. So, this commit simply adds those tics to the 'system' figures so that it can be seen in text or graph modes. Reference(s): https://gitlab.com/procps-ng/procps/-/merge_requests/173 https://gitlab.com/procps-ng/procps/-/issues/274 . Mar 2023, avoid keystroke '%Cpu' distortions commit 7e33fc47c642aceea8ad53e86a6797239b91f5f9 Signed-off-by: Jim Warner <james.warner@comcast.net>
Diffstat (limited to 'man')
-rw-r--r--man/top.17
1 files changed, 5 insertions, 2 deletions
diff --git a/man/top.1 b/man/top.1
index 5a77beb..8bf804a 100644
--- a/man/top.1
+++ b/man/top.1
@@ -527,6 +527,9 @@ Depending on your kernel version, the \fBst\fR field may not be shown.
\fBst\fR : time stolen from this vm by the hypervisor
.fi
+The `sy' value above also reflects the time running a virtual \*(Pu
+for guest operating systems, including those that have been niced.
+
Beyond the first tasks/threads line, there are alternate \*(PU display
modes available via the 4-way `t' \*(CT.
They show an abbreviated summary consisting of these elements:
@@ -537,8 +540,8 @@ They show an abbreviated summary consisting of these elements:
.fi
Where: a) is the `user' (us + ni) percentage; b) is the `system'
-(sy + hi + si) percentage; c) is the total percentage; and d) is
-one of two visual graphs of those representations.
+(sy + hi + si + guests) percentage; c) is the total percentage;
+and d) is one of two visual graphs of those representations.
Such graphs also reflect separate `user' and `system' portions.
If the `4' \*(CT is used to yield more than two cpus per line,