1<html lang="en"> 2<head> 3<title>Xtensa Options - Using as</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="Using as"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="up" href="Xtensa_002dDependent.html#Xtensa_002dDependent" title="Xtensa-Dependent"> 9<link rel="next" href="Xtensa-Syntax.html#Xtensa-Syntax" title="Xtensa Syntax"> 10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 11<!-- 12This file documents the GNU Assembler "as". 13 14Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 152000, 2001, 2002, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, 16Inc. 17 18Permission is granted to copy, distribute and/or modify this document 19under the terms of the GNU Free Documentation License, Version 1.3 20or any later version published by the Free Software Foundation; 21with no Invariant Sections, with no Front-Cover Texts, and with no 22Back-Cover Texts. A copy of the license is included in the 23section entitled ``GNU Free Documentation License''. 24 25--> 26<meta http-equiv="Content-Style-Type" content="text/css"> 27<style type="text/css"><!-- 28 pre.display { font-family:inherit } 29 pre.format { font-family:inherit } 30 pre.smalldisplay { font-family:inherit; font-size:smaller } 31 pre.smallformat { font-family:inherit; font-size:smaller } 32 pre.smallexample { font-size:smaller } 33 pre.smalllisp { font-size:smaller } 34 span.sc { font-variant:small-caps } 35 span.roman { font-family:serif; font-weight:normal; } 36 span.sansserif { font-family:sans-serif; font-weight:normal; } 37--></style> 38<link rel="stylesheet" type="text/css" href="../cs.css"> 39</head> 40<body> 41<div class="node"> 42<a name="Xtensa-Options"></a> 43<p> 44Next: <a rel="next" accesskey="n" href="Xtensa-Syntax.html#Xtensa-Syntax">Xtensa Syntax</a>, 45Up: <a rel="up" accesskey="u" href="Xtensa_002dDependent.html#Xtensa_002dDependent">Xtensa-Dependent</a> 46<hr> 47</div> 48 49<h4 class="subsection">9.46.1 Command Line Options</h4> 50 51<!-- man begin OPTIONS --> 52 <dl> 53<dt><code>--text-section-literals | --no-text-section-literals</code><dd><a name="index-g_t_002d_002dtext_002dsection_002dliterals-2163"></a><a name="index-g_t_002d_002dno_002dtext_002dsection_002dliterals-2164"></a>Control the treatment of literal pools. The default is 54‘<samp><span class="samp">--no-text-section-literals</span></samp>’, which places literals in 55separate sections in the output file. This allows the literal pool to be 56placed in a data RAM/ROM. With ‘<samp><span class="samp">--text-section-literals</span></samp>’, the 57literals are interspersed in the text section in order to keep them as 58close as possible to their references. This may be necessary for large 59assembly files, where the literals would otherwise be out of range of the 60<code>L32R</code> instructions in the text section. These options only affect 61literals referenced via PC-relative <code>L32R</code> instructions; literals 62for absolute mode <code>L32R</code> instructions are handled separately. 63See <a href="Literal-Directive.html#Literal-Directive">literal</a>. 64 65 <br><dt><code>--absolute-literals | --no-absolute-literals</code><dd><a name="index-g_t_002d_002dabsolute_002dliterals-2165"></a><a name="index-g_t_002d_002dno_002dabsolute_002dliterals-2166"></a>Indicate to the assembler whether <code>L32R</code> instructions use absolute 66or PC-relative addressing. If the processor includes the absolute 67addressing option, the default is to use absolute <code>L32R</code> 68relocations. Otherwise, only the PC-relative <code>L32R</code> relocations 69can be used. 70 71 <br><dt><code>--target-align | --no-target-align</code><dd><a name="index-g_t_002d_002dtarget_002dalign-2167"></a><a name="index-g_t_002d_002dno_002dtarget_002dalign-2168"></a>Enable or disable automatic alignment to reduce branch penalties at some 72expense in code size. See <a href="Xtensa-Automatic-Alignment.html#Xtensa-Automatic-Alignment">Automatic Instruction Alignment</a>. This optimization is enabled by default. Note 73that the assembler will always align instructions like <code>LOOP</code> that 74have fixed alignment requirements. 75 76 <br><dt><code>--longcalls | --no-longcalls</code><dd><a name="index-g_t_002d_002dlongcalls-2169"></a><a name="index-g_t_002d_002dno_002dlongcalls-2170"></a>Enable or disable transformation of call instructions to allow calls 77across a greater range of addresses. See <a href="Xtensa-Call-Relaxation.html#Xtensa-Call-Relaxation">Function Call Relaxation</a>. This option should be used when call 78targets can potentially be out of range. It may degrade both code size 79and performance, but the linker can generally optimize away the 80unnecessary overhead when a call ends up within range. The default is 81‘<samp><span class="samp">--no-longcalls</span></samp>’. 82 83 <br><dt><code>--transform | --no-transform</code><dd><a name="index-g_t_002d_002dtransform-2171"></a><a name="index-g_t_002d_002dno_002dtransform-2172"></a>Enable or disable all assembler transformations of Xtensa instructions, 84including both relaxation and optimization. The default is 85‘<samp><span class="samp">--transform</span></samp>’; ‘<samp><span class="samp">--no-transform</span></samp>’ should only be used in the 86rare cases when the instructions must be exactly as specified in the 87assembly source. Using ‘<samp><span class="samp">--no-transform</span></samp>’ causes out of range 88instruction operands to be errors. 89 90 <br><dt><code>--rename-section </code><var>oldname</var><code>=</code><var>newname</var><dd><a name="index-g_t_002d_002drename_002dsection-2173"></a>Rename the <var>oldname</var> section to <var>newname</var>. This option can be used 91multiple times to rename multiple sections. 92</dl> 93 94<!-- man end --> 95 </body></html> 96 97