NAME

rmsf − remove a special file

SYNOPSIS

/etc/rmsf [-a|-k] special_file ...
/etc/rmsf [-k] [-d driver | -C class] -H hw_path

DESCRIPTION

rmsf removes one or more special files from the current directory, and potentially removes information about the associated device or devices from the system. 

If a special_file is specified, without any options, rmsf removes that single special file from the current directory; the definition of the device remains in the system.  If the -k option is specified, the definition of the device is removed from the system without removing the special file.  If the -a option is specified, the definition of the device is removed from the system along with all special files in the current directory that map to it. 

If a hw_path is specified alone, all special files in the current directory mapping to devices at that hardware path and the system definition of those devices are removed.  The -C and -d options remove only those special files in the current directory 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 special file mapped to a single hardware path.  If the -k option is specified, the definition of all devices at that hardware path are removed from the system, again without removing any special file or files. 

Options

rmsf recognizes the following options and command-line options:

-C class Match devices belonging to the specified device class. Device classes are defined in file /etc/master, and can be listed using lsdev(1M). Cannot be used with -d. 

-a Remove the definition of the device from the system along with all special files in the current directory that refer to the device.  Cannot be used with -k. 

-d driver Match devices that are controlled by the specified device driver. Cannot be used with -C. 

-k Remove the definition of the device from the system, but not any special files.  Cannot be used with -a. 

-H hw_path A hardware path specifies the addresses of the hardware components leading to a device.  It consists of a string of numbers each suffixed by a slash (/), followed by a string of numbers separated by periods (.).  Hardware components suffixed by slashes indicate bus converters and may not be necessary on some systems.  Hardware components suffixed by .  indicate the addresses of the remaining hardware components on the path to the device. 

RETURN VALUE

rmsf returns 0 upon normal completion and 1 if an error occurred. 

DIAGNOSTICS

Most of the diagnostic messages from rmsf are self explanatory.  Listed below are some messages deserving 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

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. 

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 8.4.0:

rmsf -k 8.4.0

AUTHOR

rmsf was developed by HP. 

FILES

/dev/config
/etc/ioconfig
/etc/master

SEE ALSO

rm(1), insf(1M), ioscan(1M), lssf(1M), mksf(1M), ioconfig(4). 

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995