ioinit.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ioinit(1M) ioinit(1M)

NAME

ioinit - test and maintain consistency between the kernel I/O data structures and the ioconﬁg ﬁles

SYNOPSIS

/sbin/ioinit -i [-r]

/sbin/ioinit -c

/sbin/ioinit -f inﬁle [

-A][-r]

/sbin/ioinit -v ioconﬁg_ﬁle

/sbin/ioinit -rC class_name

DESCRIPTION

Starting with HP-UX 11i Version 3, there are two ioconﬁg ﬁles,

/etc/ioconfig

which is the same as

on prior releases and

/etc/ext_ioconfig

which contains additional agile entries (see intro (7) for

information on agile addressing). These two ioconﬁg ﬁles will have their copies in

/stand as

/stand/ioconfig

and /stand/ext_ioconfig

respectively.

The

ioinit command is invoked by the init

process when the system is booted, based on the ioin

entry in /etc/inittab:

ioin::sysinit:/sbin/ioinitrc > /dev/console 2>&1

where ioinitrc is a script to invoke ioinit with the -i and -r options. Given the

-i option,

ioinit checks consistency between the /stand versions of ioconﬁg ﬁles and the /etc

versions of

ioconﬁg ﬁles. If these ﬁles are consistent,

ioinit invokes insf to install special ﬁles for any new dev-

ices found.

/stand versions of ioconﬁg ﬁles are inconsistent with /etc versions, ioinit updates /stand

ver-

sions of ioconﬁg ﬁles from

/etc versions and, if the -r option is given, reboots the system.

/stand/ioconfig

or /stand/ext_ioconfig is corrupted or missing when the system reboots,

ioinitrc brings the system up in single-user mode. The user should then restore /stand/ioconfig

or /stand/ext_ioconfig

accordingly from backup or invoke ioinit with the -c option to recreate

/stand/ioconfig, /stand/ext_ioconfig

, /etc/ioconfig, and

/etc/ext_ioconfig from

the kernel.

If the

-f option is given, ioinit reassigns instance numbers to existing devices within a given class

based on inﬁle. If the driver associated with the given hardware path does not support online instance

number reassignment, reboot is required. If

ioinit ﬁnds no errors associated with the reassignment,

and the

-r option is given, the system is rebooted. (See the WARNINGS section.)

If the

-A option is used with -f option, the command performs Critical Resource Analysis (CRA) on all

the devices corresponding to the hardware paths speciﬁed in inﬁle, before assigning the new instance

numbers. Existing device special ﬁles of LUNs, whose instance number is to be reassigned, will be

deleted and recreated after the reassignment of instance numbers. If the driver associated with the given

hardware path does not support online instance number reassignment, the

-r option must be used.

If the

-c option is given, ioinit recreates /etc/ioconfig and /etc/ext_ioconfig

from the

existing kernel I/O data structures.

If the

-v option is given, ioinit veriﬁes if there is any corruption in the speciﬁed system ioconfig

ﬁle.

If the

-C option is given, the kernel is forced to reassign instance numbers, starting from 0, for existing

devices with the given class_name on the next reboot. Note that this option must be used with the -r

option, which reboots the system immediately, if the operation is successful.

Options

ioinit recognizes the following options:

-A Performs Critical Resource Analysis (CRA) on all the devices corresponding to the

hardware paths speciﬁed in inﬁle. Instance numbers will be reassigned as speciﬁed in

inﬁle, only if CRA of all these devices report SUCCESS. Existing device special ﬁles of

LUNs whose instance number are reassigned will be deleted and recreated with the

updated instance numbers.

The

-f option must be speciﬁed when using the -A option. (See the -f option below.)

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

Summary of content (4 pages)

PAGE 1
ioinit(1M) ioinit(1M) NAME ioinit - test and maintain consistency between the kernel I/O data structures and the ioconfig files SYNOPSIS /sbin/ioinit -i [-r] /sbin/ioinit -c /sbin/ioinit -f infile [-A] [-r] /sbin/ioinit -v ioconfig_file /sbin/ioinit -rC class_name DESCRIPTION Starting with HP-UX 11i Version 3, there are two ioconfig files, /etc/ioconfig which is the same as on prior releases and /etc/ext_ioconfig which contains additional agile entries (see intro (7) for information on agile addressing).
PAGE 2
ioinit(1M) ioinit(1M) If the driver associated with at least one given hardware paths does not support online instance number reassignment, the -r option must also be specified. (See the -r option below.) If the infile contains a hardware path of a node whose driver does not support online instance number reassignment and -r option is not specified, the command aborts the operation.
PAGE 3
ioinit(1M) ioinit(1M) Errors /etc/ioconfig is missing. /etc/ioconfig is corrupted. /etc/ext_ioconfig is missing. /etc/ext_ioconfig is corrupted. Either restore /etc/ioconfig or /etc/ext_ioconfig accordingly from backup and then reboot, or recreate /etc/ioconfig or /etc/ext_ioconfig using ioinit -c. Permission to access /etc/ext_ioconfig is denied. Change permissions to /etc/ext_ioconfig to allow access by ioinit. exec of insf failed. ioinit completed successfully, but insf failed.
PAGE 4
ioinit(1M) ioinit(1M) AUTHOR ioinit was developed by HP. FILES /stand/ioconfig /stand/ioconfig.lkg /etc/ioconfig /etc/ioconfig.lkg /stand/ext_ioconfig /stand/ext_ioconfig.lkg /etc/ext_ioconfig /etc/ext_ioconfig.lkg SEE ALSO init(1M), insf(1M), ioscan(1M), rmsf(1M), inittab(4), ioconfig(4), intro(7).