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
The ctfmerge utility exits 0 on success, and >0 if an error occurs.
SEE ALSO
HISTORY
The ctfmerge utility first appeared in FreeBSD 7.0.
AUTHORS
The CTF utilities came from OpenSolaris.