Merge branch 'vendor/GCC44'
[dragonfly.git] / contrib / binutils-2.21 / gas / doc / c-score.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 SCORE-Dependent
8 @chapter SCORE Dependent Features
9 @end ifset
10 @ifclear GENERIC
11 @node Machine Dependencies
12 @chapter SCORE Dependent Features
13 @end ifclear
14
15 @cindex SCORE processor
16 @menu
17 * SCORE-Opts::          Assembler options
18 * SCORE-Pseudo::        SCORE Assembler Directives
19 @end menu
20
21 @node SCORE-Opts 
22 @section Options
23
24 @cindex options for SCORE
25 @cindex SCORE options
26 @cindex architectures, SCORE
27 @cindex SCORE architectures
28
29 The following table lists all available SCORE options.
30
31 @table @code
32 @item -G @var{num}
33 This option sets the largest size of an object that can be referenced
34 implicitly with the @code{gp} register. The default value is 8.
35
36 @item -EB
37 Assemble code for a big-endian cpu
38
39 @itemx -EL
40 Assemble code for a little-endian cpu
41
42 @item -FIXDD 
43 Assemble code for fix data dependency
44
45 @item -NWARN 
46 Assemble code for no warning message for fix data dependency
47
48 @item -SCORE5
49 Assemble code for target is SCORE5
50
51 @itemx -SCORE5U
52 Assemble code for target is SCORE5U
53
54 @itemx -SCORE7
55 Assemble code for target is SCORE7, this is default setting
56
57 @itemx -SCORE3
58 Assemble code for target is SCORE3
59
60 @item -march=score7
61 Assemble code for target is SCORE7, this is default setting
62
63 @item -march=score3
64 Assemble code for target is SCORE3
65
66 @item -USE_R1 
67 Assemble code for no warning message when using temp register r1
68
69 @item -KPIC
70 Generate code for PIC.  This option tells the assembler to generate
71 score position-independent macro expansions.  It also tells the
72 assembler to mark the output file as PIC.
73
74 @item -O0
75 Assembler will not perform any optimizations
76
77 @item -V 
78 Sunplus release version
79
80 @end table
81
82 @node SCORE-Pseudo
83 @section SCORE Assembler Directives
84
85 @cindex directives for SCORE
86 @cindex SCORE directives
87 A number of assembler directives are available for SCORE.  The
88 following table is far from complete.
89
90 @table @code
91 @item .set nwarn 
92 Let the assembler not to generate warnings if the source machine 
93 language instructions happen data dependency.
94
95 @item .set fixdd 
96 Let the assembler to insert bubbles (32 bit nop instruction / 
97 16 bit nop! Instruction) if the source machine language instructions 
98 happen data dependency.
99
100 @item .set nofixdd 
101 Let the assembler to generate warnings if the source machine 
102 language instructions happen data dependency. (Default)
103
104 @item .set r1
105 Let the assembler not to generate warnings if the source program 
106 uses r1. allow user to use r1 
107
108 @item set nor1
109 Let the assembler to generate warnings if the source program uses
110 r1. (Default)
111
112 @item .sdata
113 Tell the assembler to add subsequent data into the sdata section  
114
115 @item .rdata
116 Tell the assembler to add subsequent data into the rdata section
117
118 @item .frame "frame-register", "offset", "return-pc-register"
119 Describe a stack frame. "frame-register" is the frame register, 
120 "offset" is the distance from the frame register to the virtual 
121 frame pointer, "return-pc-register" is the return program register. 
122 You must use ".ent" before ".frame" and only one ".frame" can be 
123 used per ".ent". 
124
125 @item .mask "bitmask", "frameoffset"
126 Indicate which of the integer registers are saved in the current 
127 function's stack frame, this is for the debugger to explain the 
128 frame chain.
129
130 @item .ent "proc-name"
131 Set the beginning of the procedure "proc_name". Use this directive 
132 when you want to generate information for the debugger. 
133
134 @item .end proc-name
135 Set the end of a procedure. Use this directive to generate information 
136 for the debugger. 
137
138 @item .bss
139 Switch the destination of following statements into the bss section, 
140 which is used for data that is uninitialized anywhere.  
141
142 @end table