Documentation/perf_counter/Documentation/perf-record.txt

   1 perf-record(1)
   2 ==========
   3
   4 NAME
   5 ----
   6 perf-record - Run a command and record its profile into perf.data
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
  12 'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>]
  13
  14 DESCRIPTION
  15 -----------
  16 This command runs a command and gathers a performance counter profile
  17 from it, into perf.data - without displaying anything.
  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=::
  29                              0:0: cpu-cycles
  30                              0:0: cycles
  31                              0:1: instructions
  32                              0:2: cache-references
  33                              0:3: cache-misses
  34                              0:4: branch-instructions
  35                              0:4: branches
  36                              0:5: branch-misses
  37                              0:6: bus-cycles
  38                              1:0: cpu-clock
  39                              1:1: task-clock
  40                              1:2: page-faults
  41                              1:2: faults
  42                              1:5: minor-faults
  43                              1:6: major-faults
  44                              1:3: context-switches
  45                              1:3: cs
  46                              1:4: cpu-migrations
  47                              1:4: migrations
  48                            rNNN: raw PMU events (eventsel+umask)
  49
  50 -a::
  51         system-wide collection
  52
  53 -l::
  54         scale counter values
  55
  56 Configuration
  57 -------------
  58
  59 EXAMPLES
  60 --------
  61
  62 SEE ALSO
  63 --------
  64 linkperf:git-stat[1]