HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

o
olrad(1M) olrad(1M)
Command displays the device command register.
Multi-func displays if this is one of the multiple functions on the PCI device.
Bridge displays if the device is a PCI-to-PCI bridge device.
Capable_66Mhz displays if the device is capable of operating at 66 MHz frequency.
Power_Consumption
displays the power consumption of the device.
Capable_Frequency
displays the bus frequency at which the device is capable of
running.
-e slot_id Lists the affected slot IDs for the specified slot.
-h slot_id Displays the hardware paths of the interface node(s) for the specified slot.
-g hw_path Displays the slot ID for the specified hardware path.
-v hw_path Displays driver information, such as current state, time-out, etc. Output fields are
detailed below.
Name displays the interface driver name.
State displays the interface driver state. State will be RUNNING if the driver is
active. State will be SUSPENDED if the driver is suspended. When the driver is in a
transition state (say from RUNNING state to SUSPENDED state), this field will indi-
cate a state change in progress. For the rare occurrence of any internal errors during a
driver state transition, this field will indicate an operation timed out status.
Suspend time displays the approximate time required to suspend the interface
driver. The value displayed accounts for worst case scenarios, and the time taken would
normally be less than this.
Resume time displays the approximate time required to resume the interface driver.
The value displayed accounts for worst case scenarios, and the time taken would nor-
mally be less than this.
Remove time displays the approximate time required to delete the driver instance.
The value displayed accounts for worst case scenarios, and the time taken would nor-
mally be less than this. This field will be valid only if the target operating environment
supports OnLine Deletion.
Error time field is for future enhancements.
When performing an OL* operation on a slot, olrad runs pref_replace and prep_replace scripts
in the pre-OL* phase and post_add and post_replace driver scripts in post-OL* phase.
There are no preface and prepare driver scripts for OLA (online add).
For a given OL* operation on a slot, pref_replace driver scripts are run for the affected slots (if any)
irrespective of the type of operation being performed on the given slot.
An audit trail is logged onto NetTL log file whenever an OLA/OLR operation is initiated. This information
is also written to standard output.
PCI Error Handling
Some systems have the capability to handle certain PCI hardware errors during the operation of PCI I/O
cards. When such errors occur, the operating system will suspend the corresponding card and I/O slot.
The software states of the components in error will be marked ERROR in ioscan(1M) output. If this
scenario occurs, the following sequence can be tried from the olrad command to attempt a recovery of the
slot:
1) If the slot remains powered ON, power it OFF using:
olrad -p OFF slot_id
2) If the power OFF succeeds, try a post replace operation at the slot using:
olrad -R slot_id
If the card/slot is recovered from the error and the post replace operation succeeds, software states of
the components recovered from the error will be restored to CLAIMED in ioscan(1M) output. If the
post replace operation fails and the error persists, one of the reasons could be that the card has gone
HP-UX 11i Version 2: December 2007 Update − 4 − Hewlett-Packard Company 121