[[PATCH V9] 5/7] CTF/BTF documentation

Richard Biener richard.guenther@gmail.com
Mon Jun 21 13:51:48 GMT 2021


On Mon, May 31, 2021 at 7:17 PM Jose E. Marchesi via Gcc-patches
<gcc-patches@gcc.gnu.org> wrote:
>
> This commit documents the new command line options introduced by the
> CTF and BTF debug formats.

Can you amend the cover text for 'Debugging Options' to mention that
there are debug formats that can co-exist with others (like DWARF with
CTF) but unless stated explicitly the -g<format> option specifies the
main debug info format to be used?  And for -gctf and friends document
it can work as alternate format (but also main, in case no other is specified?).

Thanks,
Richard.

> 2021-05-14  Indu Bhagat  <indu.bhagat@oracle.com>
>
>         * doc/invoke.texi: Document the CTF and BTF debug info options.
> ---
>  gcc/doc/invoke.texi | 20 ++++++++++++++++++++
>  1 file changed, 20 insertions(+)
>
> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> index 5cd4e2d993c..25dd50738de 100644
> --- a/gcc/doc/invoke.texi
> +++ b/gcc/doc/invoke.texi
> @@ -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
> @@ -9696,6 +9697,25 @@ 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.
> +
> +@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 -gctf is specified without a value for
> +level, the default level of CTF debug information is 2.
> +
> +Level 0 produces no CTF debug information at all.  Thus, -gctf0 negates -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),
> --
> 2.25.0.2.g232378479e
>


More information about the Gcc-patches mailing list