ioscan.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ioscan(1M) ioscan(1M)

NAME

ioscan - scan the I/O system

SYNOPSIS

/usr/sbin/ioscan

[-N][-k-u][

-e][-d driver  -C class ][-I instance ][-H hw_path ][

l][-A][-f

[-n]  -F[-F][-n]][devﬁle ]

/usr/sbin/ioscan

[-b] -M driver -H hw_path [

-I instance ]

/usr/sbin/ioscan -t

/usr/sbin/ioscan -P

property [-d driver  -C class ][

-I instance ][-H hw_path ][devﬁle ]

/usr/sbin/ioscan -m lun

[-F][-d

driver  -C class ][-I instance ][-H lun hw_path ]

[ devﬁle ]

/usr/sbin/ioscan

[-F] -m dsf [ devﬁle ]

/usr/sbin/ioscan -m hwpath

[-F][-H hw_path ]

/usr/sbin/ioscan

[-F] -m cluster_dsf [ devﬁle ]

/usr/sbin/ioscan -m resourcepath

[-F][-H

hw_path ]

/usr/sbin/ioscan -s

/usr/sbin/ioscan -r -H

hw_path

/usr/sbin/ioscan -B

/usr/sbin/ioscan -U

/usr/sbin/ioscan -a

[-F ]

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

ties that cannot be scanned are not listed. By default, ioscan will display the list using the legacy view

(see intro (7)).

The

ioscan command scans the system in the agile view or the legacy view, depending on whether or

not the -N option is used, and lists all reportable hardware found. If ioscan cannot ﬁnd any hardware

based on the options and arguments speciﬁed, ioscan prints no information and exits with a return

value of 0 since the scan encountered no errors.

ioscan can also use its options to perform the following:

•

ioscan -N displays output using the agile view instead of the legacy view (see intro (7)).

•

ioscan -M forces the speciﬁed software driver into the kernel I/O system and forces software driver

to be bound. This option can be used to make the system recognize a device that cannot be recognized

automatically; for example, a device has not yet been connected to the system, the device does not sup-

port autoconﬁguration, or diagnostics need to be run on a faulty device.

•

ioscan -b, when used with the -M option, tries to do an online binding ﬁrst. If the driver does not

support online binding, binding will be deferred to the next boot. The hardware path speciﬁed for a

deferred binding operation must be a LUN hardware path of a node.

•

ioscan -t 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.

•

ioscan -P property displays the property of a node.

•

ioscan -m lun displays the mapping between LUN hardware path and the lunpath hardware

path.

•

ioscan -m dsf displays the mapping between legacy device special ﬁles and persistent device spe-

cial ﬁles (see intro (7)).

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
ioscan(1M) ioscan(1M) NAME ioscan - scan the I/O system SYNOPSIS /usr/sbin/ioscan [-N] [-k-u] [-e] [-d driver  -C class ] [-I instance ] [-H hw_path ] [l] [-A] [ -f[-n]  -F[-F][-n] ] [ devfile ] /usr/sbin/ioscan [-b] -M driver -H hw_path [-I instance ] /usr/sbin/ioscan -t /usr/sbin/ioscan -P property [-d driver  -C class ] [-I instance ] [-H hw_path ] [ devfile ] /usr/sbin/ioscan -m lun [-F] [-d driver  -C class ] [-I instance ] [-H lun hw_path ] [ devfile ] /usr/sbin/ioscan [-F] -m dsf [ devfile ]
PAGE 2
ioscan(1M) • ioscan(1M) ioscan -m hwpath displays the mapping between (legacy) hardware path, lunpath hardware path, and LUN hardware path. • ioscan -m cluster_dsf displays the mapping between cluster device special files, legacy device special files, and persistent device special files. • ioscan -m resourcepath displays the mapping between hardware path, physical location and resourcepath.
PAGE 3
ioscan(1M) ioscan(1M) In the agile view, EFI device paths are associated with the nodes which have class as lunpath. -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.
PAGE 4
ioscan(1M) ioscan(1M) lunpath hardware path will map to a legacy hardware path. cluster_dsf Display the mapping between the cluster, legacy and persistent device special files. Either a cluster, legacy or persistent special file can be specified as an argument. If none is specified, all valid mappings for character device special files are displayed. If the cluster special files are not available, the command simply returns with a return value of 0.
PAGE 5
ioscan(1M) ioscan(1M) number replacement. Online instance number replacement means that the instance number of a node can be modified without a system reboot. The is_inst_replaceable property can be set to one of the following values: True The driver corresponding to this node supports online instance number replacement. False The driver corresponding to this node does not support online instance number replacement.
PAGE 6
ioscan(1M) ioscan(1M) 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 , card instance , is_remote , EFI device path or PA device path , health , and alias_path . The additional field is_remote is displayed only when the -F option is specified twice (-FF or -F -F).
PAGE 7
ioscan(1M) hardware type ioscan(1M) 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 SCAN a scan operation is in progress for this node Entity identifier for the hardware component.
PAGE 8
ioscan(1M) ioscan(1M) Display lun to lunpath mapping. ioscan -m lun Display the mapping between (legacy) hardware path, lunpath hardware path and lun hardware path. ioscan -m hwpath Display the mapping between legacy device special file and persistent device special file. ioscan -m dsf Display the health property of all the nodes with the class name as disk in the agile view. ioscan -P health -C disk Display the error_recovery property of all the LBA nodes claimed by the lba driver in the agile view.