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