HP-UX Reference (11i v1 05/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 information read from
/etc/ioconfig. If these are consistent,
ioinit invokes insf to install special files for all new dev-
ices. 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 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
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.
-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.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−381