annotate final_main/chapter5.tex @ 9:11ad5b3e7b85

update
author mir3636
date Wed, 15 Feb 2017 14:53:26 +0900
parents b35c8fcff7d5
children ddfca5037e41
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 を選択する。
mir3636
parents: 8
diff changeset
13 generate\_stub は引数と interface を照らし合わせ、Gearef または GearImpl を決定する。
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
9
mir3636
parents: 8
diff changeset
18 \begin{lstlisting}[frame=lrbt,label=stack_cbc,caption={\footnotesize cbcファイルの例}]
5
mir3636
parents: 4
diff changeset
19 #include "../context.h"
mir3636
parents: 4
diff changeset
20
mir3636
parents: 4
diff changeset
21 Stack* createSingleLinkedStack(struct Context* context) {
mir3636
parents: 4
diff changeset
22 struct Stack* stack = new Stack();
mir3636
parents: 4
diff changeset
23 struct SingleLinkedStack* singleLinkedStack = new SingleLinkedStack();
mir3636
parents: 4
diff changeset
24 stack->stack = (union Data*)singleLinkedStack;
mir3636
parents: 4
diff changeset
25 singleLinkedStack->top = NULL;
mir3636
parents: 4
diff changeset
26 stack->push = C_pushSingleLinkedStack;
mir3636
parents: 4
diff changeset
27 stack->pop = C_popSingleLinkedStack;
mir3636
parents: 4
diff changeset
28 stack->get = C_getSingleLinkedStack;
mir3636
parents: 4
diff changeset
29 stack->isEmpty = C_isEmptySingleLinkedStack;
mir3636
parents: 4
diff changeset
30 stack->clear = C_clearSingleLinkedStack;
mir3636
parents: 4
diff changeset
31 return stack;
mir3636
parents: 4
diff changeset
32 }
mir3636
parents: 4
diff changeset
33
mir3636
parents: 4
diff changeset
34 __code clearSingleLinkedStack(struct SingleLinkedStack* stack,__code next(...)) {
mir3636
parents: 4
diff changeset
35 stack->top = NULL;
mir3636
parents: 4
diff changeset
36 goto next(...);
mir3636
parents: 4
diff changeset
37 }
mir3636
parents: 4
diff changeset
38
mir3636
parents: 4
diff changeset
39 __code pushSingleLinkedStack(struct SingleLinkedStack* stack,union Data* data, __code next(...)) {
mir3636
parents: 4
diff changeset
40 Element* element = new Element();
mir3636
parents: 4
diff changeset
41 element->next = stack->top;
mir3636
parents: 4
diff changeset
42 element->data = data;
mir3636
parents: 4
diff changeset
43 stack->top = element;
mir3636
parents: 4
diff changeset
44 goto next(...);
mir3636
parents: 4
diff changeset
45 }
mir3636
parents: 4
diff changeset
46
mir3636
parents: 4
diff changeset
47 __code popSingleLinkedStack(struct SingleLinkedStack* stack, __code next(union Data* data, ...)) {
mir3636
parents: 4
diff changeset
48 if (stack->top) {
mir3636
parents: 4
diff changeset
49 data = stack->top->data;
mir3636
parents: 4
diff changeset
50 stack->top = stack->top->next;
mir3636
parents: 4
diff changeset
51 } else {
mir3636
parents: 4
diff changeset
52 data = NULL;
mir3636
parents: 4
diff changeset
53 }
mir3636
parents: 4
diff changeset
54 goto next(data, ...);
mir3636
parents: 4
diff changeset
55 }
mir3636
parents: 4
diff changeset
56
mir3636
parents: 4
diff changeset
57 __code getSingleLinkedStack(struct SingleLinkedStack* stack, __code next(union Data* data, ...)) {
mir3636
parents: 4
diff changeset
58 if (stack->top)
mir3636
parents: 4
diff changeset
59 data = stack->top->data;
mir3636
parents: 4
diff changeset
60 else
mir3636
parents: 4
diff changeset
61 data = NULL;
mir3636
parents: 4
diff changeset
62 goto next(data, ...);
mir3636
parents: 4
diff changeset
63 }
mir3636
parents: 4
diff changeset
64
mir3636
parents: 4
diff changeset
65 __code isEmptySingleLinkedStack(struct SingleLinkedStack* stack, __code next(...), __code whenEmpty(...)) {
mir3636
parents: 4
diff changeset
66 if (stack->top)
mir3636
parents: 4
diff changeset
67 goto next(...);
mir3636
parents: 4
diff changeset
68 else
mir3636
parents: 4
diff changeset
69 goto whenEmpty(...);
mir3636
parents: 4
diff changeset
70 }
mir3636
parents: 4
diff changeset
71 \end{lstlisting}
mir3636
parents: 4
diff changeset
72
7
mir3636
parents: 6
diff changeset
73 \begin{lstlisting}[frame=lrbt,label=stack_c,caption={\footnotesize 生成される stub}]
5
mir3636
parents: 4
diff changeset
74 __code clearSingleLinkedStack(struct Context *context,struct SingleLinkedStack* stack,enum Code next) {
mir3636
parents: 4
diff changeset
75 stack->top = NULL;
mir3636
parents: 4
diff changeset
76 goto meta(context, next);
mir3636
parents: 4
diff changeset
77 }
mir3636
parents: 4
diff changeset
78
mir3636
parents: 4
diff changeset
79 __code clearSingleLinkedStack_stub(struct Context* context) {
mir3636
parents: 4
diff changeset
80 SingleLinkedStack* stack = (SingleLinkedStack*)GearImpl(context, Stack, stack);
mir3636
parents: 4
diff changeset
81 enum Code next = Gearef(context, Stack)->next;
mir3636
parents: 4
diff changeset
82 goto clearSingleLinkedStack(context, stack, next);
mir3636
parents: 4
diff changeset
83 }
mir3636
parents: 4
diff changeset
84 \end{lstlisting}
2
mir3636
parents: 0
diff changeset
85
mir3636
parents: 0
diff changeset
86 \section{Context の生成}
mir3636
parents: 0
diff changeset
87 Context は Meta Data Gear に相当し、Code Gear や Data Gear を管理している。
9
mir3636
parents: 8
diff changeset
88 Data Gear を取得するために generate\_context は context の定義 (リスト\ref{context}) を読み宣言されている Data Gear を取得する。
2
mir3636
parents: 0
diff changeset
89 Code Gear は指定された cbc ファイルから stub を見て取得を行う。
9
mir3636
parents: 8
diff changeset
90 取得した Code/Data Gear の enum の定義は enumCode.h、enumData.h に生成される。
2
mir3636
parents: 0
diff changeset
91
9
mir3636
parents: 8
diff changeset
92 Context では Code Gear の名前とポインタの対応は generate\_context によって生成される enum Code と関数ポインタによって表現される。
2
mir3636
parents: 0
diff changeset
93 実際に Code Gear に接続する際は enum Code を指定することで接続を行う。
9
mir3636
parents: 8
diff changeset
94
mir3636
parents: 8
diff changeset
95 また、generate\_context は取得した Code/Data Gear から Context の生成を行うコード (リスト\ref{init_context}) も生成する。
2
mir3636
parents: 0
diff changeset
96
4
mir3636
parents: 2
diff changeset
97 Context には Allocation 等で生成した Data Gear へのポインタが格納されている。
mir3636
parents: 2
diff changeset
98 Code Gear は Context を通して Data Gear へアクセスする。
mir3636
parents: 2
diff changeset
99 Data Gear の Allocation を行うコードは dataGearInit.c に生成される。
2
mir3636
parents: 0
diff changeset
100
4
mir3636
parents: 2
diff changeset
101 Data Gear は union Data とその中の struct によって表現される。
mir3636
parents: 2
diff changeset
102 Context には Data Gear の Data Type の情報が格納されている。
mir3636
parents: 2
diff changeset
103 この情報から確保される Data Gear のサイズなどを決定する。
mir3636
parents: 2
diff changeset
104
mir3636
parents: 2
diff changeset
105 \begin{lstlisting}[frame=lrbt,label=context,caption={\footnotesize context の定義}]
mir3636
parents: 2
diff changeset
106 #define ALLOCATE_SIZE 20000000
mir3636
parents: 2
diff changeset
107 #define NEW(type) (type*)(calloc(1, sizeof(type)))
mir3636
parents: 2
diff changeset
108 #define NEWN(n, type) (type*)(calloc(n, sizeof(type)))
mir3636
parents: 2
diff changeset
109
mir3636
parents: 2
diff changeset
110 #define ALLOC_DATA(context, dseg) ({\
mir3636
parents: 2
diff changeset
111 struct Meta* meta = (struct Meta*)context->heap;\
mir3636
parents: 2
diff changeset
112 meta->type = D_##dseg;\
mir3636
parents: 2
diff changeset
113 meta->size = 1;\
mir3636
parents: 2
diff changeset
114 context->heap += sizeof(struct Meta);\
mir3636
parents: 2
diff changeset
115 context->data[D_##dseg] = context->heap; context->heap += sizeof(struct dseg); (struct dseg *)context->data[D_##dseg]; })
mir3636
parents: 2
diff changeset
116
mir3636
parents: 2
diff changeset
117 #define ALLOCATE(context, t) ({ \
mir3636
parents: 2
diff changeset
118 struct Meta* meta = (struct Meta*)context->heap;\
mir3636
parents: 2
diff changeset
119 context->heap += sizeof(struct Meta);\
mir3636
parents: 2
diff changeset
120 union Data* data = context->heap; \
mir3636
parents: 2
diff changeset
121 context->heap += sizeof(struct t); \
mir3636
parents: 2
diff changeset
122 meta->type = D_##t; \
mir3636
parents: 2
diff changeset
123 meta->size = 1; \
mir3636
parents: 2
diff changeset
124 data; })
mir3636
parents: 2
diff changeset
125
mir3636
parents: 2
diff changeset
126 #define Gearef(context, t) (&(context)->data[D_##t]->t)
mir3636
parents: 2
diff changeset
127 #define GearImpl(context, intf, name) (Gearef(context, intf)->name->intf.name)
mir3636
parents: 2
diff changeset
128
mir3636
parents: 2
diff changeset
129 #include "c/enumCode.h"
mir3636
parents: 2
diff changeset
130
mir3636
parents: 2
diff changeset
131 #include "c/enumData.h"
mir3636
parents: 2
diff changeset
132
mir3636
parents: 2
diff changeset
133 struct Context {
mir3636
parents: 2
diff changeset
134 enum Code next;
mir3636
parents: 2
diff changeset
135 struct Worker* worker;
mir3636
parents: 2
diff changeset
136 struct TaskManager* taskManager;
mir3636
parents: 2
diff changeset
137 int codeNum;
mir3636
parents: 2
diff changeset
138 __code (**code) (struct Context*);
mir3636
parents: 2
diff changeset
139 void* heapStart;
mir3636
parents: 2
diff changeset
140 void* heap;
mir3636
parents: 2
diff changeset
141 long heapLimit;
mir3636
parents: 2
diff changeset
142 int dataNum;
mir3636
parents: 2
diff changeset
143 int idgCount; //number of waiting dataGear
mir3636
parents: 2
diff changeset
144 int odg;
mir3636
parents: 2
diff changeset
145 int maxOdg;
mir3636
parents: 2
diff changeset
146 int workerId;
mir3636
parents: 2
diff changeset
147 union Data **data;
mir3636
parents: 2
diff changeset
148 };
mir3636
parents: 2
diff changeset
149
mir3636
parents: 2
diff changeset
150 union Data {
mir3636
parents: 2
diff changeset
151 struct Meta {
mir3636
parents: 2
diff changeset
152 enum DataType type;
mir3636
parents: 2
diff changeset
153 long size;
mir3636
parents: 2
diff changeset
154 struct Queue* wait; // tasks waiting this dataGear
mir3636
parents: 2
diff changeset
155 } meta;
mir3636
parents: 2
diff changeset
156 struct Task {
mir3636
parents: 2
diff changeset
157 enum Code code;
mir3636
parents: 2
diff changeset
158 struct Queue* dataGears;
mir3636
parents: 2
diff changeset
159 int idsCount;
mir3636
parents: 2
diff changeset
160 } Task;
mir3636
parents: 2
diff changeset
161 // Stack Interface
mir3636
parents: 2
diff changeset
162 struct Stack {
mir3636
parents: 2
diff changeset
163 union Data* stack;
mir3636
parents: 2
diff changeset
164 union Data* data;
mir3636
parents: 2
diff changeset
165 union Data* data1;
mir3636
parents: 2
diff changeset
166 enum Code whenEmpty;
mir3636
parents: 2
diff changeset
167 enum Code clear;
mir3636
parents: 2
diff changeset
168 enum Code push;
mir3636
parents: 2
diff changeset
169 enum Code pop;
mir3636
parents: 2
diff changeset
170 enum Code isEmpty;
mir3636
parents: 2
diff changeset
171 enum Code get;
mir3636
parents: 2
diff changeset
172 enum Code next;
mir3636
parents: 2
diff changeset
173 } Stack;
mir3636
parents: 2
diff changeset
174 // Stack implementations
mir3636
parents: 2
diff changeset
175 struct SingleLinkedStack {
mir3636
parents: 2
diff changeset
176 struct Element* top;
mir3636
parents: 2
diff changeset
177 } SingleLinkedStack;
mir3636
parents: 2
diff changeset
178 struct Element {
mir3636
parents: 2
diff changeset
179 union Data* data;
mir3636
parents: 2
diff changeset
180 struct Element* next;
mir3636
parents: 2
diff changeset
181 } Element;
mir3636
parents: 2
diff changeset
182 struct Node {
mir3636
parents: 2
diff changeset
183 int key; // comparable data segment
mir3636
parents: 2
diff changeset
184 union Data* value;
mir3636
parents: 2
diff changeset
185 struct Node* left;
mir3636
parents: 2
diff changeset
186 struct Node* right;
mir3636
parents: 2
diff changeset
187 // need to balancing
mir3636
parents: 2
diff changeset
188 enum Color {
mir3636
parents: 2
diff changeset
189 Red,
mir3636
parents: 2
diff changeset
190 Black,
mir3636
parents: 2
diff changeset
191 } color;
mir3636
parents: 2
diff changeset
192 } Node;
mir3636
parents: 2
diff changeset
193 }; // union Data end this is necessary for context generator
mir3636
parents: 2
diff changeset
194
mir3636
parents: 2
diff changeset
195 \end{lstlisting}
mir3636
parents: 2
diff changeset
196
mir3636
parents: 2
diff changeset
197 \begin{lstlisting}[frame=lrbt,label=init_context,caption={\footnotesize 生成された context}]
mir3636
parents: 2
diff changeset
198
mir3636
parents: 2
diff changeset
199 #include <stdlib.h>
mir3636
parents: 2
diff changeset
200
mir3636
parents: 2
diff changeset
201 #include "../context.h"
mir3636
parents: 2
diff changeset
202
mir3636
parents: 2
diff changeset
203 void initContext(struct Context* context) {
mir3636
parents: 2
diff changeset
204 context->heapLimit = sizeof(union Data)*ALLOCATE_SIZE;
mir3636
parents: 2
diff changeset
205 context->code = (__code(**) (struct Context*)) NEWN(ALLOCATE_SIZE, void*);
mir3636
parents: 2
diff changeset
206 context->data = NEWN(ALLOCATE_SIZE, union Data*);
mir3636
parents: 2
diff changeset
207 context->heapStart = NEWN(context->heapLimit, char);
mir3636
parents: 2
diff changeset
208 context->heap = context->heapStart;
mir3636
parents: 2
diff changeset
209
mir3636
parents: 2
diff changeset
210 context->code[C_clearSingleLinkedStack] = clearSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
211 context->code[C_exit_code] = exit_code_stub;
mir3636
parents: 2
diff changeset
212 context->code[C_getSingleLinkedStack] = getSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
213 context->code[C_isEmptySingleLinkedStack] = isEmptySingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
214 context->code[C_popSingleLinkedStack] = popSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
215 context->code[C_pushSingleLinkedStack] = pushSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
216 context->code[C_stack_test1] = stack_test1_stub;
mir3636
parents: 2
diff changeset
217 context->code[C_stack_test2] = stack_test2_stub;
mir3636
parents: 2
diff changeset
218 context->code[C_stack_test3] = stack_test3_stub;
mir3636
parents: 2
diff changeset
219 context->code[C_stack_test4] = stack_test4_stub;
mir3636
parents: 2
diff changeset
220 context->code[C_start_code] = start_code_stub;
mir3636
parents: 2
diff changeset
221
mir3636
parents: 2
diff changeset
222 #include "dataGearInit.c"
mir3636
parents: 2
diff changeset
223
mir3636
parents: 2
diff changeset
224 }
mir3636
parents: 2
diff changeset
225
mir3636
parents: 2
diff changeset
226 __code meta(struct Context* context, enum Code next) {
mir3636
parents: 2
diff changeset
227 // printf("meta %d\n",next);
mir3636
parents: 2
diff changeset
228 goto (context->code[next])(context);
mir3636
parents: 2
diff changeset
229 }
mir3636
parents: 2
diff changeset
230
mir3636
parents: 2
diff changeset
231 __code start_code(struct Context* context) {
mir3636
parents: 2
diff changeset
232 goto meta(context, context->next);
mir3636
parents: 2
diff changeset
233 }
mir3636
parents: 2
diff changeset
234
mir3636
parents: 2
diff changeset
235 __code start_code_stub(struct Context* context) {
mir3636
parents: 2
diff changeset
236 goto start_code(context);
mir3636
parents: 2
diff changeset
237 }
mir3636
parents: 2
diff changeset
238
mir3636
parents: 2
diff changeset
239 __code exit_code(struct Context* context) {
mir3636
parents: 2
diff changeset
240 free(context->code);
mir3636
parents: 2
diff changeset
241 free(context->data);
mir3636
parents: 2
diff changeset
242 free(context->heapStart);
mir3636
parents: 2
diff changeset
243 goto exit(0);
mir3636
parents: 2
diff changeset
244 }
mir3636
parents: 2
diff changeset
245
mir3636
parents: 2
diff changeset
246 __code exit_code_stub(struct Context* context) {
mir3636
parents: 2
diff changeset
247 goto exit_code(context);
mir3636
parents: 2
diff changeset
248 }
mir3636
parents: 2
diff changeset
249
mir3636
parents: 2
diff changeset
250 // end context_c
mir3636
parents: 2
diff changeset
251 \end{lstlisting}
2
mir3636
parents: 0
diff changeset
252 %enum で Code Gear と Data Gear
mir3636
parents: 0
diff changeset
253 %Data Gear の typedef
mir3636
parents: 0
diff changeset
254 %stub の extern
mir3636
parents: 0
diff changeset
255 %Data Gear の init (ALLOCA)
mir3636
parents: 0
diff changeset
256 %target 毎の init context
mir3636
parents: 0
diff changeset
257
mir3636
parents: 0
diff changeset
258