as: s390 Literal Pool Entries
9.40.3.8 Literal Pool Entries
.............................
A literal pool is a collection of values. To access the values a
pointer to the literal pool is loaded to a register, the literal pool
register. Usually, register %r13 is used as the literal pool register
(s390 Register). Literal pool entries are created by adding the
suffix :lit1, :lit2, :lit4, or :lit8 to the end of an expression for an
instruction operand. The expression is added to the literal pool and
the operand is replaced with the offset to the literal in the literal
pool.
':lit1'
The literal pool entry is created as an 8-bit value. An operand
modifier must not be used for the original expression.
':lit2'
The literal pool entry is created as a 16 bit value. The operand
modifier @got may be used in the original expression. The term
'x@got:lit2' will put the got offset for the global symbol x to the
literal pool as 16 bit value.
':lit4'
The literal pool entry is created as a 32-bit value. The operand
modifier @got and @plt may be used in the original expression. The
term 'x@got:lit4' will put the got offset for the global symbol x
to the literal pool as a 32-bit value. The term 'x@plt:lit4' will
put the plt offset for the global symbol x to the literal pool as a
32-bit value.
':lit8'
The literal pool entry is created as a 64-bit value. The operand
modifier @got and @plt may be used in the original expression. The
term 'x@got:lit8' will put the got offset for the global symbol x
to the literal pool as a 64-bit value. The term 'x@plt:lit8' will
put the plt offset for the global symbol x to the literal pool as a
64-bit value.
The assembler directive '.ltorg' is used to emit all literal pool
entries to the current position.