insf.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

insf(1M) insf(1M)

NAME

insf - install special (device) ﬁles

SYNOPSIS

/sbin/insf

/sbin/insf [-C class  -d

driver ][-D directory ][-e][-H hw-path ][

-I instance ]

[

-n npty ][-q

-v][-s nstrpty ]

/sbin/insf -L [-v]

DESCRIPTION

The

insf command installs special ﬁles in the devices directory, normally

/dev. If required, insf

creates any subdirectories that are deﬁned for the resulting special ﬁle. Both the legacy and persistent

device special ﬁles (see intro(7)) are created, unless speciﬁed.

If no options are speciﬁed, special ﬁles are created for all new devices in the system. New devices are

those devices for which no special ﬁles have been previously created. A subset of the new devices can be

selected with the

-C, -d

, and -H options.

With the

-e option, insf reinstalls the special ﬁles for pseudo-drivers and existing devices. This is use-

ful for restoring special ﬁles when one or more have been removed.

Normally,

insf displays a message as the special ﬁles are installed for each driver. The -q

(quiet)

option suppresses the installation message. The

-v (verbose) option displays the installation message

and the name of each special ﬁle as it is created.

With the

-L option, insf enables the legacy naming model. If the -v option is included,

insf also

displays the current mode, legacy, or agile without changing the current mode.

Options

insf recognizes the following options.

-C class Match devices that belong to a given device class, class . Device classes can be listed

with the lsdev command (see lsdev (1M)). The special class pseudo includes all

pseudo-drivers. This option cannot be used with

-d.

-d driver Match devices that are controlled by the speciﬁed device driver, driver .Device

drivers can be listed with the

lsdev command (see lsdev (1M)). This option cannot

be used with -C.

-D directory Override the default device installation directory /dev and install the special ﬁles

in directory instead. directory must exist; otherwise, insf displays an error mes-

sage and exits. See WARNINGS .

-e Reinstall the special ﬁles for pseudo-drivers and existing devices. This is useful for

restoring special ﬁles if one or more have been removed.

-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 speciﬁes 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.

If the speciﬁed path contains fewer numbers than are necessary to reach a device,

special ﬁles are made for all devices at addresses that extend the given path. If the

speciﬁed path is

56, then special ﬁles are made for the devices at addresses 56.0,

56.1, 56.2, etc. In the agile view (see intro(7)), the devices will have new

hardware path formats, which can be displayed using the ioscan command with

-N option (see ioscan (1M)).

-I instance Match a device with the speciﬁed instance number. Instances can be listed with the

-f option of the ioscan command (see ioscan (1M)).

This option is effective only if the

-e option is speciﬁed or if an appropriate device

class or driver is speciﬁed with a -C or -d option.

-L Enable the legacy naming model. This command reinstalls the legacy I/O nodes and

