Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14857 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

PERF-TOP(1)			  perf Manual			   PERF-TOP(1)

NAME
       perf-top - System profiling tool.

SYNOPSIS
       perf top [-e <EVENT> | --event=EVENT] [<options>]

DESCRIPTION
       This command generates and displays a performance counter profile in
       real time.

OPTIONS
       -a, --all-cpus
	   System-wide collection. (default)

       -c <count>, --count=<count>
	   Event period to sample.

       -C <cpu-list>, --cpu=<cpu>
	   Monitor only on the list of CPUs provided. Multiple CPUs can be
	   provided as a comma-separated list with no space: 0,1. Ranges of
	   CPUs are specified with -: 0-2. Default is to monitor all CPUS.

       -d <seconds>, --delay=<seconds>
	   Number of seconds to delay between refreshes.

       -e <event>, --event=<event>
	   Select the PMU event. Selection can be a symbolic event name (use
	   perf list to list all events) or a raw PMU event (eventsel+umask)
	   in the form of rNNN where NNN is a hexadecimal event descriptor.

       -E <entries>, --entries=<entries>
	   Display this many functions.

       -f <count>, --count-filter=<count>
	   Only display functions with more events than this.

       -g, --group
	   Put the counters into a counter group.

       -F <freq>, --freq=<freq>
	   Profile at this frequency.

       -i, --inherit
	   Child tasks inherit counters, only makes sens with -p option.

       -k <path>, --vmlinux=<path>
	   Path to vmlinux. Required for annotation functionality.

       -m <pages>, --mmap-pages=<pages>
	   Number of mmapped data pages.

       -p <pid>, --pid=<pid>
	   Profile events on existing Process ID.

       -t <tid>, --tid=<tid>
	   Profile events on existing thread ID.

       -r <priority>, --realtime=<priority>
	   Collect data with this RT SCHED_FIFO priority.

       -s <symbol>, --sym-annotate=<symbol>
	   Annotate this symbol.

       -K, --hide_kernel_symbols
	   Hide kernel symbols.

       -U, --hide_user_symbols
	   Hide user symbols.

       -D, --dump-symtab
	   Dump the symbol table used for profiling.

       -v, --verbose
	   Be more verbose (show counter open errors, etc).

       -z, --zero
	   Zero history across display updates.

INTERACTIVE PROMPTING KEYS
       [d]
	   Display refresh delay.

       [e]
	   Number of entries to display.

       [E]
	   Event to display when multiple counters are active.

       [f]
	   Profile display filter (>= hit count).

       [F]
	   Annotation display filter (>= % of total).

       [s]
	   Annotate symbol.

       [S]
	   Stop annotation, return to full profile display.

       [w]
	   Toggle between weighted sum and individual count[E]r profile.

       [z]
	   Toggle event count zeroing across display updates.

       [qQ]
	   Quit.

       Pressing any unmapped key displays a menu, and prompts for input.

SEE ALSO
       perf-stat(1), perf-list(1)

perf 3.0.76			  06/14/2013			   PERF-TOP(1)

Vote for polarhome