1 | #include "EXTERN.h" |
1 | #include "EXTERN.h" |
2 | #include "perl.h" |
2 | #include "perl.h" |
3 | #include "XSUB.h" |
3 | #include "XSUB.h" |
|
|
4 | |
|
|
5 | #include "patchlevel.h" |
|
|
6 | |
|
|
7 | #if PATCHLEVEL < 6 |
|
|
8 | # ifndef PL_ppaddr |
|
|
9 | # define PL_ppaddr ppaddr |
|
|
10 | # endif |
|
|
11 | # ifndef call_sv |
|
|
12 | # define call_sv perl_call_sv |
|
|
13 | # endif |
|
|
14 | # ifndef get_sv |
|
|
15 | # define get_sv perl_get_sv |
|
|
16 | # endif |
|
|
17 | # ifndef get_cv |
|
|
18 | # define get_cv perl_get_cv |
|
|
19 | # endif |
|
|
20 | # ifndef IS_PADGV |
|
|
21 | # define IS_PADGV(v) 0 |
|
|
22 | # endif |
|
|
23 | # ifndef IS_PADCONST |
|
|
24 | # define IS_PADCONST(v) 0 |
|
|
25 | # endif |
|
|
26 | #endif |
4 | |
27 | |
5 | #include "libcoro/coro.c" |
28 | #include "libcoro/coro.c" |
6 | |
29 | |
7 | #include <signal.h> |
30 | #include <signal.h> |
8 | |
31 | |
… | |
… | |
16 | # undef HAVE_MMAP |
39 | # undef HAVE_MMAP |
17 | # endif |
40 | # endif |
18 | # endif |
41 | # endif |
19 | #endif |
42 | #endif |
20 | |
43 | |
21 | #define MAY_FLUSH /* increases codesize and is rarely used */ |
|
|
22 | |
|
|
23 | #define SUB_INIT "Coro::State::initialize" |
44 | #define SUB_INIT "Coro::State::initialize" |
24 | #define UCORO_STATE "_coro_state" |
45 | #define UCORO_STATE "_coro_state" |
25 | |
46 | |
26 | /* The next macro should declare a variable stacklevel that contains and approximation |
47 | /* The next macro should declare a variable stacklevel that contains and approximation |
27 | * to the current C stack pointer. Its property is that it changes with each call |
48 | * to the current C stack pointer. Its property is that it changes with each call |
… | |
… | |
31 | #define IN_DESTRUCT (PL_main_cv == Nullcv) |
52 | #define IN_DESTRUCT (PL_main_cv == Nullcv) |
32 | |
53 | |
33 | #define labs(l) ((l) >= 0 ? (l) : -(l)) |
54 | #define labs(l) ((l) >= 0 ? (l) : -(l)) |
34 | |
55 | |
35 | #include "CoroAPI.h" |
56 | #include "CoroAPI.h" |
|
|
57 | |
|
|
58 | #ifdef USE_ITHREADS |
|
|
59 | static perl_mutex coro_mutex; |
|
|
60 | # define LOCK do { MUTEX_LOCK (&coro_mutex); } while (0) |
|
|
61 | # define UNLOCK do { MUTEX_UNLOCK (&coro_mutex); } while (0) |
|
|
62 | #else |
|
|
63 | # define LOCK 0 |
|
|
64 | # define UNLOCK 0 |
|
|
65 | #endif |
36 | |
66 | |
37 | static struct CoroAPI coroapi; |
67 | static struct CoroAPI coroapi; |
38 | |
68 | |
39 | /* this is actually not only the c stack but also c registers etc... */ |
69 | /* this is actually not only the c stack but also c registers etc... */ |
40 | typedef struct { |
70 | typedef struct { |
… | |
… | |
47 | void *sptr; |
77 | void *sptr; |
48 | long ssize; /* positive == mmap, otherwise malloc */ |
78 | long ssize; /* positive == mmap, otherwise malloc */ |
49 | } coro_stack; |
79 | } coro_stack; |
50 | |
80 | |
51 | struct coro { |
81 | struct coro { |
|
|
82 | /* the top-level JMPENV for each coroutine, needed to catch dies. */ |
|
|
83 | JMPENV start_env; |
|
|
84 | |
52 | /* the optional C context */ |
85 | /* the optional C context */ |
53 | coro_stack *stack; |
86 | coro_stack *stack; |
54 | void *cursp; |
87 | void *cursp; |
55 | int gencnt; |
88 | int gencnt; |
56 | |
89 | |
57 | /* optionally saved, might be zero */ |
90 | /* optionally saved, might be zero */ |
58 | AV *defav; |
91 | AV *defav; |
59 | SV *defsv; |
92 | SV *defsv; |
60 | SV *errsv; |
93 | SV *errsv; |
61 | /* TODO: PL_pmop might be nice && effortless to save. */ |
|
|
62 | |
94 | |
63 | /* saved global state not related to stacks */ |
95 | /* saved global state not related to stacks */ |
64 | U8 dowarn; |
96 | U8 dowarn; |
65 | I32 in_eval; |
97 | I32 in_eval; |
66 | |
98 | |
… | |
… | |
69 | AV *curstack; |
101 | AV *curstack; |
70 | AV *mainstack; |
102 | AV *mainstack; |
71 | SV **stack_sp; |
103 | SV **stack_sp; |
72 | OP *op; |
104 | OP *op; |
73 | SV **curpad; |
105 | SV **curpad; |
|
|
106 | AV *comppad; |
74 | SV **stack_base; |
107 | SV **stack_base; |
75 | SV **stack_max; |
108 | SV **stack_max; |
76 | SV **tmps_stack; |
109 | SV **tmps_stack; |
77 | I32 tmps_floor; |
110 | I32 tmps_floor; |
78 | I32 tmps_ix; |
111 | I32 tmps_ix; |
… | |
… | |
101 | |
134 | |
102 | static AV *main_mainstack; /* used to differentiate between $main and others */ |
135 | static AV *main_mainstack; /* used to differentiate between $main and others */ |
103 | static HV *coro_state_stash; |
136 | static HV *coro_state_stash; |
104 | static SV *ucoro_state_sv; |
137 | static SV *ucoro_state_sv; |
105 | static U32 ucoro_state_hash; |
138 | static U32 ucoro_state_hash; |
106 | static HV *padlist_cache; |
|
|
107 | static SV *coro_mortal; /* will be freed after next transfer */ |
139 | static SV *coro_mortal; /* will be freed after next transfer */ |
108 | |
140 | |
109 | /* mostly copied from op.c:cv_clone2 */ |
141 | /* mostly copied from op.c:cv_clone2 */ |
110 | STATIC AV * |
142 | STATIC AV * |
111 | clone_padlist (AV *protopadlist) |
143 | clone_padlist (AV *protopadlist) |
… | |
… | |
140 | AvFLAGS (av) = AVf_REIFY; |
172 | AvFLAGS (av) = AVf_REIFY; |
141 | |
173 | |
142 | for (ix = fpad; ix > 0; ix--) |
174 | for (ix = fpad; ix > 0; ix--) |
143 | { |
175 | { |
144 | SV *namesv = (ix <= fname) ? pname[ix] : Nullsv; |
176 | SV *namesv = (ix <= fname) ? pname[ix] : Nullsv; |
|
|
177 | |
145 | if (namesv && namesv != &PL_sv_undef) |
178 | if (namesv && namesv != &PL_sv_undef) |
146 | { |
179 | { |
147 | char *name = SvPVX (namesv); /* XXX */ |
180 | char *name = SvPVX (namesv); /* XXX */ |
|
|
181 | |
148 | if (SvFLAGS (namesv) & SVf_FAKE || *name == '&') |
182 | if (SvFLAGS (namesv) & SVf_FAKE || *name == '&') |
149 | { /* lexical from outside? */ |
183 | { /* lexical from outside? */ |
150 | npad[ix] = SvREFCNT_inc (ppad[ix]); |
184 | npad[ix] = SvREFCNT_inc (ppad[ix]); |
151 | } |
185 | } |
152 | else |
186 | else |
… | |
… | |
158 | sv = (SV *) newAV (); |
192 | sv = (SV *) newAV (); |
159 | else if (*name == '%') |
193 | else if (*name == '%') |
160 | sv = (SV *) newHV (); |
194 | sv = (SV *) newHV (); |
161 | else |
195 | else |
162 | sv = NEWSV (0, 0); |
196 | sv = NEWSV (0, 0); |
|
|
197 | |
|
|
198 | #ifdef SvPADBUSY |
163 | if (!SvPADBUSY (sv)) |
199 | if (!SvPADBUSY (sv)) |
|
|
200 | #endif |
164 | SvPADMY_on (sv); |
201 | SvPADMY_on (sv); |
|
|
202 | |
165 | npad[ix] = sv; |
203 | npad[ix] = sv; |
166 | } |
204 | } |
167 | } |
205 | } |
168 | else if (IS_PADGV (ppad[ix]) || IS_PADCONST (ppad[ix])) |
206 | else if (IS_PADGV (ppad[ix]) || IS_PADCONST (ppad[ix])) |
169 | { |
207 | { |
… | |
… | |
198 | #endif |
236 | #endif |
199 | |
237 | |
200 | return newpadlist; |
238 | return newpadlist; |
201 | } |
239 | } |
202 | |
240 | |
203 | #ifdef MAY_FLUSH |
|
|
204 | STATIC void |
241 | STATIC void |
205 | free_padlist (AV *padlist) |
242 | free_padlist (AV *padlist) |
206 | { |
243 | { |
207 | /* may be during global destruction */ |
244 | /* may be during global destruction */ |
208 | if (SvREFCNT(padlist)) |
245 | if (SvREFCNT (padlist)) |
209 | { |
246 | { |
210 | I32 i = AvFILLp(padlist); |
247 | I32 i = AvFILLp (padlist); |
211 | while (i >= 0) |
248 | while (i >= 0) |
212 | { |
249 | { |
213 | SV **svp = av_fetch(padlist, i--, FALSE); |
250 | SV **svp = av_fetch (padlist, i--, FALSE); |
214 | SV *sv = svp ? *svp : Nullsv; |
|
|
215 | if (sv) |
251 | if (svp) |
|
|
252 | { |
|
|
253 | SV *sv; |
|
|
254 | while (&PL_sv_undef != (sv = av_pop ((AV *)*svp))) |
216 | SvREFCNT_dec(sv); |
255 | SvREFCNT_dec (sv); |
|
|
256 | |
|
|
257 | SvREFCNT_dec (*svp); |
|
|
258 | } |
217 | } |
259 | } |
218 | |
260 | |
219 | SvREFCNT_dec((SV*)padlist); |
261 | SvREFCNT_dec ((SV*)padlist); |
220 | } |
262 | } |
221 | } |
263 | } |
222 | #endif |
264 | |
|
|
265 | STATIC int |
|
|
266 | coro_cv_free (pTHX_ SV *sv, MAGIC *mg) |
|
|
267 | { |
|
|
268 | AV *padlist; |
|
|
269 | AV *av = (AV *)mg->mg_obj; |
|
|
270 | |
|
|
271 | /* casting is fun. */ |
|
|
272 | while (&PL_sv_undef != (SV *)(padlist = (AV *)av_pop (av))) |
|
|
273 | free_padlist (padlist); |
|
|
274 | } |
|
|
275 | |
|
|
276 | #define PERL_MAGIC_coro PERL_MAGIC_ext |
|
|
277 | |
|
|
278 | static MGVTBL vtbl_coro = {0, 0, 0, 0, coro_cv_free}; |
223 | |
279 | |
224 | /* the next two functions merely cache the padlists */ |
280 | /* the next two functions merely cache the padlists */ |
225 | STATIC void |
281 | STATIC void |
226 | get_padlist (CV *cv) |
282 | get_padlist (CV *cv) |
227 | { |
283 | { |
228 | SV **he = hv_fetch (padlist_cache, (void *)&cv, sizeof (CV *), 0); |
284 | MAGIC *mg = mg_find ((SV *)cv, PERL_MAGIC_coro); |
229 | |
285 | |
230 | if (he && AvFILLp ((AV *)*he) >= 0) |
286 | if (mg && AvFILLp ((AV *)mg->mg_obj) >= 0) |
231 | CvPADLIST (cv) = (AV *)av_pop ((AV *)*he); |
287 | CvPADLIST (cv) = (AV *)av_pop ((AV *)mg->mg_obj); |
232 | else |
288 | else |
233 | CvPADLIST (cv) = clone_padlist (CvPADLIST (cv)); |
289 | CvPADLIST (cv) = clone_padlist (CvPADLIST (cv)); |
234 | } |
290 | } |
235 | |
291 | |
236 | STATIC void |
292 | STATIC void |
237 | put_padlist (CV *cv) |
293 | put_padlist (CV *cv) |
238 | { |
294 | { |
239 | SV **he = hv_fetch (padlist_cache, (void *)&cv, sizeof (CV *), 1); |
295 | MAGIC *mg = mg_find ((SV *)cv, PERL_MAGIC_coro); |
240 | |
296 | |
241 | if (SvTYPE (*he) != SVt_PVAV) |
297 | if (!mg) |
242 | { |
298 | { |
243 | SvREFCNT_dec (*he); |
299 | sv_magic ((SV *)cv, 0, PERL_MAGIC_coro, 0, 0); |
|
|
300 | mg = mg_find ((SV *)cv, PERL_MAGIC_coro); |
|
|
301 | mg->mg_virtual = &vtbl_coro; |
244 | *he = (SV *)newAV (); |
302 | mg->mg_obj = (SV *)newAV (); |
245 | } |
303 | } |
246 | |
304 | |
247 | av_push ((AV *)*he, (SV *)CvPADLIST (cv)); |
305 | av_push ((AV *)mg->mg_obj, (SV *)CvPADLIST (cv)); |
248 | } |
306 | } |
249 | |
|
|
250 | #ifdef MAY_FLUSH |
|
|
251 | STATIC void |
|
|
252 | flush_padlist_cache () |
|
|
253 | { |
|
|
254 | HV *hv = padlist_cache; |
|
|
255 | padlist_cache = newHV (); |
|
|
256 | |
|
|
257 | if (hv_iterinit (hv)) |
|
|
258 | { |
|
|
259 | HE *he; |
|
|
260 | AV *padlist; |
|
|
261 | |
|
|
262 | while (!!(he = hv_iternext (hv))) |
|
|
263 | { |
|
|
264 | AV *av = (AV *)HeVAL(he); |
|
|
265 | |
|
|
266 | /* casting is fun. */ |
|
|
267 | while (&PL_sv_undef != (SV *)(padlist = (AV *)av_pop (av))) |
|
|
268 | free_padlist (padlist); |
|
|
269 | } |
|
|
270 | } |
|
|
271 | |
|
|
272 | SvREFCNT_dec (hv); |
|
|
273 | } |
|
|
274 | #endif |
|
|
275 | |
307 | |
276 | #define SB do { |
308 | #define SB do { |
277 | #define SE } while (0) |
309 | #define SE } while (0) |
278 | |
310 | |
279 | #define LOAD(state) load_state(aTHX_ (state)); |
311 | #define LOAD(state) load_state(aTHX_ (state)); |
280 | #define SAVE(state,flags) save_state(aTHX_ (state),(flags)); |
312 | #define SAVE(state,flags) save_state(aTHX_ (state),(flags)); |
281 | |
313 | |
282 | #define REPLACE_SV(sv,val) SB SvREFCNT_dec(sv); (sv) = (val); SE |
314 | #define REPLACE_SV(sv,val) SB SvREFCNT_dec(sv); (sv) = (val); (val) = 0; SE |
283 | |
315 | |
284 | static void |
316 | static void |
285 | load_state(pTHX_ Coro__State c) |
317 | load_state(pTHX_ Coro__State c) |
286 | { |
318 | { |
287 | PL_dowarn = c->dowarn; |
319 | PL_dowarn = c->dowarn; |
… | |
… | |
291 | PL_curstack = c->curstack; |
323 | PL_curstack = c->curstack; |
292 | PL_mainstack = c->mainstack; |
324 | PL_mainstack = c->mainstack; |
293 | PL_stack_sp = c->stack_sp; |
325 | PL_stack_sp = c->stack_sp; |
294 | PL_op = c->op; |
326 | PL_op = c->op; |
295 | PL_curpad = c->curpad; |
327 | PL_curpad = c->curpad; |
|
|
328 | PL_comppad = c->comppad; |
296 | PL_stack_base = c->stack_base; |
329 | PL_stack_base = c->stack_base; |
297 | PL_stack_max = c->stack_max; |
330 | PL_stack_max = c->stack_max; |
298 | PL_tmps_stack = c->tmps_stack; |
331 | PL_tmps_stack = c->tmps_stack; |
299 | PL_tmps_floor = c->tmps_floor; |
332 | PL_tmps_floor = c->tmps_floor; |
300 | PL_tmps_ix = c->tmps_ix; |
333 | PL_tmps_ix = c->tmps_ix; |
… | |
… | |
329 | |
362 | |
330 | if (padlist) |
363 | if (padlist) |
331 | { |
364 | { |
332 | put_padlist (cv); /* mark this padlist as available */ |
365 | put_padlist (cv); /* mark this padlist as available */ |
333 | CvPADLIST(cv) = padlist; |
366 | CvPADLIST(cv) = padlist; |
334 | #ifdef USE_THREADS |
|
|
335 | /*CvOWNER(cv) = (struct perl_thread *)POPs;*/ |
|
|
336 | #endif |
|
|
337 | } |
367 | } |
338 | |
368 | |
339 | ++CvDEPTH(cv); |
369 | ++CvDEPTH(cv); |
340 | } |
370 | } |
341 | |
371 | |
… | |
… | |
368 | if (CxTYPE(cx) == CXt_SUB) |
398 | if (CxTYPE(cx) == CXt_SUB) |
369 | { |
399 | { |
370 | CV *cv = cx->blk_sub.cv; |
400 | CV *cv = cx->blk_sub.cv; |
371 | if (CvDEPTH(cv)) |
401 | if (CvDEPTH(cv)) |
372 | { |
402 | { |
373 | #ifdef USE_THREADS |
|
|
374 | /*XPUSHs ((SV *)CvOWNER(cv));*/ |
|
|
375 | /*CvOWNER(cv) = 0;*/ |
|
|
376 | /*error must unlock this cv etc.. etc...*/ |
|
|
377 | #endif |
|
|
378 | EXTEND (SP, CvDEPTH(cv)*2); |
403 | EXTEND (SP, CvDEPTH(cv)*2); |
379 | |
404 | |
380 | while (--CvDEPTH(cv)) |
405 | while (--CvDEPTH(cv)) |
381 | { |
406 | { |
382 | /* this tells the restore code to increment CvDEPTH */ |
407 | /* this tells the restore code to increment CvDEPTH */ |
… | |
… | |
388 | PUSHs ((SV *)cv); |
413 | PUSHs ((SV *)cv); |
389 | |
414 | |
390 | get_padlist (cv); /* this is a monster */ |
415 | get_padlist (cv); /* this is a monster */ |
391 | } |
416 | } |
392 | } |
417 | } |
|
|
418 | #ifdef CXt_FORMAT |
393 | else if (CxTYPE(cx) == CXt_FORMAT) |
419 | else if (CxTYPE(cx) == CXt_FORMAT) |
394 | { |
420 | { |
395 | /* I never used formats, so how should I know how these are implemented? */ |
421 | /* I never used formats, so how should I know how these are implemented? */ |
396 | /* my bold guess is as a simple, plain sub... */ |
422 | /* my bold guess is as a simple, plain sub... */ |
397 | croak ("CXt_FORMAT not yet handled. Don't switch coroutines from within formats"); |
423 | croak ("CXt_FORMAT not yet handled. Don't switch coroutines from within formats"); |
398 | } |
424 | } |
|
|
425 | #endif |
399 | } |
426 | } |
400 | |
427 | |
401 | if (top_si->si_type == PERLSI_MAIN) |
428 | if (top_si->si_type == PERLSI_MAIN) |
402 | break; |
429 | break; |
403 | |
430 | |
… | |
… | |
420 | c->curstack = PL_curstack; |
447 | c->curstack = PL_curstack; |
421 | c->mainstack = PL_mainstack; |
448 | c->mainstack = PL_mainstack; |
422 | c->stack_sp = PL_stack_sp; |
449 | c->stack_sp = PL_stack_sp; |
423 | c->op = PL_op; |
450 | c->op = PL_op; |
424 | c->curpad = PL_curpad; |
451 | c->curpad = PL_curpad; |
|
|
452 | c->comppad = PL_comppad; |
425 | c->stack_base = PL_stack_base; |
453 | c->stack_base = PL_stack_base; |
426 | c->stack_max = PL_stack_max; |
454 | c->stack_max = PL_stack_max; |
427 | c->tmps_stack = PL_tmps_stack; |
455 | c->tmps_stack = PL_tmps_stack; |
428 | c->tmps_floor = PL_tmps_floor; |
456 | c->tmps_floor = PL_tmps_floor; |
429 | c->tmps_ix = PL_tmps_ix; |
457 | c->tmps_ix = PL_tmps_ix; |
… | |
… | |
445 | } |
473 | } |
446 | |
474 | |
447 | /* |
475 | /* |
448 | * allocate various perl stacks. This is an exact copy |
476 | * allocate various perl stacks. This is an exact copy |
449 | * of perl.c:init_stacks, except that it uses less memory |
477 | * of perl.c:init_stacks, except that it uses less memory |
450 | * on the assumption that coroutines do not usually need |
478 | * on the (sometimes correct) assumption that coroutines do |
451 | * a lot of stackspace. |
479 | * not usually need a lot of stackspace. |
452 | */ |
480 | */ |
453 | STATIC void |
481 | STATIC void |
454 | coro_init_stacks (pTHX) |
482 | coro_init_stacks (pTHX) |
455 | { |
483 | { |
|
|
484 | LOCK; |
|
|
485 | |
456 | PL_curstackinfo = new_stackinfo(96, 1024/sizeof(PERL_CONTEXT) - 1); |
486 | PL_curstackinfo = new_stackinfo(96, 1024/sizeof(PERL_CONTEXT) - 1); |
457 | PL_curstackinfo->si_type = PERLSI_MAIN; |
487 | PL_curstackinfo->si_type = PERLSI_MAIN; |
458 | PL_curstack = PL_curstackinfo->si_stack; |
488 | PL_curstack = PL_curstackinfo->si_stack; |
459 | PL_mainstack = PL_curstack; /* remember in case we switch stacks */ |
489 | PL_mainstack = PL_curstack; /* remember in case we switch stacks */ |
460 | |
490 | |
… | |
… | |
469 | |
499 | |
470 | New(54,PL_markstack,16,I32); |
500 | New(54,PL_markstack,16,I32); |
471 | PL_markstack_ptr = PL_markstack; |
501 | PL_markstack_ptr = PL_markstack; |
472 | PL_markstack_max = PL_markstack + 16; |
502 | PL_markstack_max = PL_markstack + 16; |
473 | |
503 | |
|
|
504 | #ifdef SET_MARK_OFFSET |
474 | SET_MARK_OFFSET; |
505 | SET_MARK_OFFSET; |
|
|
506 | #endif |
475 | |
507 | |
476 | New(54,PL_scopestack,16,I32); |
508 | New(54,PL_scopestack,16,I32); |
477 | PL_scopestack_ix = 0; |
509 | PL_scopestack_ix = 0; |
478 | PL_scopestack_max = 16; |
510 | PL_scopestack_max = 16; |
479 | |
511 | |
… | |
… | |
482 | PL_savestack_max = 96; |
514 | PL_savestack_max = 96; |
483 | |
515 | |
484 | New(54,PL_retstack,8,OP*); |
516 | New(54,PL_retstack,8,OP*); |
485 | PL_retstack_ix = 0; |
517 | PL_retstack_ix = 0; |
486 | PL_retstack_max = 8; |
518 | PL_retstack_max = 8; |
|
|
519 | |
|
|
520 | UNLOCK; |
487 | } |
521 | } |
488 | |
522 | |
489 | /* |
523 | /* |
490 | * destroy the stacks, the callchain etc... |
524 | * destroy the stacks, the callchain etc... |
491 | * still there is a memleak of 128 bytes... |
|
|
492 | */ |
525 | */ |
493 | STATIC void |
526 | STATIC void |
494 | destroy_stacks(pTHX) |
527 | destroy_stacks(pTHX) |
495 | { |
528 | { |
496 | if (!IN_DESTRUCT) |
529 | if (!IN_DESTRUCT) |
497 | { |
530 | { |
498 | /* is this ugly, I ask? */ |
531 | /* is this ugly, I ask? */ |
499 | while (PL_scopestack_ix) |
532 | LEAVE_SCOPE (0); |
500 | LEAVE; |
|
|
501 | |
533 | |
502 | /* sure it is, but more important: is it correct?? :/ */ |
534 | /* sure it is, but more important: is it correct?? :/ */ |
503 | while (PL_tmps_ix > PL_tmps_floor) /* should only ever be one iteration */ |
|
|
504 | FREETMPS; |
535 | FREETMPS; |
505 | } |
536 | } |
506 | |
537 | |
507 | while (PL_curstackinfo->si_next) |
538 | while (PL_curstackinfo->si_next) |
508 | PL_curstackinfo = PL_curstackinfo->si_next; |
539 | PL_curstackinfo = PL_curstackinfo->si_next; |
509 | |
540 | |
… | |
… | |
543 | New (0, stack, 1, coro_stack); |
574 | New (0, stack, 1, coro_stack); |
544 | |
575 | |
545 | stack->refcnt = 1; |
576 | stack->refcnt = 1; |
546 | stack->usecnt = 1; |
577 | stack->usecnt = 1; |
547 | stack->gencnt = ctx->gencnt = 0; |
578 | stack->gencnt = ctx->gencnt = 0; |
|
|
579 | |
548 | if (alloc) |
580 | if (alloc) |
549 | { |
581 | { |
550 | #if HAVE_MMAP |
582 | #if HAVE_MMAP |
551 | stack->ssize = 128 * 1024 * sizeof (long); /* mmap should do allocate-on-write for us */ |
583 | stack->ssize = 16384 * sizeof (long); /* mmap should do allocate-on-write for us */ |
552 | stack->sptr = mmap (0, stack->ssize, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, 0, 0); |
584 | stack->sptr = mmap (0, stack->ssize, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, 0, 0); |
553 | if (stack->sptr == (void *)-1) |
585 | if (stack->sptr == (void *)-1) |
554 | #endif |
586 | #endif |
555 | { |
587 | { |
556 | /*FIXME*//*D*//* reasonable stack size! */ |
588 | /*FIXME*//*D*//* reasonable stack size! */ |
557 | stack->ssize = -4096 * sizeof (long); |
589 | stack->ssize = - (8192 * sizeof (long)); |
558 | New (0, stack->sptr, 4096, long); |
590 | New (0, stack->sptr, 8192, long); |
559 | } |
591 | } |
560 | } |
592 | } |
561 | else |
593 | else |
562 | stack->sptr = 0; |
594 | stack->sptr = 0; |
563 | |
595 | |
… | |
… | |
577 | { |
609 | { |
578 | #ifdef HAVE_MMAP |
610 | #ifdef HAVE_MMAP |
579 | if (stack->ssize > 0 && stack->sptr) |
611 | if (stack->ssize > 0 && stack->sptr) |
580 | munmap (stack->sptr, stack->ssize); |
612 | munmap (stack->sptr, stack->ssize); |
581 | else |
613 | else |
582 | #else |
614 | #endif |
583 | Safefree (stack->sptr); |
615 | Safefree (stack->sptr); |
584 | #endif |
616 | |
585 | Safefree (stack); |
617 | Safefree (stack); |
586 | } |
618 | } |
587 | else if (ctx->gencnt == stack->gencnt) |
619 | else if (ctx->gencnt == stack->gencnt) |
588 | --stack->usecnt; |
620 | --stack->usecnt; |
589 | } |
621 | } |
… | |
… | |
595 | /* |
627 | /* |
596 | * emulate part of the perl startup here. |
628 | * emulate part of the perl startup here. |
597 | */ |
629 | */ |
598 | dSP; |
630 | dSP; |
599 | Coro__State ctx = (Coro__State)arg; |
631 | Coro__State ctx = (Coro__State)arg; |
600 | SV *sub_init = (SV*)get_cv(SUB_INIT, FALSE); |
632 | SV *sub_init = (SV *)get_cv (SUB_INIT, FALSE); |
601 | |
633 | |
602 | coro_init_stacks (aTHX); |
634 | coro_init_stacks (aTHX); |
603 | /*PL_curcop = 0;*/ |
635 | /*PL_curcop = 0;*/ |
604 | /*PL_in_eval = PL_in_eval;*/ /* inherit */ |
636 | /*PL_in_eval = PL_in_eval;*/ /* inherit */ |
605 | SvREFCNT_dec (GvAV (PL_defgv)); |
637 | SvREFCNT_dec (GvAV (PL_defgv)); |
606 | GvAV (PL_defgv) = ctx->args; |
638 | GvAV (PL_defgv) = ctx->args; ctx->args = 0; |
607 | |
639 | |
608 | SPAGAIN; |
640 | SPAGAIN; |
609 | |
641 | |
610 | if (ctx->stack) |
642 | if (ctx->stack) |
611 | { |
643 | { |
… | |
… | |
638 | * that doesn't matter, though, since it is only |
670 | * that doesn't matter, though, since it is only |
639 | * pp_nextstate and we never return... |
671 | * pp_nextstate and we never return... |
640 | * ah yes, and I don't care anyways ;) |
672 | * ah yes, and I don't care anyways ;) |
641 | */ |
673 | */ |
642 | PUTBACK; |
674 | PUTBACK; |
643 | PL_op = pp_entersub(); |
675 | PL_op = PL_ppaddr[OP_ENTERSUB](aTHX); |
644 | SPAGAIN; |
676 | SPAGAIN; |
645 | |
677 | |
646 | ENTER; /* necessary e.g. for dounwind */ |
678 | ENTER; /* necessary e.g. for dounwind */ |
647 | } |
679 | } |
648 | } |
680 | } |
… | |
… | |
654 | * this is a _very_ stripped down perl interpreter ;) |
686 | * this is a _very_ stripped down perl interpreter ;) |
655 | */ |
687 | */ |
656 | Coro__State ctx = (Coro__State)arg; |
688 | Coro__State ctx = (Coro__State)arg; |
657 | JMPENV coro_start_env; |
689 | JMPENV coro_start_env; |
658 | |
690 | |
659 | /* same as JMPENV_BOOTSTRAP */ |
|
|
660 | Zero(&coro_start_env, 1, JMPENV); |
|
|
661 | coro_start_env.je_ret = -1; |
|
|
662 | coro_start_env.je_mustcatch = TRUE; |
|
|
663 | PL_top_env = &coro_start_env; |
691 | PL_top_env = &ctx->start_env; |
664 | |
692 | |
665 | ctx->cursp = 0; |
693 | ctx->cursp = 0; |
666 | PL_op = PL_op->op_next; |
694 | PL_op = PL_op->op_next; |
667 | CALLRUNOPS(aTHX); |
695 | CALLRUNOPS(aTHX); |
668 | |
696 | |
669 | abort (); |
697 | abort (); |
670 | } |
698 | } |
671 | |
699 | |
672 | STATIC void |
700 | STATIC void |
673 | transfer(pTHX_ struct coro *prev, struct coro *next, int flags) |
701 | transfer (pTHX_ struct coro *prev, struct coro *next, int flags) |
674 | { |
702 | { |
675 | dSTACKLEVEL; |
703 | dSTACKLEVEL; |
676 | static struct coro *xnext; |
|
|
677 | |
704 | |
678 | if (prev != next) |
705 | if (prev != next) |
679 | { |
706 | { |
680 | xnext = next; |
|
|
681 | |
|
|
682 | if (next->mainstack) |
707 | if (next->mainstack) |
683 | { |
708 | { |
|
|
709 | LOCK; |
684 | SAVE (prev, flags); |
710 | SAVE (prev, flags); |
685 | LOAD (next); |
711 | LOAD (next); |
|
|
712 | UNLOCK; |
686 | |
713 | |
687 | /* mark this state as in-use */ |
714 | /* mark this state as in-use */ |
688 | next->mainstack = 0; |
715 | next->mainstack = 0; |
689 | next->tmps_ix = -2; |
716 | next->tmps_ix = -2; |
690 | |
717 | |
… | |
… | |
709 | continue_coro, (void *)next, |
736 | continue_coro, (void *)next, |
710 | next->stack->sptr, labs (next->stack->ssize)); |
737 | next->stack->sptr, labs (next->stack->ssize)); |
711 | } |
738 | } |
712 | |
739 | |
713 | coro_transfer (&(prev->stack->cctx), &(next->stack->cctx)); |
740 | coro_transfer (&(prev->stack->cctx), &(next->stack->cctx)); |
|
|
741 | prev->cursp = stacklevel; |
714 | /* don't add any code here */ |
742 | /* don't add any code here */ |
715 | } |
743 | } |
716 | |
744 | else |
|
|
745 | next->cursp = stacklevel; |
717 | } |
746 | } |
718 | else if (next->tmps_ix == -2) |
747 | else if (next->tmps_ix == -2) |
719 | croak ("tried to transfer to running coroutine"); |
748 | croak ("tried to transfer to running coroutine"); |
720 | else |
749 | else |
721 | { |
750 | { |
|
|
751 | LOCK; |
722 | SAVE (prev, -1); /* first get rid of the old state */ |
752 | SAVE (prev, -1); /* first get rid of the old state */ |
|
|
753 | UNLOCK; |
723 | |
754 | |
724 | if (flags & TRANSFER_SAVE_CCTXT) |
755 | if (flags & TRANSFER_SAVE_CCTXT) |
725 | { |
756 | { |
726 | if (!prev->stack) |
757 | if (!prev->stack) |
727 | allocate_stack (prev, 0); |
758 | allocate_stack (prev, 0); |
728 | |
759 | |
729 | if (prev->stack->sptr && flags & TRANSFER_LAZY_STACK) |
760 | if (prev->stack->sptr && flags & TRANSFER_LAZY_STACK) |
730 | { |
761 | { |
|
|
762 | PL_top_env = &next->start_env; |
|
|
763 | |
731 | setup_coro (next); |
764 | setup_coro (next); |
|
|
765 | next->cursp = stacklevel; |
732 | |
766 | |
733 | prev->stack->refcnt++; |
767 | prev->stack->refcnt++; |
734 | prev->stack->usecnt++; |
768 | prev->stack->usecnt++; |
735 | next->stack = prev->stack; |
769 | next->stack = prev->stack; |
736 | next->gencnt = prev->gencnt; |
770 | next->gencnt = prev->gencnt; |
737 | } |
771 | } |
738 | else |
772 | else |
739 | { |
773 | { |
|
|
774 | assert (!next->stack); |
740 | allocate_stack (next, 1); |
775 | allocate_stack (next, 1); |
741 | coro_create (&(next->stack->cctx), |
776 | coro_create (&(next->stack->cctx), |
742 | setup_coro, (void *)next, |
777 | setup_coro, (void *)next, |
743 | next->stack->sptr, labs (next->stack->ssize)); |
778 | next->stack->sptr, labs (next->stack->ssize)); |
744 | coro_transfer (&(prev->stack->cctx), &(next->stack->cctx)); |
779 | coro_transfer (&(prev->stack->cctx), &(next->stack->cctx)); |
|
|
780 | prev->cursp = stacklevel; |
745 | /* don't add any code here */ |
781 | /* don't add any code here */ |
746 | } |
782 | } |
747 | } |
783 | } |
748 | else |
784 | else |
|
|
785 | { |
749 | setup_coro (next); |
786 | setup_coro (next); |
|
|
787 | next->cursp = stacklevel; |
|
|
788 | } |
750 | } |
789 | } |
751 | |
|
|
752 | /* |
|
|
753 | * xnext is now either prev or next, depending on wether |
|
|
754 | * we switched the c stack or not. that's why i use a global |
|
|
755 | * variable, that should become thread-specific at one point. |
|
|
756 | */ |
|
|
757 | xnext->cursp = stacklevel; |
|
|
758 | } |
790 | } |
759 | |
791 | |
|
|
792 | LOCK; |
760 | if (coro_mortal) |
793 | if (coro_mortal) |
761 | { |
794 | { |
762 | SvREFCNT_dec (coro_mortal); |
795 | SvREFCNT_dec (coro_mortal); |
763 | coro_mortal = 0; |
796 | coro_mortal = 0; |
764 | } |
797 | } |
|
|
798 | UNLOCK; |
765 | } |
799 | } |
766 | |
800 | |
767 | #define SV_CORO(sv,func) \ |
801 | #define SV_CORO(sv,func) \ |
768 | do { \ |
802 | do { \ |
769 | if (SvROK (sv)) \ |
803 | if (SvROK (sv)) \ |
770 | sv = SvRV (sv); \ |
804 | sv = SvRV (sv); \ |
771 | \ |
805 | \ |
772 | if (SvTYPE(sv) == SVt_PVHV) \ |
806 | if (SvTYPE (sv) == SVt_PVHV) \ |
773 | { \ |
807 | { \ |
774 | HE *he = hv_fetch_ent((HV *)sv, ucoro_state_sv, 0, ucoro_state_hash); \ |
808 | HE *he = hv_fetch_ent ((HV *)sv, ucoro_state_sv, 0, ucoro_state_hash); \ |
775 | \ |
809 | \ |
776 | if (!he) \ |
810 | if (!he) \ |
777 | croak ("%s() -- %s is a hashref but lacks the " UCORO_STATE " key", func, # sv); \ |
811 | croak ("%s() -- %s is a hashref but lacks the " UCORO_STATE " key", func, # sv); \ |
778 | \ |
812 | \ |
779 | (sv) = SvRV (HeVAL(he)); \ |
813 | (sv) = SvRV (HeVAL(he)); \ |
780 | } \ |
814 | } \ |
781 | \ |
815 | \ |
782 | /* must also be changed inside Coro::Cont::yield */ \ |
816 | /* must also be changed inside Coro::Cont::yield */ \ |
783 | if (!SvOBJECT(sv) || SvSTASH(sv) != coro_state_stash) \ |
817 | if (!SvOBJECT (sv) || SvSTASH (sv) != coro_state_stash) \ |
784 | croak ("%s() -- %s is not (and contains not) a Coro::State object", func, # sv); \ |
818 | croak ("%s() -- %s is not (and contains not) a Coro::State object", func, # sv); \ |
785 | \ |
819 | \ |
786 | } while(0) |
820 | } while(0) |
787 | |
821 | |
788 | #define SvSTATE(sv) (struct coro *)SvIV (sv) |
822 | #define SvSTATE(sv) (struct coro *)SvIV (sv) |
… | |
… | |
854 | api_ready (SV *coro) |
888 | api_ready (SV *coro) |
855 | { |
889 | { |
856 | if (SvROK (coro)) |
890 | if (SvROK (coro)) |
857 | coro = SvRV (coro); |
891 | coro = SvRV (coro); |
858 | |
892 | |
|
|
893 | LOCK; |
859 | coro_enq (SvREFCNT_inc (coro)); |
894 | coro_enq (SvREFCNT_inc (coro)); |
|
|
895 | UNLOCK; |
860 | } |
896 | } |
861 | |
897 | |
862 | static void |
898 | static void |
863 | api_schedule (void) |
899 | api_schedule (void) |
864 | { |
900 | { |
865 | SV *prev, *next; |
901 | SV *prev, *next; |
866 | |
902 | |
|
|
903 | LOCK; |
|
|
904 | |
867 | prev = SvRV (GvSV (coro_current)); |
905 | prev = SvRV (GvSV (coro_current)); |
868 | next = coro_deq (PRIO_MIN); |
906 | next = coro_deq (PRIO_MIN); |
869 | |
907 | |
870 | if (!next) |
908 | if (!next) |
871 | next = SvREFCNT_inc (SvRV (GvSV (coro_idle))); |
909 | next = SvREFCNT_inc (SvRV (GvSV (coro_idle))); |
872 | |
910 | |
|
|
911 | /* free this only after the transfer */ |
873 | coro_mortal = prev; |
912 | coro_mortal = prev; |
874 | SV_CORO (prev, "Coro::schedule"); |
913 | SV_CORO (prev, "Coro::schedule"); |
875 | |
914 | |
876 | SvRV (GvSV (coro_current)) = next; |
915 | SvRV (GvSV (coro_current)) = next; |
877 | |
916 | |
878 | SV_CORO (next, "Coro::schedule"); |
917 | SV_CORO (next, "Coro::schedule"); |
879 | |
918 | |
|
|
919 | UNLOCK; |
|
|
920 | |
880 | transfer (aTHX_ SvSTATE (prev), SvSTATE (next), |
921 | transfer (aTHX_ SvSTATE (prev), SvSTATE (next), |
881 | TRANSFER_SAVE_ALL | TRANSFER_LAZY_STACK); |
922 | TRANSFER_SAVE_ALL | TRANSFER_LAZY_STACK); |
882 | } |
923 | } |
883 | |
924 | |
884 | static void |
925 | static void |
885 | api_cede (void) |
926 | api_cede (void) |
886 | { |
927 | { |
|
|
928 | LOCK; |
887 | coro_enq (SvREFCNT_inc (SvRV (GvSV (coro_current)))); |
929 | coro_enq (SvREFCNT_inc (SvRV (GvSV (coro_current)))); |
|
|
930 | UNLOCK; |
888 | |
931 | |
889 | api_schedule (); |
932 | api_schedule (); |
890 | } |
933 | } |
891 | |
934 | |
892 | MODULE = Coro::State PACKAGE = Coro::State |
935 | MODULE = Coro::State PACKAGE = Coro::State |
893 | |
936 | |
894 | PROTOTYPES: ENABLE |
937 | PROTOTYPES: ENABLE |
895 | |
938 | |
896 | BOOT: |
939 | BOOT: |
897 | { /* {} necessary for stoopid perl-5.6.x */ |
940 | { /* {} necessary for stoopid perl-5.6.x */ |
|
|
941 | #ifdef USE_ITHREADS |
|
|
942 | MUTEX_INIT (&coro_mutex); |
|
|
943 | #endif |
|
|
944 | |
898 | ucoro_state_sv = newSVpv (UCORO_STATE, sizeof(UCORO_STATE) - 1); |
945 | ucoro_state_sv = newSVpv (UCORO_STATE, sizeof(UCORO_STATE) - 1); |
899 | PERL_HASH(ucoro_state_hash, UCORO_STATE, sizeof(UCORO_STATE) - 1); |
946 | PERL_HASH(ucoro_state_hash, UCORO_STATE, sizeof(UCORO_STATE) - 1); |
900 | coro_state_stash = gv_stashpv ("Coro::State", TRUE); |
947 | coro_state_stash = gv_stashpv ("Coro::State", TRUE); |
901 | |
948 | |
902 | newCONSTSUB (coro_state_stash, "SAVE_DEFAV", newSViv (TRANSFER_SAVE_DEFAV)); |
949 | newCONSTSUB (coro_state_stash, "SAVE_DEFAV", newSViv (TRANSFER_SAVE_DEFAV)); |
903 | newCONSTSUB (coro_state_stash, "SAVE_DEFSV", newSViv (TRANSFER_SAVE_DEFSV)); |
950 | newCONSTSUB (coro_state_stash, "SAVE_DEFSV", newSViv (TRANSFER_SAVE_DEFSV)); |
904 | newCONSTSUB (coro_state_stash, "SAVE_ERRSV", newSViv (TRANSFER_SAVE_ERRSV)); |
951 | newCONSTSUB (coro_state_stash, "SAVE_ERRSV", newSViv (TRANSFER_SAVE_ERRSV)); |
905 | newCONSTSUB (coro_state_stash, "SAVE_CCTXT", newSViv (TRANSFER_SAVE_CCTXT)); |
952 | newCONSTSUB (coro_state_stash, "SAVE_CCTXT", newSViv (TRANSFER_SAVE_CCTXT)); |
906 | |
|
|
907 | if (!padlist_cache) |
|
|
908 | padlist_cache = newHV (); |
|
|
909 | |
953 | |
910 | main_mainstack = PL_mainstack; |
954 | main_mainstack = PL_mainstack; |
911 | |
955 | |
912 | coroapi.ver = CORO_API_VERSION; |
956 | coroapi.ver = CORO_API_VERSION; |
913 | coroapi.transfer = api_transfer; |
957 | coroapi.transfer = api_transfer; |
… | |
… | |
921 | Coro__State coro; |
965 | Coro__State coro; |
922 | |
966 | |
923 | if (!SvROK (args) || SvTYPE (SvRV (args)) != SVt_PVAV) |
967 | if (!SvROK (args) || SvTYPE (SvRV (args)) != SVt_PVAV) |
924 | croak ("Coro::State::_newprocess expects an arrayref"); |
968 | croak ("Coro::State::_newprocess expects an arrayref"); |
925 | |
969 | |
926 | New (0, coro, 1, struct coro); |
970 | Newz (0, coro, 1, struct coro); |
927 | |
971 | |
928 | coro->args = (AV *)SvREFCNT_inc (SvRV (args)); |
972 | coro->args = (AV *)SvREFCNT_inc (SvRV (args)); |
929 | coro->mainstack = 0; /* actual work is done inside transfer */ |
973 | coro->mainstack = 0; /* actual work is done inside transfer */ |
930 | coro->stack = 0; |
974 | coro->stack = 0; |
|
|
975 | |
|
|
976 | /* same as JMPENV_BOOTSTRAP */ |
|
|
977 | /* we might be able to recycle start_env, but safe is safe */ |
|
|
978 | //Zero(&coro->start_env, 1, JMPENV); |
|
|
979 | coro->start_env.je_ret = -1; |
|
|
980 | coro->start_env.je_mustcatch = TRUE; |
931 | |
981 | |
932 | RETVAL = coro; |
982 | RETVAL = coro; |
933 | OUTPUT: |
983 | OUTPUT: |
934 | RETVAL |
984 | RETVAL |
935 | |
985 | |
… | |
… | |
967 | |
1017 | |
968 | coro->mainstack = 0; |
1018 | coro->mainstack = 0; |
969 | } |
1019 | } |
970 | |
1020 | |
971 | deallocate_stack (coro); |
1021 | deallocate_stack (coro); |
972 | |
1022 | SvREFCNT_dec (coro->args); |
973 | Safefree (coro); |
1023 | Safefree (coro); |
974 | |
|
|
975 | void |
|
|
976 | flush() |
|
|
977 | CODE: |
|
|
978 | #ifdef MAY_FLUSH |
|
|
979 | flush_padlist_cache (); |
|
|
980 | #endif |
|
|
981 | |
1024 | |
982 | void |
1025 | void |
983 | _exit(code) |
1026 | _exit(code) |
984 | int code |
1027 | int code |
985 | PROTOTYPE: $ |
1028 | PROTOTYPE: $ |
986 | CODE: |
1029 | CODE: |
987 | #if defined(__GLIBC__) || _POSIX_C_SOURCE |
|
|
988 | _exit (code); |
1030 | _exit (code); |
989 | #else |
|
|
990 | signal (SIGTERM, SIG_DFL); |
|
|
991 | raise (SIGTERM); |
|
|
992 | exit (code); |
|
|
993 | #endif |
|
|
994 | |
1031 | |
995 | MODULE = Coro::State PACKAGE = Coro::Cont |
1032 | MODULE = Coro::State PACKAGE = Coro::Cont |
996 | |
1033 | |
997 | # this is slightly dirty (should expose a c-level api) |
1034 | # this is slightly dirty (should expose a c-level api) |
998 | |
1035 | |
… | |
… | |
1004 | SV *sv; |
1041 | SV *sv; |
1005 | AV *defav = GvAV (PL_defgv); |
1042 | AV *defav = GvAV (PL_defgv); |
1006 | struct coro *prev, *next; |
1043 | struct coro *prev, *next; |
1007 | |
1044 | |
1008 | if (!returnstk) |
1045 | if (!returnstk) |
1009 | returnstk = SvRV (get_sv ("Coro::Cont::return", FALSE)); |
1046 | returnstk = SvRV ((SV *)get_sv ("Coro::Cont::return", FALSE)); |
1010 | |
1047 | |
1011 | /* set up @_ -- ugly */ |
1048 | /* set up @_ -- ugly */ |
1012 | av_clear (defav); |
1049 | av_clear (defav); |
1013 | av_fill (defav, items - 1); |
1050 | av_fill (defav, items - 1); |
1014 | while (items--) |
1051 | while (items--) |
… | |
… | |
1057 | sv_setiv(sv, (IV)&coroapi); |
1094 | sv_setiv(sv, (IV)&coroapi); |
1058 | SvREADONLY_on(sv); |
1095 | SvREADONLY_on(sv); |
1059 | } |
1096 | } |
1060 | } |
1097 | } |
1061 | |
1098 | |
|
|
1099 | #if !PERL_MICRO |
|
|
1100 | |
1062 | void |
1101 | void |
1063 | ready(self) |
1102 | ready(self) |
1064 | SV * self |
1103 | SV * self |
1065 | PROTOTYPE: $ |
1104 | PROTOTYPE: $ |
1066 | CODE: |
1105 | CODE: |
1067 | api_ready (self); |
1106 | api_ready (self); |
|
|
1107 | |
|
|
1108 | #endif |
1068 | |
1109 | |
1069 | int |
1110 | int |
1070 | nready(...) |
1111 | nready(...) |
1071 | PROTOTYPE: |
1112 | PROTOTYPE: |
1072 | CODE: |
1113 | CODE: |