xref: /netbsd-src/external/gpl3/binutils.old/dist/binutils/doc/ctf.options.texi (revision c42dbd0ed2e61fe6eda8590caa852ccf34719964)
1867d70fcSchristos@c This file contains the entry for the --ctf, --ctf-parent, --ctf-symbols, -and
2867d70fcSchristos@c --ctf-strings options that are common to both readelf and objdump.
3867d70fcSchristos
4*c42dbd0eSchristos@item --ctf[=@var{section}]
5867d70fcSchristos@cindex CTF
6867d70fcSchristos@cindex Compact Type Format
7867d70fcSchristos
8867d70fcSchristosDisplay the contents of the specified CTF section.  CTF sections themselves
9867d70fcSchristoscontain many subsections, all of which are displayed in order.
10867d70fcSchristos
11*c42dbd0eSchristosBy default, display the name of the section named @var{.ctf}, which is the
12*c42dbd0eSchristosname emitted by @command{ld}.
13867d70fcSchristos
14*c42dbd0eSchristos@item --ctf-parent=@var{member}
15*c42dbd0eSchristos
16*c42dbd0eSchristosIf the CTF section contains ambiguously-defined types, it will consist
17*c42dbd0eSchristosof an archive of many CTF dictionaries, all inheriting from one
18*c42dbd0eSchristosdictionary containing unambiguous types.  This member is by default
19*c42dbd0eSchristosnamed @var{.ctf}, like the section containing it, but it is possible to
20*c42dbd0eSchristoschange this name using the @code{ctf_link_set_memb_name_changer}
21*c42dbd0eSchristosfunction at link time.  When looking at CTF archives that have been
22*c42dbd0eSchristoscreated by a linker that uses the name changer to rename the parent
23*c42dbd0eSchristosarchive member, @option{--ctf-parent} can be used to specify the name
24*c42dbd0eSchristosused for the parent.
25