HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

i
intctl(1M) intctl(1M)
NAME
intctl - manage the interrupt configuration of the system
SYNOPSIS
/usr/contrib/bin/intctl
[-h
| -F | -p | -c cpu_id]
/usr/contrib/bin/intctl
[-C
class][-H hw_path]
/usr/contrib/bin/intctl
[-M -H
hw_path -I intr_id -c cpu_id]
/usr/contrib/bin/intctl
[
-r file | -s file]
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/contrib/bin
, and the command can be executed only by the super user. The
intctl command is not a general system administration command. It should be used only by perfor-
mance 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.
Interrupt migration functionality is not enabled for systems with RAID. Also 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 Produce a compact listing of fields separated by colons.
-h Display the usage of the command.
-H hw_path Display interrupt information about all interface cards connected at the specified hardware
path. For hardware paths / and 0, intctl prints the interrupt information about all the
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−377