PPROF(1)

💅 PPROF(1) — aka google-pprof

okay bestie, sit down, hydrate, and let me tell you about google-pprof ✨ it's the manual page for google-pprof, which is part of gperftools (yes that gperftools, the iconic one). it's literally a profiler-reading bestie and it's here to tell you where your program is spending all its time. 🎀

---

✨ SYNOPSIS ✨

google-pprof [options] <program> <profile>

---

🌸 DESCRIPTION 🌸

it prints the specified cpu- or heap-profile. that's the whole vibe. you give it a program and a profile, it gives you the tea. ☕💅

---

👑 OPTIONS 👑

• --cum — sort by cumulative</> data. like, the totals, not just the individual moment.
• --base=<base> — subtract <base> from <profile> before it gets displayed. math first, pretty later. ✨

---

📊 Reporting Granularity 📊

how zoomed-in do you want the receipts, bestie?

• --addresses — report at the address level
• --lines — report at the source line level
• --functions — report at the function level [default]
• --files — report at the source file level

---

🎨 Output type 🎨

pick your aesthetic. it's giving choices. 💖

• --text — generate a text report [default]
• --gv — generate Postscript and display it
• --list=<regexp> — generate a source listing of the matching routines
• --disasm=<regexp> — generate disassembly of the matching routines
• --dot — generate a 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 this 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 🌈

watch and learn, this is the good part 👑

google-pprof /bin/ls ls.prof

outputs one line per procedure

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

displays an 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

---

and that's the whole page bestie 🫶 this lil icon came from google-pprof (part of gperfto... and it's dated February 2005. historic. legendary. slay. 💅✨