You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

M32R_002dOpts.html 10.0KB

3 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255
  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-2020 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 6.5, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  15. <title>M32R-Opts (Using as)</title>
  16. <meta name="description" content="M32R-Opts (Using as)">
  17. <meta name="keywords" content="M32R-Opts (Using as)">
  18. <meta name="resource-type" content="document">
  19. <meta name="distribution" content="global">
  20. <meta name="Generator" content="makeinfo">
  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="M32R_002dDependent.html#M32R_002dDependent" rel="up" title="M32R-Dependent">
  25. <link href="M32R_002dDirectives.html#M32R_002dDirectives" rel="next" title="M32R-Directives">
  26. <link href="M32R_002dDependent.html#M32R_002dDependent" rel="prev" title="M32R-Dependent">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.indentedblock {margin-right: 0em}
  31. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
  32. blockquote.smallquotation {font-size: smaller}
  33. div.display {margin-left: 3.2em}
  34. div.example {margin-left: 3.2em}
  35. div.lisp {margin-left: 3.2em}
  36. div.smalldisplay {margin-left: 3.2em}
  37. div.smallexample {margin-left: 3.2em}
  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.nolinebreak {white-space: nowrap}
  49. span.roman {font-family: initial; font-weight: normal}
  50. span.sansserif {font-family: sans-serif; font-weight: normal}
  51. ul.no-bullet {list-style: none}
  52. -->
  53. </style>
  54. </head>
  55. <body lang="en">
  56. <a name="M32R_002dOpts"></a>
  57. <div class="header">
  58. <p>
  59. Next: <a href="M32R_002dDirectives.html#M32R_002dDirectives" accesskey="n" rel="next">M32R-Directives</a>, Up: <a href="M32R_002dDependent.html#M32R_002dDependent" accesskey="u" rel="up">M32R-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>
  60. </div>
  61. <hr>
  62. <a name="M32R-Options"></a>
  63. <h4 class="subsection">9.21.1 M32R Options</h4>
  64. <a name="index-options_002c-M32R"></a>
  65. <a name="index-M32R-options"></a>
  66. <p>The Renesas M32R version of <code>as</code> has a few machine
  67. dependent options:
  68. </p>
  69. <dl compact="compact">
  70. <dt><code>-m32rx</code></dt>
  71. <dd><a name="index-_002dm32rx-option_002c-M32RX"></a>
  72. <a name="index-architecture-options_002c-M32RX"></a>
  73. <a name="index-M32R-architecture-options"></a>
  74. <p><code>as</code> can assemble code for several different members of the
  75. Renesas M32R family. Normally the default is to assemble code for
  76. the M32R microprocessor. This option may be used to change the default
  77. to the M32RX microprocessor, which adds some more instructions to the
  78. basic M32R instruction set, and some additional parameters to some of
  79. the original instructions.
  80. </p>
  81. </dd>
  82. <dt><code>-m32r2</code></dt>
  83. <dd><a name="index-_002dm32rx-option_002c-M32R2"></a>
  84. <a name="index-architecture-options_002c-M32R2"></a>
  85. <a name="index-M32R-architecture-options-1"></a>
  86. <p>This option changes the target processor to the M32R2
  87. microprocessor.
  88. </p>
  89. </dd>
  90. <dt><code>-m32r</code></dt>
  91. <dd><a name="index-_002dm32r-option_002c-M32R"></a>
  92. <a name="index-architecture-options_002c-M32R"></a>
  93. <a name="index-M32R-architecture-options-2"></a>
  94. <p>This option can be used to restore the assembler&rsquo;s default behaviour of
  95. assembling for the M32R microprocessor. This can be useful if the
  96. default has been changed by a previous command-line option.
  97. </p>
  98. </dd>
  99. <dt><code>-little</code></dt>
  100. <dd><a name="index-_002dlittle-option_002c-M32R"></a>
  101. <p>This option tells the assembler to produce little-endian code and
  102. data. The default is dependent upon how the toolchain was
  103. configured.
  104. </p>
  105. </dd>
  106. <dt><code>-EL</code></dt>
  107. <dd><a name="index-_002dEL-option_002c-M32R"></a>
  108. <p>This is a synonym for <em>-little</em>.
  109. </p>
  110. </dd>
  111. <dt><code>-big</code></dt>
  112. <dd><a name="index-_002dbig-option_002c-M32R"></a>
  113. <p>This option tells the assembler to produce big-endian code and
  114. data.
  115. </p>
  116. </dd>
  117. <dt><code>-EB</code></dt>
  118. <dd><a name="index-_002dEB-option_002c-M32R"></a>
  119. <p>This is a synonym for <em>-big</em>.
  120. </p>
  121. </dd>
  122. <dt><code>-KPIC</code></dt>
  123. <dd><a name="index-_002dKPIC-option_002c-M32R"></a>
  124. <a name="index-PIC-code-generation-for-M32R"></a>
  125. <p>This option specifies that the output of the assembler should be
  126. marked as position-independent code (PIC).
  127. </p>
  128. </dd>
  129. <dt><code>-parallel</code></dt>
  130. <dd><a name="index-_002dparallel-option_002c-M32RX"></a>
  131. <p>This option tells the assembler to attempts to combine two sequential
  132. instructions into a single, parallel instruction, where it is legal to
  133. do so.
  134. </p>
  135. </dd>
  136. <dt><code>-no-parallel</code></dt>
  137. <dd><a name="index-_002dno_002dparallel-option_002c-M32RX"></a>
  138. <p>This option disables a previously enabled <em>-parallel</em> option.
  139. </p>
  140. </dd>
  141. <dt><code>-no-bitinst</code></dt>
  142. <dd><a name="index-_002dno_002dbitinst_002c-M32R2"></a>
  143. <p>This option disables the support for the extended bit-field
  144. instructions provided by the M32R2. If this support needs to be
  145. re-enabled the <em>-bitinst</em> switch can be used to restore it.
  146. </p>
  147. </dd>
  148. <dt><code>-O</code></dt>
  149. <dd><a name="index-_002dO-option_002c-M32RX"></a>
  150. <p>This option tells the assembler to attempt to optimize the
  151. instructions that it produces. This includes filling delay slots and
  152. converting sequential instructions into parallel ones. This option
  153. implies <em>-parallel</em>.
  154. </p>
  155. </dd>
  156. <dt><code>-warn-explicit-parallel-conflicts</code></dt>
  157. <dd><a name="index-_002dwarn_002dexplicit_002dparallel_002dconflicts-option_002c-M32RX"></a>
  158. <p>Instructs <code>as</code> to produce warning messages when
  159. questionable parallel instructions are encountered. This option is
  160. enabled by default, but <code>gcc</code> disables it when it invokes
  161. <code>as</code> directly. Questionable instructions are those whose
  162. behaviour would be different if they were executed sequentially. For
  163. example the code fragment &lsquo;<samp>mv r1, r2 || mv r3, r1</samp>&rsquo; produces a
  164. different result from &lsquo;<samp>mv r1, r2 \n mv r3, r1</samp>&rsquo; since the former
  165. moves r1 into r3 and then r2 into r1, whereas the later moves r2 into r1
  166. and r3.
  167. </p>
  168. </dd>
  169. <dt><code>-Wp</code></dt>
  170. <dd><a name="index-_002dWp-option_002c-M32RX"></a>
  171. <p>This is a shorter synonym for the <em>-warn-explicit-parallel-conflicts</em>
  172. option.
  173. </p>
  174. </dd>
  175. <dt><code>-no-warn-explicit-parallel-conflicts</code></dt>
  176. <dd><a name="index-_002dno_002dwarn_002dexplicit_002dparallel_002dconflicts-option_002c-M32RX"></a>
  177. <p>Instructs <code>as</code> not to produce warning messages when
  178. questionable parallel instructions are encountered.
  179. </p>
  180. </dd>
  181. <dt><code>-Wnp</code></dt>
  182. <dd><a name="index-_002dWnp-option_002c-M32RX"></a>
  183. <p>This is a shorter synonym for the <em>-no-warn-explicit-parallel-conflicts</em>
  184. option.
  185. </p>
  186. </dd>
  187. <dt><code>-ignore-parallel-conflicts</code></dt>
  188. <dd><a name="index-_002dignore_002dparallel_002dconflicts-option_002c-M32RX"></a>
  189. <p>This option tells the assembler&rsquo;s to stop checking parallel
  190. instructions for constraint violations. This ability is provided for
  191. hardware vendors testing chip designs and should not be used under
  192. normal circumstances.
  193. </p>
  194. </dd>
  195. <dt><code>-no-ignore-parallel-conflicts</code></dt>
  196. <dd><a name="index-_002dno_002dignore_002dparallel_002dconflicts-option_002c-M32RX"></a>
  197. <p>This option restores the assembler&rsquo;s default behaviour of checking
  198. parallel instructions to detect constraint violations.
  199. </p>
  200. </dd>
  201. <dt><code>-Ip</code></dt>
  202. <dd><a name="index-_002dIp-option_002c-M32RX"></a>
  203. <p>This is a shorter synonym for the <em>-ignore-parallel-conflicts</em>
  204. option.
  205. </p>
  206. </dd>
  207. <dt><code>-nIp</code></dt>
  208. <dd><a name="index-_002dnIp-option_002c-M32RX"></a>
  209. <p>This is a shorter synonym for the <em>-no-ignore-parallel-conflicts</em>
  210. option.
  211. </p>
  212. </dd>
  213. <dt><code>-warn-unmatched-high</code></dt>
  214. <dd><a name="index-_002dwarn_002dunmatched_002dhigh-option_002c-M32R"></a>
  215. <p>This option tells the assembler to produce a warning message if a
  216. <code>.high</code> pseudo op is encountered without a matching <code>.low</code>
  217. pseudo op. The presence of such an unmatched pseudo op usually
  218. indicates a programming error.
  219. </p>
  220. </dd>
  221. <dt><code>-no-warn-unmatched-high</code></dt>
  222. <dd><a name="index-_002dno_002dwarn_002dunmatched_002dhigh-option_002c-M32R"></a>
  223. <p>Disables a previously enabled <em>-warn-unmatched-high</em> option.
  224. </p>
  225. </dd>
  226. <dt><code>-Wuh</code></dt>
  227. <dd><a name="index-_002dWuh-option_002c-M32RX"></a>
  228. <p>This is a shorter synonym for the <em>-warn-unmatched-high</em> option.
  229. </p>
  230. </dd>
  231. <dt><code>-Wnuh</code></dt>
  232. <dd><a name="index-_002dWnuh-option_002c-M32RX"></a>
  233. <p>This is a shorter synonym for the <em>-no-warn-unmatched-high</em> option.
  234. </p>
  235. </dd>
  236. </dl>
  237. <hr>
  238. <div class="header">
  239. <p>
  240. Next: <a href="M32R_002dDirectives.html#M32R_002dDirectives" accesskey="n" rel="next">M32R-Directives</a>, Up: <a href="M32R_002dDependent.html#M32R_002dDependent" accesskey="u" rel="up">M32R-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>
  241. </div>
  242. </body>
  243. </html>