You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
209 lines
10 KiB
HTML
209 lines
10 KiB
HTML
<html lang="en">
|
|
<head>
|
|
<title>DBX Options - GNU Compiler Collection (GCC) Internals</title>
|
|
<meta http-equiv="Content-Type" content="text/html">
|
|
<meta name="description" content="GNU Compiler Collection (GCC) Internals">
|
|
<meta name="generator" content="makeinfo 4.13">
|
|
<link title="Top" rel="start" href="index.html#Top">
|
|
<link rel="up" href="Debugging-Info.html#Debugging-Info" title="Debugging Info">
|
|
<link rel="prev" href="All-Debuggers.html#All-Debuggers" title="All Debuggers">
|
|
<link rel="next" href="DBX-Hooks.html#DBX-Hooks" title="DBX Hooks">
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
|
<!--
|
|
Copyright (C) 1988-2015 Free Software Foundation, Inc.
|
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
|
any later version published by the Free Software Foundation; with the
|
|
Invariant Sections being ``Funding Free Software'', the Front-Cover
|
|
Texts being (a) (see below), and with the Back-Cover Texts being (b)
|
|
(see below). A copy of the license is included in the section entitled
|
|
``GNU Free Documentation License''.
|
|
|
|
(a) The FSF's Front-Cover Text is:
|
|
|
|
A GNU Manual
|
|
|
|
(b) The FSF's Back-Cover Text is:
|
|
|
|
You have freedom to copy and modify this GNU Manual, like GNU
|
|
software. Copies published by the Free Software Foundation raise
|
|
funds for GNU development.-->
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
|
<style type="text/css"><!--
|
|
pre.display { font-family:inherit }
|
|
pre.format { font-family:inherit }
|
|
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
|
pre.smallformat { font-family:inherit; font-size:smaller }
|
|
pre.smallexample { font-size:smaller }
|
|
pre.smalllisp { font-size:smaller }
|
|
span.sc { font-variant:small-caps }
|
|
span.roman { font-family:serif; font-weight:normal; }
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
|
--></style>
|
|
</head>
|
|
<body>
|
|
<div class="node">
|
|
<a name="DBX-Options"></a>
|
|
<p>
|
|
Next: <a rel="next" accesskey="n" href="DBX-Hooks.html#DBX-Hooks">DBX Hooks</a>,
|
|
Previous: <a rel="previous" accesskey="p" href="All-Debuggers.html#All-Debuggers">All Debuggers</a>,
|
|
Up: <a rel="up" accesskey="u" href="Debugging-Info.html#Debugging-Info">Debugging Info</a>
|
|
<hr>
|
|
</div>
|
|
|
|
<h4 class="subsection">17.21.2 Specific Options for DBX Output</h4>
|
|
|
|
<!-- prevent bad page break with this line -->
|
|
<p>These are specific options for DBX output.
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_DEBUGGING_INFO</b><var><a name="index-DBX_005fDEBUGGING_005fINFO-4754"></a></var><br>
|
|
<blockquote><p>Define this macro if GCC should produce debugging output for DBX
|
|
in response to the <samp><span class="option">-g</span></samp> option.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>XCOFF_DEBUGGING_INFO</b><var><a name="index-XCOFF_005fDEBUGGING_005fINFO-4755"></a></var><br>
|
|
<blockquote><p>Define this macro if GCC should produce XCOFF format debugging output
|
|
in response to the <samp><span class="option">-g</span></samp> option. This is a variant of DBX format.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DEFAULT_GDB_EXTENSIONS</b><var><a name="index-DEFAULT_005fGDB_005fEXTENSIONS-4756"></a></var><br>
|
|
<blockquote><p>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.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DEBUG_SYMS_TEXT</b><var><a name="index-DEBUG_005fSYMS_005fTEXT-4757"></a></var><br>
|
|
<blockquote><p>Define this macro if all <code>.stabs</code> commands should be output while
|
|
in the text section.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>ASM_STABS_OP</b><var><a name="index-ASM_005fSTABS_005fOP-4758"></a></var><br>
|
|
<blockquote><p>A C string constant, including spacing, naming the assembler pseudo op to
|
|
use instead of <code>"\t.stabs\t"</code> to define an ordinary debugging symbol.
|
|
If you don't define this macro, <code>"\t.stabs\t"</code> is used. This macro
|
|
applies only to DBX debugging information format.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>ASM_STABD_OP</b><var><a name="index-ASM_005fSTABD_005fOP-4759"></a></var><br>
|
|
<blockquote><p>A C string constant, including spacing, naming the assembler pseudo op to
|
|
use instead of <code>"\t.stabd\t"</code> to define a debugging symbol whose
|
|
value is the current location. If you don't define this macro,
|
|
<code>"\t.stabd\t"</code> is used. This macro applies only to DBX debugging
|
|
information format.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>ASM_STABN_OP</b><var><a name="index-ASM_005fSTABN_005fOP-4760"></a></var><br>
|
|
<blockquote><p>A C string constant, including spacing, naming the assembler pseudo op to
|
|
use instead of <code>"\t.stabn\t"</code> to define a debugging symbol with no
|
|
name. If you don't define this macro, <code>"\t.stabn\t"</code> is used. This
|
|
macro applies only to DBX debugging information format.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_NO_XREFS</b><var><a name="index-DBX_005fNO_005fXREFS-4761"></a></var><br>
|
|
<blockquote><p>Define this macro if DBX on your system does not support the construct
|
|
‘<samp><span class="samp">xs</span><var>tagname</var></samp>’. On some systems, this construct is used to
|
|
describe a forward reference to a structure named <var>tagname</var>.
|
|
On other systems, this construct is not supported at all.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_CONTIN_LENGTH</b><var><a name="index-DBX_005fCONTIN_005fLENGTH-4762"></a></var><br>
|
|
<blockquote><p>A symbol name in DBX-format debugging information is normally
|
|
continued (split into two separate <code>.stabs</code> 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.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_CONTIN_CHAR</b><var><a name="index-DBX_005fCONTIN_005fCHAR-4763"></a></var><br>
|
|
<blockquote><p>Normally continuation is indicated by adding a ‘<samp><span class="samp">\</span></samp>’ character to
|
|
the end of a <code>.stabs</code> 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.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_STATIC_STAB_DATA_SECTION</b><var><a name="index-DBX_005fSTATIC_005fSTAB_005fDATA_005fSECTION-4764"></a></var><br>
|
|
<blockquote><p>Define this macro if it is necessary to go to the data section before
|
|
outputting the ‘<samp><span class="samp">.stabs</span></samp>’ pseudo-op for a non-global static
|
|
variable.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_TYPE_DECL_STABS_CODE</b><var><a name="index-DBX_005fTYPE_005fDECL_005fSTABS_005fCODE-4765"></a></var><br>
|
|
<blockquote><p>The value to use in the “code” field of the <code>.stabs</code> directive
|
|
for a typedef. The default is <code>N_LSYM</code>.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_STATIC_CONST_VAR_CODE</b><var><a name="index-DBX_005fSTATIC_005fCONST_005fVAR_005fCODE-4766"></a></var><br>
|
|
<blockquote><p>The value to use in the “code” field of the <code>.stabs</code> directive
|
|
for a static variable located in the text section. DBX format does not
|
|
provide any “right” way to do this. The default is <code>N_FUN</code>.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_REGPARM_STABS_CODE</b><var><a name="index-DBX_005fREGPARM_005fSTABS_005fCODE-4767"></a></var><br>
|
|
<blockquote><p>The value to use in the “code” field of the <code>.stabs</code> directive
|
|
for a parameter passed in registers. DBX format does not provide any
|
|
“right” way to do this. The default is <code>N_RSYM</code>.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_REGPARM_STABS_LETTER</b><var><a name="index-DBX_005fREGPARM_005fSTABS_005fLETTER-4768"></a></var><br>
|
|
<blockquote><p>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 <code>'P'</code>.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_FUNCTION_FIRST</b><var><a name="index-DBX_005fFUNCTION_005fFIRST-4769"></a></var><br>
|
|
<blockquote><p>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.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_BLOCKS_FUNCTION_RELATIVE</b><var><a name="index-DBX_005fBLOCKS_005fFUNCTION_005fRELATIVE-4770"></a></var><br>
|
|
<blockquote><p>Define this macro, with value 1, if the value of a symbol describing
|
|
the scope of a block (<code>N_LBRAC</code> or <code>N_RBRAC</code>) should be
|
|
relative to the start of the enclosing function. Normally, GCC uses
|
|
an absolute address.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_LINES_FUNCTION_RELATIVE</b><var><a name="index-DBX_005fLINES_005fFUNCTION_005fRELATIVE-4771"></a></var><br>
|
|
<blockquote><p>Define this macro, with value 1, if the value of a symbol indicating
|
|
the current line number (<code>N_SLINE</code>) should be relative to the
|
|
start of the enclosing function. Normally, GCC uses an absolute address.
|
|
</p></blockquote></div>
|
|
|
|
<div class="defun">
|
|
— Macro: <b>DBX_USE_BINCL</b><var><a name="index-DBX_005fUSE_005fBINCL-4772"></a></var><br>
|
|
<blockquote><p>Define this macro if GCC should generate <code>N_BINCL</code> and
|
|
<code>N_EINCL</code> 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 <code>N_BINCL</code> or <code>N_EINCL</code> stabs, and it outputs a single
|
|
number for a type number.
|
|
</p></blockquote></div>
|
|
|
|
</body></html>
|
|
|