NAME

       gmemusage - graphically display memory used by running processes.

SYNOPSIS

       gmemusage [ options ]

DESCRIPTION

       Gmemusage   is  modelled  after  the  program  of  the  same  name  on  Silicon  Graphics'
       workstations.  Gmemusage graphically displays the contents of memory on a running  system,
       broken  up  by individual processes. The display is a stacked bar graph with the height of
       an area representing the RSS size of the corresponding process. In addition,  the  process
       name, number of processes with that name and the size (in kilobytes) are shown.

       Processes which take up less memory than a (user-specifiable) threshhold are merged into a
       single area on the graph. Multiple processes with the same name are merged into  a  single
       area.

       While running, gmemusage accepts the following keys:

       Q or q
            Exit the program.

       Up Arrow
            Increase the minimum threshhold by 10 kb.

       Down Arrow
            Decrease the minimum threshhold by 10 kb.

       Other keys are (not-so-silently!) ignored.

OPTIONS

       Gmemusage accepts the following command-line options (defaults in brackets):

       -name resourcename
            Class name to use for resources (Gmemusage)

       -display display
            X server to contact ($DISPLAY environment variable)

       -geometry geometry
            Initial window geometry (320x400)

       -font font
            Use font font for drawing text (fixed)

       -background color
            Color to use for window background (grey4)

       -update seconds
            Update interval (5 seconds)

       -threshhold kb
            Threshhold below which small processes are merged (400 kb)

       -ncolors #colors
            How many different colors to use (3)

       -color1 color
            Name of first color (red/maroon)

       -color2 color
            Name of second color (green/OliveDrab)

       -color3 color
            Name of third color (blue/SlateBlue)

       -color[4-9] color
            Names of remaining colors (undefined)

       -help
            Print a short help message.

RESOURCES

       Gmemusage  understands  the  following X resources. See the OPTIONS section for details of
       what they do.

              name (class Name)
              display (class Display)
              geometry (class Geometry)
              font (class Font)
              background (class Background)
              update (class Interval)
              threshhold (class Threshhold)
              ncolors (class NColors)
              color1 (class Color)
              color2 (class Color)
              color3 (class Color)
              color[4-9] (class Color)

BUGS

       See the TODO file which comes with the distribution.

SEE ALSO

       top(1), ps(1), xosview(1).

VERSION

       Gmemusage version 0.2, 1998/01/14

AUTHOR

       Raju Mathur (raju@sgi.com) aka OldMonk.

SITE

       The canonical site for gmemusage is:

              http://reality.sgi.com/raju/software

COPYRIGHT

       Gmemusage is copyright (C) 1997, 1998 by Raju Mathur. See the file COPYING in  the  source
       directory for copyright information.