Manual Pages for UNIX Operating System command usage for man intrstat

System Administration Commands                       intrstat(1M)



NAME
     intrstat - report interrupt statistics

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


DESCRIPTION
     The intrstat utility gathers and displays run-time interrupt
     statistics.  The  output  is a table of device names and CPU
     IDs, where each row of the table denotes a device, and  each
     column  of  the  table denotes a CPU. Each cell in the table
     contains both the raw number of  interrupts  for  the  given
     device on the given CPU, and the percentage of absolute time
     spent in that device's interrupt handler on that CPU.


     The device name is given in the form  of  {name}#{instance}.
     The  name  is  the  normalized  driver  name,  and typically
     corresponds to the  name  of  the  module  implementing  the
     driver.  See ddi_driver_name(9F). Many Sun-delivered drivers
     have their own manual pages. See Intro(7).


     If standard output is a terminal, the table contains as many
     columns  of  data  as  can fit within the terminal width. If
     standard output is not a terminal,  the  table  contains  at
     most  four columns of data. By default, data is gathered and
     displayed for all CPUs. If the data cannot fit in  a  single
     table, it is printed across multiple tables. The set of CPUs
     for which data is displayed can be optionally specified with
     the -c or -C option.


     By default, intrstat displays data once per second and  runs
     indefinitely. Both of these behaviors can be optionally con-
     trolled with the  interval  and  count  parameters,  respec-
     tively. See OPERANDS.


     Because intrstat uses dynamic discovery, it reports only  on
     devices  that raise interrupts while the command is running.
     Any devices that  are silent while intrstat is  running  are
     not displayed.


     intrstat induces a small  system-wide  performance  degrada-
     tion.  As  a result, only the super-user can run intrstat by
     default. The Solaris  Dynamic  Tracing  Guide  explains  how
     administrators can grant privileges to other users to permit
     them to run intrstat.



SunOS 5.11          Last change: 16 Jun 2009                    1






System Administration Commands                       intrstat(1M)



OPTIONS
     The following options are supported:

     -c cpulist

         Displays data for the CPUs specified by cpulist.

         cpulist can be a single processor ID (for example, 4), a
         range  of  processor  IDs (for example, 4-6), or a comma
         separated list of processor IDs or processor  ID  ranges
         (for example, 4,5,6 or 4,6-8).


     -C processor_set_id

         Displays data for the CPUs in the processor  set  speci-
         fied by processor_set_id.

         intrstat modifies its output to always reflect the  CPUs
         in the specified processor set. If a CPU is added to the
         set, intrstat modifies its output to include  the  added
         CPU. If a CPU is removed from the set, intrstat modifies
         its output to exclude the removed CPU. At most one  pro-
         cessor set can be specified.


     -T u | d

         Display a time stamp.

         Specify u for a printed representation of  the  internal
         representation of time. See time(2). Specify d for stan-
         dard date format. See date(1).


     -x opt[=val]

         Enable or modify a DTrace runtime option or  D  compiler
         option.  The  list  of  options  is found in the Solaris
         Dynamic Tracing Guide. A boolean option  is  enabled  by
         specifying  its  name.  Options  with  values are set by
         separating the option name and value with an equal  sign
         (=)


OPERANDS
     The following operands are supported:

     count

         Indicates the number  of  intervals  to  execute  before
         exiting.



SunOS 5.11          Last change: 16 Jun 2009                    2






System Administration Commands                       intrstat(1M)



     interval

         Indicates the number of seconds to  be  executed  before
         exiting.


EXAMPLES
     Example 1 Using intrstat Without Options


     Without options, intrstat displays a table of trap types and
     CPUs.  At most, four columns can fit in the default terminal
     width. If there are more than four CPUs, multiple tables are
     displayed.



     The following example runs intrstat on a uniprocessor  Intel
     IA/32-based laptop:


       example# intrstat
                      device |      cpu0 %tim
            -----------------+---------------
                       ata#0 |       166  0.4
                       ata#1 |         0  0.0
                 audioi810#0 |         6  0.0
                     i8042#0 |       281  0.7
                      iprb#0 |         6  0.0
                      uhci#1 |         6  0.0
                      uhci#2 |         6  0.0

                      device |      cpu0 %tim
            -----------------+---------------
                       ata#0 |       161  0.5
                       ata#1 |         0  0.0
                 audioi810#0 |         6  0.0
                     i8042#0 |       303  0.6
                      iprb#0 |         6  0.0
                      uhci#1 |         6  0.0
                      uhci#2 |         6  0.0
            ...



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







SunOS 5.11          Last change: 16 Jun 2009                    3






System Administration Commands                       intrstat(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | developer/dtrace            |
    |_____________________________|_____________________________|
    | Interface Stability         | See below.                  |
    |_____________________________|_____________________________|



     The command-line syntax  is  Committed.  The  human-readable
     output is Uncommitted.

SEE ALSO
     dtrace(1M),    trapstat(1M),    attributes(5),     Intro(7),
     ddi_driver_name(9F)


     Solaris Dynamic Tracing Guide




































SunOS 5.11          Last change: 16 Jun 2009                    4