aarch64-linux-gnu-4.9/share/doc/gccint/SDB-and-DWARF.html - toolchains/linux-x86/gcc - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <!-- 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. -->
 <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
 <head>
 <title>GNU Compiler Collection (GCC) Internals: SDB and DWARF</title>

 <meta name="description" content="GNU Compiler Collection (GCC) Internals: SDB and DWARF">
 <meta name="keywords" content="GNU Compiler Collection (GCC) Internals: SDB and DWARF">
 <meta name="resource-type" content="document">
 <meta name="distribution" content="global">
 <meta name="Generator" content="makeinfo">
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <link href="index.html#Top" rel="start" title="Top">
 <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
 <link href="Debugging-Info.html#Debugging-Info" rel="up" title="Debugging Info">
 <link href="VMS-Debug.html#VMS-Debug" rel="next" title="VMS Debug">
 <link href="File-Names-and-DBX.html#File-Names-and-DBX" rel="prev" title="File Names and DBX">
 <style type="text/css">
 <!--
 a.summary-letter {text-decoration: none}
 blockquote.smallquotation {font-size: smaller}
 div.display {margin-left: 3.2em}
 div.example {margin-left: 3.2em}
 div.indentedblock {margin-left: 3.2em}
 div.lisp {margin-left: 3.2em}
 div.smalldisplay {margin-left: 3.2em}
 div.smallexample {margin-left: 3.2em}
 div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
 div.smalllisp {margin-left: 3.2em}
 kbd {font-style:oblique}
 pre.display {font-family: inherit}
 pre.format {font-family: inherit}
 pre.menu-comment {font-family: serif}
 pre.menu-preformatted {font-family: serif}
 pre.smalldisplay {font-family: inherit; font-size: smaller}
 pre.smallexample {font-size: smaller}
 pre.smallformat {font-family: inherit; font-size: smaller}
 pre.smalllisp {font-size: smaller}
 span.nocodebreak {white-space:nowrap}
 span.nolinebreak {white-space:nowrap}
 span.roman {font-family:serif; font-weight:normal}
 span.sansserif {font-family:sans-serif; font-weight:normal}
 ul.no-bullet {list-style: none}
 -->
 </style>


 </head>

 <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
 <a name="SDB-and-DWARF"></a>
 <div class="header">
 <p>
 Next: <a href="VMS-Debug.html#VMS-Debug" accesskey="n" rel="next">VMS Debug</a>, Previous: <a href="File-Names-and-DBX.html#File-Names-and-DBX" accesskey="p" rel="prev">File Names and DBX</a>, Up: <a href="Debugging-Info.html#Debugging-Info" accesskey="u" rel="up">Debugging Info</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <hr>
 <a name="Macros-for-SDB-and-DWARF-Output"></a>
 <h4 class="subsection">17.22.5 Macros for SDB and DWARF Output</h4>

 <p>Here are macros for SDB and DWARF output.
 </p>
 <dl>
 <dt><a name="index-SDB_005fDEBUGGING_005fINFO"></a>Macro: <strong>SDB_DEBUGGING_INFO</strong></dt>
 <dd><p>Define this macro if GCC should produce COFF-style debugging output
 for SDB in response to the <samp>-g</samp> option.
 </p></dd></dl>

 <dl>
 <dt><a name="index-DWARF2_005fDEBUGGING_005fINFO"></a>Macro: <strong>DWARF2_DEBUGGING_INFO</strong></dt>
 <dd><p>Define this macro if GCC should produce dwarf version 2 format
 debugging output in response to the <samp>-g</samp> option.
 </p>
 <dl>
 <dt><a name="index-TARGET_005fDWARF_005fCALLING_005fCONVENTION"></a>Target Hook: <em>int</em> <strong>TARGET_DWARF_CALLING_CONVENTION</strong> <em>(const_tree <var>function</var>)</em></dt>
 <dd><p>Define this to enable the dwarf attribute <code>DW_AT_calling_convention</code> to
 be emitted for each function.  Instead of an integer return the enum
 value for the <code>DW_CC_</code> tag.
 </p></dd></dl>

 <p>To support optional call frame debugging information, you must also
 define <code>INCOMING_RETURN_ADDR_RTX</code> and either set
 <code>RTX_FRAME_RELATED_P</code> on the prologue insns if you use RTL for the
 prologue, or call <code>dwarf2out_def_cfa</code> and <code>dwarf2out_reg_save</code>
 as appropriate from <code>TARGET_ASM_FUNCTION_PROLOGUE</code> if you don&rsquo;t.
 </p></dd></dl>

 <dl>
 <dt><a name="index-DWARF2_005fFRAME_005fINFO"></a>Macro: <strong>DWARF2_FRAME_INFO</strong></dt>
 <dd><p>Define this macro to a nonzero value if GCC should always output
 Dwarf 2 frame information.  If <code>TARGET_EXCEPT_UNWIND_INFO</code>
 (see <a href="Exception-Region-Output.html#Exception-Region-Output">Exception Region Output</a>) returns <code>UI_DWARF2</code>, and
 exceptions are enabled, GCC will output this information not matter
 how you define <code>DWARF2_FRAME_INFO</code>.
 </p></dd></dl>

 <dl>
 <dt><a name="index-TARGET_005fDEBUG_005fUNWIND_005fINFO"></a>Target Hook: <em>enum unwind_info_type</em> <strong>TARGET_DEBUG_UNWIND_INFO</strong> <em>(void)</em></dt>
 <dd><p>This hook defines the mechanism that will be used for describing frame
 unwind information to the debugger.  Normally the hook will return
 <code>UI_DWARF2</code> if DWARF 2 debug information is enabled, and
 return <code>UI_NONE</code> otherwise.
 </p>
 <p>A target may return <code>UI_DWARF2</code> even when DWARF 2 debug information
 is disabled in order to always output DWARF 2 frame information.
 </p>
 <p>A target may return <code>UI_TARGET</code> if it has ABI specified unwind tables.
 This will suppress generation of the normal debug frame unwind information.
 </p></dd></dl>

 <dl>
 <dt><a name="index-DWARF2_005fASM_005fLINE_005fDEBUG_005fINFO"></a>Macro: <strong>DWARF2_ASM_LINE_DEBUG_INFO</strong></dt>
 <dd><p>Define this macro to be a nonzero value if the assembler can generate Dwarf 2
 line debug info sections.  This will result in much more compact line number
 tables, and hence is desirable if it works.
 </p></dd></dl>

 <dl>
 <dt><a name="index-TARGET_005fWANT_005fDEBUG_005fPUB_005fSECTIONS"></a>Target Hook: <em>bool</em> <strong>TARGET_WANT_DEBUG_PUB_SECTIONS</strong></dt>
 <dd><p>True if the <code>.debug_pubtypes</code> and <code>.debug_pubnames</code> sections should be emitted.  These sections are not used on most platforms, and in particular GDB does not use them.
 </p></dd></dl>

 <dl>
 <dt><a name="index-TARGET_005fFORCE_005fAT_005fCOMP_005fDIR"></a>Target Hook: <em>bool</em> <strong>TARGET_FORCE_AT_COMP_DIR</strong></dt>
 <dd><p>True if the <code>DW_AT_comp_dir</code> attribute should be emitted for each  compilation unit.  This attribute is required for the darwin linker  to emit debug information.
 </p></dd></dl>

 <dl>
 <dt><a name="index-TARGET_005fDELAY_005fSCHED2"></a>Target Hook: <em>bool</em> <strong>TARGET_DELAY_SCHED2</strong></dt>
 <dd><p>True if sched2 is not to be run at its normal place.  This usually means it will be run as part of machine-specific reorg.
 </p></dd></dl>

 <dl>
 <dt><a name="index-TARGET_005fDELAY_005fVARTRACK"></a>Target Hook: <em>bool</em> <strong>TARGET_DELAY_VARTRACK</strong></dt>
 <dd><p>True if vartrack is not to be run at its normal place.  This usually means it will be run as part of machine-specific reorg.
 </p></dd></dl>

 <dl>
 <dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fDELTA"></a>Macro: <strong>ASM_OUTPUT_DWARF_DELTA</strong> <em>(<var>stream</var>, <var>size</var>, <var>label1</var>, <var>label2</var>)</em></dt>
 <dd><p>A C statement to issue assembly directives that create a difference
 <var>lab1</var> minus <var>lab2</var>, using an integer of the given <var>size</var>.
 </p></dd></dl>

 <dl>
 <dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fVMS_005fDELTA"></a>Macro: <strong>ASM_OUTPUT_DWARF_VMS_DELTA</strong> <em>(<var>stream</var>, <var>size</var>, <var>label1</var>, <var>label2</var>)</em></dt>
 <dd><p>A C statement to issue assembly directives that create a difference
 between the two given labels in system defined units, e.g. instruction
 slots on IA64 VMS, using an integer of the given size.
 </p></dd></dl>

 <dl>
 <dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fOFFSET"></a>Macro: <strong>ASM_OUTPUT_DWARF_OFFSET</strong> <em>(<var>stream</var>, <var>size</var>, <var>label</var>, <var>section</var>)</em></dt>
 <dd><p>A C statement to issue assembly directives that create a
 section-relative reference to the given <var>label</var>, using an integer of the
 given <var>size</var>.  The label is known to be defined in the given <var>section</var>.
 </p></dd></dl>

 <dl>
 <dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fPCREL"></a>Macro: <strong>ASM_OUTPUT_DWARF_PCREL</strong> <em>(<var>stream</var>, <var>size</var>, <var>label</var>)</em></dt>
 <dd><p>A C statement to issue assembly directives that create a self-relative
 reference to the given <var>label</var>, using an integer of the given <var>size</var>.
 </p></dd></dl>

 <dl>
 <dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fTABLE_005fREF"></a>Macro: <strong>ASM_OUTPUT_DWARF_TABLE_REF</strong> <em>(<var>label</var>)</em></dt>
 <dd><p>A C statement to issue assembly directives that create a reference to
 the DWARF table identifier <var>label</var> from the current section.  This
 is used on some systems to avoid garbage collecting a DWARF table which
 is referenced by a function.
 </p></dd></dl>

 <dl>
 <dt><a name="index-TARGET_005fASM_005fOUTPUT_005fDWARF_005fDTPREL"></a>Target Hook: <em>void</em> <strong>TARGET_ASM_OUTPUT_DWARF_DTPREL</strong> <em>(FILE *<var>file</var>, int <var>size</var>, rtx <var>x</var>)</em></dt>
 <dd><p>If defined, this target hook is a function which outputs a DTP-relative
 reference to the given TLS symbol of the specified size.
 </p></dd></dl>

 <dl>
 <dt><a name="index-PUT_005fSDB_005f"></a>Macro: <strong>PUT_SDB_</strong> <em>&hellip;</em></dt>
 <dd><p>Define these macros to override the assembler syntax for the special
 SDB assembler directives.  See <samp>sdbout.c</samp> for a list of these
 macros and their arguments.  If the standard syntax is used, you need
 not define them yourself.
 </p></dd></dl>

 <dl>
 <dt><a name="index-SDB_005fDELIM"></a>Macro: <strong>SDB_DELIM</strong></dt>
 <dd><p>Some assemblers do not support a semicolon as a delimiter, even between
 SDB assembler directives.  In that case, define this macro to be the
 delimiter to use (usually &lsquo;<samp>\n</samp>&rsquo;).  It is not necessary to define
 a new set of <code>PUT_SDB_<var>op</var></code> macros if this is the only change
 required.
 </p></dd></dl>

 <dl>
 <dt><a name="index-SDB_005fALLOW_005fUNKNOWN_005fREFERENCES"></a>Macro: <strong>SDB_ALLOW_UNKNOWN_REFERENCES</strong></dt>
 <dd><p>Define this macro to allow references to unknown structure,
 union, or enumeration tags to be emitted.  Standard COFF does not
 allow handling of unknown references, MIPS ECOFF has support for
 it.
 </p></dd></dl>

 <dl>
 <dt><a name="index-SDB_005fALLOW_005fFORWARD_005fREFERENCES"></a>Macro: <strong>SDB_ALLOW_FORWARD_REFERENCES</strong></dt>
 <dd><p>Define this macro to allow references to structure, union, or
 enumeration tags that have not yet been seen to be handled.  Some
 assemblers choke if forward tags are used, while some require it.
 </p></dd></dl>

 <dl>
 <dt><a name="index-SDB_005fOUTPUT_005fSOURCE_005fLINE"></a>Macro: <strong>SDB_OUTPUT_SOURCE_LINE</strong> <em>(<var>stream</var>, <var>line</var>)</em></dt>
 <dd><p>A C statement to output SDB debugging information before code for line
 number <var>line</var> of the current source file to the stdio stream
 <var>stream</var>.  The default is to emit an <code>.ln</code> directive.
 </p></dd></dl>

 <hr>
 <div class="header">
 <p>
 Next: <a href="VMS-Debug.html#VMS-Debug" accesskey="n" rel="next">VMS Debug</a>, Previous: <a href="File-Names-and-DBX.html#File-Names-and-DBX" accesskey="p" rel="prev">File Names and DBX</a>, Up: <a href="Debugging-Info.html#Debugging-Info" accesskey="u" rel="up">Debugging Info</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
 </div>


 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<html>
	<!-- 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. -->
	<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
	<head>
	<title>GNU Compiler Collection (GCC) Internals: SDB and DWARF</title>

	<meta name="description" content="GNU Compiler Collection (GCC) Internals: SDB and DWARF">
	<meta name="keywords" content="GNU Compiler Collection (GCC) Internals: SDB and DWARF">
	<meta name="resource-type" content="document">
	<meta name="distribution" content="global">
	<meta name="Generator" content="makeinfo">
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<link href="index.html#Top" rel="start" title="Top">
	<link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
	<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
	<link href="Debugging-Info.html#Debugging-Info" rel="up" title="Debugging Info">
	<link href="VMS-Debug.html#VMS-Debug" rel="next" title="VMS Debug">
	<link href="File-Names-and-DBX.html#File-Names-and-DBX" rel="prev" title="File Names and DBX">
	<style type="text/css">
	<!--
	a.summary-letter {text-decoration: none}
	blockquote.smallquotation {font-size: smaller}
	div.display {margin-left: 3.2em}
	div.example {margin-left: 3.2em}
	div.indentedblock {margin-left: 3.2em}
	div.lisp {margin-left: 3.2em}
	div.smalldisplay {margin-left: 3.2em}
	div.smallexample {margin-left: 3.2em}
	div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
	div.smalllisp {margin-left: 3.2em}
	kbd {font-style:oblique}
	pre.display {font-family: inherit}
	pre.format {font-family: inherit}
	pre.menu-comment {font-family: serif}
	pre.menu-preformatted {font-family: serif}
	pre.smalldisplay {font-family: inherit; font-size: smaller}
	pre.smallexample {font-size: smaller}
	pre.smallformat {font-family: inherit; font-size: smaller}
	pre.smalllisp {font-size: smaller}
	span.nocodebreak {white-space:nowrap}
	span.nolinebreak {white-space:nowrap}
	span.roman {font-family:serif; font-weight:normal}
	span.sansserif {font-family:sans-serif; font-weight:normal}
	ul.no-bullet {list-style: none}
	-->
	</style>


	</head>

	<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
	<a name="SDB-and-DWARF"></a>
	<div class="header">
	<p>
	Next: <a href="VMS-Debug.html#VMS-Debug" accesskey="n" rel="next">VMS Debug</a>, Previous: <a href="File-Names-and-DBX.html#File-Names-and-DBX" accesskey="p" rel="prev">File Names and DBX</a>, Up: <a href="Debugging-Info.html#Debugging-Info" accesskey="u" rel="up">Debugging Info</a>   [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
	</div>
	<hr>
	<a name="Macros-for-SDB-and-DWARF-Output"></a>
	<h4 class="subsection">17.22.5 Macros for SDB and DWARF Output</h4>

	<p>Here are macros for SDB and DWARF output.
	</p>
	<dl>
	<dt><a name="index-SDB_005fDEBUGGING_005fINFO"></a>Macro: <strong>SDB_DEBUGGING_INFO</strong></dt>
	<dd><p>Define this macro if GCC should produce COFF-style debugging output
	for SDB in response to the <samp>-g</samp> option.
	</p></dd></dl>

	<dl>
	<dt><a name="index-DWARF2_005fDEBUGGING_005fINFO"></a>Macro: <strong>DWARF2_DEBUGGING_INFO</strong></dt>
	<dd><p>Define this macro if GCC should produce dwarf version 2 format
	debugging output in response to the <samp>-g</samp> option.
	</p>
	<dl>
	<dt><a name="index-TARGET_005fDWARF_005fCALLING_005fCONVENTION"></a>Target Hook: <em>int</em> <strong>TARGET_DWARF_CALLING_CONVENTION</strong> <em>(const_tree <var>function</var>)</em></dt>
	<dd><p>Define this to enable the dwarf attribute <code>DW_AT_calling_convention</code> to
	be emitted for each function. Instead of an integer return the enum
	value for the <code>DW_CC_</code> tag.
	</p></dd></dl>

	<p>To support optional call frame debugging information, you must also
	define <code>INCOMING_RETURN_ADDR_RTX</code> and either set
	<code>RTX_FRAME_RELATED_P</code> on the prologue insns if you use RTL for the
	prologue, or call <code>dwarf2out_def_cfa</code> and <code>dwarf2out_reg_save</code>
	as appropriate from <code>TARGET_ASM_FUNCTION_PROLOGUE</code> if you don’t.
	</p></dd></dl>

	<dl>
	<dt><a name="index-DWARF2_005fFRAME_005fINFO"></a>Macro: <strong>DWARF2_FRAME_INFO</strong></dt>
	<dd><p>Define this macro to a nonzero value if GCC should always output
	Dwarf 2 frame information. If <code>TARGET_EXCEPT_UNWIND_INFO</code>
	(see <a href="Exception-Region-Output.html#Exception-Region-Output">Exception Region Output</a>) returns <code>UI_DWARF2</code>, and
	exceptions are enabled, GCC will output this information not matter
	how you define <code>DWARF2_FRAME_INFO</code>.
	</p></dd></dl>

	<dl>
	<dt><a name="index-TARGET_005fDEBUG_005fUNWIND_005fINFO"></a>Target Hook: <em>enum unwind_info_type</em> <strong>TARGET_DEBUG_UNWIND_INFO</strong> <em>(void)</em></dt>
	<dd><p>This hook defines the mechanism that will be used for describing frame
	unwind information to the debugger. Normally the hook will return
	<code>UI_DWARF2</code> if DWARF 2 debug information is enabled, and
	return <code>UI_NONE</code> otherwise.
	</p>
	<p>A target may return <code>UI_DWARF2</code> even when DWARF 2 debug information
	is disabled in order to always output DWARF 2 frame information.
	</p>
	<p>A target may return <code>UI_TARGET</code> if it has ABI specified unwind tables.
	This will suppress generation of the normal debug frame unwind information.
	</p></dd></dl>

	<dl>
	<dt><a name="index-DWARF2_005fASM_005fLINE_005fDEBUG_005fINFO"></a>Macro: <strong>DWARF2_ASM_LINE_DEBUG_INFO</strong></dt>
	<dd><p>Define this macro to be a nonzero value if the assembler can generate Dwarf 2
	line debug info sections. This will result in much more compact line number
	tables, and hence is desirable if it works.
	</p></dd></dl>

	<dl>
	<dt><a name="index-TARGET_005fWANT_005fDEBUG_005fPUB_005fSECTIONS"></a>Target Hook: <em>bool</em> <strong>TARGET_WANT_DEBUG_PUB_SECTIONS</strong></dt>
	<dd><p>True if the <code>.debug_pubtypes</code> and <code>.debug_pubnames</code> sections should be emitted. These sections are not used on most platforms, and in particular GDB does not use them.
	</p></dd></dl>

	<dl>
	<dt><a name="index-TARGET_005fFORCE_005fAT_005fCOMP_005fDIR"></a>Target Hook: <em>bool</em> <strong>TARGET_FORCE_AT_COMP_DIR</strong></dt>
	<dd><p>True if the <code>DW_AT_comp_dir</code> attribute should be emitted for each compilation unit. This attribute is required for the darwin linker to emit debug information.
	</p></dd></dl>

	<dl>
	<dt><a name="index-TARGET_005fDELAY_005fSCHED2"></a>Target Hook: <em>bool</em> <strong>TARGET_DELAY_SCHED2</strong></dt>
	<dd><p>True if sched2 is not to be run at its normal place. This usually means it will be run as part of machine-specific reorg.
	</p></dd></dl>

	<dl>
	<dt><a name="index-TARGET_005fDELAY_005fVARTRACK"></a>Target Hook: <em>bool</em> <strong>TARGET_DELAY_VARTRACK</strong></dt>
	<dd><p>True if vartrack is not to be run at its normal place. This usually means it will be run as part of machine-specific reorg.
	</p></dd></dl>

	<dl>
	<dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fDELTA"></a>Macro: <strong>ASM_OUTPUT_DWARF_DELTA</strong> <em>(<var>stream</var>, <var>size</var>, <var>label1</var>, <var>label2</var>)</em></dt>
	<dd><p>A C statement to issue assembly directives that create a difference
	<var>lab1</var> minus <var>lab2</var>, using an integer of the given <var>size</var>.
	</p></dd></dl>

	<dl>
	<dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fVMS_005fDELTA"></a>Macro: <strong>ASM_OUTPUT_DWARF_VMS_DELTA</strong> <em>(<var>stream</var>, <var>size</var>, <var>label1</var>, <var>label2</var>)</em></dt>
	<dd><p>A C statement to issue assembly directives that create a difference
	between the two given labels in system defined units, e.g. instruction
	slots on IA64 VMS, using an integer of the given size.
	</p></dd></dl>

	<dl>
	<dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fOFFSET"></a>Macro: <strong>ASM_OUTPUT_DWARF_OFFSET</strong> <em>(<var>stream</var>, <var>size</var>, <var>label</var>, <var>section</var>)</em></dt>
	<dd><p>A C statement to issue assembly directives that create a
	section-relative reference to the given <var>label</var>, using an integer of the
	given <var>size</var>. The label is known to be defined in the given <var>section</var>.
	</p></dd></dl>

	<dl>
	<dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fPCREL"></a>Macro: <strong>ASM_OUTPUT_DWARF_PCREL</strong> <em>(<var>stream</var>, <var>size</var>, <var>label</var>)</em></dt>
	<dd><p>A C statement to issue assembly directives that create a self-relative
	reference to the given <var>label</var>, using an integer of the given <var>size</var>.
	</p></dd></dl>

	<dl>
	<dt><a name="index-ASM_005fOUTPUT_005fDWARF_005fTABLE_005fREF"></a>Macro: <strong>ASM_OUTPUT_DWARF_TABLE_REF</strong> <em>(<var>label</var>)</em></dt>
	<dd><p>A C statement to issue assembly directives that create a reference to
	the DWARF table identifier <var>label</var> from the current section. This
	is used on some systems to avoid garbage collecting a DWARF table which
	is referenced by a function.
	</p></dd></dl>

	<dl>
	<dt><a name="index-TARGET_005fASM_005fOUTPUT_005fDWARF_005fDTPREL"></a>Target Hook: <em>void</em> <strong>TARGET_ASM_OUTPUT_DWARF_DTPREL</strong> <em>(FILE *<var>file</var>, int <var>size</var>, rtx <var>x</var>)</em></dt>
	<dd><p>If defined, this target hook is a function which outputs a DTP-relative
	reference to the given TLS symbol of the specified size.
	</p></dd></dl>

	<dl>
	<dt><a name="index-PUT_005fSDB_005f"></a>Macro: <strong>PUT_SDB_</strong> <em>…</em></dt>
	<dd><p>Define these macros to override the assembler syntax for the special
	SDB assembler directives. See <samp>sdbout.c</samp> for a list of these
	macros and their arguments. If the standard syntax is used, you need
	not define them yourself.
	</p></dd></dl>

	<dl>
	<dt><a name="index-SDB_005fDELIM"></a>Macro: <strong>SDB_DELIM</strong></dt>
	<dd><p>Some assemblers do not support a semicolon as a delimiter, even between
	SDB assembler directives. In that case, define this macro to be the
	delimiter to use (usually ‘<samp>\n</samp>’). It is not necessary to define
	a new set of <code>PUT_SDB_<var>op</var></code> macros if this is the only change
	required.
	</p></dd></dl>

	<dl>
	<dt><a name="index-SDB_005fALLOW_005fUNKNOWN_005fREFERENCES"></a>Macro: <strong>SDB_ALLOW_UNKNOWN_REFERENCES</strong></dt>
	<dd><p>Define this macro to allow references to unknown structure,
	union, or enumeration tags to be emitted. Standard COFF does not
	allow handling of unknown references, MIPS ECOFF has support for
	it.
	</p></dd></dl>

	<dl>
	<dt><a name="index-SDB_005fALLOW_005fFORWARD_005fREFERENCES"></a>Macro: <strong>SDB_ALLOW_FORWARD_REFERENCES</strong></dt>
	<dd><p>Define this macro to allow references to structure, union, or
	enumeration tags that have not yet been seen to be handled. Some
	assemblers choke if forward tags are used, while some require it.
	</p></dd></dl>

	<dl>
	<dt><a name="index-SDB_005fOUTPUT_005fSOURCE_005fLINE"></a>Macro: <strong>SDB_OUTPUT_SOURCE_LINE</strong> <em>(<var>stream</var>, <var>line</var>)</em></dt>
	<dd><p>A C statement to output SDB debugging information before code for line
	number <var>line</var> of the current source file to the stdio stream
	<var>stream</var>. The default is to emit an <code>.ln</code> directive.
	</p></dd></dl>

	<hr>
	<div class="header">
	<p>
	Next: <a href="VMS-Debug.html#VMS-Debug" accesskey="n" rel="next">VMS Debug</a>, Previous: <a href="File-Names-and-DBX.html#File-Names-and-DBX" accesskey="p" rel="prev">File Names and DBX</a>, Up: <a href="Debugging-Info.html#Debugging-Info" accesskey="u" rel="up">Debugging Info</a>   [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
	</div>



	</body>
	</html>