---

   pcp-atop    ( 1 )

---

Интерактивные команды (Interactive commands)

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.