1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html>
3<!-- This file documents the GNU Assembler "as".
4
5Copyright (C) 1991-2021 Free Software Foundation, Inc.
6
7Permission is granted to copy, distribute and/or modify this document
8under the terms of the GNU Free Documentation License, Version 1.3
9or any later version published by the Free Software Foundation;
10with no Invariant Sections, with no Front-Cover Texts, and with no
11Back-Cover Texts.  A copy of the license is included in the
12section entitled "GNU Free Documentation License".
13 -->
14<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
15<head>
16<title>Using as: Alpha Options</title>
17
18<meta name="description" content="Using as: Alpha Options">
19<meta name="keywords" content="Using as: Alpha Options">
20<meta name="resource-type" content="document">
21<meta name="distribution" content="global">
22<meta name="Generator" content="makeinfo">
23<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
24<link href="index.html#Top" rel="start" title="Top">
25<link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
26<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
27<link href="Alpha_002dDependent.html#Alpha_002dDependent" rel="up" title="Alpha-Dependent">
28<link href="Alpha-Syntax.html#Alpha-Syntax" rel="next" title="Alpha Syntax">
29<link href="Alpha-Notes.html#Alpha-Notes" rel="previous" title="Alpha Notes">
30<style type="text/css">
31<!--
32a.summary-letter {text-decoration: none}
33blockquote.smallquotation {font-size: smaller}
34div.display {margin-left: 3.2em}
35div.example {margin-left: 3.2em}
36div.indentedblock {margin-left: 3.2em}
37div.lisp {margin-left: 3.2em}
38div.smalldisplay {margin-left: 3.2em}
39div.smallexample {margin-left: 3.2em}
40div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
41div.smalllisp {margin-left: 3.2em}
42kbd {font-style:oblique}
43pre.display {font-family: inherit}
44pre.format {font-family: inherit}
45pre.menu-comment {font-family: serif}
46pre.menu-preformatted {font-family: serif}
47pre.smalldisplay {font-family: inherit; font-size: smaller}
48pre.smallexample {font-size: smaller}
49pre.smallformat {font-family: inherit; font-size: smaller}
50pre.smalllisp {font-size: smaller}
51span.nocodebreak {white-space:nowrap}
52span.nolinebreak {white-space:nowrap}
53span.roman {font-family:serif; font-weight:normal}
54span.sansserif {font-family:sans-serif; font-weight:normal}
55ul.no-bullet {list-style: none}
56-->
57</style>
58
59
60</head>
61
62<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
63<a name="Alpha-Options"></a>
64<div class="header">
65<p>
66Next: <a href="Alpha-Syntax.html#Alpha-Syntax" accesskey="n" rel="next">Alpha Syntax</a>, Previous: <a href="Alpha-Notes.html#Alpha-Notes" accesskey="p" rel="previous">Alpha Notes</a>, Up: <a href="Alpha_002dDependent.html#Alpha_002dDependent" accesskey="u" rel="up">Alpha-Dependent</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
67</div>
68<hr>
69<a name="Options-1"></a>
70<h4 class="subsection">9.2.2 Options</h4>
71<a name="index-Alpha-options"></a>
72<a name="index-options-for-Alpha"></a>
73
74<dl compact="compact">
75<dd><a name="index-_002dmcpu-command_002dline-option_002c-Alpha"></a>
76</dd>
77<dt><code>-m<var>cpu</var></code></dt>
78<dd><p>This option specifies the target processor.  If an attempt is made to
79assemble an instruction which will not execute on the target processor,
80the assembler may either expand the instruction as a macro or issue an
81error message.  This option is equivalent to the <code>.arch</code> directive.
82</p>
83<p>The following processor names are recognized:
84<code>21064</code>,
85<code>21064a</code>,
86<code>21066</code>,
87<code>21068</code>,
88<code>21164</code>,
89<code>21164a</code>,
90<code>21164pc</code>,
91<code>21264</code>,
92<code>21264a</code>,
93<code>21264b</code>,
94<code>ev4</code>,
95<code>ev5</code>,
96<code>lca45</code>,
97<code>ev5</code>,
98<code>ev56</code>,
99<code>pca56</code>,
100<code>ev6</code>,
101<code>ev67</code>,
102<code>ev68</code>.
103The special name <code>all</code> may be used to allow the assembler to accept
104instructions valid for any Alpha processor.
105</p>
106<p>In order to support existing practice in OSF/1 with respect to <code>.arch</code>,
107and existing practice within <code>MILO</code> (the Linux ARC bootloader), the
108numbered processor names (e.g. 21064) enable the processor-specific PALcode
109instructions, while the &ldquo;electro-vlasic&rdquo; names (e.g. <code>ev4</code>) do not.
110</p>
111<a name="index-_002dmdebug-command_002dline-option_002c-Alpha"></a>
112<a name="index-_002dno_002dmdebug-command_002dline-option_002c-Alpha"></a>
113</dd>
114<dt><code>-mdebug</code></dt>
115<dt><code>-no-mdebug</code></dt>
116<dd><p>Enables or disables the generation of <code>.mdebug</code> encapsulation for
117stabs directives and procedure descriptors.  The default is to automatically
118enable <code>.mdebug</code> when the first stabs directive is seen.
119</p>
120<a name="index-_002drelax-command_002dline-option_002c-Alpha"></a>
121</dd>
122<dt><code>-relax</code></dt>
123<dd><p>This option forces all relocations to be put into the object file, instead
124of saving space and resolving some relocations at assembly time.  Note that
125this option does not propagate all symbol arithmetic into the object file,
126because not all symbol arithmetic can be represented.  However, the option
127can still be useful in specific applications.
128</p>
129<a name="index-_002dreplace-command_002dline-option_002c-Alpha"></a>
130<a name="index-_002dnoreplace-command_002dline-option_002c-Alpha"></a>
131</dd>
132<dt><code>-replace</code></dt>
133<dt><code>-noreplace</code></dt>
134<dd><p>Enables or disables the optimization of procedure calls, both at assemblage
135and at link time.  These options are only available for VMS targets and
136<code>-replace</code> is the default.  See section 1.4.1 of the OpenVMS Linker
137Utility Manual.
138</p>
139<a name="index-_002dg-command_002dline-option_002c-Alpha"></a>
140</dd>
141<dt><code>-g</code></dt>
142<dd><p>This option is used when the compiler generates debug information.  When
143<code>gcc</code> is using <code>mips-tfile</code> to generate debug
144information for ECOFF, local labels must be passed through to the object
145file.  Otherwise this option has no effect.
146</p>
147<a name="index-_002dG-command_002dline-option_002c-Alpha"></a>
148</dd>
149<dt><code>-G<var>size</var></code></dt>
150<dd><p>A local common symbol larger than <var>size</var> is placed in <code>.bss</code>,
151while smaller symbols are placed in <code>.sbss</code>.
152</p>
153<a name="index-_002dF-command_002dline-option_002c-Alpha"></a>
154<a name="index-_002d32addr-command_002dline-option_002c-Alpha"></a>
155</dd>
156<dt><code>-F</code></dt>
157<dt><code>-32addr</code></dt>
158<dd><p>These options are ignored for backward compatibility.
159</p></dd>
160</dl>
161
162<a name="index-Alpha-Syntax"></a>
163<hr>
164<div class="header">
165<p>
166Next: <a href="Alpha-Syntax.html#Alpha-Syntax" accesskey="n" rel="next">Alpha Syntax</a>, Previous: <a href="Alpha-Notes.html#Alpha-Notes" accesskey="p" rel="previous">Alpha Notes</a>, Up: <a href="Alpha_002dDependent.html#Alpha_002dDependent" accesskey="u" rel="up">Alpha-Dependent</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
167</div>
168
169
170
171</body>
172</html>
173