gcc -g :what will happen

That’s kind of right, but incomplete. -g requests that the compiler and linker generate and retain source-level debugging/symbol information in the executable itself.

If…

  • the program happens to later crash and produce a core file (which suggests some problem in the actual code), or
  • a deliberate OS command forced it to core (e.g. kill -SIGQUIT pid), or
  • the program calls a function that dumps core (e.g. abort)

…- none of which are actually caused by the use of -g – then the debugger will know how to read that “-g” symbol information from the executable and cross-reference it with the core. This means you can see the proper names of variables and functions in your stack frames, get line numbers and see the source as you step around in the executable.

That debug information is useful whenever debugging – whether you started with a core or just the executable alone. It even helps produce better output from commands like pstack.

Note that your environment may have other settings to control whether cores are generated (they can be big, and there’s no general way to know if/when they can be removed, so they’re not always wanted). For example, on UNIX/LINUX shells it’s often ulimit -c.

You may also be interested to read about DWARF Wikipedia – a commonly used debugging information format for encoding the embedded debug/symbol information in executable/library objects (e.g. on UNIX and Linux).

UPDATE per Victor’s request in comments…

Symbol information lists identifiers from the source code (usually only after any name mangling needed), the (virtual) memory addresses/offsets at which they’ll be loaded in the process memory, the type (e.g. data vs. code). For example…

$ cat ok.cc
int g_my_num;
namespace NS { int ns_my_num = 2; }
int f() { return g_my_num + NS::ns_my_num; }
int main() { return f(); }

$ g++ -g ok.cc -o ok    # compile ok executable with symbol info

$ nm ok    # show mangled identifiers
00000000004017c8 d _DYNAMIC
0000000000401960 d _GLOBAL_OFFSET_TABLE_
0000000000400478 R _IO_stdin_used
                 w _ITM_deregisterTMCloneTable
                 w _ITM_registerTMCloneTable
                 w _Jv_RegisterClasses
000000000040037c T _Z1fv                     # this is f()
0000000000401798 D _ZN2NS9ns_my_numE         # this is NS::ns_my_num
00000000004017a8 d __CTOR_END__
00000000004017a0 d __CTOR_LIST__
00000000004017b8 d __DTOR_END__
00000000004017b0 d __DTOR_LIST__
0000000000400540 r __FRAME_END__
00000000004017c0 d __JCR_END__
00000000004017c0 d __JCR_LIST__
00000000004017c8 d __TMC_END__
00000000004017c8 d __TMC_LIST__
0000000000401980 A __bss_start
0000000000401788 D __data_start
0000000000400440 t __do_global_ctors_aux
00000000004002e0 t __do_global_dtors_aux
0000000000401790 d __dso_handle
0000000000000000 a __fini_array_end
0000000000000000 a __fini_array_start
                 w __gmon_start__
0000000000000000 a __init_array_end
0000000000000000 a __init_array_start
00000000004003a0 T __libc_csu_fini
00000000004003b0 T __libc_csu_init
                 U __libc_start_main
0000000000000000 a __preinit_array_end
0000000000000000 a __preinit_array_start
0000000000401980 A _edata
0000000000401994 A _end
0000000000400494 T _fini
000000000040047c T _init
0000000000400220 T _start
000000000040024c t call_gmon_start
0000000000401980 b completed.6118
0000000000401788 W data_start
0000000000400270 t deregister_tm_clones
0000000000401988 b dtor_idx.6120
0000000000401994 A end
0000000000400350 t frame_dummy
0000000000401990 B g_my_num                   # our global g_my_num
0000000000400390 T main                       # the int main() function
00000000004002a0 t register_tm_clones

$ nm ok | c++filt            # c++filt "unmangles" identifiers...
00000000004017c8 d _DYNAMIC
0000000000401960 d _GLOBAL_OFFSET_TABLE_
0000000000400478 R _IO_stdin_used
                 w _ITM_deregisterTMCloneTable
                 w _ITM_registerTMCloneTable
                 w _Jv_RegisterClasses
000000000040037c T f()
0000000000401798 D NS::ns_my_num
00000000004017a8 d __CTOR_END__
00000000004017a0 d __CTOR_LIST__
00000000004017b8 d __DTOR_END__
00000000004017b0 d __DTOR_LIST__
0000000000400540 r __FRAME_END__
00000000004017c0 d __JCR_END__
00000000004017c0 d __JCR_LIST__
00000000004017c8 d __TMC_END__
00000000004017c8 d __TMC_LIST__
0000000000401980 A __bss_start
0000000000401788 D __data_start
0000000000400440 t __do_global_ctors_aux
00000000004002e0 t __do_global_dtors_aux
0000000000401790 d __dso_handle
0000000000000000 a __fini_array_end
0000000000000000 a __fini_array_start
                 w __gmon_start__
0000000000000000 a __init_array_end
0000000000000000 a __init_array_start
00000000004003a0 T __libc_csu_fini
00000000004003b0 T __libc_csu_init
                 U __libc_start_main
0000000000000000 a __preinit_array_end
0000000000000000 a __preinit_array_start
0000000000401980 A _edata
0000000000401994 A _end
0000000000400494 T _fini
000000000040047c T _init
0000000000400220 T _start
000000000040024c t call_gmon_start
0000000000401980 b completed.6118
0000000000401788 W data_start
0000000000400270 t deregister_tm_clones
0000000000401988 b dtor_idx.6120
0000000000401994 A end
0000000000400350 t frame_dummy
0000000000401990 B g_my_num
0000000000400390 T main
00000000004002a0 t register_tm_clones

