Debian Codegraph @

upstream/debian-trixie/man1/as.1

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