LOADMETER(1)						      General Commands Manual						      LOADMETER(1)

NAME

       loadmeter - System load/resource monitor for X

SYNOPSIS

       loadmeter  [  -display  display ] [ -geometry geometry ] [ -name name ] [ -numfont font ] [ -labelfont font ] [ -label label ] [ -popupfont
       font ] [ -popupbg colour ] [ -popupfg colour ] [ -warn percent ] [ -warnbg colour ] [ -meter colour ] [ -override ] [ -sync ] [ -bh  height
       ] [ -parent window ] [ -disk ] [ -noshrink ] [ -nogeom ]

DESCRIPTION

       loadmeter  is  a utility to monitor various system resources. It runs (currently) under Linux and Solaris systems running the X Window Sys-
       tem. It displays information about system hostname, load average, uptime, disk usage and memory	information.   loadmeter  uses	the  /proc
       filesystem  to  gather  most  of this information under Linux, and under Solaris it reads kernel symbols (What a headache!).  In its normal
       state it displays a window with a coloured bar graph showing the load average for the past minute. This is also shown in digits at the  top
       of  the window. Both are updated every second. A red notch marks the maximum load since loadmeter was started, and can be reset by pressing
       Button2 or hidden with Button3.	A blue notch shows the 5 minute load average.

       By clicking with Button1, a pop-up window appears showing the uptime, the load average for the past 1, 5 and 15 minutes,  the  capacity	of
       each  filesystem,  and  memory/swap usage. More detailed information on each filesystem is available by highlighting the corresponding one.
       The way this window pops down is intentional, just to make it interesting. :) (Can be disabled with -noshrink).

       Any filesystems with higher usage than specified by the -warn option (default 90%) are shown with a (default) green background in the popup
       menu.  If  the -disk option is specified, the text 'disk' appears on the main window if the usage of any filesystem exceeds the value given
       by -warn, or 90% if that option is not supplied. Popping up the stats window causes this message to go away, until either another  filesys-
       tem exceeds this value, or the usage of the filesystem that filled falls below the warning value and then subsequently exceeds it.

       Press Escape within the top level window to exit.

       The following bindings are in effect if either the -override or -parent options is specified.

       Ctrl-button1 lowers the window (-override only).

       Ctrl-button2 raises and moves the window.

       Ctrl-button3 raises and resizes the window.

       A  SIGUSR1 sent to the loadmeter process will also raise the top level window. This can be used to raise a window that has been obscured by
       a parent that was specified with the -parent option.

OPTIONS

       The following options are available. They may be abbreviated so long as ambiguity is not reached.

       -display dpy
	     Specifies which X server to connect to. If unspecified, the value of the environment variable DISPLAY is used.

       -geometry geometry
	     Sets the initial geometry of the top level window, given in standard XxY+W+H format. The default is 40x100.

       -name name
	     The name of the application to present to the window manager.

       -numfont font
	     Use the specified font for the load average digits on the top level window. The default is 6x10. Rastermans nexus font is highly rec-
	     ommended.

       -labelfont font
	     Use the specified font for the label displayed behind the bar graph. The default is -schumacher-clean-medium-r-*-*-7-*-*-*-*-*-*-*.

       -label label
	     Specify the string to be displayed behind the bar graph. The default is the hostname given by uname(2).

       -popupfont font
	     Use the specified font for the text in the popup menus. The default is -misc-fixed-medium-r-*-*-10-*-*-*-*-*-*-*.

       -popupbg colour
	     Sets the background colour of the popup menus. Default is grey30.

       -popupfg colour
	     Sets the foreground colour of the popup menus. Default is yellow.

       -warn percent
	     Causes  the  menu	entry  for a particular filesystem to be highlighted if the usage for it is greater than the given percentage. The
	     default is 90%.

       -warnbg colour
	     Specify the colour to use for highlighting a filesystem whose usage is greater than or equal to 90% or whichever  is  specified  with
	     the -warn option. The default is seagreen4.

       -meter colour
	     Specify the colour to use for the bar in the graphical representation of filesystem usages. The default is black.

       -override
	     Causes  loadmeter	to set the override_redirect bit on the top level window. This will then cause it to bypass the window manager and
	     display itself undecorated on the root window. This is useful for using it with window managers such as Enlightenment (to DR 0.13	at
	     least) which insist on decorating all top level windows. With this option set, the built in move and resize features are enabled.

       -sync Causes loadmeter to call sync(2) each time it checks the disk usages. This can slow things down on systems with busy filesystems, but
	     is more accurate as the filesystems are properly synced.

       -bh height
	     Specify the height in pixels of each of the bars (blocks) in the main bar graph. The default is two pixels.

       -parent window
	     This option allows you to specify a particular window for loadmeter to use as its parent window. Normally loadmeter will  attempt	to
	     map  itself  onto the root window, however there may be times when you wish to map it as a child of another window on the screen. The
	     author uses this to map several instances of loadmeter onto an xclock window, making it easy to move the bank around by  just  moving
	     the xclock window. It's left as an exercise to the reader to think of other uses for this option.

       -disk Causes a warning message on the top level window to be given when the usage of a filesystem exceeds 90%, or the value given by -warn.
	     The warning goes away when the stats window is popped up, until either another filesystem's usage is excessive or the  usage  of  the
	     filesystem that caused the warning falls below the threshold and then subsequently exceeds it.

       -noshrink
	     Disables  the  slow-popdown  eye candy feature of the stats window. This option is useful for slow network connections to the display
	     and/or when there is a large number of filesystems being monitored.

       -nogeom
	     Disables the displaying of the window geometry in the cursor as the main window is being moved or resized.

       Note that -override and -parent cannot both be given in the same instance.

RESOURCES

       loadmeter reads the X server database for several resources that can be used to specify options for all instances of loadmeter  running	on
       the display. The resources have the same names as each of the command line options, thus there is no point specifying them here again.

       Boolean options (i.e. those that don't take an argument) are enabled by setting the corresponding resource to True.

LICENSE

       loadmeter is covered by the GNU General Public License (GPL).

BUGS

       loadmeter does no checking as to whether a colour was successfully allocated by the X server.

       Memory info in Solaris isn't particularly correct. Patches for this would be appreciated...

SEE ALSO

       xload(1).

AUTHOR

       Ben Buxton <bb@zip.com.au>

4th Berkeley Distribution					 December 18, 2001						      LOADMETER(1)