RX_002dOpts.html 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  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: RX-Opts</title>
  15. <meta name="description" content="Using as: RX-Opts">
  16. <meta name="keywords" content="Using as: RX-Opts">
  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="RX_002dDependent.html#RX_002dDependent" rel="up" title="RX-Dependent">
  25. <link href="RX_002dModifiers.html#RX_002dModifiers" rel="next" title="RX-Modifiers">
  26. <link href="RX_002dDependent.html#RX_002dDependent" rel="prev" title="RX-Dependent">
  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="RX_002dOpts"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="RX_002dModifiers.html#RX_002dModifiers" accesskey="n" rel="next">RX-Modifiers</a>, Up: <a href="RX_002dDependent.html#RX_002dDependent" accesskey="u" rel="up">RX-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="RX-Options"></a>
  64. <h4 class="subsection">9.38.1 RX Options</h4>
  65. <a name="index-options_002c-RX"></a>
  66. <a name="index-RX-options"></a>
  67. <p>The Renesas RX port of <code>as</code> has a few target specfic
  68. command line options:
  69. </p>
  70. <dl compact="compact">
  71. <dd>
  72. <a name="index-_002dm32bit_002ddoubles"></a>
  73. </dd>
  74. <dt><code>-m32bit-doubles</code></dt>
  75. <dd><p>This option controls the ABI and indicates to use a 32-bit float ABI.
  76. It has no effect on the assembled instructions, but it does influence
  77. the behaviour of the &lsquo;<samp>.double</samp>&rsquo; pseudo-op.
  78. This is the default.
  79. </p>
  80. <a name="index-_002dm64bit_002ddoubles"></a>
  81. </dd>
  82. <dt><code>-m64bit-doubles</code></dt>
  83. <dd><p>This option controls the ABI and indicates to use a 64-bit float ABI.
  84. It has no effect on the assembled instructions, but it does influence
  85. the behaviour of the &lsquo;<samp>.double</samp>&rsquo; pseudo-op.
  86. </p>
  87. <a name="index-_002dmbig_002dendian"></a>
  88. </dd>
  89. <dt><code>-mbig-endian</code></dt>
  90. <dd><p>This option controls the ABI and indicates to use a big-endian data
  91. ABI. It has no effect on the assembled instructions, but it does
  92. influence the behaviour of the &lsquo;<samp>.short</samp>&rsquo;, &lsquo;<samp>.hword</samp>&rsquo;, &lsquo;<samp>.int</samp>&rsquo;,
  93. &lsquo;<samp>.word</samp>&rsquo;, &lsquo;<samp>.long</samp>&rsquo;, &lsquo;<samp>.quad</samp>&rsquo; and &lsquo;<samp>.octa</samp>&rsquo; pseudo-ops.
  94. </p>
  95. <a name="index-_002dmlittle_002dendian"></a>
  96. </dd>
  97. <dt><code>-mlittle-endian</code></dt>
  98. <dd><p>This option controls the ABI and indicates to use a little-endian data
  99. ABI. It has no effect on the assembled instructions, but it does
  100. influence the behaviour of the &lsquo;<samp>.short</samp>&rsquo;, &lsquo;<samp>.hword</samp>&rsquo;, &lsquo;<samp>.int</samp>&rsquo;,
  101. &lsquo;<samp>.word</samp>&rsquo;, &lsquo;<samp>.long</samp>&rsquo;, &lsquo;<samp>.quad</samp>&rsquo; and &lsquo;<samp>.octa</samp>&rsquo; pseudo-ops.
  102. This is the default.
  103. </p>
  104. <a name="index-_002dmuse_002dconventional_002dsection_002dnames"></a>
  105. </dd>
  106. <dt><code>-muse-conventional-section-names</code></dt>
  107. <dd><p>This option controls the default names given to the code (.text),
  108. initialised data (.data) and uninitialised data sections (.bss).
  109. </p>
  110. <a name="index-_002dmuse_002drenesas_002dsection_002dnames"></a>
  111. </dd>
  112. <dt><code>-muse-renesas-section-names</code></dt>
  113. <dd><p>This option controls the default names given to the code (.P),
  114. initialised data (.D_1) and uninitialised data sections (.B_1).
  115. This is the default.
  116. </p>
  117. <a name="index-_002dmsmall_002ddata_002dlimit"></a>
  118. </dd>
  119. <dt><code>-msmall-data-limit</code></dt>
  120. <dd><p>This option tells the assembler that the small data limit feature of
  121. the RX port of GCC is being used. This results in the assembler
  122. generating an undefined reference to a symbol called <code>__gp</code> for
  123. use by the relocations that are needed to support the small data limit
  124. feature. This option is not enabled by default as it would otherwise
  125. pollute the symbol table.
  126. </p>
  127. <a name="index-_002dmpid"></a>
  128. </dd>
  129. <dt><code>-mpid</code></dt>
  130. <dd><p>This option tells the assembler that the position independent data of the
  131. RX port of GCC is being used. This results in the assembler
  132. generating an undefined reference to a symbol called <code>__pid_base</code>,
  133. and also setting the RX_PID flag bit in the e_flags field of the ELF
  134. header of the object file.
  135. </p>
  136. <a name="index-_002dmint_002dregister"></a>
  137. </dd>
  138. <dt><code>-mint-register=<var>num</var></code></dt>
  139. <dd><p>This option tells the assembler how many registers have been reserved
  140. for use by interrupt handlers. This is needed in order to compute the
  141. correct values for the <code>%gpreg</code> and <code>%pidreg</code> meta registers.
  142. </p>
  143. <a name="index-_002dmgcc_002dabi"></a>
  144. </dd>
  145. <dt><code>-mgcc-abi</code></dt>
  146. <dd><p>This option tells the assembler that the old GCC ABI is being used by
  147. the assembled code. With this version of the ABI function arguments
  148. that are passed on the stack are aligned to a 32-bit boundary.
  149. </p>
  150. <a name="index-_002dmrx_002dabi"></a>
  151. </dd>
  152. <dt><code>-mrx-abi</code></dt>
  153. <dd><p>This option tells the assembler that the official RX ABI is being used
  154. by the assembled code. With this version of the ABI function
  155. arguments that are passed on the stack are aligned to their natural
  156. alignments. This option is the default.
  157. </p>
  158. <a name="index-_002dmcpu_003d"></a>
  159. </dd>
  160. <dt><code>-mcpu=<var>name</var></code></dt>
  161. <dd><p>This option tells the assembler the target CPU type. Currently the
  162. <code>rx100</code>, <code>rx200</code>, <code>rx600</code>, <code>rx610</code> and <code>rxv2</code>
  163. are recognised as valid cpu names. Attempting to assemble an instruction
  164. not supported by the indicated cpu type will result in an error message
  165. being generated.
  166. </p>
  167. <a name="index-_002dmno_002dallow_002dstring_002dinsns"></a>
  168. </dd>
  169. <dt><code>-mno-allow-string-insns</code></dt>
  170. <dd><p>This option tells the assembler to mark the object file that it is
  171. building as one that does not use the string instructions
  172. <code>SMOVF</code>, <code>SCMPU</code>, <code>SMOVB</code>, <code>SMOVU</code>, <code>SUNTIL</code>
  173. <code>SWHILE</code> or the <code>RMPA</code> instruction. In addition the mark
  174. tells the linker to complain if an attempt is made to link the binary
  175. with another one that does use any of these instructions.
  176. </p>
  177. <p>Note - the inverse of this option, <code>-mallow-string-insns</code>, is
  178. not needed. The assembler automatically detects the use of the
  179. the instructions in the source code and labels the resulting
  180. object file appropriately. If no string instructions are detected
  181. then the object file is labelled as being one that can be linked with
  182. either string-using or string-banned object files.
  183. </p></dd>
  184. </dl>
  185. <hr>
  186. <div class="header">
  187. <p>
  188. Next: <a href="RX_002dModifiers.html#RX_002dModifiers" accesskey="n" rel="next">RX-Modifiers</a>, Up: <a href="RX_002dDependent.html#RX_002dDependent" accesskey="u" rel="up">RX-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>
  189. </div>
  190. </body>
  191. </html>