Unix/Linux Go Back    


CentOS 7.0 - man page for perf-top (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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 do not inherit counters.

       -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 (comma separated list).

       -t <tid>, --tid=<tid>
	   Profile events on existing thread ID (comma separated list).

       -u, --uid=
	   Record events in threads owned by uid. Name or number.

       -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.

       -s, --sort
	   Sort by key(s): pid, comm, dso, symbol, parent, srcline, weight, local_weight.

       -n, --show-nr-samples
	   Show a column with the number of samples.

       --show-total-period
	   Show a column with the sum of periods.

       --dsos
	   Only consider symbols in these dsos.

       --comms
	   Only consider symbols in these comms.

       --symbols
	   Only consider these symbols.

       -M, --disassembler-style=
	   Set disassembler style for objdump.

       --source
	   Interleave source code with assembly code. Enabled by default, disable with
	   --no-source.

       --asm-raw
	   Show raw instruction encoding of assembly instructions.

       -G
	   Enables call-graph (stack chain/backtrace) recording.

       --call-graph
	   Setup and enable call-graph (stack chain/backtrace) recording, implies -G.

       --ignore-callees=<regex>
	   Ignore callees of the function(s) matching the given regex. This has the effect of
	   collecting the callers of each such function into one place in the call-graph tree.

       --percent-limit
	   Do not show entries which have an overhead under that percent. (Default: 0).

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.

       [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					    06/30/2014				      PERF-TOP(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 09:08 PM.