Debian Codegraph @

upstream/fedora-44/man1/as.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.47)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "AS 1"
61 .TH AS 1 2026-02-09 binutils-2.46 "GNU Development Tools"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 AS \- the portable GNU assembler.
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 as [\fB\-a\fR[\fBcdghilns\fR][=\fIfile\fR]]
71 [\fB\-\-alternate\fR]
72 [\fB\-\-compress\-debug\-sections\fR] [\fB\-\-nocompress\-debug\-sections\fR]
73 [\fB\-D\fR]
74 [\fB\-\-dump\-config\fR]
75 [\fB\-\-debug\-prefix\-map\fR \fIold\fR=\fInew\fR]
76 [\fB\-\-defsym\fR \fIsym\fR=\fIval\fR]
77 [\fB\-\-elf\-stt\-common=[no|yes]\fR]
78 [\fB\-\-emulation\fR=\fIname\fR]
79 [\fB\-f\fR]
80 [\fB\-g\fR] [\fB\-\-gstabs\fR] [\fB\-\-gstabs+\fR]
81 [\fB\-\-gdwarf\-<N>\fR] [\fB\-\-gdwarf\-sections\fR]
82 [\fB\-\-gdwarf\-cie\-version\fR=\fIVERSION\fR]
83 [\fB\-\-generate\-missing\-build\-notes=[no|yes]\fR]
84 [\fB\-\-gsframe\fR] [\fB\-\-gsframe=[no|yes]\fR]
85 [\fB\-\-gsframe\-3\fR]
86 [\fB\-\-hash\-size\fR=\fIN\fR]
87 [\fB\-\-help\fR] [\fB\-\-target\-help\fR]
88 [\fB\-\-info\fR] [\fB\-\-no\-info\fR]
89 [\fB\-I\fR \fIdir\fR]
90 [\fB\-J\fR]
91 [\fB\-K\fR]
92 [\fB\-\-keep\-locals\fR]
93 [\fB\-L\fR]
94 [\fB\-\-listing\-lhs\-width\fR=\fINUM\fR]
95 [\fB\-\-listing\-lhs\-width2\fR=\fINUM\fR]
96 [\fB\-\-listing\-rhs\-width\fR=\fINUM\fR]
97 [\fB\-\-listing\-cont\-lines\fR=\fINUM\fR]
98 [\fB\-\-multibyte\-handling=[allow|warn|warn\-sym\-only]\fR]
99 [\fB\-\-no\-pad\-sections\fR]
100 [\fB\-o\fR \fIobjfile\fR] [\fB\-R\fR]
101 [\fB\-\-scfi=experimental\fR]
102 [\fB\-\-sectname\-subst\fR]
103 [\fB\-\-size\-check=[error|warning]\fR]
104 [\fB\-\-statistics\fR]
105 [\fB\-v\fR] [\fB\-\-verbose\fR]
106 [\fB\-version\fR] [\fB\-\-version\fR]
107 [\fB\-W\fR] [\fB\-\-no\-warn\fR] [\fB\-\-warn\fR] [\fB\-\-fatal\-warnings\fR]
108 [\fB\-w\fR] [\fB\-x\fR]
109 [\fB\-Z\fR] [\fB@\fR\fIFILE\fR]
110 [\fItarget\-options\fR]
111 [\fB\-\-\fR|\fIfiles\fR ...]
112 .SH TARGET
113 .IX Header "TARGET"
114 \&\fITarget AArch64 options:\fR
115 [\fB\-EB\fR|\fB\-EL\fR]
116 [\fB\-mabi\fR=\fIABI\fR]
117 .PP
118 \&\fITarget Alpha options:\fR
119 [\fB\-m\fR\fIcpu\fR]
120 [\fB\-mdebug\fR | \fB\-no\-mdebug\fR]
121 [\fB\-replace\fR | \fB\-noreplace\fR]
122 [\fB\-relax\fR] [\fB\-g\fR] [\fB\-G\fR\fIsize\fR]
123 [\fB\-F\fR] [\fB\-32addr\fR]
124 .PP
125 \&\fITarget ARC options:\fR
126 [\fB\-mcpu=\fR\fIcpu\fR]
127 [\fB\-mA6\fR|\fB\-mARC600\fR|\fB\-mARC601\fR|\fB\-mA7\fR|\fB\-mARC700\fR|\fB\-mEM\fR|\fB\-mHS\fR]
128 [\fB\-mcode\-density\fR]
129 [\fB\-mrelax\fR]
130 [\fB\-EB\fR|\fB\-EL\fR]
131 .PP
132 \&\fITarget ARM options:\fR
133 [\fB\-mcpu\fR=\fIprocessor\fR[+\fIextension\fR...]]
134 [\fB\-march\fR=\fIarchitecture\fR[+\fIextension\fR...]]
135 [\fB\-mfpu\fR=\fIfloating\-point\-format\fR]
136 [\fB\-mfloat\-abi\fR=\fIabi\fR]
137 [\fB\-meabi\fR=\fIver\fR]
138 [\fB\-mthumb\fR]
139 [\fB\-EB\fR|\fB\-EL\fR]
140 [\fB\-mapcs\-32\fR|\fB\-mapcs\-26\fR|\fB\-mapcs\-float\fR|
141 \fB\-mapcs\-reentrant\fR]
142 [\fB\-mthumb\-interwork\fR] [\fB\-k\fR]
143 .PP
144 \&\fITarget Blackfin options:\fR
145 [\fB\-mcpu\fR=\fIprocessor\fR[\-\fIsirevision\fR]]
146 [\fB\-mfdpic\fR]
147 [\fB\-mno\-fdpic\fR]
148 [\fB\-mnopic\fR]
149 .PP
150 \&\fITarget BPF options:\fR
151 [\fB\-EL\fR] [\fB\-EB\fR]
152 .PP
153 \&\fITarget CRIS options:\fR
154 [\fB\-\-underscore\fR | \fB\-\-no\-underscore\fR]
155 [\fB\-\-pic\fR] [\fB\-N\fR]
156 [\fB\-\-emulation=criself\fR | \fB\-\-emulation=crisaout\fR]
157 [\fB\-\-march=v0_v10\fR | \fB\-\-march=v10\fR | \fB\-\-march=v32\fR | \fB\-\-march=common_v10_v32\fR]
158 .PP
159 \&\fITarget C\-SKY options:\fR
160 [\fB\-march=\fR\fIarch\fR] [\fB\-mcpu=\fR\fIcpu\fR]
161 [\fB\-EL\fR] [\fB\-mlittle\-endian\fR] [\fB\-EB\fR] [\fB\-mbig\-endian\fR]
162 [\fB\-fpic\fR] [\fB\-pic\fR]
163 [\fB\-mljump\fR] [\fB\-mno\-ljump\fR]
164 [\fB\-force2bsr\fR] [\fB\-mforce2bsr\fR] [\fB\-no\-force2bsr\fR] [\fB\-mno\-force2bsr\fR]
165 [\fB\-jsri2bsr\fR] [\fB\-mjsri2bsr\fR] [\fB\-no\-jsri2bsr\fR ] [\fB\-mno\-jsri2bsr\fR]
166 [\fB\-mnolrw\fR ] [\fB\-mno\-lrw\fR]
167 [\fB\-melrw\fR] [\fB\-mno\-elrw\fR]
168 [\fB\-mlaf\fR ] [\fB\-mliterals\-after\-func\fR]
169 [\fB\-mno\-laf\fR] [\fB\-mno\-literals\-after\-func\fR]
170 [\fB\-mlabr\fR] [\fB\-mliterals\-after\-br\fR]
171 [\fB\-mno\-labr\fR] [\fB\-mnoliterals\-after\-br\fR]
172 [\fB\-mistack\fR] [\fB\-mno\-istack\fR]
173 [\fB\-mhard\-float\fR] [\fB\-mmp\fR] [\fB\-mcp\fR] [\fB\-mcache\fR]
174 [\fB\-msecurity\fR] [\fB\-mtrust\fR]
175 [\fB\-mdsp\fR] [\fB\-medsp\fR] [\fB\-mvdsp\fR]
176 .PP
177 \&\fITarget D10V options:\fR
178 [\fB\-O\fR]
179 .PP
180 \&\fITarget D30V options:\fR
181 [\fB\-O\fR|\fB\-n\fR|\fB\-N\fR]
182 .PP
183 \&\fITarget EPIPHANY options:\fR
184 [\fB\-mepiphany\fR|\fB\-mepiphany16\fR]
185 .PP
186 \&\fITarget H8/300 options:\fR
187 [\-h\-tick\-hex]
188 .PP
189 \&\fITarget i386 options:\fR
190 [\fB\-\-32\fR|\fB\-\-x32\fR|\fB\-\-64\fR] [\fB\-n\fR]
191 [\fB\-march\fR=\fICPU\fR[+\fIEXTENSION\fR...]] [\fB\-mtune\fR=\fICPU\fR]
192 .PP
193 \&\fITarget IA\-64 options:\fR
194 [\fB\-mconstant\-gp\fR|\fB\-mauto\-pic\fR]
195 [\fB\-milp32\fR|\fB\-milp64\fR|\fB\-mlp64\fR|\fB\-mp64\fR]
196 [\fB\-mle\fR|\fBmbe\fR]
197 [\fB\-mtune=itanium1\fR|\fB\-mtune=itanium2\fR]
198 [\fB\-munwind\-check=warning\fR|\fB\-munwind\-check=error\fR]
199 [\fB\-mhint.b=ok\fR|\fB\-mhint.b=warning\fR|\fB\-mhint.b=error\fR]
200 [\fB\-x\fR|\fB\-xexplicit\fR] [\fB\-xauto\fR] [\fB\-xdebug\fR]
201 .PP
202 \&\fITarget IP2K options:\fR
203 [\fB\-mip2022\fR|\fB\-mip2022ext\fR]
204 .PP
205 \&\fITarget M32C options:\fR
206 [\fB\-m32c\fR|\fB\-m16c\fR] [\-relax] [\-h\-tick\-hex]
207 .PP
208 \&\fITarget M32R options:\fR
209 [\fB\-\-m32rx\fR|\fB\-\-[no\-]warn\-explicit\-parallel\-conflicts\fR|
210 \fB\-\-W[n]p\fR]
211 .PP
212 \&\fITarget M680X0 options:\fR
213 [\fB\-l\fR] [\fB\-m68000\fR|\fB\-m68010\fR|\fB\-m68020\fR|...]
214 .PP
215 \&\fITarget M68HC11 options:\fR
216 [\fB\-m68hc11\fR|\fB\-m68hc12\fR|\fB\-m68hcs12\fR|\fB\-mm9s12x\fR|\fB\-mm9s12xg\fR]
217 [\fB\-mshort\fR|\fB\-mlong\fR]
218 [\fB\-mshort\-double\fR|\fB\-mlong\-double\fR]
219 [\fB\-\-force\-long\-branches\fR] [\fB\-\-short\-branches\fR]
220 [\fB\-\-strict\-direct\-mode\fR] [\fB\-\-print\-insn\-syntax\fR]
221 [\fB\-\-print\-opcodes\fR] [\fB\-\-generate\-example\fR]
222 .PP
223 \&\fITarget MCORE options:\fR
224 [\fB\-jsri2bsr\fR] [\fB\-sifilter\fR] [\fB\-relax\fR]
225 [\fB\-mcpu=[210|340]\fR]
226 .PP
227 \&\fITarget Meta options:\fR
228 [\fB\-mcpu=\fR\fIcpu\fR] [\fB\-mfpu=\fR\fIcpu\fR] [\fB\-mdsp=\fR\fIcpu\fR]
229 \&\fITarget MICROBLAZE options:\fR
230 [\fB\-mlittle\-endian\fR] [\fB\-mbig\-endian\fR]
231 .PP
232 \&\fITarget MIPS options:\fR
233 [\fB\-nocpp\fR] [\fB\-EL\fR] [\fB\-EB\fR] [\fB\-O\fR[\fIoptimization level\fR]]
234 [\fB\-g\fR[\fIdebug level\fR]] [\fB\-G\fR \fInum\fR] [\fB\-KPIC\fR] [\fB\-call_shared\fR]
235 [\fB\-non_shared\fR] [\fB\-xgot\fR [\fB\-mvxworks\-pic\fR]
236 [\fB\-mabi\fR=\fIABI\fR] [\fB\-32\fR] [\fB\-n32\fR] [\fB\-64\fR] [\fB\-mfp32\fR] [\fB\-mgp32\fR]
237 [\fB\-mfp64\fR] [\fB\-mgp64\fR] [\fB\-mfpxx\fR]
238 [\fB\-modd\-spreg\fR] [\fB\-mno\-odd\-spreg\fR]
239 [\fB\-march\fR=\fICPU\fR] [\fB\-mtune\fR=\fICPU\fR] [\fB\-mips1\fR] [\fB\-mips2\fR]
240 [\fB\-mips3\fR] [\fB\-mips4\fR] [\fB\-mips5\fR] [\fB\-mips32\fR] [\fB\-mips32r2\fR]
241 [\fB\-mips32r3\fR] [\fB\-mips32r5\fR] [\fB\-mips32r6\fR] [\fB\-mips64\fR] [\fB\-mips64r2\fR]
242 [\fB\-mips64r3\fR] [\fB\-mips64r5\fR] [\fB\-mips64r6\fR]
243 [\fB\-construct\-floats\fR] [\fB\-no\-construct\-floats\fR]
244 [\fB\-mignore\-branch\-isa\fR] [\fB\-mno\-ignore\-branch\-isa\fR]
245 [\fB\-mnan=\fR\fIencoding\fR]
246 [\fB\-trap\fR] [\fB\-no\-break\fR] [\fB\-break\fR] [\fB\-no\-trap\fR]
247 [\fB\-mips16\fR] [\fB\-no\-mips16\fR]
248 [\fB\-mmips16e2\fR] [\fB\-mno\-mips16e2\fR]
249 [\fB\-mmicromips\fR] [\fB\-mno\-micromips\fR]
250 [\fB\-msmartmips\fR] [\fB\-mno\-smartmips\fR]
251 [\fB\-mips3d\fR] [\fB\-no\-mips3d\fR]
252 [\fB\-mdmx\fR] [\fB\-no\-mdmx\fR]
253 [\fB\-mdsp\fR] [\fB\-mno\-dsp\fR]
254 [\fB\-mdspr2\fR] [\fB\-mno\-dspr2\fR]
255 [\fB\-mdspr3\fR] [\fB\-mno\-dspr3\fR]
256 [\fB\-mmsa\fR] [\fB\-mno\-msa\fR]
257 [\fB\-mxpa\fR] [\fB\-mno\-xpa\fR]
258 [\fB\-mmt\fR] [\fB\-mno\-mt\fR]
259 [\fB\-mmcu\fR] [\fB\-mno\-mcu\fR]
260 [\fB\-mcrc\fR] [\fB\-mno\-crc\fR]
261 [\fB\-mginv\fR] [\fB\-mno\-ginv\fR]
262 [\fB\-mloongson\-mmi\fR] [\fB\-mno\-loongson\-mmi\fR]
263 [\fB\-mloongson\-cam\fR] [\fB\-mno\-loongson\-cam\fR]
264 [\fB\-mloongson\-ext\fR] [\fB\-mno\-loongson\-ext\fR]
265 [\fB\-mloongson\-ext2\fR] [\fB\-mno\-loongson\-ext2\fR]
266 [\fB\-minsn32\fR] [\fB\-mno\-insn32\fR]
267 [\fB\-mfix7000\fR] [\fB\-mno\-fix7000\fR]
268 [\fB\-mfix\-rm7000\fR] [\fB\-mno\-fix\-rm7000\fR]
269 [\fB\-mfix\-vr4120\fR] [\fB\-mno\-fix\-vr4120\fR]
270 [\fB\-mfix\-vr4130\fR] [\fB\-mno\-fix\-vr4130\fR]
271 [\fB\-mfix\-r5900\fR] [\fB\-mno\-fix\-r5900\fR]
272 [\fB\-mdebug\fR] [\fB\-no\-mdebug\fR]
273 [\fB\-mpdr\fR] [\fB\-mno\-pdr\fR]
274 .PP
275 \&\fITarget MMIX options:\fR
276 [\fB\-\-fixed\-special\-register\-names\fR] [\fB\-\-globalize\-symbols\fR]
277 [\fB\-\-gnu\-syntax\fR] [\fB\-\-relax\fR] [\fB\-\-no\-predefined\-symbols\fR]
278 [\fB\-\-no\-expand\fR] [\fB\-\-no\-merge\-gregs\fR] [\fB\-x\fR]
279 [\fB\-\-linker\-allocated\-gregs\fR]
280 .PP
281 \&\fITarget NDS32 options:\fR
282 [\fB\-EL\fR] [\fB\-EB\fR] [\fB\-O\fR] [\fB\-Os\fR] [\fB\-mcpu=\fR\fIcpu\fR]
283 [\fB\-misa=\fR\fIisa\fR] [\fB\-mabi=\fR\fIabi\fR] [\fB\-mall\-ext\fR]
284 [\fB\-m[no\-]16\-bit\fR] [\fB\-m[no\-]perf\-ext\fR] [\fB\-m[no\-]perf2\-ext\fR]
285 [\fB\-m[no\-]string\-ext\fR] [\fB\-m[no\-]dsp\-ext\fR] [\fB\-m[no\-]mac\fR] [\fB\-m[no\-]div\fR]
286 [\fB\-m[no\-]audio\-isa\-ext\fR] [\fB\-m[no\-]fpu\-sp\-ext\fR] [\fB\-m[no\-]fpu\-dp\-ext\fR]
287 [\fB\-m[no\-]fpu\-fma\fR] [\fB\-mfpu\-freg=\fR\fIFREG\fR] [\fB\-mreduced\-regs\fR]
288 [\fB\-mfull\-regs\fR] [\fB\-m[no\-]dx\-regs\fR] [\fB\-mpic\fR] [\fB\-mno\-relax\fR]
289 [\fB\-mb2bb\fR]
290 .PP
291 \&\fITarget PDP11 options:\fR
292 [\fB\-mpic\fR|\fB\-mno\-pic\fR] [\fB\-mall\fR] [\fB\-mno\-extensions\fR]
293 [\fB\-m\fR\fIextension\fR|\fB\-mno\-\fR\fIextension\fR]
294 [\fB\-m\fR\fIcpu\fR] [\fB\-m\fR\fImachine\fR]
295 .PP
296 \&\fITarget picoJava options:\fR
297 [\fB\-mb\fR|\fB\-me\fR]
298 .PP
299 \&\fITarget PowerPC options:\fR
300 [\fB\-a32\fR|\fB\-a64\fR]
301 [\fB\-mpwrx\fR|\fB\-mpwr2\fR|\fB\-mpwr\fR|\fB\-m601\fR|\fB\-mppc\fR|\fB\-mppc32\fR|\fB\-m603\fR|\fB\-m604\fR|\fB\-m403\fR|\fB\-m405\fR|
302 \fB\-m440\fR|\fB\-m464\fR|\fB\-m476\fR|\fB\-m7400\fR|\fB\-m7410\fR|\fB\-m7450\fR|\fB\-m7455\fR|\fB\-m750cl\fR|\fB\-mgekko\fR|
303 \fB\-mbroadway\fR|\fB\-mppc64\fR|\fB\-m620\fR|\fB\-me500\fR|\fB\-e500x2\fR|\fB\-me500mc\fR|\fB\-me500mc64\fR|\fB\-me5500\fR|
304 \fB\-me6500\fR|\fB\-mppc64bridge\fR|\fB\-mbooke\fR|\fB\-mpower4\fR|\fB\-mpwr4\fR|\fB\-mpower5\fR|\fB\-mpwr5\fR|\fB\-mpwr5x\fR|
305 \fB\-mpower6\fR|\fB\-mpwr6\fR|\fB\-mpower7\fR|\fB\-mpwr7\fR|\fB\-mpower8\fR|\fB\-mpwr8\fR|\fB\-mpower9\fR|\fB\-mpwr9\fR\fB\-ma2\fR|
306 \fB\-mcell\fR|\fB\-mspe\fR|\fB\-mspe2\fR|\fB\-mtitan\fR|\fB\-me300\fR|\fB\-mcom\fR]
307 [\fB\-many\fR] [\fB\-maltivec\fR|\fB\-mvsx\fR|\fB\-mhtm\fR|\fB\-mvle\fR]
308 [\fB\-mregnames\fR|\fB\-mno\-regnames\fR]
309 [\fB\-mrelocatable\fR|\fB\-mrelocatable\-lib\fR|\fB\-K PIC\fR] [\fB\-memb\fR]
310 [\fB\-mlittle\fR|\fB\-mlittle\-endian\fR|\fB\-le\fR|\fB\-mbig\fR|\fB\-mbig\-endian\fR|\fB\-be\fR]
311 [\fB\-nops=\fR\fIcount\fR]
312 .PP
313 \&\fITarget PRU options:\fR
314 [\fB\-link\-relax\fR]
315 [\fB\-mnolink\-relax\fR]
316 [\fB\-mno\-warn\-regname\-label\fR]
317 .PP
318 \&\fITarget RISC\-V options:\fR
319 [\fB\-fpic\fR|\fB\-fPIC\fR|\fB\-fno\-pic\fR]
320 [\fB\-march\fR=\fIISA\fR|\fIProfiles\fR|\fIProfiles_ISA\fR]
321 [\fB\-mabi\fR=\fIABI\fR]
322 [\fB\-mlittle\-endian\fR|\fB\-mbig\-endian\fR]
323 .PP
324 \&\fITarget RL78 options:\fR
325 [\fB\-mg10\fR]
326 [\fB\-m32bit\-doubles\fR|\fB\-m64bit\-doubles\fR]
327 .PP
328 \&\fITarget RX options:\fR
329 [\fB\-mlittle\-endian\fR|\fB\-mbig\-endian\fR]
330 [\fB\-m32bit\-doubles\fR|\fB\-m64bit\-doubles\fR]
331 [\fB\-muse\-conventional\-section\-names\fR]
332 [\fB\-msmall\-data\-limit\fR]
333 [\fB\-mpid\fR]
334 [\fB\-mrelax\fR]
335 [\fB\-mint\-register=\fR\fInumber\fR]
336 [\fB\-mgcc\-abi\fR|\fB\-mrx\-abi\fR]
337 .PP
338 \&\fITarget s390 options:\fR
339 [\fB\-m31\fR|\fB\-m64\fR] [\fB\-mesa\fR|\fB\-mzarch\fR] [\fB\-march\fR=\fICPU\fR]
340 [\fB\-mregnames\fR|\fB\-mno\-regnames\fR]
341 [\fB\-mwarn\-areg\-zero\fR]
342 [\fB\-mwarn\-regtype\-mismatch=strict\fR
343 \fB\-mwarn\-regtype\-mismatch=relaxed\fR
344 \fB\-mwarn\-regtype\-mismatch=no\fR
345 \fB\-mno\-warn\-regtype\-mismatch\fR]
346 .PP
347 \&\fITarget SCORE options:\fR
348 [\fB\-EB\fR][\fB\-EL\fR][\fB\-FIXDD\fR][\fB\-NWARN\fR]
349 [\fB\-SCORE5\fR][\fB\-SCORE5U\fR][\fB\-SCORE7\fR][\fB\-SCORE3\fR]
350 [\fB\-march=score7\fR][\fB\-march=score3\fR]
351 [\fB\-USE_R1\fR][\fB\-KPIC\fR][\fB\-O0\fR][\fB\-G\fR \fInum\fR][\fB\-V\fR]
352 .PP
353 \&\fITarget SPARC options:\fR
354 [\fB\-Av6\fR|\fB\-Av7\fR|\fB\-Av8\fR|\fB\-Aleon\fR|\fB\-Asparclet\fR|\fB\-Asparclite\fR
355 \fB\-Av8plus\fR|\fB\-Av8plusa\fR|\fB\-Av8plusb\fR|\fB\-Av8plusc\fR|\fB\-Av8plusd\fR
356 \fB\-Av8plusv\fR|\fB\-Av8plusm\fR|\fB\-Av9\fR|\fB\-Av9a\fR|\fB\-Av9b\fR|\fB\-Av9c\fR
357 \fB\-Av9d\fR|\fB\-Av9e\fR|\fB\-Av9v\fR|\fB\-Av9m\fR|\fB\-Asparc\fR|\fB\-Asparcvis\fR
358 \fB\-Asparcvis2\fR|\fB\-Asparcfmaf\fR|\fB\-Asparcima\fR|\fB\-Asparcvis3\fR
359 \fB\-Asparcvisr\fR|\fB\-Asparc5\fR]
360 [\fB\-xarch=v8plus\fR|\fB\-xarch=v8plusa\fR]|\fB\-xarch=v8plusb\fR|\fB\-xarch=v8plusc\fR
361 \fB\-xarch=v8plusd\fR|\fB\-xarch=v8plusv\fR|\fB\-xarch=v8plusm\fR|\fB\-xarch=v9\fR
362 \fB\-xarch=v9a\fR|\fB\-xarch=v9b\fR|\fB\-xarch=v9c\fR|\fB\-xarch=v9d\fR|\fB\-xarch=v9e\fR
363 \fB\-xarch=v9v\fR|\fB\-xarch=v9m\fR|\fB\-xarch=sparc\fR|\fB\-xarch=sparcvis\fR
364 \fB\-xarch=sparcvis2\fR|\fB\-xarch=sparcfmaf\fR|\fB\-xarch=sparcima\fR
365 \fB\-xarch=sparcvis3\fR|\fB\-xarch=sparcvisr\fR|\fB\-xarch=sparc5\fR
366 \fB\-bump\fR]
367 [\fB\-32\fR|\fB\-64\fR]
368 [\fB\-\-enforce\-aligned\-data\fR][\fB\-\-dcti\-couples\-detect\fR]
369 .PP
370 \&\fITarget TIC54X options:\fR
371 [\fB\-mcpu=54[123589]\fR|\fB\-mcpu=54[56]lp\fR] [\fB\-mfar\-mode\fR|\fB\-mf\fR]
372 [\fB\-merrors\-to\-file\fR \fI<filename>\fR|\fB\-me\fR \fI<filename>\fR]
373 .PP
374 \&\fITarget TIC6X options:\fR
375 [\fB\-march=\fR\fIarch\fR] [\fB\-mbig\-endian\fR|\fB\-mlittle\-endian\fR]
376 [\fB\-mdsbt\fR|\fB\-mno\-dsbt\fR] [\fB\-mpid=no\fR|\fB\-mpid=near\fR|\fB\-mpid=far\fR]
377 [\fB\-mpic\fR|\fB\-mno\-pic\fR]
378 .PP
379 \&\fITarget TILE\-Gx options:\fR
380 [\fB\-m32\fR|\fB\-m64\fR][\fB\-EB\fR][\fB\-EL\fR]
381 .PP
382 \&\fITarget Visium options:\fR
383 [\fB\-mtune=\fR\fIarch\fR]
384 .PP
385 \&\fITarget Xtensa options:\fR
386 [\fB\-\-[no\-]text\-section\-literals\fR] [\fB\-\-[no\-]auto\-litpools\fR]
387 [\fB\-\-[no\-]absolute\-literals\fR]
388 [\fB\-\-[no\-]target\-align\fR] [\fB\-\-[no\-]longcalls\fR]
389 [\fB\-\-[no\-]transform\fR]
390 [\fB\-\-rename\-section\fR \fIoldname\fR=\fInewname\fR]
391 [\fB\-\-[no\-]trampolines\fR]
392 [\fB\-\-abi\-windowed\fR|\fB\-\-abi\-call0\fR]
393 .PP
394 \&\fITarget Z80 options:\fR
395 [\fB\-march=\fR\fICPU\fR\fI[\-EXT]\fR\fI[+EXT]\fR]
396 [\fB\-local\-prefix=\fR\fIPREFIX\fR]
397 [\fB\-colonless\fR]
398 [\fB\-sdcc\fR]
399 [\fB\-fp\-s=\fR\fIFORMAT\fR]
400 [\fB\-fp\-d=\fR\fIFORMAT\fR]
401 .SH DESCRIPTION
402 .IX Header "DESCRIPTION"
403 GNU \fBas\fR is really a family of assemblers.
404 If you use (or have used) the GNU assembler on one architecture, you
405 should find a fairly similar environment when you use it on another
406 architecture. Each version has much in common with the others,
407 including object file formats, most assembler directives (often called
408 \&\fIpseudo\-ops\fR) and assembler syntax.
409 .PP
410 \&\fBas\fR is primarily intended to assemble the output of the
411 GNU C compiler \f(CW\*(C`gcc\*(C'\fR for use by the linker
412 \&\f(CW\*(C`ld\*(C'\fR. Nevertheless, we\*(Aqve tried to make \fBas\fR
413 assemble correctly everything that other assemblers for the same
414 machine would assemble.
415 Any exceptions are documented explicitly.
416 This doesn\*(Aqt mean \fBas\fR always uses the same syntax as another
417 assembler for the same architecture; for example, we know of several
418 incompatible versions of 680x0 assembly language syntax.
419 .PP
420 Each time you run \fBas\fR it assembles exactly one source
421 program. The source program is made up of one or more files.
422 (The standard input is also a file.)
423 .PP
424 You give \fBas\fR a command line that has zero or more input file
425 names. The input files are read (from left file name to right). A
426 command\-line argument (in any position) that has no special meaning
427 is taken to be an input file name.
428 .PP
429 If you give \fBas\fR no file names it attempts to read one input file
430 from the \fBas\fR standard input, which is normally your terminal. You
431 may have to type \fBctl\-D\fR to tell \fBas\fR there is no more program
432 to assemble.
433 .PP
434 Use \fB\-\-\fR if you need to explicitly name the standard input file
435 in your command line.
436 .PP
437 If the source is empty, \fBas\fR produces a small, empty object
438 file.
439 .PP
440 \&\fBas\fR may write warnings and error messages to the standard error
441 file (usually your terminal). This should not happen when a compiler
442 runs \fBas\fR automatically. Warnings report an assumption made so
443 that \fBas\fR could keep assembling a flawed program; errors report a
444 grave problem that stops the assembly.
445 .PP
446 If you are invoking \fBas\fR via the GNU C compiler,
447 you can use the \fB\-Wa\fR option to pass arguments through to the assembler.
448 The assembler arguments must be separated from each other (and the \fB\-Wa\fR)
449 by commas. For example:
450 .PP
451 .Vb 1
452 \& gcc \-c \-g \-O \-Wa,\-alh,\-L file.c
453 .Ve
454 .PP
455 This passes two options to the assembler: \fB\-alh\fR (emit a listing to
456 standard output with high\-level and assembly source) and \fB\-L\fR (retain
457 local symbols in the symbol table).
458 .PP
459 Usually you do not need to use this \fB\-Wa\fR mechanism, since many compiler
460 command\-line options are automatically passed to the assembler by the compiler.
461 (You can call the GNU compiler driver with the \fB\-v\fR option to see
462 precisely what options it passes to each compilation pass, including the
463 assembler.)
464 .SH OPTIONS
465 .IX Header "OPTIONS"
466 .IP \fB@\fR\fIfile\fR 4
467 .IX Item "@file"
468 Read command\-line options from \fIfile\fR. The options read are
469 inserted in place of the original @\fIfile\fR option. If \fIfile\fR
470 does not exist, or cannot be read, then the option will be treated
471 literally, and not removed.
472 .Sp
473 Options in \fIfile\fR are separated by whitespace. A whitespace
474 character may be included in an option by surrounding the entire
475 option in either single or double quotes. Any character (including a
476 backslash) may be included by prefixing the character to be included
477 with a backslash. The \fIfile\fR may itself contain additional
478 @\fIfile\fR options; any such options will be processed recursively.
479 .IP \fB\-a[cdghilmns]\fR 4
480 .IX Item "-a[cdghilmns]"
481 Turn on listings, in any of a variety of ways:
482 .RS 4
483 .IP \fB\-ac\fR 4
484 .IX Item "-ac"
485 omit false conditionals
486 .IP \fB\-ad\fR 4
487 .IX Item "-ad"
488 omit debugging directives
489 .IP \fB\-ag\fR 4
490 .IX Item "-ag"
491 include general information, like as version and options passed
492 .IP \fB\-ah\fR 4
493 .IX Item "-ah"
494 include high\-level source
495 .IP \fB\-al\fR 4
496 .IX Item "-al"
497 include assembly
498 .IP \fB\-ali\fR 4
499 .IX Item "-ali"
500 include assembly with ginsn
501 .IP \fB\-am\fR 4
502 .IX Item "-am"
503 include macro expansions
504 .IP \fB\-an\fR 4
505 .IX Item "-an"
506 omit forms processing
507 .IP \fB\-as\fR 4
508 .IX Item "-as"
509 include symbols
510 .IP \fB=file\fR 4
511 .IX Item "=file"
512 set the name of the listing file
513 .RE
514 .RS 4
515 .Sp
516 You may combine these options; for example, use \fB\-aln\fR for assembly
517 listing without forms processing. The \fB=file\fR option, if used, must be
518 the last one. By itself, \fB\-a\fR defaults to \fB\-ahls\fR.
519 .RE
520 .IP \fB\-\-alternate\fR 4
521 .IX Item "--alternate"
522 Begin in alternate macro mode.
523 .IP \fB\-\-compress\-debug\-sections\fR 4
524 .IX Item "--compress-debug-sections"
525 Compress DWARF debug sections using zlib with SHF_COMPRESSED from the
526 ELF ABI. The resulting object file may not be compatible with older
527 linkers and object file utilities. Note if compression would make a
528 given section \fIlarger\fR then it is not compressed.
529 .IP \fB\-\-compress\-debug\-sections=none\fR 4
530 .IX Item "--compress-debug-sections=none"
531 .PD 0
532 .IP \fB\-\-compress\-debug\-sections=zlib\fR 4
533 .IX Item "--compress-debug-sections=zlib"
534 .IP \fB\-\-compress\-debug\-sections=zlib\-gnu\fR 4
535 .IX Item "--compress-debug-sections=zlib-gnu"
536 .IP \fB\-\-compress\-debug\-sections=zlib\-gabi\fR 4
537 .IX Item "--compress-debug-sections=zlib-gabi"
538 .IP \fB\-\-compress\-debug\-sections=zstd\fR 4
539 .IX Item "--compress-debug-sections=zstd"
540 .PD
541 These options control how DWARF debug sections are compressed.
542 \&\fB\-\-compress\-debug\-sections=none\fR is equivalent to
543 \&\fB\-\-nocompress\-debug\-sections\fR.
544 \&\fB\-\-compress\-debug\-sections=zlib\fR and
545 \&\fB\-\-compress\-debug\-sections=zlib\-gabi\fR are equivalent to
546 \&\fB\-\-compress\-debug\-sections\fR.
547 \&\fB\-\-compress\-debug\-sections=zlib\-gnu\fR compresses DWARF debug sections
548 using the obsoleted zlib\-gnu format. The debug sections are renamed to begin
549 with \fB.zdebug\fR.
550 \&\fB\-\-compress\-debug\-sections=zstd\fR compresses DWARF debug
551 sections using zstd. Note \- if compression would actually make a section
552 \&\fIlarger\fR, then it is not compressed nor renamed.
553 .IP \fB\-\-nocompress\-debug\-sections\fR 4
554 .IX Item "--nocompress-debug-sections"
555 Do not compress DWARF debug sections. This is usually the default for all
556 targets except the x86/x86_64, but a configure time option can be used to
557 override this.
558 .IP \fB\-D\fR 4
559 .IX Item "-D"
560 Enable debugging in target specific backends, if supported. Otherwise ignored.
561 Even if ignored, this option is accepted for script compatibility with calls to
562 other assemblers.
563 .IP "\fB\-\-debug\-prefix\-map\fR \fIold\fR\fB=\fR\fInew\fR" 4
564 .IX Item "--debug-prefix-map old=new"
565 When assembling files in directory \fIold\fR, record debugging
566 information describing them as in \fInew\fR instead.
567 .IP "\fB\-\-defsym\fR \fIsym\fR\fB=\fR\fIvalue\fR" 4
568 .IX Item "--defsym sym=value"
569 Define the symbol \fIsym\fR to be \fIvalue\fR before assembling the input file.
570 \&\fIvalue\fR must be an integer constant. As in C, a leading \fB0x\fR
571 indicates a hexadecimal value, and a leading \fB0\fR indicates an octal
572 value. The value of the symbol can be overridden inside a source file via the
573 use of a \f(CW\*(C`.set\*(C'\fR pseudo\-op.
574 .IP \fB\-\-dump\-config\fR 4
575 .IX Item "--dump-config"
576 Displays how the assembler is configured and then exits.
577 .IP \fB\-\-elf\-stt\-common=no\fR 4
578 .IX Item "--elf-stt-common=no"
579 .PD 0
580 .IP \fB\-\-elf\-stt\-common=yes\fR 4
581 .IX Item "--elf-stt-common=yes"
582 .PD
583 These options control whether the ELF assembler should generate common
584 symbols with the \f(CW\*(C`STT_COMMON\*(C'\fR type. The default can be controlled
585 by a configure option \fB\-\-enable\-elf\-stt\-common\fR.
586 .IP \fB\-\-emit\-local\-absolute\fR 4
587 .IX Item "--emit-local-absolute"
588 Emit even pre\-defined (local) absolute symbols to the outgoing symbol table.
589 Note that this isn\*(Aqt the exact opposite of \fB\-\-strip\-local\-absolute\fR.
590 .IP \fB\-\-emulation=\fR\fIname\fR 4
591 .IX Item "--emulation=name"
592 If the assembler is configured to support multiple different target
593 configurations then this option can be used to select the desired form.
594 .IP \fB\-f\fR 4
595 .IX Item "-f"
596 "fast"\-\-\-skip whitespace and comment preprocessing (assume source is
597 compiler output).
598 .IP \fB\-g\fR 4
599 .IX Item "-g"
600 .PD 0
601 .IP \fB\-\-gen\-debug\fR 4
602 .IX Item "--gen-debug"
603 .PD
604 Generate debugging information for each assembler source line using whichever
605 debug format is preferred by the target. This currently means either STABS,
606 ECOFF or DWARF2. When the debug format is DWARF then a \f(CW\*(C`.debug_info\*(C'\fR and
607 \&\f(CW\*(C`.debug_line\*(C'\fR section is only emitted when the assembly file doesn\*(Aqt
608 generate one itself.
609 .IP \fB\-\-gstabs\fR 4
610 .IX Item "--gstabs"
611 Generate stabs debugging information for each assembler line. This
612 may help debugging assembler code, if the debugger can handle it.
613 .IP \fB\-\-gstabs+\fR 4
614 .IX Item "--gstabs+"
615 Generate stabs debugging information for each assembler line, with GNU
616 extensions that probably only gdb can handle, and that could make other
617 debuggers crash or refuse to read your program. This
618 may help debugging assembler code. Currently the only GNU extension is
619 the location of the current working directory at assembling time.
620 .IP \fB\-\-gdwarf\-2\fR 4
621 .IX Item "--gdwarf-2"
622 Generate DWARF2 debugging information for each assembler line. This
623 may help debugging assembler code, if the debugger can handle it. Note\-\-\-this
624 option is only supported by some targets, not all of them.
625 .IP \fB\-\-gdwarf\-3\fR 4
626 .IX Item "--gdwarf-3"
627 This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
628 allows for the possibility of the generation of extra debug information as per
629 version 3 of the DWARF specification. Note \- enabling this option does not
630 guarantee the generation of any extra information, the choice to do so is on a
631 per target basis.
632 .IP \fB\-\-gdwarf\-4\fR 4
633 .IX Item "--gdwarf-4"
634 This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
635 allows for the possibility of the generation of extra debug information as per
636 version 4 of the DWARF specification. Note \- enabling this option does not
637 guarantee the generation of any extra information, the choice to do so is on a
638 per target basis.
639 .IP \fB\-\-gdwarf\-5\fR 4
640 .IX Item "--gdwarf-5"
641 This option is the same as the \fB\-\-gdwarf\-2\fR option, except that it
642 allows for the possibility of the generation of extra debug information as per
643 version 5 of the DWARF specification. Note \- enabling this option does not
644 guarantee the generation of any extra information, the choice to do so is on a
645 per target basis.
646 .IP \fB\-\-gdwarf\-sections\fR 4
647 .IX Item "--gdwarf-sections"
648 Instead of creating a .debug_line section, create a series of
649 \&.debug_line.\fIfoo\fR sections where \fIfoo\fR is the name of the
650 corresponding code section. For example a code section called \fI.text.func\fR
651 will have its dwarf line number information placed into a section called
652 \&\fI.debug_line.text.func\fR. If the code section is just called \fI.text\fR
653 then debug line section will still be called just \fI.debug_line\fR without any
654 suffix.
655 .IP \fB\-\-gdwarf\-cie\-version=\fR\fIversion\fR 4
656 .IX Item "--gdwarf-cie-version=version"
657 Control which version of DWARF Common Information Entries (CIEs) are produced.
658 When this flag is not specified the default is version 1, though some targets
659 can modify this default. Other possible values for \fIversion\fR are 3 or 4.
660 .IP \fB\-\-generate\-missing\-build\-notes=yes\fR 4
661 .IX Item "--generate-missing-build-notes=yes"
662 .PD 0
663 .IP \fB\-\-generate\-missing\-build\-notes=no\fR 4
664 .IX Item "--generate-missing-build-notes=no"
665 .PD
666 These options control whether the ELF assembler should generate GNU Build
667 attribute notes if none are present in the input sources.
668 The default can be controlled by the \fB\-\-enable\-generate\-build\-notes\fR
669 configure option.
670 .IP \fB\-\-gsframe\fR 4
671 .IX Item "--gsframe"
672 .PD 0
673 .IP \fB\-\-gsframe\fR 4
674 .IX Item "--gsframe"
675 .IP \fB\-\-gsframe=no\fR 4
676 .IX Item "--gsframe=no"
677 .IP \fB\-\-gsframe=yes\fR 4
678 .IX Item "--gsframe=yes"
679 .PD
680 Create \fI.sframe\fR section from CFI directives. The explicit
681 \&\fB\-\-gsframe=yes\fR option behaves the same as \fB\-\-gsframe\fR.
682 Generation can be suppressed with \fB\-\-gsframe=no\fR. The default can be
683 controlled by a configure option \fB\-\-enable\-default\-sframe\fR. The current
684 version of the emitted SFrame stack trace data is SFRAME_VERSION_3.
685 .IP \fB\-\-gsframe\-3\fR 4
686 .IX Item "--gsframe-3"
687 Generate SFrame stack trace information as per Version 3 of the specification.
688 .IP "\fB\-\-hash\-size\fR \fIN\fR" 4
689 .IX Item "--hash-size N"
690 Ignored. Supported for command line compatibility with other assemblers.
691 .IP \fB\-\-help\fR 4
692 .IX Item "--help"
693 Print a summary of the command\-line options and exit.
694 .IP \fB\-\-target\-help\fR 4
695 .IX Item "--target-help"
696 Print a summary of all target specific options and exit.
697 .IP \fB\-\-info\fR 4
698 .IX Item "--info"
699 Don\*(Aqt suppress informational messages.
700 .IP \fB\-\-no\-info\fR 4
701 .IX Item "--no-info"
702 Suppress informational messages.
703 .IP "\fB\-I\fR \fIdir\fR" 4
704 .IX Item "-I dir"
705 Add directory \fIdir\fR to the search list for \f(CW\*(C`.include\*(C'\fR directives.
706 .IP \fB\-J\fR 4
707 .IX Item "-J"
708 Don\*(Aqt warn about signed overflow.
709 .IP \fB\-K\fR 4
710 .IX Item "-K"
711 Issue warnings when difference tables altered for long displacements.
712 .IP \fB\-L\fR 4
713 .IX Item "-L"
714 .PD 0
715 .IP \fB\-\-keep\-locals\fR 4
716 .IX Item "--keep-locals"
717 .PD
718 Keep (in the symbol table) local symbols. These symbols start with
719 system\-specific local label prefixes, typically \fB.L\fR for ELF systems
720 or \fBL\fR for traditional a.out systems.
721 .IP \fB\-\-listing\-lhs\-width=\fR\fInumber\fR 4
722 .IX Item "--listing-lhs-width=number"
723 Set the maximum width, in words, of the output data column for an assembler
724 listing to \fInumber\fR.
725 .IP \fB\-\-listing\-lhs\-width2=\fR\fInumber\fR 4
726 .IX Item "--listing-lhs-width2=number"
727 Set the maximum width, in words, of the output data column for continuation
728 lines in an assembler listing to \fInumber\fR.
729 .IP \fB\-\-listing\-rhs\-width=\fR\fInumber\fR 4
730 .IX Item "--listing-rhs-width=number"
731 Set the maximum width of an input source line, as displayed in a listing, to
732 \&\fInumber\fR bytes.
733 .IP \fB\-\-listing\-cont\-lines=\fR\fInumber\fR 4
734 .IX Item "--listing-cont-lines=number"
735 Set the maximum number of lines printed in a listing for a single line of input
736 to \fInumber\fR + 1.
737 .IP \fB\-\-multibyte\-handling=allow\fR 4
738 .IX Item "--multibyte-handling=allow"
739 .PD 0
740 .IP \fB\-\-multibyte\-handling=warn\fR 4
741 .IX Item "--multibyte-handling=warn"
742 .IP \fB\-\-multibyte\-handling=warn\-sym\-only\fR 4
743 .IX Item "--multibyte-handling=warn-sym-only"
744 .IP \fB\-\-multibyte\-handling=warn_sym_only\fR 4
745 .IX Item "--multibyte-handling=warn_sym_only"
746 .PD
747 Controls how the assembler handles multibyte characters in the input. The
748 default (which can be restored by using the \fBallow\fR argument) is to
749 allow such characters without complaint. Using the \fBwarn\fR argument will
750 make the assembler generate a warning message whenever any multibyte character
751 is encountered. Using the \fBwarn\-sym\-only\fR argument will only cause a
752 warning to be generated when a symbol is defined with a name that contains
753 multibyte characters. (References to undefined symbols will not generate a
754 warning).
755 .IP \fB\-\-no\-pad\-sections\fR 4
756 .IX Item "--no-pad-sections"
757 Stop the assembler for padding the ends of output sections to the alignment
758 of that section. The default is to pad the sections, but this can waste space
759 which might be needed on targets which have tight memory constraints.
760 .IP "\fB\-o\fR \fIobjfile\fR" 4
761 .IX Item "-o objfile"
762 Name the object\-file output from \fBas\fR \fIobjfile\fR.
763 .IP \fB\-R\fR 4
764 .IX Item "-R"
765 Fold the data section into the text section.
766 .IP \fB\-\-reduce\-memory\-overheads\fR 4
767 .IX Item "--reduce-memory-overheads"
768 Ignored. Supported for compatibility with tools that pass the same option to
769 both the assembler and the linker.
770 .IP \fB\-\-scfi=experimental\fR 4
771 .IX Item "--scfi=experimental"
772 This option controls whether the assembler should synthesize CFI for
773 hand\-written input. If the input already contains some synthesizable CFI
774 directives, the assembler ignores them and emits a warning. Note that
775 \&\f(CW\*(C`\-\-scfi=experimental\*(C'\fR is not intended to be used for compiler\-generated
776 code, including inline assembly. This experimental support is work in
777 progress. Only System V AMD64 ABI is supported.
778 .Sp
779 Each input function in assembly must begin with the \f(CW\*(C`.type\*(C'\fR directive, and
780 should ideally be closed off using a \f(CW\*(C`.size\*(C'\fR directive. When using SCFI,
781 each \f(CW\*(C`.type\*(C'\fR directive prompts GAS to start a new FDE (a.k.a., Function
782 Descriptor Entry). This implies that with each \f(CW\*(C`.type\*(C'\fR directive, a
783 previous block of instructions, if any, is finalised as a distinct FDE.
784 .IP \fB\-\-sectname\-subst\fR 4
785 .IX Item "--sectname-subst"
786 Honor substitution sequences in section names.
787 .IP \fB\-\-size\-check=error\fR 4
788 .IX Item "--size-check=error"
789 .PD 0
790 .IP \fB\-\-size\-check=warning\fR 4
791 .IX Item "--size-check=warning"
792 .PD
793 Issue an error or warning for invalid ELF .size directive.
794 .IP \fB\-\-statistics\fR 4
795 .IX Item "--statistics"
796 Print the maximum space (in bytes) and total time (in seconds) used by
797 assembly.
798 .IP \fB\-\-strip\-local\-absolute\fR 4
799 .IX Item "--strip-local-absolute"
800 Remove local absolute symbols from the outgoing symbol table.
801 .IP \fB\-v\fR 4
802 .IX Item "-v"
803 .PD 0
804 .IP \fB\-\-verbose\fR 4
805 .IX Item "--verbose"
806 .PD
807 Print the \fBas\fR version.
808 .IP \fB\-\-version\fR 4
809 .IX Item "--version"
810 .PD 0
811 .IP \fB\-version\fR 4
812 .IX Item "-version"
813 .PD
814 Print the \fBas\fR version and exit.
815 .IP \fB\-W\fR 4
816 .IX Item "-W"
817 .PD 0
818 .IP \fB\-\-no\-warn\fR 4
819 .IX Item "--no-warn"
820 .PD
821 Suppress warning messages.
822 .IP \fB\-\-warn\fR 4
823 .IX Item "--warn"
824 Don\*(Aqt suppress warning messages or treat them as errors.
825 .IP \fB\-\-fatal\-warnings\fR 4
826 .IX Item "--fatal-warnings"
827 Treat warnings as errors.
828 .IP \fB\-w\fR 4
829 .IX Item "-w"
830 Ignored.
831 .IP \fB\-x\fR 4
832 .IX Item "-x"
833 Ignored.
834 .IP \fB\-Z\fR 4
835 .IX Item "-Z"
836 Generate an object file even after errors.
837 .IP "\fB\-\- |\fR \fIfiles\fR \fB...\fR" 4
838 .IX Item "-- | files ..."
839 Standard input, or source files to assemble.
840 .PP
841 The following options are available when as is configured for the
842 64\-bit mode of the ARM Architecture (AArch64).
843 .IP \fB\-EB\fR 4
844 .IX Item "-EB"
845 This option specifies that the output generated by the assembler should
846 be marked as being encoded for a big\-endian processor.
847 .IP \fB\-EL\fR 4
848 .IX Item "-EL"
849 This option specifies that the output generated by the assembler should
850 be marked as being encoded for a little\-endian processor.
851 .IP \fB\-mabi=\fR\fIabi\fR 4
852 .IX Item "-mabi=abi"
853 Specify which ABI the source code uses. The recognized arguments
854 are: \f(CW\*(C`ilp32\*(C'\fR and \f(CW\*(C`lp64\*(C'\fR, which decides the generated object
855 file in ELF32 and ELF64 format respectively. The default is \f(CW\*(C`lp64\*(C'\fR.
856 .IP \fB\-mcpu=\fR\fIprocessor\fR\fB[+\fR\fIextension\fR\fB...]\fR 4
857 .IX Item "-mcpu=processor[+extension...]"
858 This option specifies the target processor. The assembler will issue an error
859 message if an attempt is made to assemble an instruction which will not execute
860 on the target processor. The following processor names are recognized:
861 \&\f(CW\*(C`cortex\-a34\*(C'\fR,
862 \&\f(CW\*(C`cortex\-a35\*(C'\fR,
863 \&\f(CW\*(C`cortex\-a53\*(C'\fR,
864 \&\f(CW\*(C`cortex\-a55\*(C'\fR,
865 \&\f(CW\*(C`cortex\-a57\*(C'\fR,
866 \&\f(CW\*(C`cortex\-a65\*(C'\fR,
867 \&\f(CW\*(C`cortex\-a65ae\*(C'\fR,
868 \&\f(CW\*(C`cortex\-a72\*(C'\fR,
869 \&\f(CW\*(C`cortex\-a73\*(C'\fR,
870 \&\f(CW\*(C`cortex\-a75\*(C'\fR,
871 \&\f(CW\*(C`cortex\-a76\*(C'\fR,
872 \&\f(CW\*(C`cortex\-a76ae\*(C'\fR,
873 \&\f(CW\*(C`cortex\-a77\*(C'\fR,
874 \&\f(CW\*(C`cortex\-a78\*(C'\fR,
875 \&\f(CW\*(C`cortex\-a78ae\*(C'\fR,
876 \&\f(CW\*(C`cortex\-a78c\*(C'\fR,
877 \&\f(CW\*(C`cortex\-a510\*(C'\fR,
878 \&\f(CW\*(C`cortex\-a520\*(C'\fR,
879 \&\f(CW\*(C`cortex\-a710\*(C'\fR,
880 \&\f(CW\*(C`cortex\-a720\*(C'\fR,
881 \&\f(CW\*(C`ares\*(C'\fR,
882 \&\f(CW\*(C`exynos\-m1\*(C'\fR,
883 \&\f(CW\*(C`falkor\*(C'\fR,
884 \&\f(CW\*(C`neoverse\-n1\*(C'\fR,
885 \&\f(CW\*(C`neoverse\-n2\*(C'\fR,
886 \&\f(CW\*(C`neoverse\-e1\*(C'\fR,
887 \&\f(CW\*(C`neoverse\-v1\*(C'\fR,
888 \&\f(CW\*(C`qdf24xx\*(C'\fR,
889 \&\f(CW\*(C`saphira\*(C'\fR,
890 \&\f(CW\*(C`thunderx\*(C'\fR,
891 \&\f(CW\*(C`vulcan\*(C'\fR,
892 \&\f(CW\*(C`xgene1\*(C'\fR
893 \&\f(CW\*(C`xgene2\*(C'\fR,
894 \&\f(CW\*(C`cortex\-r82\*(C'\fR,
895 \&\f(CW\*(C`cortex\-x1\*(C'\fR,
896 \&\f(CW\*(C`cortex\-x2\*(C'\fR,
897 \&\f(CW\*(C`cortex\-x3\*(C'\fR,
898 and
899 \&\f(CW\*(C`cortex\-x4\*(C'\fR.
900 The special name \f(CW\*(C`all\*(C'\fR may be used to allow the assembler to accept
901 instructions valid for any supported processor, including all optional
902 extensions.
903 .Sp
904 In addition to the basic instruction set, the assembler can be told to
905 accept, or restrict, various extension mnemonics that extend the
906 processor.
907 .Sp
908 If some implementations of a particular processor can have an
909 extension, then then those extensions are automatically enabled.
910 Consequently, you will not normally have to specify any additional
911 extensions.
912 .IP \fB\-march=\fR\fIarchitecture\fR\fB[+\fR\fIextension\fR\fB...]\fR 4
913 .IX Item "-march=architecture[+extension...]"
914 This option specifies the target architecture. The assembler will
915 issue an error message if an attempt is made to assemble an
916 instruction which will not execute on the target architecture. The
917 following architecture names are recognized: \f(CW\*(C`armv8\-a\*(C'\fR,
918 \&\f(CW\*(C`armv8.1\-a\*(C'\fR, \f(CW\*(C`armv8.2\-a\*(C'\fR, \f(CW\*(C`armv8.3\-a\*(C'\fR, \f(CW\*(C`armv8.4\-a\*(C'\fR
919 \&\f(CW\*(C`armv8.5\-a\*(C'\fR, \f(CW\*(C`armv8.6\-a\*(C'\fR, \f(CW\*(C`armv8.7\-a\*(C'\fR, \f(CW\*(C`armv8.8\-a\*(C'\fR,
920 \&\f(CW\*(C`armv8.9\-a\*(C'\fR, \f(CW\*(C`armv8\-r\*(C'\fR, \f(CW\*(C`armv9\-a\*(C'\fR, \f(CW\*(C`armv9.1\-a\*(C'\fR,
921 \&\f(CW\*(C`armv9.2\-a\*(C'\fR, \f(CW\*(C`armv9.3\-a\*(C'\fR, \f(CW\*(C`armv9.4\-a\*(C'\fR and \f(CW\*(C`armv9.5\-a\*(C'\fR.
922 .Sp
923 If both \fB\-mcpu\fR and \fB\-march\fR are specified, the
924 assembler will use the setting for \fB\-mcpu\fR. If neither are
925 specified, the assembler will default to \fB\-mcpu=all\fR.
926 .Sp
927 The architecture option can be extended with the same instruction set
928 extension options as the \fB\-mcpu\fR option. Unlike
929 \&\fB\-mcpu\fR, extensions are not always enabled by default.
930 .IP \fB\-mbig\-obj\fR 4
931 .IX Item "-mbig-obj"
932 On PE/COFF target this option forces the use of big object file
933 format, which allows more than 32768 sections.
934 .IP \fB\-mverbose\-error\fR 4
935 .IX Item "-mverbose-error"
936 This option enables verbose error messages for AArch64 gas. This option
937 is enabled by default.
938 .IP \fB\-mno\-verbose\-error\fR 4
939 .IX Item "-mno-verbose-error"
940 This option disables verbose error messages in AArch64 gas.
941 .IP \fB\-menable\-sysreg\-checking\fR 4
942 .IX Item "-menable-sysreg-checking"
943 This option enables error messages that are issued if an attempt is made to
944 assemble a system register access which will not execute on the target
945 architecture.
946 .PP
947 The following options are available when as is configured for an Alpha
948 processor.
949 .IP \fB\-m\fR\fIcpu\fR 4
950 .IX Item "-mcpu"
951 This option specifies the target processor. If an attempt is made to
952 assemble an instruction which will not execute on the target processor,
953 the assembler may either expand the instruction as a macro or issue an
954 error message. This option is equivalent to the \f(CW\*(C`.arch\*(C'\fR directive.
955 .Sp
956 The following processor names are recognized:
957 \&\f(CW21064\fR,
958 \&\f(CW\*(C`21064a\*(C'\fR,
959 \&\f(CW21066\fR,
960 \&\f(CW21068\fR,
961 \&\f(CW21164\fR,
962 \&\f(CW\*(C`21164a\*(C'\fR,
963 \&\f(CW\*(C`21164pc\*(C'\fR,
964 \&\f(CW21264\fR,
965 \&\f(CW\*(C`21264a\*(C'\fR,
966 \&\f(CW\*(C`21264b\*(C'\fR,
967 \&\f(CW\*(C`ev4\*(C'\fR,
968 \&\f(CW\*(C`ev5\*(C'\fR,
969 \&\f(CW\*(C`lca45\*(C'\fR,
970 \&\f(CW\*(C`ev5\*(C'\fR,
971 \&\f(CW\*(C`ev56\*(C'\fR,
972 \&\f(CW\*(C`pca56\*(C'\fR,
973 \&\f(CW\*(C`ev6\*(C'\fR,
974 \&\f(CW\*(C`ev67\*(C'\fR,
975 \&\f(CW\*(C`ev68\*(C'\fR.
976 The special name \f(CW\*(C`all\*(C'\fR may be used to allow the assembler to accept
977 instructions valid for any Alpha processor.
978 .Sp
979 In order to support existing practice in OSF/1 with respect to \f(CW\*(C`.arch\*(C'\fR,
980 and existing practice within \fBMILO\fR (the Linux ARC bootloader), the
981 numbered processor names (e.g. 21064) enable the processor\-specific PALcode
982 instructions, while the "electro\-vlasic" names (e.g. \f(CW\*(C`ev4\*(C'\fR) do not.
983 .IP \fB\-mdebug\fR 4
984 .IX Item "-mdebug"
985 .PD 0
986 .IP \fB\-no\-mdebug\fR 4
987 .IX Item "-no-mdebug"
988 .PD
989 Enables or disables the generation of \f(CW\*(C`.mdebug\*(C'\fR encapsulation for
990 stabs directives and procedure descriptors. The default is to automatically
991 enable \f(CW\*(C`.mdebug\*(C'\fR when the first stabs directive is seen.
992 .IP \fB\-relax\fR 4
993 .IX Item "-relax"
994 This option forces all relocations to be put into the object file, instead
995 of saving space and resolving some relocations at assembly time. Note that
996 this option does not propagate all symbol arithmetic into the object file,
997 because not all symbol arithmetic can be represented. However, the option
998 can still be useful in specific applications.
999 .IP \fB\-replace\fR 4
1000 .IX Item "-replace"
1001 .PD 0
1002 .IP \fB\-noreplace\fR 4
1003 .IX Item "-noreplace"
1004 .PD
1005 Enables or disables the optimization of procedure calls, both at assemblage
1006 and at link time. These options are only available for VMS targets and
1007 \&\f(CW\*(C`\-replace\*(C'\fR is the default. See section 1.4.1 of the OpenVMS Linker
1008 Utility Manual.
1009 .IP \fB\-g\fR 4
1010 .IX Item "-g"
1011 This option is used when the compiler generates debug information. When
1012 \&\fBgcc\fR is using \fBmips\-tfile\fR to generate debug
1013 information for ECOFF, local labels must be passed through to the object
1014 file. Otherwise this option has no effect.
1015 .IP \fB\-G\fR\fIsize\fR 4
1016 .IX Item "-Gsize"
1017 A local common symbol larger than \fIsize\fR is placed in \f(CW\*(C`.bss\*(C'\fR,
1018 while smaller symbols are placed in \f(CW\*(C`.sbss\*(C'\fR.
1019 .IP \fB\-F\fR 4
1020 .IX Item "-F"
1021 .PD 0
1022 .IP \fB\-32addr\fR 4
1023 .IX Item "-32addr"
1024 .PD
1025 These options are ignored for backward compatibility.
1026 .PP
1027 The following options are available when as is configured for an ARC
1028 processor.
1029 .IP \fB\-mcpu=\fR\fIcpu\fR 4
1030 .IX Item "-mcpu=cpu"
1031 This option selects the core processor variant.
1032 .IP "\fB\-EB | \-EL\fR" 4
1033 .IX Item "-EB | -EL"
1034 Select either big\-endian (\-EB) or little\-endian (\-EL) output.
1035 .IP \fB\-mcode\-density\fR 4
1036 .IX Item "-mcode-density"
1037 Enable Code Density extension instructions.
1038 .PP
1039 The following options are available when as is configured for the ARM
1040 processor family.
1041 .IP \fB\-mcpu=\fR\fIprocessor\fR\fB[+\fR\fIextension\fR\fB...]\fR 4
1042 .IX Item "-mcpu=processor[+extension...]"
1043 Specify which ARM processor variant is the target.
1044 .IP \fB\-march=\fR\fIarchitecture\fR\fB[+\fR\fIextension\fR\fB...]\fR 4
1045 .IX Item "-march=architecture[+extension...]"
1046 Specify which ARM architecture variant is used by the target.
1047 .IP \fB\-mfpu=\fR\fIfloating\-point\-format\fR 4
1048 .IX Item "-mfpu=floating-point-format"
1049 Select which Floating Point architecture is the target.
1050 .IP \fB\-mfloat\-abi=\fR\fIabi\fR 4
1051 .IX Item "-mfloat-abi=abi"
1052 Select which floating point ABI is in use.
1053 .IP \fB\-mthumb\fR 4
1054 .IX Item "-mthumb"
1055 Enable Thumb only instruction decoding.
1056 .IP "\fB\-mapcs\-32 | \-mapcs\-26 | \-mapcs\-float | \-mapcs\-reentrant\fR" 4
1057 .IX Item "-mapcs-32 | -mapcs-26 | -mapcs-float | -mapcs-reentrant"
1058 Select which procedure calling convention is in use.
1059 .IP "\fB\-EB | \-EL\fR" 4
1060 .IX Item "-EB | -EL"
1061 Select either big\-endian (\-EB) or little\-endian (\-EL) output.
1062 .IP \fB\-mthumb\-interwork\fR 4
1063 .IX Item "-mthumb-interwork"
1064 Specify that the code has been generated with interworking between Thumb and
1065 ARM code in mind.
1066 .IP \fB\-mccs\fR 4
1067 .IX Item "-mccs"
1068 Turns on CodeComposer Studio assembly syntax compatibility mode.
1069 .IP \fB\-k\fR 4
1070 .IX Item "-k"
1071 Specify that PIC code has been generated.
1072 .PP
1073 The following options are available when as is configured for
1074 the Blackfin processor family.
1075 .IP \fB\-mcpu=\fR\fIprocessor\fR[\fB\-\fR\fIsirevision\fR] 4
1076 .IX Item "-mcpu=processor[-sirevision]"
1077 This option specifies the target processor. The optional \fIsirevision\fR
1078 is not used in assembler. It\*(Aqs here such that GCC can easily pass down its
1079 \&\f(CW\*(C`\-mcpu=\*(C'\fR option. The assembler will issue an
1080 error message if an attempt is made to assemble an instruction which
1081 will not execute on the target processor. The following processor names are
1082 recognized:
1083 \&\f(CW\*(C`bf504\*(C'\fR,
1084 \&\f(CW\*(C`bf506\*(C'\fR,
1085 \&\f(CW\*(C`bf512\*(C'\fR,
1086 \&\f(CW\*(C`bf514\*(C'\fR,
1087 \&\f(CW\*(C`bf516\*(C'\fR,
1088 \&\f(CW\*(C`bf518\*(C'\fR,
1089 \&\f(CW\*(C`bf522\*(C'\fR,
1090 \&\f(CW\*(C`bf523\*(C'\fR,
1091 \&\f(CW\*(C`bf524\*(C'\fR,
1092 \&\f(CW\*(C`bf525\*(C'\fR,
1093 \&\f(CW\*(C`bf526\*(C'\fR,
1094 \&\f(CW\*(C`bf527\*(C'\fR,
1095 \&\f(CW\*(C`bf531\*(C'\fR,
1096 \&\f(CW\*(C`bf532\*(C'\fR,
1097 \&\f(CW\*(C`bf533\*(C'\fR,
1098 \&\f(CW\*(C`bf534\*(C'\fR,
1099 \&\f(CW\*(C`bf535\*(C'\fR (not implemented yet),
1100 \&\f(CW\*(C`bf536\*(C'\fR,
1101 \&\f(CW\*(C`bf537\*(C'\fR,
1102 \&\f(CW\*(C`bf538\*(C'\fR,
1103 \&\f(CW\*(C`bf539\*(C'\fR,
1104 \&\f(CW\*(C`bf542\*(C'\fR,
1105 \&\f(CW\*(C`bf542m\*(C'\fR,
1106 \&\f(CW\*(C`bf544\*(C'\fR,
1107 \&\f(CW\*(C`bf544m\*(C'\fR,
1108 \&\f(CW\*(C`bf547\*(C'\fR,
1109 \&\f(CW\*(C`bf547m\*(C'\fR,
1110 \&\f(CW\*(C`bf548\*(C'\fR,
1111 \&\f(CW\*(C`bf548m\*(C'\fR,
1112 \&\f(CW\*(C`bf549\*(C'\fR,
1113 \&\f(CW\*(C`bf549m\*(C'\fR,
1114 \&\f(CW\*(C`bf561\*(C'\fR,
1115 and
1116 \&\f(CW\*(C`bf592\*(C'\fR.
1117 .IP \fB\-mfdpic\fR 4
1118 .IX Item "-mfdpic"
1119 Assemble for the FDPIC ABI.
1120 .IP \fB\-mno\-fdpic\fR 4
1121 .IX Item "-mno-fdpic"
1122 .PD 0
1123 .IP \fB\-mnopic\fR 4
1124 .IX Item "-mnopic"
1125 .PD
1126 Disable \-mfdpic.
1127 .PP
1128 The following options are available when as is configured for
1129 the Linux kernel BPF processor family.
1130 .PP
1131 \&\f(CW@chapter\fR BPF Dependent Features
1132 .SS "BPF Options"
1133 .IX Subsection "BPF Options"
1134 .IP \fB\-EB\fR 4
1135 .IX Item "-EB"
1136 This option specifies that the assembler should emit big\-endian eBPF.
1137 .IP \fB\-EL\fR 4
1138 .IX Item "-EL"
1139 This option specifies that the assembler should emit little\-endian
1140 eBPF.
1141 .IP \fB\-mdialect=\fR\fIdialect\fR 4
1142 .IX Item "-mdialect=dialect"
1143 This option specifies the assembly language dialect to recognize while
1144 assembling. The assembler supports \fBnormal\fR and
1145 \&\fBpseudoc\fR.
1146 .IP \fB\-misa\-spec=\fR\fIspec\fR 4
1147 .IX Item "-misa-spec=spec"
1148 This option specifies the version of the BPF instruction set to use
1149 when assembling. The BPF ISA versions supported are \fBv1\fR \fBv2\fR, \fBv3\fR and \fBv4\fR.
1150 .Sp
1151 The value \fBxbpf\fR can be specified to recognize extra
1152 instructions that are used by GCC for testing purposes. But beware
1153 this is not valid BPF.
1154 .IP \fB\-mno\-relax\fR 4
1155 .IX Item "-mno-relax"
1156 This option tells the assembler to not relax instructions.
1157 .PP
1158 Note that if no endianness option is specified in the command line,
1159 the host endianness is used.
1160 See the info pages for documentation of the CRIS\-specific options.
1161 .PP
1162 The following options are available when as is configured for
1163 the C\-SKY processor family.
1164 .IP \fB\-march=\fR\fIarchname\fR 4
1165 .IX Item "-march=archname"
1166 Assemble for architecture \fIarchname\fR. The \fB\-\-help\fR option
1167 lists valid values for \fIarchname\fR.
1168 .IP \fB\-mcpu=\fR\fIcpuname\fR 4
1169 .IX Item "-mcpu=cpuname"
1170 Assemble for architecture \fIcpuname\fR. The \fB\-\-help\fR option
1171 lists valid values for \fIcpuname\fR.
1172 .IP \fB\-EL\fR 4
1173 .IX Item "-EL"
1174 .PD 0
1175 .IP \fB\-mlittle\-endian\fR 4
1176 .IX Item "-mlittle-endian"
1177 .PD
1178 Generate little\-endian output.
1179 .IP \fB\-EB\fR 4
1180 .IX Item "-EB"
1181 .PD 0
1182 .IP \fB\-mbig\-endian\fR 4
1183 .IX Item "-mbig-endian"
1184 .PD
1185 Generate big\-endian output.
1186 .IP \fB\-fpic\fR 4
1187 .IX Item "-fpic"
1188 .PD 0
1189 .IP \fB\-pic\fR 4
1190 .IX Item "-pic"
1191 .PD
1192 Generate position\-independent code.
1193 .IP \fB\-mljump\fR 4
1194 .IX Item "-mljump"
1195 .PD 0
1196 .IP \fB\-mno\-ljump\fR 4
1197 .IX Item "-mno-ljump"
1198 .PD
1199 Enable/disable transformation of the short branch instructions
1200 \&\f(CW\*(C`jbf\*(C'\fR, \f(CW\*(C`jbt\*(C'\fR, and \f(CW\*(C`jbr\*(C'\fR to \f(CW\*(C`jmpi\*(C'\fR.
1201 This option is for V2 processors only.
1202 It is ignored on CK801 and CK802 targets, which do not support the \f(CW\*(C`jmpi\*(C'\fR
1203 instruction, and is enabled by default for other processors.
1204 .IP \fB\-mbranch\-stub\fR 4
1205 .IX Item "-mbranch-stub"
1206 .PD 0
1207 .IP \fB\-mno\-branch\-stub\fR 4
1208 .IX Item "-mno-branch-stub"
1209 .PD
1210 Pass through \f(CW\*(C`R_CKCORE_PCREL_IMM26BY2\*(C'\fR relocations for \f(CW\*(C`bsr\*(C'\fR
1211 instructions to the linker.
1212 .Sp
1213 This option is only available for bare\-metal C\-SKY V2 ELF targets,
1214 where it is enabled by default. It cannot be used in code that will be
1215 dynamically linked against shared libraries.
1216 .IP \fB\-force2bsr\fR 4
1217 .IX Item "-force2bsr"
1218 .PD 0
1219 .IP \fB\-mforce2bsr\fR 4
1220 .IX Item "-mforce2bsr"
1221 .IP \fB\-no\-force2bsr\fR 4
1222 .IX Item "-no-force2bsr"
1223 .IP \fB\-mno\-force2bsr\fR 4
1224 .IX Item "-mno-force2bsr"
1225 .PD
1226 Enable/disable transformation of \f(CW\*(C`jbsr\*(C'\fR instructions to \f(CW\*(C`bsr\*(C'\fR.
1227 This option is always enabled (and \fB\-mno\-force2bsr\fR is ignored)
1228 for CK801/CK802 targets. It is also always enabled when
1229 \&\fB\-mbranch\-stub\fR is in effect.
1230 .IP \fB\-jsri2bsr\fR 4
1231 .IX Item "-jsri2bsr"
1232 .PD 0
1233 .IP \fB\-mjsri2bsr\fR 4
1234 .IX Item "-mjsri2bsr"
1235 .IP \fB\-no\-jsri2bsr\fR 4
1236 .IX Item "-no-jsri2bsr"
1237 .IP \fB\-mno\-jsri2bsr\fR 4
1238 .IX Item "-mno-jsri2bsr"
1239 .PD
1240 Enable/disable transformation of \f(CW\*(C`jsri\*(C'\fR instructions to \f(CW\*(C`bsr\*(C'\fR.
1241 This option is enabled by default.
1242 .IP \fB\-mnolrw\fR 4
1243 .IX Item "-mnolrw"
1244 .PD 0
1245 .IP \fB\-mno\-lrw\fR 4
1246 .IX Item "-mno-lrw"
1247 .PD
1248 Enable/disable transformation of \f(CW\*(C`lrw\*(C'\fR instructions into a
1249 \&\f(CW\*(C`movih\*(C'\fR/\f(CW\*(C`ori\*(C'\fR pair.
1250 .IP \fB\-melrw\fR 4
1251 .IX Item "-melrw"
1252 .PD 0
1253 .IP \fB\-mno\-elrw\fR 4
1254 .IX Item "-mno-elrw"
1255 .PD
1256 Enable/disable extended \f(CW\*(C`lrw\*(C'\fR instructions.
1257 This option is enabled by default for CK800\-series processors.
1258 .IP \fB\-mlaf\fR 4
1259 .IX Item "-mlaf"
1260 .PD 0
1261 .IP \fB\-mliterals\-after\-func\fR 4
1262 .IX Item "-mliterals-after-func"
1263 .IP \fB\-mno\-laf\fR 4
1264 .IX Item "-mno-laf"
1265 .IP \fB\-mno\-literals\-after\-func\fR 4
1266 .IX Item "-mno-literals-after-func"
1267 .PD
1268 Enable/disable placement of literal pools after each function.
1269 .IP \fB\-mlabr\fR 4
1270 .IX Item "-mlabr"
1271 .PD 0
1272 .IP \fB\-mliterals\-after\-br\fR 4
1273 .IX Item "-mliterals-after-br"
1274 .IP \fB\-mno\-labr\fR 4
1275 .IX Item "-mno-labr"
1276 .IP \fB\-mnoliterals\-after\-br\fR 4
1277 .IX Item "-mnoliterals-after-br"
1278 .PD
1279 Enable/disable placement of literal pools after unconditional branches.
1280 This option is enabled by default.
1281 .IP \fB\-mistack\fR 4
1282 .IX Item "-mistack"
1283 .PD 0
1284 .IP \fB\-mno\-istack\fR 4
1285 .IX Item "-mno-istack"
1286 .PD
1287 Enable/disable interrupt stack instructions. This option is enabled by
1288 default on CK801, CK802, and CK802 processors.
1289 .PP
1290 The following options explicitly enable certain optional instructions.
1291 These features are also enabled implicitly by using \f(CW\*(C`\-mcpu=\*(C'\fR to specify
1292 a processor that supports it.
1293 .IP \fB\-mhard\-float\fR 4
1294 .IX Item "-mhard-float"
1295 Enable hard float instructions.
1296 .IP \fB\-mmp\fR 4
1297 .IX Item "-mmp"
1298 Enable multiprocessor instructions.
1299 .IP \fB\-mcp\fR 4
1300 .IX Item "-mcp"
1301 Enable coprocessor instructions.
1302 .IP \fB\-mcache\fR 4
1303 .IX Item "-mcache"
1304 Enable cache prefetch instruction.
1305 .IP \fB\-msecurity\fR 4
1306 .IX Item "-msecurity"
1307 Enable C\-SKY security instructions.
1308 .IP \fB\-mtrust\fR 4
1309 .IX Item "-mtrust"
1310 Enable C\-SKY trust instructions.
1311 .IP \fB\-mdsp\fR 4
1312 .IX Item "-mdsp"
1313 Enable DSP instructions.
1314 .IP \fB\-medsp\fR 4
1315 .IX Item "-medsp"
1316 Enable enhanced DSP instructions.
1317 .IP \fB\-mvdsp\fR 4
1318 .IX Item "-mvdsp"
1319 Enable vector DSP instructions.
1320 .PP
1321 The following options are available when as is configured for
1322 an Epiphany processor.
1323 .IP \fB\-mepiphany\fR 4
1324 .IX Item "-mepiphany"
1325 Specifies that the both 32 and 16 bit instructions are allowed. This is the
1326 default behavior.
1327 .IP \fB\-mepiphany16\fR 4
1328 .IX Item "-mepiphany16"
1329 Restricts the permitted instructions to just the 16 bit set.
1330 .PP
1331 The following options are available when as is configured for an H8/300
1332 processor.
1333 \&\f(CW@chapter\fR H8/300 Dependent Features
1334 .SS Options
1335 .IX Subsection "Options"
1336 The Renesas H8/300 version of \f(CW\*(C`as\*(C'\fR has one
1337 machine\-dependent option:
1338 .IP \fB\-h\-tick\-hex\fR 4
1339 .IX Item "-h-tick-hex"
1340 Support H\*(Aq00 style hex constants in addition to 0x00 style.
1341 .IP \fB\-mach=\fR\fIname\fR 4
1342 .IX Item "-mach=name"
1343 Sets the H8300 machine variant. The following machine names
1344 are recognised:
1345 \&\f(CW\*(C`h8300h\*(C'\fR,
1346 \&\f(CW\*(C`h8300hn\*(C'\fR,
1347 \&\f(CW\*(C`h8300s\*(C'\fR,
1348 \&\f(CW\*(C`h8300sn\*(C'\fR,
1349 \&\f(CW\*(C`h8300sx\*(C'\fR and
1350 \&\f(CW\*(C`h8300sxn\*(C'\fR.
1351 .PP
1352 The following options are available when as is configured for
1353 an i386 processor.
1354 .IP "\fB\-\-32 | \-\-x32 | \-\-64\fR" 4
1355 .IX Item "--32 | --x32 | --64"
1356 Select the word size, either 32 bits or 64 bits. \fB\-\-32\fR
1357 implies Intel i386 architecture, while \fB\-\-x32\fR and \fB\-\-64\fR
1358 imply AMD x86\-64 architecture with 32\-bit or 64\-bit word\-size
1359 respectively.
1360 .Sp
1361 These options are only available with the ELF object file format, and
1362 require that the necessary BFD support has been included (on a 32\-bit
1363 platform you have to add \-\-enable\-64\-bit\-bfd to configure enable 64\-bit
1364 usage and use x86\-64 as target platform).
1365 .IP \fB\-n\fR 4
1366 .IX Item "-n"
1367 By default, x86 GAS replaces multiple nop instructions used for
1368 alignment within code sections with multi\-byte nop instructions such
1369 as leal 0(%esi,1),%esi. This switch disables the optimization if a single
1370 byte nop (0x90) is explicitly specified as the fill byte for alignment.
1371 .IP \fB\-\-divide\fR 4
1372 .IX Item "--divide"
1373 On SVR4\-derived platforms, the character \fB/\fR is treated as a comment
1374 character, which means that it cannot be used in expressions. The
1375 \&\fB\-\-divide\fR option turns \fB/\fR into a normal character. This does
1376 not disable \fB/\fR at the beginning of a line starting a comment, or
1377 affect using \fB#\fR for starting a comment.
1378 .IP \fB\-march=\fR\fICPU\fR\fB[+\fR\fIEXTENSION\fR\fB...]\fR 4
1379 .IX Item "-march=CPU[+EXTENSION...]"
1380 This option specifies the target processor. The assembler will
1381 issue an error message if an attempt is made to assemble an instruction
1382 which will not execute on the target processor. The following
1383 processor names are recognized:
1384 \&\f(CW\*(C`i8086\*(C'\fR,
1385 \&\f(CW\*(C`i186\*(C'\fR,
1386 \&\f(CW\*(C`i286\*(C'\fR,
1387 \&\f(CW\*(C`i386\*(C'\fR,
1388 \&\f(CW\*(C`i486\*(C'\fR,
1389 \&\f(CW\*(C`i586\*(C'\fR,
1390 \&\f(CW\*(C`i686\*(C'\fR,
1391 \&\f(CW\*(C`pentium\*(C'\fR,
1392 \&\f(CW\*(C`pentiumpro\*(C'\fR,
1393 \&\f(CW\*(C`pentiumii\*(C'\fR,
1394 \&\f(CW\*(C`pentiumiii\*(C'\fR,
1395 \&\f(CW\*(C`pentium4\*(C'\fR,
1396 \&\f(CW\*(C`prescott\*(C'\fR,
1397 \&\f(CW\*(C`nocona\*(C'\fR,
1398 \&\f(CW\*(C`core\*(C'\fR,
1399 \&\f(CW\*(C`core2\*(C'\fR,
1400 \&\f(CW\*(C`corei7\*(C'\fR,
1401 \&\f(CW\*(C`iamcu\*(C'\fR,
1402 \&\f(CW\*(C`k6\*(C'\fR,
1403 \&\f(CW\*(C`k6_2\*(C'\fR,
1404 \&\f(CW\*(C`athlon\*(C'\fR,
1405 \&\f(CW\*(C`opteron\*(C'\fR,
1406 \&\f(CW\*(C`k8\*(C'\fR,
1407 \&\f(CW\*(C`amdfam10\*(C'\fR,
1408 \&\f(CW\*(C`bdver1\*(C'\fR,
1409 \&\f(CW\*(C`bdver2\*(C'\fR,
1410 \&\f(CW\*(C`bdver3\*(C'\fR,
1411 \&\f(CW\*(C`bdver4\*(C'\fR,
1412 \&\f(CW\*(C`znver1\*(C'\fR,
1413 \&\f(CW\*(C`znver2\*(C'\fR,
1414 \&\f(CW\*(C`znver3\*(C'\fR,
1415 \&\f(CW\*(C`znver4\*(C'\fR,
1416 \&\f(CW\*(C`znver5\*(C'\fR,
1417 \&\f(CW\*(C`znver6\*(C'\fR,
1418 \&\f(CW\*(C`btver1\*(C'\fR,
1419 \&\f(CW\*(C`btver2\*(C'\fR,
1420 \&\f(CW\*(C`generic32\*(C'\fR and
1421 \&\f(CW\*(C`generic64\*(C'\fR.
1422 .Sp
1423 In addition to the basic instruction set, the assembler can be told to
1424 accept various extension mnemonics. For example,
1425 \&\f(CW\*(C`\-march=i686+sse4+vmx\*(C'\fR extends \fIi686\fR with \fIsse4\fR and
1426 \&\fIvmx\fR. The following extensions are currently supported:
1427 \&\f(CW8087\fR,
1428 \&\f(CW287\fR,
1429 \&\f(CW387\fR,
1430 \&\f(CW687\fR,
1431 \&\f(CW\*(C`cmov\*(C'\fR,
1432 \&\f(CW\*(C`fxsr\*(C'\fR,
1433 \&\f(CW\*(C`mmx\*(C'\fR,
1434 \&\f(CW\*(C`sse\*(C'\fR,
1435 \&\f(CW\*(C`sse2\*(C'\fR,
1436 \&\f(CW\*(C`sse3\*(C'\fR,
1437 \&\f(CW\*(C`sse4a\*(C'\fR,
1438 \&\f(CW\*(C`ssse3\*(C'\fR,
1439 \&\f(CW\*(C`sse4.1\*(C'\fR,
1440 \&\f(CW\*(C`sse4.2\*(C'\fR,
1441 \&\f(CW\*(C`sse4\*(C'\fR,
1442 \&\f(CW\*(C`avx\*(C'\fR,
1443 \&\f(CW\*(C`avx2\*(C'\fR,
1444 \&\f(CW\*(C`lahf_sahf\*(C'\fR,
1445 \&\f(CW\*(C`monitor\*(C'\fR,
1446 \&\f(CW\*(C`adx\*(C'\fR,
1447 \&\f(CW\*(C`rdseed\*(C'\fR,
1448 \&\f(CW\*(C`prfchw\*(C'\fR,
1449 \&\f(CW\*(C`smap\*(C'\fR,
1450 \&\f(CW\*(C`mpx\*(C'\fR,
1451 \&\f(CW\*(C`sha\*(C'\fR,
1452 \&\f(CW\*(C`rdpid\*(C'\fR,
1453 \&\f(CW\*(C`ptwrite\*(C'\fR,
1454 \&\f(CW\*(C`cet\*(C'\fR,
1455 \&\f(CW\*(C`gfni\*(C'\fR,
1456 \&\f(CW\*(C`vaes\*(C'\fR,
1457 \&\f(CW\*(C`vpclmulqdq\*(C'\fR,
1458 \&\f(CW\*(C`prefetchwt1\*(C'\fR,
1459 \&\f(CW\*(C`clflushopt\*(C'\fR,
1460 \&\f(CW\*(C`se1\*(C'\fR,
1461 \&\f(CW\*(C`clwb\*(C'\fR,
1462 \&\f(CW\*(C`movdiri\*(C'\fR,
1463 \&\f(CW\*(C`movdir64b\*(C'\fR,
1464 \&\f(CW\*(C`enqcmd\*(C'\fR,
1465 \&\f(CW\*(C`serialize\*(C'\fR,
1466 \&\f(CW\*(C`tsxldtrk\*(C'\fR,
1467 \&\f(CW\*(C`kl\*(C'\fR,
1468 \&\f(CW\*(C`widekl\*(C'\fR,
1469 \&\f(CW\*(C`hreset\*(C'\fR,
1470 \&\f(CW\*(C`avx512f\*(C'\fR,
1471 \&\f(CW\*(C`avx512cd\*(C'\fR,
1472 \&\f(CW\*(C`avx512er\*(C'\fR,
1473 \&\f(CW\*(C`avx512pf\*(C'\fR,
1474 \&\f(CW\*(C`avx512vl\*(C'\fR,
1475 \&\f(CW\*(C`avx512bw\*(C'\fR,
1476 \&\f(CW\*(C`avx512dq\*(C'\fR,
1477 \&\f(CW\*(C`avx512ifma\*(C'\fR,
1478 \&\f(CW\*(C`avx512vbmi\*(C'\fR,
1479 \&\f(CW\*(C`avx512_4fmaps\*(C'\fR,
1480 \&\f(CW\*(C`avx512_4vnniw\*(C'\fR,
1481 \&\f(CW\*(C`avx512_vpopcntdq\*(C'\fR,
1482 \&\f(CW\*(C`avx512_vbmi2\*(C'\fR,
1483 \&\f(CW\*(C`avx512_vnni\*(C'\fR,
1484 \&\f(CW\*(C`avx512_bitalg\*(C'\fR,
1485 \&\f(CW\*(C`avx512_vp2intersect\*(C'\fR,
1486 \&\f(CW\*(C`tdx\*(C'\fR,
1487 \&\f(CW\*(C`avx512_bf16\*(C'\fR,
1488 \&\f(CW\*(C`avx_vnni\*(C'\fR,
1489 \&\f(CW\*(C`avx512_fp16\*(C'\fR,
1490 \&\f(CW\*(C`avx512_bmm\*(C'\fR,
1491 \&\f(CW\*(C`prefetchi\*(C'\fR,
1492 \&\f(CW\*(C`avx_ifma\*(C'\fR,
1493 \&\f(CW\*(C`avx_vnni_int8\*(C'\fR,
1494 \&\f(CW\*(C`cmpccxadd\*(C'\fR,
1495 \&\f(CW\*(C`wrmsrns\*(C'\fR,
1496 \&\f(CW\*(C`msrlist\*(C'\fR,
1497 \&\f(CW\*(C`avx_ne_convert\*(C'\fR,
1498 \&\f(CW\*(C`rao_int\*(C'\fR,
1499 \&\f(CW\*(C`fred\*(C'\fR,
1500 \&\f(CW\*(C`lkgs\*(C'\fR,
1501 \&\f(CW\*(C`avx_vnni_int16\*(C'\fR,
1502 \&\f(CW\*(C`sha512\*(C'\fR,
1503 \&\f(CW\*(C`sm3\*(C'\fR,
1504 \&\f(CW\*(C`sm4\*(C'\fR,
1505 \&\f(CW\*(C`pbndkb\*(C'\fR,
1506 \&\f(CW\*(C`avx10.1\*(C'\fR,
1507 \&\f(CW\*(C`avx10.1/512\*(C'\fR,
1508 \&\f(CW\*(C`avx10.1/256\*(C'\fR,
1509 \&\f(CW\*(C`avx10.1/128\*(C'\fR,
1510 \&\f(CW\*(C`user_msr\*(C'\fR,
1511 \&\f(CW\*(C`msr_imm\*(C'\fR,
1512 \&\f(CW\*(C`apx_f\*(C'\fR,
1513 \&\f(CW\*(C`apx_nci\*(C'\fR,
1514 \&\f(CW\*(C`apx_ndd\*(C'\fR,
1515 \&\f(CW\*(C`apx_nf\*(C'\fR,
1516 \&\f(CW\*(C`apx_nci_ndd_nf\*(C'\fR,
1517 \&\f(CW\*(C`avx10.2\*(C'\fR,
1518 \&\f(CW\*(C`avx10.2/512\*(C'\fR,
1519 \&\f(CW\*(C`avx10.2/256\*(C'\fR,
1520 \&\f(CW\*(C`avx10.2/128\*(C'\fR,
1521 \&\f(CW\*(C`movrs\*(C'\fR,
1522 \&\f(CW\*(C`amx_int8\*(C'\fR,
1523 \&\f(CW\*(C`amx_bf16\*(C'\fR,
1524 \&\f(CW\*(C`amx_fp16\*(C'\fR,
1525 \&\f(CW\*(C`amx_complex\*(C'\fR,
1526 \&\f(CW\*(C`amx_transpose\*(C'\fR,
1527 \&\f(CW\*(C`amx_tf32\*(C'\fR,
1528 \&\f(CW\*(C`amx_fp8\*(C'\fR
1529 \&\f(CW\*(C`amx_movrs\*(C'\fR,
1530 \&\f(CW\*(C`amx_avx512\*(C'\fR,
1531 \&\f(CW\*(C`amx_tile\*(C'\fR,
1532 \&\f(CW\*(C`vmx\*(C'\fR,
1533 \&\f(CW\*(C`vmfunc\*(C'\fR,
1534 \&\f(CW\*(C`smx\*(C'\fR,
1535 \&\f(CW\*(C`xsave\*(C'\fR,
1536 \&\f(CW\*(C`xsaveopt\*(C'\fR,
1537 \&\f(CW\*(C`xsavec\*(C'\fR,
1538 \&\f(CW\*(C`xsaves\*(C'\fR,
1539 \&\f(CW\*(C`aes\*(C'\fR,
1540 \&\f(CW\*(C`pclmul\*(C'\fR,
1541 \&\f(CW\*(C`fsgsbase\*(C'\fR,
1542 \&\f(CW\*(C`rdrnd\*(C'\fR,
1543 \&\f(CW\*(C`f16c\*(C'\fR,
1544 \&\f(CW\*(C`bmi2\*(C'\fR,
1545 \&\f(CW\*(C`fma\*(C'\fR,
1546 \&\f(CW\*(C`movbe\*(C'\fR,
1547 \&\f(CW\*(C`ept\*(C'\fR,
1548 \&\f(CW\*(C`lzcnt\*(C'\fR,
1549 \&\f(CW\*(C`popcnt\*(C'\fR,
1550 \&\f(CW\*(C`hle\*(C'\fR,
1551 \&\f(CW\*(C`rtm\*(C'\fR,
1552 \&\f(CW\*(C`tsx\*(C'\fR,
1553 \&\f(CW\*(C`invpcid\*(C'\fR,
1554 \&\f(CW\*(C`clflush\*(C'\fR,
1555 \&\f(CW\*(C`mwaitx\*(C'\fR,
1556 \&\f(CW\*(C`clzero\*(C'\fR,
1557 \&\f(CW\*(C`wbnoinvd\*(C'\fR,
1558 \&\f(CW\*(C`pconfig\*(C'\fR,
1559 \&\f(CW\*(C`waitpkg\*(C'\fR,
1560 \&\f(CW\*(C`uintr\*(C'\fR,
1561 \&\f(CW\*(C`cldemote\*(C'\fR,
1562 \&\f(CW\*(C`rdpru\*(C'\fR,
1563 \&\f(CW\*(C`mcommit\*(C'\fR,
1564 \&\f(CW\*(C`sev_es\*(C'\fR,
1565 \&\f(CW\*(C`lwp\*(C'\fR,
1566 \&\f(CW\*(C`fma4\*(C'\fR,
1567 \&\f(CW\*(C`xop\*(C'\fR,
1568 \&\f(CW\*(C`cx16\*(C'\fR,
1569 \&\f(CW\*(C`syscall\*(C'\fR,
1570 \&\f(CW\*(C`rdtscp\*(C'\fR,
1571 \&\f(CW\*(C`3dnow\*(C'\fR,
1572 \&\f(CW\*(C`3dnowa\*(C'\fR,
1573 \&\f(CW\*(C`sse4a\*(C'\fR,
1574 \&\f(CW\*(C`sse5\*(C'\fR,
1575 \&\f(CW\*(C`snp\*(C'\fR,
1576 \&\f(CW\*(C`invlpgb\*(C'\fR,
1577 \&\f(CW\*(C`tlbsync\*(C'\fR,
1578 \&\f(CW\*(C`rmpquery\*(C'\fR,
1579 \&\f(CW\*(C`rmpread\*(C'\fR,
1580 \&\f(CW\*(C`svme\*(C'\fR,
1581 \&\f(CW\*(C`gmism2\*(C'\fR,
1582 \&\f(CW\*(C`gmiccs\*(C'\fR,
1583 \&\f(CW\*(C`padlockrng2\*(C'\fR,
1584 \&\f(CW\*(C`padlockphe2\*(C'\fR,
1585 \&\f(CW\*(C`padlockxmodx\*(C'\fR and
1586 \&\f(CW\*(C`padlock\*(C'\fR.
1587 Note that these extension mnemonics can be prefixed with \f(CW\*(C`no\*(C'\fR to revoke
1588 the respective (and any dependent) functionality. Note further that the
1589 suffixes permitted on \f(CW\*(C`\-march=avx10.<N>\*(C'\fR enforce a vector length
1590 restriction, i.e. despite these otherwise being "enabling" options, using
1591 these suffixes will disable all insns with wider vector or mask register
1592 operands.
1593 .Sp
1594 When the \f(CW\*(C`.arch\*(C'\fR directive is used with \fB\-march\fR, the
1595 \&\f(CW\*(C`.arch\*(C'\fR directive will take precedent.
1596 .IP \fB\-mtune=\fR\fICPU\fR 4
1597 .IX Item "-mtune=CPU"
1598 This option specifies a processor to optimize for. When used in
1599 conjunction with the \fB\-march\fR option, only instructions
1600 of the processor specified by the \fB\-march\fR option will be
1601 generated.
1602 .Sp
1603 Valid \fICPU\fR values are identical to the processor list of
1604 \&\fB\-march=\fR\fICPU\fR.
1605 .IP \fB\-moperand\-check=\fR\fInone\fR 4
1606 .IX Item "-moperand-check=none"
1607 .PD 0
1608 .IP \fB\-moperand\-check=\fR\fIwarning\fR 4
1609 .IX Item "-moperand-check=warning"
1610 .IP \fB\-moperand\-check=\fR\fIerror\fR 4
1611 .IX Item "-moperand-check=error"
1612 .PD
1613 These options control if the assembler should check certain instruction
1614 operands or operand combinations. An example instructions where operand size
1615 cannot be inferred from its operands and also hasn\*(Aqt been specified by way of
1616 an instruction suffix.
1617 \&\fB\-moperand\-check=\fR\fInone\fR will make the assembler not perform
1618 these checks. \fB\-moperand\-check=\fR\fIwarning\fR will make the assembler
1619 issue a warning when respective checks fail, which is the default.
1620 \&\fB\-moperand\-check=\fR\fIerror\fR will make the assembler issue an error
1621 when respective checks fail.
1622 .IP \fB\-msse2avx\fR 4
1623 .IX Item "-msse2avx"
1624 This option specifies that the assembler should encode SSE instructions
1625 with VEX prefix, requiring AVX to be available. SSE instructions using
1626 extended GPRs will be encoded with EVEX prefix, requiring AVX512 or AVX10 to
1627 be available.
1628 .IP \fB\-muse\-unaligned\-vector\-move\fR 4
1629 .IX Item "-muse-unaligned-vector-move"
1630 This option specifies that the assembler should encode aligned vector
1631 move as unaligned vector move.
1632 .IP \fB\-msse\-check=\fR\fInone\fR 4
1633 .IX Item "-msse-check=none"
1634 .PD 0
1635 .IP \fB\-msse\-check=\fR\fIwarning\fR 4
1636 .IX Item "-msse-check=warning"
1637 .IP \fB\-msse\-check=\fR\fIerror\fR 4
1638 .IX Item "-msse-check=error"
1639 .PD
1640 These options control if the assembler should check SSE instructions.
1641 \&\fB\-msse\-check=\fR\fInone\fR will make the assembler not to check SSE
1642 instructions, which is the default. \fB\-msse\-check=\fR\fIwarning\fR
1643 will make the assembler issue a warning for any SSE instruction.
1644 \&\fB\-msse\-check=\fR\fIerror\fR will make the assembler issue an error
1645 for any SSE instruction.
1646 .IP \fB\-mavxscalar=\fR\fI128\fR 4
1647 .IX Item "-mavxscalar=128"
1648 .PD 0
1649 .IP \fB\-mavxscalar=\fR\fI256\fR 4
1650 .IX Item "-mavxscalar=256"
1651 .PD
1652 These options control how the assembler should encode scalar AVX
1653 instructions. \fB\-mavxscalar=\fR\fI128\fR will encode scalar
1654 AVX instructions with 128bit vector length, which is the default.
1655 \&\fB\-mavxscalar=\fR\fI256\fR will encode scalar AVX instructions
1656 with 256bit vector length.
1657 .Sp
1658 WARNING: Don\*(Aqt use this for production code \- due to CPU errata the
1659 resulting code may not work on certain models.
1660 .IP \fB\-mvexwig=\fR\fI0\fR 4
1661 .IX Item "-mvexwig=0"
1662 .PD 0
1663 .IP \fB\-mvexwig=\fR\fI1\fR 4
1664 .IX Item "-mvexwig=1"
1665 .PD
1666 These options control how the assembler should encode VEX.W\-ignored (WIG)
1667 VEX instructions. \fB\-mvexwig=\fR\fI0\fR will encode WIG VEX
1668 instructions with vex.w = 0, which is the default.
1669 \&\fB\-mvexwig=\fR\fI1\fR will encode WIG EVEX instructions with
1670 vex.w = 1.
1671 .Sp
1672 WARNING: Don\*(Aqt use this for production code \- due to CPU errata the
1673 resulting code may not work on certain models.
1674 .IP \fB\-mevexlig=\fR\fI128\fR 4
1675 .IX Item "-mevexlig=128"
1676 .PD 0
1677 .IP \fB\-mevexlig=\fR\fI256\fR 4
1678 .IX Item "-mevexlig=256"
1679 .IP \fB\-mevexlig=\fR\fI512\fR 4
1680 .IX Item "-mevexlig=512"
1681 .PD
1682 These options control how the assembler should encode length\-ignored
1683 (LIG) EVEX instructions. \fB\-mevexlig=\fR\fI128\fR will encode LIG
1684 EVEX instructions with 128bit vector length, which is the default.
1685 \&\fB\-mevexlig=\fR\fI256\fR and \fB\-mevexlig=\fR\fI512\fR will
1686 encode LIG EVEX instructions with 256bit and 512bit vector length,
1687 respectively.
1688 .IP \fB\-mevexwig=\fR\fI0\fR 4
1689 .IX Item "-mevexwig=0"
1690 .PD 0
1691 .IP \fB\-mevexwig=\fR\fI1\fR 4
1692 .IX Item "-mevexwig=1"
1693 .PD
1694 These options control how the assembler should encode w\-ignored (WIG)
1695 EVEX instructions. \fB\-mevexwig=\fR\fI0\fR will encode WIG
1696 EVEX instructions with evex.w = 0, which is the default.
1697 \&\fB\-mevexwig=\fR\fI1\fR will encode WIG EVEX instructions with
1698 evex.w = 1.
1699 .IP \fB\-mmnemonic=\fR\fIatt\fR 4
1700 .IX Item "-mmnemonic=att"
1701 .PD 0
1702 .IP \fB\-mmnemonic=\fR\fIintel\fR 4
1703 .IX Item "-mmnemonic=intel"
1704 .PD
1705 This option specifies instruction mnemonic for matching instructions.
1706 The \f(CW\*(C`.att_mnemonic\*(C'\fR and \f(CW\*(C`.intel_mnemonic\*(C'\fR directives will
1707 take precedent.
1708 .IP \fB\-msyntax=\fR\fIatt\fR 4
1709 .IX Item "-msyntax=att"
1710 .PD 0
1711 .IP \fB\-msyntax=\fR\fIintel\fR 4
1712 .IX Item "-msyntax=intel"
1713 .PD
1714 This option specifies instruction syntax when processing instructions.
1715 The \f(CW\*(C`.att_syntax\*(C'\fR and \f(CW\*(C`.intel_syntax\*(C'\fR directives will
1716 take precedent.
1717 .IP \fB\-mnaked\-reg\fR 4
1718 .IX Item "-mnaked-reg"
1719 This option specifies that registers don\*(Aqt require a \fB%\fR prefix.
1720 The \f(CW\*(C`.att_syntax\*(C'\fR and \f(CW\*(C`.intel_syntax\*(C'\fR directives will take precedent.
1721 .IP \fB\-madd\-bnd\-prefix\fR 4
1722 .IX Item "-madd-bnd-prefix"
1723 This option forces the assembler to add BND prefix to all branches, even
1724 if such prefix was not explicitly specified in the source code.
1725 .IP \fB\-mno\-shared\fR 4
1726 .IX Item "-mno-shared"
1727 On ELF target, the assembler normally optimizes out non\-PLT relocations
1728 against defined non\-weak global branch targets with default visibility.
1729 The \fB\-mshared\fR option tells the assembler to generate code which
1730 may go into a shared library where all non\-weak global branch targets
1731 with default visibility can be preempted. The resulting code is
1732 slightly bigger. This option only affects the handling of branch
1733 instructions.
1734 .IP \fB\-mbig\-obj\fR 4
1735 .IX Item "-mbig-obj"
1736 On PE/COFF target this option forces the use of big object file
1737 format, which allows more than 32768 sections.
1738 .IP \fB\-momit\-lock\-prefix=\fR\fIno\fR 4
1739 .IX Item "-momit-lock-prefix=no"
1740 .PD 0
1741 .IP \fB\-momit\-lock\-prefix=\fR\fIyes\fR 4
1742 .IX Item "-momit-lock-prefix=yes"
1743 .PD
1744 These options control how the assembler should encode lock prefix.
1745 This option is intended as a workaround for processors, that fail on
1746 lock prefix. This option can only be safely used with single\-core,
1747 single\-thread computers
1748 \&\fB\-momit\-lock\-prefix=\fR\fIyes\fR will omit all lock prefixes.
1749 \&\fB\-momit\-lock\-prefix=\fR\fIno\fR will encode lock prefix as usual,
1750 which is the default.
1751 .IP \fB\-mfence\-as\-lock\-add=\fR\fIno\fR 4
1752 .IX Item "-mfence-as-lock-add=no"
1753 .PD 0
1754 .IP \fB\-mfence\-as\-lock\-add=\fR\fIyes\fR 4
1755 .IX Item "-mfence-as-lock-add=yes"
1756 .PD
1757 These options control how the assembler should encode lfence, mfence and
1758 sfence.
1759 \&\fB\-mfence\-as\-lock\-add=\fR\fIyes\fR will encode lfence, mfence and
1760 sfence as \fBlock addl \fR\f(CB$0x0\fR\fB, (%rsp)\fR in 64\-bit mode and
1761 \&\fBlock addl \fR\f(CB$0x0\fR\fB, (%esp)\fR in 32\-bit mode.
1762 \&\fB\-mfence\-as\-lock\-add=\fR\fIno\fR will encode lfence, mfence and
1763 sfence as usual, which is the default.
1764 .IP \fB\-mrelax\-relocations=\fR\fIno\fR 4
1765 .IX Item "-mrelax-relocations=no"
1766 .PD 0
1767 .IP \fB\-mrelax\-relocations=\fR\fIyes\fR 4
1768 .IX Item "-mrelax-relocations=yes"
1769 .PD
1770 These options control whether the assembler should generate relax
1771 relocations, R_386_GOT32X, in 32\-bit mode, or R_X86_64_GOTPCRELX and
1772 R_X86_64_REX_GOTPCRELX, in 64\-bit mode.
1773 \&\fB\-mrelax\-relocations=\fR\fIyes\fR will generate relax relocations.
1774 \&\fB\-mrelax\-relocations=\fR\fIno\fR will not generate relax
1775 relocations.
1776 .IP \fB\-mtls\-check=\fR\fIno\fR 4
1777 .IX Item "-mtls-check=no"
1778 .PD 0
1779 .IP \fB\-mtls\-check=\fR\fIyes\fR 4
1780 .IX Item "-mtls-check=yes"
1781 .PD
1782 These options control whether the assembler check tls relocation.
1783 \&\fB\-mtls\-check=\fR\fIyes\fR will check tls relocation.
1784 \&\fB\-mtls\-check=\fR\fIno\fR will not check tls relocation
1785 The default can be controlled by a configure option
1786 \&\fB\-\-enable\-x86\-tls\-check\fR.
1787 .IP \fB\-malign\-branch\-boundary=\fR\fINUM\fR 4
1788 .IX Item "-malign-branch-boundary=NUM"
1789 This option controls how the assembler should align branches with segment
1790 prefixes or NOP. \fINUM\fR must be a power of 2. It should be 0 or
1791 no less than 16. Branches will be aligned within \fINUM\fR byte
1792 boundary. \fB\-malign\-branch\-boundary=0\fR, which is the default,
1793 doesn\*(Aqt align branches.
1794 .IP \fB\-malign\-branch=\fR\fITYPE\fR\fB[+\fR\fITYPE\fR\fB...]\fR 4
1795 .IX Item "-malign-branch=TYPE[+TYPE...]"
1796 This option specifies types of branches to align. \fITYPE\fR is
1797 combination of \fBjcc\fR, which aligns conditional jumps,
1798 \&\fBfused\fR, which aligns fused conditional jumps, \fBjmp\fR,
1799 which aligns unconditional jumps, \fBcall\fR which aligns calls,
1800 \&\fBret\fR, which aligns rets, \fBindirect\fR, which aligns indirect
1801 jumps and calls. The default is \fB\-malign\-branch=jcc+fused+jmp\fR.
1802 .IP \fB\-malign\-branch\-prefix\-size=\fR\fINUM\fR 4
1803 .IX Item "-malign-branch-prefix-size=NUM"
1804 This option specifies the maximum number of prefixes on an instruction
1805 to align branches. \fINUM\fR should be between 0 and 5. The default
1806 \&\fINUM\fR is 5.
1807 .IP \fB\-mbranches\-within\-32B\-boundaries\fR 4
1808 .IX Item "-mbranches-within-32B-boundaries"
1809 This option aligns conditional jumps, fused conditional jumps and
1810 unconditional jumps within 32 byte boundary with up to 5 segment prefixes
1811 on an instruction. It is equivalent to
1812 \&\fB\-malign\-branch\-boundary=32\fR
1813 \&\fB\-malign\-branch=jcc+fused+jmp\fR
1814 \&\fB\-malign\-branch\-prefix\-size=5\fR.
1815 The default doesn\*(Aqt align branches.
1816 .IP \fB\-mlfence\-after\-load=\fR\fIno\fR 4
1817 .IX Item "-mlfence-after-load=no"
1818 .PD 0
1819 .IP \fB\-mlfence\-after\-load=\fR\fIyes\fR 4
1820 .IX Item "-mlfence-after-load=yes"
1821 .PD
1822 These options control whether the assembler should generate lfence
1823 after load instructions. \fB\-mlfence\-after\-load=\fR\fIyes\fR will
1824 generate lfence. \fB\-mlfence\-after\-load=\fR\fIno\fR will not generate
1825 lfence, which is the default.
1826 .IP \fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR 4
1827 .IX Item "-mlfence-before-indirect-branch=none"
1828 .PD 0
1829 .IP \fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR 4
1830 .IX Item "-mlfence-before-indirect-branch=all"
1831 .IP \fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR 4
1832 .IX Item "-mlfence-before-indirect-branch=register"
1833 .IP \fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR 4
1834 .IX Item "-mlfence-before-indirect-branch=memory"
1835 .PD
1836 These options control whether the assembler should generate lfence
1837 before indirect near branch instructions.
1838 \&\fB\-mlfence\-before\-indirect\-branch=\fR\fIall\fR will generate lfence
1839 before indirect near branch via register and issue a warning before
1840 indirect near branch via memory.
1841 It also implicitly sets \fB\-mlfence\-before\-ret=\fR\fIshl\fR when
1842 there\*(Aqs no explicit \fB\-mlfence\-before\-ret=\fR.
1843 \&\fB\-mlfence\-before\-indirect\-branch=\fR\fIregister\fR will generate
1844 lfence before indirect near branch via register.
1845 \&\fB\-mlfence\-before\-indirect\-branch=\fR\fImemory\fR will issue a
1846 warning before indirect near branch via memory.
1847 \&\fB\-mlfence\-before\-indirect\-branch=\fR\fInone\fR will not generate
1848 lfence nor issue warning, which is the default. Note that lfence won\*(Aqt
1849 be generated before indirect near branch via register with
1850 \&\fB\-mlfence\-after\-load=\fR\fIyes\fR since lfence will be generated
1851 after loading branch target register.
1852 .IP \fB\-mlfence\-before\-ret=\fR\fInone\fR 4
1853 .IX Item "-mlfence-before-ret=none"
1854 .PD 0
1855 .IP \fB\-mlfence\-before\-ret=\fR\fIshl\fR 4
1856 .IX Item "-mlfence-before-ret=shl"
1857 .IP \fB\-mlfence\-before\-ret=\fR\fIor\fR 4
1858 .IX Item "-mlfence-before-ret=or"
1859 .IP \fB\-mlfence\-before\-ret=\fR\fIyes\fR 4
1860 .IX Item "-mlfence-before-ret=yes"
1861 .IP \fB\-mlfence\-before\-ret=\fR\fInot\fR 4
1862 .IX Item "-mlfence-before-ret=not"
1863 .PD
1864 These options control whether the assembler should generate lfence
1865 before ret. \fB\-mlfence\-before\-ret=\fR\fIor\fR will generate
1866 generate or instruction with lfence.
1867 \&\fB\-mlfence\-before\-ret=\fR\fIshl/yes\fR will generate shl instruction
1868 with lfence. \fB\-mlfence\-before\-ret=\fR\fInot\fR will generate not
1869 instruction with lfence. \fB\-mlfence\-before\-ret=\fR\fInone\fR will not
1870 generate lfence, which is the default.
1871 .IP \fB\-mx86\-used\-note=\fR\fIno\fR 4
1872 .IX Item "-mx86-used-note=no"
1873 .PD 0
1874 .IP \fB\-mx86\-used\-note=\fR\fIyes\fR 4
1875 .IX Item "-mx86-used-note=yes"
1876 .PD
1877 These options control whether the assembler should generate
1878 GNU_PROPERTY_X86_ISA_1_USED and GNU_PROPERTY_X86_FEATURE_2_USED
1879 GNU property notes. The default can be controlled by the
1880 \&\fB\-\-enable\-x86\-used\-note\fR configure option.
1881 .IP \fB\-mevexrcig=\fR\fIrne\fR 4
1882 .IX Item "-mevexrcig=rne"
1883 .PD 0
1884 .IP \fB\-mevexrcig=\fR\fIrd\fR 4
1885 .IX Item "-mevexrcig=rd"
1886 .IP \fB\-mevexrcig=\fR\fIru\fR 4
1887 .IX Item "-mevexrcig=ru"
1888 .IP \fB\-mevexrcig=\fR\fIrz\fR 4
1889 .IX Item "-mevexrcig=rz"
1890 .PD
1891 These options control how the assembler should encode SAE\-only
1892 EVEX instructions. \fB\-mevexrcig=\fR\fIrne\fR will encode RC bits
1893 of EVEX instruction with 00, which is the default.
1894 \&\fB\-mevexrcig=\fR\fIrd\fR, \fB\-mevexrcig=\fR\fIru\fR
1895 and \fB\-mevexrcig=\fR\fIrz\fR will encode SAE\-only EVEX instructions
1896 with 01, 10 and 11 RC bits, respectively.
1897 .IP \fB\-mamd64\fR 4
1898 .IX Item "-mamd64"
1899 .PD 0
1900 .IP \fB\-mintel64\fR 4
1901 .IX Item "-mintel64"
1902 .PD
1903 This option specifies that the assembler should accept only AMD64 or
1904 Intel64 ISA in 64\-bit mode. The default is to accept common, Intel64
1905 only and AMD64 ISAs.
1906 .IP "\fB\-O0 | \-O | \-O1 | \-O2 | \-Os\fR" 4
1907 .IX Item "-O0 | -O | -O1 | -O2 | -Os"
1908 Optimize instruction encoding with smaller instruction size. \fB\-O\fR
1909 and \fB\-O1\fR encode 64\-bit register load instructions with 64\-bit
1910 immediate as 32\-bit register load instructions with 31\-bit or 32\-bits
1911 immediates, encode 64\-bit register clearing instructions with 32\-bit
1912 register clearing instructions, encode 256\-bit/512\-bit VEX/EVEX vector
1913 register clearing instructions with 128\-bit VEX vector register
1914 clearing instructions, encode 128\-bit/256\-bit EVEX vector
1915 register load/store instructions with VEX vector register load/store
1916 instructions, and encode 128\-bit/256\-bit EVEX packed integer logical
1917 instructions with 128\-bit/256\-bit VEX packed integer logical.
1918 .Sp
1919 \&\fB\-O2\fR includes \fB\-O1\fR optimization plus encodes
1920 256\-bit/512\-bit EVEX vector register clearing instructions with 128\-bit
1921 EVEX vector register clearing instructions. In 64\-bit mode VEX encoded
1922 instructions with commutative source operands will also have their
1923 source operands swapped if this allows using the 2\-byte VEX prefix form
1924 instead of the 3\-byte one. Certain forms of AND as well as OR with the
1925 same (register) operand specified twice will also be changed to TEST.
1926 .Sp
1927 \&\fB\-Os\fR includes \fB\-O2\fR optimization plus encodes 16\-bit, 32\-bit
1928 and 64\-bit register tests with immediate as 8\-bit register test with
1929 immediate. \fB\-O0\fR turns off this optimization.
1930 .PP
1931 The following options are available when as is configured for the
1932 Ubicom IP2K series.
1933 .IP \fB\-mip2022ext\fR 4
1934 .IX Item "-mip2022ext"
1935 Specifies that the extended IP2022 instructions are allowed.
1936 .IP \fB\-mip2022\fR 4
1937 .IX Item "-mip2022"
1938 Restores the default behaviour, which restricts the permitted instructions to
1939 just the basic IP2022 ones.
1940 .PP
1941 The following options are available when as is configured for the
1942 Renesas M32C and M16C processors.
1943 .IP \fB\-m32c\fR 4
1944 .IX Item "-m32c"
1945 Assemble M32C instructions.
1946 .IP \fB\-m16c\fR 4
1947 .IX Item "-m16c"
1948 Assemble M16C instructions (the default).
1949 .IP \fB\-relax\fR 4
1950 .IX Item "-relax"
1951 Enable support for link\-time relaxations.
1952 .IP \fB\-h\-tick\-hex\fR 4
1953 .IX Item "-h-tick-hex"
1954 Support H\*(Aq00 style hex constants in addition to 0x00 style.
1955 .PP
1956 The following options are available when as is configured for the
1957 Renesas M32R (formerly Mitsubishi M32R) series.
1958 .IP \fB\-\-m32rx\fR 4
1959 .IX Item "--m32rx"
1960 Specify which processor in the M32R family is the target. The default
1961 is normally the M32R, but this option changes it to the M32RX.
1962 .IP "\fB\-\-warn\-explicit\-parallel\-conflicts or \-\-Wp\fR" 4
1963 .IX Item "--warn-explicit-parallel-conflicts or --Wp"
1964 Produce warning messages when questionable parallel constructs are
1965 encountered.
1966 .IP "\fB\-\-no\-warn\-explicit\-parallel\-conflicts or \-\-Wnp\fR" 4
1967 .IX Item "--no-warn-explicit-parallel-conflicts or --Wnp"
1968 Do not produce warning messages when questionable parallel constructs are
1969 encountered.
1970 .PP
1971 The following options are available when as is configured for the
1972 Motorola 68000 series.
1973 .IP \fB\-l\fR 4
1974 .IX Item "-l"
1975 Shorten references to undefined symbols, to one word instead of two.
1976 .IP "\fB\-m68000 | \-m68008 | \-m68010 | \-m68020 | \-m68030\fR" 4
1977 .IX Item "-m68000 | -m68008 | -m68010 | -m68020 | -m68030"
1978 .PD 0
1979 .IP "\fB| \-m68040 | \-m68060 | \-m68302 | \-m68331 | \-m68332\fR" 4
1980 .IX Item "| -m68040 | -m68060 | -m68302 | -m68331 | -m68332"
1981 .IP "\fB| \-m68333 | \-m68340 | \-mcpu32 | \-m5200\fR" 4
1982 .IX Item "| -m68333 | -m68340 | -mcpu32 | -m5200"
1983 .PD
1984 Specify what processor in the 68000 family is the target. The default
1985 is normally the 68020, but this can be changed at configuration time.
1986 .IP "\fB\-m68881 | \-m68882 | \-mno\-68881 | \-mno\-68882\fR" 4
1987 .IX Item "-m68881 | -m68882 | -mno-68881 | -mno-68882"
1988 The target machine does (or does not) have a floating\-point coprocessor.
1989 The default is to assume a coprocessor for 68020, 68030, and cpu32. Although
1990 the basic 68000 is not compatible with the 68881, a combination of the
1991 two can be specified, since it\*(Aqs possible to do emulation of the
1992 coprocessor instructions with the main processor.
1993 .IP "\fB\-m68851 | \-mno\-68851\fR" 4
1994 .IX Item "-m68851 | -mno-68851"
1995 The target machine does (or does not) have a memory\-management
1996 unit coprocessor. The default is to assume an MMU for 68020 and up.
1997 .PP
1998 For details about the PDP\-11 machine dependent features options,
1999 see \fBPDP\-11\-Options\fR.
2000 .IP "\fB\-mpic | \-mno\-pic\fR" 4
2001 .IX Item "-mpic | -mno-pic"
2002 Generate position\-independent (or position\-dependent) code. The
2003 default is \fB\-mpic\fR.
2004 .IP \fB\-mall\fR 4
2005 .IX Item "-mall"
2006 .PD 0
2007 .IP \fB\-mall\-extensions\fR 4
2008 .IX Item "-mall-extensions"
2009 .PD
2010 Enable all instruction set extensions. This is the default.
2011 .IP \fB\-mno\-extensions\fR 4
2012 .IX Item "-mno-extensions"
2013 Disable all instruction set extensions.
2014 .IP "\fB\-m\fR\fIextension\fR \fB| \-mno\-\fR\fIextension\fR" 4
2015 .IX Item "-mextension | -mno-extension"
2016 Enable (or disable) a particular instruction set extension.
2017 .IP \fB\-m\fR\fIcpu\fR 4
2018 .IX Item "-mcpu"
2019 Enable the instruction set extensions supported by a particular CPU, and
2020 disable all other extensions.
2021 .IP \fB\-m\fR\fImachine\fR 4
2022 .IX Item "-mmachine"
2023 Enable the instruction set extensions supported by a particular machine
2024 model, and disable all other extensions.
2025 .PP
2026 The following options are available when as is configured for
2027 a picoJava processor.
2028 .IP \fB\-mb\fR 4
2029 .IX Item "-mb"
2030 Generate "big endian" format output.
2031 .IP \fB\-ml\fR 4
2032 .IX Item "-ml"
2033 Generate "little endian" format output.
2034 .PP
2035 The following options are available when as is configured for a
2036 PRU processor.
2037 .IP \fB\-mlink\-relax\fR 4
2038 .IX Item "-mlink-relax"
2039 Assume that LD would optimize LDI32 instructions by checking the upper
2040 16 bits of the \fIexpression\fR. If they are all zeros, then LD would
2041 shorten the LDI32 instruction to a single LDI. In such case \f(CW\*(C`as\*(C'\fR
2042 will output DIFF relocations for diff expressions.
2043 .IP \fB\-mno\-link\-relax\fR 4
2044 .IX Item "-mno-link-relax"
2045 Assume that LD would not optimize LDI32 instructions. As a consequence,
2046 DIFF relocations will not be emitted.
2047 .IP \fB\-mno\-warn\-regname\-label\fR 4
2048 .IX Item "-mno-warn-regname-label"
2049 Do not warn if a label name matches a register name. Usually assembler
2050 programmers will want this warning to be emitted. C compilers may want
2051 to turn this off.
2052 .PP
2053 The following options are available when as is configured for
2054 a MIPS processor.
2055 .IP "\fB\-G\fR \fInum\fR" 4
2056 .IX Item "-G num"
2057 This option sets the largest size of an object that can be referenced
2058 implicitly with the \f(CW\*(C`gp\*(C'\fR register. It is only accepted for targets that
2059 use ECOFF format, such as a DECstation running Ultrix. The default value is 8.
2060 .IP \fB\-EB\fR 4
2061 .IX Item "-EB"
2062 Generate "big endian" format output.
2063 .IP \fB\-EL\fR 4
2064 .IX Item "-EL"
2065 Generate "little endian" format output.
2066 .IP \fB\-mips1\fR 4
2067 .IX Item "-mips1"
2068 .PD 0
2069 .IP \fB\-mips2\fR 4
2070 .IX Item "-mips2"
2071 .IP \fB\-mips3\fR 4
2072 .IX Item "-mips3"
2073 .IP \fB\-mips4\fR 4
2074 .IX Item "-mips4"
2075 .IP \fB\-mips5\fR 4
2076 .IX Item "-mips5"
2077 .IP \fB\-mips32\fR 4
2078 .IX Item "-mips32"
2079 .IP \fB\-mips32r2\fR 4
2080 .IX Item "-mips32r2"
2081 .IP \fB\-mips32r3\fR 4
2082 .IX Item "-mips32r3"
2083 .IP \fB\-mips32r5\fR 4
2084 .IX Item "-mips32r5"
2085 .IP \fB\-mips32r6\fR 4
2086 .IX Item "-mips32r6"
2087 .IP \fB\-mips64\fR 4
2088 .IX Item "-mips64"
2089 .IP \fB\-mips64r2\fR 4
2090 .IX Item "-mips64r2"
2091 .IP \fB\-mips64r3\fR 4
2092 .IX Item "-mips64r3"
2093 .IP \fB\-mips64r5\fR 4
2094 .IX Item "-mips64r5"
2095 .IP \fB\-mips64r6\fR 4
2096 .IX Item "-mips64r6"
2097 .PD
2098 Generate code for a particular MIPS Instruction Set Architecture level.
2099 \&\fB\-mips1\fR is an alias for \fB\-march=r3000\fR, \fB\-mips2\fR is an
2100 alias for \fB\-march=r6000\fR, \fB\-mips3\fR is an alias for
2101 \&\fB\-march=r4000\fR and \fB\-mips4\fR is an alias for \fB\-march=r8000\fR.
2102 \&\fB\-mips5\fR, \fB\-mips32\fR, \fB\-mips32r2\fR, \fB\-mips32r3\fR,
2103 \&\fB\-mips32r5\fR, \fB\-mips32r6\fR, \fB\-mips64\fR, \fB\-mips64r2\fR,
2104 \&\fB\-mips64r3\fR, \fB\-mips64r5\fR, and \fB\-mips64r6\fR correspond to generic
2105 MIPS V, MIPS32, MIPS32 Release 2, MIPS32 Release 3, MIPS32 Release 5, MIPS32
2106 Release 6, MIPS64, MIPS64 Release 2, MIPS64 Release 3, MIPS64 Release 5, and
2107 MIPS64 Release 6 ISA processors, respectively.
2108 .IP \fB\-march=\fR\fIcpu\fR 4
2109 .IX Item "-march=cpu"
2110 Generate code for a particular MIPS CPU.
2111 .IP \fB\-mtune=\fR\fIcpu\fR 4
2112 .IX Item "-mtune=cpu"
2113 Schedule and tune for a particular MIPS CPU.
2114 .IP \fB\-mfix7000\fR 4
2115 .IX Item "-mfix7000"
2116 .PD 0
2117 .IP \fB\-mno\-fix7000\fR 4
2118 .IX Item "-mno-fix7000"
2119 .PD
2120 Cause nops to be inserted if the read of the destination register
2121 of an mfhi or mflo instruction occurs in the following two instructions.
2122 .IP \fB\-mfix\-rm7000\fR 4
2123 .IX Item "-mfix-rm7000"
2124 .PD 0
2125 .IP \fB\-mno\-fix\-rm7000\fR 4
2126 .IX Item "-mno-fix-rm7000"
2127 .PD
2128 Cause nops to be inserted if a dmult or dmultu instruction is
2129 followed by a load instruction.
2130 .IP \fB\-mfix\-r5900\fR 4
2131 .IX Item "-mfix-r5900"
2132 .PD 0
2133 .IP \fB\-mno\-fix\-r5900\fR 4
2134 .IX Item "-mno-fix-r5900"
2135 .PD
2136 Do not attempt to schedule the preceding instruction into the delay slot
2137 of a branch instruction placed at the end of a short loop of six
2138 instructions or fewer and always schedule a \f(CW\*(C`nop\*(C'\fR instruction there
2139 instead. The short loop bug under certain conditions causes loops to
2140 execute only once or twice, due to a hardware bug in the R5900 chip.
2141 .IP \fB\-mdebug\fR 4
2142 .IX Item "-mdebug"
2143 .PD 0
2144 .IP \fB\-no\-mdebug\fR 4
2145 .IX Item "-no-mdebug"
2146 .PD
2147 Cause stabs\-style debugging output to go into an ECOFF\-style .mdebug
2148 section instead of the standard ELF .stabs sections.
2149 .IP \fB\-mpdr\fR 4
2150 .IX Item "-mpdr"
2151 .PD 0
2152 .IP \fB\-mno\-pdr\fR 4
2153 .IX Item "-mno-pdr"
2154 .PD
2155 Control generation of \f(CW\*(C`.pdr\*(C'\fR sections.
2156 .IP \fB\-mgp32\fR 4
2157 .IX Item "-mgp32"
2158 .PD 0
2159 .IP \fB\-mfp32\fR 4
2160 .IX Item "-mfp32"
2161 .PD
2162 The register sizes are normally inferred from the ISA and ABI, but these
2163 flags force a certain group of registers to be treated as 32 bits wide at
2164 all times. \fB\-mgp32\fR controls the size of general\-purpose registers
2165 and \fB\-mfp32\fR controls the size of floating\-point registers.
2166 .IP \fB\-mgp64\fR 4
2167 .IX Item "-mgp64"
2168 .PD 0
2169 .IP \fB\-mfp64\fR 4
2170 .IX Item "-mfp64"
2171 .PD
2172 The register sizes are normally inferred from the ISA and ABI, but these
2173 flags force a certain group of registers to be treated as 64 bits wide at
2174 all times. \fB\-mgp64\fR controls the size of general\-purpose registers
2175 and \fB\-mfp64\fR controls the size of floating\-point registers.
2176 .IP \fB\-mfpxx\fR 4
2177 .IX Item "-mfpxx"
2178 The register sizes are normally inferred from the ISA and ABI, but using
2179 this flag in combination with \fB\-mabi=32\fR enables an ABI variant
2180 which will operate correctly with floating\-point registers which are
2181 32 or 64 bits wide.
2182 .IP \fB\-modd\-spreg\fR 4
2183 .IX Item "-modd-spreg"
2184 .PD 0
2185 .IP \fB\-mno\-odd\-spreg\fR 4
2186 .IX Item "-mno-odd-spreg"
2187 .PD
2188 Enable use of floating\-point operations on odd\-numbered single\-precision
2189 registers when supported by the ISA. \fB\-mfpxx\fR implies
2190 \&\fB\-mno\-odd\-spreg\fR, otherwise the default is \fB\-modd\-spreg\fR.
2191 .IP \fB\-mips16\fR 4
2192 .IX Item "-mips16"
2193 .PD 0
2194 .IP \fB\-no\-mips16\fR 4
2195 .IX Item "-no-mips16"
2196 .PD
2197 Generate code for the MIPS 16 processor. This is equivalent to putting
2198 \&\f(CW\*(C`.module mips16\*(C'\fR at the start of the assembly file. \fB\-no\-mips16\fR
2199 turns off this option.
2200 .IP \fB\-mmips16e2\fR 4
2201 .IX Item "-mmips16e2"
2202 .PD 0
2203 .IP \fB\-mno\-mips16e2\fR 4
2204 .IX Item "-mno-mips16e2"
2205 .PD
2206 Enable the use of MIPS16e2 instructions in MIPS16 mode. This is equivalent
2207 to putting \f(CW\*(C`.module mips16e2\*(C'\fR at the start of the assembly file.
2208 \&\fB\-mno\-mips16e2\fR turns off this option.
2209 .IP \fB\-mmicromips\fR 4
2210 .IX Item "-mmicromips"
2211 .PD 0
2212 .IP \fB\-mno\-micromips\fR 4
2213 .IX Item "-mno-micromips"
2214 .PD
2215 Generate code for the microMIPS processor. This is equivalent to putting
2216 \&\f(CW\*(C`.module micromips\*(C'\fR at the start of the assembly file.
2217 \&\fB\-mno\-micromips\fR turns off this option. This is equivalent to putting
2218 \&\f(CW\*(C`.module nomicromips\*(C'\fR at the start of the assembly file.
2219 .IP \fB\-msmartmips\fR 4
2220 .IX Item "-msmartmips"
2221 .PD 0
2222 .IP \fB\-mno\-smartmips\fR 4
2223 .IX Item "-mno-smartmips"
2224 .PD
2225 Enables the SmartMIPS extension to the MIPS32 instruction set. This is
2226 equivalent to putting \f(CW\*(C`.module smartmips\*(C'\fR at the start of the assembly
2227 file. \fB\-mno\-smartmips\fR turns off this option.
2228 .IP \fB\-mips3d\fR 4
2229 .IX Item "-mips3d"
2230 .PD 0
2231 .IP \fB\-no\-mips3d\fR 4
2232 .IX Item "-no-mips3d"
2233 .PD
2234 Generate code for the MIPS\-3D Application Specific Extension.
2235 This tells the assembler to accept MIPS\-3D instructions.
2236 \&\fB\-no\-mips3d\fR turns off this option.
2237 .IP \fB\-mdmx\fR 4
2238 .IX Item "-mdmx"
2239 .PD 0
2240 .IP \fB\-no\-mdmx\fR 4
2241 .IX Item "-no-mdmx"
2242 .PD
2243 Generate code for the MDMX Application Specific Extension.
2244 This tells the assembler to accept MDMX instructions.
2245 \&\fB\-no\-mdmx\fR turns off this option.
2246 .IP \fB\-mdsp\fR 4
2247 .IX Item "-mdsp"
2248 .PD 0
2249 .IP \fB\-mno\-dsp\fR 4
2250 .IX Item "-mno-dsp"
2251 .PD
2252 Generate code for the DSP Release 1 Application Specific Extension.
2253 This tells the assembler to accept DSP Release 1 instructions.
2254 \&\fB\-mno\-dsp\fR turns off this option.
2255 .IP \fB\-mdspr2\fR 4
2256 .IX Item "-mdspr2"
2257 .PD 0
2258 .IP \fB\-mno\-dspr2\fR 4
2259 .IX Item "-mno-dspr2"
2260 .PD
2261 Generate code for the DSP Release 2 Application Specific Extension.
2262 This option implies \fB\-mdsp\fR.
2263 This tells the assembler to accept DSP Release 2 instructions.
2264 \&\fB\-mno\-dspr2\fR turns off this option.
2265 .IP \fB\-mdspr3\fR 4
2266 .IX Item "-mdspr3"
2267 .PD 0
2268 .IP \fB\-mno\-dspr3\fR 4
2269 .IX Item "-mno-dspr3"
2270 .PD
2271 Generate code for the DSP Release 3 Application Specific Extension.
2272 This option implies \fB\-mdsp\fR and \fB\-mdspr2\fR.
2273 This tells the assembler to accept DSP Release 3 instructions.
2274 \&\fB\-mno\-dspr3\fR turns off this option.
2275 .IP \fB\-mmsa\fR 4
2276 .IX Item "-mmsa"
2277 .PD 0
2278 .IP \fB\-mno\-msa\fR 4
2279 .IX Item "-mno-msa"
2280 .PD
2281 Generate code for the MIPS SIMD Architecture Extension.
2282 This tells the assembler to accept MSA instructions.
2283 \&\fB\-mno\-msa\fR turns off this option.
2284 .IP \fB\-mxpa\fR 4
2285 .IX Item "-mxpa"
2286 .PD 0
2287 .IP \fB\-mno\-xpa\fR 4
2288 .IX Item "-mno-xpa"
2289 .PD
2290 Generate code for the MIPS eXtended Physical Address (XPA) Extension.
2291 This tells the assembler to accept XPA instructions.
2292 \&\fB\-mno\-xpa\fR turns off this option.
2293 .IP \fB\-mmt\fR 4
2294 .IX Item "-mmt"
2295 .PD 0
2296 .IP \fB\-mno\-mt\fR 4
2297 .IX Item "-mno-mt"
2298 .PD
2299 Generate code for the MT Application Specific Extension.
2300 This tells the assembler to accept MT instructions.
2301 \&\fB\-mno\-mt\fR turns off this option.
2302 .IP \fB\-mmcu\fR 4
2303 .IX Item "-mmcu"
2304 .PD 0
2305 .IP \fB\-mno\-mcu\fR 4
2306 .IX Item "-mno-mcu"
2307 .PD
2308 Generate code for the MCU Application Specific Extension.
2309 This tells the assembler to accept MCU instructions.
2310 \&\fB\-mno\-mcu\fR turns off this option.
2311 .IP \fB\-mcrc\fR 4
2312 .IX Item "-mcrc"
2313 .PD 0
2314 .IP \fB\-mno\-crc\fR 4
2315 .IX Item "-mno-crc"
2316 .PD
2317 Generate code for the MIPS cyclic redundancy check (CRC) Application
2318 Specific Extension. This tells the assembler to accept CRC instructions.
2319 \&\fB\-mno\-crc\fR turns off this option.
2320 .IP \fB\-mginv\fR 4
2321 .IX Item "-mginv"
2322 .PD 0
2323 .IP \fB\-mno\-ginv\fR 4
2324 .IX Item "-mno-ginv"
2325 .PD
2326 Generate code for the Global INValidate (GINV) Application Specific
2327 Extension. This tells the assembler to accept GINV instructions.
2328 \&\fB\-mno\-ginv\fR turns off this option.
2329 .IP \fB\-mloongson\-mmi\fR 4
2330 .IX Item "-mloongson-mmi"
2331 .PD 0
2332 .IP \fB\-mno\-loongson\-mmi\fR 4
2333 .IX Item "-mno-loongson-mmi"
2334 .PD
2335 Generate code for the Loongson MultiMedia extensions Instructions (MMI)
2336 Application Specific Extension. This tells the assembler to accept MMI
2337 instructions.
2338 \&\fB\-mno\-loongson\-mmi\fR turns off this option.
2339 .IP \fB\-mloongson\-cam\fR 4
2340 .IX Item "-mloongson-cam"
2341 .PD 0
2342 .IP \fB\-mno\-loongson\-cam\fR 4
2343 .IX Item "-mno-loongson-cam"
2344 .PD
2345 Generate code for the Loongson Content Address Memory (CAM) instructions.
2346 This tells the assembler to accept Loongson CAM instructions.
2347 \&\fB\-mno\-loongson\-cam\fR turns off this option.
2348 .IP \fB\-mloongson\-ext\fR 4
2349 .IX Item "-mloongson-ext"
2350 .PD 0
2351 .IP \fB\-mno\-loongson\-ext\fR 4
2352 .IX Item "-mno-loongson-ext"
2353 .PD
2354 Generate code for the Loongson EXTensions (EXT) instructions.
2355 This tells the assembler to accept Loongson EXT instructions.
2356 \&\fB\-mno\-loongson\-ext\fR turns off this option.
2357 .IP \fB\-mloongson\-ext2\fR 4
2358 .IX Item "-mloongson-ext2"
2359 .PD 0
2360 .IP \fB\-mno\-loongson\-ext2\fR 4
2361 .IX Item "-mno-loongson-ext2"
2362 .PD
2363 Generate code for the Loongson EXTensions R2 (EXT2) instructions.
2364 This option implies \fB\-mloongson\-ext\fR.
2365 This tells the assembler to accept Loongson EXT2 instructions.
2366 \&\fB\-mno\-loongson\-ext2\fR turns off this option.
2367 .IP \fB\-minsn32\fR 4
2368 .IX Item "-minsn32"
2369 .PD 0
2370 .IP \fB\-mno\-insn32\fR 4
2371 .IX Item "-mno-insn32"
2372 .PD
2373 Only use 32\-bit instruction encodings when generating code for the
2374 microMIPS processor. This option inhibits the use of any 16\-bit
2375 instructions. This is equivalent to putting \f(CW\*(C`.set insn32\*(C'\fR at
2376 the start of the assembly file. \fB\-mno\-insn32\fR turns off this
2377 option. This is equivalent to putting \f(CW\*(C`.set noinsn32\*(C'\fR at the
2378 start of the assembly file. By default \fB\-mno\-insn32\fR is
2379 selected, allowing all instructions to be used.
2380 .IP \fB\-\-construct\-floats\fR 4
2381 .IX Item "--construct-floats"
2382 .PD 0
2383 .IP \fB\-\-no\-construct\-floats\fR 4
2384 .IX Item "--no-construct-floats"
2385 .PD
2386 The \fB\-\-no\-construct\-floats\fR option disables the construction of
2387 double width floating point constants by loading the two halves of the
2388 value into the two single width floating point registers that make up
2389 the double width register. By default \fB\-\-construct\-floats\fR is
2390 selected, allowing construction of these floating point constants.
2391 .IP \fB\-\-relax\-branch\fR 4
2392 .IX Item "--relax-branch"
2393 .PD 0
2394 .IP \fB\-\-no\-relax\-branch\fR 4
2395 .IX Item "--no-relax-branch"
2396 .PD
2397 The \fB\-\-relax\-branch\fR option enables the relaxation of out\-of\-range
2398 branches. By default \fB\-\-no\-relax\-branch\fR is selected, causing any
2399 out\-of\-range branches to produce an error.
2400 .IP \fB\-mignore\-branch\-isa\fR 4
2401 .IX Item "-mignore-branch-isa"
2402 .PD 0
2403 .IP \fB\-mno\-ignore\-branch\-isa\fR 4
2404 .IX Item "-mno-ignore-branch-isa"
2405 .PD
2406 Ignore branch checks for invalid transitions between ISA modes. The
2407 semantics of branches does not provide for an ISA mode switch, so in
2408 most cases the ISA mode a branch has been encoded for has to be the
2409 same as the ISA mode of the branch\*(Aqs target label. Therefore GAS has
2410 checks implemented that verify in branch assembly that the two ISA
2411 modes match. \fB\-mignore\-branch\-isa\fR disables these checks. By
2412 default \fB\-mno\-ignore\-branch\-isa\fR is selected, causing any invalid
2413 branch requiring a transition between ISA modes to produce an error.
2414 .IP \fB\-mnan=\fR\fIencoding\fR 4
2415 .IX Item "-mnan=encoding"
2416 Select between the IEEE 754\-2008 (\fB\-mnan=2008\fR) or the legacy
2417 (\fB\-mnan=legacy\fR) NaN encoding format. The latter is the default.
2418 .IP \fB\-\-emulation=\fR\fIname\fR 4
2419 .IX Item "--emulation=name"
2420 This option was formerly used to switch between ELF and ECOFF output
2421 on targets like IRIX 5 that supported both. MIPS ECOFF support was
2422 removed in GAS 2.24, so the option now serves little purpose.
2423 It is retained for backwards compatibility.
2424 .Sp
2425 The available configuration names are: \fBmipself\fR, \fBmipslelf\fR and
2426 \&\fBmipsbelf\fR. Choosing \fBmipself\fR now has no effect, since the output
2427 is always ELF. \fBmipslelf\fR and \fBmipsbelf\fR select little\- and
2428 big\-endian output respectively, but \fB\-EL\fR and \fB\-EB\fR are now the
2429 preferred options instead.
2430 .IP \fB\-nocpp\fR 4
2431 .IX Item "-nocpp"
2432 \&\fBas\fR ignores this option. It is accepted for compatibility with
2433 the native tools.
2434 .IP \fB\-\-trap\fR 4
2435 .IX Item "--trap"
2436 .PD 0
2437 .IP \fB\-\-no\-trap\fR 4
2438 .IX Item "--no-trap"
2439 .IP \fB\-\-break\fR 4
2440 .IX Item "--break"
2441 .IP \fB\-\-no\-break\fR 4
2442 .IX Item "--no-break"
2443 .PD
2444 Control how to deal with multiplication overflow and division by zero.
2445 \&\fB\-\-trap\fR or \fB\-\-no\-break\fR (which are synonyms) take a trap exception
2446 (and only work for Instruction Set Architecture level 2 and higher);
2447 \&\fB\-\-break\fR or \fB\-\-no\-trap\fR (also synonyms, and the default) take a
2448 break exception.
2449 .IP \fB\-n\fR 4
2450 .IX Item "-n"
2451 When this option is used, \fBas\fR will issue a warning every
2452 time it generates a nop instruction from a macro.
2453 .PP
2454 The following options are available when as is configured for a
2455 LoongArch processor.
2456 .IP \fB\-fpic\fR 4
2457 .IX Item "-fpic"
2458 .PD 0
2459 .IP \fB\-fPIC\fR 4
2460 .IX Item "-fPIC"
2461 .PD
2462 Generate position\-independent code
2463 .IP \fB\-fno\-pic\fR 4
2464 .IX Item "-fno-pic"
2465 Don\*(Aqt generate position\-independent code (default)
2466 .PP
2467 The following options are available when as is configured for a
2468 Meta processor.
2469 .ie n .IP """\-mcpu=metac11""" 4
2470 .el .IP \f(CW\-mcpu=metac11\fR 4
2471 .IX Item "-mcpu=metac11"
2472 Generate code for Meta 1.1.
2473 .ie n .IP """\-mcpu=metac12""" 4
2474 .el .IP \f(CW\-mcpu=metac12\fR 4
2475 .IX Item "-mcpu=metac12"
2476 Generate code for Meta 1.2.
2477 .ie n .IP """\-mcpu=metac21""" 4
2478 .el .IP \f(CW\-mcpu=metac21\fR 4
2479 .IX Item "-mcpu=metac21"
2480 Generate code for Meta 2.1.
2481 .ie n .IP """\-mfpu=metac21""" 4
2482 .el .IP \f(CW\-mfpu=metac21\fR 4
2483 .IX Item "-mfpu=metac21"
2484 Allow code to use FPU hardware of Meta 2.1.
2485 .PP
2486 See the info pages for documentation of the MMIX\-specific options.
2487 .PP
2488 The following options are available when as is configured for a
2489 NDS32 processor.
2490 .ie n .IP """\-O1""" 4
2491 .el .IP \f(CW\-O1\fR 4
2492 .IX Item "-O1"
2493 Optimize for performance.
2494 .ie n .IP """\-Os""" 4
2495 .el .IP \f(CW\-Os\fR 4
2496 .IX Item "-Os"
2497 Optimize for space.
2498 .ie n .IP """\-EL""" 4
2499 .el .IP \f(CW\-EL\fR 4
2500 .IX Item "-EL"
2501 Produce little endian data output.
2502 .ie n .IP """\-EB""" 4
2503 .el .IP \f(CW\-EB\fR 4
2504 .IX Item "-EB"
2505 Produce little endian data output.
2506 .ie n .IP """\-mpic""" 4
2507 .el .IP \f(CW\-mpic\fR 4
2508 .IX Item "-mpic"
2509 Generate PIC.
2510 .ie n .IP """\-mno\-fp\-as\-gp\-relax""" 4
2511 .el .IP \f(CW\-mno\-fp\-as\-gp\-relax\fR 4
2512 .IX Item "-mno-fp-as-gp-relax"
2513 Suppress fp\-as\-gp relaxation for this file.
2514 .ie n .IP """\-mb2bb\-relax""" 4
2515 .el .IP \f(CW\-mb2bb\-relax\fR 4
2516 .IX Item "-mb2bb-relax"
2517 Back\-to\-back branch optimization.
2518 .ie n .IP """\-mno\-all\-relax""" 4
2519 .el .IP \f(CW\-mno\-all\-relax\fR 4
2520 .IX Item "-mno-all-relax"
2521 Suppress all relaxation for this file.
2522 .ie n .IP """\-march=<arch name>""" 4
2523 .el .IP "\f(CW\-march=<arch name>\fR" 4
2524 .IX Item "-march=<arch name>"
2525 Assemble for architecture <arch name> which could be v3, v3j, v3m, v3f,
2526 v3s, v2, v2j, v2f, v2s.
2527 .ie n .IP """\-mbaseline=<baseline>""" 4
2528 .el .IP \f(CW\-mbaseline=<baseline>\fR 4
2529 .IX Item "-mbaseline=<baseline>"
2530 Assemble for baseline <baseline> which could be v2, v3, v3m.
2531 .ie n .IP """\-mfpu\-freg=\fIFREG\fR""" 4
2532 .el .IP \f(CW\-mfpu\-freg=\fR\f(CIFREG\fR\f(CW\fR 4
2533 .IX Item "-mfpu-freg=FREG"
2534 Specify a FPU configuration.
2535 .RS 4
2536 .ie n .IP """0 8 SP / 4 DP registers""" 4
2537 .el .IP "\f(CW0 8 SP / 4 DP registers\fR" 4
2538 .IX Item "0 8 SP / 4 DP registers"
2539 .PD 0
2540 .ie n .IP """1 16 SP / 8 DP registers""" 4
2541 .el .IP "\f(CW1 16 SP / 8 DP registers\fR" 4
2542 .IX Item "1 16 SP / 8 DP registers"
2543 .ie n .IP """2 32 SP / 16 DP registers""" 4
2544 .el .IP "\f(CW2 32 SP / 16 DP registers\fR" 4
2545 .IX Item "2 32 SP / 16 DP registers"
2546 .ie n .IP """3 32 SP / 32 DP registers""" 4
2547 .el .IP "\f(CW3 32 SP / 32 DP registers\fR" 4
2548 .IX Item "3 32 SP / 32 DP registers"
2549 .PD
2550 .RE
2551 .RS 4
2552 .RE
2553 .ie n .IP """\-mabi=\fIabi\fR""" 4
2554 .el .IP \f(CW\-mabi=\fR\f(CIabi\fR\f(CW\fR 4
2555 .IX Item "-mabi=abi"
2556 Specify a abi version <abi> could be v1, v2, v2fp, v2fpp.
2557 .ie n .IP """\-m[no\-]mac""" 4
2558 .el .IP \f(CW\-m[no\-]mac\fR 4
2559 .IX Item "-m[no-]mac"
2560 Enable/Disable Multiply instructions support.
2561 .ie n .IP """\-m[no\-]div""" 4
2562 .el .IP \f(CW\-m[no\-]div\fR 4
2563 .IX Item "-m[no-]div"
2564 Enable/Disable Divide instructions support.
2565 .ie n .IP """\-m[no\-]16bit\-ext""" 4
2566 .el .IP \f(CW\-m[no\-]16bit\-ext\fR 4
2567 .IX Item "-m[no-]16bit-ext"
2568 Enable/Disable 16\-bit extension
2569 .ie n .IP """\-m[no\-]dx\-regs""" 4
2570 .el .IP \f(CW\-m[no\-]dx\-regs\fR 4
2571 .IX Item "-m[no-]dx-regs"
2572 Enable/Disable d0/d1 registers
2573 .ie n .IP """\-m[no\-]perf\-ext""" 4
2574 .el .IP \f(CW\-m[no\-]perf\-ext\fR 4
2575 .IX Item "-m[no-]perf-ext"
2576 Enable/Disable Performance extension
2577 .ie n .IP """\-m[no\-]perf2\-ext""" 4
2578 .el .IP \f(CW\-m[no\-]perf2\-ext\fR 4
2579 .IX Item "-m[no-]perf2-ext"
2580 Enable/Disable Performance extension 2
2581 .ie n .IP """\-m[no\-]string\-ext""" 4
2582 .el .IP \f(CW\-m[no\-]string\-ext\fR 4
2583 .IX Item "-m[no-]string-ext"
2584 Enable/Disable String extension
2585 .ie n .IP """\-m[no\-]reduced\-regs""" 4
2586 .el .IP \f(CW\-m[no\-]reduced\-regs\fR 4
2587 .IX Item "-m[no-]reduced-regs"
2588 Enable/Disable Reduced Register configuration (GPR16) option
2589 .ie n .IP """\-m[no\-]audio\-isa\-ext""" 4
2590 .el .IP \f(CW\-m[no\-]audio\-isa\-ext\fR 4
2591 .IX Item "-m[no-]audio-isa-ext"
2592 Enable/Disable AUDIO ISA extension
2593 .ie n .IP """\-m[no\-]fpu\-sp\-ext""" 4
2594 .el .IP \f(CW\-m[no\-]fpu\-sp\-ext\fR 4
2595 .IX Item "-m[no-]fpu-sp-ext"
2596 Enable/Disable FPU SP extension
2597 .ie n .IP """\-m[no\-]fpu\-dp\-ext""" 4
2598 .el .IP \f(CW\-m[no\-]fpu\-dp\-ext\fR 4
2599 .IX Item "-m[no-]fpu-dp-ext"
2600 Enable/Disable FPU DP extension
2601 .ie n .IP """\-m[no\-]fpu\-fma""" 4
2602 .el .IP \f(CW\-m[no\-]fpu\-fma\fR 4
2603 .IX Item "-m[no-]fpu-fma"
2604 Enable/Disable FPU fused\-multiply\-add instructions
2605 .ie n .IP """\-mall\-ext""" 4
2606 .el .IP \f(CW\-mall\-ext\fR 4
2607 .IX Item "-mall-ext"
2608 Turn on all extensions and instructions support
2609 .PP
2610 The following options are available when as is configured for a
2611 PowerPC processor.
2612 .IP \fB\-a32\fR 4
2613 .IX Item "-a32"
2614 Generate ELF32 or XCOFF32.
2615 .IP \fB\-a64\fR 4
2616 .IX Item "-a64"
2617 Generate ELF64 or XCOFF64.
2618 .IP "\fB\-K PIC\fR" 4
2619 .IX Item "-K PIC"
2620 Set EF_PPC_RELOCATABLE_LIB in ELF flags.
2621 .IP "\fB\-mpwrx | \-mpwr2\fR" 4
2622 .IX Item "-mpwrx | -mpwr2"
2623 Generate code for POWER/2 (RIOS2).
2624 .IP \fB\-mpwr\fR 4
2625 .IX Item "-mpwr"
2626 Generate code for POWER (RIOS1)
2627 .IP \fB\-m601\fR 4
2628 .IX Item "-m601"
2629 Generate code for PowerPC 601.
2630 .IP "\fB\-mppc, \-mppc32, \-m603, \-m604\fR" 4
2631 .IX Item "-mppc, -mppc32, -m603, -m604"
2632 Generate code for PowerPC 603/604.
2633 .IP "\fB\-m403, \-m405\fR" 4
2634 .IX Item "-m403, -m405"
2635 Generate code for PowerPC 403/405.
2636 .IP \fB\-m440\fR 4
2637 .IX Item "-m440"
2638 Generate code for PowerPC 440. BookE and some 405 instructions.
2639 .IP \fB\-m464\fR 4
2640 .IX Item "-m464"
2641 Generate code for PowerPC 464.
2642 .IP \fB\-m476\fR 4
2643 .IX Item "-m476"
2644 Generate code for PowerPC 476.
2645 .IP "\fB\-m7400, \-m7410, \-m7450, \-m7455\fR" 4
2646 .IX Item "-m7400, -m7410, -m7450, -m7455"
2647 Generate code for PowerPC 7400/7410/7450/7455.
2648 .IP "\fB\-m750cl, \-mgekko, \-mbroadway\fR" 4
2649 .IX Item "-m750cl, -mgekko, -mbroadway"
2650 Generate code for PowerPC 750CL/Gekko/Broadway.
2651 .IP "\fB\-m821, \-m850, \-m860\fR" 4
2652 .IX Item "-m821, -m850, -m860"
2653 Generate code for PowerPC 821/850/860.
2654 .IP "\fB\-mppc64, \-m620\fR" 4
2655 .IX Item "-mppc64, -m620"
2656 Generate code for PowerPC 620/625/630.
2657 .IP "\fB\-me200z2, \-me200z4\fR" 4
2658 .IX Item "-me200z2, -me200z4"
2659 Generate code for e200 variants, e200z2 with LSP, e200z4 with SPE.
2660 .IP \fB\-me300\fR 4
2661 .IX Item "-me300"
2662 Generate code for PowerPC e300 family.
2663 .IP "\fB\-me500, \-me500x2\fR" 4
2664 .IX Item "-me500, -me500x2"
2665 Generate code for Motorola e500 core complex.
2666 .IP \fB\-me500mc\fR 4
2667 .IX Item "-me500mc"
2668 Generate code for Freescale e500mc core complex.
2669 .IP \fB\-me500mc64\fR 4
2670 .IX Item "-me500mc64"
2671 Generate code for Freescale e500mc64 core complex.
2672 .IP \fB\-me5500\fR 4
2673 .IX Item "-me5500"
2674 Generate code for Freescale e5500 core complex.
2675 .IP \fB\-me6500\fR 4
2676 .IX Item "-me6500"
2677 Generate code for Freescale e6500 core complex.
2678 .IP \fB\-mlsp\fR 4
2679 .IX Item "-mlsp"
2680 Enable LSP instructions. (Disables SPE and SPE2.)
2681 .IP \fB\-mspe\fR 4
2682 .IX Item "-mspe"
2683 Generate code for Motorola SPE instructions. (Disables LSP.)
2684 .IP \fB\-mspe2\fR 4
2685 .IX Item "-mspe2"
2686 Generate code for Freescale SPE2 instructions. (Disables LSP.)
2687 .IP \fB\-mtitan\fR 4
2688 .IX Item "-mtitan"
2689 Generate code for AppliedMicro Titan core complex.
2690 .IP \fB\-mppc64bridge\fR 4
2691 .IX Item "-mppc64bridge"
2692 Generate code for PowerPC 64, including bridge insns.
2693 .IP \fB\-mbooke\fR 4
2694 .IX Item "-mbooke"
2695 Generate code for 32\-bit BookE.
2696 .IP \fB\-ma2\fR 4
2697 .IX Item "-ma2"
2698 Generate code for A2 architecture.
2699 .IP \fB\-maltivec\fR 4
2700 .IX Item "-maltivec"
2701 Generate code for processors with AltiVec instructions.
2702 .IP \fB\-mvle\fR 4
2703 .IX Item "-mvle"
2704 Generate code for Freescale PowerPC VLE instructions.
2705 .IP \fB\-mvsx\fR 4
2706 .IX Item "-mvsx"
2707 Generate code for processors with Vector\-Scalar (VSX) instructions.
2708 .IP \fB\-mhtm\fR 4
2709 .IX Item "-mhtm"
2710 Generate code for processors with Hardware Transactional Memory instructions.
2711 .IP "\fB\-mpower4, \-mpwr4\fR" 4
2712 .IX Item "-mpower4, -mpwr4"
2713 Generate code for Power4 architecture.
2714 .IP "\fB\-mpower5, \-mpwr5, \-mpwr5x\fR" 4
2715 .IX Item "-mpower5, -mpwr5, -mpwr5x"
2716 Generate code for Power5 architecture.
2717 .IP "\fB\-mpower6, \-mpwr6\fR" 4
2718 .IX Item "-mpower6, -mpwr6"
2719 Generate code for Power6 architecture.
2720 .IP "\fB\-mpower7, \-mpwr7\fR" 4
2721 .IX Item "-mpower7, -mpwr7"
2722 Generate code for Power7 architecture.
2723 .IP "\fB\-mpower8, \-mpwr8\fR" 4
2724 .IX Item "-mpower8, -mpwr8"
2725 Generate code for Power8 architecture.
2726 .IP "\fB\-mpower9, \-mpwr9\fR" 4
2727 .IX Item "-mpower9, -mpwr9"
2728 Generate code for Power9 architecture.
2729 .IP "\fB\-mpower10, \-mpwr10\fR" 4
2730 .IX Item "-mpower10, -mpwr10"
2731 Generate code for Power10 architecture.
2732 .IP "\fB\-mpower11, \-mpwr11\fR" 4
2733 .IX Item "-mpower11, -mpwr11"
2734 Generate code for Power11 architecture.
2735 .IP \fB\-mfuture\fR 4
2736 .IX Item "-mfuture"
2737 Generate code for \*(Aqfuture\*(Aq architecture.
2738 .IP \fB\-mcell\fR 4
2739 .IX Item "-mcell"
2740 .PD 0
2741 .IP \fB\-mcell\fR 4
2742 .IX Item "-mcell"
2743 .PD
2744 Generate code for Cell Broadband Engine architecture.
2745 .IP \fB\-mcom\fR 4
2746 .IX Item "-mcom"
2747 Generate code Power/PowerPC common instructions.
2748 .IP \fB\-many\fR 4
2749 .IX Item "-many"
2750 Generate code for any architecture (PWR/PWRX/PPC).
2751 .IP \fB\-mregnames\fR 4
2752 .IX Item "-mregnames"
2753 Allow symbolic names for registers.
2754 .IP \fB\-mno\-regnames\fR 4
2755 .IX Item "-mno-regnames"
2756 Do not allow symbolic names for registers.
2757 .IP \fB\-mrelocatable\fR 4
2758 .IX Item "-mrelocatable"
2759 Support for GCC\*(Aqs \-mrelocatable option.
2760 .IP \fB\-mrelocatable\-lib\fR 4
2761 .IX Item "-mrelocatable-lib"
2762 Support for GCC\*(Aqs \-mrelocatable\-lib option.
2763 .IP \fB\-memb\fR 4
2764 .IX Item "-memb"
2765 Set PPC_EMB bit in ELF flags.
2766 .IP "\fB\-mlittle, \-mlittle\-endian, \-le\fR" 4
2767 .IX Item "-mlittle, -mlittle-endian, -le"
2768 Generate code for a little endian machine.
2769 .IP "\fB\-mbig, \-mbig\-endian, \-be\fR" 4
2770 .IX Item "-mbig, -mbig-endian, -be"
2771 Generate code for a big endian machine.
2772 .IP \fB\-nops=\fR\fIcount\fR 4
2773 .IX Item "-nops=count"
2774 If an alignment directive inserts more than \fIcount\fR nops, put a
2775 branch at the beginning to skip execution of the nops.
2776 .PP
2777 The following options are available when as is configured for a
2778 RISC\-V processor.
2779 .IP \fB\-fpic\fR 4
2780 .IX Item "-fpic"
2781 .PD 0
2782 .IP \fB\-fPIC\fR 4
2783 .IX Item "-fPIC"
2784 .PD
2785 Generate position\-independent code
2786 .IP \fB\-fno\-pic\fR 4
2787 .IX Item "-fno-pic"
2788 Don\*(Aqt generate position\-independent code (default)
2789 .IP \fB\-march=ISA|Profiles|Profiles_ISA\fR 4
2790 .IX Item "-march=ISA|Profiles|Profiles_ISA"
2791 Select the base isa, as specified by ISA or Profiles or Profies_ISA.
2792 For example \fB\-march=rv32ima\fR \fB\-march=RVI20U64\fR
2793 \&\fB\-march=RVI20U64_d\fR.
2794 If this option and the architecture attributes aren\*(Aqt set, then assembler
2795 will check the default configure setting \-\-with\-arch=ISA.
2796 .IP \fB\-misa\-spec=ISAspec\fR 4
2797 .IX Item "-misa-spec=ISAspec"
2798 Select the default isa spec version. If the version of ISA isn\*(Aqt set
2799 by \-march, then assembler helps to set the version according to
2800 the default chosen spec. If this option isn\*(Aqt set, then assembler will
2801 check the default configure setting \-\-with\-isa\-spec=ISAspec.
2802 .IP \fB\-mpriv\-spec=PRIVspec\fR 4
2803 .IX Item "-mpriv-spec=PRIVspec"
2804 Select the privileged spec version. We can decide whether the CSR is valid or
2805 not according to the chosen spec. If this option and the privilege attributes
2806 aren\*(Aqt set, then assembler will check the default configure setting
2807 \&\-\-with\-priv\-spec=PRIVspec.
2808 .IP \fB\-mabi=ABI\fR 4
2809 .IX Item "-mabi=ABI"
2810 Selects the ABI, which is either "ilp32" or "lp64", optionally followed
2811 by "f", "d", or "q" to indicate single\-precision, double\-precision, or
2812 quad\-precision floating\-point calling convention, or none or "e" to indicate
2813 the soft\-float calling convention ("e" indicates a soft\-float RVE ABI).
2814 .IP \fB\-mrelax\fR 4
2815 .IX Item "-mrelax"
2816 Take advantage of linker relaxations to reduce the number of instructions
2817 required to materialize symbol addresses. (default)
2818 .IP \fB\-mno\-relax\fR 4
2819 .IX Item "-mno-relax"
2820 Don\*(Aqt do linker relaxations.
2821 .IP \fB\-march\-attr\fR 4
2822 .IX Item "-march-attr"
2823 Generate the default contents for the riscv elf attribute section if the
2824 \&.attribute directives are not set. This section is used to record the
2825 information that a linker or runtime loader needs to check compatibility.
2826 This information includes ISA string, stack alignment requirement, unaligned
2827 memory accesses, and the major, minor and revision version of privileged
2828 specification.
2829 .IP \fB\-mno\-arch\-attr\fR 4
2830 .IX Item "-mno-arch-attr"
2831 Don\*(Aqt generate the default riscv elf attribute section if the .attribute
2832 directives are not set.
2833 .IP \fB\-mcsr\-check\fR 4
2834 .IX Item "-mcsr-check"
2835 Enable the CSR checking for the ISA\-dependent CRS and the read\-only CSR.
2836 The ISA\-dependent CSR are only valid when the specific ISA is set. The
2837 read\-only CSR can not be written by the CSR instructions.
2838 .IP \fB\-mno\-csr\-check\fR 4
2839 .IX Item "-mno-csr-check"
2840 Don\*(Aqt do CSR checking.
2841 .IP \fB\-mlittle\-endian\fR 4
2842 .IX Item "-mlittle-endian"
2843 Generate code for a little endian machine.
2844 .IP \fB\-mbig\-endian\fR 4
2845 .IX Item "-mbig-endian"
2846 Generate code for a big endian machine.
2847 .PP
2848 See the info pages for documentation of the RX\-specific options.
2849 .PP
2850 The following options are available when as is configured for the s390
2851 processor family.
2852 .IP \fB\-m31\fR 4
2853 .IX Item "-m31"
2854 .PD 0
2855 .IP \fB\-m64\fR 4
2856 .IX Item "-m64"
2857 .PD
2858 Select the word size, either 31/32 bits or 64 bits.
2859 .IP \fB\-mesa\fR 4
2860 .IX Item "-mesa"
2861 .PD 0
2862 .IP \fB\-mzarch\fR 4
2863 .IX Item "-mzarch"
2864 .PD
2865 Select the architecture mode, either the Enterprise System
2866 Architecture (esa) or the z/Architecture mode (zarch).
2867 .IP \fB\-march=\fR\fIprocessor\fR 4
2868 .IX Item "-march=processor"
2869 Specify which s390 processor variant is the target, \fBg5\fR (or
2870 \&\fBarch3\fR), \fBg6\fR, \fBz900\fR (or \fBarch5\fR), \fBz990\fR (or
2871 \&\fBarch6\fR), \fBz9\-109\fR, \fBz9\-ec\fR (or \fBarch7\fR), \fBz10\fR (or
2872 \&\fBarch8\fR), \fBz196\fR (or \fBarch9\fR), \fBzEC12\fR (or \fBarch10\fR),
2873 \&\fBz13\fR (or \fBarch11\fR), \fBz14\fR (or \fBarch12\fR), \fBz15\fR
2874 (or \fBarch13\fR), \fBz16\fR (or \fBarch14\fR), or \fBz17\fR (or
2875 \&\fBarch15\fR).
2876 .IP \fB\-mregnames\fR 4
2877 .IX Item "-mregnames"
2878 .PD 0
2879 .IP \fB\-mno\-regnames\fR 4
2880 .IX Item "-mno-regnames"
2881 .PD
2882 Allow or disallow symbolic names for registers.
2883 .IP \fB\-mwarn\-areg\-zero\fR 4
2884 .IX Item "-mwarn-areg-zero"
2885 Warn whenever the operand for a base or index register has been specified
2886 but evaluates to zero.
2887 .IP \fB\-mwarn\-regtype\-mismatch=strict\fR 4
2888 .IX Item "-mwarn-regtype-mismatch=strict"
2889 .PD 0
2890 .IP \fB\-mwarn\-regtype\-mismatch=relaxed\fR 4
2891 .IX Item "-mwarn-regtype-mismatch=relaxed"
2892 .IP \fB\-mwarn\-regtype\-mismatch=no\fR 4
2893 .IX Item "-mwarn-regtype-mismatch=no"
2894 .IP \fB\-mno\-warn\-regtype\-mismatch\fR 4
2895 .IX Item "-mno-warn-regtype-mismatch"
2896 .PD
2897 Controls whether the assembler performs register name type checks and generates
2898 a warning message in case of a mismatch with the operand register type.
2899 The default (which can be restored by using the \fBrelaxed\fR argument) is
2900 to perform relaxed register name type checks, which allow floating point
2901 register (FPR) names \f(CW%f0\fR to \f(CW%f15\fR to be specified as argument to vector register
2902 (VR) operands and vector register (VR) names \f(CW%v0\fR to \f(CW%v15\fR to be specified as
2903 argument to floating point register (FPR) operands. This is acceptable as the
2904 FPR are embedded into the lower half of the VR.
2905 Using the \fBstrict\fR argument strict register name type checks are
2906 performed.
2907 The \fBno\fR argument, which is equivalent to
2908 \&\fB\-mno\-warn\-regtype\-mismatch\fR, disables any register name type checks.
2909 .PP
2910 The following options are available when as is configured for a
2911 TMS320C6000 processor.
2912 .IP \fB\-march=\fR\fIarch\fR 4
2913 .IX Item "-march=arch"
2914 Enable (only) instructions from architecture \fIarch\fR. By default,
2915 all instructions are permitted.
2916 .Sp
2917 The following values of \fIarch\fR are accepted: \f(CW\*(C`c62x\*(C'\fR,
2918 \&\f(CW\*(C`c64x\*(C'\fR, \f(CW\*(C`c64x+\*(C'\fR, \f(CW\*(C`c67x\*(C'\fR, \f(CW\*(C`c67x+\*(C'\fR, \f(CW\*(C`c674x\*(C'\fR.
2919 .IP \fB\-mdsbt\fR 4
2920 .IX Item "-mdsbt"
2921 .PD 0
2922 .IP \fB\-mno\-dsbt\fR 4
2923 .IX Item "-mno-dsbt"
2924 .PD
2925 The \fB\-mdsbt\fR option causes the assembler to generate the
2926 \&\f(CW\*(C`Tag_ABI_DSBT\*(C'\fR attribute with a value of 1, indicating that the
2927 code is using DSBT addressing. The \fB\-mno\-dsbt\fR option, the
2928 default, causes the tag to have a value of 0, indicating that the code
2929 does not use DSBT addressing. The linker will emit a warning if
2930 objects of different type (DSBT and non\-DSBT) are linked together.
2931 .IP \fB\-mpid=no\fR 4
2932 .IX Item "-mpid=no"
2933 .PD 0
2934 .IP \fB\-mpid=near\fR 4
2935 .IX Item "-mpid=near"
2936 .IP \fB\-mpid=far\fR 4
2937 .IX Item "-mpid=far"
2938 .PD
2939 The \fB\-mpid=\fR option causes the assembler to generate the
2940 \&\f(CW\*(C`Tag_ABI_PID\*(C'\fR attribute with a value indicating the form of data
2941 addressing used by the code. \fB\-mpid=no\fR, the default,
2942 indicates position\-dependent data addressing, \fB\-mpid=near\fR
2943 indicates position\-independent addressing with GOT accesses using near
2944 DP addressing, and \fB\-mpid=far\fR indicates position\-independent
2945 addressing with GOT accesses using far DP addressing. The linker will
2946 emit a warning if objects built with different settings of this option
2947 are linked together.
2948 .IP \fB\-mpic\fR 4
2949 .IX Item "-mpic"
2950 .PD 0
2951 .IP \fB\-mno\-pic\fR 4
2952 .IX Item "-mno-pic"
2953 .PD
2954 The \fB\-mpic\fR option causes the assembler to generate the
2955 \&\f(CW\*(C`Tag_ABI_PIC\*(C'\fR attribute with a value of 1, indicating that the
2956 code is using position\-independent code addressing, The
2957 \&\f(CW\*(C`\-mno\-pic\*(C'\fR option, the default, causes the tag to have a value of
2958 0, indicating position\-dependent code addressing. The linker will
2959 emit a warning if objects of different type (position\-dependent and
2960 position\-independent) are linked together.
2961 .IP \fB\-mbig\-endian\fR 4
2962 .IX Item "-mbig-endian"
2963 .PD 0
2964 .IP \fB\-mlittle\-endian\fR 4
2965 .IX Item "-mlittle-endian"
2966 .PD
2967 Generate code for the specified endianness. The default is
2968 little\-endian.
2969 .PP
2970 The following options are available when as is configured for a TILE\-Gx
2971 processor.
2972 .IP "\fB\-m32 | \-m64\fR" 4
2973 .IX Item "-m32 | -m64"
2974 Select the word size, either 32 bits or 64 bits.
2975 .IP "\fB\-EB | \-EL\fR" 4
2976 .IX Item "-EB | -EL"
2977 Select the endianness, either big\-endian (\-EB) or little\-endian (\-EL).
2978 .PP
2979 The following option is available when as is configured for a Visium
2980 processor.
2981 .IP \fB\-mtune=\fR\fIarch\fR 4
2982 .IX Item "-mtune=arch"
2983 This option specifies the target architecture. If an attempt is made to
2984 assemble an instruction that will not execute on the target architecture,
2985 the assembler will issue an error message.
2986 .Sp
2987 The following names are recognized:
2988 \&\f(CW\*(C`mcm24\*(C'\fR
2989 \&\f(CW\*(C`mcm\*(C'\fR
2990 \&\f(CW\*(C`gr5\*(C'\fR
2991 \&\f(CW\*(C`gr6\*(C'\fR
2992 .PP
2993 The following options are available when as is configured for an
2994 Xtensa processor.
2995 .IP "\fB\-\-text\-section\-literals | \-\-no\-text\-section\-literals\fR" 4
2996 .IX Item "--text-section-literals | --no-text-section-literals"
2997 Control the treatment of literal pools. The default is
2998 \&\fB\-\-no\-text\-section\-literals\fR, which places literals in
2999 separate sections in the output file. This allows the literal pool to be
3000 placed in a data RAM/ROM. With \fB\-\-text\-section\-literals\fR, the
3001 literals are interspersed in the text section in order to keep them as
3002 close as possible to their references. This may be necessary for large
3003 assembly files, where the literals would otherwise be out of range of the
3004 \&\f(CW\*(C`L32R\*(C'\fR instructions in the text section. Literals are grouped into
3005 pools following \f(CW\*(C`.literal_position\*(C'\fR directives or preceding
3006 \&\f(CW\*(C`ENTRY\*(C'\fR instructions. These options only affect literals referenced
3007 via PC\-relative \f(CW\*(C`L32R\*(C'\fR instructions; literals for absolute mode
3008 \&\f(CW\*(C`L32R\*(C'\fR instructions are handled separately.
3009 .IP "\fB\-\-auto\-litpools | \-\-no\-auto\-litpools\fR" 4
3010 .IX Item "--auto-litpools | --no-auto-litpools"
3011 Control the treatment of literal pools. The default is
3012 \&\fB\-\-no\-auto\-litpools\fR, which in the absence of
3013 \&\fB\-\-text\-section\-literals\fR places literals in separate sections
3014 in the output file. This allows the literal pool to be placed in a data
3015 RAM/ROM. With \fB\-\-auto\-litpools\fR, the literals are interspersed
3016 in the text section in order to keep them as close as possible to their
3017 references, explicit \f(CW\*(C`.literal_position\*(C'\fR directives are not
3018 required. This may be necessary for very large functions, where single
3019 literal pool at the beginning of the function may not be reachable by
3020 \&\f(CW\*(C`L32R\*(C'\fR instructions at the end. These options only affect
3021 literals referenced via PC\-relative \f(CW\*(C`L32R\*(C'\fR instructions; literals
3022 for absolute mode \f(CW\*(C`L32R\*(C'\fR instructions are handled separately.
3023 When used together with \fB\-\-text\-section\-literals\fR,
3024 \&\fB\-\-auto\-litpools\fR takes precedence.
3025 .IP "\fB\-\-absolute\-literals | \-\-no\-absolute\-literals\fR" 4
3026 .IX Item "--absolute-literals | --no-absolute-literals"
3027 Indicate to the assembler whether \f(CW\*(C`L32R\*(C'\fR instructions use absolute
3028 or PC\-relative addressing. If the processor includes the absolute
3029 addressing option, the default is to use absolute \f(CW\*(C`L32R\*(C'\fR
3030 relocations. Otherwise, only the PC\-relative \f(CW\*(C`L32R\*(C'\fR relocations
3031 can be used.
3032 .IP "\fB\-\-target\-align | \-\-no\-target\-align\fR" 4
3033 .IX Item "--target-align | --no-target-align"
3034 Enable or disable automatic alignment to reduce branch penalties at some
3035 expense in code size. This optimization is enabled by default. Note
3036 that the assembler will always align instructions like \f(CW\*(C`LOOP\*(C'\fR that
3037 have fixed alignment requirements.
3038 .IP "\fB\-\-longcalls | \-\-no\-longcalls\fR" 4
3039 .IX Item "--longcalls | --no-longcalls"
3040 Enable or disable transformation of call instructions to allow calls
3041 across a greater range of addresses. This option should be used when call
3042 targets can potentially be out of range. It may degrade both code size
3043 and performance, but the linker can generally optimize away the
3044 unnecessary overhead when a call ends up within range. The default is
3045 \&\fB\-\-no\-longcalls\fR.
3046 .IP "\fB\-\-transform | \-\-no\-transform\fR" 4
3047 .IX Item "--transform | --no-transform"
3048 Enable or disable all assembler transformations of Xtensa instructions,
3049 including both relaxation and optimization. The default is
3050 \&\fB\-\-transform\fR; \fB\-\-no\-transform\fR should only be used in the
3051 rare cases when the instructions must be exactly as specified in the
3052 assembly source. Using \fB\-\-no\-transform\fR causes out of range
3053 instruction operands to be errors.
3054 .IP "\fB\-\-rename\-section\fR \fIoldname\fR\fB=\fR\fInewname\fR" 4
3055 .IX Item "--rename-section oldname=newname"
3056 Rename the \fIoldname\fR section to \fInewname\fR. This option can be used
3057 multiple times to rename multiple sections.
3058 .IP "\fB\-\-trampolines | \-\-no\-trampolines\fR" 4
3059 .IX Item "--trampolines | --no-trampolines"
3060 Enable or disable transformation of jump instructions to allow jumps
3061 across a greater range of addresses. This option should be used when jump targets can
3062 potentially be out of range. In the absence of such jumps this option
3063 does not affect code size or performance. The default is
3064 \&\fB\-\-trampolines\fR.
3065 .IP "\fB\-\-abi\-windowed | \-\-abi\-call0\fR" 4
3066 .IX Item "--abi-windowed | --abi-call0"
3067 Choose ABI tag written to the \f(CW\*(C`.xtensa.info\*(C'\fR section. ABI tag
3068 indicates ABI of the assembly code. A warning is issued by the linker
3069 on an attempt to link object files with inconsistent ABI tags.
3070 Default ABI is chosen by the Xtensa core configuration.
3071 .PP
3072 The following options are available when as is configured for an
3073 Z80 processor.
3074 .PP
3075 \&\f(CW@chapter\fR Z80 Dependent Features
3076 .SS "Command\-line Options"
3077 .IX Subsection "Command-line Options"
3078 .IP \fB\-march=\fR\fICPU\fR\fB[\-\fR\fIEXT\fR\fB...][+\fR\fIEXT\fR\fB...]\fR 4
3079 .IX Item "-march=CPU[-EXT...][+EXT...]"
3080 This option specifies the target processor. The assembler will issue
3081 an error message if an attempt is made to assemble an instruction which
3082 will not execute on the target processor. The following processor names
3083 are recognized:
3084 \&\f(CW\*(C`z80\*(C'\fR,
3085 \&\f(CW\*(C`z180\*(C'\fR,
3086 \&\f(CW\*(C`ez80\*(C'\fR,
3087 \&\f(CW\*(C`gbz80\*(C'\fR,
3088 \&\f(CW\*(C`z80n\*(C'\fR,
3089 \&\f(CW\*(C`r800\*(C'\fR.
3090 In addition to the basic instruction set, the assembler can be told to
3091 accept some extension mnemonics. For example,
3092 \&\f(CW\*(C`\-march=z180+sli+infc\*(C'\fR extends \fIz180\fR with \fISLI\fR instructions and
3093 \&\fIIN F,(C)\fR. The following extensions are currently supported:
3094 \&\f(CW\*(C`full\*(C'\fR (all known instructions),
3095 \&\f(CW\*(C`adl\*(C'\fR (ADL CPU mode by default, eZ80 only),
3096 \&\f(CW\*(C`sli\*(C'\fR (instruction known as \fISLI\fR, \fISLL\fR or \fISL1\fR),
3097 \&\f(CW\*(C`xyhl\*(C'\fR (instructions with halves of index registers: \fIIXL\fR, \fIIXH\fR,
3098 \&\fIIYL\fR, \fIIYH\fR),
3099 \&\f(CW\*(C`xdcb\*(C'\fR (instructions like \fIRotOp (II+d),R\fR and \fIBitOp n,(II+d),R\fR),
3100 \&\f(CW\*(C`infc\*(C'\fR (instruction \fIIN F,(C)\fR or \fIIN (C)\fR),
3101 \&\f(CW\*(C`outc0\*(C'\fR (instruction \fIOUT (C),0\fR).
3102 Note that rather than extending a basic instruction set, the extension
3103 mnemonics starting with \f(CW\*(C`\-\*(C'\fR revoke the respective functionality:
3104 \&\f(CW\*(C`\-march=z80\-full+xyhl\*(C'\fR first removes all default extensions and adds
3105 support for index registers halves only.
3106 .Sp
3107 If this option is not specified then \f(CW\*(C`\-march=z80+xyhl+infc\*(C'\fR is assumed.
3108 .IP \fB\-local\-prefix=\fR\fIprefix\fR 4
3109 .IX Item "-local-prefix=prefix"
3110 Mark all labels with specified prefix as local. But such label can be
3111 marked global explicitly in the code. This option do not change default
3112 local label prefix \f(CW\*(C`.L\*(C'\fR, it is just adds new one.
3113 .IP \fB\-colonless\fR 4
3114 .IX Item "-colonless"
3115 Accept colonless labels. All symbols at line begin are treated as labels.
3116 .IP \fB\-sdcc\fR 4
3117 .IX Item "-sdcc"
3118 Accept assembler code produced by SDCC.
3119 .IP \fB\-fp\-s=\fR\fIFORMAT\fR 4
3120 .IX Item "-fp-s=FORMAT"
3121 Single precision floating point numbers format. Default: ieee754 (32 bit).
3122 .IP \fB\-fp\-d=\fR\fIFORMAT\fR 4
3123 .IX Item "-fp-d=FORMAT"
3124 Double precision floating point numbers format. Default: ieee754 (64 bit).
3125 .SH "SEE ALSO"
3126 .IX Header "SEE ALSO"
3127 \&\fBgcc\fR\|(1), \fBld\fR\|(1), and the Info entries for \fIbinutils\fR and \fIld\fR.
3128 .SH COPYRIGHT
3129 .IX Header "COPYRIGHT"
3130 Copyright (c) 1991\-2026 Free Software Foundation, Inc.
3131 .PP
3132 Permission is granted to copy, distribute and/or modify this document
3133 under the terms of the GNU Free Documentation License, Version 1.3
3134 or any later version published by the Free Software Foundation;
3135 with no Invariant Sections, with no Front\-Cover Texts, and with no
3136 Back\-Cover Texts. A copy of the license is included in the
3137 section entitled "GNU Free Documentation License".