ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/EV/EV.xs
Revision: 1.123
Committed: Sat Apr 25 14:12:48 2009 UTC (15 years ago) by root
Branch: MAIN
CVS Tags: rel-3_6
Changes since 1.122: +17 -2 lines
Log Message:
*** empty log message ***

File Contents

# Content
1 #include "EXTERN.h"
2 #include "perl.h"
3 #include "XSUB.h"
4
5 /*#include <netinet/in.h>*/
6
7 /* fix perl api breakage */
8 #undef signal
9 #undef sigaction
10
11 #define EV_PROTOTYPES 1
12 #define EV_USE_NANOSLEEP EV_USE_MONOTONIC
13 #define EV_H <ev.h>
14 #include "EV/EVAPI.h"
15
16 #define EV_SELECT_IS_WINSOCKET 0
17 #ifdef _WIN32
18 # define EV_SELECT_USE_FD_SET 0
19 # define NFDBITS PERL_NFDBITS
20 # define fd_mask Perl_fd_mask
21 #endif
22 /* due to bugs in OS X we have to use libev/ explicitly here */
23 #include "libev/ev.c"
24
25 #ifndef _WIN32
26 # include <pthread.h>
27 #endif
28
29 /* 5.10.0 */
30 #ifndef SvREFCNT_inc_NN
31 # define SvREFCNT_inc_NN(sv) SvREFCNT_inc (sv)
32 #endif
33
34 /* 5.6.x */
35 #ifndef SvRV_set
36 # define SvRV_set(a,b) SvRV ((a)) = (b)
37 #endif
38
39 #if __GNUC__ >= 3
40 # define expect(expr,value) __builtin_expect ((expr),(value))
41 #else
42 # define expect(expr,value) (expr)
43 #endif
44
45 #define expect_false(expr) expect ((expr) != 0, 0)
46 #define expect_true(expr) expect ((expr) != 0, 1)
47
48 #define e_loop(w) INT2PTR (struct ev_loop *, SvIVX ((w)->loop))
49
50 #define WFLAG_KEEPALIVE 1
51 #define WFLAG_UNREFED 2 /* has been unref'ed */
52
53 #define UNREF(w) \
54 if (!((w)->e_flags & (WFLAG_KEEPALIVE | WFLAG_UNREFED)) \
55 && ev_is_active (w)) \
56 { \
57 ev_unref (e_loop (w)); \
58 (w)->e_flags |= WFLAG_UNREFED; \
59 }
60
61 #define REF(w) \
62 if ((w)->e_flags & WFLAG_UNREFED) \
63 { \
64 (w)->e_flags &= ~WFLAG_UNREFED; \
65 ev_ref (e_loop (w)); \
66 }
67
68 #define START(type,w) \
69 do { \
70 ev_ ## type ## _start (e_loop (w), w); \
71 UNREF (w); \
72 } while (0)
73
74 #define STOP(type,w) \
75 do { \
76 REF (w); \
77 ev_ ## type ## _stop (e_loop (w), w); \
78 } while (0)
79
80 #define RESET(type,w,seta) \
81 do { \
82 int active = ev_is_active (w); \
83 if (active) STOP (type, w); \
84 ev_ ## type ## _set seta; \
85 if (active) START (type, w); \
86 } while (0)
87
88 typedef int Signal;
89
90 static SV *default_loop_sv;
91
92 static struct EVAPI evapi;
93
94 static HV
95 *stash_loop,
96 *stash_watcher,
97 *stash_io,
98 *stash_timer,
99 *stash_periodic,
100 *stash_signal,
101 *stash_child,
102 *stash_stat,
103 *stash_idle,
104 *stash_prepare,
105 *stash_check,
106 *stash_embed,
107 *stash_fork,
108 *stash_async;
109
110 #ifndef SIG_SIZE
111 /* kudos to Slaven Rezic for the idea */
112 static char sig_size [] = { SIG_NUM };
113 # define SIG_SIZE (sizeof (sig_size) + 1)
114 #endif
115
116 static Signal
117 sv_signum (SV *sig)
118 {
119 Signal signum;
120
121 SvGETMAGIC (sig);
122
123 for (signum = 1; signum < SIG_SIZE; ++signum)
124 if (strEQ (SvPV_nolen (sig), PL_sig_name [signum]))
125 return signum;
126
127 signum = SvIV (sig);
128
129 if (signum > 0 && signum < SIG_SIZE)
130 return signum;
131
132 return -1;
133 }
134
135 /////////////////////////////////////////////////////////////////////////////
136 // Event
137
138 static void e_cb (EV_P_ ev_watcher *w, int revents);
139
140 static int
141 sv_fileno (SV *fh)
142 {
143 SvGETMAGIC (fh);
144
145 if (SvROK (fh))
146 fh = SvRV (fh);
147
148 if (SvTYPE (fh) == SVt_PVGV)
149 return PerlIO_fileno (IoIFP (sv_2io (fh)));
150
151 if (SvOK (fh) && (SvIV (fh) >= 0) && (SvIV (fh) < 0x7fffffffL))
152 return SvIV (fh);
153
154 return -1;
155 }
156
157 static SV *
158 e_get_cv (SV *cb_sv)
159 {
160 HV *st;
161 GV *gvp;
162 CV *cv = sv_2cv (cb_sv, &st, &gvp, 0);
163
164 if (!cv)
165 croak ("EV watcher callback must be a CODE reference");
166
167 return (SV *)cv;
168 }
169
170 static void *
171 e_new (int size, SV *cb_sv, SV *loop)
172 {
173 SV *cv = cb_sv ? e_get_cv (cb_sv) : 0;
174 ev_watcher *w;
175 SV *self = NEWSV (0, size);
176 SvPOK_only (self);
177 SvCUR_set (self, size);
178
179 w = (ev_watcher *)SvPVX (self);
180
181 ev_init (w, cv ? e_cb : 0);
182
183 w->loop = SvREFCNT_inc (SvRV (loop));
184 w->e_flags = WFLAG_KEEPALIVE;
185 w->data = 0;
186 w->fh = 0;
187 w->cb_sv = SvREFCNT_inc (cv);
188 w->self = self;
189
190 return (void *)w;
191 }
192
193 static void
194 e_destroy (void *w_)
195 {
196 ev_watcher *w = (ev_watcher *)w_;
197
198 SvREFCNT_dec (w->loop ); w->loop = 0;
199 SvREFCNT_dec (w->fh ); w->fh = 0;
200 SvREFCNT_dec (w->cb_sv); w->cb_sv = 0;
201 SvREFCNT_dec (w->data ); w->data = 0;
202 }
203
204 static SV *
205 e_bless (ev_watcher *w, HV *stash)
206 {
207 SV *rv;
208
209 if (SvOBJECT (w->self))
210 rv = newRV_inc (w->self);
211 else
212 {
213 rv = newRV_noinc (w->self);
214 sv_bless (rv, stash);
215 SvREADONLY_on (w->self);
216 }
217
218 return rv;
219 }
220
221 static SV *sv_self_cache, *sv_events_cache;
222
223 static void
224 e_cb (EV_P_ ev_watcher *w, int revents)
225 {
226 dSP;
227 I32 mark = SP - PL_stack_base;
228 SV *sv_self, *sv_events;
229
230 /* libev might have stopped the watcher */
231 if (expect_false (w->e_flags & WFLAG_UNREFED)
232 && !ev_is_active (w))
233 REF (w);
234
235 if (expect_true (sv_self_cache))
236 {
237 sv_self = sv_self_cache; sv_self_cache = 0;
238 SvRV_set (sv_self, SvREFCNT_inc_NN (w->self));
239 }
240 else
241 {
242 sv_self = newRV_inc (w->self); /* w->self MUST be blessed by now */
243 SvREADONLY_on (sv_self);
244 }
245
246 if (expect_true (sv_events_cache))
247 {
248 sv_events = sv_events_cache; sv_events_cache = 0;
249 SvIV_set (sv_events, revents);
250 }
251 else
252 {
253 sv_events = newSViv (revents);
254 SvREADONLY_on (sv_events);
255 }
256
257 PUSHMARK (SP);
258 EXTEND (SP, 2);
259 PUSHs (sv_self);
260 PUSHs (sv_events);
261
262 PUTBACK;
263 call_sv (w->cb_sv, G_DISCARD | G_VOID | G_EVAL);
264
265 if (expect_false (SvREFCNT (sv_self) != 1 || sv_self_cache))
266 SvREFCNT_dec (sv_self);
267 else
268 {
269 SvREFCNT_dec (SvRV (sv_self));
270 SvRV_set (sv_self, &PL_sv_undef);
271 sv_self_cache = sv_self;
272 }
273
274 if (expect_false (SvREFCNT (sv_events) != 1 || sv_events_cache))
275 SvREFCNT_dec (sv_events);
276 else
277 sv_events_cache = sv_events;
278
279 if (expect_false (SvTRUE (ERRSV)))
280 {
281 SPAGAIN;
282 PUSHMARK (SP);
283 PUTBACK;
284 call_sv (get_sv ("EV::DIED", 1), G_DISCARD | G_VOID | G_EVAL | G_KEEPERR);
285 }
286
287 SP = PL_stack_base + mark;
288 PUTBACK;
289 }
290
291 static void
292 e_once_cb (int revents, void *arg)
293 {
294 dSP;
295 I32 mark = SP - PL_stack_base;
296 SV *sv_events;
297
298 if (sv_events_cache)
299 {
300 sv_events = sv_events_cache; sv_events_cache = 0;
301 SvIV_set (sv_events, revents);
302 }
303 else
304 sv_events = newSViv (revents);
305
306 PUSHMARK (SP);
307 XPUSHs (sv_events);
308
309 PUTBACK;
310 call_sv ((SV *)arg, G_DISCARD | G_VOID | G_EVAL);
311
312 SvREFCNT_dec ((SV *)arg);
313
314 if (sv_events_cache)
315 SvREFCNT_dec (sv_events);
316 else
317 sv_events_cache = sv_events;
318
319 if (SvTRUE (ERRSV))
320 {
321 SPAGAIN;
322 PUSHMARK (SP);
323 PUTBACK;
324 call_sv (get_sv ("EV::DIED", 1), G_DISCARD | G_VOID | G_EVAL | G_KEEPERR);
325 }
326
327 SP = PL_stack_base + mark;
328 PUTBACK;
329 }
330
331 static ev_tstamp
332 e_periodic_cb (ev_periodic *w, ev_tstamp now)
333 {
334 ev_tstamp retval;
335 int count;
336 dSP;
337
338 ENTER;
339 SAVETMPS;
340
341 PUSHMARK (SP);
342 EXTEND (SP, 2);
343 PUSHs (newRV_inc (w->self)); /* w->self MUST be blessed by now */
344 PUSHs (newSVnv (now));
345
346 PUTBACK;
347 count = call_sv (w->fh, G_SCALAR | G_EVAL);
348 SPAGAIN;
349
350 if (SvTRUE (ERRSV))
351 {
352 PUSHMARK (SP);
353 PUTBACK;
354 call_sv (get_sv ("EV::DIED", 1), G_DISCARD | G_VOID | G_EVAL | G_KEEPERR);
355 SPAGAIN;
356 }
357
358 if (count > 0)
359 {
360 retval = SvNV (TOPs);
361
362 if (retval < now)
363 retval = now;
364 }
365 else
366 retval = now;
367
368 FREETMPS;
369 LEAVE;
370
371 return retval;
372 }
373
374 #define CHECK_REPEAT(repeat) if (repeat < 0.) \
375 croak (# repeat " value must be >= 0");
376
377 #define CHECK_FD(fh,fd) if ((fd) < 0) \
378 croak ("illegal file descriptor or filehandle (either no attached file descriptor or illegal value): %s", SvPV_nolen (fh));
379
380 #define CHECK_SIG(sv,num) if ((num) < 0) \
381 croak ("illegal signal number or name: %s", SvPV_nolen (sv));
382
383 /////////////////////////////////////////////////////////////////////////////
384 // XS interface functions
385
386 MODULE = EV PACKAGE = EV PREFIX = ev_
387
388 PROTOTYPES: ENABLE
389
390 BOOT:
391 {
392 HV *stash = gv_stashpv ("EV", 1);
393
394 static const struct {
395 const char *name;
396 IV iv;
397 } *civ, const_iv[] = {
398 # define const_iv(pfx, name) { # name, (IV) pfx ## name },
399 const_iv (EV_, MINPRI)
400 const_iv (EV_, MAXPRI)
401
402 const_iv (EV_, UNDEF)
403 const_iv (EV_, NONE)
404 const_iv (EV_, READ)
405 const_iv (EV_, WRITE)
406 const_iv (EV_, IO)
407 const_iv (EV_, TIMEOUT)
408 const_iv (EV_, TIMER)
409 const_iv (EV_, PERIODIC)
410 const_iv (EV_, SIGNAL)
411 const_iv (EV_, CHILD)
412 const_iv (EV_, STAT)
413 const_iv (EV_, IDLE)
414 const_iv (EV_, PREPARE)
415 const_iv (EV_, CHECK)
416 const_iv (EV_, EMBED)
417 const_iv (EV_, FORK)
418 const_iv (EV_, ASYNC)
419 const_iv (EV_, CUSTOM)
420 const_iv (EV_, ERROR)
421
422 const_iv (EV, LOOP_NONBLOCK)
423 const_iv (EV, LOOP_ONESHOT)
424
425 const_iv (EV, UNLOOP_CANCEL)
426 const_iv (EV, UNLOOP_ONE)
427 const_iv (EV, UNLOOP_ALL)
428
429 const_iv (EV, BACKEND_SELECT)
430 const_iv (EV, BACKEND_POLL)
431 const_iv (EV, BACKEND_EPOLL)
432 const_iv (EV, BACKEND_KQUEUE)
433 const_iv (EV, BACKEND_DEVPOLL)
434 const_iv (EV, BACKEND_PORT)
435 const_iv (EV, FLAG_AUTO)
436 const_iv (EV, FLAG_NOENV)
437 const_iv (EV, FLAG_FORKCHECK)
438
439 const_iv (EV_, VERSION_MAJOR)
440 const_iv (EV_, VERSION_MINOR)
441 };
442
443 for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
444 newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
445
446 stash_loop = gv_stashpv ("EV::Loop" , 1);
447 stash_watcher = gv_stashpv ("EV::Watcher" , 1);
448 stash_io = gv_stashpv ("EV::IO" , 1);
449 stash_timer = gv_stashpv ("EV::Timer" , 1);
450 stash_periodic = gv_stashpv ("EV::Periodic", 1);
451 stash_signal = gv_stashpv ("EV::Signal" , 1);
452 stash_idle = gv_stashpv ("EV::Idle" , 1);
453 stash_prepare = gv_stashpv ("EV::Prepare" , 1);
454 stash_check = gv_stashpv ("EV::Check" , 1);
455 stash_child = gv_stashpv ("EV::Child" , 1);
456 stash_embed = gv_stashpv ("EV::Embed" , 1);
457 stash_stat = gv_stashpv ("EV::Stat" , 1);
458 stash_fork = gv_stashpv ("EV::Fork" , 1);
459 stash_async = gv_stashpv ("EV::Async" , 1);
460
461 {
462 SV *sv = perl_get_sv ("EV::API", TRUE);
463 perl_get_sv ("EV::API", TRUE); /* silence 5.10 warning */
464
465 /* the poor man's shared library emulator */
466 evapi.ver = EV_API_VERSION;
467 evapi.rev = EV_API_REVISION;
468 evapi.sv_fileno = sv_fileno;
469 evapi.sv_signum = sv_signum;
470 evapi.supported_backends = ev_supported_backends ();
471 evapi.recommended_backends = ev_recommended_backends ();
472 evapi.embeddable_backends = ev_embeddable_backends ();
473 evapi.time_ = ev_time;
474 evapi.sleep_ = ev_sleep;
475 evapi.loop_new = ev_loop_new;
476 evapi.loop_destroy = ev_loop_destroy;
477 evapi.loop_fork = ev_loop_fork;
478 evapi.loop_count = ev_loop_count;
479 evapi.now = ev_now;
480 evapi.now_update = ev_now_update;
481 evapi.suspend = ev_suspend;
482 evapi.resume = ev_resume;
483 evapi.backend = ev_backend;
484 evapi.unloop = ev_unloop;
485 evapi.ref = ev_ref;
486 evapi.unref = ev_unref;
487 evapi.loop = ev_loop;
488 evapi.once = ev_once;
489 evapi.io_start = ev_io_start;
490 evapi.io_stop = ev_io_stop;
491 evapi.timer_start = ev_timer_start;
492 evapi.timer_stop = ev_timer_stop;
493 evapi.timer_again = ev_timer_again;
494 evapi.periodic_start = ev_periodic_start;
495 evapi.periodic_stop = ev_periodic_stop;
496 evapi.signal_start = ev_signal_start;
497 evapi.signal_stop = ev_signal_stop;
498 evapi.idle_start = ev_idle_start;
499 evapi.idle_stop = ev_idle_stop;
500 evapi.prepare_start = ev_prepare_start;
501 evapi.prepare_stop = ev_prepare_stop;
502 evapi.check_start = ev_check_start;
503 evapi.check_stop = ev_check_stop;
504 evapi.child_start = ev_child_start;
505 evapi.child_stop = ev_child_stop;
506 evapi.stat_start = ev_stat_start;
507 evapi.stat_stop = ev_stat_stop;
508 evapi.stat_stat = ev_stat_stat;
509 evapi.embed_start = ev_embed_start;
510 evapi.embed_stop = ev_embed_stop;
511 evapi.embed_sweep = ev_embed_sweep;
512 evapi.fork_start = ev_fork_start;
513 evapi.fork_stop = ev_fork_stop;
514 evapi.async_start = ev_async_start;
515 evapi.async_stop = ev_async_stop;
516 evapi.async_send = ev_async_send;
517 evapi.clear_pending = ev_clear_pending;
518 evapi.invoke = ev_invoke;
519
520 sv_setiv (sv, (IV)&evapi);
521 SvREADONLY_on (sv);
522 }
523 #ifndef _WIN32
524 pthread_atfork (0, 0, ev_default_fork);
525 #endif
526 }
527
528 SV *ev_default_loop (unsigned int flags = 0)
529 CODE:
530 {
531 if (!default_loop_sv)
532 {
533 evapi.default_loop = ev_default_loop (flags);
534
535 if (!evapi.default_loop)
536 XSRETURN_UNDEF;
537
538 default_loop_sv = sv_bless (newRV_noinc (newSViv (PTR2IV (evapi.default_loop))), stash_loop);
539 }
540
541 RETVAL = newSVsv (default_loop_sv);
542 }
543 OUTPUT:
544 RETVAL
545
546 void ev_default_destroy ()
547 CODE:
548 ev_default_destroy ();
549 SvREFCNT_dec (default_loop_sv);
550 default_loop_sv = 0;
551
552 unsigned int ev_supported_backends ()
553
554 unsigned int ev_recommended_backends ()
555
556 unsigned int ev_embeddable_backends ()
557
558 void ev_sleep (NV interval)
559
560 NV ev_time ()
561
562 NV ev_now ()
563 C_ARGS: evapi.default_loop
564
565 void ev_now_update ()
566 C_ARGS: evapi.default_loop
567
568 void ev_suspend ()
569 C_ARGS: evapi.default_loop
570
571 void ev_resume ()
572 C_ARGS: evapi.default_loop
573
574 unsigned int ev_backend ()
575 C_ARGS: evapi.default_loop
576
577 unsigned int ev_loop_count ()
578 C_ARGS: evapi.default_loop
579
580 void ev_set_io_collect_interval (NV interval)
581 C_ARGS: evapi.default_loop, interval
582
583 void ev_set_timeout_collect_interval (NV interval)
584 C_ARGS: evapi.default_loop, interval
585
586 void ev_loop (int flags = 0)
587 C_ARGS: evapi.default_loop, flags
588
589 void ev_unloop (int how = EVUNLOOP_ONE)
590 C_ARGS: evapi.default_loop, how
591
592 void ev_feed_fd_event (int fd, int revents = EV_NONE)
593 C_ARGS: evapi.default_loop, fd, revents
594
595 void ev_feed_signal_event (SV *signal)
596 CODE:
597 {
598 Signal signum = sv_signum (signal);
599 CHECK_SIG (signal, signum);
600
601 ev_feed_signal_event (evapi.default_loop, signum);
602 }
603
604 ev_io *io (SV *fh, int events, SV *cb)
605 ALIAS:
606 io_ns = 1
607 CODE:
608 {
609 int fd = sv_fileno (fh);
610 CHECK_FD (fh, fd);
611
612 RETVAL = e_new (sizeof (ev_io), cb, default_loop_sv);
613 RETVAL->fh = newSVsv (fh);
614 ev_io_set (RETVAL, fd, events);
615 if (!ix) START (io, RETVAL);
616 }
617 OUTPUT:
618 RETVAL
619
620 ev_timer *timer (NV after, NV repeat, SV *cb)
621 ALIAS:
622 timer_ns = 1
623 INIT:
624 CHECK_REPEAT (repeat);
625 CODE:
626 RETVAL = e_new (sizeof (ev_timer), cb, default_loop_sv);
627 ev_timer_set (RETVAL, after, repeat);
628 if (!ix) START (timer, RETVAL);
629 OUTPUT:
630 RETVAL
631
632 SV *periodic (NV at, NV interval, SV *reschedule_cb, SV *cb)
633 ALIAS:
634 periodic_ns = 1
635 INIT:
636 CHECK_REPEAT (interval);
637 CODE:
638 {
639 ev_periodic *w;
640 w = e_new (sizeof (ev_periodic), cb, default_loop_sv);
641 w->fh = SvTRUE (reschedule_cb) ? newSVsv (reschedule_cb) : 0;
642 ev_periodic_set (w, at, interval, w->fh ? e_periodic_cb : 0);
643 RETVAL = e_bless ((ev_watcher *)w, stash_periodic);
644 if (!ix) START (periodic, w);
645 }
646 OUTPUT:
647 RETVAL
648
649 ev_signal *signal (SV *signal, SV *cb)
650 ALIAS:
651 signal_ns = 1
652 CODE:
653 {
654 Signal signum = sv_signum (signal);
655 CHECK_SIG (signal, signum);
656
657 RETVAL = e_new (sizeof (ev_signal), cb, default_loop_sv);
658 ev_signal_set (RETVAL, signum);
659 if (!ix) START (signal, RETVAL);
660 }
661 OUTPUT:
662 RETVAL
663
664 ev_idle *idle (SV *cb)
665 ALIAS:
666 idle_ns = 1
667 CODE:
668 RETVAL = e_new (sizeof (ev_idle), cb, default_loop_sv);
669 ev_idle_set (RETVAL);
670 if (!ix) START (idle, RETVAL);
671 OUTPUT:
672 RETVAL
673
674 ev_prepare *prepare (SV *cb)
675 ALIAS:
676 prepare_ns = 1
677 CODE:
678 RETVAL = e_new (sizeof (ev_prepare), cb, default_loop_sv);
679 ev_prepare_set (RETVAL);
680 if (!ix) START (prepare, RETVAL);
681 OUTPUT:
682 RETVAL
683
684 ev_check *check (SV *cb)
685 ALIAS:
686 check_ns = 1
687 CODE:
688 RETVAL = e_new (sizeof (ev_check), cb, default_loop_sv);
689 ev_check_set (RETVAL);
690 if (!ix) START (check, RETVAL);
691 OUTPUT:
692 RETVAL
693
694 ev_fork *fork (SV *cb)
695 ALIAS:
696 fork_ns = 1
697 CODE:
698 RETVAL = e_new (sizeof (ev_fork), cb, default_loop_sv);
699 ev_fork_set (RETVAL);
700 if (!ix) START (fork, RETVAL);
701 OUTPUT:
702 RETVAL
703
704 ev_child *child (int pid, int trace, SV *cb)
705 ALIAS:
706 child_ns = 1
707 CODE:
708 RETVAL = e_new (sizeof (ev_child), cb, default_loop_sv);
709 ev_child_set (RETVAL, pid, trace);
710 if (!ix) START (child, RETVAL);
711 OUTPUT:
712 RETVAL
713
714 ev_stat *stat (SV *path, NV interval, SV *cb)
715 ALIAS:
716 stat_ns = 1
717 CODE:
718 RETVAL = e_new (sizeof (ev_stat), cb, default_loop_sv);
719 RETVAL->fh = newSVsv (path);
720 ev_stat_set (RETVAL, SvPVbyte_nolen (RETVAL->fh), interval);
721 if (!ix) START (stat, RETVAL);
722 OUTPUT:
723 RETVAL
724
725 ev_embed *embed (struct ev_loop *loop, SV *cb = 0)
726 ALIAS:
727 embed_ns = 1
728 CODE:
729 {
730 if (!(ev_backend (loop) & ev_embeddable_backends ()))
731 croak ("passed loop is not embeddable via EV::embed,");
732
733 RETVAL = e_new (sizeof (ev_embed), cb, default_loop_sv);
734 RETVAL->fh = newSVsv (ST (0));
735 ev_embed_set (RETVAL, loop);
736 if (!ix) START (embed, RETVAL);
737 }
738 OUTPUT:
739 RETVAL
740
741 ev_async *async (SV *cb)
742 ALIAS:
743 async_ns = 1
744 CODE:
745 RETVAL = e_new (sizeof (ev_async), cb, default_loop_sv);
746 ev_async_set (RETVAL);
747 if (!ix) START (async, RETVAL);
748 OUTPUT:
749 RETVAL
750
751 void once (SV *fh, int events, SV *timeout, SV *cb)
752 CODE:
753 ev_once (
754 evapi.default_loop,
755 sv_fileno (fh), events,
756 SvOK (timeout) ? SvNV (timeout) : -1.,
757 e_once_cb,
758 newSVsv (cb)
759 );
760
761 PROTOTYPES: DISABLE
762
763 MODULE = EV PACKAGE = EV::Watcher PREFIX = ev_
764
765 int ev_is_active (ev_watcher *w)
766
767 int ev_is_pending (ev_watcher *w)
768
769 void ev_invoke (ev_watcher *w, int revents = EV_NONE)
770 C_ARGS: e_loop (w), w, revents
771
772 int ev_clear_pending (ev_watcher *w)
773 C_ARGS: e_loop (w), w
774
775 void ev_feed_event (ev_watcher *w, int revents = EV_NONE)
776 C_ARGS: e_loop (w), w, revents
777
778 int keepalive (ev_watcher *w, int new_value = 0)
779 CODE:
780 {
781 RETVAL = w->e_flags & WFLAG_KEEPALIVE;
782 new_value = new_value ? WFLAG_KEEPALIVE : 0;
783
784 if (items > 1 && ((new_value ^ w->e_flags) & WFLAG_KEEPALIVE))
785 {
786 w->e_flags = (w->e_flags & ~WFLAG_KEEPALIVE) | new_value;
787 REF (w);
788 UNREF (w);
789 }
790 }
791 OUTPUT:
792 RETVAL
793
794 SV *cb (ev_watcher *w, SV *new_cb = 0)
795 CODE:
796 {
797 if (items > 1)
798 {
799 new_cb = e_get_cv (new_cb);
800 RETVAL = newRV_noinc (w->cb_sv);
801 w->cb_sv = SvREFCNT_inc (new_cb);
802 }
803 else
804 RETVAL = newRV_inc (w->cb_sv);
805 }
806 OUTPUT:
807 RETVAL
808
809 SV *data (ev_watcher *w, SV *new_data = 0)
810 CODE:
811 {
812 RETVAL = w->data ? newSVsv (w->data) : &PL_sv_undef;
813
814 if (items > 1)
815 {
816 SvREFCNT_dec (w->data);
817 w->data = newSVsv (new_data);
818 }
819 }
820 OUTPUT:
821 RETVAL
822
823 SV *loop (ev_watcher *w)
824 CODE:
825 RETVAL = newRV_inc (w->loop);
826 OUTPUT:
827 RETVAL
828
829 int priority (ev_watcher *w, int new_priority = 0)
830 CODE:
831 {
832 RETVAL = w->priority;
833
834 if (items > 1)
835 {
836 int active = ev_is_active (w);
837
838 if (active)
839 {
840 /* grrr. */
841 PUSHMARK (SP);
842 XPUSHs (ST (0));
843 PUTBACK;
844 call_method ("stop", G_DISCARD | G_VOID);
845 }
846
847 ev_set_priority (w, new_priority);
848
849 if (active)
850 {
851 PUSHMARK (SP);
852 XPUSHs (ST (0));
853 PUTBACK;
854 call_method ("start", G_DISCARD | G_VOID);
855 }
856 }
857 }
858 OUTPUT:
859 RETVAL
860
861 MODULE = EV PACKAGE = EV::IO PREFIX = ev_io_
862
863 void ev_io_start (ev_io *w)
864 CODE:
865 START (io, w);
866
867 void ev_io_stop (ev_io *w)
868 CODE:
869 STOP (io, w);
870
871 void DESTROY (ev_io *w)
872 CODE:
873 STOP (io, w);
874 e_destroy (w);
875
876 void set (ev_io *w, SV *fh, int events)
877 CODE:
878 {
879 int fd = sv_fileno (fh);
880 CHECK_FD (fh, fd);
881
882 sv_setsv (w->fh, fh);
883 RESET (io, w, (w, fd, events));
884 }
885
886 SV *fh (ev_io *w, SV *new_fh = 0)
887 CODE:
888 {
889 if (items > 1)
890 {
891 int fd = sv_fileno (new_fh);
892 CHECK_FD (new_fh, fd);
893
894 RETVAL = w->fh;
895 w->fh = newSVsv (new_fh);
896
897 RESET (io, w, (w, fd, w->events));
898 }
899 else
900 RETVAL = newSVsv (w->fh);
901 }
902 OUTPUT:
903 RETVAL
904
905 int events (ev_io *w, int new_events = EV_UNDEF)
906 CODE:
907 {
908 RETVAL = w->events;
909
910 if (items > 1)
911 RESET (io, w, (w, w->fd, new_events));
912 }
913 OUTPUT:
914 RETVAL
915
916 MODULE = EV PACKAGE = EV::Signal PREFIX = ev_signal_
917
918 void ev_signal_start (ev_signal *w)
919 CODE:
920 START (signal, w);
921
922 void ev_signal_stop (ev_signal *w)
923 CODE:
924 STOP (signal, w);
925
926 void DESTROY (ev_signal *w)
927 CODE:
928 STOP (signal, w);
929 e_destroy (w);
930
931 void set (ev_signal *w, SV *signal)
932 CODE:
933 {
934 Signal signum = sv_signum (signal);
935 CHECK_SIG (signal, signum);
936
937 RESET (signal, w, (w, signum));
938 }
939
940 int signal (ev_signal *w, SV *new_signal = 0)
941 CODE:
942 {
943 RETVAL = w->signum;
944
945 if (items > 1)
946 {
947 Signal signum = sv_signum (new_signal);
948 CHECK_SIG (new_signal, signum);
949
950 RESET (signal, w, (w, signum));
951 }
952 }
953 OUTPUT:
954 RETVAL
955
956 MODULE = EV PACKAGE = EV::Timer PREFIX = ev_timer_
957
958 void ev_timer_start (ev_timer *w)
959 INIT:
960 CHECK_REPEAT (w->repeat);
961 CODE:
962 START (timer, w);
963
964 void ev_timer_stop (ev_timer *w)
965 CODE:
966 STOP (timer, w);
967
968 void ev_timer_again (ev_timer *w)
969 INIT:
970 CHECK_REPEAT (w->repeat);
971 CODE:
972 ev_timer_again (e_loop (w), w);
973 UNREF (w);
974
975 void DESTROY (ev_timer *w)
976 CODE:
977 STOP (timer, w);
978 e_destroy (w);
979
980 void set (ev_timer *w, NV after, NV repeat = 0.)
981 INIT:
982 CHECK_REPEAT (repeat);
983 CODE:
984 RESET (timer, w, (w, after, repeat));
985
986 MODULE = EV PACKAGE = EV::Periodic PREFIX = ev_periodic_
987
988 void ev_periodic_start (ev_periodic *w)
989 INIT:
990 CHECK_REPEAT (w->interval);
991 CODE:
992 START (periodic, w);
993
994 void ev_periodic_stop (ev_periodic *w)
995 CODE:
996 STOP (periodic, w);
997
998 void ev_periodic_again (ev_periodic *w)
999 CODE:
1000 ev_periodic_again (e_loop (w), w);
1001 UNREF (w);
1002
1003 void DESTROY (ev_periodic *w)
1004 CODE:
1005 STOP (periodic, w);
1006 e_destroy (w);
1007
1008 void set (ev_periodic *w, NV at, NV interval = 0., SV *reschedule_cb = &PL_sv_undef)
1009 INIT:
1010 CHECK_REPEAT (interval);
1011 CODE:
1012 {
1013 SvREFCNT_dec (w->fh);
1014 w->fh = SvTRUE (reschedule_cb) ? newSVsv (reschedule_cb) : 0;
1015
1016 RESET (periodic, w, (w, at, interval, w->fh ? e_periodic_cb : 0));
1017 }
1018
1019 NV at (ev_periodic *w)
1020 CODE:
1021 RETVAL = ev_periodic_at (w);
1022 OUTPUT:
1023 RETVAL
1024
1025 MODULE = EV PACKAGE = EV::Idle PREFIX = ev_idle_
1026
1027 void ev_idle_start (ev_idle *w)
1028 CODE:
1029 START (idle, w);
1030
1031 void ev_idle_stop (ev_idle *w)
1032 CODE:
1033 STOP (idle, w);
1034
1035 void DESTROY (ev_idle *w)
1036 CODE:
1037 STOP (idle, w);
1038 e_destroy (w);
1039
1040 MODULE = EV PACKAGE = EV::Prepare PREFIX = ev_prepare_
1041
1042 void ev_prepare_start (ev_prepare *w)
1043 CODE:
1044 START (prepare, w);
1045
1046 void ev_prepare_stop (ev_prepare *w)
1047 CODE:
1048 STOP (prepare, w);
1049
1050 void DESTROY (ev_prepare *w)
1051 CODE:
1052 STOP (prepare, w);
1053 e_destroy (w);
1054
1055 MODULE = EV PACKAGE = EV::Check PREFIX = ev_check_
1056
1057 void ev_check_start (ev_check *w)
1058 CODE:
1059 START (check, w);
1060
1061 void ev_check_stop (ev_check *w)
1062 CODE:
1063 STOP (check, w);
1064
1065 void DESTROY (ev_check *w)
1066 CODE:
1067 STOP (check, w);
1068 e_destroy (w);
1069
1070 MODULE = EV PACKAGE = EV::Fork PREFIX = ev_fork_
1071
1072 void ev_fork_start (ev_fork *w)
1073 CODE:
1074 START (fork, w);
1075
1076 void ev_fork_stop (ev_fork *w)
1077 CODE:
1078 STOP (fork, w);
1079
1080 void DESTROY (ev_fork *w)
1081 CODE:
1082 STOP (fork, w);
1083 e_destroy (w);
1084
1085 MODULE = EV PACKAGE = EV::Child PREFIX = ev_child_
1086
1087 void ev_child_start (ev_child *w)
1088 CODE:
1089 START (child, w);
1090
1091 void ev_child_stop (ev_child *w)
1092 CODE:
1093 STOP (child, w);
1094
1095 void DESTROY (ev_child *w)
1096 CODE:
1097 STOP (child, w);
1098 e_destroy (w);
1099
1100 void set (ev_child *w, int pid, int trace)
1101 CODE:
1102 RESET (child, w, (w, pid, trace));
1103
1104 int pid (ev_child *w)
1105 ALIAS:
1106 rpid = 1
1107 rstatus = 2
1108 CODE:
1109 RETVAL = ix == 0 ? w->pid
1110 : ix == 1 ? w->rpid
1111 : w->rstatus;
1112 OUTPUT:
1113 RETVAL
1114
1115 MODULE = EV PACKAGE = EV::Stat PREFIX = ev_stat_
1116
1117 void ev_stat_start (ev_stat *w)
1118 CODE:
1119 START (stat, w);
1120
1121 void ev_stat_stop (ev_stat *w)
1122 CODE:
1123 STOP (stat, w);
1124
1125 void DESTROY (ev_stat *w)
1126 CODE:
1127 STOP (stat, w);
1128 e_destroy (w);
1129
1130 void set (ev_stat *w, SV *path, NV interval)
1131 CODE:
1132 {
1133 sv_setsv (w->fh, path);
1134 RESET (stat, w, (w, SvPVbyte_nolen (w->fh), interval));
1135 }
1136
1137 SV *path (ev_stat *w, SV *new_path = 0)
1138 CODE:
1139 {
1140 RETVAL = SvREFCNT_inc (w->fh);
1141
1142 if (items > 1)
1143 {
1144 SvREFCNT_dec (w->fh);
1145 w->fh = newSVsv (new_path);
1146 RESET (stat, w, (w, SvPVbyte_nolen (w->fh), w->interval));
1147 }
1148 }
1149 OUTPUT:
1150 RETVAL
1151
1152 NV interval (ev_stat *w, NV new_interval = 0.)
1153 CODE:
1154 {
1155 RETVAL = w->interval;
1156
1157 if (items > 1)
1158 RESET (stat, w, (w, SvPVbyte_nolen (w->fh), new_interval));
1159 }
1160 OUTPUT:
1161 RETVAL
1162
1163 void prev (ev_stat *w)
1164 ALIAS:
1165 stat = 1
1166 attr = 2
1167 PPCODE:
1168 {
1169 ev_statdata *s = ix ? &w->attr : &w->prev;
1170
1171 if (ix == 1)
1172 ev_stat_stat (e_loop (w), w);
1173 else if (!s->st_nlink)
1174 errno = ENOENT;
1175
1176 PL_statcache.st_dev = s->st_nlink;
1177 PL_statcache.st_ino = s->st_ino;
1178 PL_statcache.st_mode = s->st_mode;
1179 PL_statcache.st_nlink = s->st_nlink;
1180 PL_statcache.st_uid = s->st_uid;
1181 PL_statcache.st_gid = s->st_gid;
1182 PL_statcache.st_rdev = s->st_rdev;
1183 PL_statcache.st_size = s->st_size;
1184 PL_statcache.st_atime = s->st_atime;
1185 PL_statcache.st_mtime = s->st_mtime;
1186 PL_statcache.st_ctime = s->st_ctime;
1187
1188 if (GIMME_V == G_SCALAR)
1189 XPUSHs (boolSV (s->st_nlink));
1190 else if (GIMME_V == G_ARRAY && s->st_nlink)
1191 {
1192 EXTEND (SP, 13);
1193 PUSHs (sv_2mortal (newSViv (s->st_dev)));
1194 PUSHs (sv_2mortal (newSViv (s->st_ino)));
1195 PUSHs (sv_2mortal (newSVuv (s->st_mode)));
1196 PUSHs (sv_2mortal (newSVuv (s->st_nlink)));
1197 PUSHs (sv_2mortal (newSViv (s->st_uid)));
1198 PUSHs (sv_2mortal (newSViv (s->st_gid)));
1199 PUSHs (sv_2mortal (newSViv (s->st_rdev)));
1200 PUSHs (sv_2mortal (newSVnv ((NV)s->st_size)));
1201 PUSHs (sv_2mortal (newSVnv (s->st_atime)));
1202 PUSHs (sv_2mortal (newSVnv (s->st_mtime)));
1203 PUSHs (sv_2mortal (newSVnv (s->st_ctime)));
1204 PUSHs (sv_2mortal (newSVuv (4096)));
1205 PUSHs (sv_2mortal (newSVnv ((NV)((s->st_size + 4095) / 4096))));
1206 }
1207 }
1208
1209 MODULE = EV PACKAGE = EV::Embed PREFIX = ev_embed_
1210
1211 void ev_embed_start (ev_embed *w)
1212 CODE:
1213 START (embed, w);
1214
1215 void ev_embed_stop (ev_embed *w)
1216 CODE:
1217 STOP (embed, w);
1218
1219 void DESTROY (ev_embed *w)
1220 CODE:
1221 STOP (embed, w);
1222 e_destroy (w);
1223
1224 void set (ev_embed *w, struct ev_loop *loop)
1225 CODE:
1226 {
1227 sv_setsv (w->fh, ST (1));
1228 RESET (embed, w, (w, loop));
1229 }
1230
1231 SV *other (ev_embed *w)
1232 CODE:
1233 RETVAL = newSVsv (w->fh);
1234 OUTPUT:
1235 RETVAL
1236
1237 void ev_embed_sweep (ev_embed *w)
1238 C_ARGS: e_loop (w), w
1239
1240 MODULE = EV PACKAGE = EV::Async PREFIX = ev_async_
1241
1242 void ev_async_start (ev_async *w)
1243 CODE:
1244 START (async, w);
1245
1246 void ev_async_stop (ev_async *w)
1247 CODE:
1248 STOP (async, w);
1249
1250 void DESTROY (ev_async *w)
1251 CODE:
1252 STOP (async, w);
1253 e_destroy (w);
1254
1255 void ev_async_send (ev_async *w)
1256 C_ARGS: e_loop (w), w
1257
1258 SV *ev_async_async_pending (ev_async *w)
1259 CODE:
1260 RETVAL = boolSV (ev_async_pending (w));
1261 OUTPUT:
1262 RETVAL
1263
1264 MODULE = EV PACKAGE = EV::Loop PREFIX = ev_
1265
1266 SV *new (SV *klass, unsigned int flags = 0)
1267 CODE:
1268 {
1269 struct ev_loop *loop = ev_loop_new (flags);
1270
1271 if (!loop)
1272 XSRETURN_UNDEF;
1273
1274 RETVAL = sv_bless (newRV_noinc (newSViv (PTR2IV (loop))), stash_loop);
1275 }
1276 OUTPUT:
1277 RETVAL
1278
1279 void DESTROY (struct ev_loop *loop)
1280 CODE:
1281 if (loop != evapi.default_loop) /* global destruction sucks */
1282 ev_loop_destroy (loop);
1283
1284 void ev_loop_fork (struct ev_loop *loop)
1285
1286 void ev_loop_verify (struct ev_loop *loop)
1287
1288 NV ev_now (struct ev_loop *loop)
1289
1290 void ev_now_update (struct ev_loop *loop)
1291
1292 void ev_suspend (struct ev_loop *loop)
1293
1294 void ev_resume (struct ev_loop *loop)
1295
1296 void ev_set_io_collect_interval (struct ev_loop *loop, NV interval)
1297
1298 void ev_set_timeout_collect_interval (struct ev_loop *loop, NV interval)
1299
1300 unsigned int ev_backend (struct ev_loop *loop)
1301
1302 unsigned int ev_loop_count (struct ev_loop *loop)
1303
1304 void ev_loop (struct ev_loop *loop, int flags = 0)
1305
1306 void ev_unloop (struct ev_loop *loop, int how = 1)
1307
1308 void ev_feed_fd_event (struct ev_loop *loop, int fd, int revents = EV_NONE)
1309
1310 #if 0
1311
1312 void ev_feed_signal_event (struct ev_loop *loop, SV *signal)
1313 CODE:
1314 {
1315 Signal signum = sv_signum (signal);
1316 CHECK_SIG (signal, signum);
1317
1318 ev_feed_signal_event (loop, signum);
1319 }
1320
1321 #endif
1322
1323 ev_io *io (struct ev_loop *loop, SV *fh, int events, SV *cb)
1324 ALIAS:
1325 io_ns = 1
1326 CODE:
1327 {
1328 int fd = sv_fileno (fh);
1329 CHECK_FD (fh, fd);
1330
1331 RETVAL = e_new (sizeof (ev_io), cb, ST (0));
1332 RETVAL->fh = newSVsv (fh);
1333 ev_io_set (RETVAL, fd, events);
1334 if (!ix) START (io, RETVAL);
1335 }
1336 OUTPUT:
1337 RETVAL
1338
1339 ev_timer *timer (struct ev_loop *loop, NV after, NV repeat, SV *cb)
1340 ALIAS:
1341 timer_ns = 1
1342 INIT:
1343 CHECK_REPEAT (repeat);
1344 CODE:
1345 RETVAL = e_new (sizeof (ev_timer), cb, ST (0));
1346 ev_timer_set (RETVAL, after, repeat);
1347 if (!ix) START (timer, RETVAL);
1348 OUTPUT:
1349 RETVAL
1350
1351 SV *periodic (struct ev_loop *loop, NV at, NV interval, SV *reschedule_cb, SV *cb)
1352 ALIAS:
1353 periodic_ns = 1
1354 INIT:
1355 CHECK_REPEAT (interval);
1356 CODE:
1357 {
1358 ev_periodic *w;
1359 w = e_new (sizeof (ev_periodic), cb, ST (0));
1360 w->fh = SvTRUE (reschedule_cb) ? newSVsv (reschedule_cb) : 0;
1361 ev_periodic_set (w, at, interval, w->fh ? e_periodic_cb : 0);
1362 RETVAL = e_bless ((ev_watcher *)w, stash_periodic);
1363 if (!ix) START (periodic, w);
1364 }
1365 OUTPUT:
1366 RETVAL
1367
1368 #if 0
1369
1370 ev_signal *signal (struct ev_loop *loop, SV *signal, SV *cb)
1371 ALIAS:
1372 signal_ns = 1
1373 CODE:
1374 {
1375 Signal signum = sv_signum (signal);
1376 CHECK_SIG (signal, signum);
1377
1378 RETVAL = e_new (sizeof (ev_signal), cb, ST (0));
1379 ev_signal_set (RETVAL, signum);
1380 if (!ix) START (signal, RETVAL);
1381 }
1382 OUTPUT:
1383 RETVAL
1384
1385 #endif
1386
1387 ev_idle *idle (struct ev_loop *loop, SV *cb)
1388 ALIAS:
1389 idle_ns = 1
1390 CODE:
1391 RETVAL = e_new (sizeof (ev_idle), cb, ST (0));
1392 ev_idle_set (RETVAL);
1393 if (!ix) START (idle, RETVAL);
1394 OUTPUT:
1395 RETVAL
1396
1397 ev_prepare *prepare (struct ev_loop *loop, SV *cb)
1398 ALIAS:
1399 prepare_ns = 1
1400 CODE:
1401 RETVAL = e_new (sizeof (ev_prepare), cb, ST (0));
1402 ev_prepare_set (RETVAL);
1403 if (!ix) START (prepare, RETVAL);
1404 OUTPUT:
1405 RETVAL
1406
1407 ev_check *check (struct ev_loop *loop, SV *cb)
1408 ALIAS:
1409 check_ns = 1
1410 CODE:
1411 RETVAL = e_new (sizeof (ev_check), cb, ST (0));
1412 ev_check_set (RETVAL);
1413 if (!ix) START (check, RETVAL);
1414 OUTPUT:
1415 RETVAL
1416
1417 ev_fork *fork (struct ev_loop *loop, SV *cb)
1418 ALIAS:
1419 fork_ns = 1
1420 CODE:
1421 RETVAL = e_new (sizeof (ev_fork), cb, ST (0));
1422 ev_fork_set (RETVAL);
1423 if (!ix) START (fork, RETVAL);
1424 OUTPUT:
1425 RETVAL
1426
1427 ev_child *child (struct ev_loop *loop, int pid, int trace, SV *cb)
1428 ALIAS:
1429 child_ns = 1
1430 CODE:
1431 RETVAL = e_new (sizeof (ev_child), cb, ST (0));
1432 ev_child_set (RETVAL, pid, trace);
1433 if (!ix) START (child, RETVAL);
1434 OUTPUT:
1435 RETVAL
1436
1437 ev_stat *stat (struct ev_loop *loop, SV *path, NV interval, SV *cb)
1438 ALIAS:
1439 stat_ns = 1
1440 CODE:
1441 RETVAL = e_new (sizeof (ev_stat), cb, ST (0));
1442 RETVAL->fh = newSVsv (path);
1443 ev_stat_set (RETVAL, SvPVbyte_nolen (RETVAL->fh), interval);
1444 if (!ix) START (stat, RETVAL);
1445 OUTPUT:
1446 RETVAL
1447
1448 ev_embed *embed (struct ev_loop *loop, struct ev_loop *other, SV *cb = 0)
1449 ALIAS:
1450 embed_ns = 1
1451 CODE:
1452 {
1453 if (!(ev_backend (other) & ev_embeddable_backends ()))
1454 croak ("passed loop is not embeddable via EV::embed,");
1455
1456 RETVAL = e_new (sizeof (ev_embed), cb, ST (0));
1457 RETVAL->fh = newSVsv (ST (1));
1458 ev_embed_set (RETVAL, other);
1459 if (!ix) START (embed, RETVAL);
1460 }
1461 OUTPUT:
1462 RETVAL
1463
1464 ev_async *async (struct ev_loop *loop, SV *cb)
1465 ALIAS:
1466 async_ns = 1
1467 CODE:
1468 RETVAL = e_new (sizeof (ev_async), cb, ST (0));
1469 ev_async_set (RETVAL);
1470 if (!ix) START (async, RETVAL);
1471 OUTPUT:
1472 RETVAL
1473
1474 void once (struct ev_loop *loop, SV *fh, int events, SV *timeout, SV *cb)
1475 CODE:
1476 ev_once (
1477 loop,
1478 sv_fileno (fh), events,
1479 SvOK (timeout) ? SvNV (timeout) : -1.,
1480 e_once_cb,
1481 newSVsv (cb)
1482 );
1483