intrstat man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

intrstat(1M)		System Administration Commands		  intrstat(1M)

NAME
       intrstat - report interrupt statistics

SYNOPSIS
       /usr/sbin/intrstat [-c cpulist | -C processor_set_id]
	   [interval [count]]

DESCRIPTION
       The  intrstat  utility  gathers and displays run-time interrupt statis‐
       tics. 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 indefi‐
       nitely. Both of these behaviors can be optionally controlled  with  the
       interval and count parameters, respectively. 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 degradation. 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.

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 pro‐
	   cessor 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 specified  by  pro‐
	   cessor_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 processor set can be specified.

OPERANDS
       The following operands are supported:

       count

	   Indicates the number of intervals to execute before exiting.

       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 attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWdtrc			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │See below.		   │
       └─────────────────────────────┴─────────────────────────────┘

       The command-line syntax	is  Evolving.  The  human-readable  output  is
       Unstable.

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

       Solaris Dynamic Tracing Guide

SunOS 5.10			  9 Jul 2007			  intrstat(1M)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net