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

i
intctl(1M) intctl(1M)
handling the interrupts is less than this percentage. A value 100 will always trigger
balancing of interrupts, but if the system is optimally balanced with respect to interrupt
distribution then it may not result in any interrupt migrations. The default value is 50.
distribute_to_cpu is the percentage of available number of CPUs that should be handling
interrupts. Balancing of interrupts would distribute interrupts across this percentage of
available number of CPUs. The default value is 75.
NOTE: If WLM (Work Load Manager) is configured to load balance across partitions by
migrating CPUs, it is desirable not to set this value to more than 75.
-p Display interrupt information about all the CPUs on the system in a long format with spac-
ing in between the fields.
-r file Restore the system interrupt configuration from the specified file, file. The interrupt
configuration is restored only if all the interface cards and CPUs referenced in the saved
configuration file are still present on the system and the CPUs are in the same state as in
the saved configuration. If new cards and new CPUs are added to the system,
intctl
will continue to restore the interrupt configuration as long as the old configuration has not
changed.
intctl will fail to restore the interrupt configuration if the file permission is
not 0600.
In restoring the system configuration, the command will assign interrupts from the inter-
face cards to the CPUs as specified in the file.
-s file Save the system interrupt configuration to the specified file, file, with file permission 0600.
If the file exists, the content of the file will be overwritten and the file permissions will be
changed to 0600. The command will store the interrupt information of all the CPUs on the
system. This file can be used to restore the interrupt configuration of the system later
using the
-r option.
-w Force migrations without asking for user input. Without this option, a user confirmation is
requested while balancing interrupts (option
-b). When used with -b, -w allows the user
to balance interrupts without asking for migrations that should be skipped.
Interrupt Configuration Display
The interrupt configuration can be displayed sorted by CPU ID (
intctl -p) or sorted by interface card
hardware path (
intctl -H hw_path).
By default, the command displays interrupt information about all the interface cards on the system. Here
is a sample interrupt configuration display, and the fields are explained below.
hw path class drv card cpu cpu intr intr card
name cell ID cell type ID description
=======================================================================
0/0/0/0 lan btlan N/A 0 N/A L 5 HP PCI
10/100Base-TX Core
0/0/1/0 ext_bus c720 N/A 0 N/A L 0 SCSI C895 Fast
Wide LVD
0/0/2/0 ext_bus c720 N/A 0 N/A L 1 SCSI C87x Ultra
Wide Single-Ended
0/0/2/1 ext_bus c720 N/A 0 N/A L 2 SCSI C87x Ultra
Wide Single-Ended
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, such as: lan, tty, ext_bus.
drv name The driver associated with the card.
card cell The cell number of the cell to which the card is connected.
cpu ID An integer value representing the identity of the CPU to which the card’s interrupt is
assigned.
404 Hewlett-Packard Company − 4 − HP-UX 11i Version 2: December 2007 Update