binutils/doc/ctf.options.texi

   1 @c This file contains the entry for the --ctf, --ctf-parent, --ctf-symbols, -and
   2 @c --ctf-strings options that are common to both readelf and objdump.
   3
   4 @item --ctf[=@var{section}]
   5 @cindex CTF
   6 @cindex Compact Type Format
   7
   8 Display the contents of the specified CTF section.  CTF sections themselves
   9 contain many subsections, all of which are displayed in order.
  10
  11 By default, display the name of the section named @var{.ctf}, which is the
  12 name emitted by @command{ld}.
  13
  14 @item --ctf-parent=@var{member}
  15
  16 If the CTF section contains ambiguously-defined types, it will consist
  17 of an archive of many CTF dictionaries, all inheriting from one
  18 dictionary containing unambiguous types.  This member is by default
  19 named @var{.ctf}, like the section containing it, but it is possible to
  20 change this name using the @code{ctf_link_set_memb_name_changer}
  21 function at link time.  When looking at CTF archives that have been
  22 created by a linker that uses the name changer to rename the parent
  23 archive member, @option{--ctf-parent} can be used to specify the name
  24 used for the parent.
  25
  26 @item --ctf-parent-section=@var{section}
  27
  28 This option lets you pick a completely different section for the CTF
  29 parent dictionary containing unambiguous types than for the child
  30 dictionaries that contain the ambiguous remainder.  The linker does
  31 not emit ELF objects structured like this, but some third-party linkers
  32 may.  It's also convenient to inspect CTF written out as multiple raw
  33 files to compose them with objcopy, which can put them in different
  34 ELF sections but not in different members of a single CTF dict.