ctfmerge(1) on freebsd

Usage

ctfmerge [-fgstv] -l label -L labelenv -o outfile file ...

ctfmerge [-fgstv] -l label -L labelenv -o outfile -d uniqfile [-g] [-D uniqlabel] file ...

ctfmerge [-fgstv] -l label -L labelenv -o outfile -w withfile file ...

ctfmerge [-g] -c srcfile destfile

The ctfmerge utility merges several CTF (Compact C Type Format) data sections from several files into one output file, unifying common data.

The following options are available:

-f: Match global symbols to global CTF data.
-g: Don't delete the original debugging sections.
-s: Use the .dynsym ELF section instead of the .symtab ELF section.
-t: Make sure that all object files have a CTF section.
-v: Enable verbose mode.
-l label: Sets the label as label.
-L labelenv: Instructs ctfmerge to read the label from the environment variable labelenv.
-o outfile: Use outfile to store the merged CTF data.
-d uniqfile: Uniquify against uniqfile.
-D uniqlabel: Uniquify against label uniqlabel.
-w withfile: Additive merge with withfile.
-c srcfile destfile: Copy CTF data from srcfile into destfile.

The following environment variables are used by ctfmerge:

CTFMERGE_DEBUG_LEVEL: Increase debugging verbosity (maximum 3).
CTFMERGE_INPUT_THROTTLE: Max queue size to queue (default 10).
CTFMERGE_PHASE1_BATCH_SIZE: Number of files in a slot that are needed before processing starts (default 8).
CTFMERGE_MAX_SLOTS: Number of round-robin slots in the input queue that is processed by worker threads. Each slot represents a file batch (default 5).
CTFMERGE_TERMINATE_NO_UNLINK: Do not remove temporary files on exit, so that they can be examined for debugging.

The ctfmerge utility exits 0 on success, and >0 if an error occurs.

37 releases since FreeBSD 8.2-RELEASE; the text changed 27 times.

-D since FreeBSD 16.0-CURRENT (2026-10-27).