File-Names-and-DBX.html 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1988-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>GNU Compiler Collection (GCC) Internals: File Names and DBX</title>
  20. <meta name="description" content="GNU Compiler Collection (GCC) Internals: File Names and DBX">
  21. <meta name="keywords" content="GNU Compiler Collection (GCC) Internals: File Names and DBX">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Debugging-Info.html#Debugging-Info" rel="up" title="Debugging Info">
  30. <link href="SDB-and-DWARF.html#SDB-and-DWARF" rel="next" title="SDB and DWARF">
  31. <link href="DBX-Hooks.html#DBX-Hooks" rel="prev" title="DBX Hooks">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style:oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="File-Names-and-DBX"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="SDB-and-DWARF.html#SDB-and-DWARF" accesskey="n" rel="next">SDB and DWARF</a>, Previous: <a href="DBX-Hooks.html#DBX-Hooks" accesskey="p" rel="prev">DBX Hooks</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>
  66. </div>
  67. <hr>
  68. <a name="File-Names-in-DBX-Format"></a>
  69. <h4 class="subsection">17.21.4 File Names in DBX Format</h4>
  70. <p>This describes file names in DBX format.
  71. </p>
  72. <dl>
  73. <dt><a name="index-DBX_005fOUTPUT_005fMAIN_005fSOURCE_005fFILENAME"></a>Macro: <strong>DBX_OUTPUT_MAIN_SOURCE_FILENAME</strong> <em>(<var>stream</var>, <var>name</var>)</em></dt>
  74. <dd><p>A C statement to output DBX debugging information to the stdio stream
  75. <var>stream</var>, which indicates that file <var>name</var> is the main source
  76. file&mdash;the file specified as the input file for compilation.
  77. This macro is called only once, at the beginning of compilation.
  78. </p>
  79. <p>This macro need not be defined if the standard form of output
  80. for DBX debugging information is appropriate.
  81. </p>
  82. <p>It may be necessary to refer to a label equal to the beginning of the
  83. text section. You can use &lsquo;<samp>assemble_name (stream, ltext_label_name)</samp>&rsquo;
  84. to do so. If you do this, you must also set the variable
  85. <var>used_ltext_label_name</var> to <code>true</code>.
  86. </p></dd></dl>
  87. <dl>
  88. <dt><a name="index-NO_005fDBX_005fMAIN_005fSOURCE_005fDIRECTORY"></a>Macro: <strong>NO_DBX_MAIN_SOURCE_DIRECTORY</strong></dt>
  89. <dd><p>Define this macro, with value 1, if GCC should not emit an indication
  90. of the current directory for compilation and current source language at
  91. the beginning of the file.
  92. </p></dd></dl>
  93. <dl>
  94. <dt><a name="index-NO_005fDBX_005fGCC_005fMARKER"></a>Macro: <strong>NO_DBX_GCC_MARKER</strong></dt>
  95. <dd><p>Define this macro, with value 1, if GCC should not emit an indication
  96. that this object file was compiled by GCC. The default is to emit
  97. an <code>N_OPT</code> stab at the beginning of every source file, with
  98. &lsquo;<samp>gcc2_compiled.</samp>&rsquo; for the string and value 0.
  99. </p></dd></dl>
  100. <dl>
  101. <dt><a name="index-DBX_005fOUTPUT_005fMAIN_005fSOURCE_005fFILE_005fEND"></a>Macro: <strong>DBX_OUTPUT_MAIN_SOURCE_FILE_END</strong> <em>(<var>stream</var>, <var>name</var>)</em></dt>
  102. <dd><p>A C statement to output DBX debugging information at the end of
  103. compilation of the main source file <var>name</var>. Output should be
  104. written to the stdio stream <var>stream</var>.
  105. </p>
  106. <p>If you don&rsquo;t define this macro, nothing special is output at the end
  107. of compilation, which is correct for most machines.
  108. </p></dd></dl>
  109. <dl>
  110. <dt><a name="index-DBX_005fOUTPUT_005fNULL_005fN_005fSO_005fAT_005fMAIN_005fSOURCE_005fFILE_005fEND"></a>Macro: <strong>DBX_OUTPUT_NULL_N_SO_AT_MAIN_SOURCE_FILE_END</strong></dt>
  111. <dd><p>Define this macro <em>instead of</em> defining
  112. <code>DBX_OUTPUT_MAIN_SOURCE_FILE_END</code>, if what needs to be output at
  113. the end of compilation is an <code>N_SO</code> stab with an empty string,
  114. whose value is the highest absolute text address in the file.
  115. </p></dd></dl>
  116. <hr>
  117. <div class="header">
  118. <p>
  119. Next: <a href="SDB-and-DWARF.html#SDB-and-DWARF" accesskey="n" rel="next">SDB and DWARF</a>, Previous: <a href="DBX-Hooks.html#DBX-Hooks" accesskey="p" rel="prev">DBX Hooks</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>
  120. </div>
  121. </body>
  122. </html>