ioscan(1M)

only to display the kernel hardware tree.

use the mapping features.

display the property of a node.

list pending deferred bindings.

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.

Defer the binding of a driver to a hardware path until the next system boot. Must be used with -M and -H options.

List all the pending deferred bindings.

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

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

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.

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

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

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.

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.

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.

Display mapping information according to the keyword specified. ioscan retrieves the information from the kernel I/O data structures without scanning the hardware. Keywords can be any one of the following:

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

List device file names in the output. Only special files in the /dev directory and its subdirectories are listed. Must be used with either the -f or the -F option.

Displays the agile view (see intro(7)) of the system hardware. For mass storage device entries that would normally include the driver class, the legacy hardware path, and the device description, ioscan prints a class of lunpath, the lunpath hardware path, and the name of the LUN that it maps to, when used with this option. In addition, the output will include entries for the mass storage devices at their LUN hardware paths, with the expected driver class and description. Thus, each mass storage device will have at least two entries in the ioscan output: one for the LUN hardware path and one for each lunpath hardware path. If used with the -n option, ioscan only prints persistent special files.

Displays the property of nodes in the agile view. This option can be combined with the -C, -d, -I and -H options, but the parameters passed must belong to the agile view. The valid properties are:

bus_type, cdio, is_block, is_char, is_pseudo, b_major, c_major, minor, class, driver, hw_path, id_bytes, instance, module_name, sw_state, hw_type, description, health.

Remove a deferred binding at the specified hardware path. Must be used with the -H option. The hw_path must belong to the agile view.

Lists stale I/O node entries present in the system. These entries correspond to nodes that have an entry in the system I/O configuration file, but the corresponding device is not found (see ioconfig(4)).

Display the date and time at which the system hardware was last scanned. This is an example output ioscan produces with this option:

Fri Nov 22 11:22:21 2005.

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.

Initiates a scan on unclaimed nodes of type INTERFACE in the agile view.

Bus type associated with the node.

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

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

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

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

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 exist.

The device minor number.

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.

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.

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.

The identify bytes returned from a module or device.

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.

The software components separated by periods (.).

The module name of the software component controlling the node.

The result of software binding.

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

A description of the device.

The instance number of the hardware interface card.

On Integrity servers hardware, this field contains the EFI device path. On PA-RISC hardware, this field contains the PA device path in both hexadecimal and decimal format separated by a comma ,.

State of the node as defined by the subsystem that manages this node (for example, a driver). It is one of the following strings: