ioinit - test and maintain consistency between the kernel I/O data
structures and /etc/ioconfig
/sbin/ioinit -i [-r]
/sbin/ioinit -f infile [-r]
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 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
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 structures.
ioinit recognizes the following options:
-i Invoke insf to install special files for new devices
after checking consistency between the kernel and
-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,
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
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.
0 No errors occurred, although warnings might be issued.
1 ioinit encountered an error.
Most of the diagnostic messages from ioinit are self-explanatory.
Listed below are some messages deserving further clarification. Errors
cause ioinit to halt immediately.
/etc/ioconfig is missing.
/etc/ioconfig is corrupted.
Either restore /etc/ioconfig from backup and then reboot, or
recreate /etc/ioconfig using ioinit -c.
Permission to access /etc/ioconfig is denied.
Change permissions to /etc/ioconfig to allow access by ioinit.
exec of insf failed.
ioinit completed successfully, but insf failed.
Instance number is already in kernel.
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000
Instance number already exists for a given class. Use rmsf to
remove the existing instance number, then retry.
Hardware path is not in the kernel.
The given hardware path is not in the kernel. Use ioscan -k to
get the correct hardware path, then retry.
Device class name is not in the kernel.
The given class name is not in the kernel. Use ioscan -k to get
the correct class name, then retry.
To reassign an instance number to a device and class (specified in
infile) and reboot the system:
/sbin/ioinit -f infile -r
where infile contains the following:
56.52 scsi 2
56.52 is the h/w_path, scsi is the class_name, and 2 is the
Running rmsf or insf overwrites the effect of reassignment by ioinit
before the system is rebooted.
ioinit was developed by HP.
init(1M), insf(1M), ioscan(1M), rmsf(1M), inittab(4), ioconfig(4).
Hewlett-Packard Company - 3 - HP-UX Release 11i: November 2000