DBX Options - GNU Compiler Collection (GCC) Internals
Description: GNU Compiler Collection (GCC) Internals

Next: DBX Hooks, Previous: All Debuggers, Up: Debugging Info

#### 17.22.2 Specific Options for DBX Output

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.