topmem(8) CLIX topmem(8)
NAME
topmem - Runs CRM utility for monitoring physical and virtual memory
SYNOPSIS
/usr/ip32/crm/topmem [-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 required only 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 specified in 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 topmem in graphics-based format.
DESCRIPTION
The topmem command monitors the amounts of physical and virtual memory
being used by processes on the system.
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 topmem,
click on the color palette icon from the window icon box. A small Color
menu will appear. The foreground color is displayed when the menu first
2/94 - Intergraph Corporation 1
topmem(8) CLIX topmem(8)
appears. Clicking the mouse button moves to the next color. Exit and
save the changes by clicking on the delete icon in the Colors window.
These colors are saved for this monitoring session only.
A brief explanation of the topmem fields follows. A similar list can be
accessed online by entering ? while the monitor is running.
freemem
Displays the average amount of memory that was free (available)
during the last sample interval.
proc_phys
Displays the sum of all Weighted_physical_size values. The
resulting sum indicates the total physical memory used by all
processes.
freeswap
Displays the amount of space available on the swap device.
availsmem
Displays the available physical memory space left on the system.
Physical_size
Displays the total amount of physical memory (valid pages) being
used by the indicated process.
Virtual_size
Displays the size of the virtual address space being used by the
indicated process. This value indicates the amount of swap space
being allocated to processes.
Weighted_physical_size
Displays the sum of valid pages used by a process, modified by the
number of processes that share it. In the case where several
processes can share memory pages, the first executed is allocated
the memory pages needed for it to run. The subsequent processes
are allocated fewer memory pages since they will share some of the
pages allocated for the first process. The Weighted_physical_size
indicates the amount of physical memory actually being used.
For example, if three vterm processes were running, the first
process executed is allocated the memory pages needed to run. The
second and third vterm processes do not require as many memory
pages because they could share some of the pages allocated to the
first vterm process. Therefore, the weighted physical size of each
process varies, depending on the number of pages already allocated
to the first process that the subsequent processes can share.
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
topmem(8) CLIX topmem(8)
EXAMPLES
The following example samples every 60 seconds the physical and virtual
memory used by processes on the system.
/usr/ip32/crm/topmem -I 60
FILES
/dev/kmem Allows topmem access to kernel virtual memory space.
/dev/mem Allows topmem access to kernel physical memory space.
/unix The default CLIX image. The topmem 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.
EXIT VALUES
The exit values are not valid.
RELATED INFORMATION
Commands: crm(1), vterm(1)
2/94 - Intergraph Corporation 3