contrib/binutils/gas/doc/as.1

   1 .\" $FreeBSD: src/contrib/binutils/gas/doc/as.1,v 1.2.6.4 2002/09/01 23:44:06 obrien Exp $
   2 .\"
   3 .\"
   4 .\" Automatically generated by Pod::Man v1.3, Pod::Parser v1.13
   5 .\"
   6 .\" Standard preamble:
   7 .\" ========================================================================
   8 .de Sh \" Subsection heading
   9 .br
  10 .if t .Sp
  11 .ne 5
  12 .PP
  13 \fB\\$1\fR
  14 .PP
  15 ..
  16 .de Sp \" Vertical space (when we can't use .PP)
  17 .if t .sp .5v
  18 .if n .sp
  19 ..
  20 .de Vb \" Begin verbatim text
  21 .ft CW
  22 .nf
  23 .ne \\$1
  24 ..
  25 .de Ve \" End verbatim text
  26 .ft R
  27
  28 .fi
  29 ..
  30 .\" Set up some character translations and predefined strings.  \*(-- will
  31 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  32 .\" double quote, and \*(R" will give a right double quote.  | will give a
  33 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
  34 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
  35 .\" expand to `' in nroff, nothing in troff, for use with C<>.
  36 .tr \(*W-|\(bv\*(Tr
  37 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  38 .ie n \{\
  39 .    ds -- \(*W-
  40 .    ds PI pi
  41 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  42 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  43 .    ds L" ""
  44 .    ds R" ""
  45 .    ds C` ""
  46 .    ds C' ""
  47 'br\}
  48 .el\{\
  49 .    ds -- \|\(em\|
  50 .    ds PI \(*p
  51 .    ds L" ``
  52 .    ds R" ''
  53 'br\}
  54 .\"
  55 .\" If the F register is turned on, we'll generate index entries on stderr for
  56 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  57 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  58 .\" output yourself in some meaningful fashion.
  59 .if \nF \{\
  60 .    de IX
  61 .    tm Index:\\$1\t\\n%\t"\\$2"
  62 ..
  63 .    nr % 0
  64 .    rr F
  65 .\}
  66 .\"
  67 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
  68 .\" way too many mistakes in technical documents.
  69 .hy 0
  70 .\"
  71 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  72 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  73 .    \" fudge factors for nroff and troff
  74 .if n \{\
  75 .    ds #H 0
  76 .    ds #V .8m
  77 .    ds #F .3m
  78 .    ds #[ \f1
  79 .    ds #] \fP
  80 .\}
  81 .if t \{\
  82 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  83 .    ds #V .6m
  84 .    ds #F 0
  85 .    ds #[ \&
  86 .    ds #] \&
  87 .\}
  88 .    \" simple accents for nroff and troff
  89 .if n \{\
  90 .    ds ' \&
  91 .    ds ` \&
  92 .    ds ^ \&
  93 .    ds , \&
  94 .    ds ~ ~
  95 .    ds /
  96 .\}
  97 .if t \{\
  98 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  99 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 100 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 101 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 102 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 103 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 104 .\}
 105 .    \" troff and (daisy-wheel) nroff accents
 106 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 107 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 108 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 109 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 110 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 111 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 112 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 113 .ds ae a\h'-(\w'a'u*4/10)'e
 114 .ds Ae A\h'-(\w'A'u*4/10)'E
 115 .    \" corrections for vroff
 116 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 117 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 118 .    \" for low resolution devices (crt and lpr)
 119 .if \n(.H>23 .if \n(.V>19 \
 120 \{\
 121 .    ds : e
 122 .    ds 8 ss
 123 .    ds o a
 124 .    ds d- d\h'-1'\(ga
 125 .    ds D- D\h'-1'\(hy
 126 .    ds th \o'bp'
 127 .    ds Th \o'LP'
 128 .    ds ae ae
 129 .    ds Ae AE
 130 .\}
 131 .rm #[ #] #H #V #F C
 132 .\" ========================================================================
 133 .\"
 134 .IX Title "AS 1"
 135 .TH AS 1 "2002-05-14" "binutils-2.12.1" "GNU Development Tools"
 136 .UC
 137 .SH "NAME"
 138 \&\s-1AS\s0 \- the portable \s-1GNU\s0 assembler.
 139 .SH "SYNOPSIS"
 140 .IX Header "SYNOPSIS"
 141 as [\fB\-a\fR[\fBcdhlns\fR][=\fIfile\fR]] [\fB\-D\fR] [\fB\-\-defsym\fR \fIsym\fR=\fIval\fR]
 142  [\fB\-f\fR] [\fB\-\-gstabs\fR] [\fB\-\-gdwarf2\fR] [\fB\-\-help\fR] [\fB\-I\fR \fIdir\fR]
 143  [\fB\-J\fR] [\fB\-K\fR] [\fB\-L\fR]
 144  [\fB\-\-listing\-lhs\-width\fR=\fI\s-1NUM\s0\fR] [\fB\-\-listing\-lhs\-width2\fR=\fI\s-1NUM\s0\fR]
 145  [\fB\-\-listing\-rhs\-width\fR=\fI\s-1NUM\s0\fR] [\fB\-\-listing\-cont\-lines\fR=\fI\s-1NUM\s0\fR]
 146  [\fB\-\-keep\-locals\fR] [\fB\-o\fR \fIobjfile\fR] [\fB\-R\fR] [\fB\-\-statistics\fR] [\fB\-v\fR]
 147  [\fB\-version\fR] [\fB\-\-version\fR] [\fB\-W\fR] [\fB\-\-warn\fR] [\fB\-\-fatal\-warnings\fR]
 148  [\fB\-w\fR] [\fB\-x\fR] [\fB\-Z\fR] [\fB\-\-target\-help\fR] [\fItarget-options\fR]
 149  [\fB\-\-\fR|\fIfiles\fR ...]
 150 .PP
 151 \&\fITarget Alpha options:\fR
 152    [\fB\-m\fR\fIcpu\fR]
 153    [\fB\-mdebug\fR | \fB\-no\-mdebug\fR]
 154    [\fB\-relax\fR] [\fB\-g\fR] [\fB\-G\fR\fIsize\fR]
 155    [\fB\-F\fR] [\fB\-32addr\fR]
 156 .PP
 157 \&\fITarget \s-1ARC\s0 options:\fR
 158    [\fB\-marc[5|6|7|8]\fR]
 159    [\fB\-EB\fR|\fB\-EL\fR]
 160 .PP
 161 \&\fITarget \s-1ARM\s0 options:\fR
 162    [\fB\-mcpu\fR=\fIprocessor\fR[+\fIextension\fR...]]
 163    [\fB\-march\fR=\fIarchitecture\fR[+\fIextension\fR...]]
 164    [\fB\-mfpu\fR=\fIfloating-point-fromat\fR]
 165    [\fB\-mthumb\fR]
 166    [\fB\-EB\fR|\fB\-EL\fR]
 167    [\fB\-mapcs\-32\fR|\fB\-mapcs\-26\fR|\fB\-mapcs\-float\fR|
 168     \fB\-mapcs\-reentrant\fR]
 169    [\fB\-mthumb\-interwork\fR] [\fB\-moabi\fR] [\fB\-k\fR]
 170 .PP
 171 \&\fITarget \s-1CRIS\s0 options:\fR
 172    [\fB\-\-underscore\fR | \fB\-\-no\-underscore\fR]
 173    [\fB\-\-pic\fR] [\fB\-N\fR]
 174    [\fB\-\-emulation=criself\fR | \fB\-\-emulation=crisaout\fR]
 175 .PP
 176 \&\fITarget D10V options:\fR
 177    [\fB\-O\fR]
 178 .PP
 179 \&\fITarget D30V options:\fR
 180    [\fB\-O\fR|\fB\-n\fR|\fB\-N\fR]
 181 .PP
 182 \&\fITarget i386 options:\fR
 183    [\fB\-\-32\fR|\fB\-\-64\fR]
 184 .PP
 185 \&\fITarget i960 options:\fR
 186    [\fB\-ACA\fR|\fB\-ACA_A\fR|\fB\-ACB\fR|\fB\-ACC\fR|\fB\-AKA\fR|\fB\-AKB\fR|
 187     \fB\-AKC\fR|\fB\-AMC\fR]
 188    [\fB\-b\fR] [\fB\-no\-relax\fR]
 189 .PP
 190 \&\fITarget M32R options:\fR
 191    [\fB\-\-m32rx\fR|\fB\-\-[no\-]warn\-explicit\-parallel\-conflicts\fR|
 192     \fB\-\-W[n]p\fR]
 193 .PP
 194 \&\fITarget M680X0 options:\fR
 195    [\fB\-l\fR] [\fB\-m68000\fR|\fB\-m68010\fR|\fB\-m68020\fR|...]
 196 .PP
 197 \&\fITarget M68HC11 options:\fR
 198    [\fB\-m68hc11\fR|\fB\-m68hc12\fR]
 199    [\fB\-\-force\-long\-branchs\fR] [\fB\-\-short\-branchs\fR]
 200    [\fB\-\-strict\-direct\-mode\fR] [\fB\-\-print\-insn\-syntax\fR]
 201    [\fB\-\-print\-opcodes\fR] [\fB\-\-generate\-example\fR]
 202 .PP
 203 \&\fITarget \s-1MCORE\s0 options:\fR
 204    [\fB\-jsri2bsr\fR] [\fB\-sifilter\fR] [\fB\-relax\fR]
 205    [\fB\-mcpu=[210|340]\fR]
 206 .PP
 207 \&\fITarget \s-1MIPS\s0 options:\fR
 208    [\fB\-nocpp\fR] [\fB\-EL\fR] [\fB\-EB\fR] [\fB\-G\fR \fInum\fR] [\fB\-mcpu\fR=\fI\s-1CPU\s0\fR ]
 209    [\fB\-mips1\fR] [\fB\-mips2\fR] [\fB\-mips3\fR] [\fB\-mips4\fR] [\fB\-mips5\fR]
 210    [\fB\-mips32\fR] [\fB\-mips64\fR]
 211    [\fB\-m4650\fR] [\fB\-no\-m4650\fR]
 212    [\fB\-\-trap\fR] [\fB\-\-break\fR] [\fB\-n\fR]
 213    [\fB\-\-emulation\fR=\fIname\fR ]
 214 .PP
 215 \&\fITarget \s-1MMIX\s0 options:\fR
 216    [\fB\-\-fixed\-special\-register\-names\fR] [\fB\-\-globalize\-symbols\fR]
 217    [\fB\-\-gnu\-syntax\fR] [\fB\-\-relax\fR] [\fB\-\-no\-predefined\-symbols\fR]
 218    [\fB\-\-no\-expand\fR] [\fB\-\-no\-merge\-gregs\fR] [\fB\-x\fR]
 219    [\fB\-\-linker\-allocated\-gregs\fR]
 220 .PP
 221 \&\fITarget \s-1PDP11\s0 options:\fR
 222    [\fB\-mpic\fR|\fB\-mno\-pic\fR] [\fB\-mall\fR] [\fB\-mno\-extensions\fR]
 223    [\fB\-m\fR\fIextension\fR|\fB\-mno\-\fR\fIextension\fR]
 224    [\fB\-m\fR\fIcpu\fR] [\fB\-m\fR\fImachine\fR]
 225 .PP
 226 \&\fITarget picoJava options:\fR
 227    [\fB\-mb\fR|\fB\-me\fR]
 228 .PP
 229 \&\fITarget PowerPC options:\fR
 230    [\fB\-mpwrx\fR|\fB\-mpwr2\fR|\fB\-mpwr\fR|\fB\-m601\fR|\fB\-mppc\fR|\fB\-mppc32\fR|\fB\-m603\fR|\fB\-m604\fR|
 231     \fB\-m403\fR|\fB\-m405\fR|\fB\-mppc64\fR|\fB\-m620\fR|\fB\-mppc64bridge\fR|\fB\-mbooke\fR|
 232     \fB\-mbooke32\fR|\fB\-mbooke64\fR]
 233    [\fB\-mcom\fR|\fB\-many\fR|\fB\-maltivec\fR] [\fB\-memb\fR]
 234    [\fB\-mregnames\fR|\fB\-mno\-regnames\fR]
 235    [\fB\-mrelocatable\fR|\fB\-mrelocatable\-lib\fR]
 236    [\fB\-mlittle\fR|\fB\-mlittle\-endian\fR|\fB\-mbig\fR|\fB\-mbig\-endian\fR]
 237    [\fB\-msolaris\fR|\fB\-mno\-solaris\fR]
 238 .PP
 239 \&\fITarget \s-1SPARC\s0 options:\fR
 240    [\fB\-Av6\fR|\fB\-Av7\fR|\fB\-Av8\fR|\fB\-Asparclet\fR|\fB\-Asparclite\fR
 241     \fB\-Av8plus\fR|\fB\-Av8plusa\fR|\fB\-Av9\fR|\fB\-Av9a\fR]
 242    [\fB\-xarch=v8plus\fR|\fB\-xarch=v8plusa\fR] [\fB\-bump\fR]
 243    [\fB\-32\fR|\fB\-64\fR]
 244 .SH "DESCRIPTION"
 245 .IX Header "DESCRIPTION"
 246 \&\s-1GNU\s0 \fBas\fR is really a family of assemblers.
 247 If you use (or have used) the \s-1GNU\s0 assembler on one architecture, you
 248 should find a fairly similar environment when you use it on another
 249 architecture.  Each version has much in common with the others,
 250 including object file formats, most assembler directives (often called
 251 \&\fIpseudo-ops\fR) and assembler syntax.
 252 .PP
 253 \&\fBas\fR is primarily intended to assemble the output of the
 254 \&\s-1GNU\s0 C compiler  for use by the linker
 255 \&.  Nevertheless, we've tried to make \fBas\fR
 256 assemble correctly everything that other assemblers for the same
 257 machine would assemble.
 258 Any exceptions are documented explicitly.
 259 This doesn't mean \fBas\fR always uses the same syntax as another
 260 assembler for the same architecture; for example, we know of several
 261 incompatible versions of 680x0 assembly language syntax.
 262 .PP
 263 Each time you run \fBas\fR it assembles exactly one source
 264 program.  The source program is made up of one or more files.
 265 (The standard input is also a file.)
 266 .PP
 267 You give \fBas\fR a command line that has zero or more input file
 268 names.  The input files are read (from left file name to right).  A
 269 command line argument (in any position) that has no special meaning
 270 is taken to be an input file name.
 271 .PP
 272 If you give \fBas\fR no file names it attempts to read one input file
 273 from the \fBas\fR standard input, which is normally your terminal.  You
 274 may have to type \fBctl-D\fR to tell \fBas\fR there is no more program
 275 to assemble.
 276 .PP
 277 Use \fB\-\-\fR if you need to explicitly name the standard input file
 278 in your command line.
 279 .PP
 280 If the source is empty, \fBas\fR produces a small, empty object
 281 file.
 282 .PP
 283 \&\fBas\fR may write warnings and error messages to the standard error
 284 file (usually your terminal).  This should not happen when  a compiler
 285 runs \fBas\fR automatically.  Warnings report an assumption made so
 286 that \fBas\fR could keep assembling a flawed program; errors report a
 287 grave problem that stops the assembly.
 288 .PP
 289 If you are invoking \fBas\fR via the \s-1GNU\s0 C compiler (version 2),
 290 you can use the \fB\-Wa\fR option to pass arguments through to the assembler.
 291 The assembler arguments must be separated from each other (and the \fB\-Wa\fR)
 292 by commas.  For example:
 293 .PP
 294 .Vb 1
 295 \&        gcc -c -g -O -Wa,-alh,-L file.c
 296 .Ve
 297 This passes two options to the assembler: \fB\-alh\fR (emit a listing to
 298 standard output with with high-level and assembly source) and \fB\-L\fR (retain
 299 local symbols in the symbol table).
 300 .PP
 301 Usually you do not need to use this \fB\-Wa\fR mechanism, since many compiler
 302 command-line options are automatically passed to the assembler by the compiler.
 303 (You can call the \s-1GNU\s0 compiler driver with the \fB\-v\fR option to see
 304 precisely what options it passes to each compilation pass, including the
 305 assembler.)
 306 .SH "OPTIONS"
 307 .IX Header "OPTIONS"
 308 .IP "\fB\-a[cdhlmns]\fR" 4
 309 .IX Item "-a[cdhlmns]"
 310 Turn on listings, in any of a variety of ways:
 311 .RS 4
 312 .IP "\fB\-ac\fR" 4
 313 .IX Item "-ac"
 314 omit false conditionals
 315 .IP "\fB\-ad\fR" 4
 316 .IX Item "-ad"
 317 omit debugging directives
 318 .IP "\fB\-ah\fR" 4
 319 .IX Item "-ah"
 320 include high-level source
 321 .IP "\fB\-al\fR" 4
 322 .IX Item "-al"
 323 include assembly
 324 .IP "\fB\-am\fR" 4
 325 .IX Item "-am"
 326 include macro expansions
 327 .IP "\fB\-an\fR" 4
 328 .IX Item "-an"
 329 omit forms processing
 330 .IP "\fB\-as\fR" 4
 331 .IX Item "-as"
 332 include symbols
 333 .IP "\fB=file\fR" 4
 334 .IX Item "=file"
 335 set the name of the listing file
 336 .RE
 337 .RS 4
 338 .Sp
 339 You may combine these options; for example, use \fB\-aln\fR for assembly
 340 listing without forms processing.  The \fB=file\fR option, if used, must be
 341 the last one.  By itself, \fB\-a\fR defaults to \fB\-ahls\fR.
 342 .RE
 343 .IP "\fB\-D\fR" 4
 344 .IX Item "-D"
 345 Ignored.  This option is accepted for script compatibility with calls to
 346 other assemblers.
 347 .IP "\fB\-\-defsym\fR \fIsym\fR\fB=\fR\fIvalue\fR" 4
 348 .IX Item "--defsym sym=value"
 349 Define the symbol \fIsym\fR to be \fIvalue\fR before assembling the input file.
 350 \&\fIvalue\fR must be an integer constant.  As in C, a leading \fB0x\fR
 351 indicates a hexadecimal value, and a leading \fB0\fR indicates an octal value.
 352 .IP "\fB\-f\fR" 4
 353 .IX Item "-f"
 354 ``fast''\-\-\-skip whitespace and comment preprocessing (assume source is
 355 compiler output).
 356 .IP "\fB\-\-gstabs\fR" 4
 357 .IX Item "--gstabs"
 358 Generate stabs debugging information for each assembler line.  This
 359 may help debugging assembler code, if the debugger can handle it.
 360 .IP "\fB\-\-gdwarf2\fR" 4
 361 .IX Item "--gdwarf2"
 362 Generate \s-1DWARF2\s0 debugging information for each assembler line.  This
 363 may help debugging assembler code, if the debugger can handle it.  Note \- this
 364 option is only supported by some targets, not all of them.
 365 .IP "\fB\-\-help\fR" 4
 366 .IX Item "--help"
 367 Print a summary of the command line options and exit.
 368 .IP "\fB\-\-target\-help\fR" 4
 369 .IX Item "--target-help"
 370 Print a summary of all target specific options and exit.
 371 .IP "\fB\-I\fR \fIdir\fR" 4
 372 .IX Item "-I dir"
 373 Add directory \fIdir\fR to the search list for \f(CW\*(C`.include\*(C'\fR directives.
 374 .IP "\fB\-J\fR" 4
 375 .IX Item "-J"
 376 Don't warn about signed overflow.
 377 .IP "\fB\-K\fR" 4
 378 .IX Item "-K"
 379 This option is accepted but has no effect on the \s-1TARGET\s0 family.
 380 .IP "\fB\-L\fR" 4
 381 .IX Item "-L"
 382 .PD 0
 383 .IP "\fB\-\-keep\-locals\fR" 4
 384 .IX Item "--keep-locals"
 385 .PD
 386 Keep (in the symbol table) local symbols.  On traditional a.out systems
 387 these start with \fBL\fR, but different systems have different local
 388 label prefixes.
 389 .IP "\fB\-\-listing\-lhs\-width=\fR\fInumber\fR" 4
 390 .IX Item "--listing-lhs-width=number"
 391 Set the maximum width, in words, of the output data column for an assembler
 392 listing to \fInumber\fR.
 393 .IP "\fB\-\-listing\-lhs\-width2=\fR\fInumber\fR" 4
 394 .IX Item "--listing-lhs-width2=number"
 395 Set the maximum width, in words, of the output data column for continuation
 396 lines in an assembler listing to \fInumber\fR.
 397 .IP "\fB\-\-listing\-rhs\-width=\fR\fInumber\fR" 4
 398 .IX Item "--listing-rhs-width=number"
 399 Set the maximum width of an input source line, as displayed in a listing, to
 400 \&\fInumber\fR bytes.
 401 .IP "\fB\-\-listing\-cont\-lines=\fR\fInumber\fR" 4
 402 .IX Item "--listing-cont-lines=number"
 403 Set the maximum number of lines printed in a listing for a single line of input
 404 to \fInumber\fR + 1.
 405 .IP "\fB\-o\fR \fIobjfile\fR" 4
 406 .IX Item "-o objfile"
 407 Name the object-file output from \fBas\fR \fIobjfile\fR.
 408 .IP "\fB\-R\fR" 4
 409 .IX Item "-R"
 410 Fold the data section into the text section.
 411 .IP "\fB\-\-statistics\fR" 4
 412 .IX Item "--statistics"
 413 Print the maximum space (in bytes) and total time (in seconds) used by
 414 assembly.
 415 .IP "\fB\-\-strip\-local\-absolute\fR" 4
 416 .IX Item "--strip-local-absolute"
 417 Remove local absolute symbols from the outgoing symbol table.
 418 .IP "\fB\-v\fR" 4
 419 .IX Item "-v"
 420 .PD 0
 421 .IP "\fB\-version\fR" 4
 422 .IX Item "-version"
 423 .PD
 424 Print the \fBas\fR version.
 425 .IP "\fB\-\-version\fR" 4
 426 .IX Item "--version"
 427 Print the \fBas\fR version and exit.
 428 .IP "\fB\-W\fR" 4
 429 .IX Item "-W"
 430 .PD 0
 431 .IP "\fB\-\-no\-warn\fR" 4
 432 .IX Item "--no-warn"
 433 .PD
 434 Suppress warning messages.
 435 .IP "\fB\-\-fatal\-warnings\fR" 4
 436 .IX Item "--fatal-warnings"
 437 Treat warnings as errors.
 438 .IP "\fB\-\-warn\fR" 4
 439 .IX Item "--warn"
 440 Don't suppress warning messages or treat them as errors.
 441 .IP "\fB\-w\fR" 4
 442 .IX Item "-w"
 443 Ignored.
 444 .IP "\fB\-x\fR" 4
 445 .IX Item "-x"
 446 Ignored.
 447 .IP "\fB\-Z\fR" 4
 448 .IX Item "-Z"
 449 Generate an object file even after errors.
 450 .IP "\fB\-\- |\fR \fIfiles\fR \fB...\fR" 4
 451 .IX Item "-- | files ..."
 452 Standard input, or source files to assemble.
 453 .PP
 454 The following options are available when as is configured for
 455 an \s-1ARC\s0 processor.
 456 .IP "\fB\-marc[5|6|7|8]\fR" 4
 457 .IX Item "-marc[5|6|7|8]"
 458 This option selects the core processor variant.
 459 .IP "\fB\-EB | \-EL\fR" 4
 460 .IX Item "-EB | -EL"
 461 Select either big-endian (\-EB) or little-endian (\-EL) output.
 462 .PP
 463 The following options are available when as is configured for the \s-1ARM\s0
 464 processor family.
 465 .IP "\fB\-mcpu=\fR\fIprocessor\fR\fB[+\fR\fIextension\fR\fB...]\fR" 4
 466 .IX Item "-mcpu=processor[+extension...]"
 467 Specify which \s-1ARM\s0 processor variant is the target.
 468 .IP "\fB\-march=\fR\fIarchitecture\fR\fB[+\fR\fIextension\fR\fB...]\fR" 4
 469 .IX Item "-march=architecture[+extension...]"
 470 Specify which \s-1ARM\s0 architecture variant is used by the target.
 471 .IP "\fB\-mfpu=\fR\fIfloating-point-format\fR" 4
 472 .IX Item "-mfpu=floating-point-format"
 473 Select which Floating Point architecture is the target.
 474 .IP "\fB\-mthumb\fR" 4
 475 .IX Item "-mthumb"
 476 Enable Thumb only instruction decoding.
 477 .IP "\fB\-mapcs\-32 | \-mapcs\-26 | \-mapcs\-float | \-mapcs\-reentrant | \-moabi\fR" 4
 478 .IX Item "-mapcs-32 | -mapcs-26 | -mapcs-float | -mapcs-reentrant | -moabi"
 479 Select which procedure calling convention is in use.
 480 .IP "\fB\-EB | \-EL\fR" 4
 481 .IX Item "-EB | -EL"
 482 Select either big-endian (\-EB) or little-endian (\-EL) output.
 483 .IP "\fB\-mthumb\-interwork\fR" 4
 484 .IX Item "-mthumb-interwork"
 485 Specify that the code has been generated with interworking between Thumb and
 486 \&\s-1ARM\s0 code in mind.
 487 .IP "\fB\-k\fR" 4
 488 .IX Item "-k"
 489 Specify that \s-1PIC\s0 code has been generated.
 490 .PP
 491 See the info pages for documentation of the CRIS-specific options.
 492 .PP
 493 The following options are available when as is configured for
 494 a D10V processor.
 495 .IP "\fB\-O\fR" 4
 496 .IX Item "-O"
 497 Optimize output by parallelizing instructions.
 498 .PP
 499 The following options are available when as is configured for a D30V
 500 processor.
 501 .IP "\fB\-O\fR" 4
 502 .IX Item "-O"
 503 Optimize output by parallelizing instructions.
 504 .IP "\fB\-n\fR" 4
 505 .IX Item "-n"
 506 Warn when nops are generated.
 507 .IP "\fB\-N\fR" 4
 508 .IX Item "-N"
 509 Warn when a nop after a 32\-bit multiply instruction is generated.
 510 .PP
 511 The following options are available when as is configured for the
 512 Intel 80960 processor.
 513 .IP "\fB\-ACA | \-ACA_A | \-ACB | \-ACC | \-AKA | \-AKB | \-AKC | \-AMC\fR" 4
 514 .IX Item "-ACA | -ACA_A | -ACB | -ACC | -AKA | -AKB | -AKC | -AMC"
 515 Specify which variant of the 960 architecture is the target.
 516 .IP "\fB\-b\fR" 4
 517 .IX Item "-b"
 518 Add code to collect statistics about branches taken.
 519 .IP "\fB\-no\-relax\fR" 4
 520 .IX Item "-no-relax"
 521 Do not alter compare-and-branch instructions for long displacements;
 522 error if necessary.
 523 .PP
 524 The following options are available when as is configured for the
 525 Mitsubishi M32R series.
 526 .IP "\fB\-\-m32rx\fR" 4
 527 .IX Item "--m32rx"
 528 Specify which processor in the M32R family is the target.  The default
 529 is normally the M32R, but this option changes it to the M32RX.
 530 .IP "\fB\-\-warn\-explicit\-parallel\-conflicts or \-\-Wp\fR" 4
 531 .IX Item "--warn-explicit-parallel-conflicts or --Wp"
 532 Produce warning messages when questionable parallel constructs are
 533 encountered.
 534 .IP "\fB\-\-no\-warn\-explicit\-parallel\-conflicts or \-\-Wnp\fR" 4
 535 .IX Item "--no-warn-explicit-parallel-conflicts or --Wnp"
 536 Do not produce warning messages when questionable parallel constructs are
 537 encountered.
 538 .PP
 539 The following options are available when as is configured for the
 540 Motorola 68000 series.
 541 .IP "\fB\-l\fR" 4
 542 .IX Item "-l"
 543 Shorten references to undefined symbols, to one word instead of two.
 544 .IP "\fB\-m68000 | \-m68008 | \-m68010 | \-m68020 | \-m68030\fR" 4
 545 .IX Item "-m68000 | -m68008 | -m68010 | -m68020 | -m68030"
 546 .PD 0
 547 .IP "\fB| \-m68040 | \-m68060 | \-m68302 | \-m68331 | \-m68332\fR" 4
 548 .IX Item "| -m68040 | -m68060 | -m68302 | -m68331 | -m68332"
 549 .IP "\fB| \-m68333 | \-m68340 | \-mcpu32 | \-m5200\fR" 4
 550 .IX Item "| -m68333 | -m68340 | -mcpu32 | -m5200"
 551 .PD
 552 Specify what processor in the 68000 family is the target.  The default
 553 is normally the 68020, but this can be changed at configuration time.
 554 .IP "\fB\-m68881 | \-m68882 | \-mno\-68881 | \-mno\-68882\fR" 4
 555 .IX Item "-m68881 | -m68882 | -mno-68881 | -mno-68882"
 556 The target machine does (or does not) have a floating-point coprocessor.
 557 The default is to assume a coprocessor for 68020, 68030, and cpu32.  Although
 558 the basic 68000 is not compatible with the 68881, a combination of the
 559 two can be specified, since it's possible to do emulation of the
 560 coprocessor instructions with the main processor.
 561 .IP "\fB\-m68851 | \-mno\-68851\fR" 4
 562 .IX Item "-m68851 | -mno-68851"
 563 The target machine does (or does not) have a memory-management
 564 unit coprocessor.  The default is to assume an \s-1MMU\s0 for 68020 and up.
 565 .PP
 566 For details about the \s-1PDP\-11\s0 machine dependent features options,
 567 see \f(CW@ref\fR{PDP\-11\-Options}.
 568 .IP "\fB\-mpic | \-mno\-pic\fR" 4
 569 .IX Item "-mpic | -mno-pic"
 570 Generate position-independent (or position\-dependent) code.  The
 571 default is \fB\-mpic\fR.
 572 .IP "\fB\-mall\fR" 4
 573 .IX Item "-mall"
 574 .PD 0
 575 .IP "\fB\-mall\-extensions\fR" 4
 576 .IX Item "-mall-extensions"
 577 .PD
 578 Enable all instruction set extensions.  This is the default.
 579 .IP "\fB\-mno\-extensions\fR" 4
 580 .IX Item "-mno-extensions"
 581 Disable all instruction set extensions.
 582 .IP "\fB\-m\fR\fIextension\fR \fB| \-mno\-\fR\fIextension\fR" 4
 583 .IX Item "-mextension | -mno-extension"
 584 Enable (or disable) a particular instruction set extension.
 585 .IP "\fB\-m\fR\fIcpu\fR" 4
 586 .IX Item "-mcpu"
 587 Enable the instruction set extensions supported by a particular \s-1CPU\s0, and
 588 disable all other extensions.
 589 .IP "\fB\-m\fR\fImachine\fR" 4
 590 .IX Item "-mmachine"
 591 Enable the instruction set extensions supported by a particular machine
 592 model, and disable all other extensions.
 593 .PP
 594 The following options are available when as is configured for
 595 a picoJava processor.
 596 .IP "\fB\-mb\fR" 4
 597 .IX Item "-mb"
 598 Generate ``big endian'' format output.
 599 .IP "\fB\-ml\fR" 4
 600 .IX Item "-ml"
 601 Generate ``little endian'' format output.
 602 .PP
 603 The following options are available when as is configured for the
 604 Motorola 68HC11 or 68HC12 series.
 605 .IP "\fB\-m68hc11 | \-m68hc12\fR" 4
 606 .IX Item "-m68hc11 | -m68hc12"
 607 Specify what processor is the target.  The default is
 608 defined by the configuration option when building the assembler.
 609 .IP "\fB\-\-force\-long\-branchs\fR" 4
 610 .IX Item "--force-long-branchs"
 611 Relative branches are turned into absolute ones. This concerns
 612 conditional branches, unconditional branches and branches to a
 613 sub routine.
 614 .IP "\fB\-S | \-\-short\-branchs\fR" 4
 615 .IX Item "-S | --short-branchs"
 616 Do not turn relative branchs into absolute ones
 617 when the offset is out of range.
 618 .IP "\fB\-\-strict\-direct\-mode\fR" 4
 619 .IX Item "--strict-direct-mode"
 620 Do not turn the direct addressing mode into extended addressing mode
 621 when the instruction does not support direct addressing mode.
 622 .IP "\fB\-\-print\-insn\-syntax\fR" 4
 623 .IX Item "--print-insn-syntax"
 624 Print the syntax of instruction in case of error.
 625 .IP "\fB\-\-print\-opcodes\fR" 4
 626 .IX Item "--print-opcodes"
 627 print the list of instructions with syntax and then exit.
 628 .IP "\fB\-\-generate\-example\fR" 4
 629 .IX Item "--generate-example"
 630 print an example of instruction for each possible instruction and then exit.
 631 This option is only useful for testing \fBas\fR.
 632 .PP
 633 The following options are available when \fBas\fR is configured
 634 for the \s-1SPARC\s0 architecture:
 635 .IP "\fB\-Av6 | \-Av7 | \-Av8 | \-Asparclet | \-Asparclite\fR" 4
 636 .IX Item "-Av6 | -Av7 | -Av8 | -Asparclet | -Asparclite"
 637 .PD 0
 638 .IP "\fB\-Av8plus | \-Av8plusa | \-Av9 | \-Av9a\fR" 4
 639 .IX Item "-Av8plus | -Av8plusa | -Av9 | -Av9a"
 640 .PD
 641 Explicitly select a variant of the \s-1SPARC\s0 architecture.
 642 .Sp
 643 \&\fB\-Av8plus\fR and \fB\-Av8plusa\fR select a 32 bit environment.
 644 \&\fB\-Av9\fR and \fB\-Av9a\fR select a 64 bit environment.
 645 .Sp
 646 \&\fB\-Av8plusa\fR and \fB\-Av9a\fR enable the \s-1SPARC\s0 V9 instruction set with
 647 UltraSPARC extensions.
 648 .IP "\fB\-xarch=v8plus | \-xarch=v8plusa\fR" 4
 649 .IX Item "-xarch=v8plus | -xarch=v8plusa"
 650 For compatibility with the Solaris v9 assembler.  These options are
 651 equivalent to \-Av8plus and \-Av8plusa, respectively.
 652 .IP "\fB\-bump\fR" 4
 653 .IX Item "-bump"
 654 Warn when the assembler switches to another architecture.
 655 .PP
 656 The following options are available when as is configured for
 657 a \s-1MIPS\s0 processor.
 658 .IP "\fB\-G\fR \fInum\fR" 4
 659 .IX Item "-G num"
 660 This option sets the largest size of an object that can be referenced
 661 implicitly with the \f(CW\*(C`gp\*(C'\fR register.  It is only accepted for targets that
 662 use \s-1ECOFF\s0 format, such as a DECstation running Ultrix.  The default value is 8.
 663 .IP "\fB\-EB\fR" 4
 664 .IX Item "-EB"
 665 Generate ``big endian'' format output.
 666 .IP "\fB\-EL\fR" 4
 667 .IX Item "-EL"
 668 Generate ``little endian'' format output.
 669 .IP "\fB\-mips1\fR" 4
 670 .IX Item "-mips1"
 671 .PD 0
 672 .IP "\fB\-mips2\fR" 4
 673 .IX Item "-mips2"
 674 .IP "\fB\-mips3\fR" 4
 675 .IX Item "-mips3"
 676 .IP "\fB\-mips4\fR" 4
 677 .IX Item "-mips4"
 678 .IP "\fB\-mips32\fR" 4
 679 .IX Item "-mips32"
 680 .IP "\fB\-mips64\fR" 4
 681 .IX Item "-mips64"
 682 .PD
 683 Generate code for a particular \s-1MIPS\s0 Instruction Set Architecture level.
 684 \&\fB\-mips1\fR corresponds to the R2000 and R3000 processors,
 685 \&\fB\-mips2\fR to the R6000 processor, and \fB\-mips3\fR to the R4000
 686 processor.
 687 \&\fB\-mips5\fR, \fB\-mips32\fR, and \fB\-mips64\fR correspond
 688 to generic \s-1MIPS\s0 V, \s-1MIPS32\s0, and \s-1MIPS64\s0 \s-1ISA\s0
 689 processors, respectively.
 690 .IP "\fB\-m4650\fR" 4
 691 .IX Item "-m4650"
 692 .PD 0
 693 .IP "\fB\-no\-m4650\fR" 4
 694 .IX Item "-no-m4650"
 695 .PD
 696 Generate code for the \s-1MIPS\s0 R4650 chip.  This tells the assembler to accept
 697 the \fBmad\fR and \fBmadu\fR instruction, and to not schedule \fBnop\fR
 698 instructions around accesses to the \fB\s-1HI\s0\fR and \fB\s-1LO\s0\fR registers.
 699 \&\fB\-no\-m4650\fR turns off this option.
 700 .IP "\fB\-mcpu=\fR\fI\s-1CPU\s0\fR" 4
 701 .IX Item "-mcpu=CPU"
 702 Generate code for a particular \s-1MIPS\s0 cpu.  It is exactly equivalent to
 703 \&\fB\-m\fR\fIcpu\fR, except that there are more value of \fIcpu\fR
 704 understood.
 705 .IP "\fB\-\-emulation=\fR\fIname\fR" 4
 706 .IX Item "--emulation=name"
 707 This option causes \fBas\fR to emulate \fBas\fR configured
 708 for some other target, in all respects, including output format (choosing
 709 between \s-1ELF\s0 and \s-1ECOFF\s0 only), handling of pseudo-opcodes which may generate
 710 debugging information or store symbol table information, and default
 711 endianness.  The available configuration names are: \fBmipsecoff\fR,
 712 \&\fBmipself\fR, \fBmipslecoff\fR, \fBmipsbecoff\fR, \fBmipslelf\fR,
 713 \&\fBmipsbelf\fR.  The first two do not alter the default endianness from that
 714 of the primary target for which the assembler was configured; the others change
 715 the default to little\- or big-endian as indicated by the \fBb\fR or \fBl\fR
 716 in the name.  Using \fB\-EB\fR or \fB\-EL\fR will override the endianness
 717 selection in any case.
 718 .Sp
 719 This option is currently supported only when the primary target
 720 \&\fBas\fR is configured for is a \s-1MIPS\s0 \s-1ELF\s0 or \s-1ECOFF\s0 target.
 721 Furthermore, the primary target or others specified with
 722 \&\fB\-\-enable\-targets=...\fR at configuration time must include support for
 723 the other format, if both are to be available.  For example, the Irix 5
 724 configuration includes support for both.
 725 .Sp
 726 Eventually, this option will support more configurations, with more
 727 fine-grained control over the assembler's behavior, and will be supported for
 728 more processors.
 729 .IP "\fB\-nocpp\fR" 4
 730 .IX Item "-nocpp"
 731 \&\fBas\fR ignores this option.  It is accepted for compatibility with
 732 the native tools.
 733 .IP "\fB\-\-trap\fR" 4
 734 .IX Item "--trap"
 735 .PD 0
 736 .IP "\fB\-\-no\-trap\fR" 4
 737 .IX Item "--no-trap"
 738 .IP "\fB\-\-break\fR" 4
 739 .IX Item "--break"
 740 .IP "\fB\-\-no\-break\fR" 4
 741 .IX Item "--no-break"
 742 .PD
 743 Control how to deal with multiplication overflow and division by zero.
 744 \&\fB\-\-trap\fR or \fB\-\-no\-break\fR (which are synonyms) take a trap exception
 745 (and only work for Instruction Set Architecture level 2 and higher);
 746 \&\fB\-\-break\fR or \fB\-\-no\-trap\fR (also synonyms, and the default) take a
 747 break exception.
 748 .IP "\fB\-n\fR" 4
 749 .IX Item "-n"
 750 When this option is used, \fBas\fR will issue a warning every
 751 time it generates a nop instruction from a macro.
 752 .PP
 753 The following options are available when as is configured for
 754 an MCore processor.
 755 .IP "\fB\-jsri2bsr\fR" 4
 756 .IX Item "-jsri2bsr"
 757 .PD 0
 758 .IP "\fB\-nojsri2bsr\fR" 4
 759 .IX Item "-nojsri2bsr"
 760 .PD
 761 Enable or disable the \s-1JSRI\s0 to \s-1BSR\s0 transformation.  By default this is enabled.
 762 The command line option \fB\-nojsri2bsr\fR can be used to disable it.
 763 .IP "\fB\-sifilter\fR" 4
 764 .IX Item "-sifilter"
 765 .PD 0
 766 .IP "\fB\-nosifilter\fR" 4
 767 .IX Item "-nosifilter"
 768 .PD
 769 Enable or disable the silicon filter behaviour.  By default this is disabled.
 770 The default can be overridden by the \fB\-sifilter\fR command line option.
 771 .IP "\fB\-relax\fR" 4
 772 .IX Item "-relax"
 773 Alter jump instructions for long displacements.
 774 .IP "\fB\-mcpu=[210|340]\fR" 4
 775 .IX Item "-mcpu=[210|340]"
 776 Select the cpu type on the target hardware.  This controls which instructions
 777 can be assembled.
 778 .IP "\fB\-EB\fR" 4
 779 .IX Item "-EB"
 780 Assemble for a big endian target.
 781 .IP "\fB\-EL\fR" 4
 782 .IX Item "-EL"
 783 Assemble for a little endian target.
 784 .PP
 785 See the info pages for documentation of the MMIX-specific options.
 786 .SH "SEE ALSO"
 787 .IX Header "SEE ALSO"
 788 \&\fIgcc\fR\|(1), \fIld\fR\|(1), and the Info entries for \fIbinutils\fR and \fIld\fR.
 789 .SH "COPYRIGHT"
 790 .IX Header "COPYRIGHT"
 791 Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.
 792 .PP
 793 Permission is granted to copy, distribute and/or modify this document
 794 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 795 or any later version published by the Free Software Foundation;
 796 with no Invariant Sections, with no Front-Cover Texts, and with no
 797 Back-Cover Texts.  A copy of the license is included in the
 798 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".