intctl.1m (2010 09)

intctl(1M) intctl(1M)

Migrate the interrupt with ID 1, coming from the card whose hardware path is

0/4/0/0/5/0 to CPU 3:

intctl -M -H 0/4/0/0/5/0 -I 1 -c 3

Migrate interrupts of the card whose hardware path is

0/4/0/1 as speciﬁed by the entries in the ﬁle

intr_assign.

intctl -M -H 0/4/0/1 -f intr_assign

Store the system interrupt conﬁguration to

myconfig;ifmyconfig already exists, its contents are

overwritten:

intctl -s myconfig

Restore the system interrupt conﬁguration from

myconfig:

intctl -r myconfig

Display all the CPUs available in cell_id 2

intctl -l 2

Balance interrupts using the driver_weight

algorithm and without user conﬁrmation:

intctl -b -w -a driver_weight

Balance interrupts only if less than 40% of the available CPUs are handling interrupts, and distribute the

interrupts across 75% of the CPUs available:

intctl -b -w -o trig:40:75

Balance interrupts ignoring all interrupts of the I/O card with hardware path 1/2/1/0, ignore the CPU

with hardware path 133/2, and ignore the driver graf1; also, ask for conﬁrmation before performing

interrupt migrations:

intctl -b -i io:1/2/1/0:-1 -i cpu:133/2 -i drv:graf1

Balance interrupts according to the conﬁguration ﬁle, but add a new driver graf

with weight 300 and

change the weight of existing

btlan driver from 10 (speciﬁed in the conﬁguration ﬁle) to 15:

intctl -b -o drv:graf:300 -o drv:btlan:15

Balance interrupts if the current percentage of number of available CPUs handling interrupts is below

60% and distribute the interrupts across 80% of number of available CPUs the system:

intctl -b -o trig:60:80

WARNINGS

The intctl command can be executed only by the superuser. The intctl command should be used

only by performance analysts for performance tuning purposes. If care is not taken to redistribute the

interrupts properly, a decrease in the overall system performance could occur by overloading some pro-

cessors and by not optimally utilizing the remaining processors.

FILES

/etc/intctl.conf intctl interrupt conﬁguration ﬁle. See the Interrupt Conﬁguration File sec-

tion above.