GNU Compiler Collection (GCC) Internals: DBX Options

GNU Compiler Collection (GCC) Internals: DBX Options

These are specific options for DBX output.

Macro: DBX_DEBUGGING_INFO: Define this macro if GCC should produce debugging output for DBX in response to the -g option.

Macro: XCOFF_DEBUGGING_INFO: Define this macro if GCC should produce XCOFF format debugging output in response to the -g option. This is a variant of DBX format.

Macro: DEFAULT_GDB_EXTENSIONS: Define this macro to control whether GCC should by default generate GDB’s extended version of DBX debugging information (assuming DBX-format debugging information is enabled at all). If you don’t define the macro, the default is 1: always generate the extended information if there is any occasion to.

Macro: DEBUG_SYMS_TEXT: Define this macro if all .stabs commands should be output while in the text section.

Macro: ASM_STABS_OP: A C string constant, including spacing, naming the assembler pseudo op to use instead of "\t.stabs\t" to define an ordinary debugging symbol. If you don’t define this macro, "\t.stabs\t" is used. This macro applies only to DBX debugging information format.

Macro: ASM_STABD_OP: A C string constant, including spacing, naming the assembler pseudo op to use instead of "\t.stabd\t" to define a debugging symbol whose value is the current location. If you don’t define this macro, "\t.stabd\t" is used. This macro applies only to DBX debugging information format.

Macro: ASM_STABN_OP: A C string constant, including spacing, naming the assembler pseudo op to use instead of "\t.stabn\t" to define a debugging symbol with no name. If you don’t define this macro, "\t.stabn\t" is used. This macro applies only to DBX debugging information format.

Macro: DBX_NO_XREFS: Define this macro if DBX on your system does not support the construct ‘xstagname’. On some systems, this construct is used to describe a forward reference to a structure named tagname. On other systems, this construct is not supported at all.

Macro: DBX_CONTIN_LENGTH: A symbol name in DBX-format debugging information is normally continued (split into two separate .stabs directives) when it exceeds a certain length (by default, 80 characters). On some operating systems, DBX requires this splitting; on others, splitting must not be done. You can inhibit splitting by defining this macro with the value zero. You can override the default splitting-length by defining this macro as an expression for the length you desire.

Macro: DBX_CONTIN_CHAR: Normally continuation is indicated by adding a ‘\’ character to the end of a .stabs string when a continuation follows. To use a different character instead, define this macro as a character constant for the character you want to use. Do not define this macro if backslash is correct for your system.

Macro: DBX_STATIC_STAB_DATA_SECTION: Define this macro if it is necessary to go to the data section before outputting the ‘.stabs’ pseudo-op for a non-global static variable.

Macro: DBX_TYPE_DECL_STABS_CODE: The value to use in the “code” field of the .stabs directive for a typedef. The default is N_LSYM.

Macro: DBX_STATIC_CONST_VAR_CODE: The value to use in the “code” field of the .stabs directive for a static variable located in the text section. DBX format does not provide any “right” way to do this. The default is N_FUN.

Macro: DBX_REGPARM_STABS_CODE: The value to use in the “code” field of the .stabs directive for a parameter passed in registers. DBX format does not provide any “right” way to do this. The default is N_RSYM.

Macro: DBX_REGPARM_STABS_LETTER: The letter to use in DBX symbol data to identify a symbol as a parameter passed in registers. DBX format does not customarily provide any way to do this. The default is 'P'.

Macro: DBX_FUNCTION_FIRST: Define this macro if the DBX information for a function and its arguments should precede the assembler code for the function. Normally, in DBX format, the debugging information entirely follows the assembler code.

Macro: DBX_BLOCKS_FUNCTION_RELATIVE: Define this macro, with value 1, if the value of a symbol describing the scope of a block (N_LBRAC or N_RBRAC) should be relative to the start of the enclosing function. Normally, GCC uses an absolute address.

Macro: DBX_LINES_FUNCTION_RELATIVE: Define this macro, with value 1, if the value of a symbol indicating the current line number (N_SLINE) should be relative to the start of the enclosing function. Normally, GCC uses an absolute address.

Macro: DBX_USE_BINCL: Define this macro if GCC should generate N_BINCL and N_EINCL stabs for included header files, as on Sun systems. This macro also directs GCC to output a type number as a pair of a file number and a type number within the file. Normally, GCC does not generate N_BINCL or N_EINCL stabs, and it outputs a single number for a type number.