monproc(1) CLIX monproc(1)
NAME
monproc - Runs the CRM utility for monitoring a process
SYNOPSIS
/usr/ip32/crm/monproc [-U boot_image] [-w] [-I interval] [-S snap_file]
[-o output_file] input_option
FLAGS
-U boot_image Provides 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 with the Operating System
Parameters item 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.)
-o output_file Directs output to output_file. A hyphen (-) for
output_file directs output to stdout.
-I interval Specifies how frequently the monitor samples and displays
information.
-S snap_file Specifies a name for the snapshot file. (The default
filename is /tmp/CRM.snapshot.)
-w Executes monproc in graphics-based format.
The following input_options are available:
-i input_file
Reads the data from input_file each interval. The input_file must
have been created as an output_file using the -o flag. A hyphen
(-) for input_file reads input from stdin.
-p pid Specifies the ID number of the process to monitor (PID). The user
can key in ps -e at the system prompt to determine the PID of a
process already running.
-n process_name
Specifies the name of the process to monitor. The user may enter
ps -e at the system prompt to determine the name of a process
already running.
-e command [arg ... ]
Allows the user to run, provide arguments for, and monitor a
program.
2/94 - Intergraph Corporation 1
monproc(1) CLIX monproc(1)
DESCRIPTION
The monproc command monitors CPU use, status, priority, hard and soft
fault rates, and current PC (program counter) for a process.
A brief explanation of the monproc fields follows.
CPU user time
CPU system time
Displays the amount of CPU time used by the process in user and
system mode since the beginning of the monitoring session.
Status Displays the process state (such as SLEEP or STOP) when the monitor
examines it.
Priority
Displays the priority assigned by the system to the process being
monitored.
Username
Displays the username that is running the process being monitored.
Hard fault rate
Soft fault rate
Displays the number of hard and soft faults that occurred per
second during the sample interval.
Physical Memory
Virtual Memory
Displays the amount of physical and virtual memory the system
assigns to the process being monitored.
Elapsed time
Displays how long the process has been running.
PC Displays the address where the program counter was located the last
time the monitor polled it. If the program was compiled to include
debugger symbols (such as to be used by Intergraph's dbg), the
monitor can read those symbols and provide more logical values in
this field. For instance, the PC might display a more logical
address such as sub1 + 10, where sub1 is the name of a procedure in
the program and 10 is the number of bytes offset into sub1.
Notice the two separate color bar graphs when the graphics-based process
monitor executes. The first bar shows activity for the last sample
period; the second bar shows average activity for the last 10 sample
periods.
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.
2 Intergraph Corporation - 2/94
monproc(1) CLIX monproc(1)
EXAMPLES
The following is an example of a monproc session:
Process is xns_listen Thu May 25 11:14:53 1990
CPU user time 00 00:00:00.41 CPU system time 00 00:00:06.31
Status: STOP Priority: 14 Username: root
Hard fault rate 00/sec Soft fault rate 00/sec
Physical Memory 196 k Virtual Memory 532 k
Elapsed time: 00 00:52:16:00
PC: 0000efe6 /current
PC: 0000efe6 /last
FILES
/dev/kmem Allows monproc access to kernel virtual memory space.
/dev/mem Allows monproc access to kernel physical memory space.
/proc/????? The proc file system entry for the target process, where
????? is the five-digit process ID.
/unix The default CLIX image. The monproc command looks up offsets
into the kernel using symbols from the boot_image.
/tmp/CRM.snapshot
The default filename of a snapshot.
NOTES
Superuser privileges are required to run this monitor on processes other
than those owned by the user.
CAUTIONS
Sending raw data to a file can create a very large file, which may result
in unexplained ``disk full'' messages.
EXIT VALUES
The exit values are not valid.
RELATED INFORMATION
Commands: crm(1), ps(1)
2/94 - Intergraph Corporation 3