git.oblomov.eu Git - linux-2.6/blob - tools/perf/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         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
  32          hexadecimal event descriptor.
  33
  34 -a::
  35         system-wide collection
  36
  37 -l::
  38         scale counter values
  39
  40 SEE ALSO
  41 --------
  42 linkperf:perf-stat[1], linkperf:perf-list[1]