* minor Xtensa doc fixes for gas
@ 2004-10-14 23:00 Bob Wilson
0 siblings, 0 replies; only message in thread
From: Bob Wilson @ 2004-10-14 23:00 UTC (permalink / raw)
To: binutils
[-- Attachment #1: Type: text/plain, Size: 465 bytes --]
I missed a few recent edits to the gas documentation for the Xtensa port.
Committed on mainline.
2004-10-14 Bob Wilson <bob.wilson@acm.org>
* doc/c-xtensa.texi (Xtensa Options, Absolute Literals Directive):
Remove comments about placement of literal pools.
(Literal Directive): Update description of literal placement.
(Literal Prefix Directive): Remove statement that this does not apply
to absolute-mode literals. Describe new section naming scheme.
[-- Attachment #2: c-xtensa-fixes.diff --]
[-- Type: text/plain, Size: 5837 bytes --]
Index: c-xtensa.texi
===================================================================
RCS file: /cvs/src/src/gas/doc/c-xtensa.texi,v
retrieving revision 1.3
diff -u -r1.3 c-xtensa.texi
--- c-xtensa.texi 8 Oct 2004 00:22:11 -0000 1.3
+++ c-xtensa.texi 14 Oct 2004 22:48:29 -0000
@@ -54,9 +54,7 @@
or PC-relative addressing. If the processor includes the absolute
addressing option, the default is to use absolute @code{L32R}
relocations. Otherwise, only the PC-relative @code{L32R} relocations
-can be used. Literals referenced with absolute @code{L32R} relocations
-are always placed in the @code{.lit4} section, independent of the
-placement of PC-relative literals.
+can be used.
@item --target-align | --no-target-align
@kindex --target-align
@@ -616,17 +614,17 @@
the data in a literal pool.
Literal pools for absolute mode @code{L32R} instructions
-(@pxref{Absolute Literals Directive}) are always placed in the
+(@pxref{Absolute Literals Directive}) are placed in a seperate
@code{.lit4} section. By default literal pools for PC-relative mode
-@code{L32R} instructions are placed in a separate section; however, when
-using the @samp{--text-@-section-@-literals} option (@pxref{Xtensa
-Options, ,Command Line Options}), the literal pools are placed in the
-current section. These text section literal pools are created
-automatically before @code{ENTRY} instructions and manually after
-@samp{.literal_position} directives (@pxref{Literal Position Directive,
-,literal_position}). If there are no preceding @code{ENTRY}
-instructions, explicit @code{.literal_position} directives
-must be used to place the text section literal pools; otherwise,
+@code{L32R} instructions are placed in a separate @code{.literal}
+section; however, when using the @samp{--text-@-section-@-literals}
+option (@pxref{Xtensa Options, ,Command Line Options}), the literal
+pools are placed in the current section. These text section literal
+pools are created automatically before @code{ENTRY} instructions and
+manually after @samp{.literal_position} directives (@pxref{Literal
+Position Directive, ,literal_position}). If there are no preceding
+@code{ENTRY} instructions, explicit @code{.literal_position} directives
+must be used to place the text section literal pools; otherwise,
@command{@value{AS}} will report an error.
@node Literal Position Directive
@@ -679,9 +677,6 @@
The @code{literal_prefix} directive allows you to specify different
sections to hold literals from different portions of an assembly file.
-This directive only applies to literals referenced from PC-relative
-@code{L32R} instructions; it has no effect for absolute literals
-(@pxref{Absolute Literals Directive}).
With this directive, a single assembly file can be used to generate code
into multiple sections, including literals generated by the assembler.
@@ -690,13 +685,34 @@
.end literal_prefix
@end smallexample
-For the code inside the delimited region, the assembler puts literals in
-the section @code{@var{name}.literal}. If this section does not yet
-exist, the assembler creates it. The @var{name} parameter is
-optional. If @var{name} is not specified, the literal prefix is set to
-the ``default'' for the file. This default is usually @code{.literal}
-but can be changed with the @samp{--rename-section} command-line
-argument.
+By default the assembler places literal pools in sections separate from
+the instructions, using the default literal section names of
+@code{.literal} for PC-relative mode @code{L32R} instructions and
+@code{.lit4} for absolute mode @code{L32R} instructions (@pxref{Absolute
+Literals Directive}). The @code{literal_prefix} directive causes
+different literal sections to be used for the code inside the delimited
+region. The new literal sections are determined by including @var{name}
+as a prefix to the default literal section names. If the @var{name}
+argument is omitted, the literal sections revert to the defaults. This
+directive has no effect when using the
+@samp{--text-@-section-@-literals} option (@pxref{Xtensa Options,
+,Command Line Options}).
+
+Except for two special cases, the assembler determines the new literal
+sections by simply prepending @var{name} to the default section names,
+resulting in @code{@var{name}.literal} and @code{@var{name}.lit4}
+sections. The @code{literal_prefix} directive is often used with the
+name of the current text section as the prefix argument. To facilitate
+this usage, the assembler uses special case rules when it recognizes
+@var{name} as a text section name. First, if @var{name} ends with
+@code{.text}, that suffix is not included in the literal section name.
+For example, if @var{name} is @code{.iram0.text}, then the literal
+sections will be @code{.iram0.literal} and @code{.iram0.lit4}. Second,
+if @var{name} begins with @code{.gnu.linkonce.t.}, then the literal
+section names are formed by replacing the @code{.t} substring with
+@code{.literal} and @code{.lit4}. For example, if @var{name} is
+@code{.gnu.linkonce.t.func}, the literal sections will be
+@code{.gnu.linkonce.literal.func} and @code{.gnu.linkonce.lit4.func}.
@node Absolute Literals Directive
@subsection absolute-literals
@@ -721,11 +737,6 @@
to keep track of the mode and indicate to the assembler which mode is
used in each region of code.
-Literals referenced with absolute @code{L32R} instructions are always
-placed in the @code{.lit4} section. PC-relative literals may be placed
-in the current text section or in a separate literal section, as
-described elsewhere (@pxref{Literal Directive}).
-
If the Xtensa configuration includes the absolute @code{L32R} addressing
option, the default is to assume absolute @code{L32R} addressing unless
the @samp{--no-@-absolute-@-literals} command-line option is specified.
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2004-10-14 23:00 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2004-10-14 23:00 minor Xtensa doc fixes for gas Bob Wilson
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).