1.\" $NetBSD: intrctl.8,v 1.8 2021/02/22 11:38:13 jmcneill Exp $ 2.\" 3.\" Copyright (c) 2015 Internet Initiative Japan Inc. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25.\" POSSIBILITY OF SUCH DAMAGE. 26.\" 27.Dd February 22, 2021 28.Dt INTRCTL 8 29.Os 30.Sh NAME 31.Nm intrctl 32.Nd program to control interrupts 33.Sh SYNOPSIS 34.Nm intrctl 35.Ar command 36.Op Ar options 37.Sh DESCRIPTION 38The 39.Nm 40command can be used to control and inspect the state of interrupts 41in the system. 42.Pp 43The first argument, 44.Ar command , 45specifies the action to take. 46Valid commands are: 47.Bl -tag -width XofflineXcpunoX 48.It affinity Fl c Ar cpu_index Fl i Ar intrid 49set an 50.Ar intrid 51interrupt's affinity to 52.Ar cpu_index . 53.It intr Fl c Ar cpu_index 54enable to set an interrupt's affinity to 55.Ar cpu_index . 56If 57.Ar cpu_index 58is already enabled, this command has no effect. 59.It list Oo Fl cz Oc Oo Fl w Ar wait Oc 60for each intrid in the system, display interrupt counts per CPU. 61The intrid is an interrupt name such as "ioapic0 pin 22" for x86. 62.Pp 63If 64.Fl c 65is specified, display compact list with total counts per interrupt, 66and CPU affinity as list of CPU indexes. 67.Pp 68If 69.Fl w 70is specified then 71.Nm 72display the data continuously with a 73.Ar wait 74seconds delay between each iteration. 75.Pp 76If 77.Fl z 78is specified then rows with all CPUs having zero interrupts will be skipped. 79.It nointr Fl c Ar cpu_index 80disable to set an interrupt's affinity to 81.Ar cpu_index . 82If 83.Ar cpu_index 84is already disabled, this command has no effect. 85.El 86.Sh SEE ALSO 87.Xr cpuctl 8 88.Sh HISTORY 89.Nm 90first appeared in 91.Nx 8.0 . 92.Sh AUTHORS 93.An Kengo NAKAHARA Aq Mt knakahara@NetBSD.org 94