ctfmerge
—
merge several CTF data sections into one
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 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 in
ctfmerge
:
CTFMERGE_TERMINATE_NO_UNLINK
- Don't remove temporary files on exit, so that they can be examined for
debugging.
CTFMERGE_MAX_SLOTS
- Number of round-robin slots in the input queue that it is processed by
worker threads. Each slot represents a file batch (default 5).
CTFMERGE_PHASE1_BATCH_SIZE
- Number of files in a slot that are needed before processing starts
(default 8).
CTFMERGE_NUM_THREADS
- Set the number of worker threads. If the number of processors can be
determined it defaults to
min
(processors*3/2,
nslots); if not it defaults to 2.
CTFMERGE_INPUT_THROTTLE
- Max queue size to queue (defaults to 10).
CTFMERGE_DEBUG_LEVEL
- Increase debugging verbosity (maximum is 3).
The ctfmerge
utility exits 0 on success,
and >0 if an error occurs.
The ctfmerge
utility first appeared in
FreeBSD 7.0.
The CTF utilities came from OpenSolaris.