[ViewVC] Diff of: cvs/Coro/Coro/State.xs

Comparing Coro/Coro/State.xs (file contents):
Revision 1.75 by root, Thu Oct 26 06:50:20 2006 UTC vs.
Revision 1.183 by root, Wed Oct 3 19:19:06 2007 UTC

…		…
		1	#include "libcoro/coro.c"
		2
1	#define PERL_NO_GET_CONTEXT	3	#define PERL_NO_GET_CONTEXT
2
3	#include "libcoro/coro.c"
4		4
5	#include "EXTERN.h"	5	#include "EXTERN.h"
6	#include "perl.h"	6	#include "perl.h"
7	#include "XSUB.h"	7	#include "XSUB.h"
8		8
9	#include "patchlevel.h"	9	#include "patchlevel.h"
10		10
11	#if PERL_VERSION < 6	11	#include <stdio.h>
		12	#include <errno.h>
		13	#include <assert.h>
		14
		15	#ifdef HAVE_MMAP
		16	# include <unistd.h>
		17	# include <sys/mman.h>
		18	# ifndef MAP_ANONYMOUS
		19	# ifdef MAP_ANON
		20	# define MAP_ANONYMOUS MAP_ANON
		21	# else
		22	# undef HAVE_MMAP
		23	# endif
		24	# endif
		25	# include <limits.h>
		26	# ifndef PAGESIZE
		27	# define PAGESIZE pagesize
		28	# define BOOT_PAGESIZE pagesize = sysconf (_SC_PAGESIZE)
		29	static long pagesize;
		30	# else
		31	# define BOOT_PAGESIZE (void)0
		32	# endif
		33	#else
		34	# define PAGESIZE 0
		35	# define BOOT_PAGESIZE (void)0
		36	#endif
		37
		38	#if CORO_USE_VALGRIND
		39	# include <valgrind/valgrind.h>
		40	# define REGISTER_STACK(cctx,start,end) (cctx)->valgrind_id = VALGRIND_STACK_REGISTER ((start), (end))
		41	#else
		42	# define REGISTER_STACK(cctx,start,end)
		43	#endif
		44
		45	/* the maximum number of idle cctx that will be pooled */
		46	#define MAX_IDLE_CCTX 8
		47
		48	#define PERL_VERSION_ATLEAST(a,b,c) \
		49	(PERL_REVISION > (a) \
		50	\|\| (PERL_REVISION == (a) \
		51	&& (PERL_VERSION > (b) \
		52	\|\| (PERL_VERSION == (b) && PERLSUBVERSION >= (c)))))
		53
		54	#if !PERL_VERSION_ATLEAST (5,6,0)
12	# ifndef PL_ppaddr	55	# ifndef PL_ppaddr
13	# define PL_ppaddr ppaddr	56	# define PL_ppaddr ppaddr
14	# endif	57	# endif
15	# ifndef call_sv	58	# ifndef call_sv
16	# define call_sv perl_call_sv	59	# define call_sv perl_call_sv
27	# ifndef IS_PADCONST	70	# ifndef IS_PADCONST
28	# define IS_PADCONST(v) 0	71	# define IS_PADCONST(v) 0
29	# endif	72	# endif
30	#endif	73	#endif
31		74
32	#include <errno.h>	75	/* 5.8.7 */
33	#include <signal.h>	76	#ifndef SvRV_set
34		77	# define SvRV_set(s,v) SvRV(s) = (v)
35	#ifdef HAVE_MMAP
36	# include <unistd.h>
37	# include <sys/mman.h>
38	# ifndef MAP_ANONYMOUS
39	# ifdef MAP_ANON
40	# define MAP_ANONYMOUS MAP_ANON
41	# else
42	# undef HAVE_MMAP
43	# endif
44	# endif	78	#endif
45	#endif
46		79
47	#define SUB_INIT "Coro::State::initialize"	80	#if !__i386 && !__x86_64 && !__powerpc && !__m68k && !__alpha && !__mips && !__sparc64
48	#define UCORO_STATE "_coro_state"	81	# undef CORO_STACKGUARD
		82	#endif
49		83
50	/* The next macro should declare a variable stacklevel that contains and approximation	84	#ifndef CORO_STACKGUARD
51	* to the current C stack pointer. Its property is that it changes with each call	85	# define CORO_STACKGUARD 0
52	* and should be unique. */	86	#endif
		87
		88	/* prefer perl internal functions over our own? */
		89	#ifndef CORO_PREFER_PERL_FUNCTIONS
		90	# define CORO_PREFER_PERL_FUNCTIONS 0
		91	#endif
		92
		93	/* The next macros try to return the current stack pointer, in an as
		94	* portable way as possible. */
		95	#define dSTACKLEVEL volatile char stacklevel
53	#define dSTACKLEVEL void *stacklevel = &stacklevel	96	#define STACKLEVEL ((void *)&stacklevel)
54		97
55	#define IN_DESTRUCT (PL_main_cv == Nullcv)	98	#define IN_DESTRUCT (PL_main_cv == Nullcv)
56		99
57	#define labs(l) ((l) >= 0 ? (l) : -(l))	100	#if __GNUC__ >= 3
		101	# define attribute(x) __attribute__(x)
		102	# define BARRIER __asm__ __volatile__ ("" : : : "memory")
		103	#else
		104	# define attribute(x)
		105	# define BARRIER
		106	#endif
		107
		108	#define NOINLINE attribute ((noinline))
58		109
59	#include "CoroAPI.h"	110	#include "CoroAPI.h"
60		111
61	#ifdef USE_ITHREADS	112	#ifdef USE_ITHREADS
62	static perl_mutex coro_mutex;	113	static perl_mutex coro_mutex;
…		…
65	#else	116	#else
66	# define LOCK (void)0	117	# define LOCK (void)0
67	# define UNLOCK (void)0	118	# define UNLOCK (void)0
68	#endif	119	#endif
69		120
		121	/* helper storage struct for Coro::AIO */
		122	struct io_state
		123	{
		124	int errorno;
		125	I32 laststype;
		126	int laststatval;
		127	Stat_t statcache;
		128	};
		129
		130	static size_t coro_stacksize = CORO_STACKSIZE;
70	static struct CoroAPI coroapi;	131	static struct CoroAPI coroapi;
71	static AV main_mainstack; / used to differentiate between $main and others */	132	static AV main_mainstack; / used to differentiate between $main and others */
		133	static JMPENV *main_top_env;
72	static HV *coro_state_stash;	134	static HV coro_state_stash, coro_stash;
73	static SV *ucoro_state_sv;
74	static U32 ucoro_state_hash;
75	static SV coro_mortal; / will be freed after next transfer */	135	static SV coro_mortal; / will be freed after next transfer */
76		136
77	/* this is actually not only the c stack but also c registers etc... */	137	static GV irsgv; / $/ */
		138
		139	/* async_pool helper stuff */
		140	static SV *sv_pool_rss;
		141	static SV *sv_pool_size;
		142	static AV *av_async_pool;
		143
		144	static struct coro_cctx *cctx_first;
		145	static int cctx_count, cctx_idle;
		146
		147	enum {
		148	CC_MAPPED = 0x01,
		149	CC_NOREUSE = 0x02, /* throw this away after tracing */
		150	CC_TRACE = 0x04,
		151	CC_TRACE_SUB = 0x08, /* trace sub calls */
		152	CC_TRACE_LINE = 0x10, /* trace each statement */
		153	CC_TRACE_ALL = CC_TRACE_SUB \| CC_TRACE_LINE,
		154	};
		155
		156	/* this is a structure representing a c-level coroutine */
78	typedef struct {	157	typedef struct coro_cctx {
79	int refcnt; /* pointer reference counter */	158	struct coro_cctx *next;
80	int usecnt; /* shared by how many coroutines */
81	int gencnt; /* generation counter */
82		159
		160	/* the stack */
		161	void *sptr;
		162	size_t ssize;
		163
		164	/* cpu state */
		165	void idle_sp; / sp of top-level transfer/schedule/cede call */
		166	JMPENV idle_te; / same as idle_sp, but for top_env, TODO: remove once stable */
		167	JMPENV *top_env;
83	coro_context cctx;	168	coro_context cctx;
84		169
85	void *sptr;	170	#if CORO_USE_VALGRIND
86	long ssize; /* positive == mmap, otherwise malloc */	171	int valgrind_id;
87	} coro_stack;	172	#endif
		173	unsigned char flags;
		174	} coro_cctx;
88		175
		176	enum {
		177	CF_RUNNING = 0x0001, /* coroutine is running */
		178	CF_READY = 0x0002, /* coroutine is ready */
		179	CF_NEW = 0x0004, /* has never been switched to */
		180	CF_DESTROYED = 0x0008, /* coroutine data has been freed */
		181	};
		182
		183	/* this is a structure representing a perl-level coroutine */
89	struct coro {	184	struct coro {
90	/* the top-level JMPENV for each coroutine, needed to catch dies. */	185	/* the c coroutine allocated to this perl coroutine, if any */
91	JMPENV start_env;	186	coro_cctx *cctx;
92
93	/* the optional C context */
94	coro_stack *stack;
95	void *cursp;
96	int gencnt;
97
98	/* optionally saved, might be zero */
99	AV *defav;
100	SV *defsv;
101	SV *errsv;
102
103	/* saved global state not related to stacks */
104	U8 dowarn;
105	I32 in_eval;
106
107	/* the stacks and related info (callchain etc..) */
108	PERL_SI *curstackinfo;
109	AV *curstack;
110	AV *mainstack;
111	SV **stack_sp;
112	OP *op;
113	SV **curpad;
114	AV *comppad;
115	CV *compcv;
116	SV **stack_base;
117	SV **stack_max;
118	SV **tmps_stack;
119	I32 tmps_floor;
120	I32 tmps_ix;
121	I32 tmps_max;
122	I32 *markstack;
123	I32 *markstack_ptr;
124	I32 *markstack_max;
125	I32 *scopestack;
126	I32 scopestack_ix;
127	I32 scopestack_max;
128	ANY *savestack;
129	I32 savestack_ix;
130	I32 savestack_max;
131	OP **retstack;
132	I32 retstack_ix;
133	I32 retstack_max;
134	PMOP *curpm;
135	COP *curcop;
136	JMPENV *top_env;
137		187
138	/* data associated with this coroutine (initial args) */	188	/* data associated with this coroutine (initial args) */
139	AV *args;	189	AV *args;
		190	int refcnt;
		191	int flags; /* CF_ flags */
		192
		193	/* optionally saved, might be zero */
		194	AV defav; / @_ */
		195	SV defsv; / $_ */
		196	SV errsv; / $@ */
		197	GV deffh; / default filehandle */
		198	SV irssv; / $/ */
		199	SV irssv_sv; / real $/ cache */
		200
		201	#define VAR(name,type) type name;
		202	# include "state.h"
		203	#undef VAR
		204
		205	/* statistics */
		206	int usecount; /* number of transfers to this coro */
		207
		208	/* coro process data */
		209	int prio;
		210	//SV *throw;
		211
		212	/* async_pool */
		213	GV *asp_deffh;
		214
		215	/* linked list */
		216	struct coro next, prev;
		217	HV hv; / the perl hash associated with this coro, if any */
140	};	218	};
141		219
142	typedef struct coro *Coro__State;	220	typedef struct coro *Coro__State;
143	typedef struct coro *Coro__State_or_hashref;	221	typedef struct coro *Coro__State_or_hashref;
144		222
145	/* mostly copied from op.c:cv_clone2 */	223	/ Coro ******************************************************************/
146	STATIC AV *	224
147	clone_padlist (pTHX_ AV *protopadlist)	225	#define PRIO_MAX 3
		226	#define PRIO_HIGH 1
		227	#define PRIO_NORMAL 0
		228	#define PRIO_LOW -1
		229	#define PRIO_IDLE -3
		230	#define PRIO_MIN -4
		231
		232	/* for Coro.pm */
		233	static SV *coro_current;
		234	static AV *coro_ready [PRIO_MAX-PRIO_MIN+1];
		235	static int coro_nready;
		236	static struct coro *coro_first;
		237
		238	/ lowlevel stuff ********************************************************/
		239
		240	static AV *
		241	coro_clone_padlist (pTHX_ CV *cv)
