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: R</title> 17 18<meta name="description" content="Using as: R"> 19<meta name="keywords" content="Using as: R"> 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="Invoking.html#Invoking" rel="up" title="Invoking"> 28<link href="statistics.html#statistics" rel="next" title="statistics"> 29<link href="o.html#o" rel="previous" title="o"> 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="R"></a> 64<div class="header"> 65<p> 66Next: <a href="statistics.html#statistics" accesskey="n" rel="next">statistics</a>, Previous: <a href="o.html#o" accesskey="p" rel="previous">o</a>, Up: <a href="Invoking.html#Invoking" accesskey="u" rel="up">Invoking</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="Join-Data-and-Text-Sections_003a-_002dR"></a> 70<h3 class="section">2.13 Join Data and Text Sections: <samp>-R</samp></h3> 71 72<a name="index-_002dR"></a> 73<a name="index-data-and-text-sections_002c-joining"></a> 74<a name="index-text-and-data-sections_002c-joining"></a> 75<a name="index-joining-text-and-data-sections"></a> 76<a name="index-merging-text-and-data-sections"></a> 77<p><samp>-R</samp> tells <code>as</code> to write the object file as if all 78data-section data lives in the text section. This is only done at 79the very last moment: your binary data are the same, but data 80section parts are relocated differently. The data section part of 81your object file is zero bytes long because all its bytes are 82appended to the text section. (See <a href="Sections.html#Sections">Sections and Relocation</a>.) 83</p> 84<p>When you specify <samp>-R</samp> it would be possible to generate shorter 85address displacements (because we do not have to cross between text and 86data section). We refrain from doing this simply for compatibility with 87older versions of <code>as</code>. In future, <samp>-R</samp> may work this way. 88</p> 89<p>When <code>as</code> is configured for COFF or ELF output, 90this option is only useful if you use sections named ‘<samp>.text</samp>’ and 91‘<samp>.data</samp>’. 92</p> 93<p><samp>-R</samp> is not supported for any of the HPPA targets. Using 94<samp>-R</samp> generates a warning from <code>as</code>. 95</p> 96 97 98 99</body> 100</html> 101