[mirror_ubuntu-bionic-kernel.git] / Documentation / perf_counter / Documentation / perf-stat.txt

perf-stat(1)
==========

NAME
----
perf-stat - Run a command and gather performance counter statistics

SYNOPSIS
--------
[verse]
'perf stat' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>

DESCRIPTION
-----------
This command runs a command and gathers performance counter statistics
from it.


OPTIONS
-------
<command>...::
	Any command you can specify in a shell.

-e::
--event=::
                             0:0: cpu-cycles          
                             0:0: cycles              
                             0:1: instructions        
                             0:2: cache-references    
                             0:3: cache-misses        
                             0:4: branch-instructions 
                             0:4: branches            
                             0:5: branch-misses       
                             0:6: bus-cycles          
                             1:0: cpu-clock           
                             1:1: task-clock          
                             1:2: page-faults         
                             1:2: faults              
                             1:5: minor-faults        
                             1:6: major-faults        
                             1:3: context-switches    
                             1:3: cs                  
                             1:4: cpu-migrations      
                             1:4: migrations          
                           rNNN: raw PMU events (eventsel+umask)

-a::
        system-wide collection

-l::
        scale counter values

Configuration
-------------

EXAMPLES
--------

$ perf stat sleep 1

 Performance counter stats for 'sleep':

       0.678356  task clock ticks     (msecs)
              7  context switches     (events)
              4  CPU migrations       (events)
            232  pagefaults           (events)
        1810403  CPU cycles           (events)
         946759  instructions         (events)
          18952  cache references     (events)
           4885  cache misses         (events)

 Wall-clock time elapsed:  1001.252894 msecs

SEE ALSO
--------
linkperf:git-tops[1]
Commit	Line	Data
1d8c8b20 IM	1	perf-stat(1)
	2	==========
	3
	4	NAME
	5	----
	6	perf-stat - Run a command and gather performance counter statistics
	7
	8	SYNOPSIS
	9	--------
	10	[verse]
	11	'perf stat' [-e <EVENT> \| --event=EVENT] [-l] [-a] <command>
	12
	13	DESCRIPTION
	14	-----------
	15	This command runs a command and gathers performance counter statistics
	16	from it.
	17
	18
	19	OPTIONS
	20	-------
	21	<command>...::
	22	Any command you can specify in a shell.
	23
	24	-e::
	25	--event=::
	26	0:0: cpu-cycles
	27	0:0: cycles
	28	0:1: instructions
	29	0:2: cache-references
	30	0:3: cache-misses
	31	0:4: branch-instructions
	32	0:4: branches
	33	0:5: branch-misses
	34	0:6: bus-cycles
	35	1:0: cpu-clock
	36	1:1: task-clock
	37	1:2: page-faults
	38	1:2: faults
	39	1:5: minor-faults
	40	1:6: major-faults
	41	1:3: context-switches
	42	1:3: cs
	43	1:4: cpu-migrations
	44	1:4: migrations
	45	rNNN: raw PMU events (eventsel+umask)
	46
	47	-a::
	48	system-wide collection
	49
	50	-l::
	51	scale counter values
	52
	53	Configuration
	54	-------------
	55
	56	EXAMPLES
	57	--------
	58
	59	$ perf stat sleep 1
	60
	61	Performance counter stats for 'sleep':
	62
	63	0.678356 task clock ticks (msecs)
	64	7 context switches (events)
65	4 CPU migrations (events)
66	232 pagefaults (events)
67	1810403 CPU cycles (events)
68	946759 instructions (events)
69	18952 cache references (events)
70	4885 cache misses (events)
71
72	Wall-clock time elapsed: 1001.252894 msecs
73
74	SEE ALSO
75	--------
76	linkperf:git-tops[1]