Provided by: pcp_6.3.0-1_amd64 bug

NAME

       mpvis - visualize cpu utilization/performance

SYNOPSIS

       mpvis [-biV] [-r rowlength] [-R rowlength] [pmview options] [cpuid ...]

DESCRIPTION

       mpvis  displays  a three dimensional bar chart of CPU utilization.  The display is updated
       with new values retrieved from the target host or archive every interval seconds  (default
       is 2 seconds).

       The  height  of  the bars is proportional to the CPU utilization in each of the modes idle
       (with no I/O pending), wait (idle, but waiting for I/O  -  only  visible  in  IRIX),  intr
       (interrupt  processing - only visible in IRIX), nice (nice state - only visible in Linux),
       sys (in the kernel) and user.

       The number of CPUs per row in the scene is governed by the default maximum row length, and
       the  options  -b, -r and -R.  If none of these flags are specified, mpvis uses the default
       maximum row length to calculate the actual  number  of  rows  and  columns  in  the  view,
       according to:

            nrows = (ncpus + maxrowlen - 1) / maxrowlen
            ncols = (ncpus + nrows - 1) / nrows.

       The  -r  option  uses the above algorithm, but allows the user to override the maximum row
       length.

       The CPUs are sorted in ascending order.  They are displayed from left to right, and  front
       to back (in the case where there is more than one row of CPUs).

       The user can specify a list of CPUs as cpuid arguments using the naming scheme reported by
          $ pminfo -f kernel.percpu.cpu.user
       i.e.   cpuN   or   cpuA:B   depending  on  the  operating  system  version  and  platform.
       Alternatively, if the cpuid argument contains one of the characters ^  or  .   or  [  then
       cpuid  will  be  treated as a regular expression in the style of egrep(1) and the matching
       set of CPU names will be used instead of cpuid.

       If one or more cpuid arguments is specified, then only the CPUs in this list are displayed
       in  the view.  The list of CPUs is sorted into ascending CPU number and they are displayed
       from left to right, and front to back (in the case where there is more  than  one  row  of
       CPUs).

       mpvis  generates  a  pmview(1) configuration file, and passes most command line options to
       pmview(1).  Therefore, the command line options -A, -a, -C, -h, -n, -O, -p, -S, -t, -T, -Z
       and -z, and the user interface are described in the pmview(1) man page.

COMMAND LINE OPTIONS

       The mpvis specific options are:

       -b     Use  a ratio for row:column of 1:8.  This option is best for large numbers of CPUs.
              If the row length is not a factor of the number of CPUs, then the last row will  be
              shorter than all other rows.  This option ignores the maximum row length.

       -i     Label each CPU column with the CPU number.

       -r     Split  the  view  into  a  number of rows, where each row has a maximum length of n
              CPUs.  This is a soft limit.  The actual row length is calculated by  an  algorithm
              (see above) which prduces a balanced view with no more than n CPUs per row.

       -R     Split  the view into a number of rows, where each row has a length of n CPUs.  This
              is a hard limit.  If the row length is not a factor of the number of CPUs, then the
              last row will be shorter than all other rows.

       -V     Verbose mode - output the generated pmview(1) configuration file.

LAUNCH

       The  behavior of pmchart(1) when launched from mpvis is dependent on the number of CPUs in
       each row.  If there are more than 6 CPUs in a row then each chart will contain a  separate
       metric, otherwise each chart will contain a separate CPU instance.

FILES

       $PCP_VAR_DIR/config/pmlogger/config.mpvis
                 A pmlogger(1) configuration file for mpvis metrics.
       $PCP_SHARE_DIR/lib/pmview-args
                 Shell procedures for parsing pmview(1) command line options.

PCP ENVIRONMENT

       Environment variables with the prefix PCP_ are used to parameterize the file and directory
       names used by PCP.  On each installation, the file /etc/pcp.conf contains the local values
       for  these  variables.   The  $PCP_CONF  variable  may  be  used to specify an alternative
       configuration file, as described in pcp.conf(4).

SEE ALSO

       dkvis(1), nfsvis(1), pmcd(1), pmchart(1), pmlogger(1) and pmview(1).

       The CPU view for pmchart(1).