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

Comparing Coro/Coro/State.xs (file contents):
Revision 1.108 by root, Mon Nov 27 18:15:47 2006 UTC vs.
Revision 1.201 by root, Mon Oct 8 01:23:14 2007 UTC

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

Diff Legend

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

Comparing Coro/Coro/State.xs (file contents): Revision 1.108 by root, Mon Nov 27 18:15:47 2006 UTC vs. Revision 1.201 by root, Mon Oct 8 01:23:14 2007 UTC

Diff Legend

Comparing Coro/Coro/State.xs (file contents):
Revision 1.108 by root, Mon Nov 27 18:15:47 2006 UTC vs.
Revision 1.201 by root, Mon Oct 8 01:23:14 2007 UTC