- -a slot_id
Prepare to add a card to system at the specified slot.
Critical resource analysis is run to ensure that the current card
addition onto the system will not cause disruption in the functioning of
the system. The driver scripts
(pref_replace
and
prep_replace)
for affected slots (if any) are run and the drivers associated with the
affected slots are suspended. The slot power is turned OFF, and the
attention LED at the corresponding slot is set to BLINK mode.
If the
-f
option is specified, it overrides critical analysis (CRA) results.
See the description for the
-f
option.
- -A slot_id
Post add phase. The slot power is turned ON, the drivers associated with
all affected slots are resumed.
ioscan
is run and if the card is
claimed, the driver scripts,
post_add
for the current slot and
post_replace
for affected slots (if any), are run and the attention LED
at the corresponding slot is turned OFF.
- -r slot_id
Prepare to replace a card on the system at the specified slot.
Critical resource analysis is run to ensure that the current card
replacement on the system will not cause disruption in the functioning of
the system. The driver scripts
(pref_replace
and
prep_replace)
for the affected slots (if any) and the current slot are run.
The drivers associated with the current slot and affected slots are suspended.
The target slot is powered off and the attention LED is set to BLINK at the
corresponding slot.
If the
-f
option is specified, it overrides critical analysis (CRA) results.
See the description earlier for the
-f
option.
- -R slot_id
Post Replace phase. The target slot power is turned ON. The suspended
drivers are resumed and the driver scripts
(post_replace)
for the current
slot and the affected slots (if any) are run. The attention LED at the
corresponding slot is set to OFF.
On systems with the capability to handle certain PCI
hardware errors during the operation of PCI I/O cards,
the post replace phase can be used to attempt recovery
of the PCI card and corresponding I/O slot from such
errors.
- -f
The
-f
option, if specified, overrides the "data critical" errors returned by CRA.
It is important to note that
olrad
will not allow "critical" errors to be overridden and that
olrad
automatically overrides "warnings".
Irrespective of whether
-f
is specified or not, critical resource analysis routines are run before
an OLA/R operation, to ensure that the current OLA/R operation does not
interrupt the normal working of the system; in other words, to identify
"critical" errors.
The "data critical" errors are typically not critical
to the system, but they may be critical to the user.
Hence, the user need to decide whether or not to
use the
-f
option for overriding these types of
errors.
- -F
Displays the output in machine readable format.
It can be used with the following options:
-q,
-c,
-h,
and
-v.
- -n
Display the number of OLA/R capable slots in the system.
- -q
Displays the status of all OLA/R capable slots in the system.
In the output, slots with the same bus number share the same
PCI Bus. Output fields are detailed below; some descriptions
are platform dependent.
On systems with OLA/R capable PCI-Express
slots, the output fields are slightly varied. See the
PCI Express Based Slots
section for detailed description of the fields displayed
for such slots.
Slot
displays the
slot_id.
Path
displays the
slot_hw_path.
Bus Number
identifies the I/O Bus corresponding to the slot.
Max Spd
displays the maximum operating speed of the
PCI Bus attached to the slot.
Spd
displays the current operating speed of the PCI Bus
attached to the slot. The card inserted into the slot
determines the current operating speed, together
with the capability of the slot's PCI Bus.
Pwr
displays the slot power status.
Occu
displays whether the slot is occupied or not.
Susp
displays if the card in the slot is suspended or not.
Driver(s) Capable
displays the OL* capability of the interface driver/s that
claimed the PCI device/s present in the slot.
OLAR
field displays whether the interface driver/s are capable
of OnLine Add/Replace operations.
OLD
field displays whether the interface driver/s are capable
of OnLine Deletion operation.
Max mode
displays the maximum operating mode of the
PCI Bus attached to the slot.
Mode
displays the current operating mode of the PCI Bus
attached to the slot. The card inserted into the slot
determines the current operating mode, together
with the capability of the slot's PCI Bus.
PCI and PCI-X are examples of different operating modes.
PCI Express Based Slots:
On systems with OLA/R capable PCI-Express slots, the
output fields are slightly varied. The detailed description
of the fields displayed for such slots are as mentioned below;
Max Link Spd
(Expressed in Giga Bits / Second) indicates the maximum
link speed possible for the PCI-Express Link at the slot.
Link Spd
(Expressed in Giga Bits / Second) indicates the negotiated
link speed of the PCI-Express Link at the slot.
Max Link Width
indicates the maximum link width supported by the PCI-Express
link at the slot.
For example:
x8
means the maximum link width supported by a PCI-Express link at
the slot is 8 lanes.
Link Width
indicates the negotiated width of the PCI-Express Link at the slot.
Mode
indicates the current operating mode of the slot. For PCI-Express
slots mode is displayed as "PCIe".
- -I flag slot_id
Controls the state of the Attention LED. The valid
values for this
flag
option are:
ATTN
and
OFF.
Based on the
flag
value, the
Attention LED at the corresponding slot is set to the appropriate
state. The flags are not case-sensitive.
- -P flag slot_id
Controls the state of the
power indicator. Currently, the only valid
value for this
flag
option is:
RAIL.
The
-P
option can be used with
RAIL
to set the power indicator to follow the specified slot's power state;
in other words, the power indicator is turned solid ON if the slot
power is ON, or the power indicator is turned OFF, if the slot
power is OFF.
The flag is not case sensitive.
- -p flag slot_id
Controls the slot power. The valid
value for this
flag
option are:
ON
and
OFF.
Based on the flag set, the slot power status
changes appropriately. The flags are not case sensitive.
- -C slot_id
Runs critical resource analysis routine (CRA) only on the specified
slot_id
and display the results.
It checks for critical resources on all affected hardware paths associated
with the specified slot. It analyzes file systems, volumes, processes,
networking, swap, and dump; and generates a report of affected resources.
It lists the severity levels and their meanings.
- CRA_SUCCESS
no affected resources in use.
- CRA_WARNINGS
resources in use on affected device(s) but none are deemed critical.
- CRA_DATA_CRITICAL
probable data loss, only proceed with the user's permission.
- CRA_SYS_CRITICAL
likely to bring down the user's system.
- CRA_ERROR
some internal CRA error encountered.
Users are advised to use this option first to check out whether the intended
OLA operation is safe and would not cause disruption in the functioning
of the system.
- -c slot_id
Displays the device information (Device_ID, Vendor_ID, Revision_ID, etc)
of all the interface devices at the indicated slot. Output fields
are detailed below, some descriptions are platform dependent.
Path
displays the hardware path of the device.
Name
displays the interface driver name that claimed the
device.
Device_ID
displays PCI Device ID of the device.
Vendor_ID
displays PCI Vendor ID of the device.
Subsystem_ID
displays PCI Subsystem ID of the device.
Subsystem_Vendor_ID
displays PCI Subsystem Vendor ID of the device.
Revision_ID
displays the PCI Revision ID of the device.
Class
displays the PCI Class of the device.
Status
displays the device status register.
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
indicate 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 normally 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 normally 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.