lssf.1m (2010 09)

l
lssf(1M) lssf(1M)
NAME
lssf - list a special file
SYNOPSIS
/sbin/lssf special_file ...
/sbin/lssf -s
/sbin/lssf -c special_file
DESCRIPTION
In the first form,
lssf lists information about a special file. For each special_file name,
lssf deter-
mines the major number of the special file and whether it is block or character (using
stat()). It then
scans the system for the device that is associated with the special file. When the device is found, the
minor number of the special file is decoded.
A mnemonic description of the minor number is printed on standard output along with the hardware path
(in other words, address) of the device. Mnemonics used to describe the fields are closely related to the
options used with
mksf (see mksf(1M)).
In the second form,
lssf displays the list of stale device special files present in selected directories under
the /dev directory.
In the third form,
lssf executes a Critical Resource Analysis (CRA) on the special_file.
Options
lssf recognizes the following options:
-c Displays the Critical Resource Analysis (CRA) of special_file.
-s Displays the stale device special files present in the directories below, which contain special
files for mass storage devices. The stale device special files correspond to nodes that have an
entry in the system I/O configuration files but the corresponding device is not found. The dev-
ice special files can either be legacy or persistent (see intro (7)).
/dev/dsk /dev/rdsk /dev/ct /dev/rmt
/dev/floppy /dev/rfloppy /dev/rscsi /dev/pt
/dev/disk /dev/rdisk /dev/rtape
DIAGNOSTICS
Most diagnostic messages from lssf are self explanatory. Listed below are some messages deserving
further clarification. Warnings allow lssf to continue.
Warnings
No such device in the system
There is no information about the device in the kernel. The special file is not usable. Use
rmsf to remove the special file (see rmsf (1M)).
Character major major is not in the kernel
Block major major is not in the kernel
The major number associated with the special file is not in the kernel. Use kcmodule to add
the appropriate driver to the kernel (see kcmodule (1M)).
Device driver name is not in the kernel
Device class name is not in the kernel
The indicated device driver or device class is not present in the kernel. An open() of a spe-
cial file pointing to an unusable device fails. To make the device usable, the appropriate device
driver and/or device class must be added to the kernel using kcmodule. If the device is no
longer needed, rmsf should be used to remove the special files and update the system I/O
configuration files.
special_file
is not a special file
The file is not associated with an IO device.
EXAMPLES
Suppose a special file is created with the command
mksf -d tape2 -H 8.6.1 -b 160 -a
rmt/c2t6d0m. The command lssf rmt/c2t6d0m then produces:
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1