Bug 94491 - -g2 debugging level is not documented
Summary: -g2 debugging level is not documented
Status: NEW
Alias: None
Product: gcc
Classification: Unclassified
Component: debug (show other bugs)
Version: 10.0
: P3 normal
Target Milestone: ---
Assignee: Not yet assigned to anyone
URL:
Keywords: documentation
Depends on:
Blocks:
 
Reported: 2020-04-05 11:04 UTC by Sergei Trofimovich
Modified: 2021-08-31 03:42 UTC (History)
2 users (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2020-04-06 00:00:00


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Sergei Trofimovich 2020-04-05 11:04:20 UTC
A tiny backstory: to profile a program I built it with '-g'. The result did not fit in my RAM and machine crashed. Looking at the doc I found out '-g' means '-g2' (and not '-g1').

Worth documenting what -g2 actually do? Others are interested as well: https://stackoverflow.com/questions/10475040/gcc-g-vs-g3-gdb-flag-what-is-the-difference


'man gcc' covers only 0,1 and 3:

"""
       -glevel
       -ggdblevel
       -gstabslevel
       -gxcofflevel
       -gvmslevel
           Request debugging information and also use level to specify how much information.  The default level is 2.

           Level 0 produces no debug information at all.  Thus, -g0 negates -g.

           Level 1 produces minimal information, enough for making backtraces in parts of the program that you don't plan to debug.  This includes descriptions of functions and external
           variables, and line number tables, but no information about local variables.

           Level 3 includes extra information, such as all the macro definitions present in the program.  Some debuggers support macro expansion when you use -g3.

           If you use multiple -g options, with or without level numbers, the last such option is the one that is effective.

           -gdwarf does not accept a concatenated debug level, to avoid confusion with -gdwarf-level.  Instead use an additional -glevel option to change the debug level for DWARF.
"""
Comment 1 Martin Liška 2020-04-06 06:49:30 UTC
Confirmed.