NAME

       procmeter3, procmeter3-xaw - A user friendly system monitoring program.

SYNOPSIS

       procmeter3|procmeter3-xaw   [-w  <hint1>[,<hint2>]]  [-h|--help]  [--rc=<filename>]  [--...]   [...]   [X
        windows  options]

DESCRIPTION

       ProcMeter Displays one or more pieces of information about the  operating  system  and  other  resources.
       Most  of  the  information that is displayed comes from the /proc filesystem.  The program is modular and
       very configurable.

OPTIONS

       The command line options are described below.

       -h     Provides a help message listing the available outputs.   This  will  be  different  for  different
              computers  depending on the Linux kernel version that is being used and the hardware/software that
              is configured.

       -w     Gives Extended Window Manager hints (EWMH) to change the way that the Window  Manager  treats  the
              ProcMeter3 window.  Implemented hints are: above, below, skip_pager, skip_taskbar, sticky.

              You  can  give more than one hint separated by commas (e. g. -w above,skip_taskbar,sticky), or use
              -w multiple times (e. g. -w above -w sticky).

       --rc=<filename>
              Load the specified .procmeterrc file in stead of the searching in the usual places.

       --...  A list of configuration file options that will override the values in the .procmeterrc file.   The
              format  of these options is (for example) --resources.background=grey50 which is equivalent to the
              entry in the .procmeterrc file of

               [resources]
               background = grey50

              All spaces around the equal sign must be removed and if spaces are required in the  value  on  the
              right hand side then quotes must be used around the entire command line option.

       ...    A list of names of outputs that are to be displayed.  This can include any of the outputs that are
              available (see the -h option).  For the CPU usage is in a module named Statistics with  an  output
              named  CPU  and  there  are  graph (-g), text (-t) and bar (-b) options.  To display the CPU usage
              graph you would use the command line option Statistics.CPU-g

       X windows options
              The standard set of X Windows program options, see X(1) for information.  These include  -geometry
              to set the size of the window, -display to set the display and other general X window options.

USAGE

       When  started  the  program  will  display  all  of  the  requested information in a set of output panels
       (vertically aligned by default).  Each output can be either a graph, text or bar, and can  have  a  label
       indicating  what it represents.  The outputs that are displayed are those from the command line and those
       from the .procmeterrc configuration file.

       The left mouse button will produce a menu of options that are specific to the output  that  is  selected.
       The  Properties  option  on this menu will give more detailed information about the origin and meaning of
       the information that is displayed.  When the properties information  window  is  displayed,  clicking  on
       another  output will change the displayed information.  The Move to Above and Move to Below options allow
       the output to be moved around in the window.  Selecting one of these options will change the mouse cursor
       to  a hand, use this to select another output.  The output that was selected first will be moved to above
       or below the output that was selected second.  The Run option on the menu (which may not be available  on
       all  outputs)  will  run the specified command.  This may be to display a list of running processes, show
       the amount of free memory  or  disk  space  for  example.   This  menu  option  is  configurable  in  the
       .procmeterrc file.

       The  right mouse button will produce a set of menus that list the modules that are available and for each
       of them the available set of outputs.  There are three types of output, text and two  graphical  outputs,
       these  are  indicated in the sub-menus by icons.  Selecting one of the outputs from a sub-menu will cause
       that output to be displayed if it is not already visible.  If it is currently displayed then it  will  be
       disabled.   Those  that  are  currently  displayed are indicated by a marker to the left in the sub-menu.
       When the output is added to the window it will be placed at the bottom, use the left mouse button to move
       it if required.

       The  middle mouse button will display the sub-menu that is associated with the module for the output that
       is selected.  This is one of sub-menus that are found with the right mouse button.

MODULES

       The  modules  that  are  available   for   procmeter3   and   procmeter3-xaw   are   described   in   the
       procmeter3_modules(1) manual page.

X RESOURCES

       As  with  all  X  Window  programs  X  resources can be used.  For this version of ProcMeter (compared to
       previous  versions)  this  is  not  the  default  method  of   configuring   the   program.    The   file
       $HOME/.procmeterrc contains the configuration information.

SEE ALSO

       X(1) procmeterrc(5) procmeter3_modules(1)

AUTHOR

       Andrew M. Bishop 1998-2008

                                                  July 3, 2010                                     PROCMETER3(1)