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)