| perf-top(1) |
| =========== |
| |
| NAME |
| ---- |
| perf-top - System profiling tool. |
| |
| SYNOPSIS |
| -------- |
| [verse] |
| '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 |
| -------- |
| linkperf:perf-stat[1], linkperf:perf-list[1] |