intrstat(1m)

1intrstat(1M)            System Administration Commands            intrstat(1M)
2
3
4

NAME

6       intrstat - report interrupt statistics
7

SYNOPSIS

9       /usr/sbin/intrstat [-c cpulist | -C processor_set_id] [-T u | d ]
10            [-x opt[=val]] [interval [count]]
11
12

DESCRIPTION

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

OPTIONS

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

OPERANDS

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

EXAMPLES

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

ATTRIBUTES

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