ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/Coro/Coro/State.xs

Comparing Coro/Coro/State.xs (file contents):
Revision 1.261 by root, Mon Nov 10 05:09:30 2008 UTC vs.
Revision 1.292 by root, Tue Nov 18 06:09:35 2008 UTC

…		…
46	# define BOOT_PAGESIZE (void)0	46	# define BOOT_PAGESIZE (void)0
47	#endif	47	#endif
48		48
49	#if CORO_USE_VALGRIND	49	#if CORO_USE_VALGRIND
50	# include <valgrind/valgrind.h>	50	# include <valgrind/valgrind.h>
51	# define REGISTER_STACK(cctx,start,end) (cctx)->valgrind_id = VALGRIND_STACK_REGISTER ((start), (end))
52	#else
53	# define REGISTER_STACK(cctx,start,end)
54	#endif	51	#endif
55		52
56	/* the maximum number of idle cctx that will be pooled */	53	/* the maximum number of idle cctx that will be pooled */
57	static int cctx_max_idle = 4;	54	static int cctx_max_idle = 4;
58		55
…		…
98	# define GV_NOTQUAL 0	95	# define GV_NOTQUAL 0
99	#endif	96	#endif
100	#ifndef newSV	97	#ifndef newSV
101	# define newSV(l) NEWSV(0,l)	98	# define newSV(l) NEWSV(0,l)
102	#endif	99	#endif
		100	#ifndef CvISXSUB_on
		101	# define CvISXSUB_on(cv) (void)cv
		102	#endif
103		103
104	/* 5.8.7 */	104	/* 5.8.7 */
105	#ifndef SvRV_set	105	#ifndef SvRV_set
106	# define SvRV_set(s,v) SvRV(s) = (v)	106	# define SvRV_set(s,v) SvRV(s) = (v)
107	#endif	107	#endif
…		…
119	# define CORO_PREFER_PERL_FUNCTIONS 0	119	# define CORO_PREFER_PERL_FUNCTIONS 0
120	#endif	120	#endif
121		121
122	/* The next macros try to return the current stack pointer, in an as	122	/* The next macros try to return the current stack pointer, in an as
123	* portable way as possible. */	123	* portable way as possible. */
124	#define dSTACKLEVEL volatile char stacklevel	124	#if __GNUC__ >= 4
125	#define STACKLEVEL ((void *)&stacklevel)	125	# define dSTACKLEVEL void *stacklevel = __builtin_frame_address (0)
		126	#else
		127	# define dSTACKLEVEL volatile void *stacklevel = (volatile void *)&stacklevel
		128	#endif
126		129
127	#define IN_DESTRUCT (PL_main_cv == Nullcv)	130	#define IN_DESTRUCT (PL_main_cv == Nullcv)
128		131
129	#if __GNUC__ >= 3	132	#if __GNUC__ >= 3
130	# define attribute(x) __attribute__(x)	133	# define attribute(x) __attribute__(x)
131	# define BARRIER __asm__ __volatile__ ("" : : : "memory")
132	# define expect(expr,value) __builtin_expect ((expr),(value))	134	# define expect(expr,value) __builtin_expect ((expr),(value))
		135	# define INLINE static inline
133	#else	136	#else
134	# define attribute(x)	137	# define attribute(x)
135	# define BARRIER
136	# define expect(expr,value) (expr)	138	# define expect(expr,value) (expr)
		139	# define INLINE static
137	#endif	140	#endif
138		141
139	#define expect_false(expr) expect ((expr) != 0, 0)	142	#define expect_false(expr) expect ((expr) != 0, 0)
140	#define expect_true(expr) expect ((expr) != 0, 1)	143	#define expect_true(expr) expect ((expr) != 0, 1)
141		144
142	#define NOINLINE attribute ((noinline))	145	#define NOINLINE attribute ((noinline))
143		146
144	#include "CoroAPI.h"	147	#include "CoroAPI.h"
145		148
146	#ifdef USE_ITHREADS	149	#ifdef USE_ITHREADS
147
148	static perl_mutex coro_lock;
149	# define LOCK do { MUTEX_LOCK (&coro_lock); } while (0)
150	# define UNLOCK do { MUTEX_UNLOCK (&coro_lock); } while (0)
151	# if CORO_PTHREAD	150	# if CORO_PTHREAD
152	static void *coro_thx;	151	static void *coro_thx;
153	# endif	152	# endif
154
155	#else
156
157	# define LOCK (void)0
158	# define UNLOCK (void)0
159
160	#endif	153	#endif
161
162	# undef LOCK
163	# define LOCK (void)0
164	# undef UNLOCK
165	# define UNLOCK (void)0
166
167	/* helper storage struct for Coro::AIO */
168	struct io_state
169	{
170	AV *res;
171	int errorno;
172	I32 laststype; /* U16 in 5.10.0 */
173	int laststatval;
174	Stat_t statcache;
175	};
176		154
177	static double (*nvtime)(); /* so why doesn't it take void? */	155	static double (*nvtime)(); /* so why doesn't it take void? */
		156
		157	/* we hijack an hopefully unused CV flag for our purposes */
		158	#define CVf_SLF 0x4000
		159	static OP *pp_slf (pTHX);
178		160
179	static U32 cctx_gen;	161	static U32 cctx_gen;
180	static size_t cctx_stacksize = CORO_STACKSIZE;	162	static size_t cctx_stacksize = CORO_STACKSIZE;
181	static struct CoroAPI coroapi;	163	static struct CoroAPI coroapi;
182	static AV *main_mainstack; /* used to differentiate between $main and others */	164	static AV *main_mainstack; /* used to differentiate between $main and others */
183	static JMPENV *main_top_env;	165	static JMPENV *main_top_env;
184	static HV *coro_state_stash, *coro_stash;	166	static HV *coro_state_stash, *coro_stash;
185	static volatile SV *coro_mortal; /* will be freed/thrown after next transfer */	167	static volatile SV *coro_mortal; /* will be freed/thrown after next transfer */
186	static volatile struct coro *transfer_next;
187
188	struct transfer_args
189	{
190	struct coro *prev, *next;
191	};
192		168
193	static GV *irsgv; /* $/ */	169	static GV *irsgv; /* $/ */
194	static GV *stdoutgv; /* *STDOUT */	170	static GV *stdoutgv; /* *STDOUT */
195	static SV *rv_diehook;	171	static SV *rv_diehook;
196	static SV *rv_warnhook;	172	static SV *rv_warnhook;
…		…
215	CC_TRACE_LINE = 0x10, /* trace each statement */	191	CC_TRACE_LINE = 0x10, /* trace each statement */
216	CC_TRACE_ALL = CC_TRACE_SUB | CC_TRACE_LINE,	192	CC_TRACE_ALL = CC_TRACE_SUB | CC_TRACE_LINE,
217	};	193	};
218		194
219	/* this is a structure representing a c-level coroutine */	195	/* this is a structure representing a c-level coroutine */
220	typedef struct coro_cctx {	196	typedef struct coro_cctx
		197	{
221	struct coro_cctx *next;	198	struct coro_cctx *next;
222		199
223	/* the stack */	200	/* the stack */
224	void *sptr;	201	void *sptr;
225	size_t ssize;	202	size_t ssize;
…		…
243	CF_NEW = 0x0004, /* has never been switched to */	220	CF_NEW = 0x0004, /* has never been switched to */
244	CF_DESTROYED = 0x0008, /* coroutine data has been freed */	221	CF_DESTROYED = 0x0008, /* coroutine data has been freed */
245	};	222	};
246		223
247	/* the structure where most of the perl state is stored, overlaid on the cxstack */	224	/* the structure where most of the perl state is stored, overlaid on the cxstack */
248	typedef struct {	225	typedef struct
		226	{
249	SV *defsv;	227	SV *defsv;
250	AV *defav;	228	AV *defav;
251	SV *errsv;	229	SV *errsv;
252	SV *irsgv;	230	SV *irsgv;
253	#define VAR(name,type) type name;	231	#define VAR(name,type) type name;
…		…
257		235
258	#define SLOT_COUNT ((sizeof (perl_slots) + sizeof (PERL_CONTEXT) - 1) / sizeof (PERL_CONTEXT))	236	#define SLOT_COUNT ((sizeof (perl_slots) + sizeof (PERL_CONTEXT) - 1) / sizeof (PERL_CONTEXT))
259		237
260	/* this is a structure representing a perl-level coroutine */	238	/* this is a structure representing a perl-level coroutine */
261	struct coro {	239	struct coro {
262	/* the c coroutine allocated to this perl coroutine, if any */	240	/* the C coroutine allocated to this perl coroutine, if any */
263	coro_cctx *cctx;	241	coro_cctx *cctx;
264		242
265	/* process data */	243	/* state data */
		244	struct CoroSLF slf_frame; /* saved slf frame */
266	AV *mainstack;	245	AV *mainstack;
267	perl_slots *slot; /* basically the saved sp */	246	perl_slots *slot; /* basically the saved sp */
268		247
269	AV *args; /* data associated with this coroutine (initial args) */	248	AV *args; /* data associated with this coroutine (initial args) */
270	int refcnt; /* coroutines are refcounted, yes */	249	int refcnt; /* coroutines are refcounted, yes */
271	int flags; /* CF_ flags */	250	int flags; /* CF_ flags */
272	HV *hv; /* the perl hash associated with this coro, if any */	251	HV *hv; /* the perl hash associated with this coro, if any */
		252	void (*on_destroy)(pTHX_ struct coro *coro);
273		253
274	/* statistics */	254	/* statistics */
275	int usecount; /* number of transfers to this coro */	255	int usecount; /* number of transfers to this coro */
276		256
277	/* coro process data */	257	/* coro process data */
…		…
285	struct coro *next, *prev;	265	struct coro *next, *prev;
286	};	266	};
287		267
288	typedef struct coro *Coro__State;	268	typedef struct coro *Coro__State;
289	typedef struct coro *Coro__State_or_hashref;	269	typedef struct coro *Coro__State_or_hashref;
		270
		271	/* the following variables are effectively part of the perl context */
		272	/* and get copied between struct coro and these variables */
		273	/* the mainr easonw e don't support windows process emulation */
		274	static struct CoroSLF slf_frame; /* the current slf frame */
		275	static SV *coro_throw;
290		276
291	/** Coro ********************************************************************/	277	/** Coro ********************************************************************/
292		278
293	#define PRIO_MAX 3	279	#define PRIO_MAX 3
294	#define PRIO_HIGH 1	280	#define PRIO_HIGH 1
…		…
299		285
300	/* for Coro.pm */	286	/* for Coro.pm */
301	static SV *coro_current;	287	static SV *coro_current;
302	static SV *coro_readyhook;	288	static SV *coro_readyhook;
303	static AV *coro_ready [PRIO_MAX - PRIO_MIN + 1];	289	static AV *coro_ready [PRIO_MAX - PRIO_MIN + 1];
304	static int coro_nready;
305	static struct coro *coro_first;	290	static struct coro *coro_first;
		291	#define coro_nready coroapi.nready
306		292
307	/** lowlevel stuff **********************************************************/	293	/** lowlevel stuff **********************************************************/
308		294
309	static SV *	295	static SV *
310	coro_get_sv (pTHX_ const char *name, int create)	296	coro_get_sv (pTHX_ const char *name, int create)
…		…
395	SvREFCNT_dec (av); /* sv_magicext increased the refcount */	381	SvREFCNT_dec (av); /* sv_magicext increased the refcount */
396		382
397	return 0;	383	return 0;
398	}	384	}
399		385
400	#define CORO_MAGIC_type_cv PERL_MAGIC_ext	386	#define CORO_MAGIC_type_cv 26
401	#define CORO_MAGIC_type_state PERL_MAGIC_ext	387	#define CORO_MAGIC_type_state PERL_MAGIC_ext
402		388
403	static MGVTBL coro_cv_vtbl = {	389	static MGVTBL coro_cv_vtbl = {
404	0, 0, 0, 0,	390	0, 0, 0, 0,
405	coro_cv_free	391	coro_cv_free
406	};	392	};
407		393
		394	#define CORO_MAGIC_NN(sv, type) \
		395	(expect_true (SvMAGIC (sv)->mg_type == type) \
		396	? SvMAGIC (sv) \
		397	: mg_find (sv, type))
		398
