rmsf.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

rmsf(1M) rmsf(1M)

NAME

rmsf - remove a special (device) ﬁle

SYNOPSIS

/sbin/rmsf [[-a-k][

-m]] [-D directory ][-q-v][

-c] special_ﬁle ...

/sbin/rmsf [-C class  -d

driver ][-D directory ][-m][-c] -H

hw_path [-k][-q-v]

/sbin/rmsf -L

/sbin/rmsf -u -H hw_path

/sbin/rmsf -x -H hw_path

DESCRIPTION

The

rmsf command removes one or more special ﬁles from the

/dev directory and potentially removes

information about the associated device or devices with H/W type

DEVICE, TGT_PATH or a LUN_PATH,

(see ioscan(1M)) from the system.

If no options are speciﬁed,

rmsf removes only the special_ﬁle speciﬁed on the command line. The -k

option causes rmsf to remove the deﬁnition of the device from the system without removing any special

ﬁles. The -a option causes rmsf

to remove the device deﬁnition and all special ﬁles that map to it from

the

/dev directory (or the directory speciﬁed with the -D option).

When the speciﬁed special_ﬁle or hw_path belongs to a persistent device type, the device corresponding to

special_ﬁle or hw_path should not be in an open state in order for the command to complete successfully.

When the

-c option is used along with a persistent device type special_ﬁle or LUN hw_path, the com-

mand executes and displays Critical Resource Analysis (CRA) on the corresponding device before remov-

ing the special_ﬁle or hw_path . Other than with persistent device type special_ﬁle or LUN hw_path , the

-c option will be ignored by the command for any other type of special_ﬁle or hw_path . Use of the

-q

(quiet) option along with -c suppresses the display of Critical Resource Analysis (CRA) report.

Without the

-D option, if special_ﬁle is speciﬁed with a relative path, the path is treated relative to the

default device directory /dev.Ifspecial_ﬁle is speciﬁed with an absolute path and the

-D option is also

used, the special_ﬁle with absolute path will have precedence over the

-D option.

Note that if special_ﬁle belongs to a node for which H/W type is not

DEVICE, the device deﬁnition will

not be removed from the system and the special_ﬁle will be removed if it is a leaf node.

If a

-H hw_path is speciﬁed, special ﬁles are removed as follows:

• If hw_path belongs to a node with H/W type

DEVICE, all special ﬁles mapping to devices at that

hardware path and the system deﬁnition of those devices are removed. If the hw_path belongs to

LUN hardware path of a node of type

DEVICE, the device should not be in an open state for the

command to complete successfully.

• If hw_path belongs to a node with H/W type

LUN_PATH, all legacy special ﬁles mapping to dev-

ices at that hardware path, as well as the system deﬁnition of those devices, are removed.

• If hw_path belongs to a node for which H/W type is

TGT_PATH, no special ﬁles are removed;

only corresponding node is removed.

• If hw_path belongs to a node for which H/W type is not any of the above mentioned types, then a

special ﬁle is removed as follows:

• If it is a leaf node, only special ﬁles for that node will be removed.

• If the node has children, then a warning message will be issued and system deﬁnition of all

the children devices and their special ﬁles are removed.

The

-C and -d options remove only those special ﬁles 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 spe-

cial ﬁle mapped to a single hardware path. These options are not supported with the class or device

drivers which do not have a hardware module on the system; for example, the pseudo class.

If the

-k option is speciﬁed, the deﬁnition of all devices at that hardware path are removed from the sys-

tem, again without removing any special ﬁles.

The

-v (verbose) option displays the name of each special ﬁle as it is deleted. The -q (quiet) option

suppresses the deletion message.

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
rmsf(1M) rmsf(1M) NAME rmsf - remove a special (device) file SYNOPSIS /sbin/rmsf [[-a-k] [-m]] [-D directory ] [-q-v] [-c] special_file ...
PAGE 2
rmsf(1M) rmsf(1M) With the -L option, rmsf disables the legacy naming model, removing all legacy I/O nodes and their device special files from the system. If the -u and -H options are specified, rmsf performs an unbind on the driver associated with the given hw_path . The hw_path must be a LUN hardware path (see intro (7)). The -x option removes stale device special files and the stale IO nodes from the system. A specific stale hw_path can be specified with -H.
PAGE 3
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 command will not validate the presence or utilization of products with these limitations.
PAGE 4
rmsf(1M) rmsf(1M) 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.