NAME [Toc] [Back]
ioscan - scan I/O system
SYNOPSIS [Toc] [Back]
/usr/sbin/ioscan [-k|-u] [-e] [-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 [Toc] [Back]
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
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
In the third form, ioscan displays the date and time at which system
hardware was last scanned.
Note: The -t option cannot be used with any other options
available for this command.
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 [Toc] [Back]
ioscan recognizes the following options:
-C class Restrict the output listing to those devices
belonging to the specified class. Cannot be
used with -d.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
-d driver Restrict the output listing to those devices
controlled by the specified driver. Cannot be
used with -C.
-e Display EFI (Extensible Firmware Interface)
device paths when available.
-f Generate a full listing, displaying the
module's class, instance number, hardware path,
driver, software state, hardware type, and a
-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. The state of
the device may be restored by retrying ioscan
from a bus node above the NO_HW node. When
used with -M, this option specifies the full
hardware path at which to bind the software
-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
-M driver Specify 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.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
-t Display the date and time at which the system
hardware was last scanned. The output of the
ioscan command used with this option is as
follows: Fri Nov 22 11:22:21 2002
-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
Fields [Toc] [Back]
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
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
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
NO_HW the hardware at this address is no
ERROR the hardware at this address is
responding but is in an error state
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
DEVICE Hardware component is a device
bus type Bus type associated with the node.
cdio The name associated with the Context-Dependent I/O
is_block A boolean value indicating whether a device block
major number exists. A T or F is generated in
is_char A boolean value indicating whether a device
character major number exists. A T or F is
generated in this field.
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003
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.
The device character major number. A -1 indicates
that a device character major number does not
minor The device minor number.
identify bytes The identify bytes returned from a module or
module path The software components separated by periods (.).
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
RETURN VALUE [Toc] [Back]
ioscan returns 0 upon normal completion and 1 if an error occurred.
EXAMPLES [Toc] [Back]
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 [Toc] [Back]
ioscan was developed by HP.
FILES [Toc] [Back]
SEE ALSO [Toc] [Back]
kcmodule(1M), lsdev(1M), ioconfig(4).
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003 [ Back ]