Debian Codegraph @

upstream/debian-unstable/man1/as.1

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