mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-02-11 13:02:10 +08:00
3d16b64e28
This is embarrassing. The whole point of CTF is that it remains intact even after a binary is stripped, providing a compact mapping from symbols to types for everything in the externally-visible interface of an ELF object: it has connections to the symbol table for that purpose, and to the string table to avoid duplicating symbol names. So it's a shame that the hooks I implemented last year served to hook it up to the .symtab and .strtab, which obviously disappear on strip, leaving any accompanying the CTF dict containing references to strings (and, soon, symbols) which don't exist any more because their containing strtab has been vaporized. The original Solaris design used .dynsym and .dynstr (well, actually, .ldynsym, which has more symbols) which do not disappear. So should we. Thankfully the work we did before serves as guide rails, and adjusting things to use the .dynstr and .dynsym was fast and easy. The only annoyance is that the dynsym is assembled inside elflink.c in a fairly piecemeal fashion, so that the easiest way to get the symbols out was to hook in before every call to swap_symbol_out (we also leave in a hook in front of symbol additions to the .symtab because it seems plausible that we might want to hook them in future too: for now that hook is unused). We adjust things so that rather than being offered a whole hash table of symbols at once, libctf is now given symbols one at a time, with st_name indexes already resolved and pointing at their final .dynstr offsets: it's now up to libctf to resolve these to names as needed using the strtab info we pass it separately. Some bits might be contentious. The ctf_new_dynstr callback takes an elf_internal_sym, and this remains an elf_internal_sym right down through the generic emulation layers into ldelfgen. This is no worse than the elf_sym_strtab we used to pass down, but in the future when we gain non-ELF CTF symtab support we might want to lower the elf_internal_sym to some other representation (perhaps a ctf_link_symbol) in bfd or in ldlang_ctf_new_dynsym. We rename the 'apply_strsym' hooks to 'acquire_strings' instead, becuse they no longer have anything to do with symbols. There are some API changes to pieces of API which are technically public but actually totally unused by anything and/or unused by anything but ld so they can change freely: the ctf_link_symbol gains new fields to allow symbol names to be given as strtab offsets as well as strings, and a symidx so that the symbol index can be passed in. ctf_link_shuffle_syms loses its callback parameter: the idea now is that linkers call the new ctf_link_add_linker_symbol for every symbol in .dynsym, feed in all the strtab entries with ctf_link_add_strtab, and then a call to ctf_link_shuffle_syms will apply both and arrange to use them to reorder the CTF symtab at CTF serialization time (which is coming in the next commit). Inside libctf we have a new preamble flag CTF_F_DYNSTR which is always set in v3-format CTF dicts from this commit forwards: CTF dicts without this flag are associated with .strtab like they used to be, so that old dicts' external strings don't turn to garbage when loaded by new libctf. Dicts with this flag are associated with .dynstr and .dynsym instead. (The flag is not the next in sequence because this commit was written quite late: the missing flags will be filled in by the next commit.) Tests forthcoming in a later commit in this series. bfd/ChangeLog 2020-11-20 Nick Alcock <nick.alcock@oracle.com> * elflink.c (elf_finalize_dynstr): Call examine_strtab after dynstr finalization. (elf_link_swap_symbols_out): Don't call it here. Call ctf_new_symbol before swap_symbol_out. (elf_link_output_extsym): Call ctf_new_dynsym before swap_symbol_out. (bfd_elf_final_link): Likewise. * elf.c (swap_out_syms): Pass in bfd_link_info. Call ctf_new_symbol before swap_symbol_out. (_bfd_elf_compute_section_file_positions): Adjust. binutils/ChangeLog 2020-11-20 Nick Alcock <nick.alcock@oracle.com> * readelf.c (dump_section_as_ctf): Use .dynsym and .dynstr, not .symtab and .strtab. include/ChangeLog 2020-11-20 Nick Alcock <nick.alcock@oracle.com> * bfdlink.h (struct elf_sym_strtab): Replace with... (struct elf_internal_sym): ... this. (struct bfd_link_callbacks) <examine_strtab>: Take only a symstrtab argument. <ctf_new_symbol>: New. <ctf_new_dynsym>: Likewise. * ctf-api.h (struct ctf_link_sym) <st_symidx>: New. <st_nameidx>: Likewise. <st_nameidx_set>: Likewise. (ctf_link_iter_symbol_f): Removed. (ctf_link_shuffle_syms): Remove most parameters, just takes a ctf_dict_t now. (ctf_link_add_linker_symbol): New, split from ctf_link_shuffle_syms. * ctf.h (CTF_F_DYNSTR): New. (CTF_F_MAX): Adjust. ld/ChangeLog 2020-11-20 Nick Alcock <nick.alcock@oracle.com> * ldelfgen.c (struct ctf_strsym_iter_cb_arg): Rename to... (struct ctf_strtab_iter_cb_arg): ... this, changing fields: <syms>: Remove. <symcount>: Remove. <symstrtab>: Rename to... <strtab>: ... this. (ldelf_ctf_strtab_iter_cb): Adjust. (ldelf_ctf_symbols_iter_cb): Remove. (ldelf_new_dynsym_for_ctf): New, tell libctf about a single symbol. (ldelf_examine_strtab_for_ctf): Rename to... (ldelf_acquire_strings_for_ctf): ... this, only doing the strtab portion and not symbols. * ldelfgen.h: Adjust declarations accordingly. * ldemul.c (ldemul_examine_strtab_for_ctf): Rename to... (ldemul_acquire_strings_for_ctf): ... this. (ldemul_new_dynsym_for_ctf): New. * ldemul.h: Adjust declarations accordingly. * ldlang.c (ldlang_ctf_apply_strsym): Rename to... (ldlang_ctf_acquire_strings): ... this. (ldlang_ctf_new_dynsym): New. (lang_write_ctf): Call ldemul_new_dynsym_for_ctf with NULL to do the actual symbol shuffle. * ldlang.h (struct elf_strtab_hash): Adjust accordingly. * ldmain.c (bfd_link_callbacks): Wire up new/renamed callbacks. libctf/ChangeLog 2020-11-20 Nick Alcock <nick.alcock@oracle.com> * ctf-link.c (ctf_link_shuffle_syms): Adjust. (ctf_link_add_linker_symbol): New, unimplemented stub. * libctf.ver: Add it. * ctf-create.c (ctf_serialize): Set CTF_F_DYNSTR on newly-serialized dicts. * ctf-open-bfd.c (ctf_bfdopen_ctfsect): Check for the flag: open the symtab/strtab if not present, dynsym/dynstr otherwise. * ctf-archive.c (ctf_arc_bufpreamble): New, get the preamble from some arbitrary member of a CTF archive. * ctf-impl.h (ctf_arc_bufpreamble): Declare it. |
||
|---|---|---|
| .. | ||
| 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 | ||
| 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-2019 | ||
| 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-rs6000.c | ||
| coff-sh.c | ||
| coff-stgo32.c | ||
| coff-tic4x.c | ||
| coff-tic30.c | ||
| coff-tic54x.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-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-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-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-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-z80.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-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-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-2020 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.