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

-nameresourcename

Class name to use for resources (Gmemusage)

-displaydisplay

X server to contact ($DISPLAY environment variable)

-geometrygeometry

Initial window geometry (320x400)

-fontfont

Use font font for drawing text (fixed)

-backgroundcolor

Color to use for window background (grey4)

-updateseconds

Update interval (5 seconds)

-threshholdkb

Threshhold below which small processes are merged (400 kb)

-ncolors#colors

How many different colors to use (3)

-color1color

Name of first color (red/maroon)

-color2color

Name of second color (green/OliveDrab)

-color3color

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.

RELATED TO gmemusage…

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

VERSION

Gmemusage version 0.2, 1998/01/14

AUTHOR

Raju Mathur ([email protected]) 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.