Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
awilliam
GitHub Repository: awilliam/linux-vfio
 Path: blob/master/tools/perf/Documentation/perf-report.txt
10821 views
1
perf-report(1)

2
==============

3


4
NAME

5
----

6
perf-report - Read perf.data (created by perf record) and display the profile

7


8
SYNOPSIS

9
--------

10
[verse]

11
'perf report' [-i <file> | --input=file]

12


13
DESCRIPTION

14
-----------

15
This command displays the performance counter profile information recorded

16
via perf record.

17


18
OPTIONS

19
-------

20
-i::

21
--input=::

22
        Input file name. (default: perf.data)

23


24
-v::

25
--verbose::

26
        Be more verbose. (show symbol address, etc)

27


28
-d::

29
--dsos=::

30
	Only consider symbols in these dsos. CSV that understands

31
	file://filename entries.

32
-n::

33
--show-nr-samples::

34
	Show the number of samples for each symbol

35


36
--showcpuutilization::

37
        Show sample percentage for different cpu modes.

38


39
-T::

40
--threads::

41
	Show per-thread event counters

42
-C::

43
--comms=::

44
	Only consider symbols in these comms. CSV that understands

45
	file://filename entries.

46
-S::

47
--symbols=::

48
	Only consider these symbols. CSV that understands

49
	file://filename entries.

50


51
-U::

52
--hide-unresolved::

53
        Only display entries resolved to a symbol.

54


55
-s::

56
--sort=::

57
	Sort by key(s): pid, comm, dso, symbol, parent.

58


59
-p::

60
--parent=<regex>::

61
        regex filter to identify parent, see: '--sort parent'

62


63
-x::

64
--exclude-other::

65
        Only display entries with parent-match.

66


67
-w::

68
--column-widths=<width[,width...]>::

69
	Force each column width to the provided list, for large terminal

70
	readability.

71


72
-t::

73
--field-separator=::

74


75
	Use a special separator character and don't pad with spaces, replacing

76
	all occurrences of this separator in symbol names (and other output)

77
	with a '.' character, that thus it's the only non valid separator.

78


79
-D::

80
--dump-raw-trace::

81
        Dump raw trace in ASCII.

82


83
-g [type,min]::

84
--call-graph::

85
        Display call chains using type and min percent threshold.

86
	type can be either:

87
	- flat: single column, linear exposure of call chains.

88
	- graph: use a graph tree, displaying absolute overhead rates.

89
	- fractal: like graph, but displays relative rates. Each branch of

90
		 the tree is considered as a new profiled object. +

91
	Default: fractal,0.5.

92


93
--pretty=<key>::

94
        Pretty printing style.  key: normal, raw

95


96
--stdio:: Use the stdio interface.

97


98
--tui:: Use the TUI interface, that is integrated with annotate and allows

99
        zooming into DSOs or threads, among other features. Use of --tui

100
	requires a tty, if one is not present, as when piping to other

101
	commands, the stdio interface is used.

102


103
-k::

104
--vmlinux=<file>::

105
        vmlinux pathname

106


107
--kallsyms=<file>::

108
        kallsyms pathname

109


110
-m::

111
--modules::

112
        Load module symbols. WARNING: This should only be used with -k and

113
        a LIVE kernel.

114


115
-f::

116
--force::

117
        Don't complain, do it.

118


119
--symfs=<directory>::

120
        Look for files with symbols relative to this directory.

121


122
SEE ALSO

123
--------

124
linkperf:perf-stat[1]

125


126