HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

i
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 recog-
nize 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. Can-
not be used with
-C.
-f Generate a full listing, displaying the modules class, instance number, hardware
path, driver, software state, hardware type, and a brief description.
-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.
HP-UX 11i Version 1: September 2005 1 Hewlett-Packard Company Section 1M383