unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 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 >&gt&gt> /dev/console 2>&gt&gt>&&amp&amp&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
      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 Release 11i: November 2000






 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.

	   -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.

    Errors
      /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






 ioinit(1M)							  ioinit(1M)




	   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.

 EXAMPLES
      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
      Running rmsf or insf overwrites the effect of reassignment by ioinit
      before the system is rebooted.

 AUTHOR
      ioinit was developed by HP.

 FILES
      /stand/ioconfig

      /etc/ioconfig

 SEE ALSO
      init(1M), insf(1M), ioscan(1M), rmsf(1M), inittab(4), ioconfig(4).














 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000