MONITOR(1)MONITOR(1)NAMEmonitor - display system activity
SYNOPSISmonitor [ collection ] [ display ] [ data ] [ options ]
DESCRIPTION
Monitor is a program for collecting data on system activity. Depending
on the options chosen this data can be displayed or saved in a file for
later review. Monitor allows the user to select the data collection
mode, display mode and the data to be collected.
Live, replay and names are the currently supported collection modes.
In live mode the data is collected from the running system. In replay
mode the data is read from a file created by an earlier run of monitor.
Names is a special collection mode that prints what it can about the
system configuration. The other options, data options and display
modes have no effect on this option.
The currently supported display modes are save, read, and screen. In
save mode the data is collected and written to a file. The format of
this file is documented in the monitor(5) manual page. In screen mode
the data is formatted according to the data options and displayed on
the user's terminal using curses(3). The display mode read dumps in
textual form the contents of collected records.
Data Options
The currently supported data options are listed below. All the options
may be abbreviated to the shortest unique string. When monitor sees an
ambigious argument it provides a list of the matching options in the
error message.
cache Buffer and namei cache statistics.
cpu Time in CPU states, context switches, etc.
tty TTY input and output counts.
disk Disk I/O data.
free Free memory measured in Kilobytes.
fork Fork and vfork counts.
page Paging information.
swap Swap space utilization.
users Number of users logged on.
netif Network interface data.
memory Memory utilization.
loadave The load average.
Some data options cause groups of previous data options to be col‐
lected.
io Disk, Network interfaces and tty data.
os CPU, fork, paging and memory statistics.
mon Everything.
all Everything.
Some data options allow further selection on a unit basis. These are
cpu, disk and netif. The format of these options is:
data-option=unit[,unit]
Examples:
netif=de0,dmc0
disk=ra0,ra2,hp0
Screen Commands
When monitor runs in screen mode a number of commands can be used to
control the display.
^L Redraw the screen.
r Redraw the screen.
q Quit, same as Exit.
e Exit, same as Quit.
p Pause the session.
h Help.
? Help.
d Dump a copy of the screen to screen.dump. If the -output option
is used the filename given will be used.
m Magnify a data record.
u Unmagnify - return to the normal display.
OPTIONS-help Print a help listing.
-magnify data-option
The magnify function for the selected data option is used
instead of the normal screen function.
-file file
In save mode, save the output in file.
-output file
File to be used for screen dumps.
-prompt prompt
Set the screen mode prompt to prompt.
-sleep #
Sleep for # seconds between samples.
-total When disk is a selected data option in screen mode, print the
I/O totals.
-version
Print the version string and exit.
-sample
The first and sample data records are enabled for magnification.
DEFAULTS
───────────────────────────────────────────────────────────────────
Option Default
───────────────────────────────────────────────────────────────────
display screen
collection live
data all
prompt monitor>
file monitor.dat
output screen.dump
sleep 10 minutes in save, dependent on tty speed in screen.
───────────────────────────────────────────────────────────────────
────────────────────────
Baud rate Update time
────────────────────────
> 9600 2 seconds
4800 3 seconds
2400 3 seconds
1200 5 seconds
300 8 seconds
────────────────────────
FILES
/dev/kmem, /vmunix, screen.dump, monitor.dat
/vmunix is used to obtain the name list of the running kernel.
/dev/kmem is used to collect the system performance data.
DIAGNOSTICS
Please see chapter 5 of the Long Awaited Monitor User's Guide.
SEE ALSO
The sections starting with ``Interpreting system activity'' in
Installing and Operating 4.2bsd. The version of the configuration and
tuning guide for the particular version of the operating system. The
title varies somewhat by release.
RESTRICTIONS
The current version of monitor was not designed to run as a setuid pro‐
gram. It needs read access to /dev/kmem and can be run setgid for
group kmem, as long as no interesting files are given write access by
group kmem.
BUGS
The names support in V5 uses the V4 style device names and may generate
the wrong name for Wide16 SCSI devices taking full advantage of the
feature. Data for the cache option collected on V4 earlier may display
inaccurately on V5. The same is true of cache data collected on V5 and
displayed on V4.
MONITOR(1)