148	{	242	{
149	AV *av;	243	AV *padlist = CvPADLIST (cv);
150	I32 ix;
151	AV protopad_name = (AV ) * av_fetch (protopadlist, 0, FALSE);
152	AV protopad = (AV ) * av_fetch (protopadlist, 1, FALSE);
153	SV **pname = AvARRAY (protopad_name);
154	SV **ppad = AvARRAY (protopad);
155	I32 fname = AvFILLp (protopad_name);
156	I32 fpad = AvFILLp (protopad);
157	AV newpadlist, newpad_name, *newpad;	244	AV newpadlist, newpad;
158	SV **npad;
159
160	newpad_name = newAV ();
161	for (ix = fname; ix >= 0; ix--)
162	av_store (newpad_name, ix, SvREFCNT_inc (pname[ix]));
163
164	newpad = newAV ();
165	av_fill (newpad, AvFILLp (protopad));
166	npad = AvARRAY (newpad);
167		245
168	newpadlist = newAV ();	246	newpadlist = newAV ();
169	AvREAL_off (newpadlist);	247	AvREAL_off (newpadlist);
170	av_store (newpadlist, 0, (SV *) newpad_name);	248	#if PERL_VERSION_ATLEAST (5,9,0)
		249	Perl_pad_push (aTHX_ padlist, AvFILLp (padlist) + 1);
		250	#else
		251	Perl_pad_push (aTHX_ padlist, AvFILLp (padlist) + 1, 1);
		252	#endif
		253	newpad = (AV *)AvARRAY (padlist)[AvFILLp (padlist)];
		254	--AvFILLp (padlist);
		255
		256	av_store (newpadlist, 0, SvREFCNT_inc (*av_fetch (padlist, 0, FALSE)));
171	av_store (newpadlist, 1, (SV *) newpad);	257	av_store (newpadlist, 1, (SV *)newpad);
172
173	av = newAV (); /* will be @_ */
174	av_extend (av, 0);
175	av_store (newpad, 0, (SV *) av);
176	AvREIFY_on (av);
177
178	for (ix = fpad; ix > 0; ix--)
179	{
180	SV *namesv = (ix <= fname) ? pname[ix] : Nullsv;
181
182	if (namesv && namesv != &PL_sv_undef)
183	{
184	char name = SvPVX (namesv); / XXX */
185
186	if (SvFLAGS (namesv) & SVf_FAKE \|\| *name == '&')
187	{ /* lexical from outside? */
188	npad[ix] = SvREFCNT_inc (ppad[ix]);
189	}
190	else
191	{ /* our own lexical */
192	SV *sv;
193	if (*name == '&')
194	sv = SvREFCNT_inc (ppad[ix]);
195	else if (*name == '@')
196	sv = (SV *) newAV ();
197	else if (*name == '%')
198	sv = (SV *) newHV ();
199	else
200	sv = NEWSV (0, 0);
201
202	#ifdef SvPADBUSY
203	if (!SvPADBUSY (sv))
204	#endif
205	SvPADMY_on (sv);
206
207	npad[ix] = sv;
208	}
209	}
210	else if (IS_PADGV (ppad[ix]) \|\| IS_PADCONST (ppad[ix]))
211	{
212	npad[ix] = SvREFCNT_inc (ppad[ix]);
213	}
214	else
215	{
216	SV *sv = NEWSV (0, 0);
217	SvPADTMP_on (sv);
218	npad[ix] = sv;
219	}
220	}
221
222	#if 0 /* return -ENOTUNDERSTOOD */
223	/* Now that vars are all in place, clone nested closures. */
224
225	for (ix = fpad; ix > 0; ix--) {
226	SV* namesv = (ix <= fname) ? pname[ix] : Nullsv;
227	if (namesv
228	&& namesv != &PL_sv_undef
229	&& !(SvFLAGS(namesv) & SVf_FAKE)
230	&& *SvPVX(namesv) == '&'
231	&& CvCLONE(ppad[ix]))
232	{
233	CV kid = cv_clone((CV)ppad[ix]);
234	SvREFCNT_dec(ppad[ix]);
235	CvCLONE_on(kid);
236	SvPADMY_on(kid);
237	npad[ix] = (SV*)kid;
238	}
239	}
240	#endif
241		258
242	return newpadlist;	259	return newpadlist;
243	}	260	}
244		261
245	STATIC void	262	static void
246	free_padlist (pTHX_ AV *padlist)	263	free_padlist (pTHX_ AV *padlist)
247	{	264	{
248	/* may be during global destruction */	265	/* may be during global destruction */
249	if (SvREFCNT (padlist))	266	if (SvREFCNT (padlist))
250	{	267	{
…		…
264		281
265	SvREFCNT_dec ((SV*)padlist);	282	SvREFCNT_dec ((SV*)padlist);
266	}	283	}
267	}	284	}
268		285
269	STATIC int	286	static int
270	coro_cv_free (pTHX_ SV sv, MAGIC mg)	287	coro_cv_free (pTHX_ SV sv, MAGIC mg)
271	{	288	{
272	AV *padlist;	289	AV *padlist;
273	AV av = (AV )mg->mg_obj;	290	AV av = (AV )mg->mg_obj;
274		291
275	/* casting is fun. */	292	/* casting is fun. */
276	while (&PL_sv_undef != (SV )(padlist = (AV )av_pop (av)))	293	while (&PL_sv_undef != (SV )(padlist = (AV )av_pop (av)))
277	free_padlist (aTHX_ padlist);	294	free_padlist (aTHX_ padlist);
278		295
279	SvREFCNT_dec (av);	296	SvREFCNT_dec (av);
		297
		298	return 0;
280	}	299	}
281		300
282	#define PERL_MAGIC_coro PERL_MAGIC_ext	301	#define PERL_MAGIC_coro PERL_MAGIC_ext
283		302
284	static MGVTBL vtbl_coro = {0, 0, 0, 0, coro_cv_free};	303	static MGVTBL vtbl_coro = {0, 0, 0, 0, coro_cv_free};
285		304
		305	#define CORO_MAGIC(cv) \
		306	SvMAGIC (cv) \
		307	? SvMAGIC (cv)->mg_type == PERL_MAGIC_coro \
		308	? SvMAGIC (cv) \
		309	: mg_find ((SV *)cv, PERL_MAGIC_coro) \
		310	: 0
		311
		312	static struct coro *
		313	SvSTATE_ (pTHX_ SV *coro)
		314	{
		315	HV *stash;
		316	MAGIC *mg;
		317
		318	if (SvROK (coro))
		319	coro = SvRV (coro);
		320
		321	if (SvTYPE (coro) != SVt_PVHV)
		322	croak ("Coro::State object required");
		323
		324	stash = SvSTASH (coro);
		325	if (stash != coro_stash && stash != coro_state_stash)
		326	{
		327	/* very slow, but rare, check */
		328	if (!sv_derived_from (sv_2mortal (newRV_inc (coro)), "Coro::State"))
		329	croak ("Coro::State object required");
		330	}
		331
		332	mg = CORO_MAGIC (coro);
		333	return (struct coro *)mg->mg_ptr;
		334	}
		335
		336	#define SvSTATE(sv) SvSTATE_ (aTHX_ (sv))
		337
