perf-record.txt 1.7 KB

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