HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

r
rmsf(1M) rmsf(1M)
NAME
rmsf - remove a special (device) file
SYNOPSIS
/sbin/rmsf [-a-k][
-D directory][-q-v] special_file ...
/sbin/rmsf [-C class  -d
driver][-D directory] -H hw_path [-k][-q
-v]
/sbin/rmsf -L
/sbin/rmsf -u -H
hw_path
/sbin/rmsf -x
DESCRIPTION
The rmsf command removes one or more special files from the
/dev directory and potentially removes
information about the associated device or devices with H/W type
DEVICE, TGT_PATH or a LUN_PATH,
(see ioscan(1M)) from the system.
If no options are specified,
rmsf
removes only the special_file specified on the command line. The -k
option causes rmsf to remove the definition of the device from the system without removing any special
files. The -a option causes rmsf to remove the device definition and all special files that map to it from
the /dev directory (or the directory specified with the -D option). When special_file is a persistent
device special file type, the device corresponding to
special_file should not be in an open state in
order for the command to complete successfully.
Without the
-D option, if special_file is specified with a relative path, the path is treated relative to
the default device directory /dev.Ifspecial_file is specified with an absolute path and the
-D
option is also used, the special_file with absolute path will have precedence over the -D option.
Note that if special_file belongs to a node for which H/W type is not
DEVICE
, the device definition will not
be removed from the system and the special_file will be removed if it is a leaf node.
If a
-H hw_path is specified, special files are removed as follows:
• If hw_path belongs to a node with H/W type DEVICE, all special files mapping to devices at that
hardware path and the system definition of those devices are removed. If the hw_path belongs to
LUN hardware path of a node of type
DEVICE, the device should not be in an open state for the
command to complete successfully.
• If hw_path belongs to a node with H/W type LUN_PATH, all legacy special files mapping to devices
at that hardware path, as well as the system definition of those devices, are removed.
• If hw_path belongs to a node for which H/W type is TGT_PATH, no special files are removed; only
corresponding node is removed.
• If hw_path belongs to a node for which H/W type is not DEVICE, then, a special file is removed as
follows:
• If it is a leaf node, only special files for that node will be removed.
• If the node has children, then a warning message will be issued and system definition of all the
children devices and their special files are removed.
The -C and -d options remove only those special files that are associated with the given device driver or
that belong to the given device class, respectively. This is useful when there is more than one type of spe-
cial file mapped to a single hardware path. These options are not supported with the class or device drivers
which do not have a hardware module on the system; for example, the pseudo class.
If the -k option is specified, the definition of all devices at that hardware path are removed from the sys-
tem, again without removing any special files.
The -v (verbose) option displays the name of each special file as it is deleted. The -q (quiet) option
suppresses the deletion message.
With the -L option, rmsf disables the legacy naming model, removing all legacy I/O nodes and their dev-
ice special files from the system.
If the -u and -H options are specified, rmsf performs an unbind on the driver associated with the given
hw_path. The hw_path must be a LUN hardware path (see intro(7)).
264 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007