rmsf.1m (2011 09)

r
rmsf(1M) rmsf(1M)
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 com-
mand will not validate the presence or utilization of products with these limitations.
Also note that this option cannot be used in single user mode.
-m Remove the dynamically assigned major number of the device. This option must be
used with the
-a or -k
or -H option.
-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.
-v Verbose option. Prints the name of the special file as it is removed by
rmsf. May
be used as a progress indicator.
-x Remove all the stale IO nodes and the stale device special files from the system.
These entries correspond to those nodes which have an entry in the system I/O
configuration files but the corresponding device is not found (see ioconfig(4)).
This option removes the stale device special files in the following directories only:
/dev/dsk /dev/rdsk /dev/ct /dev/rmt
/dev/floppy /dev/rfloppy /dev/rscsi /dev/pt
/dev/disk /dev/rdisk /dev/rtape
Also this option removes stale device special files of interface drivers like c8xx,
mpt, side, hpvmdio, and td from the /dev directory. Note that when -x
is
used along with
-H, no stale device special files will be removed.
RETURN VALUE
rmsf exits with one of the following values:
0 Successful completion, including warning diagnostics.
1 Failure. An error occurred.
2 Driver does not support this feature.
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 IO 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.
HP-UX 11i Version 3: September 2011 − 3 − Hewlett-Packard Company 3