intctl.1m (2010 09)

i
intctl(1M) intctl(1M)
configuration file.
NOTE: Refer to the
INTCTL_DRV_IGNORE
section of the /etc/intctl.conf
configuration file for other drivers that are currently not supported while balancing inter-
rupts.
Refer also to the Interrupt Configuration Display and Interrupt Configuration File sec-
tions of this manpage for more interrupt configuration information.
-I intr_id Specify the interrupt ID of the interrupt to be moved or migrated (to be used with the
-M
option).
-l [cell_id] Display the CPUs available in the specified Cell. The cell_id is an optional argument. If
cell_id is not specified,
intctl will display the CPUs available in all the Cells.
-M Migrate an interrupt to a specified CPU. The
-M option must be specified first followed
by a combination of
-H, -I
, and -c options or followed by a combination of -H, -I
, and
-f options. An additional -w
option can be specified with either of the two combinations
to force migration of interrupts without asking for user input.
If the CPU specified is not the preferred CPU for migration, the migration can potentially
impact the performance. In that scenario, an appropriate warning message and a prompt
is displayed to the user. The warning message asks for confirmation before proceeding
with the migration. The warning message also displays a list of CPU IDs that are pre-
ferred by this interrupt. Note that this list of CPU IDs might also include CPU IDs of
those CPUs that are currently not configured in the system.
-o Override existing parameters specified in the interrupt configuration file which is
explained in the Interrupt Configuration File section of this manpage. This option can
also be used for specifying new parameters.
• Override driver weight information
(
-o drv:driver_name:weight).
Specify a new driver weight or override an existing driver weight. driver_name is
either the existing driver in the
INTCTL_DRIVER_WEIGHTS
section of the interrupt
configuration file or a new driver name. weight is the interrupt load that the driver
may generate. Refer also to the
-a option explanation of driver weight.
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
).
The balance_on_cpu and the distribute_to_cpu percentage values determine when the
interrupts will be balanced and the scope of balancing 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
handling the interrupts is less than this percentage. A value 100 will always trigger
balancing of interrupts. However, if the system is optimally balanced with respect to
interrupt distribution, then there might not be any interrupt migrations. The default
value is
50. For example, if there are 4 CPUs and balance_on_cpu is set to 50, then
the actual balancing of interrupts will start when the number of CPUs currently han-
dling the interrupts is less than 2 (50% of 4 CPUs).
distribute_to_cpu is the percentage of available number of CPUs that should be han-
dling interrupts. Balancing of interrupts distribute interrupts across this percentage
of available number of CPUs. The default value is
75. For example, if there are 4
CPUs and distribute_to_cpu is set to 75, then the interrupts are distributed among a
maximum of 3 CPUs (75% of 4 CPUs).
NOTE: If WLM (Work Load Manager) is configured to load balance across partitions
by migrating CPUs, HP recommends that distribute_to_cpu should not be set to more
than 75. That is, it should be set to 75 or less.
-p Display interrupt information about all the CPUs on the system in a long format with
spacing in between the fields.
4 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: September 2010