PMATOP(1)						      General Commands Manual							 PMATOP(1)

NAME

       pmatop - System & Process Monitor

SYNOPSIS

       Interactive usage:

       pmatop [-g|-m] [-L linelen] [-h host] [ interval [ samples ]]

       Writing and reading raw logfiles:

       pmatop -w rawfile [ interval [ samples ]]
       pmatop -r [ rawfile ] [-g|-m] [-L linelen] [-h host]

DESCRIPTION

       The  program  pmatop  is  an interactive monitor to view the load on a Linux system.  It shows the occupation of the most critical hardware
       resources (from a performance point of view) on system level, i.e. cpu, memory, disk and network.  By default metrics from the  local  host
       are  displayed,	but  a different host may be specified with the [-h host] option.  It is modeled after atop(1) and provides a showcase for
       the variety of data available via pmcd(1).

       Every interval (default: 10 seconds) information is shown about the resource occupation on system level (cpu,  memory,  disks  and  network
       layers),  followed by a list of processes which have been active during the last interval If the list of active processes does not entirely
       fit on the screen, only the top of the list is shown.
       The intervals are repeated till the number of samples (specified as command argument) is reached, or till the key 'q' is pressed in  inter-
       active mode.

       When  pmatop  is  started,  it checks whether the standard output channel is connected to a screen, or to a file/pipe. In the first case it
       produces screen control codes (via the ncurses library) and behaves interactively; in the second case it produces flat ASCII-output.

       In interactive mode, the output of pmatop scales dynamically to the current dimensions of the screen/window.

       Furthermore in interactive mode the output of pmatop can be controlled by pressing particular keys.  However it is also possible to specify
       such  key  as  flag  on the command line. In that case pmatop switches to the indicated mode on beforehand; this mode can be modified again
       interactively. Specifying such key as flag is especially useful when running pmatop with output to  a  pipe  or	file  (non-interactively).
       These flags are the same as the keys that can be pressed in interactive mode (see section INTERACTIVE COMMANDS).

OUTPUT FORMAT

       The output of pmatop consists of system level and process level information.  The system level information consists of the following output
       lines:

       PRC  Process and thread level totals.
	    This line contains the total cpu time consumed in system mode (`sys') and in user mode (`user'), the total number of processes present
	    at this moment (`#proc'), `sleeping interruptible' (`#tslpi') and `sleeping uninterruptible' (`#tslpu'), and the number of zombie pro-
	    cesses (`#zombie').

       CPU  The occupation percentage of this process related to the available capacity for this resource on system level.
	    This line contains the total CPU usage in system mode, in user mode, in irq mode, in idle mode, and in wait mode.  The cpu lines  con-
	    tain this information on a per cpu basis.

       CPL  This  line	contains  load	average  information  for  the last minute, five minutes, and fifteen minutes.	Also the number of context
	    switches and the number of device interrupts.

       MEM  This line contains the size of physical memory, free memory, page cache, buffer cache, and slab.

       SWP  This line contains the size of swap, free swap, committed space, and committed space limit.

       PAG  This line contains the number of page scans, allocstalls, swapins, and swapouts.

       LVM/MDD/DSK
	    For every logical volume/multiple device/hard disk one line is shown containing the name, number of reads, and number of writes.

       NET  The first line is for the upper TCP/IP layer and contains the number of packets received, packets transmitted, packets received.   The
	    next line is one per network interface and contains the number of packets received and number of packets transmitted.

       PROCESS
	    The remaining lines are one line per process and can be controlled as described below.

INTERACTIVE COMMANDS

       When running pmatop interactively (no output redirection), keys can be pressed to control the output.

       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 are 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.

       Miscellaneous interactive commands:

       ?    Request for help information (also the key 'h' can be pressed).

       z    The pause key can be used to freeze the current situation in order to investigate the output on the screen. While  pmatop  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, pmatop will continue with a next sample.

SEE ALSO

       PCPIntro(1), collectl(1), perl(1), python(1), pmlogger(1), pmcd(1), pmprobe(1), pmval(1), PMAPI(3), and pcp.conf(4).

Performance Co-Pilot							PCP								 PMATOP(1)