* doc/as.texinfo: Update MIPS documentation.

This commit is contained in:
Thiemo Seufer 2002-06-07 23:07:19 +00:00
parent 52714ff9ee
commit 437ee9d5ca
2 changed files with 54 additions and 26 deletions

View File

@ -1,3 +1,7 @@
2002-06-08 Thiemo Seufer <seufer@csv.ica.uni-stuttgart.de>
* doc/as.texinfo: Update MIPS documentation.
2002-06-08 Thiemo Seufer <seufer@csv.ica.uni-stuttgart.de> 2002-06-08 Thiemo Seufer <seufer@csv.ica.uni-stuttgart.de>
* config/tc-mips.c: Add define for $zero register. * config/tc-mips.c: Add define for $zero register.

View File

@ -370,14 +370,18 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}.
@ifset MIPS @ifset MIPS
@emph{Target MIPS options:} @emph{Target MIPS options:}
[@b{-nocpp}] [@b{-EL}] [@b{-EB}] [@b{-G} @var{num}] [@b{-mcpu}=@var{CPU} ] [@b{-nocpp}] [@b{-EL}] [@b{-EB}] [@b{-n}] [@b{-O}[@var{optimization level}]]
[@b{-mips1}] [@b{-mips2}] [@b{-mips3}] [@b{-mips4}] [@b{-mips5}] [@b{-g}[@var{debug level}]] [@b{-G} @var{num}] [@b{-KPIC}] [@b{-call_shared}]
[@b{-mips32}] [@b{-mips64}] [@b{-non_shared}] [@b{-xgot}] [@b{--membedded-pic}]
[@b{-m4650}] [@b{-no-m4650}] [@b{-mabi}=@var{ABI}] [@b{-32}] [@b{-n32}] [@b{-64}] [@b{-mfp32}] [@b{-mgp32}]
[@b{-march}=@var{CPU}] [@b{-mtune}=@var{CPU}] [@b{-mips1}] [@b{-mips2}]
[@b{-mips3}] [@b{-mips4}] [@b{-mips5}] [@b{-mips32}] [@b{-mips64}]
[@b{-construct-floats}] [@b{-no-construct-floats}]
[@b{-trap}] [@b{-no-break}] [@b{-break}] [@b{-no-trap}]
[@b{-mfix7000}] [@b{-mno-fix7000}]
[@b{-mips16}] [@b{-no-mips16}]
[@b{-mips3d}] [@b{-no-mips3d}] [@b{-mips3d}] [@b{-no-mips3d}]
[@b{-mdmx}] [@b{-no-mdmx}] [@b{-mdmx}] [@b{-no-mdmx}]
[@b{--trap}] [@b{--break}] [@b{-n}]
[@b{--emulation}=@var{name} ]
@end ifset @end ifset
@ifset MMIX @ifset MMIX
@ -843,7 +847,7 @@ behaviour in the shell.
@ifset MIPS @ifset MIPS
The following options are available when @value{AS} is configured for The following options are available when @value{AS} is configured for
a MIPS processor. a @sc{mips} processor.
@table @gcctabopt @table @gcctabopt
@item -G @var{num} @item -G @var{num}
@ -866,22 +870,40 @@ Generate ``little endian'' format output.
@itemx -mips2 @itemx -mips2
@itemx -mips3 @itemx -mips3
@itemx -mips4 @itemx -mips4
@itemx -mips5
@itemx -mips32 @itemx -mips32
@itemx -mips64 @itemx -mips64
Generate code for a particular MIPS Instruction Set Architecture level. Generate code for a particular @sc{mips} Instruction Set Architecture level.
@samp{-mips1} corresponds to the @sc{r2000} and @sc{r3000} processors, @samp{-mips1} is an alias for @samp{-march=r3000}, @samp{-mips2} is an
@samp{-mips2} to the @sc{r6000} processor, and @samp{-mips3} to the @sc{r4000} alias for @samp{-march=r6000}, @samp{-mips3} is an alias for
processor. @samp{-march=r4000} and @samp{-mips4} is an alias for @samp{-march=r8000}.
@samp{-mips5}, @samp{-mips32}, and @samp{-mips64} correspond @samp{-mips5}, @samp{-mips32}, and @samp{-mips64} correspond to generic
to generic @sc{MIPS V}, @sc{MIPS32}, and @sc{MIPS64} ISA @samp{MIPS V}, @samp{MIPS32}, and @samp{MIPS64} ISA processors,
processors, respectively. respectively.
@item -m4650 @item -march=@var{CPU}
@itemx -no-m4650 Generate code for a particular @sc{mips} cpu.
Generate code for the MIPS @sc{r4650} chip. This tells the assembler to accept
the @samp{mad} and @samp{madu} instruction, and to not schedule @samp{nop} @item -mtune=@var{cpu}
instructions around accesses to the @samp{HI} and @samp{LO} registers. Schedule and tune for a particular @sc{mips} cpu.
@samp{-no-m4650} turns off this option.
@item -mfix7000
@itemx -mno-fix7000
Cause nops to be inserted if the read of the destination register
of an mfhi or mflo instruction occurs in the following two instructions.
@item -mgp32
@itemx -mfp32
The register sizes are normally inferred from the ISA and ABI, but these
flags force a certain group of registers to be treated as 32 bits wide at
all times. @samp{-mgp32} controls the size of general-purpose registers
and @samp{-mfp32} controls the size of floating-point registers.
@item -mips16
@itemx -no-mips16
Generate code for the MIPS 16 processor. This is equivalent to putting
@code{.set mips16} at the start of the assembly file. @samp{-no-mips16}
turns off this option.
@item -mips3d @item -mips3d
@itemx -no-mips3d @itemx -no-mips3d
@ -895,10 +917,13 @@ Generate code for the MDMX Application Specific Extension.
This tells the assembler to accept MDMX instructions. This tells the assembler to accept MDMX instructions.
@samp{-no-mdmx} turns off this option. @samp{-no-mdmx} turns off this option.
@item -mcpu=@var{CPU} @item --construct-floats
Generate code for a particular MIPS cpu. It is exactly equivalent to @itemx --no-construct-floats
@samp{-m@var{cpu}}, except that there are more value of @var{cpu} The @samp{--no-construct-floats} option disables the construction of
understood. double width floating point constants by loading the two halves of the
value into the two single width floating point registers that make up
the double width register. By default @samp{--construct-floats} is
selected, allowing construction of these floating point constants.
@cindex emulation @cindex emulation
@item --emulation=@var{name} @item --emulation=@var{name}
@ -915,7 +940,7 @@ in the name. Using @samp{-EB} or @samp{-EL} will override the endianness
selection in any case. selection in any case.
This option is currently supported only when the primary target This option is currently supported only when the primary target
@command{@value{AS}} is configured for is a MIPS ELF or ECOFF target. @command{@value{AS}} is configured for is a @sc{mips} ELF or ECOFF target.
Furthermore, the primary target or others specified with Furthermore, the primary target or others specified with
@samp{--enable-targets=@dots{}} at configuration time must include support for @samp{--enable-targets=@dots{}} at configuration time must include support for
the other format, if both are to be available. For example, the Irix 5 the other format, if both are to be available. For example, the Irix 5
@ -929,7 +954,6 @@ more processors.
@command{@value{AS}} ignores this option. It is accepted for compatibility with @command{@value{AS}} ignores this option. It is accepted for compatibility with
the native tools. the native tools.
@need 900
@item --trap @item --trap
@itemx --no-trap @itemx --no-trap
@itemx --break @itemx --break