topcpu(8) CLIX topcpu(8)
NAME
topcpu - Runs CRM utility for monitoring CPU time
SYNOPSIS
/usr/ip32/crm/topcpu [-U boot_image] [-I interval] [-S snap_file] [-i
input_file] [-o output_file] [-w]
FLAGS
-U boot_image Lists the file specification of the CLIX image which was
booted. This flag is only required if the boot image has
been moved since the system was booted. (The default boot
image used is set on the Operating System Parameters menu
of the workstation Utility Pages; usually, the image is
the /unix file. However, if the user moves the boot image
to a different directory, the -U flag must be used to tell
the CRM utilities where to find the boot image.)
-I interval Specifies how frequently the monitor samples and displays
information. The interval is the number of seconds. The
default interval is 2 seconds.
-S snap_file Specifies a name for the snapshot file. (The default
filename is /tmp/CRM.snapshot.)
-i input_file Reads the data from input_file every interval seconds.
The input_file must have been created as an output_file
using the -o flag. A hyphen (-) for input_file reads
input from stdin.
-o output_file Directs output to output_file. A hyphen (-) for
output_file directs output to stdout.
-w Runs topcpu in graphics-based format.
DESCRIPTION
The topcpu command monitors the amount of CPU time being used in each of
the following modes: user, kernel, wait I/O, swap I/O, phys I/O (physical
I/O), and sxbrk (time spent allocating memory for a new job).
In graphics format, to expand the list of processes being monitored,
stretch the length of the window with the standard modify icon. To
receive a description of each category represented in the monitor bar
graphs, click on the question mark (?) icon from the window icon box. A
help window will appear.
In graphics format, to change the colors of the bar graphs in topcpu,
click on the color palette icon from the window icon box. A small Colors
2/94 - Intergraph Corporation 1
topcpu(8) CLIX topcpu(8)
menu will appear in its own window. The foreground color is displayed
when the menu first appears. Clicking the mouse button moves to the next
color. Exit and save the changes by clicking on the delete icon of the
window containing the Colors menu. These colors are saved for this
monitoring session only.
A brief explanation of the topcpu fields follows. A similar list may be
accessed online by entering ? while the monitor is running.
%Used Displays the amount of overall CPU time being used by a process.
%User/System used
Displays a type of bar graph composed of U (user) and S (system) to
illustrate visually how much CPU time used by a process is being
taken up by the user (the process itself) or by the system. Each U
or S represents about two percent.
To take a snapshot of the statistics, type S (press <Shift> <S> ). The
statistics shown at that instant are saved to the file /tmp/CRM.snapshot,
or to the file specified with the -S flag.
EXAMPLES
The following example samples the CPU time being used every five seconds.
/usr/ip32/crm/topcpu -I 5
FILES
/dev/kmem Allows topcpu access to kernel virtual memory space.
/dev/mem Allows topcpu access to kernel physical memory space.
/unix The default CLIX image. The topcpu command looks up offsets
into the kernel using symbols from boot_image.
/tmp/CRM.snapshot
The default filename of a snapshot.
NOTES
Read permission is required to access some files used by this command. If
the user is denied permission to access the required files, the superuser
privileges are required to run this command.
CAUTIONS
Sending raw data to a file can create a very large file, which can result
in unexpected ``disk full'' messages.
2 Intergraph Corporation - 2/94
topcpu(8) CLIX topcpu(8)
DIAGNOSTICS
The diagnostic messages are designed to be self-explanatory.
EXIT VALUES
The exit values are not valid.
RELATED INFORMATION
Commands: crm(1)
2/94 - Intergraph Corporation 3