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: s390 Options</title> 17 18<meta name="description" content="Using as: s390 Options"> 19<meta name="keywords" content="Using as: s390 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="S_002f390_002dDependent.html#S_002f390_002dDependent" rel="up" title="S/390-Dependent"> 28<link href="s390-Characters.html#s390-Characters" rel="next" title="s390 Characters"> 29<link href="S_002f390_002dDependent.html#S_002f390_002dDependent" rel="previous" title="S/390-Dependent"> 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="s390-Options"></a> 64<div class="header"> 65<p> 66Next: <a href="s390-Characters.html#s390-Characters" accesskey="n" rel="next">s390 Characters</a>, Up: <a href="S_002f390_002dDependent.html#S_002f390_002dDependent" accesskey="u" rel="up">S/390-Dependent</a> [<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-21"></a> 70<h4 class="subsection">9.41.1 Options</h4> 71<a name="index-options-for-s390"></a> 72<a name="index-s390-options"></a> 73 74<p>The following table lists all available s390 specific options: 75</p> 76<dl compact="compact"> 77<dd><a name="index-_002dm31-option_002c-s390"></a> 78<a name="index-_002dm64-option_002c-s390"></a> 79</dd> 80<dt><code>-m31 | -m64</code></dt> 81<dd><p>Select 31- or 64-bit ABI implying a word size of 32- or 64-bit. 82</p> 83<p>These options are only available with the ELF object file format, and 84require that the necessary BFD support has been included (on a 31-bit 85platform you must add –enable-64-bit-bfd on the call to the configure 86script to enable 64-bit usage and use s390x as target platform). 87</p> 88<a name="index-_002dmesa-option_002c-s390"></a> 89<a name="index-_002dmzarch-option_002c-s390"></a> 90</dd> 91<dt><code>-mesa | -mzarch</code></dt> 92<dd><p>Select the architecture mode, either the Enterprise System Architecture 93(esa) mode or the z/Architecture mode (zarch). 94</p> 95<p>The 64-bit instructions are only available with the z/Architecture mode. 96The combination of ‘<samp>-m64</samp>’ and ‘<samp>-mesa</samp>’ results in a warning 97message. 98</p> 99<a name="index-_002dmarch_003d-option_002c-s390"></a> 100</dd> 101<dt><code>-march=<var>CPU</var></code></dt> 102<dd><p>This option specifies the target processor. The following processor names 103are recognized: 104<code>g5</code> (or <code>arch3</code>), 105<code>g6</code>, 106<code>z900</code> (or <code>arch5</code>), 107<code>z990</code> (or <code>arch6</code>), 108<code>z9-109</code>, 109<code>z9-ec</code> (or <code>arch7</code>), 110<code>z10</code> (or <code>arch8</code>), 111<code>z196</code> (or <code>arch9</code>), 112<code>zEC12</code> (or <code>arch10</code>), 113<code>z13</code> (or <code>arch11</code>), 114<code>z14</code> (or <code>arch12</code>), 115<code>z15</code> (or <code>arch13</code>), and 116<code>arch14</code>. 117</p> 118<p>Assembling an instruction that is not supported on the target 119processor results in an error message. 120</p> 121<p>The processor names starting with <code>arch</code> refer to the edition 122number in the Principle of Operations manual. They can be used as 123alternate processor names and have been added for compatibility with 124the IBM XL compiler. 125</p> 126<p><code>arch3</code>, <code>g5</code> and <code>g6</code> cannot be used with the 127‘<samp>-mzarch</samp>’ option since the z/Architecture mode is not supported 128on these processor levels. 129</p> 130<p>There is no <code>arch4</code> option supported. <code>arch4</code> matches 131<code>-march=arch5 -mesa</code>. 132</p> 133<a name="index-_002dmregnames-option_002c-s390"></a> 134</dd> 135<dt><code>-mregnames</code></dt> 136<dd><p>Allow symbolic names for registers. 137</p> 138<a name="index-_002dmno_002dregnames-option_002c-s390"></a> 139</dd> 140<dt><code>-mno-regnames</code></dt> 141<dd><p>Do not allow symbolic names for registers. 142</p> 143<a name="index-_002dmwarn_002dareg_002dzero-option_002c-s390"></a> 144</dd> 145<dt><code>-mwarn-areg-zero</code></dt> 146<dd><p>Warn whenever the operand for a base or index register has been specified 147but evaluates to zero. This can indicate the misuse of general purpose 148register 0 as an address register. 149</p> 150</dd> 151</dl> 152 153<hr> 154<div class="header"> 155<p> 156Next: <a href="s390-Characters.html#s390-Characters" accesskey="n" rel="next">s390 Characters</a>, Up: <a href="S_002f390_002dDependent.html#S_002f390_002dDependent" accesskey="u" rel="up">S/390-Dependent</a> [<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> 157</div> 158 159 160 161</body> 162</html> 163