HP-UX Reference (11i v2 03/08) - 1M System Administration Commands A-M (vol 3)

i
intctl(1M) intctl(1M)
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
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.
cpu_state Integer value representing the state of the CPU: ENABLED(0), DISABLED(1) or
RESERVED(2). 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 that the interrupt belongs to is in an
erroneous or timed out state, the interrupt will not be moved. If an interrupt shares a line with other
interrupts, and if any of the cards is in an erroneous 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 and that the CPUs are in the same state as in the saved configuration. The command will continue
to restore the configuration if new cards or CPUs have been added to the system since the interrupt
configuration was saved.
RETURN VALUE
Exit values are:
0 Successful completion.
>0 An error condition occurred.
EXAMPLES
Display information about all interface cards which belong to the class
lan:
intctl -C lan
Display the interrupt information of the card with hardware path 0/4/0/0/5/0:
intctl -H 0/4/0/0/5/0
Display interrupt information of all the interface cards under the path, 0/4:
intctl -H 0/4
Section 1M−−326 Hewlett-Packard Company − 3 − HP-UX 11i Version 2: August 2003