286	/* the next two functions merely cache the padlists */	338	/* the next two functions merely cache the padlists */
287	STATIC void	339	static void
288	get_padlist (pTHX_ CV *cv)	340	get_padlist (pTHX_ CV *cv)
289	{	341	{
290	MAGIC mg = mg_find ((SV )cv, PERL_MAGIC_coro);	342	MAGIC *mg = CORO_MAGIC (cv);
		343	AV *av;
291		344
292	if (mg && AvFILLp ((AV *)mg->mg_obj) >= 0)	345	if (mg && AvFILLp ((av = (AV *)mg->mg_obj)) >= 0)
293	CvPADLIST (cv) = (AV )av_pop ((AV )mg->mg_obj);	346	CvPADLIST (cv) = (AV *)AvARRAY (av)[AvFILLp (av)--];
294	else	347	else
		348	{
		349	#if CORO_PREFER_PERL_FUNCTIONS
		350	/* this is probably cleaner, but also slower? */
		351	CV *cp = Perl_cv_clone (cv);
		352	CvPADLIST (cv) = CvPADLIST (cp);
		353	CvPADLIST (cp) = 0;
		354	SvREFCNT_dec (cp);
		355	#else
295	CvPADLIST (cv) = clone_padlist (aTHX_ CvPADLIST (cv));	356	CvPADLIST (cv) = coro_clone_padlist (aTHX_ cv);
		357	#endif
		358	}
296	}	359	}
297		360
298	STATIC void	361	static void
299	put_padlist (pTHX_ CV *cv)	362	put_padlist (pTHX_ CV *cv)
300	{	363	{
301	MAGIC mg = mg_find ((SV )cv, PERL_MAGIC_coro);	364	MAGIC *mg = CORO_MAGIC (cv);
		365	AV *av;
302		366
303	if (!mg)	367	if (!mg)
304	{	368	{
305	sv_magic ((SV *)cv, 0, PERL_MAGIC_coro, 0, 0);	369	sv_magic ((SV *)cv, 0, PERL_MAGIC_coro, 0, 0);
306	mg = mg_find ((SV *)cv, PERL_MAGIC_coro);	370	mg = mg_find ((SV *)cv, PERL_MAGIC_coro);
307	mg->mg_virtual = &vtbl_coro;	371	mg->mg_virtual = &vtbl_coro;
308	mg->mg_obj = (SV *)newAV ();	372	mg->mg_obj = (SV *)newAV ();
309	}	373	}
310		374
311	av_push ((AV )mg->mg_obj, (SV )CvPADLIST (cv));	375	av = (AV *)mg->mg_obj;
312	}
313		376
314	#define SB do {	377	if (AvFILLp (av) >= AvMAX (av))
315	#define SE } while (0)	378	av_extend (av, AvMAX (av) + 1);
316		379
317	#define LOAD(state) load_state(aTHX_ (state));	380	AvARRAY (av)[++AvFILLp (av)] = (SV *)CvPADLIST (cv);
318	#define SAVE(state,flags) save_state(aTHX_ (state),(flags));	381	}
319		382
320	#define REPLACE_SV(sv,val) SB SvREFCNT_dec(sv); (sv) = (val); (val) = 0; SE	383	/ load & save, init *****************************************************/
321		384
322	static void	385	static void
323	load_state(pTHX_ Coro__State c)	386	load_perl (pTHX_ Coro__State c)
324	{	387	{
325	PL_dowarn = c->dowarn;	388	#define VAR(name,type) PL_ ## name = c->name;
326	PL_in_eval = c->in_eval;	389	# include "state.h"
		390	#undef VAR
327		391
328	PL_curstackinfo = c->curstackinfo;	392	GvSV (PL_defgv) = c->defsv;
329	PL_curstack = c->curstack;	393	GvAV (PL_defgv) = c->defav;
330	PL_mainstack = c->mainstack;	394	GvSV (PL_errgv) = c->errsv;
331	PL_stack_sp = c->stack_sp;	395	PL_defoutgv = c->deffh;
332	PL_op = c->op;	396	PL_rs = c->irssv;
333	PL_curpad = c->curpad;	397	GvSV (irsgv) = c->irssv_sv;
334	PL_comppad = c->comppad;
335	PL_compcv = c->compcv;
336	PL_stack_base = c->stack_base;
337	PL_stack_max = c->stack_max;
338	PL_tmps_stack = c->tmps_stack;
339	PL_tmps_floor = c->tmps_floor;
340	PL_tmps_ix = c->tmps_ix;
341	PL_tmps_max = c->tmps_max;
342	PL_markstack = c->markstack;
343	PL_markstack_ptr = c->markstack_ptr;
344	PL_markstack_max = c->markstack_max;
345	PL_scopestack = c->scopestack;
346	PL_scopestack_ix = c->scopestack_ix;
347	PL_scopestack_max = c->scopestack_max;
348	PL_savestack = c->savestack;
349	PL_savestack_ix = c->savestack_ix;
350	PL_savestack_max = c->savestack_max;
351	#if PERL_VERSION < 9
352	PL_retstack = c->retstack;
353	PL_retstack_ix = c->retstack_ix;
354	PL_retstack_max = c->retstack_max;
355	#endif
356	PL_curpm = c->curpm;
357	PL_curcop = c->curcop;
358	PL_top_env = c->top_env;
359
360	if (c->defav) REPLACE_SV (GvAV (PL_defgv), c->defav);
361	if (c->defsv) REPLACE_SV (DEFSV , c->defsv);
362	if (c->errsv) REPLACE_SV (ERRSV , c->errsv);
363		398
364	{	399	{
365	dSP;	400	dSP;
366	CV *cv;	401	CV *cv;
367		402
368	/* now do the ugly restore mess */	403	/* now do the ugly restore mess */
369	while ((cv = (CV *)POPs))	404	while ((cv = (CV *)POPs))
370	{	405	{
371	AV padlist = (AV )POPs;
372
373	if (padlist)
374	{
375	put_padlist (aTHX_ cv); /* mark this padlist as available */	406	put_padlist (aTHX_ cv); /* mark this padlist as available */
376	CvPADLIST(cv) = padlist;	407	CvDEPTH (cv) = PTR2IV (POPs);
377	}	408	CvPADLIST (cv) = (AV *)POPs;
378
379	++CvDEPTH(cv);
380	}	409	}
381		410
382	PUTBACK;	411	PUTBACK;
383	}	412	}
384	}	413	}
385		414
386	static void	415	static void
387	save_state(pTHX_ Coro__State c, int flags)	416	save_perl (pTHX_ Coro__State c)
388	{	417	{
389	{	418	{
390	dSP;	419	dSP;
391	I32 cxix = cxstack_ix;	420	I32 cxix = cxstack_ix;
392	PERL_CONTEXT *ccstk = cxstack;	421	PERL_CONTEXT *ccstk = cxstack;
…		…
395	/*	424	/*
396	* the worst thing you can imagine happens first - we have to save	425	* the worst thing you can imagine happens first - we have to save
397	* (and reinitialize) all cv's in the whole callchain :(	426	* (and reinitialize) all cv's in the whole callchain :(
398	*/	427	*/
399		428
400	PUSHs (Nullsv);	429	XPUSHs (Nullsv);
401	/* this loop was inspired by pp_caller */	430	/* this loop was inspired by pp_caller */
402	for (;;)	431	for (;;)
403	{	432	{
404	while (cxix >= 0)	433	while (cxix >= 0)
405	{	434	{
406	PERL_CONTEXT *cx = &ccstk[cxix--];	435	PERL_CONTEXT *cx = &ccstk[cxix--];
407		436
408	if (CxTYPE(cx) == CXt_SUB)	437	if (CxTYPE (cx) == CXt_SUB \|\| CxTYPE (cx) == CXt_FORMAT)
409	{	438	{
410	CV *cv = cx->blk_sub.cv;	439	CV *cv = cx->blk_sub.cv;
		440
411	if (CvDEPTH(cv))	441	if (CvDEPTH (cv))
412	{	442	{
413	EXTEND (SP, CvDEPTH(cv)*2);	443	EXTEND (SP, 3);
414
415	while (--CvDEPTH(cv))
416	{
417	/* this tells the restore code to increment CvDEPTH */
418	PUSHs (Nullsv);
419	PUSHs ((SV *)cv);
420	}
421
422	PUSHs ((SV *)CvPADLIST(cv));	444	PUSHs ((SV *)CvPADLIST (cv));
		445	PUSHs (INT2PTR (SV *, CvDEPTH (cv)));
423	PUSHs ((SV *)cv);	446	PUSHs ((SV *)cv);
424		447
		448	CvDEPTH (cv) = 0;
425	get_padlist (aTHX_ cv); /* this is a monster */	449	get_padlist (aTHX_ cv);
426	}	450	}
427	}	451	}
428	#ifdef CXt_FORMAT
429	else if (CxTYPE(cx) == CXt_FORMAT)
430	{
431	/* I never used formats, so how should I know how these are implemented? */
432	/* my bold guess is as a simple, plain sub... */
433	croak ("CXt_FORMAT not yet handled. Don't switch coroutines from within formats");
434	}
435	#endif
436	}	452	}
437		453
438	if (top_si->si_type == PERLSI_MAIN)	454	if (top_si->si_type == PERLSI_MAIN)
439	break;	455	break;
440		456
441	top_si = top_si->si_prev;	457	top_si = top_si->si_prev;
442	ccstk = top_si->si_cxstack;	458	ccstk = top_si->si_cxstack;
443	cxix = top_si->si_cxix;	459	cxix = top_si->si_cxix;
444	}	460	}
445		461
446	PUTBACK;	462	PUTBACK;
447	}	463	}
448		464
449	c->defav = flags & TRANSFER_SAVE_DEFAV ? (AV *)SvREFCNT_inc (GvAV (PL_defgv)) : 0;	465	c->defav = GvAV (PL_defgv);
450	c->defsv = flags & TRANSFER_SAVE_DEFSV ? SvREFCNT_inc (DEFSV) : 0;	466	c->defsv = DEFSV;
451	c->errsv = flags & TRANSFER_SAVE_ERRSV ? SvREFCNT_inc (ERRSV) : 0;	467	c->errsv = ERRSV;
		468	c->deffh = PL_defoutgv;
		469	c->irssv = PL_rs;
		470	c->irssv_sv = GvSV (irsgv);
452		471
453	c->dowarn = PL_dowarn;	472	#define VAR(name,type)c->name = PL_ ## name;
454	c->in_eval = PL_in_eval;	473	# include "state.h"
455		474	#undef VAR
456	c->curstackinfo = PL_curstackinfo;
457	c->curstack = PL_curstack;
458	c->mainstack = PL_mainstack;
459	c->stack_sp = PL_stack_sp;
460	c->op = PL_op;
461	c->curpad = PL_curpad;
462	c->comppad = PL_comppad;
463	c->compcv = PL_compcv;
464	c->stack_base = PL_stack_base;
465	c->stack_max = PL_stack_max;
466	c->tmps_stack = PL_tmps_stack;
467	c->tmps_floor = PL_tmps_floor;
468	c->tmps_ix = PL_tmps_ix;
469	c->tmps_max = PL_tmps_max;
470	c->markstack = PL_markstack;
471	c->markstack_ptr = PL_markstack_ptr;
472	c->markstack_max = PL_markstack_max;
473	c->scopestack = PL_scopestack;
474	c->scopestack_ix = PL_scopestack_ix;
475	c->scopestack_max = PL_scopestack_max;
476	c->savestack = PL_savestack;
477	c->savestack_ix = PL_savestack_ix;
478	c->savestack_max = PL_savestack_max;
479	#if PERL_VERSION < 9
480	c->retstack = PL_retstack;
481	c->retstack_ix = PL_retstack_ix;
482	c->retstack_max = PL_retstack_max;
483	#endif
484	c->curpm = PL_curpm;
485	c->curcop = PL_curcop;
486	c->top_env = PL_top_env;
487	}	475	}
488		476
489	/*	477	/*
490	* allocate various perl stacks. This is an exact copy	478	* allocate various perl stacks. This is an exact copy
491	* of perl.c:init_stacks, except that it uses less memory	479	* of perl.c:init_stacks, except that it uses less memory
492	* on the (sometimes correct) assumption that coroutines do	480	* on the (sometimes correct) assumption that coroutines do
493	* not usually need a lot of stackspace.	481	* not usually need a lot of stackspace.
494	*/	482	*/
495	STATIC void	483	#if CORO_PREFER_PERL_FUNCTIONS
		484	# define coro_init_stacks init_stacks
		485	#else
		486	static void
496	coro_init_stacks (pTHX)	487	coro_init_stacks (pTHX)
497	{	488	{
498	LOCK;	489	PL_curstackinfo = new_stackinfo(64, 6);
499
500	PL_curstackinfo = new_stackinfo(96, 1024/sizeof(PERL_CONTEXT) - 1);
501	PL_curstackinfo->si_type = PERLSI_MAIN;	490	PL_curstackinfo->si_type = PERLSI_MAIN;
502	PL_curstack = PL_curstackinfo->si_stack;	491	PL_curstack = PL_curstackinfo->si_stack;
503	PL_mainstack = PL_curstack; /* remember in case we switch stacks */	492	PL_mainstack = PL_curstack; /* remember in case we switch stacks */
504		493
505	PL_stack_base = AvARRAY(PL_curstack);	494	PL_stack_base = AvARRAY(PL_curstack);
506	PL_stack_sp = PL_stack_base;	495	PL_stack_sp = PL_stack_base;
507	PL_stack_max = PL_stack_base + AvMAX(PL_curstack);	496	PL_stack_max = PL_stack_base + AvMAX(PL_curstack);
508		497
509	New(50,PL_tmps_stack,96,SV*);	498	New(50,PL_tmps_stack,64,SV*);
510	PL_tmps_floor = -1;	499	PL_tmps_floor = -1;
511	PL_tmps_ix = -1;	500	PL_tmps_ix = -1;
512	PL_tmps_max = 96;	501	PL_tmps_max = 64;
513		502
514	New(54,PL_markstack,16,I32);	503	New(54,PL_markstack,16,I32);
515	PL_markstack_ptr = PL_markstack;	504	PL_markstack_ptr = PL_markstack;
516	PL_markstack_max = PL_markstack + 16;	505	PL_markstack_max = PL_markstack + 16;
517		506
…		…
521		510
522	New(54,PL_scopestack,16,I32);	511	New(54,PL_scopestack,16,I32);
523	PL_scopestack_ix = 0;	512	PL_scopestack_ix = 0;
524	PL_scopestack_max = 16;	513	PL_scopestack_max = 16;
525		514
526	New(54,PL_savestack,96,ANY);	515	New(54,PL_savestack,64,ANY);
527	PL_savestack_ix = 0;	516	PL_savestack_ix = 0;
528	PL_savestack_max = 96;	517	PL_savestack_max = 64;
529		518
530	#if PERL_VERSION < 9	519	#if !PERL_VERSION_ATLEAST (5,9,0)
531	New(54,PL_retstack,8,OP*);	520	New(54,PL_retstack,4,OP*);
532	PL_retstack_ix = 0;	521	PL_retstack_ix = 0;
533	PL_retstack_max = 8;	522	PL_retstack_max = 4;
534	#endif	523	#endif
535
536	UNLOCK;
537	}	524	}
		525	#endif
538		526
539	/*	527	/*
540	* destroy the stacks, the callchain etc...	528	* destroy the stacks, the callchain etc...
541	*/	529	*/
542	STATIC void	530	static void
543	destroy_stacks(pTHX)	531	coro_destroy_stacks (pTHX)
544	{	532	{
545	if (!IN_DESTRUCT)
546	{
547	/* is this ugly, I ask? */
548	LEAVE_SCOPE (0);
549
550	/* sure it is, but more important: is it correct?? :/ */
551	FREETMPS;
552
553	/POPSTACK_TO (PL_mainstack);//D//use/
554	}
555
556	while (PL_curstackinfo->si_next)	533	while (PL_curstackinfo->si_next)
557	PL_curstackinfo = PL_curstackinfo->si_next;	534	PL_curstackinfo = PL_curstackinfo->si_next;
558		535
559	while (PL_curstackinfo)	536	while (PL_curstackinfo)
560	{	537	{
561	PERL_SI *p = PL_curstackinfo->si_prev;	538	PERL_SI *p = PL_curstackinfo->si_prev;
562		539
563	{ /D//remove/
564	dSP;
565	SWITCHSTACK (PL_curstack, PL_curstackinfo->si_stack);
566	PUTBACK; /* possibly superfluous */
567	}
568
569	if (!IN_DESTRUCT)	540	if (!IN_DESTRUCT)
570	{
571	dounwind (-1);/D//remove/
572	SvREFCNT_dec (PL_curstackinfo->si_stack);	541	SvREFCNT_dec (PL_curstackinfo->si_stack);
573	}
574		542
575	Safefree (PL_curstackinfo->si_cxstack);	543	Safefree (PL_curstackinfo->si_cxstack);
576	Safefree (PL_curstackinfo);	544	Safefree (PL_curstackinfo);
577	PL_curstackinfo = p;	545	PL_curstackinfo = p;
578	}	546	}
579		547
580	Safefree (PL_tmps_stack);	548	Safefree (PL_tmps_stack);
581	Safefree (PL_markstack);	549	Safefree (PL_markstack);
582	Safefree (PL_scopestack);	550	Safefree (PL_scopestack);
583	Safefree (PL_savestack);	551	Safefree (PL_savestack);
584	#if PERL_VERSION < 9	552	#if !PERL_VERSION_ATLEAST (5,9,0)
585	Safefree (PL_retstack);	553	Safefree (PL_retstack);
586	#endif	554	#endif
587	}	555	}
588		556
589	static void	557	static size_t
590	allocate_stack (Coro__State ctx, int alloc)	558	coro_rss (pTHX_ struct coro *coro)
591	{	559	{
592	coro_stack *stack;	560	size_t rss = sizeof (*coro);
593		561
594	New (0, stack, 1, coro_stack);	562	if (coro->mainstack)
595
596	stack->refcnt = 1;
597	stack->usecnt = 1;
598	stack->gencnt = ctx->gencnt = 0;
599
600	if (alloc)
601	{	563	{
602	#if HAVE_MMAP	564	if (coro->flags & CF_RUNNING)
603	stack->ssize = STACKSIZE * sizeof (long); /* mmap should do allocate-on-write for us */
604	stack->sptr = mmap (0, stack->ssize, PROT_EXEC\|PROT_READ\|PROT_WRITE, MAP_PRIVATE\|MAP_ANONYMOUS, 0, 0);
605	if (stack->sptr == (void *)-1)
606	#endif
607	{	565	{
608	/FIXME//D//* reasonable stack size! */	566	#define VAR(name,type)coro->name = PL_ ## name;
609	stack->ssize = - (STACKSIZE * sizeof (long));	567	# include "state.h"
610	New (0, stack->sptr, STACKSIZE, long);	568	#undef VAR
611	}	569	}
612	}
613	else
614	stack->sptr = 0;
615		570
616	ctx->stack = stack;	571	rss += sizeof (coro->curstackinfo);
617	}	572	rss += sizeof (struct xpvav) + (1 + AvFILL (coro->curstackinfo->si_stack)) * sizeof (SV *);
		573	rss += (coro->curstackinfo->si_cxmax + 1) * sizeof (PERL_CONTEXT);
		574	rss += sizeof (struct xpvav) + (1 + AvFILL (coro->curstack)) * sizeof (SV *);
		575	rss += coro->tmps_max * sizeof (SV *);
		576	rss += (coro->markstack_max - coro->markstack_ptr) * sizeof (I32);
		577	rss += coro->scopestack_max * sizeof (I32);
		578	rss += coro->savestack_max * sizeof (ANY);
618		579
619	static void	580	#if !PERL_VERSION_ATLEAST (5,9,0)
620	deallocate_stack (Coro__State ctx)	581	rss += coro->retstack_max * sizeof (OP *);
621	{	582	#endif
622	coro_stack *stack = ctx->stack;
623
624	ctx->stack = 0;
625
626	if (stack)
627	{	583	}
628	if (!--stack->refcnt)
629	{
630	#ifdef HAVE_MMAP
631	if (stack->ssize > 0 && stack->sptr)
632	munmap (stack->sptr, stack->ssize);
633	else
634	#endif
635	Safefree (stack->sptr);
636		584
637	Safefree (stack);	585	return rss;
638	}
639	else if (ctx->gencnt == stack->gencnt)
640	--stack->usecnt;
641	}
642	}	586	}
643		587
		588	/ coroutine stack handling **********************************************/
		589
644	static void	590	static void
645	setup_coro (void *arg)	591	coro_setup (pTHX_ struct coro *coro)
646	{	592	{
647	/*	593	/*
648	* emulate part of the perl startup here.	594	* emulate part of the perl startup here.
649	*/	595	*/
		596	coro_init_stacks (aTHX);
		597
		598	PL_runops = RUNOPS_DEFAULT;
		599	PL_curcop = &PL_compiling;
		600	PL_in_eval = EVAL_NULL;
		601	PL_comppad = 0;
		602	PL_curpm = 0;
		603	PL_localizing = 0;
		604	PL_dirty = 0;
		605	PL_restartop = 0;
		606
		607	GvSV (PL_defgv) = NEWSV (0, 0);
		608	GvAV (PL_defgv) = coro->args; coro->args = 0;
		609	GvSV (PL_errgv) = NEWSV (0, 0);
		610	GvSV (irsgv) = newSVpvn ("\n", 1); sv_magic (GvSV (irsgv), (SV *)irsgv, PERL_MAGIC_sv, "/", 0);
		611	PL_rs = newSVsv (GvSV (irsgv));
		612
		613	{
		614	IO *io = newIO ();
		615	PL_defoutgv = newGVgen ("Coro");
		616	GvIOp(PL_defoutgv) = io;
		617	IoTYPE (io) = IoTYPE_WRONLY;
		618	IoOFP (io) = IoIFP (io) = PerlIO_stdout ();
		619	IoFLAGS (io) \|= IOf_FLUSH;
		620	}
		621
		622	{
		623	dSP;
		624	LOGOP myop;
		625
		626	Zero (&myop, 1, LOGOP);
		627	myop.op_next = Nullop;
		628	myop.op_flags = OPf_WANT_VOID;
		629
		630	PUSHMARK (SP);
		631	XPUSHs (av_shift (GvAV (PL_defgv)));
		632	PUTBACK;
		633	PL_op = (OP *)&myop;
		634	PL_op = PL_ppaddr[OP_ENTERSUB](aTHX);
		635	SPAGAIN;
		636	}
		637
		638	ENTER; /* necessary e.g. for dounwind */
		639	}
		640
		641	static void
		642	coro_destroy (pTHX_ struct coro *coro)
		643	{
		644	if (!IN_DESTRUCT)
		645	{
		646	/* restore all saved variables and stuff */
		647	LEAVE_SCOPE (0);
		648	assert (PL_tmps_floor == -1);
		649
		650	/* free all temporaries */
		651	FREETMPS;
		652	assert (PL_tmps_ix == -1);
		653
		654	/* unwind all extra stacks */
		655	POPSTACK_TO (PL_mainstack);
		656
		657	/* unwind main stack */
		658	dounwind (-1);
		659	}
		660
		661	SvREFCNT_dec (GvSV (PL_defgv));
		662	SvREFCNT_dec (GvAV (PL_defgv));
		663	SvREFCNT_dec (GvSV (PL_errgv));
		664	SvREFCNT_dec (PL_defoutgv);
		665	SvREFCNT_dec (PL_rs);
		666	SvREFCNT_dec (GvSV (irsgv));
		667
		668	SvREFCNT_dec (coro->asp_deffh);
		669	//SvREFCNT_dec (coro->throw);
		670
		671	coro_destroy_stacks (aTHX);
		672	}
		673
		674	static void
		675	free_coro_mortal (pTHX)
		676	{
		677	if (coro_mortal)
		678	{
		679	SvREFCNT_dec (coro_mortal);
		680	coro_mortal = 0;
		681	}
		682	}
		683
		684	static int
		685	runops_trace (pTHX)
		686	{
		687	COP *oldcop = 0;
		688	int oldcxix = -2;
		689	struct coro coro = SvSTATE (coro_current); / trace cctx is tied to specific coro */
		690	coro_cctx *cctx = coro->cctx;
		691
		692	while ((PL_op = CALL_FPTR (PL_op->op_ppaddr) (aTHX)))
		693	{
		694	PERL_ASYNC_CHECK ();
		695
		696	if (cctx->flags & CC_TRACE_ALL)
		697	{
		698	if (PL_op->op_type == OP_LEAVESUB && cctx->flags & CC_TRACE_SUB)
		699	{
		700	PERL_CONTEXT *cx = &cxstack[cxstack_ix];
		701	SV bot, top;
		702	AV av = newAV (); / return values */
		703	SV **cb;
		704	dSP;
		705
		706	GV *gv = CvGV (cx->blk_sub.cv);
		707	SV *fullname = sv_2mortal (newSV (0));
		708	if (isGV (gv))
		709	gv_efullname3 (fullname, gv, 0);
		710
		711	bot = PL_stack_base + cx->blk_oldsp + 1;
		712	top = cx->blk_gimme == G_ARRAY ? SP + 1
		713	: cx->blk_gimme == G_SCALAR ? bot + 1
		714	: bot;
		715
		716	while (bot < top)
		717	av_push (av, SvREFCNT_inc (*bot++));
		718
		719	PL_runops = RUNOPS_DEFAULT;
		720	ENTER;
		721	SAVETMPS;
		722	EXTEND (SP, 3);
		723	PUSHMARK (SP);
		724	PUSHs (&PL_sv_no);
		725	PUSHs (fullname);
		726	PUSHs (sv_2mortal (newRV_noinc ((SV *)av)));
		727	PUTBACK;
		728	cb = hv_fetch ((HV *)SvRV (coro_current), "_trace_sub_cb", sizeof ("_trace_sub_cb") - 1, 0);
		729	if (cb) call_sv (*cb, G_KEEPERR \| G_EVAL \| G_VOID \| G_DISCARD);
		730	SPAGAIN;
		731	FREETMPS;
		732	LEAVE;
		733	PL_runops = runops_trace;
		734	}
		735
		736	if (oldcop != PL_curcop)
		737	{
		738	oldcop = PL_curcop;
		739
		740	if (PL_curcop != &PL_compiling)
		741	{
		742	SV **cb;
		743
		744	if (oldcxix != cxstack_ix && cctx->flags & CC_TRACE_SUB)
		745	{
		746	PERL_CONTEXT *cx = &cxstack[cxstack_ix];
		747
		748	if (CxTYPE (cx) == CXt_SUB && oldcxix < cxstack_ix)
		749	{
		750	runops_proc_t old_runops = PL_runops;
		751	dSP;
		752	GV *gv = CvGV (cx->blk_sub.cv);
		753	SV *fullname = sv_2mortal (newSV (0));
		754
		755	if (isGV (gv))
		756	gv_efullname3 (fullname, gv, 0);
		757
		758	PL_runops = RUNOPS_DEFAULT;
		759	ENTER;
		760	SAVETMPS;
		761	EXTEND (SP, 3);
		762	PUSHMARK (SP);
		763	PUSHs (&PL_sv_yes);
		764	PUSHs (fullname);
		765	PUSHs (cx->blk_sub.hasargs ? sv_2mortal (newRV_inc ((SV *)cx->blk_sub.argarray)) : &PL_sv_undef);
		766	PUTBACK;
		767	cb = hv_fetch ((HV *)SvRV (coro_current), "_trace_sub_cb", sizeof ("_trace_sub_cb") - 1, 0);
		768	if (cb) call_sv (*cb, G_KEEPERR \| G_EVAL \| G_VOID \| G_DISCARD);
		769	SPAGAIN;
		770	FREETMPS;
		771	LEAVE;
		772	PL_runops = runops_trace;
		773	}
		774
		775	oldcxix = cxstack_ix;
		776	}
		777
		778	if (cctx->flags & CC_TRACE_LINE)
		779	{
		780	dSP;
		781
		782	PL_runops = RUNOPS_DEFAULT;
		783	ENTER;
		784	SAVETMPS;
		785	EXTEND (SP, 3);
		786	PL_runops = RUNOPS_DEFAULT;
		787	PUSHMARK (SP);
		788	PUSHs (sv_2mortal (newSVpv (OutCopFILE (oldcop), 0)));
		789	PUSHs (sv_2mortal (newSViv (CopLINE (oldcop))));
		790	PUTBACK;
		791	cb = hv_fetch ((HV *)SvRV (coro_current), "_trace_line_cb", sizeof ("_trace_line_cb") - 1, 0);
		792	if (cb) call_sv (*cb, G_KEEPERR \| G_EVAL \| G_VOID \| G_DISCARD);
		793	SPAGAIN;
		794	FREETMPS;
		795	LEAVE;
		796	PL_runops = runops_trace;
		797	}
		798	}
		799	}
		800	}
		801	}
		802
		803	TAINT_NOT;
		804	return 0;
		805	}
		806
		807	/* inject a fake call to Coro::State::_cctx_init into the execution */
		808	/* _cctx_init should be careful, as it could be called at almost any time */
		809	/* during execution of a perl program */
		810	static void NOINLINE
		811	prepare_cctx (pTHX_ coro_cctx *cctx)
		812	{
		813	dSP;
		814	LOGOP myop;
		815
		816	PL_top_env = &PL_start_env;
		817
		818	if (cctx->flags & CC_TRACE)
		819	PL_runops = runops_trace;
		820
		821	Zero (&myop, 1, LOGOP);
		822	myop.op_next = PL_op;
		823	myop.op_flags = OPf_WANT_VOID \| OPf_STACKED;
		824
		825	PUSHMARK (SP);
		826	EXTEND (SP, 2);
		827	PUSHs (sv_2mortal (newSViv (PTR2IV (cctx))));
		828	PUSHs ((SV *)get_cv ("Coro::State::_cctx_init", FALSE));
		829	PUTBACK;
		830	PL_op = (OP *)&myop;
		831	PL_op = PL_ppaddr[OP_ENTERSUB](aTHX);
		832	SPAGAIN;
		833	}
		834
		835	/*
		836	* this is a _very_ stripped down perl interpreter ;)
		837	*/
		838	static void
		839	coro_run (void *arg)
		840	{
650	dTHX;	841	dTHX;
651	dSP;
652	Coro__State ctx = (Coro__State)arg;
653	SV sub_init = (SV )get_cv (SUB_INIT, FALSE);
654		842
655	coro_init_stacks (aTHX);	843	/* coro_run is the alternative tail of transfer(), so unlock here. */
656	/PL_curcop = 0;/	844	UNLOCK;
657	/PL_in_eval = PL_in_eval;/ /* inherit */
658	SvREFCNT_dec (GvAV (PL_defgv));
659	GvAV (PL_defgv) = ctx->args; ctx->args = 0;
660		845
661	SPAGAIN;	846	/* we now skip the entersub that lead to transfer() */
		847	PL_op = PL_op->op_next;
662		848
663	if (ctx->stack)	849	/* inject a fake subroutine call to cctx_init */
664	{	850	prepare_cctx (aTHX_ (coro_cctx *)arg);
665	ctx->cursp = 0;
666		851
667	PUSHMARK(SP);	852	/* somebody or something will hit me for both perl_run and PL_restartop */
668	PUTBACK;	853	PL_restartop = PL_op;
669	(void) call_sv (sub_init, G_VOID\|G_NOARGS\|G_EVAL);	854	perl_run (PL_curinterp);
670		855
671	if (SvTRUE (ERRSV))	856	/*
672	croak (NULL);	857	* If perl-run returns we assume exit() was being called or the coro
673	else	858	* fell off the end, which seems to be the only valid (non-bug)
674	croak ("FATAL: CCTXT coroutine returned!");	859	* reason for perl_run to return. We try to exit by jumping to the
		860	* bootstrap-time "top" top_env, as we cannot restore the "main"
		861	* coroutine as Coro has no such concept
		862	*/
		863	PL_top_env = main_top_env;
		864	JMPENV_JUMP (2); /* I do not feel well about the hardcoded 2 at all */
		865	}
		866
		867	static coro_cctx *
		868	cctx_new ()
		869	{
		870	coro_cctx *cctx;
		871	void *stack_start;
		872	size_t stack_size;
		873
		874	++cctx_count;
		875
		876	Newz (0, cctx, 1, coro_cctx);
		877
		878	#if HAVE_MMAP
		879
		880	cctx->ssize = ((coro_stacksize * sizeof (long) + PAGESIZE - 1) / PAGESIZE + CORO_STACKGUARD) * PAGESIZE;
		881	/* mmap supposedly does allocate-on-write for us */
		882	cctx->sptr = mmap (0, cctx->ssize, PROT_EXEC\|PROT_READ\|PROT_WRITE, MAP_PRIVATE\|MAP_ANONYMOUS, 0, 0);
		883
		884	if (cctx->sptr != (void *)-1)
		885	{
		886	# if CORO_STACKGUARD
		887	mprotect (cctx->sptr, CORO_STACKGUARD * PAGESIZE, PROT_NONE);
		888	# endif
		889	stack_start = CORO_STACKGUARD * PAGESIZE + (char *)cctx->sptr;
		890	stack_size = cctx->ssize - CORO_STACKGUARD * PAGESIZE;
		891	cctx->flags \|= CC_MAPPED;
675	}	892	}
676	else	893	else
677	{	894	#endif
678	UNOP myop;
679
680	PL_op = (OP *)&myop;
681
682	Zero(&myop, 1, UNOP);
683	myop.op_next = Nullop;
684	myop.op_flags = OPf_WANT_VOID;
685
686	PUSHMARK(SP);
687	XPUSHs (sub_init);
688	/*
689	* the next line is slightly wrong, as PL_op->op_next
690	* is actually being executed so we skip the first op.
691	* that doesn't matter, though, since it is only
692	* pp_nextstate and we never return...
693	* ah yes, and I don't care anyways ;)
694	*/
695	PUTBACK;
696	PL_op = PL_ppaddr[OP_ENTERSUB](aTHX);
697	SPAGAIN;
698
699	ENTER; /* necessary e.g. for dounwind */
700	}	895	{
701	}	896	cctx->ssize = coro_stacksize * (long)sizeof (long);
		897	New (0, cctx->sptr, coro_stacksize, long);
702		898
703	static void	899	if (!cctx->sptr)
704	continue_coro (void *arg)	900	{
705	{	901	perror ("FATAL: unable to allocate stack for coroutine");
706	/*	902	_exit (EXIT_FAILURE);
707	* this is a _very_ stripped down perl interpreter ;)	903	}
708	*/
709	dTHX;
710	Coro__State ctx = (Coro__State)arg;
711	JMPENV coro_start_env;
712		904
713	PL_top_env = &ctx->start_env;	905	stack_start = cctx->sptr;
		906	stack_size = cctx->ssize;
		907	}
714		908
715	ctx->cursp = 0;	909	REGISTER_STACK (cctx, (char )stack_start, (char )stack_start + stack_size);
716	PL_op = PL_op->op_next;	910	coro_create (&cctx->cctx, coro_run, (void *)cctx, stack_start, stack_size);
717	CALLRUNOPS(aTHX);
718		911
719	abort ();	912	return cctx;
720	}	913	}
721		914
722	STATIC void	915	static void
		916	cctx_destroy (coro_cctx *cctx)
		917	{
		918	if (!cctx)
		919	return;
		920
		921	--cctx_count;
		922
		923	#if CORO_USE_VALGRIND
		924	VALGRIND_STACK_DEREGISTER (cctx->valgrind_id);
		925	#endif
		926
		927	#if HAVE_MMAP
		928	if (cctx->flags & CC_MAPPED)
		929	munmap (cctx->sptr, cctx->ssize);
		930	else
		931	#endif
		932	Safefree (cctx->sptr);
		933
		934	Safefree (cctx);
		935	}
		936
		937	static coro_cctx *
		938	cctx_get (pTHX)
		939	{
		940	while (cctx_first)
		941	{
		942	coro_cctx *cctx = cctx_first;
		943	cctx_first = cctx->next;
		944	--cctx_idle;
		945
		946	if (cctx->ssize >= coro_stacksize && !(cctx->flags & CC_NOREUSE))
		947	return cctx;
		948
		949	cctx_destroy (cctx);
		950	}
		951
		952	return cctx_new ();
		953	}
		954
		955	static void
		956	cctx_put (coro_cctx *cctx)
		957	{
		958	/* free another cctx if overlimit */
		959	if (cctx_idle >= MAX_IDLE_CCTX)
		960	{
		961	coro_cctx *first = cctx_first;
		962	cctx_first = first->next;
		963	--cctx_idle;
		964
		965	cctx_destroy (first);
		966	}
		967
		968	++cctx_idle;
		969	cctx->next = cctx_first;
		970	cctx_first = cctx;
		971	}
		972
		973	/ coroutine switching ***************************************************/
		974
		975	static void NOINLINE
		976	transfer_check (pTHX_ struct coro prev, struct coro next)
		977	{
		978	if (prev != next)
		979	{
		980	if (!(prev->flags & (CF_RUNNING \| CF_NEW)))
		981	croak ("Coro::State::transfer called with non-running/new prev Coro::State, but can only transfer from running or new states");
		982
		983	if (next->flags & CF_RUNNING)
		984	croak ("Coro::State::transfer called with running next Coro::State, but can only transfer to inactive states");
		985
		986	if (next->flags & CF_DESTROYED)
		987	croak ("Coro::State::transfer called with destroyed next Coro::State, but can only transfer to inactive states");
		988
		989	if (PL_lex_state != LEX_NOTPARSING)
		990	croak ("Coro::State::transfer called while parsing, but this is not supported");
		991	}
		992	}
		993
		994	/* always use the TRANSFER macro */
		995	static void NOINLINE
723	transfer (pTHX_ struct coro prev, struct coro next, int flags)	996	transfer (pTHX_ struct coro prev, struct coro next)
724	{	997	{
725	dSTACKLEVEL;	998	dSTACKLEVEL;
726		999
		1000	/* sometimes transfer is only called to set idle_sp */
		1001	if (!next)
		1002	{
		1003	((coro_cctx *)prev)->idle_sp = STACKLEVEL;
		1004	assert (((coro_cctx )prev)->idle_te = PL_top_env); / just for the side-effect when asserts are enabled */
		1005	}
727	if (prev != next)	1006	else if (prev != next)
728	{	1007	{
729	if (next->mainstack)	1008	coro_cctx *prev__cctx;
		1009
		1010	if (prev->flags & CF_NEW)
730	{	1011	{
731	LOCK;	1012	/* create a new empty context */
732	SAVE (prev, flags);	1013	Newz (0, prev->cctx, 1, coro_cctx);
733	LOAD (next);	1014	prev->flags &= ~CF_NEW;
734	UNLOCK;	1015	prev->flags \|= CF_RUNNING;
735
736	/* mark this state as in-use */
737	next->mainstack = 0;
738	next->tmps_ix = -2;
739
740	/* stacklevel changed? if yes, grab the stack for us! */
741	if (flags & TRANSFER_SAVE_CCTXT)
742	{
743	if (!prev->stack)
744	allocate_stack (prev, 0);
745	else if (prev->cursp != stacklevel
746	&& prev->stack->usecnt > 1)
747	{
748	prev->gencnt = ++prev->stack->gencnt;
749	prev->stack->usecnt = 1;
750	}
751
752	/* has our stack been invalidated? */
753	if (next->stack && next->stack->gencnt != next->gencnt)
754	{
755	deallocate_stack (next);
756	allocate_stack (next, 1);
757	coro_create (&(next->stack->cctx),
758	continue_coro, (void *)next,
759	next->stack->sptr, labs (next->stack->ssize));
760	}
761
762	coro_transfer (&(prev->stack->cctx), &(next->stack->cctx));
763	prev->cursp = stacklevel;
764	/* don't add any code here */
765	}
766	else
767	next->cursp = stacklevel;
768	}	1016	}
769	else if (next->tmps_ix == -2)	1017
770	croak ("tried to transfer to running coroutine");	1018	prev->flags &= ~CF_RUNNING;
		1019	next->flags \|= CF_RUNNING;
		1020
		1021	LOCK;
		1022
		1023	if (next->flags & CF_NEW)
		1024	{
		1025	/* need to start coroutine */
		1026	next->flags &= ~CF_NEW;
		1027	/* first get rid of the old state */
		1028	save_perl (aTHX_ prev);
		1029	/* setup coroutine call */
		1030	coro_setup (aTHX_ next);
		1031	}
771	else	1032	else
772	{	1033	{
773	LOCK;	1034	/* coroutine already started */
774	SAVE (prev, -1); /* first get rid of the old state */	1035	save_perl (aTHX_ prev);
775	UNLOCK;	1036	load_perl (aTHX_ next);
776
777	if (flags & TRANSFER_SAVE_CCTXT)
778	{
779	if (!prev->stack)
780	allocate_stack (prev, 0);
781
782	if (prev->stack->sptr && flags & TRANSFER_LAZY_STACK)
783	{
784	PL_top_env = &next->start_env;
785
786	setup_coro (next);
787	next->cursp = stacklevel;
788
789	prev->stack->refcnt++;
790	prev->stack->usecnt++;
791	next->stack = prev->stack;
792	next->gencnt = prev->gencnt;
793	}
794	else
795	{
796	assert (!next->stack);
797	allocate_stack (next, 1);
798	coro_create (&(next->stack->cctx),
799	setup_coro, (void *)next,
800	next->stack->sptr, labs (next->stack->ssize));
801	coro_transfer (&(prev->stack->cctx), &(next->stack->cctx));
802	prev->cursp = stacklevel;
803	/* don't add any code here */
804	}
805	}
806	else
807	{
808	setup_coro (next);
809	next->cursp = stacklevel;
810	}
811	}	1037	}
812	}
813		1038
814	LOCK;	1039	prev__cctx = prev->cctx;
815	if (coro_mortal)	1040
816	{	1041	/* possibly "free" the cctx */
817	SvREFCNT_dec (coro_mortal);	1042	if (prev__cctx->idle_sp == STACKLEVEL && !(prev__cctx->flags & CC_TRACE))
818	coro_mortal = 0;	1043	{
819	}	1044	/* I assume that STACKLEVEL is a stronger indicator than PL_top_env changes */
		1045	assert (("ERROR: current top_env must equal previous top_env", PL_top_env == prev__cctx->idle_te));
		1046
		1047	prev->cctx = 0;
		1048
		1049	cctx_put (prev__cctx);
		1050	}
		1051
		1052	++next->usecount;
		1053
		1054	if (!next->cctx)
		1055	next->cctx = cctx_get (aTHX);
		1056
		1057	if (prev__cctx != next->cctx)
		1058	{
		1059	prev__cctx->top_env = PL_top_env;
		1060	PL_top_env = next->cctx->top_env;
		1061	coro_transfer (&prev__cctx->cctx, &next->cctx->cctx);
		1062	}
		1063
		1064	free_coro_mortal (aTHX);
820	UNLOCK;	1065	UNLOCK;
		1066	}
821	}	1067	}
822		1068
823	#define SV_CORO(sv,func) \	1069	struct transfer_args
824	do { \	1070	{
825	if (SvROK (sv)) \	1071	struct coro prev, next;
826	sv = SvRV (sv); \	1072	};
827	\
828	if (SvTYPE (sv) == SVt_PVHV) \
829	{ \
830	HE he = hv_fetch_ent ((HV )sv, ucoro_state_sv, 0, ucoro_state_hash); \
831	\
832	if (!he) \
833	croak ("%s() -- %s is a hashref but lacks the " UCORO_STATE " key", func, # sv); \
834	\
835	(sv) = SvRV (HeVAL(he)); \
836	} \
837	\
838	/* must also be changed inside Coro::Cont::yield */ \
839	if (!SvOBJECT (sv) \|\| SvSTASH (sv) != coro_state_stash) \
840	croak ("%s() -- %s is not (and contains not) a Coro::State object", func, # sv); \
841	\
842	} while(0)
843		1073
844	#define SvSTATE(sv) INT2PTR (struct coro *, SvIV (sv))	1074	#define TRANSFER(ta) transfer (aTHX_ (ta).prev, (ta).next)
		1075	#define TRANSFER_CHECK(ta) transfer_check (aTHX_ (ta).prev, (ta).next)
845		1076
		1077	/ high level stuff ******************************************************/
		1078
846	static void	1079	static int
		1080	coro_state_destroy (pTHX_ struct coro *coro)
		1081	{
		1082	if (coro->flags & CF_DESTROYED)
		1083	return 0;
		1084
		1085	coro->flags \|= CF_DESTROYED;
		1086
		1087	if (coro->flags & CF_READY)
		1088	{
		1089	/* reduce nready, as destroying a ready coro effectively unreadies it */
		1090	/* alternative: look through all ready queues and remove the coro */
		1091	LOCK;
		1092	--coro_nready;
		1093	UNLOCK;
		1094	}
		1095	else
		1096	coro->flags \|= CF_READY; /* make sure it is NOT put into the readyqueue */
		1097
		1098	if (coro->mainstack && coro->mainstack != main_mainstack)
		1099	{
		1100	struct coro temp;
		1101
		1102	if (coro->flags & CF_RUNNING)
		1103	croak ("FATAL: tried to destroy currently running coroutine");
		1104
		1105	save_perl (aTHX_ &temp);
		1106	load_perl (aTHX_ coro);
		1107
		1108	coro_destroy (aTHX_ coro);
		1109
		1110	load_perl (aTHX_ &temp); /* this will get rid of defsv etc.. */
		1111
		1112	coro->mainstack = 0;
		1113	}
		1114
		1115	cctx_destroy (coro->cctx);
		1116	SvREFCNT_dec (coro->args);
		1117
		1118	if (coro->next) coro->next->prev = coro->prev;
		1119	if (coro->prev) coro->prev->next = coro->next;
		1120	if (coro == coro_first) coro_first = coro->next;
		1121
		1122	return 1;
		1123	}
		1124
		1125	static int
		1126	coro_state_free (pTHX_ SV sv, MAGIC mg)
		1127	{
		1128	struct coro coro = (struct coro )mg->mg_ptr;
		1129	mg->mg_ptr = 0;
		1130
		1131	coro->hv = 0;
		1132
		1133	if (--coro->refcnt < 0)
		1134	{
		1135	coro_state_destroy (aTHX_ coro);
		1136	Safefree (coro);
		1137	}
		1138
		1139	return 0;
		1140	}
		1141
		1142	static int
		1143	coro_state_dup (pTHX_ MAGIC mg, CLONE_PARAMS params)
		1144	{
		1145	struct coro coro = (struct coro )mg->mg_ptr;
		1146
		1147	++coro->refcnt;
		1148
		1149	return 0;
		1150	}
		1151
		1152	static MGVTBL coro_state_vtbl = {
		1153	0, 0, 0, 0,
		1154	coro_state_free,
		1155	0,
		1156	#ifdef MGf_DUP
		1157	coro_state_dup,
		1158	#else
		1159	# define MGf_DUP 0
		1160	#endif
		1161	};
		1162
		1163	static void
		1164	prepare_transfer (pTHX_ struct transfer_args ta, SV prev_sv, SV *next_sv)
		1165	{
		1166	ta->prev = SvSTATE (prev_sv);
		1167	ta->next = SvSTATE (next_sv);
		1168	TRANSFER_CHECK (*ta);
		1169	}
		1170
		1171	static void
847	api_transfer(pTHX_ SV prev, SV next, int flags)	1172	api_transfer (SV prev_sv, SV next_sv)
848	{	1173	{
849	SV_CORO (prev, "Coro::transfer");	1174	dTHX;
850	SV_CORO (next, "Coro::transfer");	1175	struct transfer_args ta;
851		1176
852	transfer (aTHX_ SvSTATE (prev), SvSTATE (next), flags);	1177	prepare_transfer (aTHX_ &ta, prev_sv, next_sv);
		1178	TRANSFER (ta);
853	}	1179	}
854		1180
855	/ Coro ******************************************************************/	1181	/ Coro ******************************************************************/
856		1182
857	#define PRIO_MAX 3
858	#define PRIO_HIGH 1
859	#define PRIO_NORMAL 0
860	#define PRIO_LOW -1
861	#define PRIO_IDLE -3
862	#define PRIO_MIN -4
863
864	/* for Coro.pm */
865	static GV coro_current, coro_idle;
866	static AV *coro_ready[PRIO_MAX-PRIO_MIN+1];
867	static int coro_nready;
868
869	static void	1183	static void
870	coro_enq (pTHX_ SV *sv)	1184	coro_enq (pTHX_ SV *coro_sv)
871	{	1185	{
872	SV **xprio;
873	int prio;
874
875	if (SvTYPE (sv) != SVt_PVHV)
876	croak ("Coro::ready tried to enqueue something that is not a coroutine");
877
878	xprio = hv_fetch ((HV *)sv, "prio", 4, 0);
879	prio = xprio ? SvIV (*xprio) : PRIO_NORMAL;
880
881	prio = prio > PRIO_MAX ? PRIO_MAX
882	: prio < PRIO_MIN ? PRIO_MIN
883	: prio;
884
885	av_push (coro_ready [prio - PRIO_MIN], sv);	1186	av_push (coro_ready [SvSTATE (coro_sv)->prio - PRIO_MIN], coro_sv);
886	coro_nready++;
887	}	1187	}
888		1188
889	static SV *	1189	static SV *
890	coro_deq (pTHX_ int min_prio)	1190	coro_deq (pTHX_ int min_prio)
891	{	1191	{
…		…
894	min_prio -= PRIO_MIN;	1194	min_prio -= PRIO_MIN;
895	if (min_prio < 0)	1195	if (min_prio < 0)
896	min_prio = 0;	1196	min_prio = 0;
897		1197
898	for (prio = PRIO_MAX - PRIO_MIN + 1; --prio >= min_prio; )	1198	for (prio = PRIO_MAX - PRIO_MIN + 1; --prio >= min_prio; )
899	if (av_len (coro_ready[prio]) >= 0)	1199	if (AvFILLp (coro_ready [prio]) >= 0)
900	{
901	coro_nready--;
902	return av_shift (coro_ready[prio]);	1200	return av_shift (coro_ready [prio]);
903	}
904		1201
905	return 0;	1202	return 0;
906	}	1203	}
907		1204
908	static void	1205	static int
909	api_ready (SV *coro)	1206	api_ready (SV *coro_sv)
910	{	1207	{
911	dTHX;	1208	dTHX;
		1209	struct coro *coro;
912		1210
913	if (SvROK (coro))	1211	if (SvROK (coro_sv))
914	coro = SvRV (coro);	1212	coro_sv = SvRV (coro_sv);
		1213
		1214	coro = SvSTATE (coro_sv);
		1215
		1216	if (coro->flags & CF_READY)
		1217	return 0;
		1218
		1219	coro->flags \|= CF_READY;
915		1220
916	LOCK;	1221	LOCK;
917	coro_enq (aTHX_ SvREFCNT_inc (coro));	1222	coro_enq (aTHX_ SvREFCNT_inc (coro_sv));
		1223	++coro_nready;
918	UNLOCK;	1224	UNLOCK;
		1225
		1226	return 1;
		1227	}
		1228
		1229	static int
		1230	api_is_ready (SV *coro_sv)
		1231	{
		1232	dTHX;
		1233	return !!(SvSTATE (coro_sv)->flags & CF_READY);
		1234	}
		1235
		1236	static void
		1237	prepare_schedule (pTHX_ struct transfer_args *ta)
		1238	{
		1239	SV prev_sv, next_sv;
		1240
		1241	for (;;)
		1242	{
		1243	LOCK;
		1244	next_sv = coro_deq (aTHX_ PRIO_MIN);
		1245
		1246	/* nothing to schedule: call the idle handler */
		1247	if (!next_sv)
		1248	{
		1249	dSP;
		1250	UNLOCK;
		1251
		1252	ENTER;
		1253	SAVETMPS;
		1254
		1255	PUSHMARK (SP);
		1256	PUTBACK;
		1257	call_sv (get_sv ("Coro::idle", FALSE), G_DISCARD);
		1258
		1259	FREETMPS;
		1260	LEAVE;
		1261	continue;
		1262	}
		1263
		1264	ta->next = SvSTATE (next_sv);
		1265
		1266	/* cannot transfer to destroyed coros, skip and look for next */
		1267	if (ta->next->flags & CF_DESTROYED)
		1268	{
		1269	UNLOCK;
		1270	SvREFCNT_dec (next_sv);
		1271	/* coro_nready is already taken care of by destroy */
		1272	continue;
		1273	}
		1274
		1275	--coro_nready;
		1276	UNLOCK;
		1277	break;
		1278	}
		1279
		1280	/* free this only after the transfer */
		1281	prev_sv = SvRV (coro_current);
		1282	ta->prev = SvSTATE (prev_sv);
		1283	TRANSFER_CHECK (*ta);
		1284	assert (ta->next->flags & CF_READY);
		1285	ta->next->flags &= ~CF_READY;
		1286	SvRV_set (coro_current, next_sv);
		1287
		1288	LOCK;
		1289	free_coro_mortal (aTHX);
		1290	coro_mortal = prev_sv;
		1291	UNLOCK;
		1292	}
		1293
		1294	static void
		1295	prepare_cede (pTHX_ struct transfer_args *ta)
		1296	{
		1297	api_ready (coro_current);
		1298	prepare_schedule (aTHX_ ta);
		1299	}
		1300
		1301	static int
		1302	prepare_cede_notself (pTHX_ struct transfer_args *ta)
		1303	{
		1304	if (coro_nready)
		1305	{
		1306	SV *prev = SvRV (coro_current);
		1307	prepare_schedule (aTHX_ ta);
		1308	api_ready (prev);
		1309	return 1;
		1310	}
		1311	else
		1312	return 0;
919	}	1313	}
920		1314
921	static void	1315	static void
922	api_schedule (void)	1316	api_schedule (void)
923	{	1317	{
924	dTHX;	1318	dTHX;
		1319	struct transfer_args ta;
925		1320
926	SV prev, next;	1321	prepare_schedule (aTHX_ &ta);
927		1322	TRANSFER (ta);
928	LOCK;
929
930	prev = SvRV (GvSV (coro_current));
931	next = coro_deq (aTHX_ PRIO_MIN);
932
933	if (!next)
934	next = SvREFCNT_inc (SvRV (GvSV (coro_idle)));
935
936	/* free this only after the transfer */
937	coro_mortal = prev;
938	SV_CORO (prev, "Coro::schedule");
939
940	SvRV (GvSV (coro_current)) = next;
941
942	SV_CORO (next, "Coro::schedule");
943
944	UNLOCK;
945
946	transfer (aTHX_ SvSTATE (prev), SvSTATE (next),
947	TRANSFER_SAVE_ALL \| TRANSFER_LAZY_STACK);
948	}	1323	}
949		1324
950	static void	1325	static int
951	api_cede (void)	1326	api_cede (void)
952	{	1327	{
953	dTHX;	1328	dTHX;
		1329	struct transfer_args ta;
954		1330
955	LOCK;	1331	prepare_cede (aTHX_ &ta);
956	coro_enq (aTHX_ SvREFCNT_inc (SvRV (GvSV (coro_current))));
957	UNLOCK;
958		1332
959	api_schedule ();	1333	if (ta.prev != ta.next)
		1334	{
		1335	TRANSFER (ta);
		1336	return 1;
		1337	}
		1338	else
		1339	return 0;
960	}	1340	}
961		1341
		1342	static int
		1343	api_cede_notself (void)
		1344	{
		1345	dTHX;
		1346	struct transfer_args ta;
		1347
		1348	if (prepare_cede_notself (aTHX_ &ta))
		1349	{
		1350	TRANSFER (ta);
		1351	return 1;
		1352	}
		1353	else
		1354	return 0;
		1355	}
		1356
		1357	static void
		1358	api_trace (SV *coro_sv, int flags)
		1359	{
		1360	dTHX;
		1361	struct coro *coro = SvSTATE (coro_sv);
		1362
		1363	if (flags & CC_TRACE)
		1364	{
		1365	if (!coro->cctx)
		1366	coro->cctx = cctx_new ();
		1367	else if (!(coro->cctx->flags & CC_TRACE))
		1368	croak ("cannot enable tracing on coroutine with custom stack");
		1369
		1370	coro->cctx->flags \|= CC_NOREUSE \| (flags & (CC_TRACE \| CC_TRACE_ALL));
		1371	}
		1372	else if (coro->cctx && coro->cctx->flags & CC_TRACE)
		1373	{
		1374	coro->cctx->flags &= ~(CC_TRACE \| CC_TRACE_ALL);
		1375
		1376	if (coro->flags & CF_RUNNING)
		1377	PL_runops = RUNOPS_DEFAULT;
		1378	else
		1379	coro->runops = RUNOPS_DEFAULT;
		1380	}
		1381	}
		1382
962	MODULE = Coro::State PACKAGE = Coro::State	1383	MODULE = Coro::State PACKAGE = Coro::State PREFIX = api_
963		1384
964	PROTOTYPES: ENABLE	1385	PROTOTYPES: DISABLE
965		1386
966	BOOT:	1387	BOOT:
967	{ /* {} necessary for stoopid perl-5.6.x */	1388	{
968	#ifdef USE_ITHREADS	1389	#ifdef USE_ITHREADS
969	MUTEX_INIT (&coro_mutex);	1390	MUTEX_INIT (&coro_mutex);
970	#endif	1391	#endif
		1392	BOOT_PAGESIZE;
971		1393
972	ucoro_state_sv = newSVpv (UCORO_STATE, sizeof(UCORO_STATE) - 1);	1394	irsgv = gv_fetchpv ("/", 1, SVt_PV);
973	PERL_HASH(ucoro_state_hash, UCORO_STATE, sizeof(UCORO_STATE) - 1);	1395
974	coro_state_stash = gv_stashpv ("Coro::State", TRUE);	1396	coro_state_stash = gv_stashpv ("Coro::State", TRUE);
975		1397
976	newCONSTSUB (coro_state_stash, "SAVE_DEFAV", newSViv (TRANSFER_SAVE_DEFAV));	1398	newCONSTSUB (coro_state_stash, "CC_TRACE" , newSViv (CC_TRACE));
977	newCONSTSUB (coro_state_stash, "SAVE_DEFSV", newSViv (TRANSFER_SAVE_DEFSV));	1399	newCONSTSUB (coro_state_stash, "CC_TRACE_SUB" , newSViv (CC_TRACE_SUB));
978	newCONSTSUB (coro_state_stash, "SAVE_ERRSV", newSViv (TRANSFER_SAVE_ERRSV));	1400	newCONSTSUB (coro_state_stash, "CC_TRACE_LINE", newSViv (CC_TRACE_LINE));
979	newCONSTSUB (coro_state_stash, "SAVE_CCTXT", newSViv (TRANSFER_SAVE_CCTXT));	1401	newCONSTSUB (coro_state_stash, "CC_TRACE_ALL" , newSViv (CC_TRACE_ALL));
980		1402
981	main_mainstack = PL_mainstack;	1403	main_mainstack = PL_mainstack;
		1404	main_top_env = PL_top_env;
		1405
		1406	while (main_top_env->je_prev)
		1407	main_top_env = main_top_env->je_prev;
982		1408
983	coroapi.ver = CORO_API_VERSION;	1409	coroapi.ver = CORO_API_VERSION;
984	coroapi.transfer = api_transfer;	1410	coroapi.transfer = api_transfer;
985	}
986		1411
987	Coro::State	1412	assert (("PRIO_NORMAL must be 0", !PRIO_NORMAL));
988	_newprocess(args)	1413	}
989	SV * args	1414
990	PROTOTYPE: $	1415	SV *
		1416	new (char *klass, ...)
991	CODE:	1417	CODE:
992	Coro__State coro;	1418	{
		1419	struct coro *coro;
		1420	HV *hv;
		1421	int i;
993		1422
994	if (!SvROK (args) \|\| SvTYPE (SvRV (args)) != SVt_PVAV)
995	croak ("Coro::State::_newprocess expects an arrayref");
996
997	Newz (0, coro, 1, struct coro);	1423	Newz (0, coro, 1, struct coro);
		1424	coro->args = newAV ();
		1425	coro->flags = CF_NEW;
998		1426
999	coro->args = (AV *)SvREFCNT_inc (SvRV (args));	1427	if (coro_first) coro_first->prev = coro;
1000	/coro->mainstack = 0; //actual work is done inside transfer /	1428	coro->next = coro_first;
1001	/coro->stack = 0;/	1429	coro_first = coro;
1002		1430
1003	/* same as JMPENV_BOOTSTRAP */	1431	coro->hv = hv = newHV ();
1004	/* we might be able to recycle start_env, but safe is safe */	1432	sv_magicext ((SV )hv, 0, PERL_MAGIC_ext, &coro_state_vtbl, (char )coro, 0)->mg_flags \|= MGf_DUP;
1005	/Zero(&coro->start_env, 1, JMPENV);/	1433	RETVAL = sv_bless (newRV_noinc ((SV *)hv), gv_stashpv (klass, 1));
1006	coro->start_env.je_ret = -1;
1007	coro->start_env.je_mustcatch = TRUE;
1008		1434
1009	RETVAL = coro;	1435	for (i = 1; i < items; i++)
		1436	av_push (coro->args, newSVsv (ST (i)));
		1437	}
1010	OUTPUT:	1438	OUTPUT:
1011	RETVAL	1439	RETVAL
1012		1440
		1441	# these not obviously related functions are all rolled into the same xs
		1442	# function to increase chances that they all will call transfer with the same
		1443	# stack offset
1013	void	1444	void
1014	transfer(prev, next, flags)	1445	_set_stacklevel (...)
1015	SV *prev	1446	ALIAS:
1016	SV *next	1447	Coro::State::transfer = 1
1017	int flags	1448	Coro::schedule = 2
1018	PROTOTYPE: @	1449	Coro::cede = 3
		1450	Coro::cede_notself = 4
1019	CODE:	1451	CODE:
1020	PUTBACK;	1452	{
1021	SV_CORO (next, "Coro::transfer");	1453	struct transfer_args ta;
1022	SV_CORO (prev, "Coro::transfer");	1454
1023	transfer (aTHX_ SvSTATE (prev), SvSTATE (next), flags);	1455	switch (ix)
1024	SPAGAIN;	1456	{
		1457	case 0:
		1458	ta.prev = (struct coro )INT2PTR (coro_cctx , SvIV (ST (0)));
		1459	ta.next = 0;
		1460	break;
		1461
		1462	case 1:
		1463	if (items != 2)
		1464	croak ("Coro::State::transfer (prev,next) expects two arguments, not %d", items);
		1465
		1466	prepare_transfer (aTHX_ &ta, ST (0), ST (1));
		1467	break;
		1468
		1469	case 2:
		1470	prepare_schedule (aTHX_ &ta);
		1471	break;
		1472
		1473	case 3:
		1474	prepare_cede (aTHX_ &ta);
		1475	break;
		1476
		1477	case 4:
		1478	if (!prepare_cede_notself (aTHX_ &ta))
		1479	XSRETURN_EMPTY;
		1480
		1481	break;
		1482	}
		1483
		1484	BARRIER;
		1485	TRANSFER (ta);
		1486
		1487	if (GIMME_V != G_VOID && ta.next != ta.prev)
		1488	XSRETURN_YES;
		1489	}
		1490
		1491	bool
		1492	_destroy (SV *coro_sv)
		1493	CODE:
		1494	RETVAL = coro_state_destroy (aTHX_ SvSTATE (coro_sv));
		1495	OUTPUT:
		1496	RETVAL
1025		1497
1026	void	1498	void
1027	DESTROY(coro)
1028	Coro::State coro
1029	CODE:
1030
1031	if (coro->mainstack && coro->mainstack != main_mainstack)
1032	{
1033	struct coro temp;
1034
1035	PUTBACK;
1036	SAVE (aTHX_ (&temp), TRANSFER_SAVE_ALL);
1037	LOAD (aTHX_ coro);
1038	SPAGAIN;
1039
1040	destroy_stacks (aTHX);
1041
1042	LOAD ((&temp)); /* this will get rid of defsv etc.. */
1043	SPAGAIN;
1044
1045	coro->mainstack = 0;
1046	}
1047
1048	deallocate_stack (coro);
1049	SvREFCNT_dec (coro->args);
1050	Safefree (coro);
1051
1052	void
1053	_exit(code)	1499	_exit (code)
1054	int code	1500	int code
1055	PROTOTYPE: $	1501	PROTOTYPE: $
1056	CODE:	1502	CODE:
1057	_exit (code);	1503	_exit (code);
1058		1504
1059	MODULE = Coro::State PACKAGE = Coro::Cont	1505	int
		1506	cctx_stacksize (int new_stacksize = 0)
		1507	CODE:
		1508	RETVAL = coro_stacksize;
		1509	if (new_stacksize)
		1510	coro_stacksize = new_stacksize;
		1511	OUTPUT:
		1512	RETVAL
1060		1513
1061	# this is slightly dirty (should expose a c-level api)	1514	int
		1515	cctx_count ()
		1516	CODE:
		1517	RETVAL = cctx_count;
		1518	OUTPUT:
		1519	RETVAL
		1520
		1521	int
		1522	cctx_idle ()
		1523	CODE:
		1524	RETVAL = cctx_idle;
		1525	OUTPUT:
		1526	RETVAL
1062		1527
1063	void	1528	void
1064	yield(...)	1529	list ()
1065	PROTOTYPE: @	1530	PPCODE:
		1531	{
		1532	struct coro *coro;
		1533	for (coro = coro_first; coro; coro = coro->next)
		1534	if (coro->hv)
		1535	XPUSHs (sv_2mortal (newRV_inc ((SV *)coro->hv)));
		1536	}
		1537
		1538	void
		1539	call (Coro::State coro, SV *coderef)
		1540	ALIAS:
		1541	eval = 1
		1542	CODE:
		1543	{
		1544	if (coro->mainstack)
		1545	{
		1546	struct coro temp;
		1547	Zero (&temp, 1, struct coro);
		1548
		1549	if (!(coro->flags & CF_RUNNING))
		1550	{
		1551	save_perl (aTHX_ &temp);
		1552	load_perl (aTHX_ coro);
		1553	}
		1554
		1555	{
		1556	dSP;
		1557	ENTER;
		1558	SAVETMPS;
		1559	PUSHMARK (SP);
		1560	PUTBACK;
		1561	if (ix)
		1562	eval_sv (coderef, 0);
		1563	else
		1564	call_sv (coderef, G_KEEPERR \| G_EVAL \| G_VOID \| G_DISCARD);
		1565	SPAGAIN;
		1566	FREETMPS;
		1567	LEAVE;
		1568	PUTBACK;
		1569	}
		1570
		1571	if (!(coro->flags & CF_RUNNING))
		1572	{
		1573	save_perl (aTHX_ coro);
		1574	load_perl (aTHX_ &temp);
		1575	}
		1576	}
		1577	}
		1578
		1579	SV *
		1580	is_ready (Coro::State coro)
		1581	PROTOTYPE: $
		1582	ALIAS:
		1583	is_ready = CF_READY
		1584	is_running = CF_RUNNING
		1585	is_new = CF_NEW
		1586	is_destroyed = CF_DESTROYED
		1587	CODE:
		1588	RETVAL = boolSV (coro->flags & ix);
		1589	OUTPUT:
		1590	RETVAL
		1591
		1592	void
		1593	api_trace (SV *coro, int flags = CC_TRACE \| CC_TRACE_SUB)
		1594
		1595	SV *
		1596	has_stack (Coro::State coro)
		1597	PROTOTYPE: $
		1598	CODE:
		1599	RETVAL = boolSV (!!coro->cctx);
		1600	OUTPUT:
		1601	RETVAL
		1602
		1603	int
		1604	is_traced (Coro::State coro)
		1605	PROTOTYPE: $
		1606	CODE:
		1607	RETVAL = (coro->cctx ? coro->cctx->flags : 0) & CC_TRACE_ALL;
		1608	OUTPUT:
		1609	RETVAL
		1610
		1611	IV
		1612	rss (Coro::State coro)
		1613	PROTOTYPE: $
		1614	ALIAS:
		1615	usecount = 1
1066	CODE:	1616	CODE:
1067	SV *yieldstack;	1617	switch (ix)
1068	SV *sv;	1618	{
1069	AV *defav = GvAV (PL_defgv);	1619	case 0: RETVAL = coro_rss (aTHX_ coro); break;
1070	struct coro prev, next;	1620	case 1: RETVAL = coro->usecount; break;
1071
1072	yieldstack = *hv_fetch (
1073	(HV *)SvRV (GvSV (coro_current)),
1074	"yieldstack", sizeof ("yieldstack") - 1,
1075	0	1621	}
1076	);	1622	OUTPUT:
		1623	RETVAL
1077		1624
1078	/* set up @_ -- ugly */
1079	av_clear (defav);
1080	av_fill (defav, items - 1);
1081	while (items--)
1082	av_store (defav, items, SvREFCNT_inc (ST(items)));
1083
1084	sv = av_pop ((AV *)SvRV (yieldstack));
1085	prev = INT2PTR (struct coro , SvIV ((SV)SvRV (av_fetch ((AV )SvRV (sv), 0, 0))));
1086	next = INT2PTR (struct coro , SvIV ((SV)SvRV (av_fetch ((AV )SvRV (sv), 1, 0))));
1087	SvREFCNT_dec (sv);
1088
1089	transfer (aTHX_ prev, next, 0);
1090		1625
1091	MODULE = Coro::State PACKAGE = Coro	1626	MODULE = Coro::State PACKAGE = Coro
1092		1627
1093	# this is slightly dirty (should expose a c-level api)
1094
1095	BOOT:	1628	BOOT:
1096	{	1629	{
1097	int i;	1630	int i;
		1631
		1632	sv_pool_rss = get_sv ("Coro::POOL_RSS" , TRUE);
		1633	sv_pool_size = get_sv ("Coro::POOL_SIZE" , TRUE);
		1634	av_async_pool = get_av ("Coro::async_pool", TRUE);
		1635
		1636	coro_current = get_sv ("Coro::current", FALSE);
		1637	SvREADONLY_on (coro_current);
		1638
1098	HV *stash = gv_stashpv ("Coro", TRUE);	1639	coro_stash = gv_stashpv ("Coro", TRUE);
1099		1640
1100	newCONSTSUB (stash, "PRIO_MAX", newSViv (PRIO_MAX));	1641	newCONSTSUB (coro_stash, "PRIO_MAX", newSViv (PRIO_MAX));
1101	newCONSTSUB (stash, "PRIO_HIGH", newSViv (PRIO_HIGH));	1642	newCONSTSUB (coro_stash, "PRIO_HIGH", newSViv (PRIO_HIGH));
1102	newCONSTSUB (stash, "PRIO_NORMAL", newSViv (PRIO_NORMAL));	1643	newCONSTSUB (coro_stash, "PRIO_NORMAL", newSViv (PRIO_NORMAL));
1103	newCONSTSUB (stash, "PRIO_LOW", newSViv (PRIO_LOW));	1644	newCONSTSUB (coro_stash, "PRIO_LOW", newSViv (PRIO_LOW));
1104	newCONSTSUB (stash, "PRIO_IDLE", newSViv (PRIO_IDLE));	1645	newCONSTSUB (coro_stash, "PRIO_IDLE", newSViv (PRIO_IDLE));
1105	newCONSTSUB (stash, "PRIO_MIN", newSViv (PRIO_MIN));	1646	newCONSTSUB (coro_stash, "PRIO_MIN", newSViv (PRIO_MIN));
1106
1107	coro_current = gv_fetchpv ("Coro::current", TRUE, SVt_PV);
1108	coro_idle = gv_fetchpv ("Coro::idle" , TRUE, SVt_PV);
1109		1647
1110	for (i = PRIO_MAX - PRIO_MIN + 1; i--; )	1648	for (i = PRIO_MAX - PRIO_MIN + 1; i--; )
1111	coro_ready[i] = newAV ();	1649	coro_ready[i] = newAV ();
1112		1650
1113	{	1651	{
1114	SV *sv = perl_get_sv("Coro::API", 1);	1652	SV *sv = perl_get_sv("Coro::API", 1);
1115		1653
1116	coroapi.schedule = api_schedule;	1654	coroapi.schedule = api_schedule;
1117	coroapi.cede = api_cede;	1655	coroapi.cede = api_cede;
		1656	coroapi.cede_notself = api_cede_notself;
1118	coroapi.ready = api_ready;	1657	coroapi.ready = api_ready;
		1658	coroapi.is_ready = api_is_ready;
1119	coroapi.nready = &coro_nready;	1659	coroapi.nready = &coro_nready;
1120	coroapi.current = coro_current;	1660	coroapi.current = coro_current;
1121		1661
1122	GCoroAPI = &coroapi;	1662	GCoroAPI = &coroapi;
1123	sv_setiv(sv, (IV)&coroapi);	1663	sv_setiv (sv, (IV)&coroapi);
1124	SvREADONLY_on(sv);	1664	SvREADONLY_on (sv);
1125	}	1665	}
1126	}	1666	}
1127		1667
1128	#if !PERL_MICRO
1129
1130	void	1668	void
1131	ready(self)	1669	_set_current (SV *current)
1132	SV * self
1133	PROTOTYPE: $	1670	PROTOTYPE: $
1134	CODE:	1671	CODE:
1135	api_ready (self);	1672	SvREFCNT_dec (SvRV (coro_current));
1136		1673	SvRV_set (coro_current, SvREFCNT_inc (SvRV (current)));
1137	#endif
1138		1674
1139	int	1675	int
		1676	prio (Coro::State coro, int newprio = 0)
		1677	ALIAS:
		1678	nice = 1
		1679	CODE:
		1680	{
		1681	RETVAL = coro->prio;
		1682
		1683	if (items > 1)
		1684	{
		1685	if (ix)
		1686	newprio = coro->prio - newprio;
		1687
		1688	if (newprio < PRIO_MIN) newprio = PRIO_MIN;
		1689	if (newprio > PRIO_MAX) newprio = PRIO_MAX;
		1690
		1691	coro->prio = newprio;
		1692	}
		1693	}
		1694	OUTPUT:
		1695	RETVAL
		1696
		1697	SV *
		1698	ready (SV *self)
		1699	PROTOTYPE: $
		1700	CODE:
		1701	RETVAL = boolSV (api_ready (self));
		1702	OUTPUT:
		1703	RETVAL
		1704
		1705	int
1140	nready(...)	1706	nready (...)
1141	PROTOTYPE:	1707	PROTOTYPE:
1142	CODE:	1708	CODE:
1143	RETVAL = coro_nready;	1709	RETVAL = coro_nready;
1144	OUTPUT:	1710	OUTPUT:
1145	RETVAL	1711	RETVAL
1146		1712
		1713	# for async_pool speedup
1147	void	1714	void
1148	schedule(...)	1715	_pool_1 (SV *cb)
1149	PROTOTYPE:
1150	CODE:	1716	CODE:
1151	api_schedule ();	1717	{
		1718	struct coro *coro = SvSTATE (coro_current);
		1719	HV hv = (HV )SvRV (coro_current);
		1720	AV *defav = GvAV (PL_defgv);
		1721	SV *invoke = hv_delete (hv, "_invoke", sizeof ("_invoke") - 1, 0);
		1722	AV *invoke_av;
		1723	int i, len;
		1724
		1725	if (!invoke)
		1726	croak ("\3terminate\2\n");
		1727
		1728	SvREFCNT_dec (coro->asp_deffh);
		1729	coro->asp_deffh = SvREFCNT_inc (PL_defoutgv);
		1730
		1731	hv_store (hv, "desc", sizeof ("desc") - 1,
		1732	newSVpvn ("[async_pool]", sizeof ("[async_pool]") - 1), 0);
		1733
		1734	invoke_av = (AV *)SvRV (invoke);
		1735	len = av_len (invoke_av);
		1736
		1737	sv_setsv (cb, AvARRAY (invoke_av)[0]);
		1738
		1739	if (len > 0)
		1740	{
		1741	av_fill (defav, len - 1);
		1742	for (i = 0; i < len; ++i)
		1743	av_store (defav, i, SvREFCNT_inc (AvARRAY (invoke_av)[i + 1]));
		1744	}
		1745
		1746	SvREFCNT_dec (invoke);
		1747	}
1152		1748
1153	void	1749	void
1154	cede(...)	1750	_pool_2 (SV *cb)
1155	PROTOTYPE:
1156	CODE:	1751	CODE:
1157	api_cede ();	1752	{
		1753	struct coro *coro = SvSTATE (coro_current);
1158		1754
1159	# and these are hacks	1755	sv_setsv (cb, &PL_sv_undef);
		1756
		1757	SvREFCNT_dec (PL_defoutgv); PL_defoutgv = coro->asp_deffh;
		1758	coro->asp_deffh = 0;
		1759
		1760	if (coro_rss (aTHX_ coro) > SvIV (sv_pool_rss)
		1761	\|\| av_len (av_async_pool) + 1 >= SvIV (sv_pool_size))
		1762	croak ("\3terminate\2\n");
		1763
		1764	av_clear (GvAV (PL_defgv));
		1765	hv_store ((HV *)SvRV (coro_current), "desc", sizeof ("desc") - 1,
		1766	newSVpvn ("[async_pool idle]", sizeof ("[async_pool idle]") - 1), 0);
		1767
		1768	coro->prio = 0;
		1769
		1770	if (coro->cctx && (coro->cctx->flags & CC_TRACE))
		1771	api_trace (coro_current, 0);
		1772
		1773	av_push (av_async_pool, newSVsv (coro_current));
		1774	}
		1775
		1776
		1777	MODULE = Coro::State PACKAGE = Coro::AIO
		1778
1160	SV *	1779	SV *
1161	_aio_get_state ()	1780	_get_state ()
1162	CODE:	1781	CODE:
1163	{	1782	{
1164	struct {	1783	struct io_state *data;
1165	int errorno;
1166	int laststype;
1167	int laststatval;
1168	Stat_t statcache;
1169	} data;
1170		1784
		1785	RETVAL = newSV (sizeof (struct io_state));
		1786	data = (struct io_state *)SvPVX (RETVAL);
		1787	SvCUR_set (RETVAL, sizeof (struct io_state));
		1788	SvPOK_only (RETVAL);
		1789
1171	data.errorno = errno;	1790	data->errorno = errno;
1172	data.laststype = PL_laststype;	1791	data->laststype = PL_laststype;
1173	data.laststatval = PL_laststatval;	1792	data->laststatval = PL_laststatval;
1174	data.statcache = PL_statcache;	1793	data->statcache = PL_statcache;
1175
1176	RETVAL = newSVpvn ((char *)&data, sizeof data);
1177	}	1794	}
1178	OUTPUT:	1795	OUTPUT:
1179	RETVAL	1796	RETVAL
1180		1797
1181	void	1798	void
1182	_aio_set_state (char *data_)	1799	_set_state (char *data_)
1183	PROTOTYPE: $	1800	PROTOTYPE: $
1184	CODE:	1801	CODE:
1185	{	1802	{
1186	struct {	1803	struct io_state data = (void )data_;
1187	int errorno;
1188	int laststype;
1189	int laststatval;
1190	Stat_t statcache;
1191	} data = (void )data_;
1192		1804
1193	errno = data->errorno;	1805	errno = data->errorno;
1194	PL_laststype = data->laststype;	1806	PL_laststype = data->laststype;
1195	PL_laststatval = data->laststatval;	1807	PL_laststatval = data->laststatval;
1196	PL_statcache = data->statcache;	1808	PL_statcache = data->statcache;
1197	}	1809	}
		1810

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing Coro/Coro/State.xs (file contents): Revision 1.75 by root, Thu Oct 26 06:50:20 2006 UTC vs. Revision 1.183 by root, Wed Oct 3 19:19:06 2007 UTC

Diff Legend

Comparing Coro/Coro/State.xs (file contents):
Revision 1.75 by root, Thu Oct 26 06:50:20 2006 UTC vs.
Revision 1.183 by root, Wed Oct 3 19:19:06 2007 UTC