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

i
intctl(1M) intctl(1M)
NAME
intctl - manage the interrupt configuration of the system
SYNOPSIS
/usr/sbin/intctl
[-h | -F | -p | -c cpu_id]
/usr/sbin/intctl
[-C class][-H hw_path]
/usr/sbin/intctl
[[-w] -M -H hw_path -I
intr_id -c cpu_id]
/usr/sbin/intctl
[[-w] -M -H hw_path
-f file]
/usr/sbin/intctl
[-r file | -s file]
/usr/sbin/intctl
[-l [cell_id]]
DESCRIPTION
A processor receives an interrupt when either the processor’s interrupt pin is asserted (for line based inter-
rupts) or if a processor detects an interrupt message bus transaction on the system bus (for transaction
based interrupts).
Interrupts from the interface cards can be line or transaction based. Interrupts are routed to different pro-
cessors during boot time.
The
intctl command is a tool that allows a performance expert to display and modify these interrupt
assignments. The tool only supports migration of external device interrupts. The performance analyst can
also save and restore the interrupt configuration. If interrupt migration process completes successfully, a
message is logged to the console and/or to the /var/adm/syslog/syslog.log
file.
intctl resides in /usr/sbin/bin (a symbolic link exists in
/usr/contrib/bin), and the com-
mand can be executed only by the super user. The
intctl command is not a general system administra-
tion command. It should be used only by performance tuning experts with a high level of system
knowledge. The performance specialist can use the intctl command to view the interrupt configuration
of the system and modify the interrupt assignments of the CPUs to re-distribute the system load across the
CPUs.
intctl is synchronized with other High Availability (HA) events happening simultaneously on the sys-
tem. An HA event can be a PCI OLA/R or Processor allocation/de-allocation. If any of these events are hap-
pening when intctl is trying to display interrupt information or is trying to migrate an interrupt to a
CPU, intctl will exit with the error message, "Another HA event is in progress, try
again!"
and the user should retry the command.
Non-MP safe drivers do not support interrupt migration. The tool will display an error message if the user
tries to move the interrupts of a non-MP safe driver to a different CPU.
On a system with virtual partitions (vPars), intctl will only display CPUs in the current partition. A
CPU belonging to a partition can be either a bound or a floater CPU. A bound CPU is bound to the partition
and the interrupt state of these CPUs can be either ENABLED, DISABLED or RESERVED for interrupts.
Floater CPUs are not bound to the partition and the state of these CPUs is DISABLED; interrupts cannot
be assigned to these CPUs. A bound CPU in DISABLED state can be ENABLED for interrupts through the
PSETS interface. To get more information about the state of a floater CPU belonging to other partitions,
the performance expert can use the vPars
vparstatus command.
Options
By default, the command displays interrupt information about all the interface cards on the system.
intctl recognizes the following options:
-c cpu_id By itself (without any other options), display interrupt information about the specified
CPU.
When used with the -M option, -c cpu_id specifies the CPU ID of the CPU to which the
interrupt is to be moved.
-C class Display interrupt information about all the interface cards belonging to the specified class.
Can be used with the -H hw_path option to display interrupt information about the inter-
face card under the hw_path that belongs to the specified class.
-f file Migrate several interrupts of the specified hardware path. Each entry in the file is of the
form intr_id cpu_id followed by another entry on a new line.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 359