Debian Codegraph @

upstream/opensuse-tumbleweed/man1/as.1

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