179 lines
7.9 KiB
HTML
179 lines
7.9 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||
|
|
<html>
|
||
|
|
<!-- This file documents the GNU Assembler "as".
|
||
|
|
|
||
|
|
Copyright (C) 1991-2016 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".
|
||
|
|
-->
|
||
|
|
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
|
||
|
|
<head>
|
||
|
|
<title>Using as: CRIS-Pic</title>
|
||
|
|
|
||
|
|
<meta name="description" content="Using as: CRIS-Pic">
|
||
|
|
<meta name="keywords" content="Using as: CRIS-Pic">
|
||
|
|
<meta name="resource-type" content="document">
|
||
|
|
<meta name="distribution" content="global">
|
||
|
|
<meta name="Generator" content="makeinfo">
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<link href="index.html#Top" rel="start" title="Top">
|
||
|
|
<link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
|
||
|
|
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
|
||
|
|
<link href="CRIS_002dSyntax.html#CRIS_002dSyntax" rel="up" title="CRIS-Syntax">
|
||
|
|
<link href="CRIS_002dRegs.html#CRIS_002dRegs" rel="next" title="CRIS-Regs">
|
||
|
|
<link href="CRIS_002dChars.html#CRIS_002dChars" rel="prev" title="CRIS-Chars">
|
||
|
|
<style type="text/css">
|
||
|
|
<!--
|
||
|
|
a.summary-letter {text-decoration: none}
|
||
|
|
blockquote.smallquotation {font-size: smaller}
|
||
|
|
div.display {margin-left: 3.2em}
|
||
|
|
div.example {margin-left: 3.2em}
|
||
|
|
div.indentedblock {margin-left: 3.2em}
|
||
|
|
div.lisp {margin-left: 3.2em}
|
||
|
|
div.smalldisplay {margin-left: 3.2em}
|
||
|
|
div.smallexample {margin-left: 3.2em}
|
||
|
|
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
|
||
|
|
div.smalllisp {margin-left: 3.2em}
|
||
|
|
kbd {font-style:oblique}
|
||
|
|
pre.display {font-family: inherit}
|
||
|
|
pre.format {font-family: inherit}
|
||
|
|
pre.menu-comment {font-family: serif}
|
||
|
|
pre.menu-preformatted {font-family: serif}
|
||
|
|
pre.smalldisplay {font-family: inherit; font-size: smaller}
|
||
|
|
pre.smallexample {font-size: smaller}
|
||
|
|
pre.smallformat {font-family: inherit; font-size: smaller}
|
||
|
|
pre.smalllisp {font-size: smaller}
|
||
|
|
span.nocodebreak {white-space:nowrap}
|
||
|
|
span.nolinebreak {white-space:nowrap}
|
||
|
|
span.roman {font-family:serif; font-weight:normal}
|
||
|
|
span.sansserif {font-family:sans-serif; font-weight:normal}
|
||
|
|
ul.no-bullet {list-style: none}
|
||
|
|
-->
|
||
|
|
</style>
|
||
|
|
|
||
|
|
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
|
||
|
|
<a name="CRIS_002dPic"></a>
|
||
|
|
<div class="header">
|
||
|
|
<p>
|
||
|
|
Next: <a href="CRIS_002dRegs.html#CRIS_002dRegs" accesskey="n" rel="next">CRIS-Regs</a>, Previous: <a href="CRIS_002dChars.html#CRIS_002dChars" accesskey="p" rel="prev">CRIS-Chars</a>, Up: <a href="CRIS_002dSyntax.html#CRIS_002dSyntax" accesskey="u" rel="up">CRIS-Syntax</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>
|
||
|
|
</div>
|
||
|
|
<hr>
|
||
|
|
<a name="Symbols-in-position_002dindependent-code"></a>
|
||
|
|
<h4 class="subsubsection">9.8.4.2 Symbols in position-independent code</h4>
|
||
|
|
<a name="index-Symbols-in-position_002dindependent-code_002c-CRIS"></a>
|
||
|
|
<a name="index-CRIS-symbols-in-position_002dindependent-code"></a>
|
||
|
|
<a name="index-Position_002dindependent-code_002c-symbols-in_002c-CRIS"></a>
|
||
|
|
|
||
|
|
<p>When generating <a name="crispic"></a>position-independent code (SVR4
|
||
|
|
PIC) for use in cris-axis-linux-gnu or crisv32-axis-linux-gnu
|
||
|
|
shared libraries, symbol
|
||
|
|
suffixes are used to specify what kind of run-time symbol lookup
|
||
|
|
will be used, expressed in the object as different
|
||
|
|
<em>relocation types</em>. Usually, all absolute symbol values
|
||
|
|
must be located in a table, the <em>global offset table</em>,
|
||
|
|
leaving the code position-independent; independent of values of
|
||
|
|
global symbols and independent of the address of the code. The
|
||
|
|
suffix modifies the value of the symbol, into for example an
|
||
|
|
index into the global offset table where the real symbol value
|
||
|
|
is entered, or a PC-relative value, or a value relative to the
|
||
|
|
start of the global offset table. All symbol suffixes start
|
||
|
|
with the character ‘<samp>:</samp>’ (omitted in the list below). Every
|
||
|
|
symbol use in code or a read-only section must therefore have a
|
||
|
|
PIC suffix to enable a useful shared library to be created.
|
||
|
|
Usually, these constructs must not be used with an additive
|
||
|
|
constant offset as is usually allowed, i.e. no 4 as in
|
||
|
|
<code>symbol + 4</code> is allowed. This restriction is checked at
|
||
|
|
link-time, not at assembly-time.
|
||
|
|
</p>
|
||
|
|
<dl compact="compact">
|
||
|
|
<dt><code>GOT</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>Attaching this suffix to a symbol in an instruction causes the
|
||
|
|
symbol to be entered into the global offset table. The value is
|
||
|
|
a 32-bit index for that symbol into the global offset table.
|
||
|
|
The name of the corresponding relocation is
|
||
|
|
‘<samp>R_CRIS_32_GOT</samp>’. Example: <code>move.d
|
||
|
|
[$r0+extsym:GOT],$r9</code>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><code>GOT16</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>Same as for ‘<samp>GOT</samp>’, but the value is a 16-bit index into the
|
||
|
|
global offset table. The corresponding relocation is
|
||
|
|
‘<samp>R_CRIS_16_GOT</samp>’. Example: <code>move.d
|
||
|
|
[$r0+asymbol:GOT16],$r10</code>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><code>PLT</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>This suffix is used for function symbols. It causes a
|
||
|
|
<em>procedure linkage table</em>, an array of code stubs, to be
|
||
|
|
created at the time the shared object is created or linked
|
||
|
|
against, together with a global offset table entry. The value
|
||
|
|
is a pc-relative offset to the corresponding stub code in the
|
||
|
|
procedure linkage table. This arrangement causes the run-time
|
||
|
|
symbol resolver to be called to look up and set the value of the
|
||
|
|
symbol the first time the function is called (at latest;
|
||
|
|
depending environment variables). It is only safe to leave the
|
||
|
|
symbol unresolved this way if all references are function calls.
|
||
|
|
The name of the relocation is ‘<samp>R_CRIS_32_PLT_PCREL</samp>’.
|
||
|
|
Example: <code>add.d fnname:PLT,$pc</code>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><code>PLTG</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>Like PLT, but the value is relative to the beginning of the
|
||
|
|
global offset table. The relocation is
|
||
|
|
‘<samp>R_CRIS_32_PLT_GOTREL</samp>’. Example: <code>move.d
|
||
|
|
fnname:PLTG,$r3</code>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><code>GOTPLT</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>Similar to ‘<samp>PLT</samp>’, but the value of the symbol is a 32-bit
|
||
|
|
index into the global offset table. This is somewhat of a mix
|
||
|
|
between the effect of the ‘<samp>GOT</samp>’ and the ‘<samp>PLT</samp>’ suffix;
|
||
|
|
the difference to ‘<samp>GOT</samp>’ is that there will be a procedure
|
||
|
|
linkage table entry created, and that the symbol is assumed to
|
||
|
|
be a function entry and will be resolved by the run-time
|
||
|
|
resolver as with ‘<samp>PLT</samp>’. The relocation is
|
||
|
|
‘<samp>R_CRIS_32_GOTPLT</samp>’. Example: <code>jsr
|
||
|
|
[$r0+fnname:GOTPLT]</code>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><code>GOTPLT16</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>A variant of ‘<samp>GOTPLT</samp>’ giving a 16-bit value. Its
|
||
|
|
relocation name is ‘<samp>R_CRIS_16_GOTPLT</samp>’. Example: <code>jsr
|
||
|
|
[$r0+fnname:GOTPLT16]</code>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><code>GOTOFF</code></dt>
|
||
|
|
<dd>
|
||
|
|
<p>This suffix must only be attached to a local symbol, but may be
|
||
|
|
used in an expression adding an offset. The value is the
|
||
|
|
address of the symbol relative to the start of the global offset
|
||
|
|
table. The relocation name is ‘<samp>R_CRIS_32_GOTREL</samp>’.
|
||
|
|
Example: <code>move.d [$r0+localsym:GOTOFF],r3</code>
|
||
|
|
</p></dd>
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<div class="header">
|
||
|
|
<p>
|
||
|
|
Next: <a href="CRIS_002dRegs.html#CRIS_002dRegs" accesskey="n" rel="next">CRIS-Regs</a>, Previous: <a href="CRIS_002dChars.html#CRIS_002dChars" accesskey="p" rel="prev">CRIS-Chars</a>, Up: <a href="CRIS_002dSyntax.html#CRIS_002dSyntax" accesskey="u" rel="up">CRIS-Syntax</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>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|