annotate final_main/chapter5.tex @ 13:ddfca5037e41

update
author mir3636
date Wed, 15 Feb 2017 20:32:30 +0900
parents 11ad5b3e7b85
children 97f70e469150
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
mir3636
parents: 4
diff changeset
1 \chapter{Context、stub Code Segment の自動生成}
mir3636
parents: 4
diff changeset
2
mir3636
parents: 4
diff changeset
3 Gears OS では 3 章で述べたように通常の Computation の他に Context や stub などの Meta Computation を記述する必要がある。
mir3636
parents: 4
diff changeset
4 Gears OS を現在の CbC の機能のみを用いて記述すると Context や stub Code Gear の記述を行わなくてはならず、これには多くの労力を要する。
9
mir3636
parents: 8
diff changeset
5 そのため、この記述を助けるために Context を生成する generate\_context と stub Code Gear を生成する generate\_stub を perl スクリプトで作成した。
5
mir3636
parents: 4
diff changeset
6
mir3636
parents: 4
diff changeset
7 \section{stub Code Segment の生成}
mir3636
parents: 4
diff changeset
8 stub Code Gear は Code Gear 間の継続に挟まれる Code Gear が必要な Data Gear を Context から取り出す処理を行うものである。
mir3636
parents: 4
diff changeset
9 stub Code Gear は Code Gear 毎に記述する必要があり、そのCode Gear の引数を見て取り出す Data Gear を選択する。
mir3636
parents: 4
diff changeset
10 stub Code Gear を 自動生成することによって Code Gear の記述量を約半分にすることができる。
mir3636
parents: 4
diff changeset
11
9
mir3636
parents: 8
diff changeset
12 stub を生成するために generate\_stub は指定された cbc ファイルの \_\_code型である Code Gear を取得し、引数から必要な Data Gear を選択する。
13
mir3636
parents: 9
diff changeset
13 generate\_stub は引数と interface を照らし合わせ、Gearef または GearImpl を決定する(リスト\ref{generate_stub})。
8
mir3636
parents: 7
diff changeset
14 この時既に stub Code Gear が記述されている Code Gear は無視される。
5
mir3636
parents: 4
diff changeset
15
9
mir3636
parents: 8
diff changeset
16 cbc ファイル(リスト\ref{stack_cbc}) から、生成した stub Code Gear を加えて c ファイル(\ref{stack_c})に変換を行う。
6
mir3636
parents: 5
diff changeset
17
13
mir3636
parents: 9
diff changeset
18 \begin{lstlisting}[frame=lrbt,label=generate_stub,caption={\footnotesize generate stub}]
mir3636
parents: 9
diff changeset
19 sub generateStubArgs {
mir3636
parents: 9
diff changeset
20 my($codeGearName, $varName, $typeName, $typeField, $interface,$output) = @_;
mir3636
parents: 9
diff changeset
21 my $varname1 = $output?"O_$varName":$varName;
mir3636
parents: 9
diff changeset
22 for my $n ( @{$dataGearVar{$codeGearName}} ) {
mir3636
parents: 9
diff changeset
23 # we already have it
mir3636
parents: 9
diff changeset
24 return 0 if ( $n eq $varname1);
mir3636
parents: 9
diff changeset
25 }
mir3636
parents: 9
diff changeset
26 push @{$dataGearVar{$codeGearName}}, $varname1;
mir3636
parents: 9
diff changeset
27 if ($typeName eq $implementation) {
mir3636
parents: 9
diff changeset
28 # get implementation
mir3636
parents: 9
diff changeset
29 $dataGearName{$codeGearName} .= "\t$typeName* $varName = ($typeName*)GearImpl(context, $interface, $varName);\n";
mir3636
parents: 9
diff changeset
30 } else {
mir3636
parents: 9
diff changeset
31 for my $ivar (keys %{$var{$interface}}) {
mir3636
parents: 9
diff changeset
32 # input data gear field
mir3636
parents: 9
diff changeset
33 if ($varName eq $ivar) {
mir3636
parents: 9
diff changeset
34 if ($typeName eq $var{$interface}->{$ivar}) {
mir3636
parents: 9
diff changeset
35 if ($output) {
mir3636
parents: 9
diff changeset
36 $dataGearName{$codeGearName} .= "\t$typeName** O_$varName = &Gearef(context, $interface)->$varName;\n";
mir3636
parents: 9
diff changeset
37 $outputVar{$codeGearName} .= "\t$typeName* $varName;\n";
mir3636
parents: 9
diff changeset
38 return 1;
mir3636
parents: 9
diff changeset
39 }
mir3636
parents: 9
diff changeset
40
mir3636
parents: 9
diff changeset
41 $dataGearName{$codeGearName} .= "\t$typeName* $varName = Gearef(context, $interface)->$varName;\n";
mir3636
parents: 9
diff changeset
42 return 1;
mir3636
parents: 9
diff changeset
43 }
mir3636
parents: 9
diff changeset
44 }
mir3636
parents: 9
diff changeset
45 }
mir3636
parents: 9
diff changeset
46 for my $cName (keys %{$code{$interface}}) {
mir3636
parents: 9
diff changeset
47 if ($varName eq $cName) {
mir3636
parents: 9
diff changeset
48 # continuation field
mir3636
parents: 9
diff changeset
49 $dataGearName{$codeGearName} .= "\tenum Code $varName = Gearef(context, $interface)->$varName;\n";
mir3636
parents: 9
diff changeset
50 return 1;
mir3636
parents: 9
diff changeset
51 }
mir3636
parents: 9
diff changeset
52 }
mir3636
parents: 9
diff changeset
53 # global variable case
mir3636
parents: 9
diff changeset
54 $dataGearName{$codeGearName} .= "\t$typeName* $varName = Gearef(context, $typeName);\n";
mir3636
parents: 9
diff changeset
55 return 1;
mir3636
parents: 9
diff changeset
56 }
mir3636
parents: 9
diff changeset
57 }
mir3636
parents: 9
diff changeset
58 \end{lstlisting}
mir3636
parents: 9
diff changeset
59
9
mir3636
parents: 8
diff changeset
60 \begin{lstlisting}[frame=lrbt,label=stack_cbc,caption={\footnotesize cbcファイルの例}]
5
mir3636
parents: 4
diff changeset
61 #include "../context.h"
mir3636
parents: 4
diff changeset
62
mir3636
parents: 4
diff changeset
63 Stack* createSingleLinkedStack(struct Context* context) {
mir3636
parents: 4
diff changeset
64 struct Stack* stack = new Stack();
mir3636
parents: 4
diff changeset
65 struct SingleLinkedStack* singleLinkedStack = new SingleLinkedStack();
mir3636
parents: 4
diff changeset
66 stack->stack = (union Data*)singleLinkedStack;
mir3636
parents: 4
diff changeset
67 singleLinkedStack->top = NULL;
mir3636
parents: 4
diff changeset
68 stack->push = C_pushSingleLinkedStack;
mir3636
parents: 4
diff changeset
69 stack->pop = C_popSingleLinkedStack;
mir3636
parents: 4
diff changeset
70 stack->get = C_getSingleLinkedStack;
mir3636
parents: 4
diff changeset
71 stack->isEmpty = C_isEmptySingleLinkedStack;
mir3636
parents: 4
diff changeset
72 stack->clear = C_clearSingleLinkedStack;
mir3636
parents: 4
diff changeset
73 return stack;
mir3636
parents: 4
diff changeset
74 }
mir3636
parents: 4
diff changeset
75
mir3636
parents: 4
diff changeset
76 __code clearSingleLinkedStack(struct SingleLinkedStack* stack,__code next(...)) {
mir3636
parents: 4
diff changeset
77 stack->top = NULL;
mir3636
parents: 4
diff changeset
78 goto next(...);
mir3636
parents: 4
diff changeset
79 }
mir3636
parents: 4
diff changeset
80
mir3636
parents: 4
diff changeset
81 __code pushSingleLinkedStack(struct SingleLinkedStack* stack,union Data* data, __code next(...)) {
mir3636
parents: 4
diff changeset
82 Element* element = new Element();
mir3636
parents: 4
diff changeset
83 element->next = stack->top;
mir3636
parents: 4
diff changeset
84 element->data = data;
mir3636
parents: 4
diff changeset
85 stack->top = element;
mir3636
parents: 4
diff changeset
86 goto next(...);
mir3636
parents: 4
diff changeset
87 }
mir3636
parents: 4
diff changeset
88
mir3636
parents: 4
diff changeset
89 __code popSingleLinkedStack(struct SingleLinkedStack* stack, __code next(union Data* data, ...)) {
mir3636
parents: 4
diff changeset
90 if (stack->top) {
mir3636
parents: 4
diff changeset
91 data = stack->top->data;
mir3636
parents: 4
diff changeset
92 stack->top = stack->top->next;
mir3636
parents: 4
diff changeset
93 } else {
mir3636
parents: 4
diff changeset
94 data = NULL;
mir3636
parents: 4
diff changeset
95 }
mir3636
parents: 4
diff changeset
96 goto next(data, ...);
mir3636
parents: 4
diff changeset
97 }
mir3636
parents: 4
diff changeset
98
mir3636
parents: 4
diff changeset
99 __code getSingleLinkedStack(struct SingleLinkedStack* stack, __code next(union Data* data, ...)) {
mir3636
parents: 4
diff changeset
100 if (stack->top)
mir3636
parents: 4
diff changeset
101 data = stack->top->data;
mir3636
parents: 4
diff changeset
102 else
mir3636
parents: 4
diff changeset
103 data = NULL;
mir3636
parents: 4
diff changeset
104 goto next(data, ...);
mir3636
parents: 4
diff changeset
105 }
mir3636
parents: 4
diff changeset
106
mir3636
parents: 4
diff changeset
107 __code isEmptySingleLinkedStack(struct SingleLinkedStack* stack, __code next(...), __code whenEmpty(...)) {
mir3636
parents: 4
diff changeset
108 if (stack->top)
mir3636
parents: 4
diff changeset
109 goto next(...);
mir3636
parents: 4
diff changeset
110 else
mir3636
parents: 4
diff changeset
111 goto whenEmpty(...);
mir3636
parents: 4
diff changeset
112 }
mir3636
parents: 4
diff changeset
113 \end{lstlisting}
mir3636
parents: 4
diff changeset
114
7
mir3636
parents: 6
diff changeset
115 \begin{lstlisting}[frame=lrbt,label=stack_c,caption={\footnotesize 生成される stub}]
5
mir3636
parents: 4
diff changeset
116 __code clearSingleLinkedStack(struct Context *context,struct SingleLinkedStack* stack,enum Code next) {
mir3636
parents: 4
diff changeset
117 stack->top = NULL;
mir3636
parents: 4
diff changeset
118 goto meta(context, next);
mir3636
parents: 4
diff changeset
119 }
mir3636
parents: 4
diff changeset
120
mir3636
parents: 4
diff changeset
121 __code clearSingleLinkedStack_stub(struct Context* context) {
mir3636
parents: 4
diff changeset
122 SingleLinkedStack* stack = (SingleLinkedStack*)GearImpl(context, Stack, stack);
mir3636
parents: 4
diff changeset
123 enum Code next = Gearef(context, Stack)->next;
mir3636
parents: 4
diff changeset
124 goto clearSingleLinkedStack(context, stack, next);
mir3636
parents: 4
diff changeset
125 }
mir3636
parents: 4
diff changeset
126 \end{lstlisting}
2
mir3636
parents: 0
diff changeset
127
13
mir3636
parents: 9
diff changeset
128
mir3636
parents: 9
diff changeset
129
2
mir3636
parents: 0
diff changeset
130 \section{Context の生成}
mir3636
parents: 0
diff changeset
131 Context は Meta Data Gear に相当し、Code Gear や Data Gear を管理している。
9
mir3636
parents: 8
diff changeset
132 Data Gear を取得するために generate\_context は context の定義 (リスト\ref{context}) を読み宣言されている Data Gear を取得する。
4
mir3636
parents: 2
diff changeset
133
mir3636
parents: 2
diff changeset
134 \begin{lstlisting}[frame=lrbt,label=context,caption={\footnotesize context の定義}]
mir3636
parents: 2
diff changeset
135 struct Context {
mir3636
parents: 2
diff changeset
136 enum Code next;
mir3636
parents: 2
diff changeset
137 struct Worker* worker;
mir3636
parents: 2
diff changeset
138 struct TaskManager* taskManager;
mir3636
parents: 2
diff changeset
139 int codeNum;
mir3636
parents: 2
diff changeset
140 __code (**code) (struct Context*);
mir3636
parents: 2
diff changeset
141 void* heapStart;
mir3636
parents: 2
diff changeset
142 void* heap;
mir3636
parents: 2
diff changeset
143 long heapLimit;
mir3636
parents: 2
diff changeset
144 int dataNum;
mir3636
parents: 2
diff changeset
145 int idgCount; //number of waiting dataGear
mir3636
parents: 2
diff changeset
146 int odg;
mir3636
parents: 2
diff changeset
147 int maxOdg;
mir3636
parents: 2
diff changeset
148 int workerId;
mir3636
parents: 2
diff changeset
149 union Data **data;
mir3636
parents: 2
diff changeset
150 };
mir3636
parents: 2
diff changeset
151
mir3636
parents: 2
diff changeset
152 union Data {
mir3636
parents: 2
diff changeset
153 struct Meta {
mir3636
parents: 2
diff changeset
154 enum DataType type;
mir3636
parents: 2
diff changeset
155 long size;
mir3636
parents: 2
diff changeset
156 struct Queue* wait; // tasks waiting this dataGear
mir3636
parents: 2
diff changeset
157 } meta;
mir3636
parents: 2
diff changeset
158 struct Task {
mir3636
parents: 2
diff changeset
159 enum Code code;
mir3636
parents: 2
diff changeset
160 struct Queue* dataGears;
mir3636
parents: 2
diff changeset
161 int idsCount;
mir3636
parents: 2
diff changeset
162 } Task;
mir3636
parents: 2
diff changeset
163 // Stack Interface
mir3636
parents: 2
diff changeset
164 struct Stack {
mir3636
parents: 2
diff changeset
165 union Data* stack;
mir3636
parents: 2
diff changeset
166 union Data* data;
mir3636
parents: 2
diff changeset
167 union Data* data1;
mir3636
parents: 2
diff changeset
168 enum Code whenEmpty;
mir3636
parents: 2
diff changeset
169 enum Code clear;
mir3636
parents: 2
diff changeset
170 enum Code push;
mir3636
parents: 2
diff changeset
171 enum Code pop;
mir3636
parents: 2
diff changeset
172 enum Code isEmpty;
mir3636
parents: 2
diff changeset
173 enum Code get;
mir3636
parents: 2
diff changeset
174 enum Code next;
mir3636
parents: 2
diff changeset
175 } Stack;
mir3636
parents: 2
diff changeset
176 // Stack implementations
mir3636
parents: 2
diff changeset
177 struct SingleLinkedStack {
mir3636
parents: 2
diff changeset
178 struct Element* top;
mir3636
parents: 2
diff changeset
179 } SingleLinkedStack;
mir3636
parents: 2
diff changeset
180 struct Element {
mir3636
parents: 2
diff changeset
181 union Data* data;
mir3636
parents: 2
diff changeset
182 struct Element* next;
mir3636
parents: 2
diff changeset
183 } Element;
mir3636
parents: 2
diff changeset
184 struct Node {
mir3636
parents: 2
diff changeset
185 int key; // comparable data segment
mir3636
parents: 2
diff changeset
186 union Data* value;
mir3636
parents: 2
diff changeset
187 struct Node* left;
mir3636
parents: 2
diff changeset
188 struct Node* right;
mir3636
parents: 2
diff changeset
189 // need to balancing
mir3636
parents: 2
diff changeset
190 enum Color {
mir3636
parents: 2
diff changeset
191 Red,
mir3636
parents: 2
diff changeset
192 Black,
mir3636
parents: 2
diff changeset
193 } color;
mir3636
parents: 2
diff changeset
194 } Node;
mir3636
parents: 2
diff changeset
195 }; // union Data end this is necessary for context generator
mir3636
parents: 2
diff changeset
196
mir3636
parents: 2
diff changeset
197 \end{lstlisting}
mir3636
parents: 2
diff changeset
198
13
mir3636
parents: 9
diff changeset
199 Code Gear の取得は指定された cbc ファイルから \_\_code 型を見て行う。
mir3636
parents: 9
diff changeset
200 取得した Code/Data Gear の enum の定義は enumCode.h、enumData.h に生成される。
mir3636
parents: 9
diff changeset
201
mir3636
parents: 9
diff changeset
202 Context では Code Gear の名前とポインタの対応は generate\_context によって生成される enum Code と関数ポインタによって表現される。
mir3636
parents: 9
diff changeset
203 実際に Code Gear に接続する際は enum Code を指定することで接続を行う。
mir3636
parents: 9
diff changeset
204
mir3636
parents: 9
diff changeset
205 また、generate\_context は取得した Code/Data Gear から Context の生成を行うコード (リスト\ref{init_context}) も生成する。
mir3636
parents: 9
diff changeset
206
mir3636
parents: 9
diff changeset
207 Context には Allocation 等で生成した Data Gear へのポインタが格納されている。
mir3636
parents: 9
diff changeset
208 Code Gear は Context を通して Data Gear へアクセスする。
mir3636
parents: 9
diff changeset
209 Data Gear の Allocation を行うコードは dataGearInit.c に生成される。
mir3636
parents: 9
diff changeset
210
mir3636
parents: 9
diff changeset
211 Data Gear は union Data とその中の struct によって表現される。
mir3636
parents: 9
diff changeset
212 Context には Data Gear の Data Type の情報が格納されている。
mir3636
parents: 9
diff changeset
213 この情報から確保される Data Gear のサイズなどを決定する。
mir3636
parents: 9
diff changeset
214
4
mir3636
parents: 2
diff changeset
215 \begin{lstlisting}[frame=lrbt,label=init_context,caption={\footnotesize 生成された context}]
mir3636
parents: 2
diff changeset
216
mir3636
parents: 2
diff changeset
217 #include <stdlib.h>
mir3636
parents: 2
diff changeset
218
mir3636
parents: 2
diff changeset
219 #include "../context.h"
mir3636
parents: 2
diff changeset
220
mir3636
parents: 2
diff changeset
221 void initContext(struct Context* context) {
mir3636
parents: 2
diff changeset
222 context->heapLimit = sizeof(union Data)*ALLOCATE_SIZE;
mir3636
parents: 2
diff changeset
223 context->code = (__code(**) (struct Context*)) NEWN(ALLOCATE_SIZE, void*);
mir3636
parents: 2
diff changeset
224 context->data = NEWN(ALLOCATE_SIZE, union Data*);
mir3636
parents: 2
diff changeset
225 context->heapStart = NEWN(context->heapLimit, char);
mir3636
parents: 2
diff changeset
226 context->heap = context->heapStart;
mir3636
parents: 2
diff changeset
227
mir3636
parents: 2
diff changeset
228 context->code[C_clearSingleLinkedStack] = clearSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
229 context->code[C_exit_code] = exit_code_stub;
mir3636
parents: 2
diff changeset
230 context->code[C_getSingleLinkedStack] = getSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
231 context->code[C_isEmptySingleLinkedStack] = isEmptySingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
232 context->code[C_popSingleLinkedStack] = popSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
233 context->code[C_pushSingleLinkedStack] = pushSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
234 context->code[C_stack_test1] = stack_test1_stub;
mir3636
parents: 2
diff changeset
235 context->code[C_stack_test2] = stack_test2_stub;
mir3636
parents: 2
diff changeset
236 context->code[C_stack_test3] = stack_test3_stub;
mir3636
parents: 2
diff changeset
237 context->code[C_stack_test4] = stack_test4_stub;
mir3636
parents: 2
diff changeset
238 context->code[C_start_code] = start_code_stub;
mir3636
parents: 2
diff changeset
239
mir3636
parents: 2
diff changeset
240 #include "dataGearInit.c"
mir3636
parents: 2
diff changeset
241
mir3636
parents: 2
diff changeset
242 }
mir3636
parents: 2
diff changeset
243
mir3636
parents: 2
diff changeset
244 __code meta(struct Context* context, enum Code next) {
mir3636
parents: 2
diff changeset
245 // printf("meta %d\n",next);
mir3636
parents: 2
diff changeset
246 goto (context->code[next])(context);
mir3636
parents: 2
diff changeset
247 }
mir3636
parents: 2
diff changeset
248
mir3636
parents: 2
diff changeset
249 __code start_code(struct Context* context) {
mir3636
parents: 2
diff changeset
250 goto meta(context, context->next);
mir3636
parents: 2
diff changeset
251 }
mir3636
parents: 2
diff changeset
252
mir3636
parents: 2
diff changeset
253 __code start_code_stub(struct Context* context) {
mir3636
parents: 2
diff changeset
254 goto start_code(context);
mir3636
parents: 2
diff changeset
255 }
mir3636
parents: 2
diff changeset
256
mir3636
parents: 2
diff changeset
257 __code exit_code(struct Context* context) {
mir3636
parents: 2
diff changeset
258 free(context->code);
mir3636
parents: 2
diff changeset
259 free(context->data);
mir3636
parents: 2
diff changeset
260 free(context->heapStart);
mir3636
parents: 2
diff changeset
261 goto exit(0);
mir3636
parents: 2
diff changeset
262 }
mir3636
parents: 2
diff changeset
263
mir3636
parents: 2
diff changeset
264 __code exit_code_stub(struct Context* context) {
mir3636
parents: 2
diff changeset
265 goto exit_code(context);
mir3636
parents: 2
diff changeset
266 }
mir3636
parents: 2
diff changeset
267
mir3636
parents: 2
diff changeset
268 // end context_c
mir3636
parents: 2
diff changeset
269 \end{lstlisting}
2
mir3636
parents: 0
diff changeset
270 %enum で Code Gear と Data Gear
mir3636
parents: 0
diff changeset
271 %Data Gear の typedef
mir3636
parents: 0
diff changeset
272 %stub の extern
mir3636
parents: 0
diff changeset
273 %Data Gear の init (ALLOCA)
mir3636
parents: 0
diff changeset
274 %target 毎の init context
mir3636
parents: 0
diff changeset
275
mir3636
parents: 0
diff changeset
276