showxt(8) CLIX showxt(8)
NAME
showxt - Runs CRM utility for monitoring XT device activity
SYNOPSIS
/usr/ip32/crm/showxt [-U boot_image] [-c] [-I interval] [-S snap_file] [-o
output_file]
/usr/ip32/crm/showxt [-U boot_image] [-i input_file] [-o output_file]
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 in the /unix directory. 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.)
-c (Continuous operation.) Generates a curses-based display
and scans and displays the XT device list at each
interval. Without this flag, the XT device list is
displayed once, with minimum formatting of the data.
-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 instead of from the
running system. 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.
DESCRIPTION
The showxt command displays information about XT devices. These devices
are used by network connections made by the visit(1) and vterm(1)
commands. Therefore, showxt will not have anything to show unless there
are network connections coming in from other machines.
In the basic mode, each XT device in use is shown with the process ID of
2/94 - Intergraph Corporation 1
showxt(8) CLIX showxt(8)
the attached process, the username of the owner of the process (or
``<getty>'' if there is no user logged in on the device), the number of
reads and writes made to the device, and some device flags.
In continuous mode (-c) each XT device in use is shown with the username
of the user who is logged in on the device (or ``<getty>'' if there is no
user logged in), the network address or nodename of the machine from which
the connection was established or the nodename of that machine, the number
of reads and writes made to the device, and the number of reads and writes
(together) which were made during the last interval.
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
1. In this example, the following command starts a session of showxt in
the basic mode:
/usr/ip32/crm/showxt
This is sample output from the session:
0: pid:14808 markv, reads:70 writes:98, cflag:00bd flag:0003
1: pid:16844 <getty>, reads:1571 writes:4550, cflag:0cbd flag:0001
2: pid:23914 <getty>, reads:3571 writes:16418, cflag:0cbd flag:0001
3: pid:28306 <getty>, reads:27 writes:84, cflag:0cbd flag:0001
4: pid:23654 mike, reads:48 writes:163, cflag:08bd flag:0001
5: pid:5686 dsys, reads:282 writes:1348, cflag:08bd flag:0001
6: pid:22481 tsai, reads:287 writes:4022, cflag:08bd flag:0001
7: pid:12117 dsys, reads:107 writes:142, cflag:08bd flag:0001
8: pid:23709 dsys, reads:27 writes:58, cflag:08bd flag:0001
9: pid:4547 wsapp, reads:59 writes:299, cflag:08bd flag:0001
2. In this example, the following command is entered to begin a showxt
session in the continuous mode:
/usr/ip32/crm/showxt -c
This is sample output from the session:
interval=2 Wed Sep 25 14:10:11 1991
XT LOGIN_NAME NETWORK_ADDRESS READS WRITES CHANGE
0: markv markv 70 98 0
1: <getty> strap 1571 4550 0
2: thompson cjt 2870 13080 0
3: <getty> holt 27 84 0
4: mathis 000134e2.08-00-36-fc-dd-00 468 2496 0
5: dsys fuzzbro 282 1348 0
2 Intergraph Corporation - 2/94
showxt(8) CLIX showxt(8)
6: tsai gja 250 3091 0
7: dsys cs200 107 142 0
8: turner renrut 22 146 41
9: wsapp spc1 59 299 0
FILES
The showxt command needs read access to the following files:
/dev/kmem
Allows showxt access to kernel virtual memory space.
/dev/mem
Allows showxt access to kernel physical memory space.
/proc/*
The proc file system entry for all of the processes.
/unix The default CLIX image. The showxt command looks up offsets into
the kernel using symbols from boot_image.
/etc/passwd
Provides usernames.
/usr/lib/nodes/local/xns_atn_table
Provides information for translating network addresses to
nodenames.
/tmp/CRM.snapshot
The default filename of a snapshot.
NOTES
Due to the potentially large amount of data which showxt must process to
generate the display, initialization can take a long time. To reduce the
startup time in continuous mode, only a few of the clearinghouse lookups
of the Ethernet addresses are made at a time.
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 unexplained ``disk full'' messages.
EXIT VALUES
The exit values are not valid.
2/94 - Intergraph Corporation 3
showxt(8) CLIX showxt(8)
RELATED INFORMATION
Commands: crm(1), visit(1), vterm
4 Intergraph Corporation - 2/94