Man Linux: Main Page and Category List

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
       System.  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  filesystem
       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 recommended.

       -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>