HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)
i
ioscan(1M) ioscan(1M)
• ioscan -r reverts the deferred binding action on a device lunpath.
• ioscan -B lists all the pending deferred bindings.
• ioscan -U scans all unclaimed nodes of type INTERFACE.
• ioscan -a shows information about thread 0 for a processor with Hyper Threading feature.
Security Restriction
Generally, ioscan requires superuser privileges. A non root user may use the following options:
-k only to display the kernel hardware tree.
-m use the mapping features.
-P display the property of a node.
-B list pending deferred bindings.
Driver binding and actual hardware scanning is restricted to root.
Options
ioscan recognizes the following options:
-a Show information about thread ’0’ for a processor with Hyper Threading feature.
When used with -F option, command generates a compact listing of fields separated
by colons (:), useful for producing custom listings with awk. Fields include: socket,
core, thread.
-b Defer the binding of a driver to a hardware path until the next system boot. Must be
used with -M and -H options.
-B List all the pending deferred bindings.
-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.
-e Display the device path as follows:
On Integrity servers, display EFI (Extensible Firmware Interface) device paths when
available.
On PA-RISC Hardware, when used with -N option, displays PA device path when
available in hexadecimal and also in decimal format separated with a comma ,. This
is the form to be used when booting from ISL in the hpux command prompt with the
-a option (see hpux(1M)). The same format can be used to enter a lunpath hardware
path in the Boot Console Handler (BCH) boot prompt.
-f Generate a full listing, displaying the module’s class, instance number, hardware path,
driver, software state, hardware type, and a brief description.
-F Produce a compact listing of fields (see Fields 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 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.
Must be used with either -d, -C,or-M option.
-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
374 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: February 2007