---
name: "google-pprof"
section: "1"
platform: "linux"
package: "google-perftools"
version: "2.16-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/google-pprof"
---

# google-pprof(1)

manual page for google-pprof (part of gperftools)

## NAME

google-pprof - manual page for google-pprof (part of gperftools)

## SYNOPSIS

**google-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 Postscript 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

google-pprof /bin/ls ls.prof

-

  Outputs one line per procedure

google-pprof **--gv** /bin/ls ls.prof

-

  Displays annotated call-graph via 'gv'

google-pprof **--gv** **--focus**=*Mutex* /bin/ls ls.prof

-

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

google-pprof **--gv** **--focus**=*Mutex* **--ignore**=*string* /bin/ls ls.prof

-

  Code paths including Mutex but not string

google-pprof **--list**=*getdir* /bin/ls ls.prof

-

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

google-pprof **--disasm**=*getdir* /bin/ls ls.prof

-

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

## COPYRIGHT

Copyright © 2005 Google Inc.

## SEE ALSO

Further documentation for **google-pprof** is maintained as a web page called **cpu\_profiler.html** and is likely installed at one of the following locations:

-

  **/usr/share/doc/libgoogle-perftools-dev/cpuprofile.html**\
   **/usr/local/share/gperftools/cpu\_profiler.html**