HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

r
rmsf(1M) rmsf(1M)
-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 device. 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.
-k Remove the definition of the device from the system, but not any special files. This
option cannot be used with -a
.
-q Quiet option. Normally, rmsf displays a message as each driver is removed. This
option suppresses the driver message, but not error messages. See the
-v option.
-v Verbose option. In addition to the normal processing message, display the name of
each special file as it is removed. See the
-q option. Print the names of the files as
rmsf is removing them.
RETURN VALUE
rmsf exits with one of the following values:
0 Successful completion, including warning diagnostics.
1 Failure. An error occurred.
DIAGNOSTICS
Most of the diagnostic messages from
rmsf are self-explanatory. Listed below are some messages deserv-
ing further clarification. Errors cause rmsf to halt immediately. Warnings allow the program to con-
tinue.
Errors
No such device in the system
No device in the system matched the options specified. Use ioscan to list the devices in the system
(see ioscan(1M)).
special_file
is not a special file
The file is not associated with an I/O device.
Warnings
WARNING: The specified hardware path is BUS_NEXUS/INTERFACE type.
This will remove all the devices connected to it.
The H/W type of the node specified by hw_path is BUS_NEXUS/INTERFACE. All the devices under
this path will be removed.
Cannot remove driver at hw_path
The definition of the device located at hw_path and controlled by driver cannot be removed from the
kernel. That is driver does not support the
unbind function.
No device associated with special_file
The special file does not map to a device in the system; the file is removed unless the
-k option was
specified.
EXAMPLES
Remove the special file
mux0 from the current directory:
rmsf ./mux0
Remove the system definition of the device associated with /dev/lp0 along with all special files that
refer to the device:
rmsf -a /dev/lp0
Remove the system definitions for all devices associated with hardware path 52.6.0:
rmsf -k -H 52.6.0
HP-UX 11i Version 2: August 2003 − 2 − Hewlett-Packard Company Section 1M−−687