| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 1 | perf-record(1) |
| Ingo Molnar | c1c2365 | 2009-05-30 12:38:51 +0200 | [diff] [blame] | 2 | ============== |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 3 | |
| 4 | NAME |
| 5 | ---- |
| Ingo Molnar | 23ac9cb | 2009-05-27 09:33:18 +0200 | [diff] [blame] | 6 | perf-record - Run a command and record its profile into perf.data |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| 11 | 'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] <command> |
| Mike Galbraith | 9e096753 | 2009-05-28 16:25:34 +0200 | [diff] [blame] | 12 | 'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>] |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 13 | |
| 14 | DESCRIPTION |
| 15 | ----------- |
| 16 | This command runs a command and gathers a performance counter profile |
| Ingo Molnar | 23ac9cb | 2009-05-27 09:33:18 +0200 | [diff] [blame] | 17 | from it, into perf.data - without displaying anything. |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 18 | |
| 19 | This file can then be inspected later on, using 'perf report'. |
| 20 | |
| 21 | |
| 22 | OPTIONS |
| 23 | ------- |
| 24 | <command>...:: |
| 25 | Any command you can specify in a shell. |
| 26 | |
| 27 | -e:: |
| 28 | --event=:: |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 29 | Select the PMU event. Selection can be a symbolic event name |
| 30 | (use 'perf list' to list all events) or a raw PMU |
| 31 | event (eventsel+umask) in the form of rNNN where NNN is a |
| Arnaldo Carvalho de Melo | 386c0b7 | 2009-08-05 10:04:53 -0300 | [diff] [blame] | 32 | hexadecimal event descriptor. |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 33 | |
| 34 | -a:: |
| Arnaldo Carvalho de Melo | 386c0b7 | 2009-08-05 10:04:53 -0300 | [diff] [blame] | 35 | System-wide collection. |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 36 | |
| 37 | -l:: |
| Arnaldo Carvalho de Melo | 386c0b7 | 2009-08-05 10:04:53 -0300 | [diff] [blame] | 38 | Scale counter values. |
| 39 | |
| 40 | -p:: |
| 41 | --pid=:: |
| 42 | Record events on existing pid. |
| 43 | |
| 44 | -r:: |
| 45 | --realtime=:: |
| 46 | Collect data with this RT SCHED_FIFO priority. |
| 47 | -A:: |
| 48 | --append:: |
| 49 | Append to the output file to do incremental profiling. |
| 50 | |
| 51 | -f:: |
| 52 | --force:: |
| 53 | Overwrite existing data file. |
| 54 | |
| 55 | -c:: |
| 56 | --count=:: |
| 57 | Event period to sample. |
| 58 | |
| 59 | -o:: |
| 60 | --output=:: |
| 61 | Output file name. |
| 62 | |
| 63 | -i:: |
| 64 | --inherit:: |
| 65 | Child tasks inherit counters. |
| 66 | -F:: |
| 67 | --freq=:: |
| 68 | Profile at this frequency. |
| 69 | |
| 70 | -m:: |
| 71 | --mmap-pages=:: |
| 72 | Number of mmap data pages. |
| 73 | |
| 74 | -g:: |
| 75 | --call-graph:: |
| 76 | Do call-graph (stack chain/backtrace) recording. |
| 77 | |
| 78 | -v:: |
| 79 | --verbose:: |
| 80 | Be more verbose (show counter open errors, etc). |
| 81 | |
| 82 | -s:: |
| 83 | --stat:: |
| 84 | Per thread counts. |
| 85 | |
| 86 | -d:: |
| 87 | --data:: |
| 88 | Sample addresses. |
| 89 | |
| 90 | -n:: |
| 91 | --no-samples:: |
| 92 | Don't sample. |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 93 | |
| Frederic Weisbecker | ec7ba4e | 2009-08-31 03:32:03 +0200 | [diff] [blame] | 94 | -R:: |
| 95 | --raw-samples:: |
| 96 | Collect raw sample records from all opened counters (typically for tracepoint counters). |
| 97 | |
| Ingo Molnar | e33e0a4 | 2009-04-20 15:58:01 +0200 | [diff] [blame] | 98 | SEE ALSO |
| 99 | -------- |
| Thomas Gleixner | 386b05e | 2009-06-06 14:56:33 +0200 | [diff] [blame] | 100 | linkperf:perf-stat[1], linkperf:perf-list[1] |