When running pcp-atop interactively (no output redirection), keys
can be pressed to control the output. In general, lower case
keys can be used to show other information for the active
processes and upper case keys can be used to influence the sort
order of the active process/thread list.
g Show generic output (default).
Per process the following fields are shown in case of a
window-width of 80 positions: process-id, cpu consumption
during the last interval in system and user mode, the
virtual and resident memory growth of the process.
The subsequent columns depend on the used kernel:
When the kernel supports "storage accounting" (>= 2.6.20),
the data transfer for read/write on disk, the status and
exit code are shown for each process. When the kernel does
not support "storage accounting", the username, number of
threads in the thread group, the status and exit code are
shown.
The last columns contain the state, the occupation
percentage for the chosen resource (default: cpu) and the
process name.
When more than 80 positions are available, other information
is added.
m Show memory related output.
Per process the following fields are shown in case of a
window-width of 80 positions: process-id, minor and major
memory faults, size of virtual shared text, total virtual
process size, total resident process size, virtual and
resident growth during last interval, memory occupation
percentage and process name.
When more than 80 positions are available, other information
is added.
For memory consumption, always all processes are shown (also
the processes that were not active during the interval).
d Show disk-related output.
When "storage accounting" is active in the kernel, the
following fields are shown: process-id, amount of data read
from disk, amount of data written to disk, amount of data
that was written but has been withdrawn again (WCANCL), disk
occupation percentage and process name.
s Show scheduling characteristics.
Per process the following fields are shown in case of a
window-width of 80 positions: process-id, number of threads
in state 'running' (R), number of threads in state
'interruptible sleeping' (S), number of threads in state
'uninterruptible sleeping' (D), scheduling policy (normal
timesharing, realtime round-robin, realtime fifo), nice
value, priority, realtime priority, current processor,
status, exit code, state, the occupation percentage for the
chosen resource and the process name.
When more than 80 positions are available, other information
is added.
v Show various process characteristics.
Per process the following fields are shown in case of a
window-width of 80 positions: process-id, user name and
group, start date and time, status (e.g. exit code if the
process has finished), state, the occupation percentage for
the chosen resource and the process name.
When more than 80 positions are available, other information
is added.
c Show the command line of the process.
Per process the following fields are shown: process-id, the
occupation percentage for the chosen resource and the
command line including arguments.
e Show GPU utilization.
Per process at least the following fields are shown:
process-id, range of GPU numbers on which the process
currently runs, GPU busy percentage on all GPUs, memory busy
percentage (i.e. read and write accesses on memory) on all
GPUs, memory occupation at the moment of the sample, average
memory occupation during the sample, and GPU percentage.
When the pmdanvidia daemon does not run with root
privileges, the GPU busy percentage and the memory busy
percentage are not available on process level. In that
case, the GPU percentage on process level reflects the GPU
memory occupation instead of the GPU busy percentage (which
is preferred).
o Show the user-defined line of the process.
In the configuration file the keyword ownprocline can be
specified with the description of a user-defined output-
line.
Refer to the man-page of pcp-atoprc(5) for a detailed
description.
y Show the individual threads within a process (toggle).
Single-threaded processes are still shown as one line.
For multi-threaded processes, one line represents the
process while additional lines show the activity per
individual thread (in a different color). Depending on the
option 'a' (all or active toggle), all threads are shown or
only the threads that were active during the last interval.
Depending on the option 'Y' (sort threads), the threads per
process will be sorted on the chosen sort criterium or not.
Whether this key is active or not can be seen in the header
line.
Y Sort the threads per process when combined with option 'y'
(toggle).
u Show the process activity accumulated per user.
Per user the following fields are shown: number of processes
active or terminated during last interval (or in total if
combined with command `a'), accumulated cpu consumption
during last interval in system and user mode, the current
virtual and resident memory space consumed by active
processes (or all processes of the user if combined with
command `a').
When "storage accounting" is active in the kernel, the
accumulated read and write throughput on disk is shown.
When the pmdabcc(1) module `netproc' has been installed, the
number of receive and send network calls are shown.
The last columns contain the accumulated occupation
percentage for the chosen resource (default: cpu) and the
user name.
p Show the process activity accumulated per program (i.e.
process name).
Per program the following fields are shown: number of
processes active or terminated during last interval (or in
total if combined with command `a'), accumulated cpu
consumption during last interval in system and user mode,
the current virtual and resident memory space consumed by
active processes (or all processes of the user if combined
with command `a').
When "storage accounting" is active in the kernel, the
accumulated read and write throughput on disk is shown.
When the pmdabcc(1) module `netproc' has been installed, the
number of receive and send network calls are shown.
The last columns contain the accumulated occupation
percentage for the chosen resource (default: cpu) and the
program name.
j Show the process activity accumulated per Docker container.
Per container the following fields are shown: number of
processes active or terminated during last interval (or in
total if combined with command `a'), accumulated cpu
consumption during last interval in system and user mode,
the current virtual and resident memory space consumed by
active processes (or all processes of the user if combined
with command `a').
When "storage accounting" is active in the kernel, the
accumulated read and write throughput on disk is shown.
When the pmdabcc(1) module `netproc' has been installed, the
number of receive and send network calls are shown.
The last columns contain the accumulated occupation
percentage for the chosen resource (default: cpu) and the
Docker container id (CID).
C Sort the current list in the order of cpu consumption
(default). The one-but-last column changes to ``CPU''.
E Sort the current list in the order of GPU utilization
(preferred, but only applicable when the pmdanvidia daemon
runs under root privileges) or the order of GPU memory
occupation). The one-but-last column changes to ``GPU''.
M Sort the current list in the order of resident memory
consumption. The one-but-last column changes to ``MEM''.
In case of sorting on memory, the full process list will be
shown (not only the active processes).
D Sort the current list in the order of disk accesses issued.
The one-but-last column changes to ``DSK''.
N Sort the current list in the order of network bandwidth
(received and transmitted). The one-but-last column changes
to ``NET''.
A Sort the current list automatically in the order of the most
busy system resource during this interval. The one-but-last
column shows either ``ACPU'', ``AMEM'', ``ADSK'' or ``ANET''
(the preceding 'A' indicates automatic sorting-order). The
most busy resource is determined by comparing the weighted
busy-percentages of the system resources, as described
earlier in the section COLORS.
This option remains valid until another sorting-order is
explicitly selected again.
A sorting-order for disk is only possible when "storage
accounting" is active. A sorting-order for network is only
possible when the pmdabcc(1) module `netproc' has been
installed.
Miscellaneous interactive commands:
? Request for help information (also the key 'h' can be
pressed).
V Request for version information (version number and date).
R Gather and calculate the proportional set size of processes
(toggle). Gathering of all values that are needed to
calculate the PSIZE of a process is a very time-consuming
task, so this key should only be active when analyzing the
resident memory consumption of processes.
W Get the WCHAN per thread (toggle). Gathering of the WCHAN
string per thread is a relatively time-consuming task, so
this key should only be made active when analyzing the
reason for threads to be in sleep state.
x Suppress colors to highlight critical resources (toggle).
Whether this key is active or not can be seen in the header
line.
z The pause key can be used to freeze the current situation in
order to investigate the output on the screen. While pcp-
atop is paused, the keys described above can be pressed to
show other information about the current list of processes.
Whenever the pause key is pressed again, pcp-atop will
continue with the next sample.
i Modify the interval timer (default: 10 seconds). If an
interval timer of 0 is entered, the interval timer is
switched off. In that case a new sample can only be
triggered manually by pressing the key 't'.
t Trigger a new sample manually. This key can be pressed if
the current sample should be finished before the timer has
exceeded, or if no timer is set at all (interval timer
defined as 0). In the latter case pcp-atop can be used as a
stopwatch to measure the load being caused by a particular
application transaction, without knowing on beforehand how
many seconds this transaction will last.
When viewing the contents of an archive folio, this key can
be used to show the next sample from the folio.
T When viewing the contents of an archive folio, this key can
be used to show the previous sample from the folio.
b When viewing the contents of an archive folio, this key can
be used to move to a certain timestamp within the file
(either forward or backward).
r Reset all counters to zero to see the system and process
activity since boot again.
When viewing the contents of an archive, this key can be
used to rewind to the beginning of the file again.
U Specify a search string for specific user names as a regular
expression. From now on, only (active) processes will be
shown from a user which matches the regular expression. The
system statistics are still system wide. If the Enter-key
is pressed without specifying a name, (active) processes of
all users will be shown again.
Whether this key is active or not can be seen in the header
line.
I Specify a list with one or more PIDs to be selected. From
now on, only processes will be shown with a PID which
matches one of the given list. The system statistics are
still system wide. If the Enter-key is pressed without
specifying a PID, all (active) processes will be shown
again.
Whether this key is active or not can be seen in the header
line.
P Specify a search string for specific process names as a
regular expression. From now on, only processes will be
shown with a name which matches the regular expression. The
system statistics are still system wide. If the Enter-key
is pressed without specifying a name, all (active) processes
will be shown again.
Whether this key is active or not can be seen in the header
line.
/ Specify a specific command line search string as a regular
expression. From now on, only processes will be shown with
a command line which matches the regular expression. The
system statistics are still system wide. If the Enter-key
is pressed without specifying a string, all (active)
processes will be shown again.
Whether this key is active or not can be seen in the header
line.
J Specify a Docker container id of 12 (hexadecimal)
characters. From now on, only processes will be shown that
run in that specific Docker container (CID). The system
statistics are still system wide. If the Enter-key is
pressed without specifying a container id, all (active)
processes will be shown again.
Whether this key is active or not can be seen in the header
line.
Q Specify a comma-separated list of process state characters.
From now on, only processes will be shown that are in those
specific process states. Accepted states are: R (running),
S (sleeping), D (disk sleep), T (stopped), t (tracing stop),
X (dead), Z (zombie) and P (parked). The system statistics
are still system wide. If the Enter-key is pressed without
specifying a state, all (active) processes will be shown
again.
Whether this key is active or not can be seen in the header
line.
S Specify search strings for specific logical volume names,
specific disk names and specific network interface names.
All search strings are interpreted as a regular expressions.
From now on, only those system resources are shown that
match the concerning regular expression. If the Enter-key
is pressed without specifying a search string, all (active)
system resources of that type will be shown again.
Whether this key is active or not can be seen in the header
line.
a The `all/active' key can be used to toggle between only
showing/accumulating the processes that were active during
the last interval (default) or showing/accumulating all
processes.
Whether this key is active or not can be seen in the header
line.
G By default, pcp-atop shows/accumulates the processes that
are alive and the processes that are exited during the last
interval. With this key (toggle), showing/accumulating the
processes that are exited can be suppressed.
Whether this key is active or not can be seen in the header
line.
f Show a fixed (maximum) number of header lines for system
resources (toggle). By default only the lines are shown
about system resources (CPUs, paging, logical volumes,
disks, network interfaces) that really have been active
during the last interval. With this key you can force pcp-
atop to show lines of inactive resources as well.
Whether this key is active or not can be seen in the header
line.
F Suppress sorting of system resources (toggle). By default
system resources (CPUs, logical volumes, disks, network
interfaces) are sorted on utilization.
Whether this key is active or not can be seen in the header
line.
1 Show relevant counters as an average per second (in the
format `..../s') instead of as a total during the interval
(toggle).
Whether this key is active or not can be seen in the header
line.
l Limit the number of system level lines for the counters per-
cpu, the active disks and the network interfaces. By
default lines are shown of all CPUs, disks and network
interfaces which have been active during the last interval.
Limiting these lines can be useful on systems with huge
number CPUs, disks or interfaces in order to be able to run
pcp-atop on a screen/window with e.g. only 24 lines.
For all mentioned resources the maximum number of lines can
be specified interactively. When using the flag -l the
maximum number of per-cpu lines is set to 0, the maximum
number of disk lines to 5 and the maximum number of
interface lines to 3. These values can be modified again in
interactive mode.
k Send a signal to an active process (a.k.a. kill a process).
q Quit the program.
PgDn Show the next page of the process/thread list.
With the arrow-down key the list can be scrolled downwards
with single lines.
^F Show the next page of the process/thread list (forward).
With the arrow-down key the list can be scrolled downwards
with single lines.
PgUp Show the previous page of the process/thread list.
With the arrow-up key the list can be scrolled upwards with
single lines.
^B Show the previous page of the process/thread list
(backward).
With the arrow-up key the list can be scrolled upwards with
single lines.
^L Redraw the screen.
