HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
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 continue.
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
WARNINGS
Most commands and subsystems assume their device files are in /dev, therefore the use of the
-D option
is discouraged.
HP-UX Release 11i: December 2000 − 2 − Section 1M−−725
___
___