legacy device special ﬁles which might have been removed with rmsf -L (see

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (12 pages)

PAGE 1
insf(1M) insf(1M) NAME insf - install special (device) files SYNOPSIS /sbin/insf /sbin/insf [-C class  -d driver ] [-D directory ] [-e] [-H hw-path ] [-I instance ] [-n npty ] [-q-v] [-s nstrpty ] /sbin/insf -L [-v] DESCRIPTION The insf command installs special files in the devices directory, normally /dev. If required, insf creates any subdirectories that are defined for the resulting special file. Both the legacy and persistent device special files (see intro(7)) are created, unless specified.
PAGE 2
insf(1M) insf(1M) rmsf (1M)). When used with the -v option, insf reports on whether legacy mode is enabled or disabled. -n npty Install npty special files for each specified ptym and ptys driver. The pty driver specifies both the ptym and ptys drivers. npty is a decimal number. This option is effective only if the -e option is specified or if an appropriate device class or driver is specified with a -C or -d option. If this option is omitted, npty defaults to 60 for the ptym and ptys drivers.
PAGE 3
insf(1M) ttycard p1 insf(1M) rw--w--w- bin bin remote session port (direct connect) sassy rw------- root sys internal console port (direct connect) ttycard+1 p0 rw--w--w- bin bin UPS port (direct connect) ttycard+1 p1 rw--w--w- bin bin local session port (direct connect) asyncdsk The following special files are installed: asyncdsk rw-rw-rw- bin bin async rw-rw-rw- bin bin audio The following special files are installed. Note the underscore (_) before card in each special file name.
PAGE 4
insf(1M) insf(1M) No output, Mu-law format beep The following special file is installed: beep rw-rw-rw- bin bin CentIf For each card instance, the following special file is installed.
PAGE 5
insf(1M) insf(1M) rdsk/ccard ttarget ddevice spartition rw-r----- bin sys Character entry dlpi The following special files are installed: dlpi rw-rw-rw- root sys dlpi0 rw-rw-rw- root sys dlpi1 rw-rw-rw- root sys dlpi2 rw-rw-rw- root sys dlpi3 rw-rw-rw- root sys dlpi4 rw-rw-rw- root sys dmem The following special file is installed: dmem rw------- bin bin echo The following special file is installed: echo rw-rw-rw- root sys eschgr The following persistent special file is installed: A
PAGE 6
insf(1M) lancard insf(1M) rw-rw-rw- bin bin framebuf For each graphics device, the following special files are installed. crtdevice_number rw-rw-rw- bin bin ocrtdevice_number rw-rw-rw- bin bin device_number is 0 indexed and is assigned in the order in which the devices appear in ioscan output. If the console device is a graphics device, the files crt and ocrt are created as the console device. If the console is not a graphics device, crt and ocrt are identical to crt0 and ocrt0.
PAGE 7
insf(1M) insf(1M) diag/lanttycard rw-rw-rw- bin bin Exclusive access lpr2 lpr3 For each card instance, the following special files are installed: mm ccard ttarget ddevice _lp rw------- lp bin diag/ccard ttarget ddevice _lp rw------- bin bin The following special files are installed: mem rw-r----- bin sys Minor 0 kmem rw-r----- bin sys Minor 1 null rw-rw-rw- bin bin Minor 2 mpt The following persistent special files are installed: mptinstance crw-rw-rw- bin sys mux0 For each instance of a
PAGE 8
insf(1M) insf(1M) ttycard pport rw--w--w- bin bin port : 0 and 1, direct connect netqa The following special file is installed: netqa rw-rw-rw- root sys nuls The following special file is installed: nuls pci_mux0 rw-rw-rw- root sys pci_mux1 For each instance of a PCI mux card, the following "Direct Connect" special files are created. The term card below refers to the instance number of the mux card.
PAGE 9
insf(1M) insf(1M) ptym/ptyindex number rw-rw-rw- bin bin index : p to z, a to c, e to o; number: 00 to 99 ptym/ptyindex number rw-rw-rw- bin bin index : p to z, a to c, e to o; number: 000 to 999 ptys The following special files are installed: pty/ttyindex number rw-rw-rw- bin bin index : p to z, a to c, e to o; number: 0 to f (hexadecimal) The first 48 special files pty/tty* are linked to tty*.
PAGE 10
insf(1M) insf(1M) for short file name directories (14 characters maximum). Note that the first four special files in each list for tape driver instances 0-9 are also linked to rmt/instance m, rmt/instance mb, rmt/instance mn, and rmt/instance mnb, respectively.
PAGE 11
insf(1M) insf(1M) pts/tnumber rw-rw-rw- root sys number: 0 to 59 tlclts The following special file is installed: tlclts rw-rw-rw- root sys tlcots The following special file is installed: tlcots rw-rw-rw- root sys tlcotsod The following special file is installed: tlcotsod rw-rw-rw- root sys token2 The following special file is installed: lancard rw-rw-rw- bin bin udp The following special file is installed: udp rw-rw-rw- root sys unix_clts The following special file is installed: unix_clts
PAGE 12
insf(1M) insf(1M) insf -H 64000/0xfa00/0x3 Reinstall persistent special files for all the devices belonging to the esdisk device driver: insf -e -d esdisk Enable legacy mode (reinstalls all legacy I/O nodes and legacy device special files): insf -L Find out if legacy mode is enabled or disabled: insf -L -v WARNINGS insf can change the mode, owner, or group of an existing special file, or unlink and recreate one; special files that are currently open may be left in an indeterminate state.