SysTutorials

Linux Manual Pages › Section 1

pprof(1)

NAME

pprof – manual page for pprof (part of gperftools)

SYNOPSIS

pprof [options] <program> <profile>

DESCRIPTION

Prints specified cpu- or heap-profile

OPTIONS

–cum
Sort by cumulative data
–base=<base>
Subtract <base> from <profile> before display

Reporting Granularity:

–addresses
Report at address level
–lines
Report at source line level
–functions
Report at function level [default]
–files
Report at source file level

Output type:

–text
Generate text report [default]
–gv
Generate Postscript and display
–list=<regexp>
Generate source listing of matching routines
–disasm=<regexp>
Generate disassembly of matching routines
–dot
Generate DOT file to stdout
–ps
Generate Postcript to stdout
–pdf
Generate PDF to stdout
–gif
Generate GIF to stdout

Heap-Profile Options:

–inuse_space
Display in-use (mega)bytes [default]
–inuse_objects
Display in-use objects
–alloc_space
Display allocated (mega)bytes
–alloc_objects
Display allocated objects
–show_bytes
Display space in bytes
–drop_negative
Ignore negaive differences

Call-graph Options:

–nodecount=<n>
Show at most so many nodes [default=80]
–nodefraction=<f>
Hide nodes below <f>*total [default=.005]
–edgefraction=<f>
Hide edges below <f>*total [default=.001]
–focus=<regexp>
Focus on nodes matching <regexp>
–ignore=<regexp>
Ignore nodes matching <regexp>
–scale=<n>
Set GV scaling [default=0]

EXAMPLES

pprof /bin/ls ls.prof

Outputs one line per procedure

pprof –gv /bin/ls ls.prof

Displays annotated call-graph via ‘gv’

pprof –gv –focus=Mutex /bin/ls ls.prof

Restricts to code paths including a .*Mutex.* entry

pprof –gv –focus=Mutex –ignore=string /bin/ls ls.prof

Code paths including Mutex but not string

pprof –list=getdir /bin/ls ls.prof

Dissassembly (with per-line annotations) for getdir()

pprof –disasm=getdir /bin/ls ls.prof

Dissassembly (with per-PC annotations) for getdir()

COPYRIGHT

Copyright © 2005 Google Inc.

SEE ALSO

Further documentation for pprof is maintained as a web page called cpu_profiler.html and is likely installed at one of the following locations:

/usr/share/gperftools/cpu_profiler.html
/usr/local/share/gperftools/cpu_profiler.html