diff options
author | Alessio Sergi <al3hex@gmail.com> | 2016-03-02 13:29:19 +0100 |
---|---|---|
committer | Alessio Sergi <al3hex@gmail.com> | 2016-03-06 19:16:37 +0100 |
commit | c1e1ad4da5d95b50c1426f7cba879e73d3dc12a8 (patch) | |
tree | d301afe06ef8c404b9b6c8a03e9f4dd47b51d406 /docs/aoa/ps.rst | |
parent | fcc65bf14d0ba5c1b812cf63047db489bf2b6c22 (diff) |
Use Sphinx for doc
Diffstat (limited to 'docs/aoa/ps.rst')
-rw-r--r-- | docs/aoa/ps.rst | 107 |
1 files changed, 107 insertions, 0 deletions
diff --git a/docs/aoa/ps.rst b/docs/aoa/ps.rst new file mode 100644 index 00000000..a85a7d96 --- /dev/null +++ b/docs/aoa/ps.rst @@ -0,0 +1,107 @@ +.. _ps: + +Processes List +============== + +Compact view: + +.. image:: ../_static/processlist.png + +Full view: + +.. image:: ../_static/processlist-wide.png + +Filtered view: + +.. image:: ../_static/processlist-filter.png + +The process view consists of 3 parts: + +- Processes summary +- Monitored processes list (optional) +- Processes list + +The processes summary line displays: + +- Tasks number (total number of processes) +- Threads number +- Running tasks number +- Sleeping tasks number +- Other tasks number (not running or sleeping) +- Sort key + +By default, or if you hit the ``a`` key, the processes list is +automatically sorted by: + +- ``CPU``: if there is no alert (default behavior) +- ``CPU``: if a CPU or LOAD alert is detected +- ``MEM``: if a memory alert is detected +- ``DISK I/O``: if a CPU iowait alert is detected + +The number of processes in the list is adapted to the screen size. + +Columns display +--------------- + +========================= ============================================== +``CPU%`` % of CPU used by the process + + If Irix/Solaris mode is off, the value is + divided by logical core number +``MEM%`` % of MEM used by the process +``VIRT`` Virtual Memory Size + + The total amount of virtual memory used by the + process +``RES`` Resident Memory Size + + The non-swapped physical memory a process is + using +``PID`` Process ID +``USER`` User ID +``NI`` Nice level of the process +``S`` Process status + + The status of the process: + + - ``R``: running + - ``S``: sleeping (may be interrupted) + - ``D``: disk sleep (may not be interrupted) + - ``T``: traced/stopped + - ``Z``: zombie + +``TIME+`` Cumulative CPU time used by the process +``R/s`` Per process I/O read rate in B/s +``W/s`` Per process I/O write rate in B/s +``COMMAND`` Process command line or command name + + User can switch to the process name by + pressing on the ``'/'`` key +========================= ============================================== + +Extended info +------------- + +.. image:: ../_static/processlist-top.png + +In standalone mode, additional information are provided for the top +process: + +========================= ============================================== +``CPU affinity`` Number of cores used by the process +``Memory info`` Extended memory information about the process + + For example, on Linux: swap, shared, text, + lib, data and dirty +``Open`` The number of threads, files and network + sessions (TCP and UDP) used by the process +``IO nice`` The process I/O niceness (priority) +========================= ============================================== + +The extended stats feature can be enabled using the +``--enable-process-extended`` option (command line) or the ``e`` key +(curses interface). + +.. note:: + Limit values can be overwritten in the configuration file under + the ``[process]`` section. |