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

i
intctl(1M) intctl(1M)
-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
interface cards on the system.
When used with the
-C class option, -H
displays information about all interface cards con-
nected to the path and which belong to the specified class.
When used with the
-M option,
-H hw_path specifies the hardware path of the interrupt
that needs to be moved to a different CPU.
-i While balancing interrupts, it may be desirable to avoid some interrupt assignments based
on the I/O cards, CPUs, and so on. Multiple parameters can be specified by using the
-i
option multiple times.
NOTE: Specifying many parameters may reduce the scope of balancing interrupts and
may cause interrupt distribution imbalance.
• Ignore I/O Card Interrupt (-i io
:hw_path:intr_id)
While balancing interrupts, interrupt intr_id associated with this I/O card at the
hardware path hw_path will not be migrated. intr_id represents a specific interrupt id
or all interrupt ids of the specified I/O card if
-1 is used. These values can also be
specified in the configuration file section INTCTL_HW_IGNORE.
• Ignore CPU (
-i cpu:hw_path)
None of the interrupts assigned to the CPU with the specified hw_path will be migrated
while balancing interrupts. Also, no new interrupts will be assigned to these CPUs
while balancing interrupts. The same information can be specified in the
INTCTL_CPU_IGNORE section of the configuration file.
• Ignore Driver (
-i drv:driver_name)
None of the I/O cards claimed by the driver driver_name will be selected for interrupt
migrations while balancing interrupts. Care needs to be taken while specifying a
driver_name as one driver could possibly claim multiple I/O cards and specifying such a
driver will reduce the scope of balancing of interrupts. The same information can be
specified in the INTCTL_DRV_IGNORE section of the configuration file.
NOTE: Please refer to the INTCTL_DRV_IGNORE section of the configuration file for
drivers that are currently not supported while balancing interrupts.
-I intr_id Used with -M option to specify the interrupt ID of the interrupt to be moved.
-M Migrate an interrupt to a specified CPU. This option must be specified with the
-H, -I, -c options.
The -M option should be specified first in the command line followed by the remaining
options which can be specified in any order.
-o This option can be used for overriding some existing parameters from the configuration file
or for specifying new parameters.
• Override driver weight information (-o drv:driver_name:weight)
Specify a new driver weight or override an existing driver weight specified in the
configuration file. driver_name is the driver name of an existing driver in the
configuration file section INTCTL_DRIVER_WEIGHTS or a new driver name. weight is
the interrupt load that the driver may generate.
NOTE: All I/O card drivers present on the system but not specified in the
INTCTL_DRIVER_WEIGHTS section of the configuration file will be assigned a default
weight of 10.
• Override the trigger for balancing of interrupts (
-o
trig
:balance_on_cpu:distribute_to_cpu)
Using this option, the user can override the configuration file setting
INTCTL_BALANCE_TRIGGER. These values determine when the interrupts will be
balanced and the scope of balancing of interrupts.
balance_on_cpu is the minimum percentage of available number of CPUs that should be
handling interrupts. Balancing of interrupts will start only if the number of CPUs
HP-UX 11i Version 2: December 2007 Update − 3 − Hewlett-Packard Company 403