R.html 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  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. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: R</title>
  15. <meta name="description" content="Using as: R">
  16. <meta name="keywords" content="Using as: R">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="Invoking.html#Invoking" rel="up" title="Invoking">
  25. <link href="statistics.html#statistics" rel="next" title="statistics">
  26. <link href="o.html#o" rel="prev" title="o">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="R"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="statistics.html#statistics" accesskey="n" rel="next">statistics</a>, Previous: <a href="o.html#o" accesskey="p" rel="prev">o</a>, Up: <a href="Invoking.html#Invoking" accesskey="u" rel="up">Invoking</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>
  61. </div>
  62. <hr>
  63. <a name="Join-Data-and-Text-Sections_003a-_002dR"></a>
  64. <h3 class="section">2.13 Join Data and Text Sections: <samp>-R</samp></h3>
  65. <a name="index-_002dR"></a>
  66. <a name="index-data-and-text-sections_002c-joining"></a>
  67. <a name="index-text-and-data-sections_002c-joining"></a>
  68. <a name="index-joining-text-and-data-sections"></a>
  69. <a name="index-merging-text-and-data-sections"></a>
  70. <p><samp>-R</samp> tells <code>as</code> to write the object file as if all
  71. data-section data lives in the text section. This is only done at
  72. the very last moment: your binary data are the same, but data
  73. section parts are relocated differently. The data section part of
  74. your object file is zero bytes long because all its bytes are
  75. appended to the text section. (See <a href="Sections.html#Sections">Sections and Relocation</a>.)
  76. </p>
  77. <p>When you specify <samp>-R</samp> it would be possible to generate shorter
  78. address displacements (because we do not have to cross between text and
  79. data section). We refrain from doing this simply for compatibility with
  80. older versions of <code>as</code>. In future, <samp>-R</samp> may work this way.
  81. </p>
  82. <p>When <code>as</code> is configured for COFF or ELF output,
  83. this option is only useful if you use sections named &lsquo;<samp>.text</samp>&rsquo; and
  84. &lsquo;<samp>.data</samp>&rsquo;.
  85. </p>
  86. <p><samp>-R</samp> is not supported for any of the HPPA targets. Using
  87. <samp>-R</samp> generates a warning from <code>as</code>.
  88. </p>
  89. </body>
  90. </html>