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
5Copyright (C) 1991-2021 Free Software Foundation, Inc.
6
7Permission is granted to copy, distribute and/or modify this document
8under the terms of the GNU Free Documentation License, Version 1.3
9or any later version published by the Free Software Foundation;
10with no Invariant Sections, with no Front-Cover Texts, and with no
11Back-Cover Texts.  A copy of the license is included in the
12section entitled "GNU Free Documentation License".
13 -->
14<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
15<head>
16<title>Using as: AArch64 Options</title>
17
18<meta name="description" content="Using as: AArch64 Options">
19<meta name="keywords" content="Using as: AArch64 Options">
20<meta name="resource-type" content="document">
21<meta name="distribution" content="global">
22<meta name="Generator" content="makeinfo">
23<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
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="AArch64_002dDependent.html#AArch64_002dDependent" rel="up" title="AArch64-Dependent">
28<link href="AArch64-Extensions.html#AArch64-Extensions" rel="next" title="AArch64 Extensions">
29<link href="AArch64_002dDependent.html#AArch64_002dDependent" rel="previous" title="AArch64-Dependent">
30<style type="text/css">
31<!--
32a.summary-letter {text-decoration: none}
33blockquote.smallquotation {font-size: smaller}
34div.display {margin-left: 3.2em}
35div.example {margin-left: 3.2em}
36div.indentedblock {margin-left: 3.2em}
37div.lisp {margin-left: 3.2em}
38div.smalldisplay {margin-left: 3.2em}
39div.smallexample {margin-left: 3.2em}
40div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
41div.smalllisp {margin-left: 3.2em}
42kbd {font-style:oblique}
43pre.display {font-family: inherit}
44pre.format {font-family: inherit}
45pre.menu-comment {font-family: serif}
46pre.menu-preformatted {font-family: serif}
47pre.smalldisplay {font-family: inherit; font-size: smaller}
48pre.smallexample {font-size: smaller}
49pre.smallformat {font-family: inherit; font-size: smaller}
50pre.smalllisp {font-size: smaller}
51span.nocodebreak {white-space:nowrap}
52span.nolinebreak {white-space:nowrap}
53span.roman {font-family:serif; font-weight:normal}
54span.sansserif {font-family:sans-serif; font-weight:normal}
55ul.no-bullet {list-style: none}
56-->
57</style>
58
59
60</head>
61
62<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
63<a name="AArch64-Options"></a>
64<div class="header">
65<p>
66Next: <a href="AArch64-Extensions.html#AArch64-Extensions" accesskey="n" rel="next">AArch64 Extensions</a>, Up: <a href="AArch64_002dDependent.html#AArch64_002dDependent" accesskey="u" rel="up">AArch64-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>
67</div>
68<hr>
69<a name="Options"></a>
70<h4 class="subsection">9.1.1 Options</h4>
71<a name="index-AArch64-options-_0028none_0029"></a>
72<a name="index-options-for-AArch64-_0028none_0029"></a>
73
74<dl compact="compact">
75<dd>
76<a name="index-_002dEB-command_002dline-option_002c-AArch64"></a>
77</dd>
78<dt><code>-EB</code></dt>
79<dd><p>This option specifies that the output generated by the assembler should
80be marked as being encoded for a big-endian processor.
81</p>
82<a name="index-_002dEL-command_002dline-option_002c-AArch64"></a>
83</dd>
84<dt><code>-EL</code></dt>
85<dd><p>This option specifies that the output generated by the assembler should
86be marked as being encoded for a little-endian processor.
87</p>
88<a name="index-_002dmabi_003d-command_002dline-option_002c-AArch64"></a>
89</dd>
90<dt><code>-mabi=<var>abi</var></code></dt>
91<dd><p>Specify which ABI the source code uses.  The recognized arguments
92are: <code>ilp32</code> and <code>lp64</code>, which decides the generated object
93file in ELF32 and ELF64 format respectively.  The default is <code>lp64</code>.
94</p>
95<a name="index-_002dmcpu_003d-command_002dline-option_002c-AArch64"></a>
96</dd>
97<dt><code>-mcpu=<var>processor</var>[+<var>extension</var>&hellip;]</code></dt>
98<dd><p>This option specifies the target processor.  The assembler will issue an error
99message if an attempt is made to assemble an instruction which will not execute
100on the target processor.  The following processor names are recognized:
101<code>cortex-a34</code>,
102<code>cortex-a35</code>,
103<code>cortex-a53</code>,
104<code>cortex-a55</code>,
105<code>cortex-a57</code>,
106<code>cortex-a65</code>,
107<code>cortex-a65ae</code>,
108<code>cortex-a72</code>,
109<code>cortex-a73</code>,
110<code>cortex-a75</code>,
111<code>cortex-a76</code>,
112<code>cortex-a76ae</code>,
113<code>cortex-a77</code>,
114<code>cortex-a78</code>,
115<code>cortex-a78ae</code>,
116<code>cortex-a78c</code>,
117<code>ares</code>,
118<code>exynos-m1</code>,
119<code>falkor</code>,
120<code>neoverse-n1</code>,
121<code>neoverse-n2</code>,
122<code>neoverse-e1</code>,
123<code>neoverse-v1</code>,
124<code>qdf24xx</code>,
125<code>saphira</code>,
126<code>thunderx</code>,
127<code>vulcan</code>,
128<code>xgene1</code>
129<code>xgene2</code>,
130<code>cortex-r82</code>,
131and
132<code>cortex-x1</code>.
133The special name <code>all</code> may be used to allow the assembler to accept
134instructions valid for any supported processor, including all optional
135extensions.
136</p>
137<p>In addition to the basic instruction set, the assembler can be told to
138accept, or restrict, various extension mnemonics that extend the
139processor.  See <a href="AArch64-Extensions.html#AArch64-Extensions">AArch64 Extensions</a>.
140</p>
141<p>If some implementations of a particular processor can have an
142extension, then then those extensions are automatically enabled.
143Consequently, you will not normally have to specify any additional
144extensions.
145</p>
146<a name="index-_002dmarch_003d-command_002dline-option_002c-AArch64"></a>
147</dd>
148<dt><code>-march=<var>architecture</var>[+<var>extension</var>&hellip;]</code></dt>
149<dd><p>This option specifies the target architecture.  The assembler will
150issue an error message if an attempt is made to assemble an
151instruction which will not execute on the target architecture.  The
152following architecture names are recognized: <code>armv8-a</code>,
153<code>armv8.1-a</code>, <code>armv8.2-a</code>, <code>armv8.3-a</code>, <code>armv8.4-a</code>
154<code>armv8.5-a</code>, <code>armv8.6-a</code>, <code>armv8.7-a</code>, and <code>armv8-r</code>.
155</p>
156<p>If both <samp>-mcpu</samp> and <samp>-march</samp> are specified, the
157assembler will use the setting for <samp>-mcpu</samp>.  If neither are
158specified, the assembler will default to <samp>-mcpu=all</samp>.
159</p>
160<p>The architecture option can be extended with the same instruction set
161extension options as the <samp>-mcpu</samp> option.  Unlike
162<samp>-mcpu</samp>, extensions are not always enabled by default,
163See <a href="AArch64-Extensions.html#AArch64-Extensions">AArch64 Extensions</a>.
164</p>
165<a name="index-_002dmverbose_002derror-command_002dline-option_002c-AArch64"></a>
166</dd>
167<dt><code>-mverbose-error</code></dt>
168<dd><p>This option enables verbose error messages for AArch64 gas.  This option
169is enabled by default.
170</p>
171<a name="index-_002dmno_002dverbose_002derror-command_002dline-option_002c-AArch64"></a>
172</dd>
173<dt><code>-mno-verbose-error</code></dt>
174<dd><p>This option disables verbose error messages in AArch64 gas.
175</p>
176</dd>
177</dl>
178
179<hr>
180<div class="header">
181<p>
182Next: <a href="AArch64-Extensions.html#AArch64-Extensions" accesskey="n" rel="next">AArch64 Extensions</a>, Up: <a href="AArch64_002dDependent.html#AArch64_002dDependent" accesskey="u" rel="up">AArch64-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>
183</div>
184
185
186
187</body>
188</html>
189