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: s390 Literal Pool Entries</title> 17 18<meta name="description" content="Using as: s390 Literal Pool Entries"> 19<meta name="keywords" content="Using as: s390 Literal Pool Entries"> 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="s390-Syntax.html#s390-Syntax" rel="up" title="s390 Syntax"> 28<link href="s390-Directives.html#s390-Directives" rel="next" title="s390 Directives"> 29<link href="s390-Instruction-Marker.html#s390-Instruction-Marker" rel="previous" title="s390 Instruction Marker"> 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="s390-Literal-Pool-Entries"></a> 64<div class="header"> 65<p> 66Previous: <a href="s390-Instruction-Marker.html#s390-Instruction-Marker" accesskey="p" rel="previous">s390 Instruction Marker</a>, Up: <a href="s390-Syntax.html#s390-Syntax" accesskey="u" rel="up">s390 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> 67</div> 68<hr> 69<a name="Literal-Pool-Entries"></a> 70<h4 class="subsubsection">9.41.3.8 Literal Pool Entries</h4> 71<a name="index-literal-pool-entries_002c-s390"></a> 72<a name="index-s390-literal-pool-entries"></a> 73 74<p>A literal pool is a collection of values. To access the values a pointer 75to the literal pool is loaded to a register, the literal pool register. 76Usually, register %r13 is used as the literal pool register 77(<a href="s390-Register.html#s390-Register">s390 Register</a>). Literal pool entries are created by adding the 78suffix :lit1, :lit2, :lit4, or :lit8 to the end of an expression for an 79instruction operand. The expression is added to the literal pool and the 80operand is replaced with the offset to the literal in the literal pool. 81</p> 82<dl compact="compact"> 83<dt><code>:lit1</code></dt> 84<dd><p>The literal pool entry is created as an 8-bit value. An operand modifier 85must not be used for the original expression. 86</p></dd> 87<dt><code>:lit2</code></dt> 88<dd><p>The literal pool entry is created as a 16 bit value. The operand modifier 89@got may be used in the original expression. The term ‘<samp>x@got:lit2</samp>’ 90will put the got offset for the global symbol x to the literal pool as 9116 bit value. 92</p></dd> 93<dt><code>:lit4</code></dt> 94<dd><p>The literal pool entry is created as a 32-bit value. The operand modifier 95@got and @plt may be used in the original expression. The term 96‘<samp>x@got:lit4</samp>’ will put the got offset for the global symbol x to the 97literal pool as a 32-bit value. The term ‘<samp>x@plt:lit4</samp>’ will put the 98plt offset for the global symbol x to the literal pool as a 32-bit value. 99</p></dd> 100<dt><code>:lit8</code></dt> 101<dd><p>The literal pool entry is created as a 64-bit value. The operand modifier 102@got and @plt may be used in the original expression. The term 103‘<samp>x@got:lit8</samp>’ will put the got offset for the global symbol x to the 104literal pool as a 64-bit value. The term ‘<samp>x@plt:lit8</samp>’ will put the 105plt offset for the global symbol x to the literal pool as a 64-bit value. 106</p></dd> 107</dl> 108 109<p>The assembler directive ‘<samp>.ltorg</samp>’ is used to emit all literal pool 110entries to the current position. 111</p> 112<hr> 113<div class="header"> 114<p> 115Previous: <a href="s390-Instruction-Marker.html#s390-Instruction-Marker" accesskey="p" rel="previous">s390 Instruction Marker</a>, Up: <a href="s390-Syntax.html#s390-Syntax" accesskey="u" rel="up">s390 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> 116</div> 117 118 119 120</body> 121</html> 122