gas: blackfin: docs: typo fixes and fill out directive info
[deliverable/binutils-gdb.git] / gas / doc / c-sparc.texi
CommitLineData
7c31ae13
NC
1@c Copyright 1991, 1992, 1993, 1994, 1995, 1997, 1999, 2002, 2008,
2@c 2011
f7e42eb4 3@c Free Software Foundation, Inc.
252b5132
RH
4@c This is part of the GAS manual.
5@c For copying conditions, see the file as.texinfo.
6@ifset GENERIC
7@page
8@node Sparc-Dependent
9@chapter SPARC Dependent Features
10@end ifset
11@ifclear GENERIC
12@node Machine Dependencies
13@chapter SPARC Dependent Features
14@end ifclear
15
16@cindex SPARC support
17@menu
18* Sparc-Opts:: Options
19* Sparc-Aligned-Data:: Option to enforce aligned data
c15295d5 20* Sparc-Syntax:: Syntax
252b5132
RH
21* Sparc-Float:: Floating Point
22* Sparc-Directives:: Sparc Machine Directives
23@end menu
24
25@node Sparc-Opts
26@section Options
27
28@cindex options for SPARC
29@cindex SPARC options
30@cindex architectures, SPARC
31@cindex SPARC architectures
f04d18b7 32The SPARC chip family includes several successive versions, using the same
252b5132 33core instruction set, but including a few additional instructions at
f04d18b7 34each version. There are exceptions to this however. For details on what
252b5132
RH
35instructions each variant supports, please see the chip's architecture
36reference manual.
37
38By default, @code{@value{AS}} assumes the core instruction set (SPARC
39v6), but ``bumps'' the architecture level as needed: it switches to
40successively higher architectures as it encounters instructions that
41only exist in the higher levels.
42
43If not configured for SPARC v9 (@code{sparc64-*-*}) GAS will not bump
f04d18b7 44past sparclite by default, an option must be passed to enable the
252b5132
RH
45v9 instructions.
46
47GAS treats sparclite as being compatible with v8, unless an architecture
48is explicitly requested. SPARC v9 is always incompatible with sparclite.
49
50@c The order here is the same as the order of enum sparc_opcode_arch_val
51@c to give the user a sense of the order of the "bumping".
52
53@table @code
54@kindex -Av6
55@kindex Av7
56@kindex -Av8
57@kindex -Asparclet
58@kindex -Asparclite
59@kindex -Av9
60@kindex -Av9a
61@item -Av6 | -Av7 | -Av8 | -Asparclet | -Asparclite
62@itemx -Av8plus | -Av8plusa | -Av9 | -Av9a
63Use one of the @samp{-A} options to select one of the SPARC
64architectures explicitly. If you select an architecture explicitly,
65@code{@value{AS}} reports a fatal error if it encounters an instruction
66or feature requiring an incompatible or higher level.
67
68@samp{-Av8plus} and @samp{-Av8plusa} select a 32 bit environment.
69
70@samp{-Av9} and @samp{-Av9a} select a 64 bit environment and are not
71available unless GAS is explicitly configured with 64 bit environment
72support.
73
74@samp{-Av8plusa} and @samp{-Av9a} enable the SPARC V9 instruction set with
75UltraSPARC extensions.
76
77@item -xarch=v8plus | -xarch=v8plusa
f04d18b7 78For compatibility with the SunOS v9 assembler. These options are
252b5132
RH
79equivalent to -Av8plus and -Av8plusa, respectively.
80
81@item -bump
82Warn whenever it is necessary to switch to another level.
83If an architecture level is explicitly requested, GAS will not issue
84warnings until that level is reached, and will then bump the level
85as required (except between incompatible levels).
86
87@item -32 | -64
88Select the word size, either 32 bits or 64 bits.
89These options are only available with the ELF object file format,
90and require that the necessary BFD support has been included.
91@end table
92
93@node Sparc-Aligned-Data
94@section Enforcing aligned data
95
96@cindex data alignment on SPARC
97@cindex SPARC data alignment
98SPARC GAS normally permits data to be misaligned. For example, it
99permits the @code{.long} pseudo-op to be used on a byte boundary.
f04d18b7
DM
100However, the native SunOS assemblers issue an error when they see
101misaligned data.
252b5132
RH
102
103@kindex --enforce-aligned-data
104You can use the @code{--enforce-aligned-data} option to make SPARC GAS
f04d18b7 105also issue an error about misaligned data, just as the SunOS
252b5132
RH
106assemblers do.
107
108The @code{--enforce-aligned-data} option is not the default because gcc
109issues misaligned data pseudo-ops when it initializes certain packed
110data structures (structures defined using the @code{packed} attribute).
111You may have to assemble with GAS in order to initialize packed data
112structures in your own code.
113
c15295d5
DM
114@cindex SPARC syntax
115@cindex syntax, SPARC
116@node Sparc-Syntax
117@section Sparc Syntax
118The assembler syntax closely follows The Sparc Architecture Manual,
119versions 8 and 9, as well as most extensions defined by Sun
120for their UltraSPARC and Niagara line of processors.
121
122@menu
123* Sparc-Chars:: Special Characters
124* Sparc-Regs:: Register Names
1a6b486f 125* Sparc-Constants:: Constant Names
c15295d5 126* Sparc-Relocs:: Relocations
f04d18b7 127* Sparc-Size-Translations:: Size Translations
c15295d5
DM
128@end menu
129
130@node Sparc-Chars
131@subsection Special Characters
132
133@cindex line comment character, Sparc
134@cindex Sparc line comment character
7c31ae13
NC
135A @samp{!} character appearing anywhere on a line indicates the start
136of a comment that extends to the end of that line.
137
138If a @samp{#} appears as the first character of a line then the whole
139line is treated as a comment, but in this case the line could also be
140a logical line number directive (@pxref{Comments}) or a preprocessor
141control command (@pxref{Preprocessing}).
c15295d5
DM
142
143@cindex line separator, Sparc
144@cindex statement separator, Sparc
145@cindex Sparc line separator
146@samp{;} can be used instead of a newline to separate statements.
147
148@node Sparc-Regs
149@subsection Register Names
150@cindex Sparc registers
151@cindex register names, Sparc
152
153The Sparc integer register file is broken down into global,
154outgoing, local, and incoming.
155
156@itemize @bullet
157@item
158The 8 global registers are referred to as @samp{%g@var{n}}.
159
160@item
161The 8 outgoing registers are referred to as @samp{%o@var{n}}.
162
163@item
164The 8 local registers are referred to as @samp{%l@var{n}}.
165
166@item
167The 8 incoming registers are referred to as @samp{%i@var{n}}.
168
169@item
170The frame pointer register @samp{%i6} can be referenced using
171the alias @samp{%fp}.
172
173@item
174The stack pointer register @samp{%o6} can be referenced using
175the alias @samp{%sp}.
176@end itemize
177
178Floating point registers are simply referred to as @samp{%f@var{n}}.
179When assembling for pre-V9, only 32 floating point registers
180are available. For V9 and later there are 64, but there are
181restrictions when referencing the upper 32 registers. They
182can only be accessed as double or quad, and thus only even
183or quad numbered accesses are allowed. For example, @samp{%f34}
184is a legal floating point register, but @samp{%f35} is not.
185
186Certain V9 instructions allow access to ancillary state registers.
187Most simply they can be referred to as @samp{%asr@var{n}} where
f04d18b7 188@var{n} can be from 16 to 31. However, there are some aliases
c15295d5
DM
189defined to reference ASR registers defined for various UltraSPARC
190processors:
191
192@itemize @bullet
193@item
194The tick compare register is referred to as @samp{%tick_cmpr}.
195
196@item
1a6b486f
DM
197The system tick register is referred to as @samp{%stick}. An alias,
198@samp{%sys_tick}, exists but is deprecated and should not be used
199by new software.
c15295d5
DM
200
201@item
1a6b486f
DM
202The system tick compare register is referred to as @samp{%stick_cmpr}.
203An alias, @samp{%sys_tick_cmpr}, exists but is deprecated and should
204not be used by new software.
c15295d5
DM
205
206@item
207The software interrupt register is referred to as @samp{%softint}.
208
209@item
210The set software interrupt register is referred to as @samp{%set_softint}.
f04d18b7 211The mnemonic @samp{%softint_set} is provided as an alias.
c15295d5
DM
212
213@item
214The clear software interrupt register is referred to as
f04d18b7
DM
215@samp{%clear_softint}. The mnemonic @samp{%softint_clear} is provided
216as an alias.
c15295d5
DM
217
218@item
219The performance instrumentation counters register is referred to as
220@samp{%pic}.
221
222@item
223The performance control register is referred to as @samp{%pcr}.
224
225@item
226The graphics status register is referred to as @samp{%gsr}.
227
228@item
f04d18b7 229The V9 dispatch control register is referred to as @samp{%dcr}.
c15295d5
DM
230@end itemize
231
232Various V9 branch and conditional move instructions allow
233specification of which set of integer condition codes to
234test. These are referred to as @samp{%xcc} and @samp{%icc}.
235
236In V9, there are 4 sets of floating point condition codes
237which are referred to as @samp{%fcc@var{n}}.
238
239Several special privileged and non-privileged registers
240exist:
241
242@itemize @bullet
243@item
244The V9 address space identifier register is referred to as @samp{%asi}.
245
246@item
247The V9 restorable windows register is referred to as @samp{%canrestore}.
248
249@item
250The V9 savable windows register is referred to as @samp{%cansave}.
251
252@item
253The V9 clean windows register is referred to as @samp{%cleanwin}.
254
255@item
256The V9 current window pointer register is referred to as @samp{%cwp}.
257
258@item
259The floating-point queue register is referred to as @samp{%fq}.
260
261@item
f04d18b7 262The V8 co-processor queue register is referred to as @samp{%cq}.
c15295d5
DM
263
264@item
265The floating point status register is referred to as @samp{%fsr}.
266
267@item
268The other windows register is referred to as @samp{%otherwin}.
269
270@item
271The V9 program counter register is referred to as @samp{%pc}.
272
273@item
274The V9 next program counter register is referred to as @samp{%npc}.
275
276@item
277The V9 processor interrupt level register is referred to as @samp{%pil}.
278
279@item
280The V9 processor state register is referred to as @samp{%pstate}.
281
282@item
283The trap base address register is referred to as @samp{%tba}.
284
285@item
286The V9 tick register is referred to as @samp{%tick}.
287
288@item
289The V9 trap level is referred to as @samp{%tl}.
290
291@item
292The V9 trap program counter is referred to as @samp{%tpc}.
293
294@item
295The V9 trap next program counter is referred to as @samp{%tnpc}.
296
297@item
298The V9 trap state is referred to as @samp{%tstate}.
299
300@item
301The V9 trap type is referred to as @samp{%tt}.
302
303@item
304The V9 condition codes is referred to as @samp{%ccr}.
305
306@item
307The V9 floating-point registers state is referred to as @samp{%fprs}.
308
309@item
310The V9 version register is referred to as @samp{%ver}.
311
312@item
313The V9 window state register is referred to as @samp{%wstate}.
314
315@item
316The Y register is referred to as @samp{%y}.
317
318@item
319The V8 window invalid mask register is referred to as @samp{%wim}.
320
321@item
322The V8 processor state register is referred to as @samp{%psr}.
323
324@item
f04d18b7 325The V9 global register level register is referred to as @samp{%gl}.
c15295d5
DM
326@end itemize
327
328Several special register names exist for hypervisor mode code:
329
330@itemize @bullet
331@item
332The hyperprivileged processor state register is referred to as
333@samp{%hpstate}.
334
335@item
336The hyperprivileged trap state register is referred to as @samp{%htstate}.
337
338@item
339The hyperprivileged interrupt pending register is referred to as
340@samp{%hintp}.
341
342@item
343The hyperprivileged trap base address register is referred to as
344@samp{%htba}.
345
346@item
347The hyperprivileged implementation version register is referred
348to as @samp{%hver}.
349
350@item
351The hyperprivileged system tick compare register is referred
1a6b486f
DM
352to as @samp{%hstick_cmpr}. Note that there is no @samp{%hstick}
353register, the normal @samp{%stick} is used.
354@end itemize
355
356@node Sparc-Constants
357@subsection Constants
358@cindex Sparc constants
359@cindex constants, Sparc
360
361Several Sparc instructions take an immediate operand field for
362which mnemonic names exist. Two such examples are @samp{membar}
363and @samp{prefetch}. Another example are the set of V9
364memory access instruction that allow specification of an
365address space identifier.
366
367The @samp{membar} instruction specifies a memory barrier that is
368the defined by the operand which is a bitmask. The supported
369mask mnemonics are:
370
371@itemize @bullet
372@item
373@samp{#Sync} requests that all operations (including nonmemory
374reference operations) appearing prior to the @code{membar} must have
375been performed and the effects of any exceptions become visible before
376any instructions after the @code{membar} may be initiated. This
377corresponds to @code{membar} cmask field bit 2.
378
379@item
380@samp{#MemIssue} requests that all memory reference operations
381appearing prior to the @code{membar} must have been performed before
382any memory operation after the @code{membar} may be initiated. This
383corresponds to @code{membar} cmask field bit 1.
384
385@item
386@samp{#Lookaside} requests that a store appearing prior to the
387@code{membar} must complete before any load following the
388@code{membar} referencing the same address can be initiated. This
389corresponds to @code{membar} cmask field bit 0.
390
391@item
392@samp{#StoreStore} defines that the effects of all stores appearing
393prior to the @code{membar} instruction must be visible to all
394processors before the effect of any stores following the
395@code{membar}. Equivalent to the deprecated @code{stbar} instruction.
396This corresponds to @code{membar} mmask field bit 3.
397
398@item
399@samp{#LoadStore} defines all loads appearing prior to the
400@code{membar} instruction must have been performed before the effect
401of any stores following the @code{membar} is visible to any other
402processor. This corresponds to @code{membar} mmask field bit 2.
403
404@item
405@samp{#StoreLoad} defines that the effects of all stores appearing
406prior to the @code{membar} instruction must be visible to all
407processors before loads following the @code{membar} may be performed.
408This corresponds to @code{membar} mmask field bit 1.
409
410@item
411@samp{#LoadLoad} defines that all loads appearing prior to the
412@code{membar} instruction must have been performed before any loads
413following the @code{membar} may be performed. This corresponds to
414@code{membar} mmask field bit 0.
415
416@end itemize
417
418These values can be ored together, for example:
419
420@example
421membar #Sync
422membar #StoreLoad | #LoadLoad
423membar #StoreLoad | #StoreStore
424@end example
425
426The @code{prefetch} and @code{prefetcha} instructions take a prefetch
427function code. The following prefetch function code constant
428mnemonics are available:
429
430@itemize @bullet
431@item
432@samp{#n_reads} requests a prefetch for several reads, and corresponds
433to a prefetch function code of 0.
434
435@samp{#one_read} requests a prefetch for one read, and corresponds
436to a prefetch function code of 1.
437
438@samp{#n_writes} requests a prefetch for several writes (and possibly
439reads), and corresponds to a prefetch function code of 2.
440
441@samp{#one_write} requests a prefetch for one write, and corresponds
442to a prefetch function code of 3.
443
444@samp{#page} requests a prefetch page, and corresponds to a prefetch
445function code of 4.
446
447@samp{#invalidate} requests a prefetch invalidate, and corresponds to
448a prefetch function code of 16.
449
450@samp{#unified} requests a prefetch to the nearest unified cache, and
451corresponds to a prefetch function code of 17.
452
453@samp{#n_reads_strong} requests a strong prefetch for several reads,
454and corresponds to a prefetch function code of 20.
455
456@samp{#one_read_strong} requests a strong prefetch for one read,
457and corresponds to a prefetch function code of 21.
458
459@samp{#n_writes_strong} requests a strong prefetch for several writes,
460and corresponds to a prefetch function code of 22.
461
462@samp{#one_write_strong} requests a strong prefetch for one write,
463and corresponds to a prefetch function code of 23.
464
465Onle one prefetch code may be specified. Here are some examples:
466
467@example
468prefetch [%l0 + %l2], #one_read
469prefetch [%g2 + 8], #n_writes
470prefetcha [%g1] 0x8, #unified
471prefetcha [%o0 + 0x10] %asi, #n_reads
472@end example
473
474The actual behavior of a given prefetch function code is processor
475specific. If a processor does not implement a given prefetch
476function code, it will treat the prefetch instruction as a nop.
477
478For instructions that accept an immediate address space identifier,
479@code{@value{AS}} provides many mnemonics corresponding to
480V9 defined as well as UltraSPARC and Niagara extended values.
481For example, @samp{#ASI_P} and @samp{#ASI_BLK_INIT_QUAD_LDD_AIUS}.
482See the V9 and processor specific manuals for details.
483
c15295d5
DM
484@end itemize
485
486@node Sparc-Relocs
487@subsection Relocations
488@cindex Sparc relocations
489@cindex relocations, Sparc
490
491ELF relocations are available as defined in the 32-bit and 64-bit
492Sparc ELF specifications.
493
494@code{R_SPARC_HI22} is obtained using @samp{%hi} and @code{R_SPARC_LO10}
495is obtained using @samp{%lo}. Likewise @code{R_SPARC_HIX22} is
496obtained from @samp{%hix} and @code{R_SPARC_LOX10} is obtained
497using @samp{%lox}. For example:
498
499@example
500sethi %hi(symbol), %g1
501or %g1, %lo(symbol), %g1
502
503sethi %hix(symbol), %g1
504xor %g1, %lox(symbol), %g1
505@end example
506
507These ``high'' mnemonics extract bits 31:10 of their operand,
508and the ``low'' mnemonics extract bits 9:0 of their operand.
509
510V9 code model relocations can be requested as follows:
511
512@itemize @bullet
513@item
514@code{R_SPARC_HH22} is requested using @samp{%hh}. It can
515also be generated using @samp{%uhi}.
516@item
517@code{R_SPARC_HM10} is requested using @samp{%hm}. It can
518also be generated using @samp{%ulo}.
519@item
520@code{R_SPARC_LM22} is requested using @samp{%lm}.
521
522@item
523@code{R_SPARC_H44} is requested using @samp{%h44}.
524@item
525@code{R_SPARC_M44} is requested using @samp{%m44}.
526@item
527@code{R_SPARC_L44} is requested using @samp{%l44}.
528@end itemize
529
530The PC relative relocation @code{R_SPARC_PC22} can be obtained by
531enclosing an operand inside of @samp{%pc22}. Likewise, the
532@code{R_SPARC_PC10} relocation can be obtained using @samp{%pc10}.
533These are mostly used when assembling PIC code. For example, the
534standard PIC sequence on Sparc to get the base of the global offset
535table, PC relative, into a register, can be performed as:
536
537@example
538sethi %pc22(_GLOBAL_OFFSET_TABLE_-4), %l7
539add %l7, %pc10(_GLOBAL_OFFSET_TABLE_+4), %l7
540@end example
541
542Several relocations exist to allow the link editor to potentially
543optimize GOT data references. The @code{R_SPARC_GOTDATA_OP_HIX22}
544relocation can obtained by enclosing an operand inside of
545@samp{%gdop_hix22}. The @code{R_SPARC_GOTDATA_OP_LOX10}
546relocation can obtained by enclosing an operand inside of
547@samp{%gdop_lox10}. Likewise, @code{R_SPARC_GOTDATA_OP} can be
548obtained by enclosing an operand inside of @samp{%gdop}.
549For example, assuming the GOT base is in register @code{%l7}:
550
551@example
552sethi %gdop_hix22(symbol), %l1
553xor %l1, %gdop_lox10(symbol), %l1
554ld [%l7 + %l1], %l2, %gdop(symbol)
555@end example
556
557There are many relocations that can be requested for access to
558thread local storage variables. All of the Sparc TLS mnemonics
559are supported:
560
561@itemize @bullet
562@item
563@code{R_SPARC_TLS_GD_HI22} is requested using @samp{%tgd_hi22}.
564@item
565@code{R_SPARC_TLS_GD_LO10} is requested using @samp{%tgd_lo10}.
566@item
567@code{R_SPARC_TLS_GD_ADD} is requested using @samp{%tgd_add}.
568@item
569@code{R_SPARC_TLS_GD_CALL} is requested using @samp{%tgd_call}.
570
571@item
572@code{R_SPARC_TLS_LDM_HI22} is requested using @samp{%tldm_hi22}.
573@item
574@code{R_SPARC_TLS_LDM_LO10} is requested using @samp{%tldm_lo10}.
575@item
576@code{R_SPARC_TLS_LDM_ADD} is requested using @samp{%tldm_add}.
577@item
578@code{R_SPARC_TLS_LDM_CALL} is requested using @samp{%tldm_call}.
579
580@item
581@code{R_SPARC_TLS_LDO_HIX22} is requested using @samp{%tldo_hix22}.
582@item
583@code{R_SPARC_TLS_LDO_LOX10} is requested using @samp{%tldo_lox10}.
584@item
585@code{R_SPARC_TLS_LDO_ADD} is requested using @samp{%tldo_add}.
586
587@item
588@code{R_SPARC_TLS_IE_HI22} is requested using @samp{%tie_hi22}.
589@item
590@code{R_SPARC_TLS_IE_LO10} is requested using @samp{%tie_lo10}.
591@item
592@code{R_SPARC_TLS_IE_LD} is requested using @samp{%tie_ld}.
593@item
594@code{R_SPARC_TLS_IE_LDX} is requested using @samp{%tie_ldx}.
595@item
596@code{R_SPARC_TLS_IE_ADD} is requested using @samp{%tie_add}.
597
598@item
599@code{R_SPARC_TLS_LE_HIX22} is requested using @samp{%tle_hix22}.
600@item
601@code{R_SPARC_TLS_LE_LOX10} is requested using @samp{%tle_lox10}.
602@end itemize
603
604Here are some example TLS model sequences.
605
606First, General Dynamic:
607
608@example
609sethi %tgd_hi22(symbol), %l1
610add %l1, %tgd_lo10(symbol), %l1
611add %l7, %l1, %o0, %tgd_add(symbol)
612call __tls_get_addr, %tgd_call(symbol)
613nop
614@end example
615
616Local Dynamic:
617
618@example
619sethi %tldm_hi22(symbol), %l1
620add %l1, %tldm_lo10(symbol), %l1
621add %l7, %l1, %o0, %tldm_add(symbol)
622call __tls_get_addr, %tldm_call(symbol)
623nop
624
625sethi %tldo_hix22(symbol), %l1
626xor %l1, %tldo_lox10(symbol), %l1
627add %o0, %l1, %l1, %tldo_add(symbol)
628@end example
629
630Initial Exec:
631
632@example
633sethi %tie_hi22(symbol), %l1
634add %l1, %tie_lo10(symbol), %l1
635ld [%l7 + %l1], %o0, %tie_ld(symbol)
636add %g7, %o0, %o0, %tie_add(symbol)
637
638sethi %tie_hi22(symbol), %l1
639add %l1, %tie_lo10(symbol), %l1
640ldx [%l7 + %l1], %o0, %tie_ldx(symbol)
641add %g7, %o0, %o0, %tie_add(symbol)
642@end example
643
644And finally, Local Exec:
645
646@example
647sethi %tle_hix22(symbol), %l1
648add %l1, %tle_lox10(symbol), %l1
649add %g7, %l1, %l1
650@end example
651
652When assembling for 64-bit, and a secondary constant addend is
653specified in an address expression that would normally generate
654an @code{R_SPARC_LO10} relocation, the assembler will emit an
655@code{R_SPARC_OLO10} instead.
252b5132 656
f04d18b7
DM
657@node Sparc-Size-Translations
658@subsection Size Translations
659@cindex Sparc size translations
660@cindex size, translations, Sparc
661
662Often it is desirable to write code in an operand size agnostic
663manner. @code{@value{AS}} provides support for this via
664operand size opcode translations. Translations are supported
665for loads, stores, shifts, compare-and-swap atomics, and the
666@samp{clr} synthetic instruction.
667
668If generating 32-bit code, @code{@value{AS}} will generate the
66932-bit opcode. Whereas if 64-bit code is being generated,
670the 64-bit opcode will be emitted. For example @code{ldn}
671will be transformed into @code{ld} for 32-bit code and
672@code{ldx} for 64-bit code.
673
674Here is an example meant to demonstrate all the supported
675opcode translations:
676
677@example
678ldn [%o0], %o1
679ldna [%o0] %asi, %o2
680stn %o1, [%o0]
681stna %o2, [%o0] %asi
682slln %o3, 3, %o3
683srln %o4, 8, %o4
684sran %o5, 12, %o5
685casn [%o0], %o1, %o2
686casna [%o0] %asi, %o1, %o2
687clrn %g1
688@end example
689
690In 32-bit mode @code{@value{AS}} will emit:
691
692@example
693ld [%o0], %o1
694lda [%o0] %asi, %o2
695st %o1, [%o0]
696sta %o2, [%o0] %asi
697sll %o3, 3, %o3
698srl %o4, 8, %o4
699sra %o5, 12, %o5
700cas [%o0], %o1, %o2
701casa [%o0] %asi, %o1, %o2
702clr %g1
703@end example
704
705And in 64-bit mode @code{@value{AS}} will emit:
706
707@example
708ldx [%o0], %o1
709ldxa [%o0] %asi, %o2
710stx %o1, [%o0]
711stxa %o2, [%o0] %asi
712sllx %o3, 3, %o3
713srlx %o4, 8, %o4
714srax %o5, 12, %o5
715casx [%o0], %o1, %o2
716casxa [%o0] %asi, %o1, %o2
717clrx %g1
718@end example
719
720Finally, the @samp{.nword} translating directive is supported
721as well. It is documented in the section on Sparc machine
722directives.
723
252b5132
RH
724@node Sparc-Float
725@section Floating Point
726
727@cindex floating point, SPARC (@sc{ieee})
728@cindex SPARC floating point (@sc{ieee})
729The Sparc uses @sc{ieee} floating-point numbers.
730
731@node Sparc-Directives
732@section Sparc Machine Directives
733
734@cindex SPARC machine directives
735@cindex machine directives, SPARC
736The Sparc version of @code{@value{AS}} supports the following additional
737machine directives:
738
739@table @code
740@cindex @code{align} directive, SPARC
741@item .align
742This must be followed by the desired alignment in bytes.
743
744@cindex @code{common} directive, SPARC
745@item .common
746This must be followed by a symbol name, a positive number, and
747@code{"bss"}. This behaves somewhat like @code{.comm}, but the
748syntax is different.
749
750@cindex @code{half} directive, SPARC
751@item .half
752This is functionally identical to @code{.short}.
753
e06510e6
RH
754@cindex @code{nword} directive, SPARC
755@item .nword
756On the Sparc, the @code{.nword} directive produces native word sized value,
757ie. if assembling with -32 it is equivalent to @code{.word}, if assembling
758with -64 it is equivalent to @code{.xword}.
759
252b5132
RH
760@cindex @code{proc} directive, SPARC
761@item .proc
762This directive is ignored. Any text following it on the same
763line is also ignored.
764
e06510e6
RH
765@cindex @code{register} directive, SPARC
766@item .register
767This directive declares use of a global application or system register.
768It must be followed by a register name %g2, %g3, %g6 or %g7, comma and
6d8809aa 769the symbol name for that register. If symbol name is @code{#scratch},
062b7c0c 770it is a scratch register, if it is @code{#ignore}, it just suppresses any
6d8809aa
RH
771errors about using undeclared global register, but does not emit any
772information about it into the object file. This can be useful e.g. if you
773save the register before use and restore it after.
e06510e6 774
252b5132
RH
775@cindex @code{reserve} directive, SPARC
776@item .reserve
777This must be followed by a symbol name, a positive number, and
778@code{"bss"}. This behaves somewhat like @code{.lcomm}, but the
779syntax is different.
780
781@cindex @code{seg} directive, SPARC
782@item .seg
783This must be followed by @code{"text"}, @code{"data"}, or
784@code{"data1"}. It behaves like @code{.text}, @code{.data}, or
785@code{.data 1}.
786
787@cindex @code{skip} directive, SPARC
788@item .skip
789This is functionally identical to the @code{.space} directive.
790
791@cindex @code{word} directive, SPARC
792@item .word
793On the Sparc, the @code{.word} directive produces 32 bit values,
794instead of the 16 bit values it produces on many other machines.
795
796@cindex @code{xword} directive, SPARC
797@item .xword
798On the Sparc V9 processor, the @code{.xword} directive produces
79964 bit values.
800@end table
This page took 0.478292 seconds and 4 git commands to generate.