CTFMERGE(1)

NAME
ctfmerge - merge several CTF data sections into one

SYNOPSIS
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

DESCRIPTION
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.

ENVIRONMENT
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.

EXIT STATUS

SEE ALSO
ctfconvert(1), ctfdump(1), ctf(5)

HISTORY
The ctfmerge utility first appeared in FreeBSD 7.0.

AUTHORS
The CTF utilities came from OpenSolaris.