unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 ioscan(1M)							  ioscan(1M)




 NAME
      ioscan - scan I/O system

 SYNOPSIS
      /usr/sbin/ioscan [-k|-u] [-d driver|-C class] [-I instance]
	   [-H hw_path] [-f[-n]|-F[-n]] [devfile]

      /usr/sbin/ioscan -M driver -H hw_path [-I instance]

 DESCRIPTION
      ioscan scans system hardware, usable I/O system devices, or kernel I/O
      system data structures as appropriate, and lists the results.  For
      each hardware module on the system, ioscan displays by default the
      hardware path to the hardware module, the class of the hardware
      module, and a brief description.

      By default, ioscan scans the system and lists all reportable hardware
      found.  The types of hardware reported include processors, memory,
      interface cards and I/O devices.	Scanning the hardware may cause
      drivers to be unbound and others bound in their place in order to
      match actual system hardware.  Entities that cannot be scanned are not
      listed.

      In the second form shown, ioscan forces the specified software driver
      into the kernel I/O system at the given hardware path and forces
      software driver to be bound.  This can be used to make the system
      recognize a device that cannot be recognized automatically; for
      example, because it has not yet been connected to the system, does not
      support autoconfiguration, or because diagnostics need to be run on a
      faulty device.

      Generally, ioscan requires superuser privileges. A non root user may
      use the -k option, only to display the kernel hardware tree. Driver
      binding and actual hardware scanning is restricted to root.

    Options
      ioscan recognizes the following options:

	   -C class	     Restrict the output listing to those devices
			     belonging to the specified class.	Cannot be
			     used with -d.

	   -d driver	     Restrict the output listing to those devices
			     controlled by the specified driver.  Cannot be
			     used with -C.

	   -f		     Generate a full listing, displaying the
			     module's class, instance number, hardware path,
			     driver, software state, hardware type, and a
			     brief description.




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






 ioscan(1M)							  ioscan(1M)




	   -F		     Produce a compact listing of fields (described
			     below), separated by colons.  This option
			     overrides the -f option.

	   -H hw_path	     Restrict the scan and output listing to those
			     devices connected at the specified hardware
			     path.  The hardware path must be a bus path.
			     Scanning below the bus level will not probe the
			     hardware and may produce incorrect results. For
			     example, specifying the path at the target
			     level will always change the state of the
			     device attached to it as NO_HW.  When used with
			     -M, this option specifies the full hardware
			     path at which to bind the software modules.

	   -I instance	     Restrict the scan and output listing to the
			     specified instance, when used with either -d or
			     -C.  When used with -M, specifies the desired
			     instance number for binding.

	   -k		     Scan kernel I/O system data structures instead
			     of the actual hardware and list the results.
			     No binding or unbinding of drivers is
			     performed.	 The -d, -C, -I, and -H options can
			     be used to restrict listings.  Cannot be used
			     with -u.  This option does not require
			     superuser privileges.

	   -M driver	     Specifies the software driver to bind at the
			     hardware path given by the -H option.  Must be
			     used with the -H option.

	   -n		     List device file names in the output.  Only
			     special files in the /dev directory and its
			     subdirectories are listed.

	   -u		     Scan and list usable I/O system devices instead
			     of the actual hardware.  Usable I/O devices are
			     those having a driver in the kernel and an
			     assigned instance number.	The -d, -C, -I, and
			     -H options can be used to restrict listings.
			     The -u option cannot be used with -k.

      The -d and -C options can be used to obtain listings of subsets of the
      I/O system, although the entire system is still scanned.	Specifying
      -d or -C along with -I, or specifying -H or a devfile causes ioscan to
      restrict both the scan and the listing to the hardware subset
      indicated.

    Fields




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






 ioscan(1M)							  ioscan(1M)




      The -F option can be used to generate a compact listing of fields
      separated by colons (:), useful for producing custom listings with
      awk.  Fields include the module's bus type, cdio, is_block, is_char,
      is_pseudo, block major number, character major number, minor number,
      class, driver, hardware path, identify bytes, instance number, module
      path, module name, software state, hardware type, a brief description,
      and card instance. If a field does not exist, consecutive colons hold
      the field's position.  Fields are defined as follows:

	   class	  A device category, defined in the files located in
			  the directory /usr/conf/master.d and consistent
			  with the listings output by lsdev (see lsdev(1M)).
			  Examples are disk, printer, and tape.

	   instance	  The instance number associated with the device or
			  card.	 It is a unique number assigned to a card or
			  device within a class.  If no driver is available
			  for the hardware component or an error occurs
			  binding the driver, the kernel will not assign an
			  instance number and a (-1), is listed.

	   hw path	  A numerical string of hardware components, notated
			  sequentially from the bus address to the device
			  address.  Typically, the initial number is
			  appended by slash (/), to represent a bus
			  converter (if required by your machine), and
			  subsequent numbers are separated by periods (.).
			  Each number represents the location of a hardware
			  component on the path to the device.

	   driver	  The name of the driver that controls the hardware
			  component.  If no driver is available to control
			  the hardware component, a question mark (?) is
			  displayed in the output.

	   software state The result of software binding.

			  CLAIMED	 software bound successfully

			  UNCLAIMED	 no associated software found

			  DIFF_HW	 software found does not match the
					 associated software

			  NO_HW		 the hardware at this address is no
					 longer responding

			  ERROR		 the hardware at this address is
					 responding but is in an error state





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






 ioscan(1M)							  ioscan(1M)




			  SCAN		 node locked, try again later

	   hardware type  Entity identifier for the hardware component.	 It
			  is one of the following strings:

			  UNKNOWN	 There is no hardware associated or
					 the type of hardware is unknown

			  PROCESSOR	 Hardware component is a processor

			  MEMORY	 Hardware component is memory

			  BUS_NEXUS	 Hardware component is bus converter
					 or bus adapter

			  INTERFACE	 Hardware component is an interface
					 card

			  DEVICE	 Hardware component is a device

	   bus type	  Bus type associated with the node.

	   cdio		  The name associated with the Context-Dependent I/O
			  module.

	   is_block	  A boolean value indicating whether a device block
			  major number exists. A T or F is generated in this
			  field.

	   is_char	  A boolean value indicating whether a device
			  character major number exists. A T or F is
			  generated in this field.

	   is_pseudo	  A boolean value indicating a pseudo driver. A T or
			  F is generated in this field.

	   block major	  The device block major number. A -1 indicates that
			  a device block major number does not exist.

	   character major
			  The device character major number. A -1 indicates
			  that a device character major number does not
			  exist.

	   minor	  The device minor number.

	   identify bytes The identify bytes returned from a module or
			  device.

	   module path	  The software components separated by periods (.).




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






 ioscan(1M)							  ioscan(1M)




	   module name	  The module name of the software component
			  controlling the node.

	   description	  A description of the device.

	   card instance  The instance number of the hardware interface
			  card.

 RETURN VALUE
      ioscan returns 0 upon normal completion and 1 if an error occurred.

 EXAMPLES
      Scan the system hardware and list all the devices belonging to the
      disk device class.

	   ioscan -C disk

      Forcibly bind driver tape2 at the hardware path 8.4.1.

	   ioscan -M tape2 -H 8.4.1

 AUTHOR
      ioscan was developed by HP.

 FILES
      /dev/config
      /dev/*

 SEE ALSO
      config(1M), lsdev(1M), ioconfig(4).
























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