<html lang="en">
<head>
<title>i386-Options - Using as</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using as">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="i386_002dDependent.html#i386_002dDependent" title="i386-Dependent">
<link rel="next" href="i386_002dDirectives.html#i386_002dDirectives" title="i386-Directives">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This file documents the GNU Assembler "as".
Copyright (C) 1991-2015 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the
section entitled ``GNU Free Documentation License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="i386-Options"></a>
<a name="i386_002dOptions"></a>
<p>
Next: <a rel="next" accesskey="n" href="i386_002dDirectives.html#i386_002dDirectives">i386-Directives</a>,
Up: <a rel="up" accesskey="u" href="i386_002dDependent.html#i386_002dDependent">i386-Dependent</a>
<hr>
</div>
<h4 class="subsection">9.15.1 Options</h4>
<p><a name="index-options-for-i386-983"></a><a name="index-options-for-x86_002d64-984"></a><a name="index-i386-options-985"></a><a name="index-x86_002d64-options-986"></a>
The i386 version of <code>as</code> has a few machine
dependent options:
<!-- man begin OPTIONS -->
<a name="index-g_t_0040samp_007b_002d_002d32_007d-option_002c-i386-987"></a>
<a name="index-g_t_0040samp_007b_002d_002d32_007d-option_002c-x86_002d64-988"></a>
<a name="index-g_t_0040samp_007b_002d_002dx32_007d-option_002c-i386-989"></a>
<a name="index-g_t_0040samp_007b_002d_002dx32_007d-option_002c-x86_002d64-990"></a>
<a name="index-g_t_0040samp_007b_002d_002d64_007d-option_002c-i386-991"></a>
<a name="index-g_t_0040samp_007b_002d_002d64_007d-option_002c-x86_002d64-992"></a>
<dl><dt><code>--32 | --x32 | --64</code><dd>Select the word size, either 32 bits or 64 bits. ‘<samp><span class="samp">--32</span></samp>’
implies Intel i386 architecture, while ‘<samp><span class="samp">--x32</span></samp>’ and ‘<samp><span class="samp">--64</span></samp>’
imply AMD x86-64 architecture with 32-bit or 64-bit word-size
respectively.
<p>These options are only available with the ELF object file format, and
require that the necessary BFD support has been included (on a 32-bit
platform you have to add –enable-64-bit-bfd to configure enable 64-bit
usage and use x86-64 as target platform).
<br><dt><code>-n</code><dd>By default, x86 GAS replaces multiple nop instructions used for
alignment within code sections with multi-byte nop instructions such
as leal 0(%esi,1),%esi. This switch disables the optimization.
<p><a name="index-g_t_0040samp_007b_002d_002ddivide_007d-option_002c-i386-993"></a><br><dt><code>--divide</code><dd>On SVR4-derived platforms, the character ‘<samp><span class="samp">/</span></samp>’ is treated as a comment
character, which means that it cannot be used in expressions. The
‘<samp><span class="samp">--divide</span></samp>’ option turns ‘<samp><span class="samp">/</span></samp>’ into a normal character. This does
not disable ‘<samp><span class="samp">/</span></samp>’ at the beginning of a line starting a comment, or
affect using ‘<samp><span class="samp">#</span></samp>’ for starting a comment.
<p><a name="index-g_t_0040samp_007b_002dmarch_003d_007d-option_002c-i386-994"></a><a name="index-g_t_0040samp_007b_002dmarch_003d_007d-option_002c-x86_002d64-995"></a><br><dt><code>-march=</code><var>CPU</var><code>[+</code><var>EXTENSION</var><code>...]</code><dd>This option specifies the target processor. The assembler will
issue an error message if an attempt is made to assemble an instruction
which will not execute on the target processor. The following
processor names are recognized:
<code>i8086</code>,
<code>i186</code>,
<code>i286</code>,
<code>i386</code>,
<code>i486</code>,
<code>i586</code>,
<code>i686</code>,
<code>pentium</code>,
<code>pentiumpro</code>,
<code>pentiumii</code>,
<code>pentiumiii</code>,
<code>pentium4</code>,
<code>prescott</code>,
<code>nocona</code>,
<code>core</code>,
<code>core2</code>,
<code>corei7</code>,
<code>l1om</code>,
<code>k1om</code>,
<code>iamcu</code>,
<code>k6</code>,
<code>k6_2</code>,
<code>athlon</code>,
<code>opteron</code>,
<code>k8</code>,
<code>amdfam10</code>,
<code>bdver1</code>,
<code>bdver2</code>,
<code>bdver3</code>,
<code>bdver4</code>,
<code>znver1</code>,
<code>btver1</code>,
<code>btver2</code>,
<code>generic32</code> and
<code>generic64</code>.
<p>In addition to the basic instruction set, the assembler can be told to
accept various extension mnemonics. For example,
<code>-march=i686+sse4+vmx</code> extends <var>i686</var> with <var>sse4</var> and
<var>vmx</var>. The following extensions are currently supported:
<code>8087</code>,
<code>287</code>,
<code>387</code>,
<code>no87</code>,
<code>mmx</code>,
<code>nommx</code>,
<code>sse</code>,
<code>sse2</code>,
<code>sse3</code>,
<code>ssse3</code>,
<code>sse4.1</code>,
<code>sse4.2</code>,
<code>sse4</code>,
<code>nosse</code>,
<code>avx</code>,
<code>avx2</code>,
<code>adx</code>,
<code>rdseed</code>,
<code>prfchw</code>,
<code>smap</code>,
<code>mpx</code>,
<code>sha</code>,
<code>prefetchwt1</code>,
<code>clflushopt</code>,
<code>se1</code>,
<code>clwb</code>,
<code>pcommit</code>,
<code>avx512f</code>,
<code>avx512cd</code>,
<code>avx512er</code>,
<code>avx512pf</code>,
<code>avx512vl</code>,
<code>avx512bw</code>,
<code>avx512dq</code>,
<code>avx512ifma</code>,
<code>avx512vbmi</code>,
<code>noavx</code>,
<code>vmx</code>,
<code>vmfunc</code>,
<code>smx</code>,
<code>xsave</code>,
<code>xsaveopt</code>,
<code>xsavec</code>,
<code>xsaves</code>,
<code>aes</code>,
<code>pclmul</code>,
<code>fsgsbase</code>,
<code>rdrnd</code>,
<code>f16c</code>,
<code>bmi2</code>,
<code>fma</code>,
<code>movbe</code>,
<code>ept</code>,
<code>lzcnt</code>,
<code>hle</code>,
<code>rtm</code>,
<code>invpcid</code>,
<code>clflush</code>,
<code>mwaitx</code>,
<code>clzero</code>,
<code>lwp</code>,
<code>fma4</code>,
<code>xop</code>,
<code>cx16</code>,
<code>syscall</code>,
<code>rdtscp</code>,
<code>3dnow</code>,
<code>3dnowa</code>,
<code>sse4a</code>,
<code>sse5</code>,
<code>svme</code>,
<code>abm</code> and
<code>padlock</code>.
Note that rather than extending a basic instruction set, the extension
mnemonics starting with <code>no</code> revoke the respective functionality.
<p>When the <code>.arch</code> directive is used with <samp><span class="option">-march</span></samp>, the
<code>.arch</code> directive will take precedent.
<p><a name="index-g_t_0040samp_007b_002dmtune_003d_007d-option_002c-i386-996"></a><a name="index-g_t_0040samp_007b_002dmtune_003d_007d-option_002c-x86_002d64-997"></a><br><dt><code>-mtune=</code><var>CPU</var><dd>This option specifies a processor to optimize for. When used in
conjunction with the <samp><span class="option">-march</span></samp> option, only instructions
of the processor specified by the <samp><span class="option">-march</span></samp> option will be
generated.
<p>Valid <var>CPU</var> values are identical to the processor list of
<samp><span class="option">-march=</span><var>CPU</var></samp>.
<p><a name="index-g_t_0040samp_007b_002dmsse2avx_007d-option_002c-i386-998"></a><a name="index-g_t_0040samp_007b_002dmsse2avx_007d-option_002c-x86_002d64-999"></a><br><dt><code>-msse2avx</code><dd>This option specifies that the assembler should encode SSE instructions
with VEX prefix.
<p><a name="index-g_t_0040samp_007b_002dmsse_002dcheck_003d_007d-option_002c-i386-1000"></a><a name="index-g_t_0040samp_007b_002dmsse_002dcheck_003d_007d-option_002c-x86_002d64-1001"></a><br><dt><code>-msse-check=</code><var>none</var><dt><code>-msse-check=</code><var>warning</var><dt><code>-msse-check=</code><var>error</var><dd>These options control if the assembler should check SSE instructions.
<samp><span class="option">-msse-check=</span><var>none</var></samp> will make the assembler not to check SSE
instructions, which is the default. <samp><span class="option">-msse-check=</span><var>warning</var></samp>
will make the assembler issue a warning for any SSE instruction.
<samp><span class="option">-msse-check=</span><var>error</var></samp> will make the assembler issue an error
for any SSE instruction.
<p><a name="index-g_t_0040samp_007b_002dmavxscalar_003d_007d-option_002c-i386-1002"></a><a name="index-g_t_0040samp_007b_002dmavxscalar_003d_007d-option_002c-x86_002d64-1003"></a><br><dt><code>-mavxscalar=</code><var>128</var><dt><code>-mavxscalar=</code><var>256</var><dd>These options control how the assembler should encode scalar AVX
instructions. <samp><span class="option">-mavxscalar=</span><var>128</var></samp> will encode scalar
AVX instructions with 128bit vector length, which is the default.
<samp><span class="option">-mavxscalar=</span><var>256</var></samp> will encode scalar AVX instructions
with 256bit vector length.
<p><a name="index-g_t_0040samp_007b_002dmevexlig_003d_007d-option_002c-i386-1004"></a><a name="index-g_t_0040samp_007b_002dmevexlig_003d_007d-option_002c-x86_002d64-1005"></a><br><dt><code>-mevexlig=</code><var>128</var><dt><code>-mevexlig=</code><var>256</var><dt><code>-mevexlig=</code><var>512</var><dd>These options control how the assembler should encode length-ignored
(LIG) EVEX instructions. <samp><span class="option">-mevexlig=</span><var>128</var></samp> will encode LIG
EVEX instructions with 128bit vector length, which is the default.
<samp><span class="option">-mevexlig=</span><var>256</var></samp> and <samp><span class="option">-mevexlig=</span><var>512</var></samp> will
encode LIG EVEX instructions with 256bit and 512bit vector length,
respectively.
<p><a name="index-g_t_0040samp_007b_002dmevexwig_003d_007d-option_002c-i386-1006"></a><a name="index-g_t_0040samp_007b_002dmevexwig_003d_007d-option_002c-x86_002d64-1007"></a><br><dt><code>-mevexwig=</code><var>0</var><dt><code>-mevexwig=</code><var>1</var><dd>These options control how the assembler should encode w-ignored (WIG)
EVEX instructions. <samp><span class="option">-mevexwig=</span><var>0</var></samp> will encode WIG
EVEX instructions with evex.w = 0, which is the default.
<samp><span class="option">-mevexwig=</span><var>1</var></samp> will encode WIG EVEX instructions with
evex.w = 1.
<p><a name="index-g_t_0040samp_007b_002dmmnemonic_003d_007d-option_002c-i386-1008"></a><a name="index-g_t_0040samp_007b_002dmmnemonic_003d_007d-option_002c-x86_002d64-1009"></a><br><dt><code>-mmnemonic=</code><var>att</var><dt><code>-mmnemonic=</code><var>intel</var><dd>This option specifies instruction mnemonic for matching instructions.
The <code>.att_mnemonic</code> and <code>.intel_mnemonic</code> directives will
take precedent.
<p><a name="index-g_t_0040samp_007b_002dmsyntax_003d_007d-option_002c-i386-1010"></a><a name="index-g_t_0040samp_007b_002dmsyntax_003d_007d-option_002c-x86_002d64-1011"></a><br><dt><code>-msyntax=</code><var>att</var><dt><code>-msyntax=</code><var>intel</var><dd>This option specifies instruction syntax when processing instructions.
The <code>.att_syntax</code> and <code>.intel_syntax</code> directives will
take precedent.
<p><a name="index-g_t_0040samp_007b_002dmnaked_002dreg_007d-option_002c-i386-1012"></a><a name="index-g_t_0040samp_007b_002dmnaked_002dreg_007d-option_002c-x86_002d64-1013"></a><br><dt><code>-mnaked-reg</code><dd>This opetion specifies that registers don't require a ‘<samp><span class="samp">%</span></samp>’ prefix.
The <code>.att_syntax</code> and <code>.intel_syntax</code> directives will take precedent.
<p><a name="index-g_t_0040samp_007b_002dmadd_002dbnd_002dprefix_007d-option_002c-i386-1014"></a><a name="index-g_t_0040samp_007b_002dmadd_002dbnd_002dprefix_007d-option_002c-x86_002d64-1015"></a><br><dt><code>-madd-bnd-prefix</code><dd>This option forces the assembler to add BND prefix to all branches, even
if such prefix was not explicitly specified in the source code.
<p><a name="index-g_t_0040samp_007b_002dmshared_007d-option_002c-i386-1016"></a><a name="index-g_t_0040samp_007b_002dmshared_007d-option_002c-x86_002d64-1017"></a><br><dt><code>-mno-shared</code><dd>On ELF target, the assembler normally optimizes out non-PLT relocations
against defined non-weak global branch targets with default visibility.
The ‘<samp><span class="samp">-mshared</span></samp>’ option tells the assembler to generate code which
may go into a shared library where all non-weak global branch targets
with default visibility can be preempted. The resulting code is
slightly bigger. This option only affects the handling of branch
instructions.
<p><a name="index-g_t_0040samp_007b_002dmbig_002dobj_007d-option_002c-x86_002d64-1018"></a><br><dt><code>-mbig-obj</code><dd>On x86-64 PE/COFF target this option forces the use of big object file
format, which allows more than 32768 sections.
<p><a name="index-g_t_0040samp_007b_002dmomit_002dlock_002dprefix_003d_007d-option_002c-i386-1019"></a><a name="index-g_t_0040samp_007b_002dmomit_002dlock_002dprefix_003d_007d-option_002c-x86_002d64-1020"></a><br><dt><code>-momit-lock-prefix=</code><var>no</var><dt><code>-momit-lock-prefix=</code><var>yes</var><dd>These options control how the assembler should encode lock prefix.
This option is intended as a workaround for processors, that fail on
lock prefix. This option can only be safely used with single-core,
single-thread computers
<samp><span class="option">-momit-lock-prefix=</span><var>yes</var></samp> will omit all lock prefixes.
<samp><span class="option">-momit-lock-prefix=</span><var>no</var></samp> will encode lock prefix as usual,
which is the default.
<p><a name="index-g_t_0040samp_007b_002dmevexrcig_003d_007d-option_002c-i386-1021"></a><a name="index-g_t_0040samp_007b_002dmevexrcig_003d_007d-option_002c-x86_002d64-1022"></a><br><dt><code>-mevexrcig=</code><var>rne</var><dt><code>-mevexrcig=</code><var>rd</var><dt><code>-mevexrcig=</code><var>ru</var><dt><code>-mevexrcig=</code><var>rz</var><dd>These options control how the assembler should encode SAE-only
EVEX instructions. <samp><span class="option">-mevexrcig=</span><var>rne</var></samp> will encode RC bits
of EVEX instruction with 00, which is the default.
<samp><span class="option">-mevexrcig=</span><var>rd</var></samp>, <samp><span class="option">-mevexrcig=</span><var>ru</var></samp>
and <samp><span class="option">-mevexrcig=</span><var>rz</var></samp> will encode SAE-only EVEX instructions
with 01, 10 and 11 RC bits, respectively.
<p><a name="index-g_t_0040samp_007b_002dmamd64_007d-option_002c-x86_002d64-1023"></a><a name="index-g_t_0040samp_007b_002dmintel64_007d-option_002c-x86_002d64-1024"></a><br><dt><code>-mamd64</code><dt><code>-mintel64</code><dd>This option specifies that the assembler should accept only AMD64 or
Intel64 ISA in 64-bit mode. The default is to accept both.
</dl>
<!-- man end -->
</body></html>