1intrstat(1M) System Administration Commands intrstat(1M)
2
3
4
6 intrstat - report interrupt statistics
7
9 /usr/sbin/intrstat [-c cpulist | -C processor_set_id] [-T u | d ]
10 [-x opt[=val]] [interval [count]]
11
12
14 The intrstat utility gathers and displays run-time interrupt statis‐
15 tics. The output is a table of device names and CPU IDs, where each row
16 of the table denotes a device, and each column of the table denotes a
17 CPU. Each cell in the table contains both the raw number of interrupts
18 for the given device on the given CPU, and the percentage of absolute
19 time spent in that device's interrupt handler on that CPU.
20
21
22 The device name is given in the form of {name}#{instance}. The name is
23 the normalized driver name, and typically corresponds to the name of
24 the module implementing the driver. See ddi_driver_name(9F). Many Sun-
25 delivered drivers have their own manual pages. See Intro(7).
26
27
28 If standard output is a terminal, the table contains as many columns of
29 data as can fit within the terminal width. If standard output is not a
30 terminal, the table contains at most four columns of data. By default,
31 data is gathered and displayed for all CPUs. If the data cannot fit in
32 a single table, it is printed across multiple tables. The set of CPUs
33 for which data is displayed can be optionally specified with the -c or
34 -C option.
35
36
37 By default, intrstat displays data once per second and runs indefi‐
38 nitely. Both of these behaviors can be optionally controlled with the
39 interval and count parameters, respectively. See OPERANDS.
40
41
42 Because intrstat uses dynamic discovery, it reports only on devices
43 that raise interrupts while the command is running. Any devices that
44 are silent while intrstat is running are not displayed.
45
46
47 intrstat induces a small system-wide performance degradation. As a
48 result, only the super-user can run intrstat by default. The Solaris
49 Dynamic Tracing Guide explains how administrators can grant privileges
50 to other users to permit them to run intrstat.
51
53 The following options are supported:
54
55 -c cpulist
56
57 Displays data for the CPUs specified by cpulist.
58
59 cpulist can be a single processor ID (for example, 4), a range of
60 processor IDs (for example, 4-6), or a comma separated list of pro‐
61 cessor IDs or processor ID ranges (for example, 4,5,6 or 4,6-8).
62
63
64 -C processor_set_id
65
66 Displays data for the CPUs in the processor set specified by pro‐
67 cessor_set_id.
68
69 intrstat modifies its output to always reflect the CPUs in the
70 specified processor set. If a CPU is added to the set, intrstat
71 modifies its output to include the added CPU. If a CPU is removed
72 from the set, intrstat modifies its output to exclude the removed
73 CPU. At most one processor set can be specified.
74
75
76 -T u | d
77
78 Display a time stamp.
79
80 Specify u for a printed representation of the internal representa‐
81 tion of time. See time(2). Specify d for standard date format. See
82 date(1).
83
84
85 -x opt[=val]
86
87 Enable or modify a DTrace runtime option or D compiler option. The
88 list of options is found in the Solaris Dynamic Tracing Guide. A
89 boolean option is enabled by specifying its name. Options with val‐
90 ues are set by separating the option name and value with an equal
91 sign (=)
92
93
95 The following operands are supported:
96
97 count
98
99 Indicates the number of intervals to execute before exiting.
100
101
102 interval
103
104 Indicates the number of seconds to be executed before exiting.
105
106
108 Example 1 Using intrstat Without Options
109
110
111 Without options, intrstat displays a table of trap types and CPUs. At
112 most, four columns can fit in the default terminal width. If there are
113 more than four CPUs, multiple tables are displayed.
114
115
116
117 The following example runs intrstat on a uniprocessor Intel IA/32-based
118 laptop:
119
120
121 example# intrstat
122 device | cpu0 %tim
123 -----------------+---------------
124 ata#0 | 166 0.4
125 ata#1 | 0 0.0
126 audioi810#0 | 6 0.0
127 i8042#0 | 281 0.7
128 iprb#0 | 6 0.0
129 uhci#1 | 6 0.0
130 uhci#2 | 6 0.0
131
132 device | cpu0 %tim
133 -----------------+---------------
134 ata#0 | 161 0.5
135 ata#1 | 0 0.0
136 audioi810#0 | 6 0.0
137 i8042#0 | 303 0.6
138 iprb#0 | 6 0.0
139 uhci#1 | 6 0.0
140 uhci#2 | 6 0.0
141 ...
142
143
144
146 See attributes(5) for descriptions of the following attributes:
147
148
149
150
151 ┌─────────────────────────────┬─────────────────────────────┐
152 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
153 ├─────────────────────────────┼─────────────────────────────┤
154 │Availability │SUNWdtrc │
155 ├─────────────────────────────┼─────────────────────────────┤
156 │Interface Stability │See below. │
157 └─────────────────────────────┴─────────────────────────────┘
158
159
160 The command-line syntax is Evolving. The human-readable output is
161 Unstable.
162
164 dtrace(1M), trapstat(1M), attributes(5), Intro(7), ddi_driver_name(9F)
165
166
167 Solaris Dynamic Tracing Guide
168
169
170
171SunOS 5.11 16 Jun 2009 intrstat(1M)