perf-report.txt 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158
  1. perf-report(1)
  2. ==============
  3. NAME
  4. ----
  5. perf-report - Read perf.data (created by perf record) and display the profile
  6. SYNOPSIS
  7. --------
  8. [verse]
  9. 'perf report' [-i <file> | --input=file]
  10. DESCRIPTION
  11. -----------
  12. This command displays the performance counter profile information recorded
  13. via perf record.
  14. OPTIONS
  15. -------
  16. -i::
  17. --input=::
  18. Input file name. (default: perf.data unless stdin is a fifo)
  19. -v::
  20. --verbose::
  21. Be more verbose. (show symbol address, etc)
  22. -d::
  23. --dsos=::
  24. Only consider symbols in these dsos. CSV that understands
  25. file://filename entries.
  26. -n::
  27. --show-nr-samples::
  28. Show the number of samples for each symbol
  29. --showcpuutilization::
  30. Show sample percentage for different cpu modes.
  31. -T::
  32. --threads::
  33. Show per-thread event counters
  34. -c::
  35. --comms=::
  36. Only consider symbols in these comms. CSV that understands
  37. file://filename entries.
  38. -S::
  39. --symbols=::
  40. Only consider these symbols. CSV that understands
  41. file://filename entries.
  42. -U::
  43. --hide-unresolved::
  44. Only display entries resolved to a symbol.
  45. -s::
  46. --sort=::
  47. Sort by key(s): pid, comm, dso, symbol, parent.
  48. -p::
  49. --parent=<regex>::
  50. regex filter to identify parent, see: '--sort parent'
  51. -x::
  52. --exclude-other::
  53. Only display entries with parent-match.
  54. -w::
  55. --column-widths=<width[,width...]>::
  56. Force each column width to the provided list, for large terminal
  57. readability.
  58. -t::
  59. --field-separator=::
  60. Use a special separator character and don't pad with spaces, replacing
  61. all occurrences of this separator in symbol names (and other output)
  62. with a '.' character, that thus it's the only non valid separator.
  63. -D::
  64. --dump-raw-trace::
  65. Dump raw trace in ASCII.
  66. -g [type,min[,limit],order]::
  67. --call-graph::
  68. Display call chains using type, min percent threshold, optional print
  69. limit and order.
  70. type can be either:
  71. - flat: single column, linear exposure of call chains.
  72. - graph: use a graph tree, displaying absolute overhead rates.
  73. - fractal: like graph, but displays relative rates. Each branch of
  74. the tree is considered as a new profiled object. +
  75. order can be either:
  76. - callee: callee based call graph.
  77. - caller: inverted caller based call graph.
  78. Default: fractal,0.5,callee.
  79. -G::
  80. --inverted::
  81. alias for inverted caller based call graph.
  82. --pretty=<key>::
  83. Pretty printing style. key: normal, raw
  84. --stdio:: Use the stdio interface.
  85. --tui:: Use the TUI interface, that is integrated with annotate and allows
  86. zooming into DSOs or threads, among other features. Use of --tui
  87. requires a tty, if one is not present, as when piping to other
  88. commands, the stdio interface is used.
  89. -k::
  90. --vmlinux=<file>::
  91. vmlinux pathname
  92. --kallsyms=<file>::
  93. kallsyms pathname
  94. -m::
  95. --modules::
  96. Load module symbols. WARNING: This should only be used with -k and
  97. a LIVE kernel.
  98. -f::
  99. --force::
  100. Don't complain, do it.
  101. --symfs=<directory>::
  102. Look for files with symbols relative to this directory.
  103. -C::
  104. --cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can
  105. be provided as a comma-separated list with no space: 0,1. Ranges of
  106. CPUs are specified with -: 0-2. Default is to report samples on all
  107. CPUs.
  108. -M::
  109. --disassembler-style=:: Set disassembler style for objdump.
  110. --source::
  111. Interleave source code with assembly code. Enabled by default,
  112. disable with --no-source.
  113. --asm-raw::
  114. Show raw instruction encoding of assembly instructions.
  115. --show-total-period:: Show a column with the sum of periods.
  116. -I::
  117. --show-info::
  118. Display extended information about the perf.data file. This adds
  119. information which may be very large and thus may clutter the display.
  120. It currently includes: cpu and numa topology of the host system.
  121. SEE ALSO
  122. --------
  123. linkperf:perf-stat[1], linkperf:perf-annotate[1]