diff --git a/ttyload.1 b/ttyload.1 new file mode 100644 index 0000000..d04032d --- /dev/null +++ b/ttyload.1 @@ -0,0 +1,102 @@ +.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 \fP" +Sets the number of columns wide to make the display +.IP "\fB-r \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 \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