ARM-Options.html 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722
  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 5.1, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: ARM Options</title>
  15. <meta name="description" content="Using as: ARM Options">
  16. <meta name="keywords" content="Using as: ARM 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="ARM_002dDependent.html#ARM_002dDependent" rel="up" title="ARM-Dependent">
  25. <link href="ARM-Syntax.html#ARM-Syntax" rel="next" title="ARM Syntax">
  26. <link href="ARM_002dDependent.html#ARM_002dDependent" rel="previous" title="ARM-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="ARM-Options"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="ARM-Syntax.html#ARM-Syntax" accesskey="n" rel="next">ARM Syntax</a>, Up: <a href="ARM_002dDependent.html#ARM_002dDependent" accesskey="u" rel="up">ARM-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-3"></a>
  64. <h4 class="subsection">9.4.1 Options</h4>
  65. <a name="index-ARM-options-_0028none_0029"></a>
  66. <a name="index-options-for-ARM-_0028none_0029"></a>
  67. <dl compact="compact">
  68. <dd>
  69. <a name="index-_002dmcpu_003d-command_002dline-option_002c-ARM"></a>
  70. </dd>
  71. <dt><code>-mcpu=<var>processor</var>[+<var>extension</var>&hellip;]</code></dt>
  72. <dd><p>This option specifies the target processor. The assembler will issue an
  73. error message if an attempt is made to assemble an instruction which
  74. will not execute on the target processor. The following processor names are
  75. recognized:
  76. <code>arm1</code>,
  77. <code>arm2</code>,
  78. <code>arm250</code>,
  79. <code>arm3</code>,
  80. <code>arm6</code>,
  81. <code>arm60</code>,
  82. <code>arm600</code>,
  83. <code>arm610</code>,
  84. <code>arm620</code>,
  85. <code>arm7</code>,
  86. <code>arm7m</code>,
  87. <code>arm7d</code>,
  88. <code>arm7dm</code>,
  89. <code>arm7di</code>,
  90. <code>arm7dmi</code>,
  91. <code>arm70</code>,
  92. <code>arm700</code>,
  93. <code>arm700i</code>,
  94. <code>arm710</code>,
  95. <code>arm710t</code>,
  96. <code>arm720</code>,
  97. <code>arm720t</code>,
  98. <code>arm740t</code>,
  99. <code>arm710c</code>,
  100. <code>arm7100</code>,
  101. <code>arm7500</code>,
  102. <code>arm7500fe</code>,
  103. <code>arm7t</code>,
  104. <code>arm7tdmi</code>,
  105. <code>arm7tdmi-s</code>,
  106. <code>arm8</code>,
  107. <code>arm810</code>,
  108. <code>strongarm</code>,
  109. <code>strongarm1</code>,
  110. <code>strongarm110</code>,
  111. <code>strongarm1100</code>,
  112. <code>strongarm1110</code>,
  113. <code>arm9</code>,
  114. <code>arm920</code>,
  115. <code>arm920t</code>,
  116. <code>arm922t</code>,
  117. <code>arm940t</code>,
  118. <code>arm9tdmi</code>,
  119. <code>fa526</code> (Faraday FA526 processor),
  120. <code>fa626</code> (Faraday FA626 processor),
  121. <code>arm9e</code>,
  122. <code>arm926e</code>,
  123. <code>arm926ej-s</code>,
  124. <code>arm946e-r0</code>,
  125. <code>arm946e</code>,
  126. <code>arm946e-s</code>,
  127. <code>arm966e-r0</code>,
  128. <code>arm966e</code>,
  129. <code>arm966e-s</code>,
  130. <code>arm968e-s</code>,
  131. <code>arm10t</code>,
  132. <code>arm10tdmi</code>,
  133. <code>arm10e</code>,
  134. <code>arm1020</code>,
  135. <code>arm1020t</code>,
  136. <code>arm1020e</code>,
  137. <code>arm1022e</code>,
  138. <code>arm1026ej-s</code>,
  139. <code>fa606te</code> (Faraday FA606TE processor),
  140. <code>fa616te</code> (Faraday FA616TE processor),
  141. <code>fa626te</code> (Faraday FA626TE processor),
  142. <code>fmp626</code> (Faraday FMP626 processor),
  143. <code>fa726te</code> (Faraday FA726TE processor),
  144. <code>arm1136j-s</code>,
  145. <code>arm1136jf-s</code>,
  146. <code>arm1156t2-s</code>,
  147. <code>arm1156t2f-s</code>,
  148. <code>arm1176jz-s</code>,
  149. <code>arm1176jzf-s</code>,
  150. <code>mpcore</code>,
  151. <code>mpcorenovfp</code>,
  152. <code>cortex-a5</code>,
  153. <code>cortex-a7</code>,
  154. <code>cortex-a8</code>,
  155. <code>cortex-a9</code>,
  156. <code>cortex-a15</code>,
  157. <code>cortex-a17</code>,
  158. <code>cortex-a32</code>,
  159. <code>cortex-a35</code>,
  160. <code>cortex-a53</code>,
  161. <code>cortex-a55</code>,
  162. <code>cortex-a57</code>,
  163. <code>cortex-a72</code>,
  164. <code>cortex-a73</code>,
  165. <code>cortex-a75</code>,
  166. <code>cortex-a76</code>,
  167. <code>cortex-a76ae</code>,
  168. <code>cortex-a77</code>,
  169. <code>ares</code>,
  170. <code>cortex-r4</code>,
  171. <code>cortex-r4f</code>,
  172. <code>cortex-r5</code>,
  173. <code>cortex-r7</code>,
  174. <code>cortex-r8</code>,
  175. <code>cortex-r52</code>,
  176. <code>cortex-m35p</code>,
  177. <code>cortex-m33</code>,
  178. <code>cortex-m23</code>,
  179. <code>cortex-m7</code>,
  180. <code>cortex-m4</code>,
  181. <code>cortex-m3</code>,
  182. <code>cortex-m1</code>,
  183. <code>cortex-m0</code>,
  184. <code>cortex-m0plus</code>,
  185. <code>exynos-m1</code>,
  186. <code>marvell-pj4</code>,
  187. <code>marvell-whitney</code>,
  188. <code>neoverse-n1</code>,
  189. <code>neoverse-n2</code>,
  190. <code>neoverse-v1</code>,
  191. <code>xgene1</code>,
  192. <code>xgene2</code>,
  193. <code>ep9312</code> (ARM920 with Cirrus Maverick coprocessor),
  194. <code>i80200</code> (Intel XScale processor)
  195. <code>iwmmxt</code> (Intel XScale processor with Wireless MMX technology coprocessor)
  196. and
  197. <code>xscale</code>.
  198. The special name <code>all</code> may be used to allow the
  199. assembler to accept instructions valid for any ARM processor.
  200. </p>
  201. <p>In addition to the basic instruction set, the assembler can be told to
  202. accept various extension mnemonics that extend the processor using the
  203. co-processor instruction space. For example, <code>-mcpu=arm920+maverick</code>
  204. is equivalent to specifying <code>-mcpu=ep9312</code>.
  205. </p>
  206. <p>Multiple extensions may be specified, separated by a <code>+</code>. The
  207. extensions should be specified in ascending alphabetical order.
  208. </p>
  209. <p>Some extensions may be restricted to particular architectures; this is
  210. documented in the list of extensions below.
  211. </p>
  212. <p>Extension mnemonics may also be removed from those the assembler accepts.
  213. This is done be prepending <code>no</code> to the option that adds the extension.
  214. Extensions that are removed should be listed after all extensions which have
  215. been added, again in ascending alphabetical order. For example,
  216. <code>-mcpu=ep9312+nomaverick</code> is equivalent to specifying <code>-mcpu=arm920</code>.
  217. </p>
  218. <p>The following extensions are currently supported:
  219. <code>bf16</code> (BFloat16 extensions for v8.6-A architecture),
  220. <code>i8mm</code> (Int8 Matrix Multiply extensions for v8.6-A architecture),
  221. <code>crc</code>
  222. <code>crypto</code> (Cryptography Extensions for v8-A architecture, implies <code>fp+simd</code>),
  223. <code>dotprod</code> (Dot Product Extensions for v8.2-A architecture, implies <code>fp+simd</code>),
  224. <code>fp</code> (Floating Point Extensions for v8-A architecture),
  225. <code>fp16</code> (FP16 Extensions for v8.2-A architecture, implies <code>fp</code>),
  226. <code>fp16fml</code> (FP16 Floating Point Multiplication Variant Extensions for v8.2-A architecture, implies <code>fp16</code>),
  227. <code>idiv</code> (Integer Divide Extensions for v7-A and v7-R architectures),
  228. <code>iwmmxt</code>,
  229. <code>iwmmxt2</code>,
  230. <code>xscale</code>,
  231. <code>maverick</code>,
  232. <code>mp</code> (Multiprocessing Extensions for v7-A and v7-R
  233. architectures),
  234. <code>os</code> (Operating System for v6M architecture),
  235. <code>predres</code> (Execution and Data Prediction Restriction Instruction for
  236. v8-A architectures, added by default from v8.5-A),
  237. <code>sb</code> (Speculation Barrier Instruction for v8-A architectures, added by
  238. default from v8.5-A),
  239. <code>sec</code> (Security Extensions for v6K and v7-A architectures),
  240. <code>simd</code> (Advanced SIMD Extensions for v8-A architecture, implies <code>fp</code>),
  241. <code>virt</code> (Virtualization Extensions for v7-A architecture, implies
  242. <code>idiv</code>),
  243. <code>pan</code> (Privileged Access Never Extensions for v8-A architecture),
  244. <code>ras</code> (Reliability, Availability and Serviceability extensions
  245. for v8-A architecture),
  246. <code>rdma</code> (ARMv8.1 Advanced SIMD extensions for v8-A architecture, implies
  247. <code>simd</code>)
  248. and
  249. <code>xscale</code>.
  250. </p>
  251. <a name="index-_002dmarch_003d-command_002dline-option_002c-ARM"></a>
  252. </dd>
  253. <dt><code>-march=<var>architecture</var>[+<var>extension</var>&hellip;]</code></dt>
  254. <dd><p>This option specifies the target architecture. The assembler will issue
  255. an error message if an attempt is made to assemble an instruction which
  256. will not execute on the target architecture. The following architecture
  257. names are recognized:
  258. <code>armv1</code>,
  259. <code>armv2</code>,
  260. <code>armv2a</code>,
  261. <code>armv2s</code>,
  262. <code>armv3</code>,
  263. <code>armv3m</code>,
  264. <code>armv4</code>,
  265. <code>armv4xm</code>,
  266. <code>armv4t</code>,
  267. <code>armv4txm</code>,
  268. <code>armv5</code>,
  269. <code>armv5t</code>,
  270. <code>armv5txm</code>,
  271. <code>armv5te</code>,
  272. <code>armv5texp</code>,
  273. <code>armv6</code>,
  274. <code>armv6j</code>,
  275. <code>armv6k</code>,
  276. <code>armv6z</code>,
  277. <code>armv6kz</code>,
  278. <code>armv6-m</code>,
  279. <code>armv6s-m</code>,
  280. <code>armv7</code>,
  281. <code>armv7-a</code>,
  282. <code>armv7ve</code>,
  283. <code>armv7-r</code>,
  284. <code>armv7-m</code>,
  285. <code>armv7e-m</code>,
  286. <code>armv8-a</code>,
  287. <code>armv8.1-a</code>,
  288. <code>armv8.2-a</code>,
  289. <code>armv8.3-a</code>,
  290. <code>armv8-r</code>,
  291. <code>armv8.4-a</code>,
  292. <code>armv8.5-a</code>,
  293. <code>armv8-m.base</code>,
  294. <code>armv8-m.main</code>,
  295. <code>armv8.1-m.main</code>,
  296. <code>armv8.6-a</code>,
  297. <code>iwmmxt</code>,
  298. <code>iwmmxt2</code>
  299. and
  300. <code>xscale</code>.
  301. If both <code>-mcpu</code> and
  302. <code>-march</code> are specified, the assembler will use
  303. the setting for <code>-mcpu</code>.
  304. </p>
  305. <p>The architecture option can be extended with a set extension options. These
  306. extensions are context sensitive, i.e. the same extension may mean different
  307. things when used with different architectures. When used together with a
  308. <code>-mfpu</code> option, the union of both feature enablement is taken.
  309. See their availability and meaning below:
  310. </p>
  311. <p>For <code>armv5te</code>, <code>armv5texp</code>, <code>armv5tej</code>, <code>armv6</code>, <code>armv6j</code>, <code>armv6k</code>, <code>armv6z</code>, <code>armv6kz</code>, <code>armv6zk</code>, <code>armv6t2</code>, <code>armv6kt2</code> and <code>armv6zt2</code>:
  312. </p>
  313. <p><code>+fp</code>: Enables VFPv2 instructions.
  314. <code>+nofp</code>: Disables all FPU instrunctions.
  315. </p>
  316. <p>For <code>armv7</code>:
  317. </p>
  318. <p><code>+fp</code>: Enables VFPv3 instructions with 16 double-word registers.
  319. <code>+nofp</code>: Disables all FPU instructions.
  320. </p>
  321. <p>For <code>armv7-a</code>:
  322. </p>
  323. <p><code>+fp</code>: Enables VFPv3 instructions with 16 double-word registers.
  324. <code>+vfpv3-d16</code>: Alias for <code>+fp</code>.
  325. <code>+vfpv3</code>: Enables VFPv3 instructions with 32 double-word registers.
  326. <code>+vfpv3-d16-fp16</code>: Enables VFPv3 with half precision floating-point
  327. conversion instructions and 16 double-word registers.
  328. <code>+vfpv3-fp16</code>: Enables VFPv3 with half precision floating-point conversion
  329. instructions and 32 double-word registers.
  330. <code>+vfpv4-d16</code>: Enables VFPv4 instructions with 16 double-word registers.
  331. <code>+vfpv4</code>: Enables VFPv4 instructions with 32 double-word registers.
  332. <code>+simd</code>: Enables VFPv3 and NEONv1 instructions with 32 double-word
  333. registers.
  334. <code>+neon</code>: Alias for <code>+simd</code>.
  335. <code>+neon-vfpv3</code>: Alias for <code>+simd</code>.
  336. <code>+neon-fp16</code>: Enables VFPv3, half precision floating-point conversion and
  337. NEONv1 instructions with 32 double-word registers.
  338. <code>+neon-vfpv4</code>: Enables VFPv4 and NEONv1 with Fused-MAC instructions and 32
  339. double-word registers.
  340. <code>+mp</code>: Enables Multiprocessing Extensions.
  341. <code>+sec</code>: Enables Security Extensions.
  342. <code>+nofp</code>: Disables all FPU and NEON instructions.
  343. <code>+nosimd</code>: Disables all NEON instructions.
  344. </p>
  345. <p>For <code>armv7ve</code>:
  346. </p>
  347. <p><code>+fp</code>: Enables VFPv4 instructions with 16 double-word registers.
  348. <code>+vfpv4-d16</code>: Alias for <code>+fp</code>.
  349. <code>+vfpv3-d16</code>: Enables VFPv3 instructions with 16 double-word registers.
  350. <code>+vfpv3</code>: Enables VFPv3 instructions with 32 double-word registers.
  351. <code>+vfpv3-d16-fp16</code>: Enables VFPv3 with half precision floating-point
  352. conversion instructions and 16 double-word registers.
  353. <code>+vfpv3-fp16</code>: Enables VFPv3 with half precision floating-point conversion
  354. instructions and 32 double-word registers.
  355. <code>+vfpv4</code>: Enables VFPv4 instructions with 32 double-word registers.
  356. <code>+simd</code>: Enables VFPv4 and NEONv1 with Fused-MAC instructions and 32
  357. double-word registers.
  358. <code>+neon-vfpv4</code>: Alias for <code>+simd</code>.
  359. <code>+neon</code>: Enables VFPv3 and NEONv1 instructions with 32 double-word
  360. registers.
  361. <code>+neon-vfpv3</code>: Alias for <code>+neon</code>.
  362. <code>+neon-fp16</code>: Enables VFPv3, half precision floating-point conversion and
  363. NEONv1 instructions with 32 double-word registers.
  364. double-word registers.
  365. <code>+nofp</code>: Disables all FPU and NEON instructions.
  366. <code>+nosimd</code>: Disables all NEON instructions.
  367. </p>
  368. <p>For <code>armv7-r</code>:
  369. </p>
  370. <p><code>+fp.sp</code>: Enables single-precision only VFPv3 instructions with 16
  371. double-word registers.
  372. <code>+vfpv3xd</code>: Alias for <code>+fp.sp</code>.
  373. <code>+fp</code>: Enables VFPv3 instructions with 16 double-word registers.
  374. <code>+vfpv3-d16</code>: Alias for <code>+fp</code>.
  375. <code>+vfpv3xd-fp16</code>: Enables single-precision only VFPv3 and half
  376. floating-point conversion instructions with 16 double-word registers.
  377. <code>+vfpv3-d16-fp16</code>: Enables VFPv3 and half precision floating-point
  378. conversion instructions with 16 double-word registers.
  379. <code>+idiv</code>: Enables integer division instructions in ARM mode.
  380. <code>+nofp</code>: Disables all FPU instructions.
  381. </p>
  382. <p>For <code>armv7e-m</code>:
  383. </p>
  384. <p><code>+fp</code>: Enables single-precision only VFPv4 instructions with 16
  385. double-word registers.
  386. <code>+vfpvf4-sp-d16</code>: Alias for <code>+fp</code>.
  387. <code>+fpv5</code>: Enables single-precision only VFPv5 instructions with 16
  388. double-word registers.
  389. <code>+fp.dp</code>: Enables VFPv5 instructions with 16 double-word registers.
  390. <code>+fpv5-d16&quot;</code>: Alias for <code>+fp.dp</code>.
  391. <code>+nofp</code>: Disables all FPU instructions.
  392. </p>
  393. <p>For <code>armv8-m.main</code>:
  394. </p>
  395. <p><code>+dsp</code>: Enables DSP Extension.
  396. <code>+fp</code>: Enables single-precision only VFPv5 instructions with 16
  397. double-word registers.
  398. <code>+fp.dp</code>: Enables VFPv5 instructions with 16 double-word registers.
  399. <code>+cdecp0</code> (CDE extensions for v8-m architecture with coprocessor 0),
  400. <code>+cdecp1</code> (CDE extensions for v8-m architecture with coprocessor 1),
  401. <code>+cdecp2</code> (CDE extensions for v8-m architecture with coprocessor 2),
  402. <code>+cdecp3</code> (CDE extensions for v8-m architecture with coprocessor 3),
  403. <code>+cdecp4</code> (CDE extensions for v8-m architecture with coprocessor 4),
  404. <code>+cdecp5</code> (CDE extensions for v8-m architecture with coprocessor 5),
  405. <code>+cdecp6</code> (CDE extensions for v8-m architecture with coprocessor 6),
  406. <code>+cdecp7</code> (CDE extensions for v8-m architecture with coprocessor 7),
  407. <code>+nofp</code>: Disables all FPU instructions.
  408. <code>+nodsp</code>: Disables DSP Extension.
  409. </p>
  410. <p>For <code>armv8.1-m.main</code>:
  411. </p>
  412. <p><code>+dsp</code>: Enables DSP Extension.
  413. <code>+fp</code>: Enables single and half precision scalar Floating Point Extensions
  414. for Armv8.1-M Mainline with 16 double-word registers.
  415. <code>+fp.dp</code>: Enables double precision scalar Floating Point Extensions for
  416. Armv8.1-M Mainline, implies <code>+fp</code>.
  417. <code>+mve</code>: Enables integer only M-profile Vector Extension for
  418. Armv8.1-M Mainline, implies <code>+dsp</code>.
  419. <code>+mve.fp</code>: Enables Floating Point M-profile Vector Extension for
  420. Armv8.1-M Mainline, implies <code>+mve</code> and <code>+fp</code>.
  421. <code>+nofp</code>: Disables all FPU instructions.
  422. <code>+nodsp</code>: Disables DSP Extension.
  423. <code>+nomve</code>: Disables all M-profile Vector Extensions.
  424. </p>
  425. <p>For <code>armv8-a</code>:
  426. </p>
  427. <p><code>+crc</code>: Enables CRC32 Extension.
  428. <code>+simd</code>: Enables VFP and NEON for Armv8-A.
  429. <code>+crypto</code>: Enables Cryptography Extensions for Armv8-A, implies
  430. <code>+simd</code>.
  431. <code>+sb</code>: Enables Speculation Barrier Instruction for Armv8-A.
  432. <code>+predres</code>: Enables Execution and Data Prediction Restriction Instruction
  433. for Armv8-A.
  434. <code>+nofp</code>: Disables all FPU, NEON and Cryptography Extensions.
  435. <code>+nocrypto</code>: Disables Cryptography Extensions.
  436. </p>
  437. <p>For <code>armv8.1-a</code>:
  438. </p>
  439. <p><code>+simd</code>: Enables VFP and NEON for Armv8.1-A.
  440. <code>+crypto</code>: Enables Cryptography Extensions for Armv8-A, implies
  441. <code>+simd</code>.
  442. <code>+sb</code>: Enables Speculation Barrier Instruction for Armv8-A.
  443. <code>+predres</code>: Enables Execution and Data Prediction Restriction Instruction
  444. for Armv8-A.
  445. <code>+nofp</code>: Disables all FPU, NEON and Cryptography Extensions.
  446. <code>+nocrypto</code>: Disables Cryptography Extensions.
  447. </p>
  448. <p>For <code>armv8.2-a</code> and <code>armv8.3-a</code>:
  449. </p>
  450. <p><code>+simd</code>: Enables VFP and NEON for Armv8.1-A.
  451. <code>+fp16</code>: Enables FP16 Extension for Armv8.2-A, implies <code>+simd</code>.
  452. <code>+fp16fml</code>: Enables FP16 Floating Point Multiplication Variant Extensions
  453. for Armv8.2-A, implies <code>+fp16</code>.
  454. <code>+crypto</code>: Enables Cryptography Extensions for Armv8-A, implies
  455. <code>+simd</code>.
  456. <code>+dotprod</code>: Enables Dot Product Extensions for Armv8.2-A, implies
  457. <code>+simd</code>.
  458. <code>+sb</code>: Enables Speculation Barrier Instruction for Armv8-A.
  459. <code>+predres</code>: Enables Execution and Data Prediction Restriction Instruction
  460. for Armv8-A.
  461. <code>+nofp</code>: Disables all FPU, NEON, Cryptography and Dot Product Extensions.
  462. <code>+nocrypto</code>: Disables Cryptography Extensions.
  463. </p>
  464. <p>For <code>armv8.4-a</code>:
  465. </p>
  466. <p><code>+simd</code>: Enables VFP and NEON for Armv8.1-A and Dot Product Extensions for
  467. Armv8.2-A.
  468. <code>+fp16</code>: Enables FP16 Floating Point and Floating Point Multiplication
  469. Variant Extensions for Armv8.2-A, implies <code>+simd</code>.
  470. <code>+crypto</code>: Enables Cryptography Extensions for Armv8-A, implies
  471. <code>+simd</code>.
  472. <code>+sb</code>: Enables Speculation Barrier Instruction for Armv8-A.
  473. <code>+predres</code>: Enables Execution and Data Prediction Restriction Instruction
  474. for Armv8-A.
  475. <code>+nofp</code>: Disables all FPU, NEON, Cryptography and Dot Product Extensions.
  476. <code>+nocryptp</code>: Disables Cryptography Extensions.
  477. </p>
  478. <p>For <code>armv8.5-a</code>:
  479. </p>
  480. <p><code>+simd</code>: Enables VFP and NEON for Armv8.1-A and Dot Product Extensions for
  481. Armv8.2-A.
  482. <code>+fp16</code>: Enables FP16 Floating Point and Floating Point Multiplication
  483. Variant Extensions for Armv8.2-A, implies <code>+simd</code>.
  484. <code>+crypto</code>: Enables Cryptography Extensions for Armv8-A, implies
  485. <code>+simd</code>.
  486. <code>+nofp</code>: Disables all FPU, NEON, Cryptography and Dot Product Extensions.
  487. <code>+nocryptp</code>: Disables Cryptography Extensions.
  488. </p>
  489. <a name="index-_002dmfpu_003d-command_002dline-option_002c-ARM"></a>
  490. </dd>
  491. <dt><code>-mfpu=<var>floating-point-format</var></code></dt>
  492. <dd>
  493. <p>This option specifies the floating point format to assemble for. The
  494. assembler will issue an error message if an attempt is made to assemble
  495. an instruction which will not execute on the target floating point unit.
  496. The following format options are recognized:
  497. <code>softfpa</code>,
  498. <code>fpe</code>,
  499. <code>fpe2</code>,
  500. <code>fpe3</code>,
  501. <code>fpa</code>,
  502. <code>fpa10</code>,
  503. <code>fpa11</code>,
  504. <code>arm7500fe</code>,
  505. <code>softvfp</code>,
  506. <code>softvfp+vfp</code>,
  507. <code>vfp</code>,
  508. <code>vfp10</code>,
  509. <code>vfp10-r0</code>,
  510. <code>vfp9</code>,
  511. <code>vfpxd</code>,
  512. <code>vfpv2</code>,
  513. <code>vfpv3</code>,
  514. <code>vfpv3-fp16</code>,
  515. <code>vfpv3-d16</code>,
  516. <code>vfpv3-d16-fp16</code>,
  517. <code>vfpv3xd</code>,
  518. <code>vfpv3xd-d16</code>,
  519. <code>vfpv4</code>,
  520. <code>vfpv4-d16</code>,
  521. <code>fpv4-sp-d16</code>,
  522. <code>fpv5-sp-d16</code>,
  523. <code>fpv5-d16</code>,
  524. <code>fp-armv8</code>,
  525. <code>arm1020t</code>,
  526. <code>arm1020e</code>,
  527. <code>arm1136jf-s</code>,
  528. <code>maverick</code>,
  529. <code>neon</code>,
  530. <code>neon-vfpv3</code>,
  531. <code>neon-fp16</code>,
  532. <code>neon-vfpv4</code>,
  533. <code>neon-fp-armv8</code>,
  534. <code>crypto-neon-fp-armv8</code>,
  535. <code>neon-fp-armv8.1</code>
  536. and
  537. <code>crypto-neon-fp-armv8.1</code>.
  538. </p>
  539. <p>In addition to determining which instructions are assembled, this option
  540. also affects the way in which the <code>.double</code> assembler directive behaves
  541. when assembling little-endian code.
  542. </p>
  543. <p>The default is dependent on the processor selected. For Architecture 5 or
  544. later, the default is to assemble for VFP instructions; for earlier
  545. architectures the default is to assemble for FPA instructions.
  546. </p>
  547. <a name="index-_002dmfp16_002dformat_003d-command_002dline-option"></a>
  548. </dd>
  549. <dt><code>-mfp16-format=<var>format</var></code></dt>
  550. <dd><p>This option specifies the half-precision floating point format to use
  551. when assembling floating point numbers emitted by the <code>.float16</code>
  552. directive.
  553. The following format options are recognized:
  554. <code>ieee</code>,
  555. <code>alternative</code>.
  556. If <code>ieee</code> is specified then the IEEE 754-2008 half-precision floating
  557. point format is used, if <code>alternative</code> is specified then the Arm
  558. alternative half-precision format is used. If this option is set on the
  559. command line then the format is fixed and cannot be changed with
  560. the <code>float16_format</code> directive. If this value is not set then
  561. the IEEE 754-2008 format is used until the format is explicitly set with
  562. the <code>float16_format</code> directive.
  563. </p>
  564. <a name="index-_002dmthumb-command_002dline-option_002c-ARM"></a>
  565. </dd>
  566. <dt><code>-mthumb</code></dt>
  567. <dd><p>This option specifies that the assembler should start assembling Thumb
  568. instructions; that is, it should behave as though the file starts with a
  569. <code>.code 16</code> directive.
  570. </p>
  571. <a name="index-_002dmthumb_002dinterwork-command_002dline-option_002c-ARM"></a>
  572. </dd>
  573. <dt><code>-mthumb-interwork</code></dt>
  574. <dd><p>This option specifies that the output generated by the assembler should
  575. be marked as supporting interworking. It also affects the behaviour
  576. of the <code>ADR</code> and <code>ADRL</code> pseudo opcodes.
  577. </p>
  578. <a name="index-_002dmimplicit_002dit-command_002dline-option_002c-ARM"></a>
  579. </dd>
  580. <dt><code>-mimplicit-it=never</code></dt>
  581. <dt><code>-mimplicit-it=always</code></dt>
  582. <dt><code>-mimplicit-it=arm</code></dt>
  583. <dt><code>-mimplicit-it=thumb</code></dt>
  584. <dd><p>The <code>-mimplicit-it</code> option controls the behavior of the assembler when
  585. conditional instructions are not enclosed in IT blocks.
  586. There are four possible behaviors.
  587. If <code>never</code> is specified, such constructs cause a warning in ARM
  588. code and an error in Thumb-2 code.
  589. If <code>always</code> is specified, such constructs are accepted in both
  590. ARM and Thumb-2 code, where the IT instruction is added implicitly.
  591. If <code>arm</code> is specified, such constructs are accepted in ARM code
  592. and cause an error in Thumb-2 code.
  593. If <code>thumb</code> is specified, such constructs cause a warning in ARM
  594. code and are accepted in Thumb-2 code. If you omit this option, the
  595. behavior is equivalent to <code>-mimplicit-it=arm</code>.
  596. </p>
  597. <a name="index-_002dmapcs_002d26-command_002dline-option_002c-ARM"></a>
  598. <a name="index-_002dmapcs_002d32-command_002dline-option_002c-ARM"></a>
  599. </dd>
  600. <dt><code>-mapcs-26</code></dt>
  601. <dt><code>-mapcs-32</code></dt>
  602. <dd><p>These options specify that the output generated by the assembler should
  603. be marked as supporting the indicated version of the Arm Procedure.
  604. Calling Standard.
  605. </p>
  606. <a name="index-_002dmatpcs-command_002dline-option_002c-ARM"></a>
  607. </dd>
  608. <dt><code>-matpcs</code></dt>
  609. <dd><p>This option specifies that the output generated by the assembler should
  610. be marked as supporting the Arm/Thumb Procedure Calling Standard. If
  611. enabled this option will cause the assembler to create an empty
  612. debugging section in the object file called .arm.atpcs. Debuggers can
  613. use this to determine the ABI being used by.
  614. </p>
  615. <a name="index-_002dmapcs_002dfloat-command_002dline-option_002c-ARM"></a>
  616. </dd>
  617. <dt><code>-mapcs-float</code></dt>
  618. <dd><p>This indicates the floating point variant of the APCS should be
  619. used. In this variant floating point arguments are passed in FP
  620. registers rather than integer registers.
  621. </p>
  622. <a name="index-_002dmapcs_002dreentrant-command_002dline-option_002c-ARM"></a>
  623. </dd>
  624. <dt><code>-mapcs-reentrant</code></dt>
  625. <dd><p>This indicates that the reentrant variant of the APCS should be used.
  626. This variant supports position independent code.
  627. </p>
  628. <a name="index-_002dmfloat_002dabi_003d-command_002dline-option_002c-ARM"></a>
  629. </dd>
  630. <dt><code>-mfloat-abi=<var>abi</var></code></dt>
  631. <dd><p>This option specifies that the output generated by the assembler should be
  632. marked as using specified floating point ABI.
  633. The following values are recognized:
  634. <code>soft</code>,
  635. <code>softfp</code>
  636. and
  637. <code>hard</code>.
  638. </p>
  639. <a name="index-_002deabi_003d-command_002dline-option_002c-ARM"></a>
  640. </dd>
  641. <dt><code>-meabi=<var>ver</var></code></dt>
  642. <dd><p>This option specifies which EABI version the produced object files should
  643. conform to.
  644. The following values are recognized:
  645. <code>gnu</code>,
  646. <code>4</code>
  647. and
  648. <code>5</code>.
  649. </p>
  650. <a name="index-_002dEB-command_002dline-option_002c-ARM"></a>
  651. </dd>
  652. <dt><code>-EB</code></dt>
  653. <dd><p>This option specifies that the output generated by the assembler should
  654. be marked as being encoded for a big-endian processor.
  655. </p>
  656. <p>Note: If a program is being built for a system with big-endian data
  657. and little-endian instructions then it should be assembled with the
  658. <samp>-EB</samp> option, (all of it, code and data) and then linked with
  659. the <samp>--be8</samp> option. This will reverse the endianness of the
  660. instructions back to little-endian, but leave the data as big-endian.
  661. </p>
  662. <a name="index-_002dEL-command_002dline-option_002c-ARM"></a>
  663. </dd>
  664. <dt><code>-EL</code></dt>
  665. <dd><p>This option specifies that the output generated by the assembler should
  666. be marked as being encoded for a little-endian processor.
  667. </p>
  668. <a name="index-_002dk-command_002dline-option_002c-ARM"></a>
  669. <a name="index-PIC-code-generation-for-ARM"></a>
  670. </dd>
  671. <dt><code>-k</code></dt>
  672. <dd><p>This option specifies that the output of the assembler should be marked
  673. as position-independent code (PIC).
  674. </p>
  675. <a name="index-_002d_002dfix_002dv4bx-command_002dline-option_002c-ARM"></a>
  676. </dd>
  677. <dt><code>--fix-v4bx</code></dt>
  678. <dd><p>Allow <code>BX</code> instructions in ARMv4 code. This is intended for use with
  679. the linker option of the same name.
  680. </p>
  681. <a name="index-_002dmwarn_002ddeprecated-command_002dline-option_002c-ARM"></a>
  682. </dd>
  683. <dt><code>-mwarn-deprecated</code></dt>
  684. <dt><code>-mno-warn-deprecated</code></dt>
  685. <dd><p>Enable or disable warnings about using deprecated options or
  686. features. The default is to warn.
  687. </p>
  688. <a name="index-_002dmccs-command_002dline-option_002c-ARM"></a>
  689. </dd>
  690. <dt><code>-mccs</code></dt>
  691. <dd><p>Turns on CodeComposer Studio assembly syntax compatibility mode.
  692. </p>
  693. <a name="index-_002dmwarn_002dsyms-command_002dline-option_002c-ARM"></a>
  694. </dd>
  695. <dt><code>-mwarn-syms</code></dt>
  696. <dt><code>-mno-warn-syms</code></dt>
  697. <dd><p>Enable or disable warnings about symbols that match the names of ARM
  698. instructions. The default is to warn.
  699. </p>
  700. </dd>
  701. </dl>
  702. <hr>
  703. <div class="header">
  704. <p>
  705. Next: <a href="ARM-Syntax.html#ARM-Syntax" accesskey="n" rel="next">ARM Syntax</a>, Up: <a href="ARM_002dDependent.html#ARM_002dDependent" accesskey="u" rel="up">ARM-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>
  706. </div>
  707. </body>
  708. </html>