Sparc-Opts - Using as
Description: Using as

Next: Sparc-Aligned-Data, Up: Sparc-Dependent

#### 9.36.1 Options

The SPARC chip family includes several successive versions, using the same core instruction set, but including a few additional instructions at each version. There are exceptions to this however. For details on what instructions each variant supports, please see the chip's architecture reference manual.

By default, `as` assumes the core instruction set (SPARC v6), but “bumps” the architecture level as needed: it switches to successively higher architectures as it encounters instructions that only exist in the higher levels.

If not configured for SPARC v9 (`sparc64-*-*`) GAS will not bump past sparclite by default, an option must be passed to enable the v9 instructions.

GAS treats sparclite as being compatible with v8, unless an architecture is explicitly requested. SPARC v9 is always incompatible with sparclite.

`-Av6 | -Av7 | -Av8 | -Asparclet | -Asparclite`
`-Av8plus | -Av8plusa | -Av8plusb | -Av8plusc | -Av8plusd | -Av8plusv`
`-Av9 | -Av9a | -Av9b | -Av9c | -Av9d | -Av9v`
`-Asparc | -Asparcvis | -Asparcvis2 | -Asparcfmaf | -Asparcima`
`-Asparcvis3 | -Asparcvis3r`
  Use one of the ‘`-A`’ options to select one of the SPARC architectures explicitly. If you select an architecture explicitly, `as` reports a fatal error if it encounters an instruction or feature requiring an incompatible or higher level.

  ‘`-Av8plus`’, ‘`-Av8plusa`’, ‘`-Av8plusb`’, ‘`-Av8plusc`’, ‘`-Av8plusd`’, and ‘`-Av8plusv`’ select a 32 bit environment.

  ‘`-Av9`’, ‘`-Av9a`’, ‘`-Av9b`’, ‘`-Av9c`’, ‘`-Av9d`’, and ‘`-Av9v`’ select a 64 bit environment and are not available unless GAS is explicitly configured with 64 bit environment support.

  ‘`-Av8plusa`’ and ‘`-Av9a`’ enable the SPARC V9 instruction set with UltraSPARC VIS 1.0 extensions.

  ‘`-Av8plusb`’ and ‘`-Av9b`’ enable the UltraSPARC VIS 2.0 instructions, as well as the instructions enabled by ‘`-Av8plusa`’ and ‘`-Av9a`’.

  ‘`-Av8plusc`’ and ‘`-Av9c`’ enable the UltraSPARC Niagara instructions, as well as the instructions enabled by ‘`-Av8plusb`’ and ‘`-Av9b`’.

  ‘`-Av8plusd`’ and ‘`-Av9d`’ enable the floating point fused multiply-add, VIS 3.0, and HPC extension instructions, as well as the instructions enabled by ‘`-Av8plusc`’ and ‘`-Av9c`’.

  ‘`-Av8plusv`’ and ‘`-Av9v`’ enable the 'random', transactional memory, floating point unfused multiply-add, integer multiply-add, and cache sparing store instructions, as well as the instructions enabled by ‘`-Av8plusd`’ and ‘`-Av9d`’.

  ‘`-Asparc`’ specifies a v9 environment. It is equivalent to ‘`-Av9`’ if the word size is 64-bit, and ‘`-Av8plus`’ otherwise.

  ‘`-Asparcvis`’ specifies a v9a environment. It is equivalent to ‘`-Av9a`’ if the word size is 64-bit, and ‘`-Av8plusa`’ otherwise.

  ‘`-Asparcvis2`’ specifies a v9b environment. It is equivalent to ‘`-Av9b`’ if the word size is 64-bit, and ‘`-Av8plusb`’ otherwise.

  ‘`-Asparcfmaf`’ specifies a v9b environment with the floating point fused multiply-add instructions enabled.

  ‘`-Asparcima`’ specifies a v9b environment with the integer multiply-add instructions enabled.

  ‘`-Asparcvis3`’ specifies a v9b environment with the VIS 3.0, HPC , and floating point fused multiply-add instructions enabled.

  ‘`-Asparcvis3r`’ specifies a v9b environment with the VIS 3.0, HPC, transactional memory, random, and floating point unfused multiply-add instructions enabled.

`-xarch=v8plus | -xarch=v8plusa | -xarch=v8plusb | -xarch=v8plusc`
`-xarch=v8plusd | -xarch=v8plusv | -xarch=v9 | -xarch=v9a`
`-xarch=v9b | -xarch=v9c | -xarch=v9d | -xarch=v9v`
`-xarch=sparc | -xarch=sparcvis | -xarch=sparcvis2`
`-xarch=sparcfmaf | -xarch=sparcima | -xarch=sparcvis3`
`-xarch=sparcvis3r`
  For compatibility with the SunOS v9 assembler. These options are equivalent to -Av8plus, -Av8plusa, -Av8plusb, -Av8plusc, -Av8plusd, -Av8plusv, -Av9, -Av9a, -Av9b, -Av9c, -Av9d, -Av9v, -Asparc, -Asparcvis, -Asparcvis2, -Asparcfmaf, -Asparcima, -Asparcvis3, and -Asparcvis3r, respectively.
`-bump`
  Warn whenever it is necessary to switch to another level. If an architecture level is explicitly requested, GAS will not issue warnings until that level is reached, and will then bump the level as required (except between incompatible levels).
`-32 | -64`
  Select the word size, either 32 bits or 64 bits. These options are only available with the ELF object file format, and require that the necessary BFD support has been included.