HP-UX Reference (11i v3 07/02) - 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 the ioconfig files
SYNOPSIS
/sbin/ioinit -i [-r]
/sbin/ioinit -c
/sbin/ioinit -f
infile [
-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 infor-
mation on agile addressing).
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 and information read from
/etc/ioconfig and /etc/ext_ioconfig
. If these are consistent, ioinit invokes insf to
install special files for all new devices.
If the kernel is inconsistent with
/etc/ioconfig
or /etc/ext_ioconfig, ioinit updates
/stand/ioconfig from /etc/ioconfig
, and /stand/ext_ioconfig from
/etc/ext_ioconfig
, and, if the -r option is given, reboots the system.
If
/etc/ioconfig or /etc/ext_ioconfig
is corrupted or missing when the system reboots, ioin-
itrc
brings the system up in single-user mode. The user should then restore /etc/ioconfig
or
/etc/ext_ioconfig
accordingly from backup or invoke the ioinit with the -c option to recreate
/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 infile. If the driver associated with the given hardware path does not support online instance
number reassignment, reboot is required. If
ioinit finds no errors associated with the reassignment,
and the
-r option is given, the system is rebooted. (See the WARNINGS section.)
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 verifies if there is any corruption in the specified system ioconfig file.
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:
-c Recreate /etc/ioconfig and /etc/ext_ioconfig
, if the file is corrupted or miss-
ing and cannot be restored from backup. If
-c is invoked, any previous binding of
hardware path to device class and instance number is lost.
-C class_name
Forces the kernel to reassign instance numbers starting from 0 for all existing devices with
the given class_name. This option must be used with the -r option. On successful comple-
tion the system is rebooted immediately.
-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 one or more blanks. Entries should conform to the following format:
h/w_path class_name instance_#
370 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007