annotate final_main/chapter5.tex @ 7:10c4d21cc7f4

update
author mir3636
date Tue, 14 Feb 2017 22:02:53 +0900
parents 5b368e14bb64
children b35c8fcff7d5
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 の記述を行わなくてはならず、これには多くの労力を要する。
mir3636
parents: 4
diff changeset
5 そのため、この記述を助けるために Context や stub Code Gear を生成するスクリプトを作成した。
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
mir3636
parents: 4
diff changeset
12 stub を生成するために perl スクリプトは指定された cbc ファイルの \_\_code型である Code Gear を取得し、引数から必要な Data Gear を選択する。
mir3636
parents: 4
diff changeset
13 この時既に stub Code Gear が生成されている Code Gear は無視される。
mir3636
parents: 4
diff changeset
14
6
mir3636
parents: 5
diff changeset
15 cbc ファイル(リスト\ref{stack_cbc}) に生成した stub Code Gear を c ファイル(\ref{stack_c})を出力する。
mir3636
parents: 5
diff changeset
16
5
mir3636
parents: 4
diff changeset
17
mir3636
parents: 4
diff changeset
18 \begin{lstlisting}[frame=lrbt,label=stack_cbc,caption={\footnotesize SingleLinkedStack.cbc}]
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 を管理している。
4
mir3636
parents: 2
diff changeset
88 Data Gear を取得するために perl スクリプトは context の定義 (リスト\ref{context}) を読み宣言された Data Gear を取得する。
2
mir3636
parents: 0
diff changeset
89 Code Gear は指定された cbc ファイルから stub を見て取得を行う。
mir3636
parents: 0
diff changeset
90
4
mir3636
parents: 2
diff changeset
91 Context では Code Gear の名前とポインタの対応は生成する enum Code によって表現される。
2
mir3636
parents: 0
diff changeset
92 実際に Code Gear に接続する際は enum Code を指定することで接続を行う。
4
mir3636
parents: 2
diff changeset
93 取得した Code/Data Gear の enum の定義は enumCode.h、enumData.h に生成される。
mir3636
parents: 2
diff changeset
94 取得した Code/Data Gear から Context の生成を行うコード (リスト\ref{init_context}) を生成する。
2
mir3636
parents: 0
diff changeset
95
4
mir3636
parents: 2
diff changeset
96 Context には Allocation 等で生成した Data Gear へのポインタが格納されている。
mir3636
parents: 2
diff changeset
97 Code Gear は Context を通して Data Gear へアクセスする。
mir3636
parents: 2
diff changeset
98 Data Gear の Allocation を行うコードは dataGearInit.c に生成される。
2
mir3636
parents: 0
diff changeset
99
4
mir3636
parents: 2
diff changeset
100 Data Gear は union Data とその中の struct によって表現される。
mir3636
parents: 2
diff changeset
101 Context には Data Gear の Data Type の情報が格納されている。
mir3636
parents: 2
diff changeset
102 この情報から確保される Data Gear のサイズなどを決定する。
mir3636
parents: 2
diff changeset
103
mir3636
parents: 2
diff changeset
104 \begin{lstlisting}[frame=lrbt,label=context,caption={\footnotesize context の定義}]
mir3636
parents: 2
diff changeset
105 #define ALLOCATE_SIZE 20000000
mir3636
parents: 2
diff changeset
106 #define NEW(type) (type*)(calloc(1, sizeof(type)))
mir3636
parents: 2
diff changeset
107 #define NEWN(n, type) (type*)(calloc(n, sizeof(type)))
mir3636
parents: 2
diff changeset
108
mir3636
parents: 2
diff changeset
109 #define ALLOC_DATA(context, dseg) ({\
mir3636
parents: 2
diff changeset
110 struct Meta* meta = (struct Meta*)context->heap;\
mir3636
parents: 2
diff changeset
111 meta->type = D_##dseg;\
mir3636
parents: 2
diff changeset
112 meta->size = 1;\
mir3636
parents: 2
diff changeset
113 context->heap += sizeof(struct Meta);\
mir3636
parents: 2
diff changeset
114 context->data[D_##dseg] = context->heap; context->heap += sizeof(struct dseg); (struct dseg *)context->data[D_##dseg]; })
mir3636
parents: 2
diff changeset
115
mir3636
parents: 2
diff changeset
116 #define ALLOCATE(context, t) ({ \
mir3636
parents: 2
diff changeset
117 struct Meta* meta = (struct Meta*)context->heap;\
mir3636
parents: 2
diff changeset
118 context->heap += sizeof(struct Meta);\
mir3636
parents: 2
diff changeset
119 union Data* data = context->heap; \
mir3636
parents: 2
diff changeset
120 context->heap += sizeof(struct t); \
mir3636
parents: 2
diff changeset
121 meta->type = D_##t; \
mir3636
parents: 2
diff changeset
122 meta->size = 1; \
mir3636
parents: 2
diff changeset
123 data; })
mir3636
parents: 2
diff changeset
124
mir3636
parents: 2
diff changeset
125 #define Gearef(context, t) (&(context)->data[D_##t]->t)
mir3636
parents: 2
diff changeset
126 #define GearImpl(context, intf, name) (Gearef(context, intf)->name->intf.name)
mir3636
parents: 2
diff changeset
127
mir3636
parents: 2
diff changeset
128 #include "c/enumCode.h"
mir3636
parents: 2
diff changeset
129
mir3636
parents: 2
diff changeset
130 #include "c/enumData.h"
mir3636
parents: 2
diff changeset
131
mir3636
parents: 2
diff changeset
132 struct Context {
mir3636
parents: 2
diff changeset
133 enum Code next;
mir3636
parents: 2
diff changeset
134 struct Worker* worker;
mir3636
parents: 2
diff changeset
135 struct TaskManager* taskManager;
mir3636
parents: 2
diff changeset
136 int codeNum;
mir3636
parents: 2
diff changeset
137 __code (**code) (struct Context*);
mir3636
parents: 2
diff changeset
138 void* heapStart;
mir3636
parents: 2
diff changeset
139 void* heap;
mir3636
parents: 2
diff changeset
140 long heapLimit;
mir3636
parents: 2
diff changeset
141 int dataNum;
mir3636
parents: 2
diff changeset
142 int idgCount; //number of waiting dataGear
mir3636
parents: 2
diff changeset
143 int odg;
mir3636
parents: 2
diff changeset
144 int maxOdg;
mir3636
parents: 2
diff changeset
145 int workerId;
mir3636
parents: 2
diff changeset
146 union Data **data;
mir3636
parents: 2
diff changeset
147 };
mir3636
parents: 2
diff changeset
148
mir3636
parents: 2
diff changeset
149 union Data {
mir3636
parents: 2
diff changeset
150 struct Meta {
mir3636
parents: 2
diff changeset
151 enum DataType type;
mir3636
parents: 2
diff changeset
152 long size;
mir3636
parents: 2
diff changeset
153 struct Queue* wait; // tasks waiting this dataGear
mir3636
parents: 2
diff changeset
154 } meta;
mir3636
parents: 2
diff changeset
155 struct Task {
mir3636
parents: 2
diff changeset
156 enum Code code;
mir3636
parents: 2
diff changeset
157 struct Queue* dataGears;
mir3636
parents: 2
diff changeset
158 int idsCount;
mir3636
parents: 2
diff changeset
159 } Task;
mir3636
parents: 2
diff changeset
160 // Stack Interface
mir3636
parents: 2
diff changeset
161 struct Stack {
mir3636
parents: 2
diff changeset
162 union Data* stack;
mir3636
parents: 2
diff changeset
163 union Data* data;
mir3636
parents: 2
diff changeset
164 union Data* data1;
mir3636
parents: 2
diff changeset
165 enum Code whenEmpty;
mir3636
parents: 2
diff changeset
166 enum Code clear;
mir3636
parents: 2
diff changeset
167 enum Code push;
mir3636
parents: 2
diff changeset
168 enum Code pop;
mir3636
parents: 2
diff changeset
169 enum Code isEmpty;
mir3636
parents: 2
diff changeset
170 enum Code get;
mir3636
parents: 2
diff changeset
171 enum Code next;
mir3636
parents: 2
diff changeset
172 } Stack;
mir3636
parents: 2
diff changeset
173 // Stack implementations
mir3636
parents: 2
diff changeset
174 struct SingleLinkedStack {
mir3636
parents: 2
diff changeset
175 struct Element* top;
mir3636
parents: 2
diff changeset
176 } SingleLinkedStack;
mir3636
parents: 2
diff changeset
177 struct Element {
mir3636
parents: 2
diff changeset
178 union Data* data;
mir3636
parents: 2
diff changeset
179 struct Element* next;
mir3636
parents: 2
diff changeset
180 } Element;
mir3636
parents: 2
diff changeset
181 struct Node {
mir3636
parents: 2
diff changeset
182 int key; // comparable data segment
mir3636
parents: 2
diff changeset
183 union Data* value;
mir3636
parents: 2
diff changeset
184 struct Node* left;
mir3636
parents: 2
diff changeset
185 struct Node* right;
mir3636
parents: 2
diff changeset
186 // need to balancing
mir3636
parents: 2
diff changeset
187 enum Color {
mir3636
parents: 2
diff changeset
188 Red,
mir3636
parents: 2
diff changeset
189 Black,
mir3636
parents: 2
diff changeset
190 } color;
mir3636
parents: 2
diff changeset
191 } Node;
mir3636
parents: 2
diff changeset
192 }; // union Data end this is necessary for context generator
mir3636
parents: 2
diff changeset
193
mir3636
parents: 2
diff changeset
194 \end{lstlisting}
mir3636
parents: 2
diff changeset
195
mir3636
parents: 2
diff changeset
196 \begin{lstlisting}[frame=lrbt,label=init_context,caption={\footnotesize 生成された context}]
mir3636
parents: 2
diff changeset
197
mir3636
parents: 2
diff changeset
198 #include <stdlib.h>
mir3636
parents: 2
diff changeset
199
mir3636
parents: 2
diff changeset
200 #include "../context.h"
mir3636
parents: 2
diff changeset
201
mir3636
parents: 2
diff changeset
202 void initContext(struct Context* context) {
mir3636
parents: 2
diff changeset
203 context->heapLimit = sizeof(union Data)*ALLOCATE_SIZE;
mir3636
parents: 2
diff changeset
204 context->code = (__code(**) (struct Context*)) NEWN(ALLOCATE_SIZE, void*);
mir3636
parents: 2
diff changeset
205 context->data = NEWN(ALLOCATE_SIZE, union Data*);
mir3636
parents: 2
diff changeset
206 context->heapStart = NEWN(context->heapLimit, char);
mir3636
parents: 2
diff changeset
207 context->heap = context->heapStart;
mir3636
parents: 2
diff changeset
208
mir3636
parents: 2
diff changeset
209 context->code[C_clearSingleLinkedStack] = clearSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
210 context->code[C_exit_code] = exit_code_stub;
mir3636
parents: 2
diff changeset
211 context->code[C_getSingleLinkedStack] = getSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
212 context->code[C_isEmptySingleLinkedStack] = isEmptySingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
213 context->code[C_popSingleLinkedStack] = popSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
214 context->code[C_pushSingleLinkedStack] = pushSingleLinkedStack_stub;
mir3636
parents: 2
diff changeset
215 context->code[C_stack_test1] = stack_test1_stub;
mir3636
parents: 2
diff changeset
216 context->code[C_stack_test2] = stack_test2_stub;
mir3636
parents: 2
diff changeset
217 context->code[C_stack_test3] = stack_test3_stub;
mir3636
parents: 2
diff changeset
218 context->code[C_stack_test4] = stack_test4_stub;
mir3636
parents: 2
diff changeset
219 context->code[C_start_code] = start_code_stub;
mir3636
parents: 2
diff changeset
220
mir3636
parents: 2
diff changeset
221 #include "dataGearInit.c"
mir3636
parents: 2
diff changeset
222
mir3636
parents: 2
diff changeset
223 }
mir3636
parents: 2
diff changeset
224
mir3636
parents: 2
diff changeset
225 __code meta(struct Context* context, enum Code next) {
mir3636
parents: 2
diff changeset
226 // printf("meta %d\n",next);
mir3636
parents: 2
diff changeset
227 goto (context->code[next])(context);
mir3636
parents: 2
diff changeset
228 }
mir3636
parents: 2
diff changeset
229
mir3636
parents: 2
diff changeset
230 __code start_code(struct Context* context) {
mir3636
parents: 2
diff changeset
231 goto meta(context, context->next);
mir3636
parents: 2
diff changeset
232 }
mir3636
parents: 2
diff changeset
233
mir3636
parents: 2
diff changeset
234 __code start_code_stub(struct Context* context) {
mir3636
parents: 2
diff changeset
235 goto start_code(context);
mir3636
parents: 2
diff changeset
236 }
mir3636
parents: 2
diff changeset
237
mir3636
parents: 2
diff changeset
238 __code exit_code(struct Context* context) {
mir3636
parents: 2
diff changeset
239 free(context->code);
mir3636
parents: 2
diff changeset
240 free(context->data);
mir3636
parents: 2
diff changeset
241 free(context->heapStart);
mir3636
parents: 2
diff changeset
242 goto exit(0);
mir3636
parents: 2
diff changeset
243 }
mir3636
parents: 2
diff changeset
244
mir3636
parents: 2
diff changeset
245 __code exit_code_stub(struct Context* context) {
mir3636
parents: 2
diff changeset
246 goto exit_code(context);
mir3636
parents: 2
diff changeset
247 }
mir3636
parents: 2
diff changeset
248
mir3636
parents: 2
diff changeset
249 // end context_c
mir3636
parents: 2
diff changeset
250 \end{lstlisting}
2
mir3636
parents: 0
diff changeset
251 %enum で Code Gear と Data Gear
mir3636
parents: 0
diff changeset
252 %Data Gear の typedef
mir3636
parents: 0
diff changeset
253 %stub の extern
mir3636
parents: 0
diff changeset
254 %Data Gear の init (ALLOCA)
mir3636
parents: 0
diff changeset
255 %target 毎の init context
mir3636
parents: 0
diff changeset
256
mir3636
parents: 0
diff changeset
257