408	#define CORO_MAGIC(sv, type) \	399	#define CORO_MAGIC(sv, type) \
409	SvMAGIC (sv) \	400	(expect_true (SvMAGIC (sv)) \
410	? SvMAGIC (sv)->mg_type == type \	401	? CORO_MAGIC_NN (sv, type) \
411	? SvMAGIC (sv) \
412	: mg_find (sv, type) \
413	: 0	402	: 0)
414		403
415	#define CORO_MAGIC_cv(cv) CORO_MAGIC (((SV *)(cv)), CORO_MAGIC_type_cv)	404	#define CORO_MAGIC_cv(cv) CORO_MAGIC (((SV *)(cv)), CORO_MAGIC_type_cv)
416	#define CORO_MAGIC_state(sv) CORO_MAGIC (((SV *)(sv)), CORO_MAGIC_type_state)	405	#define CORO_MAGIC_state(sv) CORO_MAGIC_NN (((SV *)(sv)), CORO_MAGIC_type_state)
417		406
418	static struct coro *	407	INLINE struct coro *
419	SvSTATE_ (pTHX_ SV *coro)	408	SvSTATE_ (pTHX_ SV *coro)
420	{	409	{
421	HV *stash;	410	HV *stash;
422	MAGIC *mg;	411	MAGIC *mg;
423		412
…		…
438	mg = CORO_MAGIC_state (coro);	427	mg = CORO_MAGIC_state (coro);
439	return (struct coro *)mg->mg_ptr;	428	return (struct coro *)mg->mg_ptr;
440	}	429	}
441		430
442	#define SvSTATE(sv) SvSTATE_ (aTHX_ (sv))	431	#define SvSTATE(sv) SvSTATE_ (aTHX_ (sv))
		432
		433	/* faster than SvSTATE, but expects a coroutine hv */
		434	#define SvSTATE_hv(hv) ((struct coro *)CORO_MAGIC_NN ((SV *)hv, CORO_MAGIC_type_state)->mg_ptr)
		435	#define SvSTATE_current SvSTATE_hv (SvRV (coro_current))
443		436
444	/* the next two functions merely cache the padlists */	437	/* the next two functions merely cache the padlists */
445	static void	438	static void
446	get_padlist (pTHX_ CV *cv)	439	get_padlist (pTHX_ CV *cv)
447	{	440	{
…		…
514	CvPADLIST (cv) = (AV *)POPs;	507	CvPADLIST (cv) = (AV *)POPs;
515	}	508	}
516		509
517	PUTBACK;	510	PUTBACK;
518	}	511	}
		512
		513	slf_frame = c->slf_frame;
		514	coro_throw = c->throw;
519	}	515	}
520		516
521	static void	517	static void
522	save_perl (pTHX_ Coro__State c)	518	save_perl (pTHX_ Coro__State c)
523	{	519	{
		520	c->throw = coro_throw;
		521	c->slf_frame = slf_frame;
		522
524	{	523	{
525	dSP;	524	dSP;
526	I32 cxix = cxstack_ix;	525	I32 cxix = cxstack_ix;
527	PERL_CONTEXT *ccstk = cxstack;	526	PERL_CONTEXT *ccstk = cxstack;
528	PERL_SI *top_si = PL_curstackinfo;	527	PERL_SI *top_si = PL_curstackinfo;
…		…
595	#undef VAR	594	#undef VAR
596	}	595	}
597	}	596	}
598		597
599	/*	598	/*
600	* allocate various perl stacks. This is an exact copy	599	* allocate various perl stacks. This is almost an exact copy
601	* of perl.c:init_stacks, except that it uses less memory	600	* of perl.c:init_stacks, except that it uses less memory
602	* on the (sometimes correct) assumption that coroutines do	601	* on the (sometimes correct) assumption that coroutines do
603	* not usually need a lot of stackspace.	602	* not usually need a lot of stackspace.
604	*/	603	*/
605	#if CORO_PREFER_PERL_FUNCTIONS	604	#if CORO_PREFER_PERL_FUNCTIONS
…		…
807		806
808	return orig_sigelem_set ? orig_sigelem_set (aTHX_ sv, mg) : 0;	807	return orig_sigelem_set ? orig_sigelem_set (aTHX_ sv, mg) : 0;
809	}	808	}
810		809
811	static void	810	static void
		811	prepare_nop (pTHX_ struct coro_transfer_args *ta)
		812	{
		813	/* kind of mega-hacky, but works */
		814	ta->next = ta->prev = (struct coro *)ta;
		815	}
		816
		817	static int
		818	slf_check_nop (pTHX_ struct CoroSLF *frame)
		819	{
		820	return 0;
		821	}
		822
		823	static UNOP coro_setup_op;
		824
		825	static void NOINLINE /* noinline to keep it out of the transfer fast path */
812	coro_setup (pTHX_ struct coro *coro)	826	coro_setup (pTHX_ struct coro *coro)
813	{	827	{
814	/*	828	/*
815	* emulate part of the perl startup here.	829	* emulate part of the perl startup here.
816	*/	830	*/
…		…
855	PL_op = PL_ppaddr[OP_ENTERSUB](aTHX);	869	PL_op = PL_ppaddr[OP_ENTERSUB](aTHX);
856	SPAGAIN;	870	SPAGAIN;
857	}	871	}
858		872
859	/* this newly created coroutine might be run on an existing cctx which most	873	/* this newly created coroutine might be run on an existing cctx which most
860	* likely was suspended in set_stacklevel, called from entersub.	874	* likely was suspended in pp_slf, so we have to emulate entering pp_slf here.
861	* set_stacklevel doesn't do anything on return, but entersub does LEAVE,
862	* so we ENTER here for symmetry.
863	*/	875	*/
864	ENTER;	876	slf_frame.prepare = prepare_nop; /* provide a nop function for an eventual pp_slf */
		877	slf_frame.check = slf_check_nop; /* signal pp_slf to not repeat */
		878
		879	/* and we have to provide the pp_slf op in any case, so pp_slf can skip it */
		880	coro_setup_op.op_type = OP_CUSTOM;
		881	coro_setup_op.op_ppaddr = pp_slf;
		882	coro_setup_op.op_next = PL_op;
		883
		884	PL_op = (OP *)&coro_setup_op;
		885
		886	/* copy throw, in case it was set before coro_setup */
		887	coro_throw = coro->throw;
