NAME

spritemon − X widget to display system events

SYNOPSIS

spritemon -[uRafvpPiorw] [−N num] [-disks] [−D num] [−T interval] [−A availInterval] [−%M] [−H height]

OPTIONS

−T interval
Sets the interval at which the display is updated.  Default is 5 seconds.

−H height
Sets the height of each graph displayed.  Default is 40 pixels.

−uDisplay CPU utilization on a scale from 0.0 to 1.0. 

−N num CPUs
Do CPU utilization for more than one CPU.

−RDisplay the number of remote processes belonging to this host (in 10’s). 

−aDisplay the number of hosts to which this host can migrate (in 10’s). 

−A availInterval
Sets the interval at which the count of available hosts is updated. Default is 15 seconds.

−fDisplay file system cache size. 

−vDisplay amount of physical memory devoted to user virtual memory. 

−%Display cache size (−f) or VM size (−v) as a percentage of main memory. 

−MDisplay cache size (−f) or VM size (−v) in megabytes. 

−pDisplay the number of page-ins (in 100’s).  This is a sum of text, heap, and stack page-ins. 

−PDisplay the number of pages written out to swap files (in 100’s). 

−iDisplay the number of ethernet packets received (in 100’s). 

−oDisplay the number of ethernet packets sent out (in 100’s). 

−disks
Display disk statistics for all disks in the system (superceeds -D).

−D num
Display disk #num utilization on a scale from 0.0 to 1.0. 

−rDisplay the number of disk read transfers (in 100’s).  Use with −D or -disks. 

−wDisplay the number of disk write transfers (in 100’s).  Use with −D or -disks. 

INTRODUCTION

This widget displays operating system parameters as a running graph.  It is an X toolkit widget and so it needs to run under the X window system.  This is a “load widget”, which displays a value every interval seconds, and has a title but no vertical scale.  Instead, horizontal lines are drawn to represent increments in the native unit of whatever is being displayed.  For some parameters, like percentage of memory devoted to the file system cache, the displayed value is always between 0 and 1 so there are no horizontal scale lines.  For the megabytes of filesystem cache there will be horizontal lines that represent megabytes, for remote processes there will be horizontal lines to represent 10’s of remote processes, and for paging and network traffic there will be horizontal lines to represent 100’s of events.  The value displayed is truncated to the largest value that can be displayed without causing the horizontal lines to completely occupy the display.  This value is equal to half the pane height. 

Several system parameters can be viewed at once; the load meters are organized into a vertical pane with each meter of equal height.  It is best to let spritemon determine its own geometry at startup (it will use the default pane height times the number of parameters being displayed), or you can specify a geometry argument on the command line and spritemon will evenly divide the window into panes.  Otherwise, if you drag out a window size, the VPane widget does a poor job of picking the heights of individual panes. 

The disk related options only work on machines with disks.  The −D option specifies which disk to display information about, or -disks can be used to display information about all the disks in the system.  Utilization is displayed, and −r and −w are used to display raw read and write counts.  The number to specify to −D corresponds to a kernel table entry that is indexed starting at zero. 

BUGS

The −i option needs to be glommed together with another option, i.e. −io, or it gets interpreted by the X toolkit and spritemon starts out iconic. 

The value of the argument to −D is un-intuitive. 

The disk information should display the file system name, but kernel support is needed for this. 

SEE ALSO

vmStat, migcmd

KEYWORDS

system, page faults, file system cache, virtual memory, network interface, migration

Sprite version 1.0  —  October 17, 1989