perf-record(1)
NAME
perf-record - Run a command and record its profile into perf.data
SYNOPSIS
perf record [-e <EVENT> | --event=EVENT] [-l] [-a] <command> perf record [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>]
DESCRIPTION
This command runs a command and gathers a performance counter profile
from it, into perf.data - without displaying anything.
This file can then be inspected later on, using perf report.
OPTIONS
- <command>...
- Any command you can specify in a shell.
- -e, --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. - -a
- System-wide collection.
- -l
- Scale counter values.
- -p, --pid=
- Record events on existing pid.
- -r, --realtime=
- Collect data with this RT SCHED_FIFO priority.
- -A, --append
- Append to the output file to do incremental profiling.
- -f, --force
- Overwrite existing data file.
- -c, --count=
- Event period to sample.
- -o, --output=
- Output file name.
- -i, --inherit
- Child tasks inherit counters.
- -F, --freq=
- Profile at this frequency.
- -m, --mmap-pages=
- Number of mmap data pages.
- -g, --call-graph
- Do call-graph (stack chain/backtrace) recording.
- -v, --verbose
- Be more verbose (show counter open errors, etc).
- -s, --stat
- Per thread counts.
- -d, --data
- Sample addresses.
- -n, --no-samples
- Don't sample.
- -R, --raw-samples
- Collect raw sample records from all opened counters (typically for tracepoint counters).