M32R_002dOpts.html 10 KB

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