aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc/invoke.texi
diff options
context:
space:
mode:
authorMartin Liska <mliska@suse.cz>2021-06-29 08:49:26 +0200
committerMartin Liska <mliska@suse.cz>2021-06-29 08:49:26 +0200
commit490d1e1be15b62b51a2de248e6d7f76356402bc9 (patch)
treea140872a97abd647ca0e5287e5375b7514be227b /gcc/doc/invoke.texi
parentadf0825ae77554b00615521a545b608892bb272c (diff)
parent095a01cf6e3883b3083cf339b680cdb39910f529 (diff)
downloadgcc-490d1e1be15b62b51a2de248e6d7f76356402bc9.zip
gcc-490d1e1be15b62b51a2de248e6d7f76356402bc9.tar.gz
gcc-490d1e1be15b62b51a2de248e6d7f76356402bc9.tar.bz2
Merge branch 'master' into devel/sphinx
Diffstat (limited to 'gcc/doc/invoke.texi')
-rw-r--r--gcc/doc/invoke.texi32
1 files changed, 31 insertions, 1 deletions
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 95020a0..fa05888 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -429,6 +429,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
@@ -9610,7 +9611,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
@@ -9671,6 +9674,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),