1PPROF(1)                            Google                            PPROF(1)
2
3
4

NAME

6       pprof - manual page for pprof (part of gperftools)
7

SYNOPSIS

9       pprof [options] <program> <profile>
10

DESCRIPTION

12              Prints specified cpu- or heap-profile
13

OPTIONS

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

EXAMPLES

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

SEE ALSO

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)
Impressum