Alpha-Options.html 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172
  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: Alpha Options</title>
  15. <meta name="description" content="Using as: Alpha Options">
  16. <meta name="keywords" content="Using as: Alpha Options">
  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="Alpha_002dDependent.html#Alpha_002dDependent" rel="up" title="Alpha-Dependent">
  25. <link href="Alpha-Syntax.html#Alpha-Syntax" rel="next" title="Alpha Syntax">
  26. <link href="Alpha-Notes.html#Alpha-Notes" rel="prev" title="Alpha Notes">
  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="Alpha-Options"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Alpha-Syntax.html#Alpha-Syntax" accesskey="n" rel="next">Alpha Syntax</a>, Previous: <a href="Alpha-Notes.html#Alpha-Notes" accesskey="p" rel="prev">Alpha Notes</a>, Up: <a href="Alpha_002dDependent.html#Alpha_002dDependent" accesskey="u" rel="up">Alpha-Dependent</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="Options-1"></a>
  64. <h4 class="subsection">9.2.2 Options</h4>
  65. <a name="index-Alpha-options"></a>
  66. <a name="index-options-for-Alpha"></a>
  67. <dl compact="compact">
  68. <dd><a name="index-_002dmcpu-command-line-option_002c-Alpha"></a>
  69. </dd>
  70. <dt><code>-m<var>cpu</var></code></dt>
  71. <dd><p>This option specifies the target processor. If an attempt is made to
  72. assemble an instruction which will not execute on the target processor,
  73. the assembler may either expand the instruction as a macro or issue an
  74. error message. This option is equivalent to the <code>.arch</code> directive.
  75. </p>
  76. <p>The following processor names are recognized:
  77. <code>21064</code>,
  78. <code>21064a</code>,
  79. <code>21066</code>,
  80. <code>21068</code>,
  81. <code>21164</code>,
  82. <code>21164a</code>,
  83. <code>21164pc</code>,
  84. <code>21264</code>,
  85. <code>21264a</code>,
  86. <code>21264b</code>,
  87. <code>ev4</code>,
  88. <code>ev5</code>,
  89. <code>lca45</code>,
  90. <code>ev5</code>,
  91. <code>ev56</code>,
  92. <code>pca56</code>,
  93. <code>ev6</code>,
  94. <code>ev67</code>,
  95. <code>ev68</code>.
  96. The special name <code>all</code> may be used to allow the assembler to accept
  97. instructions valid for any Alpha processor.
  98. </p>
  99. <p>In order to support existing practice in OSF/1 with respect to <code>.arch</code>,
  100. and existing practice within <code>MILO</code> (the Linux ARC bootloader), the
  101. numbered processor names (e.g. 21064) enable the processor-specific PALcode
  102. instructions, while the &ldquo;electro-vlasic&rdquo; names (e.g. <code>ev4</code>) do not.
  103. </p>
  104. <a name="index-_002dmdebug-command-line-option_002c-Alpha"></a>
  105. <a name="index-_002dno_002dmdebug-command-line-option_002c-Alpha"></a>
  106. </dd>
  107. <dt><code>-mdebug</code></dt>
  108. <dt><code>-no-mdebug</code></dt>
  109. <dd><p>Enables or disables the generation of <code>.mdebug</code> encapsulation for
  110. stabs directives and procedure descriptors. The default is to automatically
  111. enable <code>.mdebug</code> when the first stabs directive is seen.
  112. </p>
  113. <a name="index-_002drelax-command-line-option_002c-Alpha"></a>
  114. </dd>
  115. <dt><code>-relax</code></dt>
  116. <dd><p>This option forces all relocations to be put into the object file, instead
  117. of saving space and resolving some relocations at assembly time. Note that
  118. this option does not propagate all symbol arithmetic into the object file,
  119. because not all symbol arithmetic can be represented. However, the option
  120. can still be useful in specific applications.
  121. </p>
  122. <a name="index-_002dreplace-command-line-option_002c-Alpha"></a>
  123. <a name="index-_002dnoreplace-command-line-option_002c-Alpha"></a>
  124. </dd>
  125. <dt><code>-replace</code></dt>
  126. <dt><code>-noreplace</code></dt>
  127. <dd><p>Enables or disables the optimization of procedure calls, both at assemblage
  128. and at link time. These options are only available for VMS targets and
  129. <code>-replace</code> is the default. See section 1.4.1 of the OpenVMS Linker
  130. Utility Manual.
  131. </p>
  132. <a name="index-_002dg-command-line-option_002c-Alpha"></a>
  133. </dd>
  134. <dt><code>-g</code></dt>
  135. <dd><p>This option is used when the compiler generates debug information. When
  136. <code>gcc</code> is using <code>mips-tfile</code> to generate debug
  137. information for ECOFF, local labels must be passed through to the object
  138. file. Otherwise this option has no effect.
  139. </p>
  140. <a name="index-_002dG-command-line-option_002c-Alpha"></a>
  141. </dd>
  142. <dt><code>-G<var>size</var></code></dt>
  143. <dd><p>A local common symbol larger than <var>size</var> is placed in <code>.bss</code>,
  144. while smaller symbols are placed in <code>.sbss</code>.
  145. </p>
  146. <a name="index-_002dF-command-line-option_002c-Alpha"></a>
  147. <a name="index-_002d32addr-command-line-option_002c-Alpha"></a>
  148. </dd>
  149. <dt><code>-F</code></dt>
  150. <dt><code>-32addr</code></dt>
  151. <dd><p>These options are ignored for backward compatibility.
  152. </p></dd>
  153. </dl>
  154. <a name="index-Alpha-Syntax"></a>
  155. <hr>
  156. <div class="header">
  157. <p>
  158. Next: <a href="Alpha-Syntax.html#Alpha-Syntax" accesskey="n" rel="next">Alpha Syntax</a>, Previous: <a href="Alpha-Notes.html#Alpha-Notes" accesskey="p" rel="prev">Alpha Notes</a>, Up: <a href="Alpha_002dDependent.html#Alpha_002dDependent" accesskey="u" rel="up">Alpha-Dependent</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>
  159. </div>
  160. </body>
  161. </html>