toolchain/share/doc/as.html/Ld-Sections.html

111 lines
5.1 KiB
HTML
Raw Permalink Normal View History

2024-01-10 05:24:32 +00:00
<html lang="en">
<head>
<title>Ld Sections - Using as</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using as">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Sections.html#Sections" title="Sections">
<link rel="prev" href="Secs-Background.html#Secs-Background" title="Secs Background">
<link rel="next" href="As-Sections.html#As-Sections" title="As Sections">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This file documents the GNU Assembler "as".
Copyright (C) 1991-2019 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the
section entitled ``GNU Free Documentation License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Ld-Sections"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="As-Sections.html#As-Sections">As Sections</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Secs-Background.html#Secs-Background">Secs Background</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Sections.html#Sections">Sections</a>
<hr>
</div>
<h3 class="section">4.2 Linker Sections</h3>
<p><code>ld</code> deals with just four kinds of sections, summarized below.
<a name="index-named-sections-194"></a>
<a name="index-sections_002c-named-195"></a>
<dl><dt><strong>named sections</strong><dd><a name="index-text-section-196"></a><a name="index-data-section-197"></a><dt><strong>text section</strong><dt><strong>data section</strong><dd>These sections hold your program. <samp><span class="command">as</span></samp> and <code>ld</code> treat them as
separate but equal sections. Anything you can say of one section is
true of another.
<!-- @ifset aout -->
When the program is running, however, it is
customary for the text section to be unalterable. The
text section is often shared among processes: it contains
instructions, constants and the like. The data section of a running
program is usually alterable: for example, C variables would be stored
in the data section.
<!-- @end ifset -->
<p><a name="index-bss-section-198"></a><br><dt><strong>bss section</strong><dd>This section contains zeroed bytes when your program begins running. It
is used to hold uninitialized variables or common storage. The length of
each partial program's bss section is important, but because it starts
out containing zeroed bytes there is no need to store explicit zero
bytes in the object file. The bss section was invented to eliminate
those explicit zeros from object files.
<p><a name="index-absolute-section-199"></a><br><dt><strong>absolute section</strong><dd>Address 0 of this section is always &ldquo;relocated&rdquo; to runtime address 0.
This is useful if you want to refer to an address that <code>ld</code> must
not change when relocating. In this sense we speak of absolute
addresses being &ldquo;unrelocatable&rdquo;: they do not change during relocation.
<p><a name="index-undefined-section-200"></a><br><dt><strong>undefined section</strong><dd>This &ldquo;section&rdquo; is a catch-all for address references to objects not in
the preceding sections.
<!-- FIXME: ref to some other doc on obj-file formats could go here. -->
</dl>
<p><a name="index-relocation-example-201"></a>An idealized example of three relocatable sections follows.
The example uses the traditional section names &lsquo;<samp><span class="samp">.text</span></samp>&rsquo; and &lsquo;<samp><span class="samp">.data</span></samp>&rsquo;.
Memory addresses are on the horizontal axis.
<!-- TEXI2ROFF-KILL -->
<!-- END TEXI2ROFF-KILL -->
<pre class="smallexample"> +-----+----+--+
partial program # 1: |ttttt|dddd|00|
+-----+----+--+
text data bss
seg. seg. seg.
+---+---+---+
partial program # 2: |TTT|DDD|000|
+---+---+---+
+--+---+-----+--+----+---+-----+~~
linked program: | |TTT|ttttt| |dddd|DDD|00000|
+--+---+-----+--+----+---+-----+~~
addresses: 0 ...
</pre>
<!-- TEXI2ROFF-KILL -->
<!-- END TEXI2ROFF-KILL -->
</body></html>