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

r
rmsf(1M) rmsf(1M)
The -x option removes stale device special files and the stale IO nodes from the system. Stale device spe-
cial files can be displayed using the
lssf command with -s option (see lssf(1M)).
Note that most drivers do not support the ability to be removed from the system.
If the device being removed from the system uses a dynamically assigned major number, that number will
be freed up for future allocation.
Options
rmsf recognizes the following options:
-a Remove the definition of the device from the system along with all special files that
refer to the device. This option cannot be used with
-k.
-C class Match devices that belong to a given device class, class. Device classes can be listed
with the
lsdev command (see lsdev(1M)). They are defined in files in the directory
/usr/conf/master.d
. This option cannot be used with
-d.
-d driver Match devices that are controlled by the specified device driver, driver.Device
drivers can be listed with the
lsdev
command (see lsdev(1M)). They are defined in
files in the directory
/usr/conf/master.d
. This option cannot be used with -C.
-D directory Override the default device installation directory /dev and remove the special files
from directory instead. directory must exist; otherwise, rmsf displays an error mes-
sage and exits. See WARNINGS.
-H hw_path Match devices at a given hardware path, hw-path. Hardware paths can be listed with
the ioscan command (see ioscan(1M)).
A hardware path specifies the addresses of the hardware components leading to a dev-
ice. It consists of a string of numbers separated by periods (.), such as 52
(a card),
52.3 (a target address), and 52.3.0 (a device).
If a hardware component is a bus converter, the following period, if any, is replaced by
a slash (/)asin2, 2/3, and 2/3.0. In the agile view (see intro(7)), the devices will
have new hardware path formats, which can be displayed with the
ioscan -N com-
mand (see ioscan(1M)).
See WARNINGS section for more about using this option for critical resources.
-k Remove the definition of the device from the system, but not any special files. This
option cannot be used with -a.
-L Disable legacy naming model. This command removes all legacy I/O nodes and their
device special files. Therefore, before running this command, all applications should
have been migrated to use the agile naming model.
The iofind command (see iofind(1M)) can be used to find all the ASCII files on the
system containing legacy device file names or hardware paths.
The rmsf -L command will not complete successfully if any legacy I/O nodes are in
the open state. If this is the case, the command will fail and it will return information
about the processes that opened the legacy I/O nodes, such as process name, PID, and
device special file.
Note: If the legacy naming model needs to be re-enabled, run insf -L (see
insf(1M)). To check the current status of the legacy naming model, run insf -L
-v
.
WARNING: Before running this command, check the latest release notes of HP-UX
11i Version 3 on http://docs.hp.com for information on limitations that exist when
legacy mode is disabled and how this may impact your system. This command will
not validate the presence or utilization of products with these limitations. Also note
that this option cannot be used in single user mode.
-q Quiet option. Normally rmsf displays a message as each driver is removed. This
option suppresses the driver message, but not error messages.
-u Unbind the driver associated with the given hardware path. The hardware path must
be a LUN hardware path. This option must be used with the -H option.
HP-UX 11i Version 3: February 2007 − 2 − Hewlett-Packard Company 265