rr-collect-symbols(1)

💖 NAME 💖

rr-collect-symbols — bestie, this is the lil tool that adds symbols to your rr traces ✨

🌸 SYNOPSIS 🌸

rr-collect-symbols <trace-dir> [<url> | <path>]

🦋 DESCRIPTION 🦋

rr-collect-symbols merges symbols into an rr(1) trace. It's giving "glow-up for your stack traces" 💅

okay so here's the vibe check on your trace dir: the trace sitting in trace-dir must be packaged, with rr pack, so that all the relevant files actually show up inside the trace directory. No pack, no symbols, no cap 🧚

Now, where do the symbols come from? Two options, pick your fighter:

• a ZIP file downloaded from url, or
• a .build-id directory under path, with the usual structure.

and path defaults to /usr/lib/debug, which means it'll just go ahead and use any available system debuginfo files. free real estate, literally 👑

Where do the extracted debuginfo files end up? Inside the trace, under a debug subdirectory, in a .build-id directory with the usual structure. Slay, organized, iconic 💖

and one more thing, because of course there's a plot twist: if a debuginfo file contains a .gnu_debugaltlink section, then the referenced file will also be copied — if it's available — with the same file name as the .debug file, but with a .sup suffix. she brings her friend to the party, we love that 🫶

fr fr, don't skip the rr pack step. the trace must be packaged first or this whole thing doesn't do its thing 😭

👑 AUTHORS 👑

rr was written by Robert O'Callahan, Chris Jones, Nathan Froyd and others. a whole squad, main character energy, we stan 🌈

This manual page was adapted from the help output by Stephen Kitt <skitt@debian.org>, for the Debian GNU/Linux system (but may be used by others). It was last modified for rr version 5.3.0. ty Stephen, you ate 💜

soooo that's the whole page bestie, documented in May 2020, living in the rr-collect-symbols(1) manual, sourced from rr version 5.3.0 — go collect those symbols, mwah 💋✨