1PPROF(1) Google PPROF(1)
2
3
4
6 pprof - manual page for pprof (part of gperftools)
7
9 pprof [options] <program> <profile>
10
12 Prints specified cpu- or heap-profile
13
15 --cum Sort by cumulative data
16
17 --base=<base>
18 Subtract <base> from <profile> before display
19
20 Reporting Granularity:
21 --addresses
22 Report at address level
23
24 --lines
25 Report at source line level
26
27 --functions
28 Report at function level [default]
29
30 --files
31 Report at source file level
32
33 Output type:
34 --text Generate text report [default]
35
36 --gv Generate Postscript and display
37
38 --list=<regexp>
39 Generate source listing of matching routines
40
41 --disasm=<regexp>
42 Generate disassembly of matching routines
43
44 --dot Generate DOT file to stdout
45
46 --ps Generate Postscript to stdout
47
48 --pdf Generate PDF to stdout
49
50 --gif Generate GIF to stdout
51
52 Heap-Profile Options:
53 --inuse_space
54 Display in-use (mega)bytes [default]
55
56 --inuse_objects
57 Display in-use objects
58
59 --alloc_space
60 Display allocated (mega)bytes
61
62 --alloc_objects
63 Display allocated objects
64
65 --show_bytes
66 Display space in bytes
67
68 --drop_negative
69 Ignore negaive differences
70
71 Call-graph Options:
72 --nodecount=<n>
73 Show at most so many nodes [default=80]
74
75 --nodefraction=<f>
76 Hide nodes below <f>*total [default=.005]
77
78 --edgefraction=<f>
79 Hide edges below <f>*total [default=.001]
80
81 --focus=<regexp>
82 Focus on nodes matching <regexp>
83
84 --ignore=<regexp>
85 Ignore nodes matching <regexp>
86
87 --scale=<n>
88 Set GV scaling [default=0]
89
91 pprof /bin/ls ls.prof
92
93 Outputs one line per procedure
94
95 pprof --gv /bin/ls ls.prof
96
97 Displays annotated call-graph via 'gv'
98
99 pprof --gv --focus=Mutex /bin/ls ls.prof
100
101 Restricts to code paths including a .*Mutex.* entry
102
103 pprof --gv --focus=Mutex --ignore=string /bin/ls ls.prof
104
105 Code paths including Mutex but not string
106
107 pprof --list=getdir /bin/ls ls.prof
108
109 Dissassembly (with per-line annotations) for getdir()
110
111 pprof --disasm=getdir /bin/ls ls.prof
112
113 Dissassembly (with per-PC annotations) for getdir()
114
116 Copyright © 2005 Google Inc.
117
119 Further documentation for pprof is maintained as a web page called
120 cpu_profiler.html and is likely installed at one of the following loca‐
121 tions:
122
123 /usr/share/gperftools/cpu_profiler.html
124 /usr/local/share/gperftools/cpu_profiler.html
125
126pprof (part of gperftools) February 2005 PPROF(1)