865	}	888	}
866		889
867	static void	890	static void
868	coro_destruct (pTHX_ struct coro *coro)	891	coro_destruct (pTHX_ struct coro *coro)
869	{	892	{
…		…
893		916
894	SvREFCNT_dec (PL_diehook);	917	SvREFCNT_dec (PL_diehook);
895	SvREFCNT_dec (PL_warnhook);	918	SvREFCNT_dec (PL_warnhook);
896		919
897	SvREFCNT_dec (coro->saved_deffh);	920	SvREFCNT_dec (coro->saved_deffh);
898	SvREFCNT_dec (coro->throw);	921	SvREFCNT_dec (coro_throw);
899		922
900	coro_destruct_stacks (aTHX);	923	coro_destruct_stacks (aTHX);
901	}	924	}
902		925
903	static void	926	INLINE void
904	free_coro_mortal (pTHX)	927	free_coro_mortal (pTHX)
905	{	928	{
906	if (expect_true (coro_mortal))	929	if (expect_true (coro_mortal))
907	{	930	{
908	SvREFCNT_dec (coro_mortal);	931	SvREFCNT_dec (coro_mortal);
…		…
913	static int	936	static int
914	runops_trace (pTHX)	937	runops_trace (pTHX)
915	{	938	{
916	COP *oldcop = 0;	939	COP *oldcop = 0;
917	int oldcxix = -2;	940	int oldcxix = -2;
918	struct coro *coro = SvSTATE (coro_current); /* trace cctx is tied to specific coro */	941	struct coro *coro = SvSTATE_current; /* trace cctx is tied to specific coro */
919	coro_cctx *cctx = coro->cctx;	942	coro_cctx *cctx = coro->cctx;
920		943
921	while ((PL_op = CALL_FPTR (PL_op->op_ppaddr) (aTHX)))	944	while ((PL_op = CALL_FPTR (PL_op->op_ppaddr) (aTHX)))
922	{	945	{
923	PERL_ASYNC_CHECK ();	946	PERL_ASYNC_CHECK ();
…		…
1032		1055
1033	TAINT_NOT;	1056	TAINT_NOT;
1034	return 0;	1057	return 0;
1035	}	1058	}
1036		1059
		1060	static struct coro_cctx *cctx_ssl_cctx;
		1061	static struct CoroSLF cctx_ssl_frame;
		1062
1037	static void	1063	static void
1038	prepare_set_stacklevel (struct transfer_args *ta, struct coro_cctx *cctx)	1064	slf_prepare_set_stacklevel (pTHX_ struct coro_transfer_args *ta)
1039	{	1065	{
1040	ta->prev = (struct coro *)cctx;	1066	ta->prev = (struct coro *)cctx_ssl_cctx;
1041	ta->next = 0;	1067	ta->next = 0;
1042	}	1068	}
1043		1069
1044	/* inject a fake call to Coro::State::_cctx_init into the execution */	1070	static int
1045	/* _cctx_init should be careful, as it could be called at almost any time */	1071	slf_check_set_stacklevel (pTHX_ struct CoroSLF *frame)
1046	/* during execution of a perl program */	1072	{
1047	/* also initialises PL_top_env */	1073	*frame = cctx_ssl_frame;
		1074
		1075	return 1; /* execute the restored frame - there must be one */
		1076	}
		1077
		1078	/* initialises PL_top_env and injects a pseudo-slf-call to sett he stacklevel */
1048	static void NOINLINE	1079	static void NOINLINE
1049	cctx_prepare (pTHX_ coro_cctx *cctx)	1080	cctx_prepare (pTHX_ coro_cctx *cctx)
1050	{	1081	{
1051	dSP;
1052	UNOP myop;
1053
1054	PL_top_env = &PL_start_env;	1082	PL_top_env = &PL_start_env;
1055		1083
1056	if (cctx->flags & CC_TRACE)	1084	if (cctx->flags & CC_TRACE)
1057	PL_runops = runops_trace;	1085	PL_runops = runops_trace;
1058		1086
1059	Zero (&myop, 1, UNOP);	1087	/* we already must be in an SLF call, there is no other valid way
1060	myop.op_next = PL_op;	1088	* that can lead to creation of a new cctx */
1061	myop.op_flags = OPf_WANT_VOID | OPf_STACKED;	1089	assert (("FATAL: can't prepare slf-less cctx in Coro module (please report)",
		1090	slf_frame.prepare && PL_op->op_ppaddr == pp_slf));
1062		1091
1063	PUSHMARK (SP);	1092	cctx_ssl_cctx = cctx;
1064	EXTEND (SP, 2);	1093	cctx_ssl_frame = slf_frame;
1065	PUSHs (sv_2mortal (newSViv ((IV)cctx)));
1066	PUSHs ((SV *)get_cv ("Coro::State::_cctx_init", FALSE));
1067	PUTBACK;
1068	PL_op = (OP *)&myop;
1069	PL_op = PL_ppaddr[OP_ENTERSUB](aTHX);
1070	SPAGAIN;
1071	}
1072		1094
		1095	slf_frame.prepare = slf_prepare_set_stacklevel;
		1096	slf_frame.check = slf_check_set_stacklevel;
		1097	}
		1098
1073	/* the tail of transfer: execute stuff we can onyl do afetr a transfer */	1099	/* the tail of transfer: execute stuff we can only do after a transfer */
1074	static void	1100	INLINE void
1075	transfer_tail (void)	1101	transfer_tail (pTHX)
1076	{	1102	{
1077	struct coro *next = (struct coro *)transfer_next;
1078	transfer_next = 0; //D for temporary assertion in transfer
1079	assert (("FATAL ERROR: internal error 1067 in Coro module, please report", next));//D
1080
1081	free_coro_mortal (aTHX);	1103	free_coro_mortal (aTHX);
1082	UNLOCK;
1083
1084	if (expect_false (next->throw))
1085	{
1086	SV *exception = sv_2mortal (next->throw);
1087
1088	next->throw = 0;
1089	sv_setsv (ERRSV, exception);
1090	croak (0);
1091	}
1092	}	1104	}
1093		1105
1094	/*	1106	/*
1095	* this is a _very_ stripped down perl interpreter ;)	1107	* this is a _very_ stripped down perl interpreter ;)
1096	*/	1108	*/
…		…
1103	# endif	1115	# endif
1104	#endif	1116	#endif
1105	{	1117	{
1106	dTHX;	1118	dTHX;
1107		1119
1108	/* entersub called ENTER, but we never 'returned', undo that here */	1120	/* normally we would need to skip the entersub here */
1109	LEAVE;	1121	/* not doing so will re-execute it, which is exactly what we want */
1110
1111	/* we now skip the entersub that did lead to transfer() */
1112	PL_op = PL_op->op_next;	1122	/* PL_nop = PL_nop->op_next */
1113		1123
1114	/* inject a fake subroutine call to cctx_init */	1124	/* inject a fake subroutine call to cctx_init */
1115	cctx_prepare (aTHX_ (coro_cctx *)arg);	1125	cctx_prepare (aTHX_ (coro_cctx *)arg);
1116		1126
1117	/* cctx_run is the alternative tail of transfer() */	1127	/* cctx_run is the alternative tail of transfer() */
1118	transfer_tail ();	1128	transfer_tail (aTHX);
1119		1129
1120	/* somebody or something will hit me for both perl_run and PL_restartop */	1130	/* somebody or something will hit me for both perl_run and PL_restartop */
1121	PL_restartop = PL_op;	1131	PL_restartop = PL_op;
1122	perl_run (PL_curinterp);	1132	perl_run (PL_curinterp);
1123		1133
…		…
1173	/* mmap supposedly does allocate-on-write for us */	1183	/* mmap supposedly does allocate-on-write for us */
1174	cctx->sptr = mmap (0, cctx->ssize, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, 0, 0);	1184	cctx->sptr = mmap (0, cctx->ssize, PROT_EXEC|PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, 0, 0);
1175		1185
1176	if (cctx->sptr != (void *)-1)	1186	if (cctx->sptr != (void *)-1)
1177	{	1187	{
1178	# if CORO_STACKGUARD	1188	#if CORO_STACKGUARD
1179	mprotect (cctx->sptr, CORO_STACKGUARD * PAGESIZE, PROT_NONE);	1189	mprotect (cctx->sptr, CORO_STACKGUARD * PAGESIZE, PROT_NONE);
1180	# endif	1190	#endif
1181	stack_start = CORO_STACKGUARD * PAGESIZE + (char *)cctx->sptr;	1191	stack_start = (char *)cctx->sptr + CORO_STACKGUARD * PAGESIZE;
1182	stack_size = cctx->ssize - CORO_STACKGUARD * PAGESIZE;	1192	stack_size = cctx->ssize - CORO_STACKGUARD * PAGESIZE;
1183	cctx->flags |= CC_MAPPED;	1193	cctx->flags |= CC_MAPPED;
1184	}	1194	}
1185	else	1195	else
1186	#endif	1196	#endif
1187	{	1197	{
1188	cctx->ssize = cctx_stacksize * (long)sizeof (long);	1198	cctx->ssize = cctx_stacksize * (long)sizeof (long);
1189	New (0, cctx->sptr, cctx_stacksize, long);	1199	New (0, cctx->sptr, cctx_stacksize, long);
1190		1200
1191	if (!cctx->sptr)	1201	if (!cctx->sptr)
1192	{	1202	{
1193	perror ("FATAL: unable to allocate stack for coroutine");	1203	perror ("FATAL: unable to allocate stack for coroutine, exiting.");
1194	_exit (EXIT_FAILURE);	1204	_exit (EXIT_FAILURE);
1195	}	1205	}
1196		1206
1197	stack_start = cctx->sptr;	1207	stack_start = cctx->sptr;
1198	stack_size = cctx->ssize;	1208	stack_size = cctx->ssize;
1199	}	1209	}
1200		1210
1201	REGISTER_STACK (cctx, (char *)stack_start, (char *)stack_start + stack_size);	1211	#if CORO_USE_VALGRIND
		1212	cctx->valgrind_id = VALGRIND_STACK_REGISTER ((char *)stack_start, (char *)stack_start + stack_size);
		1213	#endif
		1214
1202	coro_create (&cctx->cctx, cctx_run, (void *)cctx, stack_start, stack_size);	1215	coro_create (&cctx->cctx, cctx_run, (void *)cctx, stack_start, stack_size);
1203		1216
1204	return cctx;	1217	return cctx;
1205	}	1218	}
1206		1219
…		…
1214	coro_destroy (&cctx->cctx);	1227	coro_destroy (&cctx->cctx);
1215		1228
1216	/* coro_transfer creates new, empty cctx's */	1229	/* coro_transfer creates new, empty cctx's */
1217	if (cctx->sptr)	1230	if (cctx->sptr)
1218	{	1231	{
1219	#if CORO_USE_VALGRIND	1232	#if CORO_USE_VALGRIND
1220	VALGRIND_STACK_DEREGISTER (cctx->valgrind_id);	1233	VALGRIND_STACK_DEREGISTER (cctx->valgrind_id);
1221	#endif	1234	#endif
1222		1235
1223	#if HAVE_MMAP	1236	#if HAVE_MMAP
1224	if (cctx->flags & CC_MAPPED)	1237	if (cctx->flags & CC_MAPPED)
1225	munmap (cctx->sptr, cctx->ssize);	1238	munmap (cctx->sptr, cctx->ssize);
1226	else	1239	else
…		…
1253	}	1266	}
1254		1267
1255	static void	1268	static void
1256	cctx_put (coro_cctx *cctx)	1269	cctx_put (coro_cctx *cctx)
1257	{	1270	{
1258	assert (("cctx_put called on non-initialised cctx", cctx->sptr));	1271	assert (("FATAL: cctx_put called on non-initialised cctx in Coro (please report)", cctx->sptr));
1259		1272
1260	/* free another cctx if overlimit */	1273	/* free another cctx if overlimit */
1261	if (expect_false (cctx_idle >= cctx_max_idle))	1274	if (expect_false (cctx_idle >= cctx_max_idle))
1262	{	1275	{
1263	coro_cctx *first = cctx_first;	1276	coro_cctx *first = cctx_first;
…		…
1275	/** coroutine switching *****************************************************/	1288	/** coroutine switching *****************************************************/
1276		1289
1277	static void	1290	static void
1278	transfer_check (pTHX_ struct coro *prev, struct coro *next)	1291	transfer_check (pTHX_ struct coro *prev, struct coro *next)
1279	{	1292	{
		1293	/* TODO: throwing up here is considered harmful */
		1294
1280	if (expect_true (prev != next))	1295	if (expect_true (prev != next))
1281	{	1296	{
1282	if (expect_false (!(prev->flags & (CF_RUNNING | CF_NEW))))	1297	if (expect_false (!(prev->flags & (CF_RUNNING | CF_NEW))))
1283	croak ("Coro::State::transfer called with non-running/new prev Coro::State, but can only transfer from running or new states");	1298	croak ("Coro::State::transfer called with non-running/new prev Coro::State, but can only transfer from running or new states,");
1284		1299
1285	if (expect_false (next->flags & CF_RUNNING))	1300	if (expect_false (next->flags & CF_RUNNING))
1286	croak ("Coro::State::transfer called with running next Coro::State, but can only transfer to inactive states");	1301	croak ("Coro::State::transfer called with running next Coro::State, but can only transfer to inactive states,");
1287		1302
1288	if (expect_false (next->flags & CF_DESTROYED))	1303	if (expect_false (next->flags & CF_DESTROYED))
1289	croak ("Coro::State::transfer called with destroyed next Coro::State, but can only transfer to inactive states");	1304	croak ("Coro::State::transfer called with destroyed next Coro::State, but can only transfer to inactive states,");
1290		1305
1291	#if !PERL_VERSION_ATLEAST (5,10,0)	1306	#if !PERL_VERSION_ATLEAST (5,10,0)
1292	if (expect_false (PL_lex_state != LEX_NOTPARSING))	1307	if (expect_false (PL_lex_state != LEX_NOTPARSING))
1293	croak ("Coro::State::transfer called while parsing, but this is not supported in your perl version");	1308	croak ("Coro::State::transfer called while parsing, but this is not supported in your perl version,");
1294	#endif	1309	#endif
1295	}	1310	}
1296	}	1311	}
1297		1312
1298	/* always use the TRANSFER macro */	1313	/* always use the TRANSFER macro */
1299	static void NOINLINE	1314	static void NOINLINE /* noinline so we have a fixed stackframe */
1300	transfer (pTHX_ struct coro *prev, struct coro *next, int force_cctx)	1315	transfer (pTHX_ struct coro *prev, struct coro *next, int force_cctx)
1301	{	1316	{
1302	dSTACKLEVEL;	1317	dSTACKLEVEL;
1303		1318
1304	/* sometimes transfer is only called to set idle_sp */	1319	/* sometimes transfer is only called to set idle_sp */
1305	if (expect_false (!next))	1320	if (expect_false (!next))
1306	{	1321	{
1307	((coro_cctx *)prev)->idle_sp = STACKLEVEL;	1322	((coro_cctx *)prev)->idle_sp = (void *)stacklevel;
1308	assert (((coro_cctx *)prev)->idle_te = PL_top_env); /* just for the side-effect when asserts are enabled */	1323	assert (((coro_cctx *)prev)->idle_te = PL_top_env); /* just for the side-effect when asserts are enabled */
1309	}	1324	}
1310	else if (expect_true (prev != next))	1325	else if (expect_true (prev != next))
1311	{	1326	{
1312	coro_cctx *prev__cctx;	1327	coro_cctx *prev__cctx;
…		…
1319	prev->flags |= CF_RUNNING;	1334	prev->flags |= CF_RUNNING;
1320	}	1335	}
1321		1336
1322	prev->flags &= ~CF_RUNNING;	1337	prev->flags &= ~CF_RUNNING;
1323	next->flags |= CF_RUNNING;	1338	next->flags |= CF_RUNNING;
1324
1325	LOCK;
1326		1339
1327	/* first get rid of the old state */	1340	/* first get rid of the old state */
1328	save_perl (aTHX_ prev);	1341	save_perl (aTHX_ prev);
1329		1342
1330	if (expect_false (next->flags & CF_NEW))	1343	if (expect_false (next->flags & CF_NEW))
…		…
1339		1352
1340	prev__cctx = prev->cctx;	1353	prev__cctx = prev->cctx;
1341		1354
1342	/* possibly untie and reuse the cctx */	1355	/* possibly untie and reuse the cctx */
1343	if (expect_true (	1356	if (expect_true (
1344	prev__cctx->idle_sp == STACKLEVEL	1357	prev__cctx->idle_sp == (void *)stacklevel
1345	&& !(prev__cctx->flags & CC_TRACE)	1358	&& !(prev__cctx->flags & CC_TRACE)
1346	&& !force_cctx	1359	&& !force_cctx
1347	))	1360	))
1348	{	1361	{
1349	/* I assume that STACKLEVEL is a stronger indicator than PL_top_env changes */	1362	/* I assume that stacklevel is a stronger indicator than PL_top_env changes */
1350	assert (("ERROR: current top_env must equal previous top_env", PL_top_env == prev__cctx->idle_te));	1363	assert (("FATAL: current top_env must equal previous top_env in Coro (please report)", PL_top_env == prev__cctx->idle_te));
1351		1364
1352	prev->cctx = 0;	1365	prev->cctx = 0;
1353		1366
1354	/* if the cctx is about to be destroyed we need to make sure we won't see it in cctx_get */	1367	/* if the cctx is about to be destroyed we need to make sure we won't see it in cctx_get */
1355	/* without this the next cctx_get might destroy the prev__cctx while still in use */	1368	/* without this the next cctx_get might destroy the prev__cctx while still in use */
…		…
1362		1375
1363	++next->usecount;	1376	++next->usecount;
1364		1377
1365	if (expect_true (!next->cctx))	1378	if (expect_true (!next->cctx))
1366	next->cctx = cctx_get (aTHX);	1379	next->cctx = cctx_get (aTHX);
1367
1368	assert (("FATAL ERROR: internal error 1352 in Coro, please report", !transfer_next));//D
1369	transfer_next = next;
1370		1380
1371	if (expect_false (prev__cctx != next->cctx))	1381	if (expect_false (prev__cctx != next->cctx))
1372	{	1382	{
1373	prev__cctx->top_env = PL_top_env;	1383	prev__cctx->top_env = PL_top_env;
1374	PL_top_env = next->cctx->top_env;	1384	PL_top_env = next->cctx->top_env;
1375	coro_transfer (&prev__cctx->cctx, &next->cctx->cctx);	1385	coro_transfer (&prev__cctx->cctx, &next->cctx->cctx);
1376	}	1386	}
1377		1387
1378	transfer_tail ();	1388	transfer_tail (aTHX);
1379	}	1389	}
1380	}	1390	}
1381		1391
1382	#define TRANSFER(ta, force_cctx) transfer (aTHX_ (ta).prev, (ta).next, (force_cctx))	1392	#define TRANSFER(ta, force_cctx) transfer (aTHX_ (ta).prev, (ta).next, (force_cctx))
1383	#define TRANSFER_CHECK(ta) transfer_check (aTHX_ (ta).prev, (ta).next)	1393	#define TRANSFER_CHECK(ta) transfer_check (aTHX_ (ta).prev, (ta).next)
…		…
1387	static int	1397	static int
1388	coro_state_destroy (pTHX_ struct coro *coro)	1398	coro_state_destroy (pTHX_ struct coro *coro)
1389	{	1399	{
1390	if (coro->flags & CF_DESTROYED)	1400	if (coro->flags & CF_DESTROYED)
1391	return 0;	1401	return 0;
		1402
		1403	if (coro->on_destroy)
		1404	coro->on_destroy (aTHX_ coro);
1392		1405
1393	coro->flags |= CF_DESTROYED;	1406	coro->flags |= CF_DESTROYED;
1394		1407
1395	if (coro->flags & CF_READY)	1408	if (coro->flags & CF_READY)
1396	{	1409	{
1397	/* reduce nready, as destroying a ready coro effectively unreadies it */	1410	/* reduce nready, as destroying a ready coro effectively unreadies it */
1398	/* alternative: look through all ready queues and remove the coro */	1411	/* alternative: look through all ready queues and remove the coro */
1399	LOCK;
1400	--coro_nready;	1412	--coro_nready;
1401	UNLOCK;
1402	}	1413	}
1403	else	1414	else
1404	coro->flags |= CF_READY; /* make sure it is NOT put into the readyqueue */	1415	coro->flags |= CF_READY; /* make sure it is NOT put into the readyqueue */
1405		1416
1406	if (coro->mainstack && coro->mainstack != main_mainstack)	1417	if (coro->mainstack && coro->mainstack != main_mainstack)
1407	{	1418	{
1408	struct coro temp;	1419	struct coro temp;
1409		1420
1410	if (coro->flags & CF_RUNNING)	1421	assert (("FATAL: tried to destroy currently running coroutine (please report)", !(coro->flags & CF_RUNNING)));
1411	croak ("FATAL: tried to destroy currently running coroutine");
1412		1422
1413	save_perl (aTHX_ &temp);	1423	save_perl (aTHX_ &temp);
1414	load_perl (aTHX_ coro);	1424	load_perl (aTHX_ coro);
1415		1425
1416	coro_destruct (aTHX_ coro);	1426	coro_destruct (aTHX_ coro);
…		…
1467	# define MGf_DUP 0	1477	# define MGf_DUP 0
1468	#endif	1478	#endif
1469	};	1479	};
1470		1480
1471	static void	1481	static void
1472	prepare_transfer (pTHX_ struct transfer_args *ta, SV *prev_sv, SV *next_sv)	1482	prepare_transfer (pTHX_ struct coro_transfer_args *ta, SV *prev_sv, SV *next_sv)
1473	{	1483	{
1474	ta->prev = SvSTATE (prev_sv);	1484	ta->prev = SvSTATE (prev_sv);
1475	ta->next = SvSTATE (next_sv);	1485	ta->next = SvSTATE (next_sv);
1476	TRANSFER_CHECK (*ta);	1486	TRANSFER_CHECK (*ta);
1477	}	1487	}
1478		1488
1479	static void	1489	static void
1480	api_transfer (SV *prev_sv, SV *next_sv)	1490	api_transfer (pTHX_ SV *prev_sv, SV *next_sv)
1481	{	1491	{
1482	dTHX;
1483	struct transfer_args ta;	1492	struct coro_transfer_args ta;
1484		1493
1485	prepare_transfer (aTHX_ &ta, prev_sv, next_sv);	1494	prepare_transfer (aTHX_ &ta, prev_sv, next_sv);
1486	TRANSFER (ta, 1);	1495	TRANSFER (ta, 1);
1487	}	1496	}
1488		1497
1489	/** Coro ********************************************************************/	1498	/** Coro ********************************************************************/
1490		1499
1491	static void	1500	INLINE void
1492	coro_enq (pTHX_ SV *coro_sv)	1501	coro_enq (pTHX_ struct coro *coro)
1493	{	1502	{
1494	av_push (coro_ready [SvSTATE (coro_sv)->prio - PRIO_MIN], coro_sv);	1503	av_push (coro_ready [coro->prio - PRIO_MIN], SvREFCNT_inc_NN (coro->hv));
1495	}	1504	}
1496		1505
1497	static SV *	1506	INLINE SV *
1498	coro_deq (pTHX)	1507	coro_deq (pTHX)
1499	{	1508	{
1500	int prio;	1509	int prio;
1501		1510
1502	for (prio = PRIO_MAX - PRIO_MIN + 1; --prio >= 0; )	1511	for (prio = PRIO_MAX - PRIO_MIN + 1; --prio >= 0; )
…		…
1505		1514
1506	return 0;	1515	return 0;
1507	}	1516	}
1508		1517
1509	static int	1518	static int
1510	api_ready (SV *coro_sv)	1519	api_ready (pTHX_ SV *coro_sv)
1511	{	1520	{
1512	dTHX;
1513	struct coro *coro;	1521	struct coro *coro;
1514	SV *sv_hook;	1522	SV *sv_hook;
1515	void (*xs_hook)(void);	1523	void (*xs_hook)(void);
1516		1524
1517	if (SvROK (coro_sv))	1525	if (SvROK (coro_sv))
…		…
1522	if (coro->flags & CF_READY)	1530	if (coro->flags & CF_READY)
1523	return 0;	1531	return 0;
1524		1532
1525	coro->flags |= CF_READY;	1533	coro->flags |= CF_READY;
1526		1534
1527	LOCK;
1528
1529	sv_hook = coro_nready ? 0 : coro_readyhook;	1535	sv_hook = coro_nready ? 0 : coro_readyhook;
1530	xs_hook = coro_nready ? 0 : coroapi.readyhook;	1536	xs_hook = coro_nready ? 0 : coroapi.readyhook;
1531		1537
1532	coro_enq (aTHX_ SvREFCNT_inc_NN (coro_sv));	1538	coro_enq (aTHX_ coro);
1533	++coro_nready;	1539	++coro_nready;
1534		1540
1535	UNLOCK;
1536
1537	if (sv_hook)	1541	if (sv_hook)
1538	{	1542	{
1539	dSP;	1543	dSP;
1540		1544
1541	ENTER;	1545	ENTER;
1542	SAVETMPS;	1546	SAVETMPS;
1543		1547
1544	PUSHMARK (SP);	1548	PUSHMARK (SP);
1545	PUTBACK;	1549	PUTBACK;
1546	call_sv (sv_hook, G_DISCARD);	1550	call_sv (sv_hook, G_VOID | G_DISCARD);
1547	SPAGAIN;
1548		1551
1549	FREETMPS;	1552	FREETMPS;
1550	LEAVE;	1553	LEAVE;
1551	}	1554	}
1552		1555
…		…
1555		1558
1556	return 1;	1559	return 1;
1557	}	1560	}
1558		1561
1559	static int	1562	static int
1560	api_is_ready (SV *coro_sv)	1563	api_is_ready (pTHX_ SV *coro_sv)
1561	{	1564	{
1562	dTHX;
1563	return !!(SvSTATE (coro_sv)->flags & CF_READY);	1565	return !!(SvSTATE (coro_sv)->flags & CF_READY);
1564	}	1566	}
1565		1567
1566	static void	1568	INLINE void
1567	prepare_schedule (pTHX_ struct transfer_args *ta)	1569	prepare_schedule (pTHX_ struct coro_transfer_args *ta)
1568	{	1570	{
1569	SV *prev_sv, *next_sv;	1571	SV *prev_sv, *next_sv;
1570		1572
1571	for (;;)	1573	for (;;)
1572	{	1574	{
1573	LOCK;
1574	next_sv = coro_deq (aTHX);	1575	next_sv = coro_deq (aTHX);
1575		1576
1576	/* nothing to schedule: call the idle handler */	1577	/* nothing to schedule: call the idle handler */
1577	if (expect_false (!next_sv))	1578	if (expect_false (!next_sv))
1578	{	1579	{
1579	dSP;	1580	dSP;
1580	UNLOCK;
1581		1581
1582	ENTER;	1582	ENTER;
1583	SAVETMPS;	1583	SAVETMPS;
1584		1584
1585	PUSHMARK (SP);	1585	PUSHMARK (SP);
1586	PUTBACK;	1586	PUTBACK;
1587	call_sv (get_sv ("Coro::idle", FALSE), G_DISCARD);	1587	call_sv (get_sv ("Coro::idle", FALSE), G_VOID | G_DISCARD);
1588	SPAGAIN;
1589		1588
1590	FREETMPS;	1589	FREETMPS;
1591	LEAVE;	1590	LEAVE;
1592	continue;	1591	continue;
1593	}	1592	}
1594		1593
1595	ta->next = SvSTATE (next_sv);	1594	ta->next = SvSTATE_hv (next_sv);
1596		1595
1597	/* cannot transfer to destroyed coros, skip and look for next */	1596	/* cannot transfer to destroyed coros, skip and look for next */
1598	if (expect_false (ta->next->flags & CF_DESTROYED))	1597	if (expect_false (ta->next->flags & CF_DESTROYED))
1599	{	1598	{
1600	UNLOCK;
1601	SvREFCNT_dec (next_sv);	1599	SvREFCNT_dec (next_sv);
1602	/* coro_nready has already been taken care of by destroy */	1600	/* coro_nready has already been taken care of by destroy */
1603	continue;	1601	continue;
1604	}	1602	}
1605		1603
1606	--coro_nready;	1604	--coro_nready;
1607	UNLOCK;
1608	break;	1605	break;
1609	}	1606	}
1610		1607
1611	/* free this only after the transfer */	1608	/* free this only after the transfer */
1612	prev_sv = SvRV (coro_current);	1609	prev_sv = SvRV (coro_current);
1613	ta->prev = SvSTATE (prev_sv);	1610	ta->prev = SvSTATE_hv (prev_sv);
1614	TRANSFER_CHECK (*ta);	1611	TRANSFER_CHECK (*ta);
1615	assert (ta->next->flags & CF_READY);	1612	assert (("FATAL: next coroutine isn't marked as ready in Coro (please report)", ta->next->flags & CF_READY));
1616	ta->next->flags &= ~CF_READY;	1613	ta->next->flags &= ~CF_READY;
1617	SvRV_set (coro_current, next_sv);	1614	SvRV_set (coro_current, next_sv);
1618		1615
1619	LOCK;
1620	free_coro_mortal (aTHX);	1616	free_coro_mortal (aTHX);
1621	coro_mortal = prev_sv;	1617	coro_mortal = prev_sv;
1622	UNLOCK;
1623	}	1618	}
1624		1619
1625	static void	1620	INLINE void
1626	prepare_cede (pTHX_ struct transfer_args *ta)	1621	prepare_cede (pTHX_ struct coro_transfer_args *ta)
1627	{	1622	{
1628	api_ready (coro_current);	1623	api_ready (aTHX_ coro_current);
1629	prepare_schedule (aTHX_ ta);	1624	prepare_schedule (aTHX_ ta);
1630	}	1625	}
1631		1626
		1627	INLINE void
		1628	prepare_cede_notself (pTHX_ struct coro_transfer_args *ta)
		1629	{
		1630	SV *prev = SvRV (coro_current);
		1631
		1632	if (coro_nready)
		1633	{
		1634	prepare_schedule (aTHX_ ta);
		1635	api_ready (aTHX_ prev);
		1636	}
		1637	else
		1638	prepare_nop (aTHX_ ta);
		1639	}
		1640
		1641	static void
		1642	api_schedule (pTHX)
		1643	{
		1644	struct coro_transfer_args ta;
		1645
		1646	prepare_schedule (aTHX_ &ta);
		1647	TRANSFER (ta, 1);
		1648	}
		1649
1632	static int	1650	static int
1633	prepare_cede_notself (pTHX_ struct transfer_args *ta)	1651	api_cede (pTHX)
1634	{	1652	{
1635	if (coro_nready)	1653	struct coro_transfer_args ta;
1636	{	1654
1637	SV *prev = SvRV (coro_current);
1638	prepare_schedule (aTHX_ ta);	1655	prepare_cede (aTHX_ &ta);
1639	api_ready (prev);	1656
		1657	if (expect_true (ta.prev != ta.next))
		1658	{
		1659	TRANSFER (ta, 1);
1640	return 1;	1660	return 1;
1641	}	1661	}
1642	else	1662	else
1643	return 0;	1663	return 0;
1644	}	1664	}
1645		1665
1646	static void
1647	api_schedule (void)
1648	{
1649	dTHX;
1650	struct transfer_args ta;
1651
1652	prepare_schedule (aTHX_ &ta);
1653	TRANSFER (ta, 1);
1654	}
1655
1656	static int	1666	static int
1657	api_cede (void)	1667	api_cede_notself (pTHX)
1658	{	1668	{
1659	dTHX;	1669	if (coro_nready)
		1670	{
1660	struct transfer_args ta;	1671	struct coro_transfer_args ta;
1661		1672
1662	prepare_cede (aTHX_ &ta);	1673	prepare_cede_notself (aTHX_ &ta);
1663
1664	if (expect_true (ta.prev != ta.next))
1665	{
1666	TRANSFER (ta, 1);	1674	TRANSFER (ta, 1);
1667	return 1;	1675	return 1;
1668	}	1676	}
1669	else	1677	else
1670	return 0;	1678	return 0;
1671	}	1679	}
1672		1680
1673	static int	1681	static void
1674	api_cede_notself (void)
1675	{
1676	dTHX;
1677	struct transfer_args ta;
1678
1679	if (prepare_cede_notself (aTHX_ &ta))
1680	{
1681	TRANSFER (ta, 1);
1682	return 1;
1683	}
1684	else
1685	return 0;
1686	}
1687
1688	static void
1689	api_trace (SV *coro_sv, int flags)	1682	api_trace (pTHX_ SV *coro_sv, int flags)
1690	{	1683	{
1691	dTHX;
1692	struct coro *coro = SvSTATE (coro_sv);	1684	struct coro *coro = SvSTATE (coro_sv);
1693		1685
1694	if (flags & CC_TRACE)	1686	if (flags & CC_TRACE)
1695	{	1687	{
1696	if (!coro->cctx)	1688	if (!coro->cctx)
1697	coro->cctx = cctx_new_run ();	1689	coro->cctx = cctx_new_run ();
1698	else if (!(coro->cctx->flags & CC_TRACE))	1690	else if (!(coro->cctx->flags & CC_TRACE))
1699	croak ("cannot enable tracing on coroutine with custom stack");	1691	croak ("cannot enable tracing on coroutine with custom stack,");
1700		1692
1701	coro->cctx->flags |= CC_NOREUSE | (flags & (CC_TRACE | CC_TRACE_ALL));	1693	coro->cctx->flags |= CC_NOREUSE | (flags & (CC_TRACE | CC_TRACE_ALL));
1702	}	1694	}
1703	else if (coro->cctx && coro->cctx->flags & CC_TRACE)	1695	else if (coro->cctx && coro->cctx->flags & CC_TRACE)
1704	{	1696	{
…		…
1709	else	1701	else
1710	coro->slot->runops = RUNOPS_DEFAULT;	1702	coro->slot->runops = RUNOPS_DEFAULT;
1711	}	1703	}
1712	}	1704	}
1713		1705
1714	#if 0	1706	/*****************************************************************************/
		1707	/* schedule-like-function opcode (SLF) */
		1708
		1709	static UNOP slf_restore; /* restore stack as entersub did, for first-re-run */
		1710	static const CV *slf_cv;
		1711	static SV **slf_argv;
		1712	static int slf_argc, slf_arga; /* count, allocated */
		1713	static I32 slf_ax; /* top of stack, for restore */
		1714
		1715	/* this restores the stack in the case we patched the entersub, to */
		1716	/* recreate the stack frame as perl will on following calls */
		1717	/* since entersub cleared the stack */
		1718	static OP *
		1719	pp_restore (pTHX)
		1720	{
		1721	int i;
		1722	SV **SP = PL_stack_base + slf_ax;
		1723
		1724	PUSHMARK (SP);
		1725
		1726	EXTEND (SP, slf_argc + 1);
		1727
		1728	for (i = 0; i < slf_argc; ++i)
		1729	PUSHs (sv_2mortal (slf_argv [i]));
		1730
		1731	PUSHs ((SV *)CvGV (slf_cv));
		1732
		1733	RETURNOP (slf_restore.op_first);
		1734	}
		1735
1715	static int	1736	static void
1716	coro_gensub_free (pTHX_ SV *sv, MAGIC *mg)	1737	slf_prepare_transfer (pTHX_ struct coro_transfer_args *ta)
1717	{	1738	{
1718	AV *padlist;	1739	SV **arg = (SV **)slf_frame.data;
1719	AV *av = (AV *)mg->mg_obj;
1720		1740
1721	abort ();	1741	prepare_transfer (aTHX_ ta, arg [0], arg [1]);
1722
1723	return 0;
1724	}	1742	}
1725		1743
1726	static MGVTBL coro_gensub_vtbl = {	1744	static void
1727	0, 0, 0, 0,	1745	slf_init_transfer (pTHX_ struct CoroSLF *frame, CV *cv, SV **arg, int items)
1728	coro_gensub_free	1746	{
1729	};	1747	if (items != 2)
1730	#endif	1748	croak ("Coro::State::transfer (prev, next) expects two arguments, not %d,", items);
		1749
		1750	frame->prepare = slf_prepare_transfer;
		1751	frame->check = slf_check_nop;
		1752	frame->data = (void *)arg; /* let's hope it will stay valid */
		1753	}
		1754
		1755	static void
		1756	slf_init_schedule (pTHX_ struct CoroSLF *frame, CV *cv, SV **arg, int items)
		1757	{
		1758	frame->prepare = prepare_schedule;
		1759	frame->check = slf_check_nop;
		1760	}
		1761
		1762	static void
		1763	slf_init_cede (pTHX_ struct CoroSLF *frame, CV *cv, SV **arg, int items)
		1764	{
		1765	frame->prepare = prepare_cede;
		1766	frame->check = slf_check_nop;
		1767	}
		1768
		1769	static void
		1770	slf_init_cede_notself (pTHX_ struct CoroSLF *frame, CV *cv, SV **arg, int items)
		1771	{
		1772	frame->prepare = prepare_cede_notself;
		1773	frame->check = slf_check_nop;
		1774	}
		1775
		1776	/*
		1777	* these not obviously related functions are all rolled into one
		1778	* function to increase chances that they all will call transfer with the same
		1779	* stack offset
		1780	* SLF stands for "schedule-like-function".
		1781	*/
		1782	static OP *
		1783	pp_slf (pTHX)
		1784	{
		1785	I32 checkmark; /* mark SP to see how many elements check has pushed */
		1786
		1787	/* set up the slf frame, unless it has already been set-up */
		1788	/* the latter happens when a new coro has been started */
		1789	/* or when a new cctx was attached to an existing coroutine */
		1790	if (expect_true (!slf_frame.prepare))
		1791	{
		1792	/* first iteration */
		1793	dSP;
		1794	SV **arg = PL_stack_base + TOPMARK + 1;
		1795	int items = SP - arg; /* args without function object */
		1796	SV *gv = *sp;
		1797
		1798	/* do a quick consistency check on the "function" object, and if it isn't */
		1799	/* for us, divert to the real entersub */
		1800	if (SvTYPE (gv) != SVt_PVGV
		1801	|| !GvCV (gv)
		1802	|| !(CvFLAGS (GvCV (gv)) & CVf_SLF))
		1803	return PL_ppaddr[OP_ENTERSUB](aTHX);
		1804
		1805	if (!(PL_op->op_flags & OPf_STACKED))
		1806	{
		1807	/* ampersand-form of call, use @_ instead of stack */
		1808	AV *av = GvAV (PL_defgv);
		1809	arg = AvARRAY (av);
		1810	items = AvFILLp (av) + 1;
		1811	}
		1812
		1813	/* now call the init function, which needs to set up slf_frame */
		1814	((coro_slf_cb)CvXSUBANY (GvCV (gv)).any_ptr)
		1815	(aTHX_ &slf_frame, GvCV (gv), arg, items);
		1816
		1817	/* pop args */
		1818	SP = PL_stack_base + POPMARK;
		1819
		1820	PUTBACK;
		1821	}
		1822
		1823	/* now that we have a slf_frame, interpret it! */
		1824	/* we use a callback system not to make the code needlessly */
		1825	/* complicated, but so we can run multiple perl coros from one cctx */
		1826
		1827	do
		1828	{
		1829	struct coro_transfer_args ta;
		1830
		1831	slf_frame.prepare (aTHX_ &ta);
		1832	TRANSFER (ta, 0);
		1833
		1834	checkmark = PL_stack_sp - PL_stack_base;
		1835	}
		1836	while (slf_frame.check (aTHX_ &slf_frame));
		1837
		1838	slf_frame.prepare = 0; /* invalidate the frame, we are done processing it */
		1839
		1840	/* return value handling - mostly like entersub */
		1841	/* make sure we put something on the stack in scalar context */
		1842	if (GIMME_V == G_SCALAR)
		1843	{
		1844	dSP;
		1845	SV **bot = PL_stack_base + checkmark;
		1846
		1847	if (sp == bot) /* too few, push undef */
		1848	bot [1] = &PL_sv_undef;
		1849	else if (sp != bot + 1) /* too many, take last one */
		1850	bot [1] = *sp;
		1851
		1852	SP = bot + 1;
		1853
		1854	PUTBACK;
		1855	}
		1856
		1857	/* exception handling */
		1858	if (expect_false (coro_throw))
		1859	{
		1860	SV *exception = sv_2mortal (coro_throw);
		1861
		1862	coro_throw = 0;
		1863	sv_setsv (ERRSV, exception);
		1864	croak (0);
		1865	}
		1866
		1867	return NORMAL;
		1868	}
		1869
		1870	static void
		1871	api_execute_slf (pTHX_ CV *cv, coro_slf_cb init_cb, I32 ax)
		1872	{
		1873	int i;
		1874	SV **arg = PL_stack_base + ax;
		1875	int items = PL_stack_sp - arg + 1;
		1876
		1877	assert (("FATAL: SLF call with illegal CV value", !CvANON (cv)));
		1878
		1879	if (PL_op->op_ppaddr != PL_ppaddr [OP_ENTERSUB]
		1880	&& PL_op->op_ppaddr != pp_slf)
		1881	croak ("FATAL: Coro SLF calls can only be made normally, not via goto or any other means, caught");
		1882
		1883	CvFLAGS (cv) |= CVf_SLF;
		1884	CvXSUBANY (cv).any_ptr = (void *)init_cb;
		1885	slf_cv = cv;
		1886
		1887	/* we patch the op, and then re-run the whole call */
		1888	/* we have to put the same argument on the stack for this to work */
		1889	/* and this will be done by pp_restore */
		1890	slf_restore.op_next = (OP *)&slf_restore;
		1891	slf_restore.op_type = OP_CUSTOM;
		1892	slf_restore.op_ppaddr = pp_restore;
		1893	slf_restore.op_first = PL_op;
		1894
		1895	slf_ax = ax - 1; /* undo the ax++ inside dAXMARK */
		1896
		1897	if (PL_op->op_flags & OPf_STACKED)
		1898	{
		1899	if (items > slf_arga)
		1900	{
		1901	slf_arga = items;
		1902	free (slf_argv);
		1903	slf_argv = malloc (slf_arga * sizeof (SV *));
		1904	}
		1905
		1906	slf_argc = items;
		1907
		1908	for (i = 0; i < items; ++i)
		1909	slf_argv [i] = SvREFCNT_inc (arg [i]);
		1910	}
		1911	else
		1912	slf_argc = 0;
		1913
		1914	PL_op->op_ppaddr = pp_slf;
		1915	PL_op->op_type = OP_CUSTOM; /* maybe we should leave it at entersub? */
		1916
		1917	PL_op = (OP *)&slf_restore;
		1918	}
1731		1919
1732	/*****************************************************************************/	1920	/*****************************************************************************/
1733	/* PerlIO::cede */	1921	/* PerlIO::cede */
1734		1922
1735	typedef struct	1923	typedef struct
…		…
1763	PerlIOCede *self = PerlIOSelf (f, PerlIOCede);	1951	PerlIOCede *self = PerlIOSelf (f, PerlIOCede);
1764	double now = nvtime ();	1952	double now = nvtime ();
1765		1953
1766	if (now >= self->next)	1954	if (now >= self->next)
1767	{	1955	{
1768	api_cede ();	1956	api_cede (aTHX);
1769	self->next = now + self->every;	1957	self->next = now + self->every;
1770	}	1958	}
1771		1959
1772	return PerlIOBuf_flush (aTHX_ f);	1960	return PerlIOBuf_flush (aTHX_ f);
1773	}	1961	}
…		…
1802	PerlIOBuf_get_ptr,	1990	PerlIOBuf_get_ptr,
1803	PerlIOBuf_get_cnt,	1991	PerlIOBuf_get_cnt,
1804	PerlIOBuf_set_ptrcnt,	1992	PerlIOBuf_set_ptrcnt,
1805	};	1993	};
1806		1994
		1995	/*****************************************************************************/
		1996	/* Coro::Semaphore */
		1997
		1998	static void
		1999	coro_semaphore_adjust (pTHX_ AV *av, IV adjust)
		2000	{
		2001	SV *count_sv = AvARRAY (av)[0];
		2002	IV count = SvIVX (count_sv);
		2003
		2004	count += adjust;
		2005	SvIVX (count_sv) = count;
		2006
		2007	/* now wake up as many waiters as are expected to lock */
		2008	while (count > 0 && AvFILLp (av) > 0)
		2009	{
		2010	SV *cb;
		2011
		2012	/* swap first two elements so we can shift a waiter */
		2013	AvARRAY (av)[0] = AvARRAY (av)[1];
		2014	AvARRAY (av)[1] = count_sv;
		2015	cb = av_shift (av);
		2016
		2017	if (SvOBJECT (cb))
		2018	api_ready (aTHX_ cb);
		2019	else
		2020	croak ("callbacks not yet supported");
		2021
		2022	SvREFCNT_dec (cb);
		2023
		2024	--count;
		2025	}
		2026	}
		2027
		2028	static void
		2029	coro_semaphore_on_destroy (pTHX_ struct coro *coro)
		2030	{
		2031	/* call $sem->adjust (0) to possibly wake up some other waiters */
		2032	coro_semaphore_adjust (aTHX_ (AV *)coro->slf_frame.data, 0);
		2033	}
		2034
		2035	static int
		2036	slf_check_semaphore_down (pTHX_ struct CoroSLF *frame)
		2037	{
		2038	AV *av = (AV *)frame->data;
		2039	SV *count_sv = AvARRAY (av)[0];
		2040
		2041	if (SvIVX (count_sv) > 0)
		2042	{
		2043	SvSTATE_current->on_destroy = 0;
		2044	SvIVX (count_sv) = SvIVX (count_sv) - 1;
		2045	return 0;
		2046	}
		2047	else
		2048	{
		2049	int i;
		2050	/* if we were woken up but can't down, we look through the whole */
		2051	/* waiters list and only add us if we aren't in there already */
		2052	/* this avoids some degenerate memory usage cases */
		2053
		2054	for (i = 1; i <= AvFILLp (av); ++i)
		2055	if (AvARRAY (av)[i] == SvRV (coro_current))
		2056	return 1;
		2057
		2058	av_push (av, SvREFCNT_inc (SvRV (coro_current)));
		2059	return 1;
		2060	}
		2061	}
		2062
		2063	static void
		2064	slf_init_semaphore_down (pTHX_ struct CoroSLF *frame, CV *cv, SV **arg, int items)
		2065	{
		2066	AV *av = (AV *)SvRV (arg [0]);
		2067
		2068	if (SvIVX (AvARRAY (av)[0]) > 0)
		2069	{
		2070	frame->data = (void *)av;
		2071	frame->prepare = prepare_nop;
		2072	SvSTATE_current->on_destroy = coro_semaphore_on_destroy;
		2073	}
		2074	else
		2075	{
		2076	av_push (av, SvREFCNT_inc (SvRV (coro_current)));
		2077
		2078	frame->data = (void *)sv_2mortal (SvREFCNT_inc ((SV *)av));
		2079	frame->prepare = prepare_schedule;
		2080
		2081	/* to avoid race conditions when a woken-up coro gets terminated */
		2082	/* we arrange for a temporary on_destroy that calls adjust (0) */
		2083	assert (!SvSTATE_current->on_destroy);//D
		2084	SvSTATE_current->on_destroy = coro_semaphore_on_destroy;
		2085	}
		2086
		2087	frame->check = slf_check_semaphore_down;
		2088
		2089	}
		2090
		2091	/*****************************************************************************/
		2092	/* gensub: simple closure generation utility */
		2093
		2094	#define GENSUB_ARG CvXSUBANY (cv).any_ptr
		2095
		2096	/* create a closure from XS, returns a code reference */
		2097	/* the arg can be accessed via GENSUB_ARG from the callback */
		2098	/* the callback must use dXSARGS/XSRETURN */
		2099	static SV *
		2100	gensub (pTHX_ void (*xsub)(pTHX_ CV *), void *arg)
		2101	{
		2102	CV *cv = (CV *)newSV (0);
		2103
		2104	sv_upgrade ((SV *)cv, SVt_PVCV);
		2105
		2106	CvANON_on (cv);
		2107	CvISXSUB_on (cv);
		2108	CvXSUB (cv) = xsub;
		2109	GENSUB_ARG = arg;
		2110
		2111	return newRV_noinc ((SV *)cv);
		2112	}
		2113
		2114	/*****************************************************************************/
		2115	/* Coro::AIO */
		2116
		2117	#define CORO_MAGIC_type_aio PERL_MAGIC_ext
		2118
		2119	/* helper storage struct */
		2120	struct io_state
		2121	{
		2122	int errorno;
		2123	I32 laststype; /* U16 in 5.10.0 */
		2124	int laststatval;
		2125	Stat_t statcache;
		2126	};
		2127
		2128	static void
		2129	coro_aio_callback (pTHX_ CV *cv)
		2130	{
		2131	dXSARGS;
		2132	AV *state = (AV *)GENSUB_ARG;
		2133	SV *coro = av_pop (state);
		2134	SV *data_sv = newSV (sizeof (struct io_state));
		2135
		2136	av_extend (state, items);
		2137
		2138	sv_upgrade (data_sv, SVt_PV);
		2139	SvCUR_set (data_sv, sizeof (struct io_state));
		2140	SvPOK_only (data_sv);
		2141
		2142	{
		2143	struct io_state *data = (struct io_state *)SvPVX (data_sv);
		2144
		2145	data->errorno = errno;
		2146	data->laststype = PL_laststype;
		2147	data->laststatval = PL_laststatval;
		2148	data->statcache = PL_statcache;
		2149	}
		2150
		2151	/* now build the result vector out of all the parameters and the data_sv */
		2152	{
		2153	int i;
		2154
		2155	for (i = 0; i < items; ++i)
		2156	av_push (state, SvREFCNT_inc_NN (ST (i)));
		2157	}
		2158
		2159	av_push (state, data_sv);
		2160
		2161	api_ready (aTHX_ coro);
		2162	SvREFCNT_dec (coro);
		2163	SvREFCNT_dec ((AV *)state);
		2164	}
		2165
		2166	static int
		2167	slf_check_aio_req (pTHX_ struct CoroSLF *frame)
		2168	{
		2169	AV *state = (AV *)frame->data;
		2170
		2171	/* one element that is an RV? repeat! */
		2172	if (AvFILLp (state) == 0 && SvROK (AvARRAY (state)[0]))
		2173	return 1;
		2174
		2175	/* restore status */
		2176	{
		2177	SV *data_sv = av_pop (state);
		2178	struct io_state *data = (struct io_state *)SvPVX (data_sv);
		2179
		2180	errno = data->errorno;
		2181	PL_laststype = data->laststype;
		2182	PL_laststatval = data->laststatval;
		2183	PL_statcache = data->statcache;
		2184
		2185	SvREFCNT_dec (data_sv);
		2186	}
		2187
		2188	/* push result values */
		2189	{
		2190	dSP;
		2191	int i;
		2192
		2193	EXTEND (SP, AvFILLp (state) + 1);
		2194	for (i = 0; i <= AvFILLp (state); ++i)
		2195	PUSHs (sv_2mortal (SvREFCNT_inc_NN (AvARRAY (state)[i])));
		2196
		2197	PUTBACK;
		2198	}
		2199
		2200	return 0;
		2201	}
		2202
		2203	static void
		2204	slf_init_aio_req (pTHX_ struct CoroSLF *frame, CV *cv, SV **arg, int items)
		2205	{
		2206	AV *state = (AV *)sv_2mortal ((SV *)newAV ());
		2207	SV *coro_hv = SvRV (coro_current);
		2208	struct coro *coro = SvSTATE_hv (coro_hv);
		2209
		2210	/* put our coroutine id on the state arg */
		2211	av_push (state, SvREFCNT_inc_NN (coro_hv));
		2212
		2213	/* first see whether we have a non-zero priority and set it as AIO prio */
		2214	if (coro->prio)
		2215	{
		2216	dSP;
		2217
		2218	static SV *prio_cv;
		2219	static SV *prio_sv;
		2220
		2221	if (expect_false (!prio_cv))
		2222	{
		2223	prio_cv = (SV *)get_cv ("IO::AIO::aioreq_pri", 0);
		2224	prio_sv = newSViv (0);
		2225	}
		2226
		2227	PUSHMARK (SP);
		2228	sv_setiv (prio_sv, coro->prio);
		2229	XPUSHs (prio_sv);
		2230
		2231	PUTBACK;
		2232	call_sv (prio_cv, G_VOID | G_DISCARD);
		2233	}
		2234
		2235	/* now call the original request */
		2236	{
		2237	dSP;
		2238	CV *req = (CV *)CORO_MAGIC_NN ((SV *)cv, CORO_MAGIC_type_aio)->mg_obj;
		2239	int i;
		2240
		2241	PUSHMARK (SP);
		2242
		2243	/* first push all args to the stack */
		2244	EXTEND (SP, items + 1);
		2245
		2246	for (i = 0; i < items; ++i)
		2247	PUSHs (arg [i]);
		2248
		2249	/* now push the callback closure */
		2250	PUSHs (sv_2mortal (gensub (aTHX_ coro_aio_callback, (void *)SvREFCNT_inc_NN ((SV *)state))));
		2251
		2252	/* now call the AIO function - we assume our request is uncancelable */
		2253	PUTBACK;
		2254	call_sv ((SV *)req, G_VOID | G_DISCARD);
		2255	}
		2256
		2257	/* now that the requets is going, we loop toll we have a result */
		2258	frame->data = (void *)state;
		2259	frame->prepare = prepare_schedule;
		2260	frame->check = slf_check_aio_req;
		2261	}
		2262
		2263	static void
		2264	coro_aio_req_xs (pTHX_ CV *cv)
		2265	{
		2266	dXSARGS;
		2267
		2268	CORO_EXECUTE_SLF_XS (slf_init_aio_req);
		2269
		2270	XSRETURN_EMPTY;
		2271	}
		2272
		2273	/*****************************************************************************/
1807		2274
1808	MODULE = Coro::State PACKAGE = Coro::State PREFIX = api_	2275	MODULE = Coro::State PACKAGE = Coro::State PREFIX = api_
1809		2276
1810	PROTOTYPES: DISABLE	2277	PROTOTYPES: DISABLE
1811		2278
1812	BOOT:	2279	BOOT:
1813	{	2280	{
1814	#ifdef USE_ITHREADS	2281	#ifdef USE_ITHREADS
1815	MUTEX_INIT (&coro_lock);
1816	# if CORO_PTHREAD	2282	# if CORO_PTHREAD
1817	coro_thx = PERL_GET_CONTEXT;	2283	coro_thx = PERL_GET_CONTEXT;
1818	# endif	2284	# endif
1819	#endif	2285	#endif
1820	BOOT_PAGESIZE;	2286	BOOT_PAGESIZE;
…		…
1841	main_top_env = PL_top_env;	2307	main_top_env = PL_top_env;
1842		2308
1843	while (main_top_env->je_prev)	2309	while (main_top_env->je_prev)
1844	main_top_env = main_top_env->je_prev;	2310	main_top_env = main_top_env->je_prev;
1845		2311
		2312	{
		2313	SV *slf = sv_2mortal (newSViv (PTR2IV (pp_slf)));
		2314
		2315	if (!PL_custom_op_names) PL_custom_op_names = newHV ();
		2316	hv_store_ent (PL_custom_op_names, slf,
		2317	newSVpv ("coro_slf", 0), 0);
		2318
		2319	if (!PL_custom_op_descs) PL_custom_op_descs = newHV ();
		2320	hv_store_ent (PL_custom_op_descs, slf,
		2321	newSVpv ("coro schedule like function", 0), 0);
		2322	}
		2323
1846	coroapi.ver = CORO_API_VERSION;	2324	coroapi.ver = CORO_API_VERSION;
1847	coroapi.rev = CORO_API_REVISION;	2325	coroapi.rev = CORO_API_REVISION;
		2326
1848	coroapi.transfer = api_transfer;	2327	coroapi.transfer = api_transfer;
		2328
		2329	coroapi.sv_state = SvSTATE_;
		2330	coroapi.execute_slf = api_execute_slf;
		2331	coroapi.prepare_nop = prepare_nop;
		2332	coroapi.prepare_schedule = prepare_schedule;
		2333	coroapi.prepare_cede = prepare_cede;
		2334	coroapi.prepare_cede_notself = prepare_cede_notself;
1849		2335
1850	{	2336	{
1851	SV **svp = hv_fetch (PL_modglobal, "Time::NVtime", 12, 0);	2337	SV **svp = hv_fetch (PL_modglobal, "Time::NVtime", 12, 0);
1852		2338
1853	if (!svp) croak ("Time::HiRes is required");	2339	if (!svp) croak ("Time::HiRes is required");
…		…
1886	av_push (coro->args, newSVsv (ST (i)));	2372	av_push (coro->args, newSVsv (ST (i)));
1887	}	2373	}
1888	OUTPUT:	2374	OUTPUT:
1889	RETVAL	2375	RETVAL
1890		2376
1891	# these not obviously related functions are all rolled into the same xs
1892	# function to increase chances that they all will call transfer with the same
1893	# stack offset
1894	void	2377	void
1895	_set_stacklevel (...)	2378	transfer (...)
1896	ALIAS:	2379	PROTOTYPE: $$
1897	Coro::State::transfer = 1	2380	CODE:
1898	Coro::schedule = 2	2381	CORO_EXECUTE_SLF_XS (slf_init_transfer);
1899	Coro::cede = 3
1900	Coro::cede_notself = 4
1901	CODE:
1902	{
1903	struct transfer_args ta;
1904
1905	PUTBACK;
1906	switch (ix)
1907	{
1908	case 0:
1909	prepare_set_stacklevel (&ta, (struct coro_cctx *)SvIV (ST (0)));
1910	break;
1911
1912	case 1:
1913	if (items != 2)
1914	croak ("Coro::State::transfer (prev, next) expects two arguments, not %d", items);
1915
1916	prepare_transfer (aTHX_ &ta, ST (0), ST (1));
1917	break;
1918
1919	case 2:
1920	prepare_schedule (aTHX_ &ta);
1921	break;
1922
1923	case 3:
1924	prepare_cede (aTHX_ &ta);
1925	break;
1926
1927	case 4:
1928	if (!prepare_cede_notself (aTHX_ &ta))
1929	XSRETURN_EMPTY;
1930
1931	break;
1932	}
1933	SPAGAIN;
1934
1935	BARRIER;
1936	PUTBACK;
1937	TRANSFER (ta, 0);
1938	SPAGAIN; /* might be the sp of a different coroutine now */
1939	/* be extra careful not to ever do anything after TRANSFER */
1940	}
1941		2382
1942	bool	2383	bool
1943	_destroy (SV *coro_sv)	2384	_destroy (SV *coro_sv)
1944	CODE:	2385	CODE:
1945	RETVAL = coro_state_destroy (aTHX_ SvSTATE (coro_sv));	2386	RETVAL = coro_state_destroy (aTHX_ SvSTATE (coro_sv));
…		…
1952	CODE:	2393	CODE:
1953	_exit (code);	2394	_exit (code);
1954		2395
1955	int	2396	int
1956	cctx_stacksize (int new_stacksize = 0)	2397	cctx_stacksize (int new_stacksize = 0)
		2398	PROTOTYPE: ;$
1957	CODE:	2399	CODE:
1958	RETVAL = cctx_stacksize;	2400	RETVAL = cctx_stacksize;
1959	if (new_stacksize)	2401	if (new_stacksize)
1960	{	2402	{
1961	cctx_stacksize = new_stacksize;	2403	cctx_stacksize = new_stacksize;
…		…
1964	OUTPUT:	2406	OUTPUT:
1965	RETVAL	2407	RETVAL
1966		2408
1967	int	2409	int
1968	cctx_max_idle (int max_idle = 0)	2410	cctx_max_idle (int max_idle = 0)
		2411	PROTOTYPE: ;$
1969	CODE:	2412	CODE:
1970	RETVAL = cctx_max_idle;	2413	RETVAL = cctx_max_idle;
1971	if (max_idle > 1)	2414	if (max_idle > 1)
1972	cctx_max_idle = max_idle;	2415	cctx_max_idle = max_idle;
1973	OUTPUT:	2416	OUTPUT:
1974	RETVAL	2417	RETVAL
1975		2418
1976	int	2419	int
1977	cctx_count ()	2420	cctx_count ()
		2421	PROTOTYPE:
1978	CODE:	2422	CODE:
1979	RETVAL = cctx_count;	2423	RETVAL = cctx_count;
1980	OUTPUT:	2424	OUTPUT:
1981	RETVAL	2425	RETVAL
1982		2426
1983	int	2427	int
1984	cctx_idle ()	2428	cctx_idle ()
		2429	PROTOTYPE:
1985	CODE:	2430	CODE:
1986	RETVAL = cctx_idle;	2431	RETVAL = cctx_idle;
1987	OUTPUT:	2432	OUTPUT:
1988	RETVAL	2433	RETVAL
1989		2434
1990	void	2435	void
1991	list ()	2436	list ()
		2437	PROTOTYPE:
1992	PPCODE:	2438	PPCODE:
1993	{	2439	{
1994	struct coro *coro;	2440	struct coro *coro;
1995	for (coro = coro_first; coro; coro = coro->next)	2441	for (coro = coro_first; coro; coro = coro->next)
1996	if (coro->hv)	2442	if (coro->hv)
…		…
2058		2504
2059	void	2505	void
2060	throw (Coro::State self, SV *throw = &PL_sv_undef)	2506	throw (Coro::State self, SV *throw = &PL_sv_undef)
2061	PROTOTYPE: $;$	2507	PROTOTYPE: $;$
2062	CODE:	2508	CODE:
		2509	{
		2510	struct coro *current = SvSTATE_current;
		2511	SV **throwp = self == current ? &coro_throw : &self->throw;
2063	SvREFCNT_dec (self->throw);	2512	SvREFCNT_dec (*throwp);
2064	self->throw = SvOK (throw) ? newSVsv (throw) : 0;	2513	*throwp = SvOK (throw) ? newSVsv (throw) : 0;
		2514	}
2065		2515
2066	void	2516	void
2067	api_trace (SV *coro, int flags = CC_TRACE | CC_TRACE_SUB)	2517	api_trace (SV *coro, int flags = CC_TRACE | CC_TRACE_SUB)
		2518	PROTOTYPE: $;$
		2519	C_ARGS: aTHX_ coro, flags
2068		2520
2069	SV *	2521	SV *
2070	has_cctx (Coro::State coro)	2522	has_cctx (Coro::State coro)
2071	PROTOTYPE: $	2523	PROTOTYPE: $
2072	CODE:	2524	CODE:
…		…
2096	OUTPUT:	2548	OUTPUT:
2097	RETVAL	2549	RETVAL
2098		2550
2099	void	2551	void
2100	force_cctx ()	2552	force_cctx ()
		2553	PROTOTYPE:
2101	CODE:	2554	CODE:
2102	struct coro *coro = SvSTATE (coro_current);
2103	coro->cctx->idle_sp = 0;	2555	SvSTATE_current->cctx->idle_sp = 0;
2104		2556
2105	void	2557	void
2106	swap_defsv (Coro::State self)	2558	swap_defsv (Coro::State self)
2107	PROTOTYPE: $	2559	PROTOTYPE: $
2108	ALIAS:	2560	ALIAS:
2109	swap_defav = 1	2561	swap_defav = 1
2110	CODE:	2562	CODE:
2111	if (!self->slot)	2563	if (!self->slot)
2112	croak ("cannot swap state with coroutine that has no saved state");	2564	croak ("cannot swap state with coroutine that has no saved state,");
2113	else	2565	else
2114	{	2566	{
2115	SV **src = ix ? (SV **)&GvAV (PL_defgv) : &GvSV (PL_defgv);	2567	SV **src = ix ? (SV **)&GvAV (PL_defgv) : &GvSV (PL_defgv);
2116	SV **dst = ix ? (SV **)&self->slot->defav : (SV **)&self->slot->defsv;	2568	SV **dst = ix ? (SV **)&self->slot->defav : (SV **)&self->slot->defsv;
2117		2569
2118	SV *tmp = *src; *src = *dst; *dst = tmp;	2570	SV *tmp = *src; *src = *dst; *dst = tmp;
2119	}	2571	}
		2572
2120		2573
2121	MODULE = Coro::State PACKAGE = Coro	2574	MODULE = Coro::State PACKAGE = Coro
2122		2575
2123	BOOT:	2576	BOOT:
2124	{	2577	{
…		…
2142		2595
2143	for (i = PRIO_MAX - PRIO_MIN + 1; i--; )	2596	for (i = PRIO_MAX - PRIO_MIN + 1; i--; )
2144	coro_ready[i] = newAV ();	2597	coro_ready[i] = newAV ();
2145		2598
2146	{	2599	{
2147	SV *sv = perl_get_sv ("Coro::API", TRUE);	2600	SV *sv = coro_get_sv (aTHX_ "Coro::API", TRUE);
2148	perl_get_sv ("Coro::API", TRUE); /* silence 5.10 warning */
2149		2601
2150	coroapi.schedule = api_schedule;	2602	coroapi.schedule = api_schedule;
2151	coroapi.cede = api_cede;	2603	coroapi.cede = api_cede;
2152	coroapi.cede_notself = api_cede_notself;	2604	coroapi.cede_notself = api_cede_notself;
2153	coroapi.ready = api_ready;	2605	coroapi.ready = api_ready;
2154	coroapi.is_ready = api_is_ready;	2606	coroapi.is_ready = api_is_ready;
2155	coroapi.nready = &coro_nready;	2607	coroapi.nready = coro_nready;
2156	coroapi.current = coro_current;	2608	coroapi.current = coro_current;
2157		2609
2158	GCoroAPI = &coroapi;	2610	GCoroAPI = &coroapi;
2159	sv_setiv (sv, (IV)&coroapi);	2611	sv_setiv (sv, (IV)&coroapi);
2160	SvREADONLY_on (sv);	2612	SvREADONLY_on (sv);
2161	}	2613	}
2162	}	2614	}
		2615
		2616	void
		2617	schedule (...)
		2618	CODE:
		2619	CORO_EXECUTE_SLF_XS (slf_init_schedule);
		2620
		2621	void
		2622	cede (...)
		2623	CODE:
		2624	CORO_EXECUTE_SLF_XS (slf_init_cede);
		2625
		2626	void
		2627	cede_notself (...)
		2628	CODE:
		2629	CORO_EXECUTE_SLF_XS (slf_init_cede_notself);
2163		2630
2164	void	2631	void
2165	_set_current (SV *current)	2632	_set_current (SV *current)
2166	PROTOTYPE: $	2633	PROTOTYPE: $
2167	CODE:	2634	CODE:
…		…
2170		2637
2171	void	2638	void
2172	_set_readyhook (SV *hook)	2639	_set_readyhook (SV *hook)
2173	PROTOTYPE: $	2640	PROTOTYPE: $
2174	CODE:	2641	CODE:
2175	LOCK;
2176	SvREFCNT_dec (coro_readyhook);	2642	SvREFCNT_dec (coro_readyhook);
2177	coro_readyhook = SvOK (hook) ? newSVsv (hook) : 0;	2643	coro_readyhook = SvOK (hook) ? newSVsv (hook) : 0;
2178	UNLOCK;
2179		2644
2180	int	2645	int
2181	prio (Coro::State coro, int newprio = 0)	2646	prio (Coro::State coro, int newprio = 0)
		2647	PROTOTYPE: $;$
2182	ALIAS:	2648	ALIAS:
2183	nice = 1	2649	nice = 1
2184	CODE:	2650	CODE:
2185	{	2651	{
2186	RETVAL = coro->prio;	2652	RETVAL = coro->prio;
…		…
2201		2667
2202	SV *	2668	SV *
2203	ready (SV *self)	2669	ready (SV *self)
2204	PROTOTYPE: $	2670	PROTOTYPE: $
2205	CODE:	2671	CODE:
2206	RETVAL = boolSV (api_ready (self));	2672	RETVAL = boolSV (api_ready (aTHX_ self));
2207	OUTPUT:	2673	OUTPUT:
2208	RETVAL	2674	RETVAL
2209		2675
2210	int	2676	int
2211	nready (...)	2677	nready (...)
…		…
2218	# for async_pool speedup	2684	# for async_pool speedup
2219	void	2685	void
2220	_pool_1 (SV *cb)	2686	_pool_1 (SV *cb)
2221	CODE:	2687	CODE:
2222	{	2688	{
2223	struct coro *coro = SvSTATE (coro_current);
2224	HV *hv = (HV *)SvRV (coro_current);	2689	HV *hv = (HV *)SvRV (coro_current);
		2690	struct coro *coro = SvSTATE_hv ((SV *)hv);
2225	AV *defav = GvAV (PL_defgv);	2691	AV *defav = GvAV (PL_defgv);
2226	SV *invoke = hv_delete (hv, "_invoke", sizeof ("_invoke") - 1, 0);	2692	SV *invoke = hv_delete (hv, "_invoke", sizeof ("_invoke") - 1, 0);
2227	AV *invoke_av;	2693	AV *invoke_av;
2228	int i, len;	2694	int i, len;
2229		2695
…		…
2250	{	2716	{
2251	av_fill (defav, len - 1);	2717	av_fill (defav, len - 1);
2252	for (i = 0; i < len; ++i)	2718	for (i = 0; i < len; ++i)
2253	av_store (defav, i, SvREFCNT_inc_NN (AvARRAY (invoke_av)[i + 1]));	2719	av_store (defav, i, SvREFCNT_inc_NN (AvARRAY (invoke_av)[i + 1]));
2254	}	2720	}
2255
2256	SvREFCNT_dec (invoke);
2257	}	2721	}
2258		2722
2259	void	2723	void
2260	_pool_2 (SV *cb)	2724	_pool_2 (SV *cb)
2261	CODE:	2725	CODE:
2262	{	2726	{
2263	struct coro *coro = SvSTATE (coro_current);	2727	HV *hv = (HV *)SvRV (coro_current);
		2728	struct coro *coro = SvSTATE_hv ((SV *)hv);
2264		2729
2265	sv_setsv (cb, &PL_sv_undef);	2730	sv_setsv (cb, &PL_sv_undef);
2266		2731
2267	SvREFCNT_dec ((SV *)PL_defoutgv); PL_defoutgv = (GV *)coro->saved_deffh;	2732	SvREFCNT_dec ((SV *)PL_defoutgv); PL_defoutgv = (GV *)coro->saved_deffh;
2268	coro->saved_deffh = 0;	2733	coro->saved_deffh = 0;
…		…
2275	SvREFCNT_dec (old);	2740	SvREFCNT_dec (old);
2276	croak ("\3async_pool terminate\2\n");	2741	croak ("\3async_pool terminate\2\n");
2277	}	2742	}
2278		2743
2279	av_clear (GvAV (PL_defgv));	2744	av_clear (GvAV (PL_defgv));
2280	hv_store ((HV *)SvRV (coro_current), "desc", sizeof ("desc") - 1,	2745	hv_store (hv, "desc", sizeof ("desc") - 1,
2281	newSVpvn ("[async_pool idle]", sizeof ("[async_pool idle]") - 1), 0);	2746	newSVpvn ("[async_pool idle]", sizeof ("[async_pool idle]") - 1), 0);
2282		2747
2283	coro->prio = 0;	2748	coro->prio = 0;
2284		2749
2285	if (coro->cctx && (coro->cctx->flags & CC_TRACE))	2750	if (coro->cctx && (coro->cctx->flags & CC_TRACE))
2286	api_trace (coro_current, 0);	2751	api_trace (aTHX_ coro_current, 0);
2287		2752
2288	av_push (av_async_pool, newSVsv (coro_current));	2753	av_push (av_async_pool, newSVsv (coro_current));
2289	}	2754	}
2290		2755
2291	#if 0
2292		2756
2293	void	2757	MODULE = Coro::State PACKAGE = PerlIO::cede
2294	_generator_call (...)	2758
2295	PROTOTYPE: @	2759	BOOT:
2296	PPCODE:	2760	PerlIO_define_layer (aTHX_ &PerlIO_cede);
2297	fprintf (stderr, "call %p\n", CvXSUBANY(cv).any_ptr);	2761
2298	xxxx	2762
2299	abort ();	2763	MODULE = Coro::State PACKAGE = Coro::Semaphore
2300		2764
2301	SV *	2765	SV *
2302	gensub (SV *sub, ...)	2766	new (SV *klass, SV *count_ = 0)
2303	PROTOTYPE: &;@	2767	CODE:
2304	CODE:
2305	{	2768	{
2306	struct coro *coro;	2769	/* a semaphore contains a counter IV in $sem->[0] and any waiters after that */
2307	MAGIC *mg;	2770	AV *av = newAV ();
2308	CV *xcv;	2771	SV **ary;
2309	CV *ncv = (CV *)newSV_type (SVt_PVCV);
2310	int i;
2311		2772
2312	CvGV (ncv) = CvGV (cv);	2773	/* unfortunately, building manually saves memory */
2313	CvFILE (ncv) = CvFILE (cv);	2774	Newx (ary, 2, SV *);
		2775	AvALLOC (av) = ary;
		2776	AvARRAY (av) = ary;
		2777	AvMAX (av) = 1;
		2778	AvFILLp (av) = 0;
		2779	ary [0] = newSViv (count_ && SvOK (count_) ? SvIV (count_) : 1);
2314		2780
2315	Newz (0, coro, 1, struct coro);	2781	RETVAL = sv_bless (newRV_noinc ((SV *)av), GvSTASH (CvGV (cv)));
2316	coro->args = newAV ();
2317	coro->flags = CF_NEW;
2318
2319	av_extend (coro->args, items - 1);
2320	for (i = 1; i < items; i++)
2321	av_push (coro->args, newSVsv (ST (i)));
2322
2323	CvISXSUB_on (ncv);
2324	CvXSUBANY (ncv).any_ptr = (void *)coro;
2325
2326	xcv = GvCV (gv_fetchpv ("Coro::_generator_call", 0, SVt_PVCV));
2327
2328	CvXSUB (ncv) = CvXSUB (xcv);
2329	CvANON_on (ncv);
2330
2331	mg = sv_magicext ((SV *)ncv, 0, CORO_MAGIC_type_state, &coro_gensub_vtbl, (char *)coro, 0);
2332	RETVAL = newRV_noinc ((SV *)ncv);
2333	}	2782	}
2334	OUTPUT:	2783	OUTPUT:
2335	RETVAL	2784	RETVAL
2336		2785
2337	#endif	2786	SV *
2338		2787	count (SV *self)
2339		2788	CODE:
2340	MODULE = Coro::State PACKAGE = Coro::AIO	2789	RETVAL = newSVsv (AvARRAY ((AV *)SvRV (self))[0]);
		2790	OUTPUT:
		2791	RETVAL
2341		2792
2342	void	2793	void
2343	_get_state (SV *self)	2794	up (SV *self, int adjust = 1)
2344	PPCODE:	2795	ALIAS:
2345	{	2796	adjust = 1
2346	AV *defav = GvAV (PL_defgv);	2797	CODE:
2347	AV *av = newAV ();	2798	coro_semaphore_adjust (aTHX_ (AV *)SvRV (self), ix ? adjust : 1);
2348	int i;
2349	SV *data_sv = newSV (sizeof (struct io_state));
2350	struct io_state *data = (struct io_state *)SvPVX (data_sv);
2351	SvCUR_set (data_sv, sizeof (struct io_state));
2352	SvPOK_only (data_sv);
2353
2354	data->errorno = errno;
2355	data->laststype = PL_laststype;
2356	data->laststatval = PL_laststatval;
2357	data->statcache = PL_statcache;
2358
2359	av_extend (av, AvFILLp (defav) + 1 + 1);
2360
2361	for (i = 0; i <= AvFILLp (defav); ++i)
2362	av_push (av, SvREFCNT_inc_NN (AvARRAY (defav)[i]));
2363
2364	av_push (av, data_sv);
2365
2366	XPUSHs (sv_2mortal (newRV_noinc ((SV *)av)));
2367
2368	api_ready (self);
2369	}
2370		2799
2371	void	2800	void
2372	_set_state (SV *state)	2801	down (SV *self)
2373	PROTOTYPE: $	2802	CODE:
2374	PPCODE:	2803	CORO_EXECUTE_SLF_XS (slf_init_semaphore_down);
		2804
		2805	void
		2806	try (SV *self)
		2807	PPCODE:
2375	{	2808	{
2376	AV *av = (AV *)SvRV (state);	2809	AV *av = (AV *)SvRV (self);
2377	struct io_state *data = (struct io_state *)SvPVX (AvARRAY (av)[AvFILLp (av)]);	2810	SV *count_sv = AvARRAY (av)[0];
		2811	IV count = SvIVX (count_sv);
		2812
		2813	if (count > 0)
		2814	{
		2815	--count;
		2816	SvIVX (count_sv) = count;
		2817	XSRETURN_YES;
		2818	}
		2819	else
		2820	XSRETURN_NO;
		2821	}
		2822
		2823	void
		2824	waiters (SV *self)
		2825	CODE:
		2826	{
		2827	AV *av = (AV *)SvRV (self);
		2828
		2829	if (GIMME_V == G_SCALAR)
		2830	XPUSHs (sv_2mortal (newSVsv (AvARRAY (av)[0])));
		2831	else
		2832	{
2378	int i;	2833	int i;
2379
2380	errno = data->errorno;
2381	PL_laststype = data->laststype;
2382	PL_laststatval = data->laststatval;
2383	PL_statcache = data->statcache;
2384
2385	EXTEND (SP, AvFILLp (av));	2834	EXTEND (SP, AvFILLp (av) + 1 - 1);
2386	for (i = 0; i < AvFILLp (av); ++i)	2835	for (i = 1; i <= AvFILLp (av); ++i)
2387	PUSHs (sv_2mortal (SvREFCNT_inc_NN (AvARRAY (av)[i])));	2836	PUSHs (sv_2mortal (newRV_inc (AvARRAY (av)[i])));
		2837	}
2388	}	2838	}
2389		2839
2390		2840
2391	MODULE = Coro::State PACKAGE = Coro::AnyEvent	2841	MODULE = Coro::State PACKAGE = Coro::AnyEvent
2392		2842
2393	BOOT:	2843	BOOT:
2394	sv_activity = coro_get_sv (aTHX_ "Coro::AnyEvent::ACTIVITY", TRUE);	2844	sv_activity = coro_get_sv (aTHX_ "Coro::AnyEvent::ACTIVITY", TRUE);
2395		2845
2396	SV *	2846	void
2397	_schedule (...)	2847	_schedule (...)
2398	PROTOTYPE: @
2399	CODE:	2848	CODE:
2400	{	2849	{
2401	static int incede;	2850	static int incede;
2402		2851
2403	api_cede_notself ();	2852	api_cede_notself (aTHX);
2404		2853
2405	++incede;	2854	++incede;
2406	while (coro_nready >= incede && api_cede ())	2855	while (coro_nready >= incede && api_cede (aTHX))
2407	;	2856	;
2408		2857
2409	sv_setsv (sv_activity, &PL_sv_undef);	2858	sv_setsv (sv_activity, &PL_sv_undef);
2410	if (coro_nready >= incede)	2859	if (coro_nready >= incede)
2411	{	2860	{
2412	PUSHMARK (SP);	2861	PUSHMARK (SP);
2413	PUTBACK;	2862	PUTBACK;
2414	call_pv ("Coro::AnyEvent::_activity", G_DISCARD | G_EVAL);	2863	call_pv ("Coro::AnyEvent::_activity", G_KEEPERR | G_EVAL | G_VOID | G_DISCARD);
2415	SPAGAIN;
2416	}	2864	}
2417		2865
2418	--incede;	2866	--incede;
2419	}	2867	}
2420		2868
2421		2869
2422	MODULE = Coro::State PACKAGE = PerlIO::cede	2870	MODULE = Coro::State PACKAGE = Coro::AIO
2423		2871
2424	BOOT:	2872	void
2425	PerlIO_define_layer (aTHX_ &PerlIO_cede);	2873	_register (char *target, char *proto, SV *req)
		2874	CODE:
		2875	{
		2876	HV *st;
		2877	GV *gvp;
		2878	CV *req_cv = sv_2cv (req, &st, &gvp, 0);
		2879	/* newXSproto doesn't return the CV on 5.8 */
		2880	CV *slf_cv = newXS (target, coro_aio_req_xs, __FILE__);
		2881	sv_setpv ((SV *)slf_cv, proto);
		2882	sv_magicext ((SV *)slf_cv, (SV *)req_cv, CORO_MAGIC_type_aio, 0, 0, 0);
		2883	}
		2884

Diff Legend

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