PROCMETER3(1)						      General Commands Manual						     PROCMETER3(1)

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 dis-
       played 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  out-
       puts.   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)