Notes:

  • our functions f() and main() are type T (which stands for “TEXT” – used for read-only non-zero memory content whether it’s actually text or other data or executable code),
  • g_my_num is B being a global with implicitly zero-ed out memory, while
  • NS::ns_my_num is D as the executable has to explicitly provide the value 2 to occupy that memory.

The man/info-page for nm documents these things further….

Related Posts:

  1. Convert char to int in C and C++
  2. Fatal error: iostream: No such file or directory in compiling C program using GCC
  3. gcc/g++: “No such file or directory”
  4. Debug vs Release in CMake
  5. Debug vs Release in CMake
  6. What’s the difference between nexti and stepi in gdb?
  7. gcc: undefined reference to
  8. cc1.exe System Error – libwinpthread-1.dll missing – But it isn’t
  9. Fatal error: iostream: No such file or directory in compiling C program using GCC
  10. Linker error: “linker input file unused because linking not done”, undefined reference to a function in that file
  11. What is a segmentation fault?
  12. How many spaces for tab character(\t)?
  13. What is the difference between g++ and gcc?
  14. What does (~0L) mean?
  15. What is the difference between float and double?
  16. What is the effect of extern “C” in C++?
  17. Why are #ifndef and #define used in C++ header files?
  18. g++ ld: symbol(s) not found for architecture x86_64
  19. What exactly is the difference between “pass by reference” in C and in C++?
  20. When to use extern “C” in simple words? [duplicate]
  21. Floating point exception( core dump
  22. Mutex example / tutorial? [closed]
  23. What does “dereferencing” a pointer mean?
  24. What is an unsigned char?
  25. What does “dereferencing” a pointer mean?
  26. Why use conio.h?
  27. How to track down a “double free or corruption” error
  28. Convert an int to ASCII character
  29. How to track down a “double free or corruption” error
  30. Why unsigned int 0xFFFFFFFF is equal to int -1?
  31. What is the significance of return 0 in C and C++?
  32. How to go from fopen to fopen_s
  33. Undefined reference to vtable
  34. Expected initializer before function name
  35. Inheriting constructors
  36. Difference between long double and double in C and C++ [duplicate]
  37. What is use of c_str function In c++
  38. What is the difference between const int*, const int * const, and int const *?
  39. How to print pthread_t
  40. What is the difference between const int*, const int * const, and int const *?
  41. C ++ error: a expected initializer before [function name]
  42. Inheriting constructors
  43. What is the printf format specifier for bool?
  44. Fastest way to check if a file exist using standard C++/C++11,14,17/C?
  45. Is there a function to copy an array in C/C++?
  46. Difference between using Makefile and CMake to compile the code
  47. Should I learn C before learning C++?
  48. undefined reference to ‘std::cout’
  49. Eclipse C++ : “Program “g++” not found in PATH”
  50. Visual Studio debugger error: Unable to start program Specified file cannot be found
  51. MinGW: “gcc is not recognized as an internal or external command”
  52. Convert Python program to C/C++ code?
  53. Is “argv[0] = name-of-executable” an accepted standard or just a common convention?
  54. Examples of good gotos in C or C++
  55. Compiling a C++ program with gcc
  56. How to convert C++ Code to C
  57. How to make an array with a dynamic size? General usage of dynamic arrays (maybe pointers too)?
  58. Fatal error: ‘stdafx.h’ file not found
  59. warning: control reaches end of non-void function [-Wreturn-type]
  60. How to use glOrtho() in OpenGL?
  61. Best C/C++ Network Library
  62. Is the sizeof(some pointer) always equal to four?
  63. How do malloc() and free() work?
  64. C++ array assign error: invalid array assignment
  65. CMake error at CMakeLists.txt:30 (project): No CMAKE_C_COMPILER could be found
  66. How to run valgrind with basic c example?
  67. Typedef function pointer?
  68. cannot declare variable ‘’ to be of abstract type ‘’
  69. “…redeclared as different kind of symbol”?
  70. What is the use of intptr_t?
  71. How can I get the list of files in a directory using C or C++?
  72. What does “Permission denied” “Id returned 1 exit status” mean?
  73. Multi-character constant warnings
  74. What is the C equivalent to the C++ cin statement?
  75. Static linking vs dynamic linking
  76. C++ – Too Many Initializers for Arrays
  77. Reading string by char till end of line C/C++
  78. Is there a replacement for unistd.h for Windows (Visual C)?
  79. What does the fpermissive flag do?
  80. How to project a point onto a plane in 3D?
  81. C: using strtol endptr is never NULL, cannot check if value is integer only?
  82. Why use pointers?
  83. Update GCC on OSX
  84. Double pointer array in c++
  85. GCC -fPIC option
  86. How to write log base(2) in c/c++
  87. What is the source of the data for the ProgramFiles, ProgramW6432Dir, ProgramFilesDir (x86), CommonProgramFiles environment variables?
  88. What’s the Use of ‘\r’ escape sequence?
  89. no debugging symbols found when using gdb
  90. Is there a standard sign function (signum, sgn) in C/C++?
  91. Warning : overflow in implicit constant conversion
  92. Using OpenMP with clang
  93. Warning: comparison of distinct pointer types
  94. Two decimal places using printf( )
  95. How to Check the Version of my gcc?
  96. Make / gcc cryptic error 2: how to have more information?
  97. Difference between the int * i and int** i
  98. Is there a way to compile C++ to C Code?
  99. “please check gdb is codesigned – see taskgated(8)” – How to get gdb installed with homebrew code signed?
  100. The tilde operator in C

2 thoughts on “gcc -g :what will happen”

  1. whoah this blog is wonderful i really like reading your articles. Keep up the great paintings! You realize, a lot of people are hunting round for this info, you could help them greatly.

    Reply

Leave a Comment