.TH "ttyload" "1" "2001-08-24" "" "" 
.SH "NAME" 
ttyload \- a tty-based xload equivalent
.SH "SYNOPSIS" 
.PP 
ttyload [options]
.PP 
.SH "DESCRIPTION" 
.PP 
ttyload is a "tty" based load monitoring tool\&.  Not entirely unlike
xload, it plots a graph of a system's "load average" data\&.  Unlike
xload, it uses 3 line graphs to plot things, instead of a single fill
graph, so that it can show you not only the 1-minute load average, but
also the 5-minute and 15-minute averages\&.  Also unlike xload, it uses
a basic terminal (tty) to display the information, instead of an X
window\&.  ANSI escape sequences are used (optionally) for colorization
and screen manipulation\&.
.PP 
A few of the main features of ttyload are:
.PP 
.IP o 
graphs load averages (all 3 numbers) over time
.IP o 
uses ANSI escape sequences to colorize graphs
.IP o
works without requiring X11 libraries, in a Terminal window
.IP o
automatically determines screen size by default
.PP 
\" .SH "GENERAL" 
\" .PP 
\" See DESCRIPTION\&.
\" .PP 
.SH "USAGE" 
.PP 
The easiest way to use ttyload is just to invoke the command, with no
additional options\&.
.PP 
Additional options are described below\&.
.PP
To quit ttyload, enter the terminal's interrupt character (typically
control-C)\&.
.PP 
\" .SH "EXAMPLES" 
\" .PP 
\" Here are some examples of how I use ttyload\&.
\" .PP 
\" No examples written\&.
\" .RE
.PP 
.SH "OPTIONS" 
.PP 
ttyload uses standard getopt() style options processing\&.
Available options are:
.PP 

.DS 

.PP
.IP "\fB-h\fP" 
Display a brief usage statement ("help")\&.
.IP "\fB-v\fP" 
show version info, then exit
.IP "\fB-m\fP" 
monochrome mode (no ANSI escapes)
.IP "\fB-c <cols>\fP" 
Sets the number of columns wide to make the display
.IP "\fB-r <rows>\fP" 
Sets the number of rows high to make the display
(these two options combine to override the default behavior of
auto-determining screen size)
.IP "\fB-i <seconds>\fP" 
Alter the number of seconds in the interval between
refreshes\&.  The default is 4, and the minimum is 1, which is silently
clamped\&.  
.DE 
 

.PP 
.PP 
.SH "SEE ALSO" 
.PP 
getopt(3)
.PP 
.PP 
.SH "VERSION" 
This man page is current for version 0\&.5 of ttyload
.PP 
.SH "THANKS" 
.PP 
Thanks to several my friends for testing things out on various
platforms, or lending me accounts on their machines upon which
to do porting\&.
.PP 
.SH "AUTHOR" 
.PP 
ttyload was written by David Lindes\&.  Please send any feedback,
including bug reports and patches, to me\&.  My contact information (as
well as updates and other information) can be found on the ttyload web
page at:
http://www\&.daveltd\&.com/src/util/ttyload/
.PP