procyberian/gcc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

CTF/BTF documentation

Browse source 
This commit documents the new command line options introduced by the
CTF and BTF debug formats.

2021-06-28  Indu Bhagat  <indu.bhagat@oracle.com>

	* doc/invoke.texi: Document the CTF and BTF debug info options.
This commit is contained in:
Indu Bhagat 2021-05-20 11:20:50 -07:00 • committed by Jose E. Marchesi
parent c1f76af469
commit 824a6a52a6
1 changed files with 31 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
gcc/doc/invoke.texi
View file

@ -466,6 +466,7 @@ Objective-C and Objective-C++ Dialects}.
@item Debugging Options
@xref{Debugging Options,,Options for Debugging Your Program}.
@gccoptlist{-g -g@var{level} -gdwarf -gdwarf-@var{version} @gol
-gbtf -gctf -gctf@var{level} @gol
-ggdb -grecord-gcc-switches -gno-record-gcc-switches @gol
-gstabs -gstabs+ -gstrict-dwarf -gno-strict-dwarf @gol
-gas-loc-support -gno-as-loc-support @gol
@ -9647,7 +9648,9 @@ in the ``exploded graph'' and diagnostics associated with them.
@cindex debugging information options
To tell GCC to emit extra information for use by a debugger, in almost
all cases you need only to add @option{-g} to your other options.
all cases you need only to add @option{-g} to your other options. Some debug
formats can co-exist (like DWARF with CTF) when each of them is enabled
explicitly by adding the respective command line option to your other options.
GCC allows you to use @option{-g} with
@option{-O}. The shortcuts taken by optimized code may occasionally
@ -9708,6 +9711,33 @@ other DWARF-related options such as
@option{-fno-dwarf2-cfi-asm}) retain a reference to DWARF Version 2
in their names, but apply to all currently-supported versions of DWARF.
@item -gbtf
@opindex gbtf
Request BTF debug information. BTF is the default debugging format for the
eBPF target. On other targets, like x86, BTF debug information can be
generated along with DWARF debug information when both of the debug formats are
enabled explicitly via their respective command line options.
@item -gctf
@itemx -gctf@var{level}
@opindex gctf
Request CTF debug information and use level to specify how much CTF debug
information should be produced. If @option{-gctf} is specified
without a value for level, the default level of CTF debug information is 2.
CTF debug information can be generated along with DWARF debug information when
both of the debug formats are enabled explicitly via their respective command
line options.
Level 0 produces no CTF debug information at all. Thus, @option{-gctf0}
negates @option{-gctf}.
Level 1 produces CTF information for tracebacks only. This includes callsite
information, but does not include type information.
Level 2 produces type information for entities (functions, data objects etc.)
at file-scope or global-scope only.
@item -gstabs
@opindex gstabs
Produce debugging information in stabs format (if that is supported),