mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-15 04:31:49 +08:00
1ff6de0312
This is quite complicated because the CTF section's contents depend on
the final contents of the symtab and strtab, because it has two sections
whose contents are shuffled to be in 1:1 correspondence with the symtab,
and an internal strtab that gets deduplicated against the ELF strtab
(with offsets adjusted to point into the ELF strtab instead). It is
also compressed if large enough, so its size depends on its contents!
So we cannot construct it as early as most sections: we cannot even
*begin* construction until after the symtab and strtab are finalized.
Thankfully there is already one section treated similarly: compressed
debugging sections: the only differences are that compressed debugging
sections have extra handling to deal with their changing name if
compressed (CTF sections are always called ".ctf" for now, though we
have reserved ".ctf.*" against future use), and that compressed
debugging sections have previously-uncompressed content which has to be
stashed away for later compression, while CTF sections have no content
at all until we generate it (very late).
BFD also cannot do the link itself: libctf knows how to do it, and BFD
cannot call libctf directly because libctf already depends on bfd for
file I/O. So we have to use a pair of callbacks, one, examine_strtab,
which allows a caller to examine the symtab and strtab after
finalization (called from elf_link_swap_symbols_out(), right before the
symtabs are written, and after the strtab has been finalized), and one
which actually does the emission (called emit_ctf simply because it is
grouped with a bunch of section-specific late-emission function calls at
the bottom of bfd_elf_final_link, and a section-specific name seems best
for that). emit_ctf is actually called *twice*: once from lang_process
if the emulation suggests that this bfd target does not examine the
symtab or strtab, and once via a bfd callback if it does. (This means
that non-ELF targets still get CTF emitted, even though the late CTF
emission stage is never called for them).
v2: merged with non-ELF support patch: slight commit message
adjustments.
v3: do not spend time merging CTF, or crash, if the CTF section is
explicitly discarded. Do not try to merge or compress CTF unless
linking.
v4: add CTF_COMPRESSION_THRESHOLD. Annul the freed input ctf_file_t's
after writeout: set SEC_IN_MEMORY on the output contents so a future
bfd enhancement knows it could free it. Add SEC_LINKER_CREATED |
SEC_KEEP to avoid having to add .ctf to the linker script. Drop
now-unnecessary ldlang.h-level elf-bfd.h include and hackery around
it. Adapt to elf32.em->elf.em and elf-generic.em->ldelf*.c
changes.
v5: fix tabdamage. Drop #inclusions in .h files: include in .c files,
.em files, and use struct forwards instead. Use bfd_section_is_ctf
inline function rather than SECTION_IS_CTF macro. Move a few
comments.
* Makefile.def (dependencies): all-ld depends on all-libctf.
* Makefile.in: Regenerated.
include/
* bfdlink.h (elf_strtab_hash): New forward.
(elf_sym_strtab): Likewise.
(struct bfd_link_callbacks <examine_strtab>): New.
(struct bfd_link_callbacks <emit_ctf>): Likewise.
bfd/
* elf-bfd.h (bfd_section_is_ctf): New inline function.
* elf.c (special_sections_c): Add ".ctf".
(assign_file_positions_for_non_load_sections): Note that
compressed debugging sections etc are not assigned here. Treat
CTF sections like SEC_ELF_COMPRESS sections when is_linker_output:
sh_offset -1.
(assign_file_positions_except_relocs): Likewise.
(find_section_in_list): Note that debugging and CTF sections, as
well as reloc sections, are assigned later.
(_bfd_elf_assign_file_positions_for_non_load): CTF sections get
their size and contents updated.
(_bfd_elf_set_section_contents): Skip CTF sections: unlike
compressed sections, they have no uncompressed content to copy at
this stage.
* elflink.c (elf_link_swap_symbols_out): Call the examine_strtab
callback right before the strtab is written out.
(bfd_elf_final_link): Don't cache the section contents of CTF
sections: they are not populated yet. Call the emit_ctf callback
right at the end, after all the symbols and strings are flushed
out.
ld/
* ldlang.h: (struct lang_input_statement_struct): Add the_ctf.
(struct elf_sym_strtab): Add forward.
(struct elf_strtab_hash): Likewise.
(ldlang_ctf_apply_strsym): Declare.
(ldlang_write_ctf_late): Likewise.
* ldemul.h (ldemul_emit_ctf_early): New.
(ldemul_examine_strtab_for_ctf): Likewise.
(ld_emulation_xfer_type) <emit_ctf_early>: Likewise.
(ld_emulation_xfer_type) <examine_strtab_for_ctf>: Likewise.
* ldemul.c (ldemul_emit_ctf_early): New.
(ldemul_examine_strtab_for_ctf): Likewise.
* ldlang.c: Include ctf-api.h.
(CTF_COMPRESSION_THRESHOLD): New.
(ctf_output): New. Initialized in...
(ldlang_open_ctf): ... this new function. Open all the CTF
sections in the input files: mark them non-loaded and empty
so as not to copy their contents to the output, but linker-created
so the section gets created in the target.
(ldlang_merge_ctf): New, merge types via ctf_link_add_ctf and
ctf_link.
(ldlang_ctf_apply_strsym): New, an examine_strtab callback: wrap
ldemul_examine_strtab_for_ctf.
(lang_write_ctf): New, write out the CTF section.
(ldlang_write_ctf_late): New, late call via bfd's emit_ctf hook.
(lang_process): Call ldlang_open_ctf, ldlang_merge_ctf, and
lang_write_ctf.
* ldmain.c (link_callbacks): Add ldlang_ctf_apply_strsym,
ldlang_write_ctf_late.
* emultempl/aix.em: Add ctf-api.h.
* emultempl/armcoff.em: Likewise.
* emultempl/beos.em: Likewise.
* emultempl/elf.em: Likewise.
* emultempl/generic.em: Likewise.
* emultempl/linux.em: Likewise.
* emultempl/msp430.em: Likewise.
* emultempl/pe.em: Likewise.
* emultempl/pep.em: Likewise.
* emultempl/ticoff.em: Likewise.
* emultempl/vanilla.em: Likewise.
* ldcref.c: Likewise.
* ldctor.c: Likewise.
* ldelf.c: Likewise.
* ldelfgen.c: Likewise.
* ldemul.c: Likewise.
* ldexp.c: Likewise.
* ldfile.c: Likewise.
* ldgram.c: Likewise.
* ldlex.l: Likewise.
* ldmain.c: Likewise.
* ldmisc.c: Likewise.
* ldver.c: Likewise.
* ldwrite.c: Likewise.
* lexsup.c: Likewise.
* mri.c: Likewise.
* pe-dll.c: Likewise.
* plugin.c: Likewise.
* ldelfgen.c (ldelf_emit_ctf_early): New.
(ldelf_examine_strtab_for_ctf): tell libctf about the symtab and
strtab.
(struct ctf_strsym_iter_cb_arg): New, state to do so.
(ldelf_ctf_strtab_iter_cb): New: tell libctf about
each string in the strtab in turn.
(ldelf_ctf_symbols_iter_cb): New, tell libctf
about each symbol in the symtab in turn.
* ldelfgen.h (struct elf_sym_strtab): Add forward.
(struct elf_strtab_hash): Likewise.
(struct ctf_file): Likewise.
(ldelf_emit_ctf_early): Declare.
(ldelf_examine_strtab_for_ctf): Likewise.
* emultempl/elf-generic.em (LDEMUL_EMIT_CTF_EARLY): Set it.
(LDEMUL_EXAMINE_STRTAB_FOR_CTF): Likewise.
* emultempl/aix.em (ld_${EMULATION_NAME}_emulation): Add
emit_ctf_early and examine_strtab_for_ctf, NULL by default.
* emultempl/armcoff.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/beos.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/elf.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/generic.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/linux.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/msp430.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/pe.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/pep.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/ticoff.em (ld_${EMULATION_NAME}_emulation): Likewise.
* emultempl/vanilla.em (ld_vanilla_emulation): Likewise.
* Makefile.am: Pull in libctf (and zlib, a transitive requirement
for compressed CTF section emission). Pass it on to DejaGNU.
* configure.ac: Add AM_ZLIB.
* aclocal.m4: Added zlib.m4.
* Makefile.in: Regenerated.
* testsuite/ld-bootstrap/bootstrap.exp: Use it when relinking ld.
|
||
|---|---|---|
| .. | ||
| doc | ||
| hosts | ||
| po | ||
| .gitignore | ||
| acinclude.m4 | ||
| aclocal.m4 | ||
| aix5ppc-core.c | ||
| aix386-core.c | ||
| aout32.c | ||
| aout64.c | ||
| aout-cris.c | ||
| aout-ns32k.c | ||
| aout-target.h | ||
| aout-tic30.c | ||
| aoutx.h | ||
| arc-got.h | ||
| arc-plt.def | ||
| arc-plt.h | ||
| archive64.c | ||
| archive.c | ||
| archures.c | ||
| bfd-in2.h | ||
| bfd-in.h | ||
| bfd.c | ||
| bfd.m4 | ||
| bfdio.c | ||
| bfdwin.c | ||
| binary.c | ||
| cache.c | ||
| cf-i386lynx.c | ||
| ChangeLog | ||
| ChangeLog-0001 | ||
| ChangeLog-0203 | ||
| ChangeLog-2004 | ||
| ChangeLog-2005 | ||
| ChangeLog-2006 | ||
| ChangeLog-2007 | ||
| ChangeLog-2008 | ||
| ChangeLog-2009 | ||
| ChangeLog-2010 | ||
| ChangeLog-2011 | ||
| ChangeLog-2012 | ||
| ChangeLog-2013 | ||
| ChangeLog-2014 | ||
| ChangeLog-2015 | ||
| ChangeLog-2016 | ||
| ChangeLog-2017 | ||
| ChangeLog-2018 | ||
| ChangeLog-9193 | ||
| ChangeLog-9495 | ||
| ChangeLog-9697 | ||
| ChangeLog-9899 | ||
| cisco-core.c | ||
| coff64-rs6000.c | ||
| coff-alpha.c | ||
| coff-arm.c | ||
| coff-arm.h | ||
| coff-bfd.c | ||
| coff-bfd.h | ||
| coff-go32.c | ||
| coff-i386.c | ||
| coff-ia64.c | ||
| coff-mcore.c | ||
| coff-mips.c | ||
| coff-ppc.c | ||
| coff-rs6000.c | ||
| coff-sh.c | ||
| coff-stgo32.c | ||
| coff-tic4x.c | ||
| coff-tic30.c | ||
| coff-tic54x.c | ||
| coff-tic80.c | ||
| coff-x86_64.c | ||
| coff-z8k.c | ||
| coff-z80.c | ||
| coffcode.h | ||
| coffgen.c | ||
| cofflink.c | ||
| coffswap.h | ||
| compress.c | ||
| config.bfd | ||
| config.in | ||
| configure | ||
| configure.ac | ||
| configure.com | ||
| configure.host | ||
| COPYING | ||
| corefile.c | ||
| cpu-aarch64.c | ||
| cpu-aarch64.h | ||
| cpu-alpha.c | ||
| cpu-arc.c | ||
| cpu-arm.c | ||
| cpu-arm.h | ||
| cpu-avr.c | ||
| cpu-bfin.c | ||
| cpu-bpf.c | ||
| cpu-cr16.c | ||
| cpu-cr16c.c | ||
| cpu-cris.c | ||
| cpu-crx.c | ||
| cpu-csky.c | ||
| cpu-d10v.c | ||
| cpu-d30v.c | ||
| cpu-dlx.c | ||
| cpu-epiphany.c | ||
| cpu-fr30.c | ||
| cpu-frv.c | ||
| cpu-ft32.c | ||
| cpu-h8300.c | ||
| cpu-h8300.h | ||
| cpu-hppa.c | ||
| cpu-i386.c | ||
| cpu-ia64-opc.c | ||
| cpu-ia64.c | ||
| cpu-iamcu.c | ||
| cpu-ip2k.c | ||
| cpu-iq2000.c | ||
| cpu-k1om.c | ||
| cpu-l1om.c | ||
| cpu-lm32.c | ||
| cpu-m9s12x.c | ||
| cpu-m9s12xg.c | ||
| cpu-m32c.c | ||
| cpu-m32r.c | ||
| cpu-m68hc11.c | ||
| cpu-m68hc12.c | ||
| cpu-m68k.c | ||
| cpu-m68k.h | ||
| cpu-m10200.c | ||
| cpu-m10300.c | ||
| cpu-mcore.c | ||
| cpu-mep.c | ||
| cpu-metag.c | ||
| cpu-microblaze.c | ||
| cpu-mips.c | ||
| cpu-mmix.c | ||
| cpu-moxie.c | ||
| cpu-msp430.c | ||
| cpu-mt.c | ||
| cpu-nds32.c | ||
| cpu-nfp.c | ||
| cpu-nios2.c | ||
| cpu-ns32k.c | ||
| cpu-or1k.c | ||
| cpu-pdp11.c | ||
| cpu-pj.c | ||
| cpu-plugin.c | ||
| cpu-powerpc.c | ||
| cpu-pru.c | ||
| cpu-riscv.c | ||
| cpu-rl78.c | ||
| cpu-rs6000.c | ||
| cpu-rx.c | ||
| cpu-s12z.c | ||
| cpu-s390.c | ||
| cpu-score.c | ||
| cpu-sh.c | ||
| cpu-sparc.c | ||
| cpu-spu.c | ||
| cpu-tic4x.c | ||
| cpu-tic6x.c | ||
| cpu-tic30.c | ||
| cpu-tic54x.c | ||
| cpu-tic80.c | ||
| cpu-tilegx.c | ||
| cpu-tilepro.c | ||
| cpu-v850_rh850.c | ||
| cpu-v850.c | ||
| cpu-vax.c | ||
| cpu-visium.c | ||
| cpu-wasm32.c | ||
| cpu-xc16x.c | ||
| cpu-xgate.c | ||
| cpu-xstormy16.c | ||
| cpu-xtensa.c | ||
| cpu-z8k.c | ||
| cpu-z80.c | ||
| dep-in.sed | ||
| development.sh | ||
| dwarf1.c | ||
| dwarf2.c | ||
| ecoff-bfd.h | ||
| ecoff.c | ||
| ecofflink.c | ||
| ecoffswap.h | ||
| elf32-am33lin.c | ||
| elf32-arc.c | ||
| elf32-arm.c | ||
| elf32-arm.h | ||
| elf32-avr.c | ||
| elf32-avr.h | ||
| elf32-bfin.c | ||
| elf32-bfin.h | ||
| elf32-cr16.c | ||
| elf32-cr16.h | ||
| elf32-cr16c.c | ||
| elf32-cris.c | ||
| elf32-crx.c | ||
| elf32-csky.c | ||
| elf32-csky.h | ||
| elf32-d10v.c | ||
| elf32-d30v.c | ||
| elf32-dlx.c | ||
| elf32-dlx.h | ||
| elf32-epiphany.c | ||
| elf32-fr30.c | ||
| elf32-frv.c | ||
| elf32-ft32.c | ||
| elf32-gen.c | ||
| elf32-h8300.c | ||
| elf32-hppa.c | ||
| elf32-hppa.h | ||
| elf32-i386.c | ||
| elf32-ip2k.c | ||
| elf32-iq2000.c | ||
| elf32-lm32.c | ||
| elf32-m32c.c | ||
| elf32-m32r.c | ||
| elf32-m68hc1x.c | ||
| elf32-m68hc1x.h | ||
| elf32-m68hc11.c | ||
| elf32-m68hc12.c | ||
| elf32-m68k.c | ||
| elf32-m68k.h | ||
| elf32-mcore.c | ||
| elf32-mep.c | ||
| elf32-metag.c | ||
| elf32-metag.h | ||
| elf32-microblaze.c | ||
| elf32-mips.c | ||
| elf32-moxie.c | ||
| elf32-msp430.c | ||
| elf32-mt.c | ||
| elf32-nds32.c | ||
| elf32-nds32.h | ||
| elf32-nios2.c | ||
| elf32-nios2.h | ||
| elf32-or1k.c | ||
| elf32-pj.c | ||
| elf32-ppc.c | ||
| elf32-ppc.h | ||
| elf32-pru.c | ||
| elf32-rl78.c | ||
| elf32-rx.c | ||
| elf32-rx.h | ||
| elf32-s12z.c | ||
| elf32-s390.c | ||
| elf32-score7.c | ||
| elf32-score.c | ||
| elf32-score.h | ||
| elf32-sh-relocs.h | ||
| elf32-sh.c | ||
| elf32-sparc.c | ||
| elf32-spu.c | ||
| elf32-spu.h | ||
| elf32-tic6x.c | ||
| elf32-tic6x.h | ||
| elf32-tilegx.c | ||
| elf32-tilegx.h | ||
| elf32-tilepro.c | ||
| elf32-tilepro.h | ||
| elf32-v850.c | ||
| elf32-v850.h | ||
| elf32-vax.c | ||
| elf32-visium.c | ||
| elf32-wasm32.c | ||
| elf32-xc16x.c | ||
| elf32-xgate.c | ||
| elf32-xstormy16.c | ||
| elf32-xtensa.c | ||
| elf32.c | ||
| elf64-alpha.c | ||
| elf64-bpf.c | ||
| elf64-gen.c | ||
| elf64-hppa.c | ||
| elf64-hppa.h | ||
| elf64-ia64-vms.c | ||
| elf64-mips.c | ||
| elf64-mmix.c | ||
| elf64-nfp.c | ||
| elf64-ppc.c | ||
| elf64-ppc.h | ||
| elf64-s390.c | ||
| elf64-sparc.c | ||
| elf64-tilegx.c | ||
| elf64-tilegx.h | ||
| elf64-x86-64.c | ||
| elf64.c | ||
| elf-attrs.c | ||
| elf-bfd.h | ||
| elf-eh-frame.c | ||
| elf-hppa.h | ||
| elf-ifunc.c | ||
| elf-linker-x86.h | ||
| elf-linux-core.h | ||
| elf-m10200.c | ||
| elf-m10300.c | ||
| elf-nacl.c | ||
| elf-nacl.h | ||
| elf-properties.c | ||
| elf-s390-common.c | ||
| elf-s390.h | ||
| elf-strtab.c | ||
| elf-vxworks.c | ||
| elf-vxworks.h | ||
| elf.c | ||
| elfcode.h | ||
| elfcore.h | ||
| elflink.c | ||
| elfn32-mips.c | ||
| elfnn-aarch64.c | ||
| elfnn-ia64.c | ||
| elfnn-riscv.c | ||
| elfxx-aarch64.c | ||
| elfxx-aarch64.h | ||
| elfxx-ia64.c | ||
| elfxx-ia64.h | ||
| elfxx-mips.c | ||
| elfxx-mips.h | ||
| elfxx-riscv.c | ||
| elfxx-riscv.h | ||
| elfxx-sparc.c | ||
| elfxx-sparc.h | ||
| elfxx-target.h | ||
| elfxx-tilegx.c | ||
| elfxx-tilegx.h | ||
| elfxx-x86.c | ||
| elfxx-x86.h | ||
| format.c | ||
| gen-aout.c | ||
| genlink.h | ||
| go32stub.h | ||
| hash.c | ||
| host-aout.c | ||
| hppabsd-core.c | ||
| hpux-core.c | ||
| i386aout.c | ||
| i386bsd.c | ||
| i386lynx.c | ||
| i386msdos.c | ||
| ihex.c | ||
| init.c | ||
| irix-core.c | ||
| libaout.h | ||
| libbfd-in.h | ||
| libbfd.c | ||
| libbfd.h | ||
| libcoff-in.h | ||
| libcoff.h | ||
| libecoff.h | ||
| libhppa.h | ||
| libpei.h | ||
| libxcoff.h | ||
| linker.c | ||
| lynx-core.c | ||
| mach-o-aarch64.c | ||
| mach-o-arm.c | ||
| mach-o-i386.c | ||
| mach-o-target.c | ||
| mach-o-x86-64.c | ||
| mach-o.c | ||
| mach-o.h | ||
| MAINTAINERS | ||
| Makefile.am | ||
| Makefile.in | ||
| makefile.vms | ||
| mep-relocs.pl | ||
| merge.c | ||
| mmo.c | ||
| netbsd-core.c | ||
| netbsd.h | ||
| ns32k.h | ||
| ns32knetbsd.c | ||
| opncls.c | ||
| osf-core.c | ||
| pc532-mach.c | ||
| pdp11.c | ||
| pe-arm-wince.c | ||
| pe-arm.c | ||
| pe-i386.c | ||
| pe-mcore.c | ||
| pe-ppc.c | ||
| pe-sh.c | ||
| pe-x86_64.c | ||
| pef-traceback.h | ||
| pef.c | ||
| pef.h | ||
| pei-arm-wince.c | ||
| pei-arm.c | ||
| pei-i386.c | ||
| pei-ia64.c | ||
| pei-mcore.c | ||
| pei-ppc.c | ||
| pei-sh.c | ||
| pei-x86_64.c | ||
| peicode.h | ||
| peXXigen.c | ||
| plugin.c | ||
| plugin.h | ||
| PORTING | ||
| ppcboot.c | ||
| ptrace-core.c | ||
| README | ||
| reloc16.c | ||
| reloc.c | ||
| rs6000-core.c | ||
| sco5-core.c | ||
| section.c | ||
| simple.c | ||
| som.c | ||
| som.h | ||
| srec.c | ||
| stab-syms.c | ||
| stabs.c | ||
| stamp-h.in | ||
| syms.c | ||
| sysdep.h | ||
| targets.c | ||
| targmatch.sed | ||
| tekhex.c | ||
| TODO | ||
| trad-core.c | ||
| vax1knetbsd.c | ||
| vaxnetbsd.c | ||
| verilog.c | ||
| version.h | ||
| version.m4 | ||
| vms-alpha.c | ||
| vms-lib.c | ||
| vms-misc.c | ||
| vms.h | ||
| warning.m4 | ||
| wasm-module.c | ||
| wasm-module.h | ||
| xcofflink.c | ||
| xcofflink.h | ||
| xsym.c | ||
| xsym.h | ||
| xtensa-isa.c | ||
| xtensa-modules.c | ||
BFD is an object file library. It permits applications to use the
same routines to process object files regardless of their format.
BFD is used by the GNU debugger, assembler, linker, and the binary
utilities.
The documentation on using BFD is scanty and may be occasionally
incorrect. Pointers to documentation problems, or an entirely
rewritten manual, would be appreciated.
There is some BFD internals documentation in doc/bfdint.texi which may
help programmers who want to modify BFD.
BFD is normally built as part of another package. See the build
instructions for that package, probably in a README file in the
appropriate directory.
BFD supports the following configure options:
--target=TARGET
The default target for which to build the library. TARGET is
a configuration target triplet, such as sparc-sun-solaris.
--enable-targets=TARGET,TARGET,TARGET...
Additional targets the library should support. To include
support for all known targets, use --enable-targets=all.
--enable-64-bit-bfd
Include support for 64 bit targets. This is automatically
turned on if you explicitly request a 64 bit target, but not
for --enable-targets=all. This requires a compiler with a 64
bit integer type, such as gcc.
--enable-shared
Build BFD as a shared library.
--with-mmap
Use mmap when accessing files. This is faster on some hosts,
but slower on others. It may not work on all hosts.
Report bugs with BFD to bug-binutils@gnu.org.
Patches are encouraged. When sending patches, always send the output
of diff -u or diff -c from the original file to the new file. Do not
send default diff output. Do not make the diff from the new file to
the original file. Remember that any patch must not break other
systems. Remember that BFD must support cross compilation from any
host to any target, so patches which use ``#ifdef HOST'' are not
acceptable. Please also read the ``Reporting Bugs'' section of the
gcc manual.
Bug reports without patches will be remembered, but they may never get
fixed until somebody volunteers to fix them.
Copyright (C) 2012-2019 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.