ioinit man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

ioinit(1M)							    ioinit(1M)

NAME
       ioinit  -  test	and  maintain  consistency between the kernel I/O data
       structures and the ioconfig files

SYNOPSIS

DESCRIPTION
       Starting with HP-UX 11i Version 3, there are two ioconfig files,	 which
       is  the	same  as on prior releases and which contains additional agile
       entries (see intro(7) for information on agile addressing).  These  two
       ioconfig files will have their copies in as and respectively.

       The  command is invoked by the process when the system is booted, based
       on the entry in

	      where
	      is a script to invoke with the and options.  Given  the  option,
	      checks  consistency  between  the versions of ioconfig files and
	      the versions of ioconfig files.  If these files are  consistent,
	      invokes to install special files for any new devices found.

       If  versions  of ioconfig files are inconsistent with versions, updates
       versions of ioconfig files from versions and, if the option  is	given,
       reboots the system.

       If  or is corrupted or missing when the system reboots, brings the sys‐
       tem up in single-user mode.  The user should then  restore  or  accord‐
       ingly  from  backup  or invoke with the option to recreate and from the
       kernel.

       If the option is given, reassigns instance numbers to existing  devices
       within  a  given	 class based on infile.	 If the driver associated with
       the given hardware path does not support online instance	 number	 reas‐
       signment,  reboot  is required.	If finds no errors associated with the
       reassignment, and the option is given, the system  is  rebooted.	  (See
       the section.)

       If  the	option	is  used  with	option,	 the command performs Critical
       Resource Analysis (CRA) on all the devices corresponding to  the	 hard‐
       ware  paths specified in infile, before assigning the new instance num‐
       bers.  Existing device special files of LUNs, whose instance number  is
       to  be reassigned, will be deleted and recreated after the reassignment
       of instance numbers.  If the driver associated with the given  hardware
       path  does  not support online instance number reassignment, the option
       must be used.

       If the option is given, recreates and from the existing kernel I/O data
       structures.

       If  the	option	is  given,  verifies if there is any corruption in the
       specified system file.

       If the option is given, the kernel is forced to reassign instance  num‐
       bers,  starting	from 0, for existing devices with the given class_name
       on the next reboot.  Note that  this  option  must  be  used  with  the
       option,	which reboots the system immediately, if the operation is suc‐
       cessful.

   Options
       recognizes the following options:

	      Performs Critical Resource Analysis (CRA) on all the devices
			corresponding  to  the	hardware  paths	 specified  in
			infile.	 Instance numbers will be reassigned as speci‐
			fied in infile, only  if  CRA  of  all	these  devices
			report SUCCESS.	 Existing device special files of LUNs
			whose instance number are reassigned will  be  deleted
			and recreated with the updated instance numbers.

			The  option  must  be specified when using the option.
			(See the option below.)

			If the driver associated with at least one given hard‐
			ware  paths  does  not	support online instance number
			reassignment, the option must also be specified.  (See
			the  option below.)  If the infile contains a hardware
			path of a node whose driver does  not  support	online
			instance  number reassignment and option is not speci‐
			fied, the command aborts the operation.

	      Recreates and files from the kernel if any of  these  files  are
			missing	 or  cannot be restored from backup.  Whenever
			updates these files from information obtained from the
			kernel,	 it  saves the current ioconfig file (the last
			known good one) before updating them as and  in	 order
			to  keep them synchronized with kernel I/O data struc‐
			tures.	If ioconfig  files  are	 missing  or  corrupt,
			users are advised to copy the file from the last known
			good file so that the least amount of  information  is
			lost.  If is invoked, any previous binding of hardware
			path to device class and instance number may be lost.

	      Forces the kernel to reassign instance numbers starting from
			0 for all existing devices with the given  class_name.
			This option must be used with the option.  On success‐
			ful completion the system is rebooted immediately.

	      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 one or more blanks.	Entries should
			conform to the following format:

			h/w_path	 class_name	     instance_#

			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.  If the specified instance number  already
			exists for the given class, the entry is invalid if it
			is not for circular reassignment.  On successful  com‐
			pletion of this operation, previous special files will
			still be associated with the device.

	      Invoke	to install special files for new devices after	check‐
			ing  consistency  between the versions of the ioconfig
			files and the versions.	 This creates  device  special
			files for any new devices found on the system.

	      Reboot the system when it is required to correct the
			inconsistent  state  between  the  kernel, and as used
			with the option.  When used with the option, if	 there
			are  no	 errors associated with the instance reassign‐
			ment, reboots the system.

	      Verify if there is any corruption in
			ioconfig_file.	If the verification  of	 ioconfig_file
			is  successful, the command displays a message showing
			if the type of ioconfig_file  is  either  legacy  (for
			example, or agile (for example,

			Note:  HP-UX  should not be rebooted without the file.
			If the file is missing or corrupted, HP-UX will recre‐
			ate the file before rebooting the system.  If the sys‐
			tem needs to be booted without the file	 (thus	losing
			all  the persistent I/O information (see ioconfig(4)),
			the user can delete the file  and  reboot  the	system
			with the command (see reboot(1M)).

RETURN VALUE
	      No errors occurred, although warnings might be issued.
	      encountered an error.
	      was recognized as an
		     file but it was found corrupted during verification.

DIAGNOSTICS
       Most  of	 the  diagnostic  messages  from are self-explanatory.	Listed
       below are some messages deserving further clarification.	 Errors	 cause
       to halt immediately.

   Errors
		     Either restore
	      or accordingly from backup and then reboot,
	      or recreate or using

		     Change permissions to
	      to allow access by

		     completed successfully, but
	      failed.

		     Instance number already exists for a
		     given class.
	      Use to remove the existing instance number,
	      then retry.

		     The given hardware path  is  not  in
		     the kernel.
	      Use  to get the correct hardware path, then
	      retry.

		     The given class name is not  in  the
		     kernel.
	      Use  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:

       where infile contains the following:

       is  the	h/w_path,  is  the class_name, and is the
       instance_#.

       is the h/w_path, is the	class_name,  and  is  the
       instance_#.

       To  achieve circular reassignment of instance num‐
       bers between  two  existing  devices  of	 a  class
       (specified in infile), assuming the driver associ‐
       ated with the given hardware paths support  online
       reassignment of instance numbers.

       where infile contains the following:

       is  the	h/w_path,  is  the class_name, and is the
       instance_#.   The  existing  instance_#	of   this
       device is 30.

       is  the	h/w_path,  is  the class_name, and is the
       instance_#.   The  existing  instance_#	of   this
       device  is 20.  After the successful completion of
       this operation, will have the new instance_# as 20
       and will have the new instance_# as 30.

       Verify  file  for corruptions and find if it is of
       type legacy or agile.

WARNINGS
       Running or overwrites the effect of instance  num‐
       ber reassignment by before the system is rebooted.
       The previous statement applies  only  for  devices
       whose  drivers do not support online instance num‐
       ber reassignment.

AUTHOR
       was developed by HP.

FILES
       SEE
	      ALSO

	      init(1M),
	      insf(1M),
	      ioscan(1M),
	      rmsf(1M),
	      init‐
	      tab(4),
	      iocon‐
	      fig(4),
	      intro(7).

								    ioinit(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net