---
name: "rr-collect-symbols"
section: "1"
platform: "linux"
package: "rr"
version: "5.9.0-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rr-collect-symbols"
---

# rr-collect-symbols(1)

add symbols to rr traces

## NAME

rr-collect-symbols - add symbols to rr traces

## SYNOPSIS

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

## DESCRIPTION

**rr-collect-symbols** merges symbols into an [**rr**(1)](/rr/1.md) trace.

The trace in *trace-dir* must be package, with **rr pack**, so all relevant files appear in the trace directory.

Symbols can be extracted from a ZIP file downloaded from *url*, or from a .build-id directory under *path* with the usual structure. *path* defaults to /usr/lib/debug, thus using any available system debuginfo files.

The extracted debuginfo files are stored in the trace under a debug subdirectory, in a .build-id directory with the usual structure.

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.

## AUTHORS

**rr** was written by Robert O'Callahan, Chris Jones, Nathan Froyd and others.

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.