Blame - tools/perf/Documentation/perf-top.txt - kernel/msm-4.9

blob: f6eb1cdafb7758162463b0ca8a25525f94c44d19 [file] [log] [blame]

Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	1	perf-top(1)
Ingo Molnar	6e6b754	2008-04-15 22:39:31 +0200	[diff] [blame]	2	===========
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	3
				4	NAME
				5	----
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	6	perf-top - System profiling tool.
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	7
				8	SYNOPSIS
				9	--------
				10	[verse]
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	11	'perf top' [-e <EVENT> \| --event=EVENT] [<options>]
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	12
				13	DESCRIPTION
				14	-----------
Shawn Bohrer	2e7a988	2010-11-30 19:57:21 -0600	[diff] [blame]	15	This command generates and displays a performance counter profile in real time.
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	16
				17
				18	OPTIONS
				19	-------
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	20	-a::
				21	--all-cpus::
				22	System-wide collection. (default)
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	23
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	24	-c <count>::
				25	--count=<count>::
				26	Event period to sample.
				27
Stephane Eranian	c45c6ea	2010-05-28 12:00:01 +0200	[diff] [blame]	28	-C <cpu-list>::
				29	--cpu=<cpu>::
Shawn Bohrer	2e7a988	2010-11-30 19:57:21 -0600	[diff] [blame]	30	Monitor only on the list of CPUs provided. Multiple CPUs can be provided as a
				31	comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
Stephane Eranian	c45c6ea	2010-05-28 12:00:01 +0200	[diff] [blame]	32	Default is to monitor all CPUS.
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	33
				34	-d <seconds>::
				35	--delay=<seconds>::
				36	Number of seconds to delay between refreshes.
				37
				38	-e <event>::
				39	--event=<event>::
Thomas Gleixner	386b05e	2009-06-06 14:56:33 +0200	[diff] [blame]	40	Select the PMU event. Selection can be a symbolic event name
				41	(use 'perf list' to list all events) or a raw PMU
				42	event (eventsel+umask) in the form of rNNN where NNN is a
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	43	hexadecimal event descriptor.
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	44
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	45	-E <entries>::
				46	--entries=<entries>::
				47	Display this many functions.
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	48
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	49	-f <count>::
				50	--count-filter=<count>::
				51	Only display functions with more events than this.
				52
Shawn Bohrer	2e7a988	2010-11-30 19:57:21 -0600	[diff] [blame]	53	-g::
				54	--group::
				55	Put the counters into a counter group.
				56
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	57	-F <freq>::
				58	--freq=<freq>::
				59	Profile at this frequency.
				60
				61	-i::
				62	--inherit::
				63	Child tasks inherit counters, only makes sens with -p option.
				64
				65	-k <path>::
				66	--vmlinux=<path>::
				67	Path to vmlinux. Required for annotation functionality.
				68
				69	-m <pages>::
				70	--mmap-pages=<pages>::
				71	Number of mmapped data pages.
				72
				73	-p <pid>::
				74	--pid=<pid>::
Shawn Bohrer	2e7a988	2010-11-30 19:57:21 -0600	[diff] [blame]	75	Profile events on existing Process ID.
				76
				77	-t <tid>::
				78	--tid=<tid>::
				79	Profile events on existing thread ID.
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	80
				81	-r <priority>::
				82	--realtime=<priority>::
				83	Collect data with this RT SCHED_FIFO priority.
				84
				85	-s <symbol>::
				86	--sym-annotate=<symbol>::
Kirill Smelkov	6cff0e8	2010-02-03 16:52:08 -0200	[diff] [blame]	87	Annotate this symbol.
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	88
Shawn Bohrer	2e7a988	2010-11-30 19:57:21 -0600	[diff] [blame]	89	-K::
				90	--hide_kernel_symbols::
				91	Hide kernel symbols.
				92
				93	-U::
				94	--hide_user_symbols::
				95	Hide user symbols.
				96
				97	-D::
				98	--dump-symtab::
				99	Dump the symbol table used for profiling.
				100
Mike Galbraith	8361798	2009-08-04 10:24:41 +0200	[diff] [blame]	101	-v::
				102	--verbose::
				103	Be more verbose (show counter open errors, etc).
				104
				105	-z::
				106	--zero::
				107	Zero history across display updates.
				108
				109	INTERACTIVE PROMPTING KEYS
				110	--------------------------
				111
				112	[d]::
				113	Display refresh delay.
				114
				115	[e]::
				116	Number of entries to display.
				117
				118	[E]::
				119	Event to display when multiple counters are active.
				120
				121	[f]::
				122	Profile display filter (>= hit count).
				123
				124	[F]::
				125	Annotation display filter (>= % of total).
				126
				127	[s]::
				128	Annotate symbol.
				129
				130	[S]::
				131	Stop annotation, return to full profile display.
				132
				133	[w]::
				134	Toggle between weighted sum and individual count[E]r profile.
				135
				136	[z]::
				137	Toggle event count zeroing across display updates.
				138
				139	[qQ]::
				140	Quit.
				141
				142	Pressing any unmapped key displays a menu, and prompts for input.
				143
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	144
Ingo Molnar	1d8c8b2	2009-04-20 15:52:29 +0200	[diff] [blame]	145	SEE ALSO
				146	--------
Thomas Gleixner	386b05e	2009-06-06 14:56:33 +0200	[diff] [blame]	147	linkperf:perf-stat[1], linkperf:perf-list[1]