a.html 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- This file documents the GNU Assembler "as".
  4. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: a</title>
  15. <meta name="description" content="Using as: a">
  16. <meta name="keywords" content="Using as: a">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="Invoking.html#Invoking" rel="up" title="Invoking">
  25. <link href="alternate.html#alternate" rel="next" title="alternate">
  26. <link href="Invoking.html#Invoking" rel="prev" title="Invoking">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="a"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="alternate.html#alternate" accesskey="n" rel="next">alternate</a>, Up: <a href="Invoking.html#Invoking" accesskey="u" rel="up">Invoking</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Enable-Listings_003a-_002da_005bcdghlns_005d"></a>
  64. <h3 class="section">2.1 Enable Listings: <samp>-a[cdghlns]</samp></h3>
  65. <a name="index-_002da"></a>
  66. <a name="index-_002dac"></a>
  67. <a name="index-_002dad"></a>
  68. <a name="index-_002dag"></a>
  69. <a name="index-_002dah"></a>
  70. <a name="index-_002dal"></a>
  71. <a name="index-_002dan"></a>
  72. <a name="index-_002das"></a>
  73. <a name="index-listings_002c-enabling"></a>
  74. <a name="index-assembly-listings_002c-enabling"></a>
  75. <p>These options enable listing output from the assembler. By itself,
  76. &lsquo;<samp>-a</samp>&rsquo; requests high-level, assembly, and symbols listing.
  77. You can use other letters to select specific options for the list:
  78. &lsquo;<samp>-ah</samp>&rsquo; requests a high-level language listing,
  79. &lsquo;<samp>-al</samp>&rsquo; requests an output-program assembly listing, and
  80. &lsquo;<samp>-as</samp>&rsquo; requests a symbol table listing.
  81. High-level listings require that a compiler debugging option like
  82. &lsquo;<samp>-g</samp>&rsquo; be used, and that assembly listings (&lsquo;<samp>-al</samp>&rsquo;) be requested
  83. also.
  84. </p>
  85. <p>Use the &lsquo;<samp>-ag</samp>&rsquo; option to print a first section with general assembly
  86. information, like as version, switches passed, or time stamp.
  87. </p>
  88. <p>Use the &lsquo;<samp>-ac</samp>&rsquo; option to omit false conditionals from a listing. Any lines
  89. which are not assembled because of a false <code>.if</code> (or <code>.ifdef</code>, or any
  90. other conditional), or a true <code>.if</code> followed by an <code>.else</code>, will be
  91. omitted from the listing.
  92. </p>
  93. <p>Use the &lsquo;<samp>-ad</samp>&rsquo; option to omit debugging directives from the
  94. listing.
  95. </p>
  96. <p>Once you have specified one of these options, you can further control
  97. listing output and its appearance using the directives <code>.list</code>,
  98. <code>.nolist</code>, <code>.psize</code>, <code>.eject</code>, <code>.title</code>, and
  99. <code>.sbttl</code>.
  100. The &lsquo;<samp>-an</samp>&rsquo; option turns off all forms processing.
  101. If you do not request listing output with one of the &lsquo;<samp>-a</samp>&rsquo; options, the
  102. listing-control directives have no effect.
  103. </p>
  104. <p>The letters after &lsquo;<samp>-a</samp>&rsquo; may be combined into one option,
  105. <em>e.g.</em>, &lsquo;<samp>-aln</samp>&rsquo;.
  106. </p>
  107. <p>Note if the assembler source is coming from the standard input (e.g.,
  108. because it
  109. is being created by <code>gcc</code> and the &lsquo;<samp>-pipe</samp>&rsquo; command line switch
  110. is being used) then the listing will not contain any comments or preprocessor
  111. directives. This is because the listing code buffers input source lines from
  112. stdin only after they have been preprocessed by the assembler. This reduces
  113. memory usage and makes the code more efficient.
  114. </p>
  115. <hr>
  116. <div class="header">
  117. <p>
  118. Next: <a href="alternate.html#alternate" accesskey="n" rel="next">alternate</a>, Up: <a href="Invoking.html#Invoking" accesskey="u" rel="up">Invoking</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  119. </div>
  120. </body>
  121. </html>