HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

i
ioinit(1M) ioinit(1M)
NAME
ioinit - test and maintain consistency between the kernel I/O data structures and /etc/ioconfig
SYNOPSIS
/sbin/ioinit -i [-r]
/sbin/ioinit -c
/sbin/ioinit -f infile [
-r]
DESCRIPTION
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 kernel I/O data structures (initialized with
/stand/ioconfig
, which is accessible for NFS-diskless support when the system boots up) and infor-
mation read from
/etc/ioconfig
. If these are consistent, ioinit invokes insf
to install special
files for all new devices. If the kernel is inconsistent with
/etc/ioconfig
, ioinit updates
/stand/ioconfig
from /etc/ioconfig
, and, if the -r option is given, reboots the system.
If
/etc/ioconfig is corrupted or missing when the system reboots,
ioinitrc brings the system up
in single-user mode. The user should then restore
/etc/ioconfig
from backup or invoke the ioinit
with the -c option to recreate /etc/ioconfig
from the kernel.
If the
-f option is given, ioinit reassigns instance numbers to existing devices within a given class
based on infile. Reassignment takes effect when the system reboots. If
ioinit finds no errors associ-
ated with the reassignment, and the
-r option is given, the system is rebooted. (See the WARNINGS sec-
tion.)
If the
-c option is given, ioinit recreates /etc/ioconfig
from the existing kernel I/O data struc-
tures.
Options
ioinit recognizes the following options:
-i Invoke insf to install special files for new devices after checking consistency between
the kernel and /etc/ioconfig.
-f infile Use the file infile to reassign instance numbers to devices within a specified class. infile
may have multiple entries, each to appear on a separate line, each field in the entry
separated by 1 or more blanks. Entries should conform to the following format:
h/w_path class_name instance_#
ioinit preprocesses the contents of infile, looking for invalid entries, and prints out
explanatory messages. An entry is considered to be invalid if the specified hardware
path or class name does not already exist in the system, or if the specified instance
number already exists for the given class. For ext_bus class of devices, specified
instance numbers should not exceed 255.
-r Reboot the system when it is required to correct the inconsistent state between the kernel
and /etc/ioconfig, as used with the -i option. When used with the -f option, if
there are no errors associated with the instance reassignment, -r reboots the system.
-c Recreate /etc/ioconfig, if the file is corrupted or missing and cannot be restored
from backup. If -c is invoked, any previous binding of hardware path to device class
and instance number is lost.
RETURN VALUE
0 No errors occurred, although warnings might be issued.
1 ioinit encountered an error.
DIAGNOSTICS
Most of the diagnostic messages from
ioinit are self-explanatory. Listed below are some messages
deserving further clarification. Errors cause ioinit to halt immediately.
Section 1M−−334 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004