perf-top.txt 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. perf-top(1)
  2. ===========
  3. NAME
  4. ----
  5. perf-top - System profiling tool.
  6. SYNOPSIS
  7. --------
  8. [verse]
  9. 'perf top' [-e <EVENT> | --event=EVENT] [<options>]
  10. DESCRIPTION
  11. -----------
  12. This command generates and displays a performance counter profile in realtime.
  13. OPTIONS
  14. -------
  15. -a::
  16. --all-cpus::
  17. System-wide collection. (default)
  18. -c <count>::
  19. --count=<count>::
  20. Event period to sample.
  21. -C <cpu>::
  22. --CPU=<cpu>::
  23. CPU to profile.
  24. -d <seconds>::
  25. --delay=<seconds>::
  26. Number of seconds to delay between refreshes.
  27. -e <event>::
  28. --event=<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. -E <entries>::
  34. --entries=<entries>::
  35. Display this many functions.
  36. -f <count>::
  37. --count-filter=<count>::
  38. Only display functions with more events than this.
  39. -F <freq>::
  40. --freq=<freq>::
  41. Profile at this frequency.
  42. -i::
  43. --inherit::
  44. Child tasks inherit counters, only makes sens with -p option.
  45. -k <path>::
  46. --vmlinux=<path>::
  47. Path to vmlinux. Required for annotation functionality.
  48. -m <pages>::
  49. --mmap-pages=<pages>::
  50. Number of mmapped data pages.
  51. -p <pid>::
  52. --pid=<pid>::
  53. Profile events on existing pid.
  54. -r <priority>::
  55. --realtime=<priority>::
  56. Collect data with this RT SCHED_FIFO priority.
  57. -s <symbol>::
  58. --sym-annotate=<symbol>::
  59. Annotate this symbol. Requires -k option.
  60. -v::
  61. --verbose::
  62. Be more verbose (show counter open errors, etc).
  63. -z::
  64. --zero::
  65. Zero history across display updates.
  66. INTERACTIVE PROMPTING KEYS
  67. --------------------------
  68. [d]::
  69. Display refresh delay.
  70. [e]::
  71. Number of entries to display.
  72. [E]::
  73. Event to display when multiple counters are active.
  74. [f]::
  75. Profile display filter (>= hit count).
  76. [F]::
  77. Annotation display filter (>= % of total).
  78. [s]::
  79. Annotate symbol.
  80. [S]::
  81. Stop annotation, return to full profile display.
  82. [w]::
  83. Toggle between weighted sum and individual count[E]r profile.
  84. [z]::
  85. Toggle event count zeroing across display updates.
  86. [qQ]::
  87. Quit.
  88. Pressing any unmapped key displays a menu, and prompts for input.
  89. SEE ALSO
  90. --------
  91. linkperf:perf-stat[1], linkperf:perf-list[1]