ioinit(1M)                                                       ioinit(1M)




 NAME    [Toc]    [Back]
      ioinit - test and maintain consistency between the kernel I/O data
      structures and /etc/ioconfig

 SYNOPSIS    [Toc]    [Back]
      /sbin/ioinit -i [-r]

      /sbin/ioinit -c

      /sbin/ioinit -f infile [-r]

 DESCRIPTION    [Toc]    [Back]
      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.

    Options    [Toc]    [Back]
      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,



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 ioinit(1M)                                                       ioinit(1M)




                     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    [Toc]    [Back]
           0    No errors occurred, although warnings might be issued.

           1    ioinit encountered an error.

 DIAGNOSTICS    [Toc]    [Back]
      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    [Toc]    [Back]
      /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.

      ext_bus instance value exceeds one byte limit

           Change specified instance number for ext_bus class of devices in
           infile.  Note that the value of instance number should not exceed
           255.



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 ioinit(1M)                                                       ioinit(1M)




      exec of insf failed.

           ioinit completed successfully, but insf failed.

      Instance number is already in kernel.    [Toc]    [Back]

           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.    [Toc]    [Back]

           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.    [Toc]    [Back]

           The given class name is not in the kernel.  Use ioscan -k to get
           the correct class name, then retry.

 EXAMPLES    [Toc]    [Back]
      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
      instance_#.

 WARNINGS    [Toc]    [Back]
      Running rmsf or insf overwrites the effect of reassignment by ioinit
      before the system is rebooted.

 AUTHOR    [Toc]    [Back]
      ioinit was developed by HP.

 FILES    [Toc]    [Back]
      /stand/ioconfig

      /etc/ioconfig

 SEE ALSO    [Toc]    [Back]
      init(1M), insf(1M), ioscan(1M), rmsf(1M), inittab(4), ioconfig(4).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003