HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

i
intctl(1M) intctl(1M)
0/0/0/2/0 ext_bus c8xx 0 3 0 T 2 SCSI C1010
Ultra Wide Single-Ended
30L1
0/0/0/2/1 ext_bus c8xx 0 2 0 T 2 SCSI C1010
Ultra Wide Single-Ended
20L1
hw path A numerical string of hardware components separated by slash (/), to represent a bus con-
verter. The first component in the hardware path is the cell (for a cell based system) or the
system bus adapter (for a non-cell based system). The system bus adapter is followed by the
address of the local bus adapter and the interface card. Subsequent numbers are separated
by periods (.). Each number represents the location of a hardware component on the path of
the device.
class The class of the interface card, for example, lan, tty, ext_bus.
drv name The driver associated with the card.
card cell The cell number of the cell that the card is connected to.
cpu ID An integer value representing the identity of the CPU that the card’s interrupt is assigned
to.
cpu cell The cell number of the cell that the CPU is connected to.
intr type A character representing the interrupt type:
L line based interrupt
T transaction based interrupt
M MSI based interrupt
X MSI-X based interrupt
intr ID The identity of the interrupt to be moved.
card description A brief description of the interface card.
cpu path The hardware path of the CPU (relevant with -s and -r option).
cpu state Integer value representing the state of the CPU: ENABLED(0), DISABLED(1) or
RESERVED(2) (relevant with -s, -r, and -l options). These states are interrupt states
and do not have any relationship to the thread state.
ENABLED The CPU is capable of receiving external interrupts from interface cards.
DISABLED The CPU cannot handle external interrupts from interface cards.
RESERVED The state is reserved to receive interrupts from specific cards, e.g., for RTE
(Real Time Extensions) some processors are reserved specifically to handle
interrupts from RTE cards.
Redirection
The intctl command allows the performance specialist to modify the interrupt assignment of an inter-
face card. The user must specify the hardware path of interface card, the interrupt ID that needs to be
moved, and the new CPU ID that the interrupt will be routed to.
When an interrupt is moved from one CPU to another, if the interrupt shares a line with other interrupts,
all the interrupts on that line will be moved to the specified CPU. The kernel will add a message to the
/var/adm/syslog/syslog.log file which will contain the hardware path and interrupt IDs of the
interrupts being moved and the CPU ID of the CPU to which these interrupts were moved.
When migrating an interrupt from one CPU to another, if the card to which the interrupt belongs is in
timed-out state, from either a SUSPEND or RESUME operation (see olrad(1M)), then the interrupt will
not be moved. If an interrupt shares a line with other interrupts, and if any of the cards is in timed-out
state, then none of the interrupts on the line will be moved to the specified CPU.
Saving & Restoring System Interrupt Configurations
The intctl command can save and restore the system interrupt configuration in a user specified file.
Before restoring the configuration, the intctl command checks to see if the system setup has changed by
checking that all the interface cards and CPUs from the saved configuration are still present in the system
HP-UX 11i Version 3: February 2007 − 3 − Hewlett-Packard Company 361