showfiles(8) CLIX showfiles(8)
NAME
showfiles - Runs CRM utility for monitoring open files
SYNOPSIS
/usr/ip32/crm/showfiles [-U boot_image] [-cdf] [input_flag] [-o
output_file]
FLAGS
-U boot_image Specifies 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.)
-c Specifies that showfiles should run continuously.
-d Translates major and minor device numbers to device names.
-f Spawns the ncheck command to translate inode numbers to
filenames. Also translates device numbers to device names
as with the -d flag.
-o output_file Directs output to output_file. A hyphen (-) for
output_file directs output to stdout.
The following input_flags may be used:
-p pid Specifies the ID number of the process to monitor (PID). The user
may enter 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.
-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.
DESCRIPTION
The showfiles command displays a list of all processes on the system. It
also lists open files for each process. With the -d flag, device names
2/94 - Intergraph Corporation 1
showfiles(8) CLIX showfiles(8)
and inode numbers are provided for each open file. Users needing a list
of filenames can use the -f flag, but this is a time-consuming process.
An alternate method for transferring mode numbers to pathnames is the find
command using the -inum flag.
Once an open file's inode number is determined, the ncheck command can be
used to generate the pathnames from the inode numbers.
EXAMPLES
The following example translates major and minor device numbers to device
names, monitors the process called clean.
/usr/ip32/crm/showfiles -d -n clean
FILES
/dev/kmem Allows showfiles access to kernel virtual memory space.
/dev/mem Allows showfiles access to kernel physical memory space.
/proc/????? The proc file system entries for all of the processes, where
????? are the five-digit process IDs.
/unix The default CLIX image. The showfiles command looks up
offsets into the kernel using symbols from boot_image.
/dev/* The device files.
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 create
unexplained ``disk full'' messages.
Device name translation takes more time.
Filename lookup by the ncheck command takes much more time, since each
file system must be searched for the inode numbers.
DIAGNOSTICS
The diagnostic messages are designed to be self-explanatory.
EXIT VALUES
2 Intergraph Corporation - 2/94
showfiles(8) CLIX showfiles(8)
The exit values are not valid.
RELATED INFORMATION
Commands: crm(1), ncheck(8), find(1), ps(1), auditd(8)
2/94 - Intergraph Corporation 3