Initial import of binutils 2.22 on the new vendor branch
[dragonfly.git] / contrib / binutils-2.21 / gas / doc / c-microblaze.texi
1 @c Copyright 2009
2 @c Free Software Foundation, Inc.
3 @c This is part of the GAS manual.
4 @c For copying conditions, see the file as.texinfo.
5 @ifset GENERIC
6 @page
7 @node MicroBlaze-Dependent
8 @chapter MicroBlaze Dependent Features
9 @end ifset
10 @ifclear GENERIC
11 @node Machine Dependencies
12 @chapter MicroBlaze Dependent Features
13 @end ifclear
14
15 @cindex MicroBlaze architectures
16 The Xilinx MicroBlaze processor family includes several variants, all using 
17 the same core instruction set.  This chapter covers features of the @sc{gnu} 
18 assembler that are specific to the MicroBlaze architecture.  For details about 
19 the MicroBlaze instruction set, please see the @cite{MicroBlaze Processor
20 Reference Guide (UG081)} available at www.xilinx.com.
21
22 @cindex MicroBlaze support
23 @menu
24 * MicroBlaze Directives::           Directives for MicroBlaze Processors.
25 @end menu
26
27 @node MicroBlaze Directives
28 @section Directives
29 @cindex MicroBlaze directives 
30 A number of assembler directives are available for MicroBlaze. 
31
32 @table @code
33 @item .data8 @var{expression},...
34 This directive is an alias for @code{.byte}. Each expression is assembled 
35 into an eight-bit value.
36
37 @item .data16 @var{expression},...
38 This directive is an alias for @code{.hword}. Each expression is assembled 
39 into an 16-bit value.
40
41 @item .data32 @var{expression},...
42 This directive is an alias for @code{.word}. Each expression is assembled 
43 into an 32-bit value.
44
45 @item .ent @var{name}[,@var{label}]
46 This directive is an alias for @code{.func} denoting the start of function 
47 @var{name} at (optional) @var{label}.  
48
49 @item .end @var{name}[,@var{label}]
50 This directive is an alias for @code{.endfunc} denoting the end of function 
51 @var{name}.
52
53 @item .gpword @var{label},...
54 This directive is an alias for @code{.rva}.  The resolved address of @var{label}
55 is stored in the data section.
56
57 @item .weakext @var{label}
58 Declare that @var{label} is a weak external symbol.
59
60 @item .rodata
61 Switch to .rodata section. Equivalent to @code{.section .rodata}
62
63 @item .sdata2
64 Switch to .sdata2 section. Equivalent to @code{.section .sdata2}
65
66 @item .sdata
67 Switch to .sdata section. Equivalent to @code{.section .sdata}
68
69 @item .bss
70 Switch to .bss section. Equivalent to @code{.section .bss}
71
72 @item .sbss
73 Switch to .sbss section. Equivalent to @code{.section .sbss}
74 @end table