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)