.\" gmemusage.1		0.2 990114; Copyright (C) 1997, 1998 - Raju Mathur
.TH gmemusage 1 "14 January 1998" "Silicon Graphics"
.SH NAME
gmemusage \- graphically display memory used by running processes.
.SH SYNOPSIS
.B gmemusage
[
.BI options
]
.SH DESCRIPTION
.B Gmemusage
is modelled after the program of the same name on Silicon Graphics'
workstations.
.B 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.
.sp
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.
.sp
While running,
.B gmemusage
accepts the following keys:
.TP 5
Q or q
Exit the program.
.TP 5
Up Arrow
Increase the minimum threshhold by 10 kb.
.TP 5
Down Arrow
Decrease the minimum threshhold by 10 kb.
.TP 0
Other keys are (not-so-silently!) ignored.
.SH OPTIONS
.B Gmemusage
accepts the following command-line options (defaults in brackets):
.TP 5
.BI \-name \ resourcename
Class name to use for resources (Gmemusage)
.TP 5
.BI \-display \ display
X server to contact ($DISPLAY environment variable)
.TP 5
.BI \-geometry \ geometry
Initial window geometry (320x400)
.TP 5
.BI \-font \ font
Use font
.I font
for drawing text (fixed)
.TP 5
.BI \-background \ color
Color to use for window background (grey4)
.TP 5
.BI \-update \ seconds
Update interval (5 seconds)
.TP 5
.BI \-threshhold \ kb
Threshhold below which small processes are merged (400 kb)
.TP 5
.BI \-ncolors \ #colors
How many different colors to use (3)
.TP 5
.BI \-color1 \ color
Name of first color (red/maroon)
.TP 5
.BI \-color2 \ color
Name of second color (green/OliveDrab)
.TP 5
.BI \-color3 \ color
Name of third color (blue/SlateBlue)
.TP 5
.BI \-color[4-9] \ color
Names of remaining colors (undefined)
.TP 5
.BI \-help
Print a short help message.
.SH RESOURCES
.B Gmemusage
understands the following X resources. See the OPTIONS section for
details of what they do.
.sp
.RS
.B "name (\fPclass \fBName)"
.RE
.RS
.B "display (\fPclass \fBDisplay)"
.RE
.RS
.B "geometry (\fPclass \fBGeometry)"
.RE
.RS
.B "font (\fPclass \fBFont)"
.RE
.RS
.B "background (\fPclass \fBBackground)"
.RE
.RS
.B "update (\fPclass \fBInterval)"
.RE
.RS
.B "threshhold (\fPclass \fBThreshhold)"
.RE
.RS
.B "ncolors (\fPclass \fBNColors)"
.RE
.RS
.B "color1 (\fPclass \fBColor)"
.RE
.RS
.B "color2 (\fPclass \fBColor)"
.RE
.RS
.B "color3 (\fPclass \fBColor)"
.RE
.RS
.B "color[4-9] (\fPclass \fBColor)"
.RE
.SH BUGS
See the TODO file which comes with the distribution.
.SH SEE ALSO
top(1), ps(1), xosview(1).
.SH VERSION
.B Gmemusage
version 0.2, 1998/01/14
.SH AUTHOR
Raju Mathur (raju@sgi.com) aka OldMonk.
.SH SITE
The canonical site for
.B gmemusage
is:
.sp
.RS
.B http://reality.sgi.com/raju/software
.RE
.SH COPYRIGHT
.B Gmemusage
is copyright (C) 1997, 1998 by Raju Mathur. See the file COPYING in
the source directory for copyright information.