visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
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.
2 Commits
1 Branch
Tree: 898a39b5ab
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '898a39b5ab'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/as.html/Sparc_002dOpts.html

238 lines
12KB
Raw Blame History 

  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. 

  5. Copyright (C) 1991-2020 Free Software Foundation, Inc.

  6. 

  7. Permission is granted to copy, distribute and/or modify this document

  8. under the terms of the GNU Free Documentation License, Version 1.3

  9. or any later version published by the Free Software Foundation;

  10. with no Invariant Sections, with no Front-Cover Texts, and with no

  11. Back-Cover Texts.  A copy of the license is included in the

  12. section entitled "GNU Free Documentation License".

  13.  -->

  14. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  15. <head>

  16. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  17. <title>Sparc-Opts (Using as)</title>

  18. 

  19. <meta name="description" content="Sparc-Opts (Using as)">

  20. <meta name="keywords" content="Sparc-Opts (Using as)">

  21. <meta name="resource-type" content="document">

  22. <meta name="distribution" content="global">

  23. <meta name="Generator" content="makeinfo">

  24. <link href="index.html#Top" rel="start" title="Top">

  25. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">

  26. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  27. <link href="Sparc_002dDependent.html#Sparc_002dDependent" rel="up" title="Sparc-Dependent">

  28. <link href="Sparc_002dAligned_002dData.html#Sparc_002dAligned_002dData" rel="next" title="Sparc-Aligned-Data">

  29. <link href="Sparc_002dDependent.html#Sparc_002dDependent" rel="prev" title="Sparc-Dependent">

  30. <style type="text/css">

  31. <!--

  32. a.summary-letter {text-decoration: none}

  33. blockquote.indentedblock {margin-right: 0em}

  34. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  35. blockquote.smallquotation {font-size: smaller}

  36. div.display {margin-left: 3.2em}

  37. div.example {margin-left: 3.2em}

  38. div.lisp {margin-left: 3.2em}

  39. div.smalldisplay {margin-left: 3.2em}

  40. div.smallexample {margin-left: 3.2em}

  41. div.smalllisp {margin-left: 3.2em}

  42. kbd {font-style: oblique}

  43. pre.display {font-family: inherit}

  44. pre.format {font-family: inherit}

  45. pre.menu-comment {font-family: serif}

  46. pre.menu-preformatted {font-family: serif}

  47. pre.smalldisplay {font-family: inherit; font-size: smaller}

  48. pre.smallexample {font-size: smaller}

  49. pre.smallformat {font-family: inherit; font-size: smaller}

  50. pre.smalllisp {font-size: smaller}

  51. span.nolinebreak {white-space: nowrap}

  52. span.roman {font-family: initial; font-weight: normal}

  53. span.sansserif {font-family: sans-serif; font-weight: normal}

  54. ul.no-bullet {list-style: none}

  55. -->

  56. </style>

  57. 

  58. 

  59. </head>

  60. 

  61. <body lang="en">

  62. <a name="Sparc_002dOpts"></a>

  63. <div class="header">

  64. <p>

  65. Next: <a href="Sparc_002dAligned_002dData.html#Sparc_002dAligned_002dData" accesskey="n" rel="next">Sparc-Aligned-Data</a>, Up: <a href="Sparc_002dDependent.html#Sparc_002dDependent" accesskey="u" rel="up">Sparc-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>

  66. </div>

  67. <hr>

  68. <a name="Options-24"></a>

  69. <h4 class="subsection">9.44.1 Options</h4>

  70. 

  71. <a name="index-options-for-SPARC"></a>

  72. <a name="index-SPARC-options"></a>

  73. <a name="index-architectures_002c-SPARC"></a>

  74. <a name="index-SPARC-architectures"></a>

  75. <p>The SPARC chip family includes several successive versions, using the same

  76. core instruction set, but including a few additional instructions at

  77. each version.  There are exceptions to this however.  For details on what

  78. instructions each variant supports, please see the chip&rsquo;s architecture

  79. reference manual.

  80. </p>

  81. <p>By default, <code>as</code> assumes the core instruction set (SPARC

  82. v6), but &ldquo;bumps&rdquo; the architecture level as needed: it switches to

  83. successively higher architectures as it encounters instructions that

  84. only exist in the higher levels.

  85. </p>

  86. <p>If not configured for SPARC v9 (<code>sparc64-*-*</code>) GAS will not bump

  87. past sparclite by default, an option must be passed to enable the

  88. v9 instructions.

  89. </p>

  90. <p>GAS treats sparclite as being compatible with v8, unless an architecture

  91. is explicitly requested.  SPARC v9 is always incompatible with sparclite.

  92. </p>

  93. 

  94. <dl compact="compact">

  95. <dd><a name="index-_002dAv6"></a>

  96. <a name="index-_002dAv7"></a>

  97. <a name="index-_002dAv8"></a>

  98. <a name="index-_002dAleon"></a>

  99. <a name="index-_002dAsparclet"></a>

  100. <a name="index-_002dAsparclite"></a>

  101. <a name="index-_002dAv9"></a>

  102. <a name="index-_002dAv9a"></a>

  103. <a name="index-_002dAv9b"></a>

  104. <a name="index-_002dAv9c"></a>

  105. <a name="index-_002dAv9d"></a>

  106. <a name="index-_002dAv9e"></a>

  107. <a name="index-_002dAv9v"></a>

  108. <a name="index-_002dAv9m"></a>

  109. <a name="index-_002dAsparc"></a>

  110. <a name="index-_002dAsparcvis"></a>

  111. <a name="index-_002dAsparcvis2"></a>

  112. <a name="index-_002dAsparcfmaf"></a>

  113. <a name="index-_002dAsparcima"></a>

  114. <a name="index-_002dAsparcvis3"></a>

  115. <a name="index-_002dAsparcvis3r"></a>

  116. </dd>

  117. <dt><code>-Av6 | -Av7 | -Av8 | -Aleon | -Asparclet | -Asparclite</code></dt>

  118. <dt><code>-Av8plus | -Av8plusa | -Av8plusb | -Av8plusc | -Av8plusd |</code></dt>

  119. <dt><code>-Av8plusv | -Av8plusm | -Av8plusm8</code></dt>

  120. <dt><code>-Av9 | -Av9a | -Av9b | -Av9c | -Av9d | -Av9e | -Av9v | -Av9m | -Av9m8</code></dt>

  121. <dt><code>-Asparc | -Asparcvis | -Asparcvis2 | -Asparcfmaf | -Asparcima</code></dt>

  122. <dt><code>-Asparcvis3 | -Asparcvis3r | -Asparc5 | -Asparc6</code></dt>

  123. <dd><p>Use one of the &lsquo;<samp>-A</samp>&rsquo; options to select one of the SPARC

  124. architectures explicitly.  If you select an architecture explicitly,

  125. <code>as</code> reports a fatal error if it encounters an instruction

  126. or feature requiring an incompatible or higher level.

  127. </p>

  128. <p>&lsquo;<samp>-Av8plus</samp>&rsquo;, &lsquo;<samp>-Av8plusa</samp>&rsquo;, &lsquo;<samp>-Av8plusb</samp>&rsquo;, &lsquo;<samp>-Av8plusc</samp>&rsquo;,

  129. &lsquo;<samp>-Av8plusd</samp>&rsquo;, and &lsquo;<samp>-Av8plusv</samp>&rsquo; select a 32 bit environment.

  130. </p>

  131. <p>&lsquo;<samp>-Av9</samp>&rsquo;, &lsquo;<samp>-Av9a</samp>&rsquo;, &lsquo;<samp>-Av9b</samp>&rsquo;, &lsquo;<samp>-Av9c</samp>&rsquo;, &lsquo;<samp>-Av9d</samp>&rsquo;,

  132. &lsquo;<samp>-Av9e</samp>&rsquo;, &lsquo;<samp>-Av9v</samp>&rsquo; and &lsquo;<samp>-Av9m</samp>&rsquo; select a 64 bit

  133. environment and are not available unless GAS is explicitly configured

  134. with 64 bit environment support.

  135. </p>

  136. <p>&lsquo;<samp>-Av8plusa</samp>&rsquo; and &lsquo;<samp>-Av9a</samp>&rsquo; enable the SPARC V9 instruction set with

  137. UltraSPARC VIS 1.0 extensions.

  138. </p>

  139. <p>&lsquo;<samp>-Av8plusb</samp>&rsquo; and &lsquo;<samp>-Av9b</samp>&rsquo; enable the UltraSPARC VIS 2.0 instructions,

  140. as well as the instructions enabled by &lsquo;<samp>-Av8plusa</samp>&rsquo; and &lsquo;<samp>-Av9a</samp>&rsquo;.

  141. </p>

  142. <p>&lsquo;<samp>-Av8plusc</samp>&rsquo; and &lsquo;<samp>-Av9c</samp>&rsquo; enable the UltraSPARC Niagara instructions,

  143. as well as the instructions enabled by &lsquo;<samp>-Av8plusb</samp>&rsquo; and &lsquo;<samp>-Av9b</samp>&rsquo;.

  144. </p>

  145. <p>&lsquo;<samp>-Av8plusd</samp>&rsquo; and &lsquo;<samp>-Av9d</samp>&rsquo; enable the floating point fused

  146. multiply-add, VIS 3.0, and HPC extension instructions, as well as the

  147. instructions enabled by &lsquo;<samp>-Av8plusc</samp>&rsquo; and &lsquo;<samp>-Av9c</samp>&rsquo;.

  148. </p>

  149. <p>&lsquo;<samp>-Av8pluse</samp>&rsquo; and &lsquo;<samp>-Av9e</samp>&rsquo; enable the cryptographic

  150. instructions, as well as the instructions enabled by &lsquo;<samp>-Av8plusd</samp>&rsquo;

  151. and &lsquo;<samp>-Av9d</samp>&rsquo;.

  152. </p>

  153. <p>&lsquo;<samp>-Av8plusv</samp>&rsquo; and &lsquo;<samp>-Av9v</samp>&rsquo; enable floating point unfused

  154. multiply-add, and integer multiply-add, as well as the instructions

  155. enabled by &lsquo;<samp>-Av8pluse</samp>&rsquo; and &lsquo;<samp>-Av9e</samp>&rsquo;.

  156. </p>

  157. <p>&lsquo;<samp>-Av8plusm</samp>&rsquo; and &lsquo;<samp>-Av9m</samp>&rsquo; enable the VIS 4.0, subtract extended,

  158. xmpmul, xmontmul and xmontsqr instructions, as well as the instructions

  159. enabled by &lsquo;<samp>-Av8plusv</samp>&rsquo; and &lsquo;<samp>-Av9v</samp>&rsquo;.

  160. </p>

  161. <p>&lsquo;<samp>-Av8plusm8</samp>&rsquo; and &lsquo;<samp>-Av9m8</samp>&rsquo; enable the instructions introduced

  162. in the Oracle SPARC Architecture 2017 and the M8 processor, as

  163. well as the instructions enabled by &lsquo;<samp>-Av8plusm</samp>&rsquo; and &lsquo;<samp>-Av9m</samp>&rsquo;.

  164. </p>

  165. <p>&lsquo;<samp>-Asparc</samp>&rsquo; specifies a v9 environment.  It is equivalent to

  166. &lsquo;<samp>-Av9</samp>&rsquo; if the word size is 64-bit, and &lsquo;<samp>-Av8plus</samp>&rsquo; otherwise.

  167. </p>

  168. <p>&lsquo;<samp>-Asparcvis</samp>&rsquo; specifies a v9a environment.  It is equivalent to

  169. &lsquo;<samp>-Av9a</samp>&rsquo; if the word size is 64-bit, and &lsquo;<samp>-Av8plusa</samp>&rsquo; otherwise.

  170. </p>

  171. <p>&lsquo;<samp>-Asparcvis2</samp>&rsquo; specifies a v9b environment.  It is equivalent to

  172. &lsquo;<samp>-Av9b</samp>&rsquo; if the word size is 64-bit, and &lsquo;<samp>-Av8plusb</samp>&rsquo; otherwise.

  173. </p>

  174. <p>&lsquo;<samp>-Asparcfmaf</samp>&rsquo; specifies a v9b environment with the floating point

  175. fused multiply-add instructions enabled.

  176. </p>

  177. <p>&lsquo;<samp>-Asparcima</samp>&rsquo; specifies a v9b environment with the integer

  178. multiply-add instructions enabled.

  179. </p>

  180. <p>&lsquo;<samp>-Asparcvis3</samp>&rsquo; specifies a v9b environment with the VIS 3.0,

  181. HPC , and floating point fused multiply-add instructions enabled.

  182. </p>

  183. <p>&lsquo;<samp>-Asparcvis3r</samp>&rsquo; specifies a v9b environment with the VIS 3.0, HPC,

  184. and floating point unfused multiply-add instructions enabled.

  185. </p>

  186. <p>&lsquo;<samp>-Asparc5</samp>&rsquo; is equivalent to &lsquo;<samp>-Av9m</samp>&rsquo;.

  187. </p>

  188. <p>&lsquo;<samp>-Asparc6</samp>&rsquo; is equivalent to &lsquo;<samp>-Av9m8</samp>&rsquo;.

  189. </p>

  190. </dd>

  191. <dt><code>-xarch=v8plus | -xarch=v8plusa | -xarch=v8plusb | -xarch=v8plusc</code></dt>

  192. <dt><code>-xarch=v8plusd | -xarch=v8plusv | -xarch=v8plusm |</code></dt>

  193. <dt><code>-xarch=v8plusm8 | -xarch=v9 | -xarch=v9a | -xarch=v9b</code></dt>

  194. <dt><code>-xarch=v9c | -xarch=v9d | -xarch=v9e | -xarch=v9v</code></dt>

  195. <dt><code>-xarch=v9m | -xarch=v9m8</code></dt>

  196. <dt><code>-xarch=sparc | -xarch=sparcvis | -xarch=sparcvis2</code></dt>

  197. <dt><code>-xarch=sparcfmaf | -xarch=sparcima | -xarch=sparcvis3</code></dt>

  198. <dt><code>-xarch=sparcvis3r | -xarch=sparc5 | -xarch=sparc6</code></dt>

  199. <dd><p>For compatibility with the SunOS v9 assembler.  These options are

  200. equivalent to -Av8plus, -Av8plusa, -Av8plusb, -Av8plusc, -Av8plusd,

  201. -Av8plusv, -Av8plusm, -Av8plusm8, -Av9, -Av9a, -Av9b, -Av9c, -Av9d,

  202. -Av9e, -Av9v, -Av9m, -Av9m8, -Asparc, -Asparcvis, -Asparcvis2,

  203. -Asparcfmaf, -Asparcima, -Asparcvis3, -Asparcvis3r, -Asparc5 and

  204. -Asparc6 respectively.

  205. </p>

  206. </dd>

  207. <dt><code>-bump</code></dt>

  208. <dd><p>Warn whenever it is necessary to switch to another level.

  209. If an architecture level is explicitly requested, GAS will not issue

  210. warnings until that level is reached, and will then bump the level

  211. as required (except between incompatible levels).

  212. </p>

  213. </dd>

  214. <dt><code>-32 | -64</code></dt>

  215. <dd><p>Select the word size, either 32 bits or 64 bits.

  216. These options are only available with the ELF object file format,

  217. and require that the necessary BFD support has been included.

  218. </p>

  219. </dd>

  220. <dt><code>--dcti-couples-detect</code></dt>

  221. <dd><p>Warn if a DCTI (delayed control transfer instruction) couple is found

  222. when generating code for a variant of the SPARC architecture in which

  223. the execution of the couple is unpredictable, or very slow.  This is

  224. disabled by default.

  225. </p></dd>

  226. </dl>

  227. 

  228. <hr>

  229. <div class="header">

  230. <p>

  231. Next: <a href="Sparc_002dAligned_002dData.html#Sparc_002dAligned_002dData" accesskey="n" rel="next">Sparc-Aligned-Data</a>, Up: <a href="Sparc_002dDependent.html#Sparc_002dDependent" accesskey="u" rel="up">Sparc-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>

  232. </div>

  233. 

  234. 

  235. 

  236. </body>

  237. </html>