HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

i
ioinit(1M) ioinit(1M)
ioinit preprocesses the contents of infile, looking for invalid entries, and prints out
explanatory messages. If the infile contains more than 14 entries, then a reboot is
required. An entry is considered to be invalid if the specified hardware path or class name
does not already exist in the system. If the specified instance number already exists for the
given class, the entry is invalid if it is not for circular reassignment. On successful comple-
tion of this operation, previous special files will still be associated with the device.
-i Invoke insf to install special files for new devices after checking consistency between the
kernel and /etc/ioconfig
and /etc/ext_ioconfig
.
-r Reboot the system when it is required to correct the inconsistent state between the kernel
and /etc/ioconfig
and /etc/ext_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.
-v ioconfig_file
Verify if there is any corruption in ioconfig_file. If the verification of ioconfig_file is success-
ful, the command displays a message showing if the type of ioconfig_file is either legacy (for
example,
/etc/ioconfig
) or agile (for example, /etc/ext_ioconfig
).
Note: HP-UX cannot be rebooted without the
/stand/ext_ioconfig
file. If the file is
missing or corrupted, HP-UX will recreate the file before rebooting the system. If there is a
need for booting the system without the
/stand/ext_ioconfig
file (thus losing all the
persistent I/O information (see ioconfig(4)), the user can delete the file and reboot the sys-
tem with the command
reboot -q (see reboot(1M)).
RETURN VALUE
0 No errors occurred, although warnings might be issued.
1 ioinit encountered an error.
2 file was recognized as an ioconfig_file
file but it was found corrupted during
verification.
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.
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/ioconfig is denied.
Change permissions to /etc/ioconfig to allow access by
ioinit.
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.
Instance number is already in kernel.
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.
HP-UX 11i Version 3: February 2007 − 2 − Hewlett-Packard Company 371