1 |
root |
1.1 |
package EV::MakeMaker; |
2 |
|
|
|
3 |
|
|
BEGIN { eval { require warnings } && warnings->unimport ("uninitialized") } |
4 |
|
|
|
5 |
|
|
use Config; |
6 |
|
|
use base 'Exporter'; |
7 |
|
|
|
8 |
|
|
@EXPORT_OK = qw(&ev_args $installsitearch); |
9 |
|
|
|
10 |
|
|
my %opt; |
11 |
|
|
|
12 |
|
|
for my $opt (split /:+/, $ENV{PERL_MM_OPT}) { |
13 |
|
|
my ($k,$v) = split /=/, $opt; |
14 |
|
|
$opt{$k} = $v; |
15 |
|
|
} |
16 |
|
|
|
17 |
|
|
my $extra = $Config{sitearch}; |
18 |
|
|
|
19 |
|
|
$extra =~ s/$Config{prefix}/$opt{PREFIX}/ if |
20 |
|
|
exists $opt{PREFIX}; |
21 |
|
|
|
22 |
|
|
for my $d ($extra, @INC) { |
23 |
|
|
if (-e "$d/EV/EVAPI.h") { |
24 |
|
|
$installsitearch = $d; |
25 |
|
|
last; |
26 |
|
|
} |
27 |
|
|
} |
28 |
|
|
|
29 |
|
|
sub ev_args { |
30 |
|
|
my %arg = @_; |
31 |
root |
1.2 |
$arg{INC} .= " -I$installsitearch/EV -I$installsitearch"; |
32 |
root |
1.1 |
%arg; |
33 |
|
|
} |
34 |
|
|
|
35 |
|
|
1; |
36 |
|
|
__END__ |
37 |
|
|
|
38 |
|
|
=head1 NAME |
39 |
|
|
|
40 |
|
|
EV::MakeMaker - MakeMaker glue for the C-level EV API |
41 |
|
|
|
42 |
|
|
=head1 SYNOPSIS |
43 |
|
|
|
44 |
|
|
This allows you to access some libevent functionality from other perl |
45 |
|
|
modules. |
46 |
|
|
|
47 |
|
|
=head1 DESCRIPTION |
48 |
|
|
|
49 |
|
|
For optimal performance, hook into EV at the C-level. You'll need |
50 |
|
|
to make changes to your C<Makefile.PL> and add code to your C<xs> / |
51 |
|
|
C<c> file(s). |
52 |
|
|
|
53 |
|
|
=head1 HOW TO |
54 |
|
|
|
55 |
|
|
=head2 Makefile.PL |
56 |
|
|
|
57 |
|
|
use EV::MakeMaker qw(ev_args); |
58 |
|
|
|
59 |
|
|
# ... set up %args ... |
60 |
|
|
|
61 |
|
|
WriteMakefile (ev_args (%args)); |
62 |
|
|
|
63 |
|
|
=head2 XS |
64 |
|
|
|
65 |
|
|
#include "EVAPI.h" |
66 |
|
|
|
67 |
|
|
BOOT: |
68 |
|
|
I_EV_API ("YourModule"); |
69 |
|
|
|
70 |
root |
1.4 |
=head1 API |
71 |
root |
1.1 |
|
72 |
root |
1.7 |
See the L<EVAPI.h|http://cvs.schmorp.de/EV/EV/EVAPI.h> header. |
73 |
root |
1.1 |
|
74 |
root |
1.3 |
In short, all the functions and macros from F<ev.h> should work, except |
75 |
|
|
that the trailing underscore macros (C<EV_A_>, C<EV_DEFAULT_>) are not |
76 |
|
|
available (except C<EV_P_> :). |
77 |
|
|
|
78 |
|
|
Multiplicity is enabled. |
79 |
|
|
|
80 |
|
|
The C<data> member in each watcher is of type C<SV *> and not C<void *> |
81 |
|
|
(this might change at some point). |
82 |
|
|
|
83 |
root |
1.4 |
=head1 EXAMPLE |
84 |
root |
1.3 |
|
85 |
|
|
The L<EV::Glib>, L<EV::ADNS> and L<Glib::EV> all give nice examples on how |
86 |
|
|
to use this module. |
87 |
|
|
|
88 |
|
|
Here are some F<.xs> fragments taken from EV::ADNS that should get you |
89 |
|
|
going: |
90 |
|
|
|
91 |
|
|
#include "EVAPI.h" |
92 |
|
|
|
93 |
|
|
static ev_prepare pw; |
94 |
|
|
static ev_idle iw; |
95 |
|
|
|
96 |
|
|
static void |
97 |
|
|
idle_cb (EV_P_ ev_idle *w, int revents) |
98 |
|
|
{ |
99 |
|
|
ev_idle_stop (EV_A, w); |
100 |
|
|
} |
101 |
|
|
|
102 |
|
|
MODULE = ... |
103 |
|
|
|
104 |
|
|
BOOT: |
105 |
|
|
{ |
106 |
|
|
I_EV_API ("EV::ADNS"); |
107 |
|
|
ev_prepare_init (&pw, prepare_cb); |
108 |
|
|
ev_init (&iw, idle_cb); ev_set_priority (&iw, EV_MINPRI); |
109 |
|
|
ev_idle_start (EV_DEFAULT, &iw); |
110 |
|
|
} |
111 |
|
|
|
112 |
root |
1.1 |
=cut |
113 |
root |
1.3 |
|