ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/EV/Makefile.PL
Revision: 1.52
Committed: Sat Feb 4 20:12:17 2012 UTC (12 years, 3 months ago) by root
Content type: text/plain
Branch: MAIN
CVS Tags: EV_rel-4_11
Changes since 1.51: +6 -1 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.43 use 5.008002;
2 root 1.4
3 root 1.37 use strict qw(vars subs);
4 root 1.7 use Config;
5 root 1.1 use ExtUtils::MakeMaker;
6    
7 root 1.10 unless (-e "libev/ev_epoll.c") {
8     print <<EOF;
9    
10     ***
11     *** ERROR: libev is missing or damaged. If you used a CVS check-out of EV,
12     *** you also have to check-out the "libev" module from the same CVS
13     *** repository into the EV dir (i.e. EV/libev from outside).
14     ***
15    
16     EOF
17     exit 1;
18     }
19    
20 root 1.11 print <<EOF;
21    
22 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
23 root 1.11
24    
25     Welcome to EV configuration. If you are in a hurry, just press return here
26     and hope for the best. The defaults should usually do.
27    
28     EOF
29    
30     if (prompt ("Skip further questions and use defaults (y/n)?", "y") =~ /[yY]/) {
31     $ENV{PERL_MM_USE_DEFAULT} = 1;
32     }
33    
34     print <<EOF;
35    
36 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
37 root 1.11
38    
39 root 1.14 POSIX optionally offers support for a monotonic clock source. EV
40 root 1.45 can take advantage of this clock source to detect time jumps more
41 root 1.14 reliably. Unfortunately, some systems are bound to be broken, so you can
42     disable this here: you can completely disable the detection and use of
43     the monotonic clock by answering 'n' here. Support for this clock type
44 root 1.29 will otherwise be autodetected at both compile- and runtime. (this setting
45     currently affects the use of nanosleep over select as well).
46 root 1.11
47     EOF
48    
49 root 1.37 my $DEFINE .= " -DEV_USE_MONOTONIC=" . (0 + (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/));
50 root 1.11
51     print <<EOF;
52    
53 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
54 root 1.11
55    
56     POSIX optionally offers support for a (potentially) high-resolution
57     realtime clock interface. In a good implementation, using it is faster
58     than the normal method of using gettimeofday. Unfortunately, this option
59 root 1.39 is also bound to be broken on some systems, and current EV versions do not
60 root 1.45 actually call gettimeofday very often, so it defaults to no.
61 root 1.11
62     EOF
63    
64 root 1.39 $DEFINE .= " -DEV_USE_REALTIME=" . (0 + (prompt ("Prefer clock_gettime (CLOCK_REALTIME) over gettimeofday (y/n)?", "n") =~ /[yY]/));
65 root 1.11
66     print <<EOF;
67    
68 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
69 root 1.11
70    
71 root 1.46 EV can use various backends with various portability issues. The select
72 root 1.19 backend is the most portable and makes for a good fallback, but it can be
73 root 1.22 limited to a low number of file descriptors and/or might not compile. If
74     you have problems with compiling ev_select.c, you might try to play around
75 root 1.19 with disabling it here, or forcing it to use the fd_set provided by your
76     OS, via the next question. I highly recommend keeping it in.
77    
78     EOF
79    
80     if (prompt ("Enable select backend (y/n)?", "y") =~ /[yY]/) {
81 root 1.22 $DEFINE .= " -DEV_USE_SELECT=1";
82 root 1.19
83     print <<EOF;
84    
85 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
86 root 1.19
87    
88     The select backend can operate in two modes. One uses the system-provided
89     fd_set and is usually limited to 1024 file descriptors (64 on windows),
90     the other requires your header files to define NFDBITS and declare a
91     suitable fd_mask type. If you run into problems compiling ev_select.c, you
92     can try forcing the use of the system fd_set here.
93    
94     EOF
95    
96     if (prompt ("Force use of system fd_set for select backend (y/n)?", "n") =~ /[yY]/) {
97     $DEFINE .= " -DEV_SELECT_USE_FD_SET";
98     }
99 root 1.22 } else {
100     $DEFINE .= " -DEV_USE_SELECT=0";
101 root 1.19 }
102    
103     print <<EOF;
104    
105 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
106 root 1.19
107    
108     The second very portable backend is poll(2). It does not exist on windows
109     and various versions of Mac OS X (and on the other versions it simply
110     doesn't work), but works basically everywhere else. It is recommended to use
111     the default here unless you run into compile problems in ev_poll.c.
112    
113     EOF
114    
115 root 1.22 $DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (-e "/usr/include/poll.h") ? "y" : "n") =~ /[yY]/));
116 root 1.19
117     print <<EOF;
118    
119 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
120 root 1.19
121    
122 root 1.24 Select and poll make it hard to write efficient servers, especially if the
123     number of active connections is much lower than the watched ones. GNU/Linux
124     systems have a more scalable method called "epoll", which EV can use. For
125     this to work, both your kernel and glibc have to support epoll, but if you
126     can compile it, the detection will be done at runtime, and EV will safely
127     fall back to using select when epoll isn't available. If unsure, accept
128     the default.
129 root 1.11
130     EOF
131    
132 root 1.37 my $can_epoll = -e "/usr/include/sys/epoll.h";
133     $can_epoll = $ENV{EV_EPOLL} if exists $ENV{EV_EPOLL};
134     $DEFINE .= " -DEV_USE_EPOLL=" . (0 + (prompt ("Enable epoll backend (y/n)?", $can_epoll ? "y" : "n") =~ /[yY]/));
135 root 1.15
136     print <<EOF;
137    
138 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
139 root 1.15
140    
141 root 1.23 Similarly to the epoll backend above, EV can take advantage of kqueue on
142     many BSD systems. Support for kqueue will be detected at runtime, with a
143     safe fallback to other methods when it cannot be used.
144    
145 root 1.31 Note that kqueue is broken on most operating systems, so by default it
146     won't be used on many platforms, but you can still create your own event
147 root 1.40 loop with kqueue backend if you ask specifically for it.
148 root 1.31
149     Here is what we know:
150 root 1.23
151 root 1.45 NetBSD: partially working in at least 3.1 and later. Yeah! :)
152     FreeBSD: broken on at least 6.2-STABLE, spotty in later versions,
153 root 1.28 sockets *likely* work, ptys definitely don't.
154 root 1.23 OpenBSD: reports indicate that it likely doesn't work
155     (similar problems as on FreeBSD).
156 root 1.45 OS X: completely, utterly broken on at least <= 10.6.
157 root 1.11
158 root 1.15 EOF
159    
160 root 1.28 my $can_kqueue = -e "/usr/include/sys/event.h";
161 root 1.37 $can_kqueue = $ENV{EV_KQUEUE} if exists $ENV{EV_KQUEUE};
162 root 1.23 $DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", $can_kqueue ? "y" : "n") =~ /[yY]/));
163 root 1.11
164     print <<EOF;
165    
166 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
167 root 1.11
168    
169 root 1.21 Similarly to the kqueue backend above, EV can take advantage of the
170 root 1.26 solaris 10 event port interface. Support for event ports will be detected
171     at runtime, with a safe fallback to other methods when it cannot be used.
172 root 1.21
173     EOF
174    
175 root 1.26 $DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable event port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/));
176 root 1.21
177     print <<EOF;
178    
179 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
180 root 1.21
181    
182 root 1.11 EV needs the functions pthread_atfork and clock_gettime. On most systems
183 root 1.15 you need some special libraries for this (such as -lrt and -lpthread). You
184 root 1.23 can specify additional libraries to provide these calls (and any other
185     required by EV) now, or accept the default.
186 root 1.11
187     EOF
188    
189 root 1.38 my $solaris_libs = $^O =~ /solaris/i ? "-lsocket -lnsl" : "";
190 root 1.50 #my $librt = $^O =~ /linux/i ? "-lpthread" : "-lpthread -lrt";
191     my $librt = "-lpthread -lrt";
192 root 1.38 my $LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "$librt $solaris_libs";
193 root 1.15
194 root 1.11
195     print <<EOF;
196    
197 root 1.22 *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
198 root 1.11
199    
200 root 1.25 A backend of a different kind is the Linux inotify(7) interface, which can
201     be used to speed up (and reduce resource consumption) of stat watchers. If
202 root 1.40 you have the include file and libc support for it, it is usually a good
203     idea to enable it, as kernel availability is detected at runtime.
204 root 1.25
205     EOF
206    
207     my $can_inotify = -e "/usr/include/sys/inotify.h";
208 root 1.37 $can_inotify = $ENV{EV_INOTIFY} if exists $ENV{EV_INOTIFY};
209 root 1.25 $DEFINE .= " -DEV_USE_INOTIFY=" . (0 + (prompt ("Enable inotify support (y/n)?", $can_inotify ? "y" : "n") =~ /[yY]/));
210    
211     print <<EOF;
212    
213     *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
214    
215    
216 root 1.36 Another useful bit of functionality is the Linux eventfd, which is useful
217     for faster signal handling (don't care) and intra-thread communications
218     (more relevant). Kernel support for this will be probed at runtime, but
219     your libc must contain the necessary wrapper. Glibc 2.7 and later should
220     have this wrapper.
221    
222     EOF
223    
224 root 1.37 my $can_eventfd = -e "/usr/include/sys/eventfd.h";
225     $can_eventfd = $ENV{EV_EVENTFD} if exists $ENV{EV_EVENTFD};
226     $DEFINE .= " -DEV_USE_EVENTFD=" . (0 + (prompt ("Enable linux eventfd support (y/n)?", $can_eventfd ? "y" : "n") =~ /[yY]/));
227 root 1.36
228     print <<EOF;
229    
230     *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
231    
232    
233 root 1.42 Another sometimes useful bit of functionality is the Linux signalfd, which
234     is useful for faster signal handling (don't care). Kernel support for
235     this will be probed at runtime, but your libc must contain the necessary
236 root 1.44 wrapper. Glibc 2.7 and later should have this wrapper.
237 root 1.42
238     EOF
239    
240     my $can_signalfd = -e "/usr/include/sys/signalfd.h";
241     $can_signalfd = $ENV{EV_SIGNALFD} if exists $ENV{EV_SIGNALFD};
242     $DEFINE .= " -DEV_USE_SIGNALFD=" . (0 + (prompt ("Enable linux signalfd support (y/n)?", $can_signalfd ? "y" : "n") =~ /[yY]/));
243    
244     print <<EOF;
245    
246     *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
247    
248    
249 root 1.48 Very rarely, people want to tweak EV even more, e.g. to exclude
250 root 1.52 or include certain watcher types or backends. This can be done by adding
251 root 1.48 extra -D options here, or via the EV_EXTRA_DEFS environment variable.
252 root 1.52
253     For example, if you run into compile problems because of missing memory
254     fences (or you just want extra performance), you can tell EV to not support
255     smp and threads via -DEV_NO_THREADS.
256    
257 root 1.48 Normal persons just press enter.
258    
259     EOF
260    
261 root 1.49 $DEFINE .= " " . prompt "Any extra -D options?", "$ENV{EV_EXTRA_DEFS}";
262 root 1.48
263     print <<EOF;
264    
265     *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
266    
267    
268 root 1.11 EOF
269    
270 root 1.47 my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 5.29 } ? (AnyEvent => 5.29) : ();
271 root 1.20
272 root 1.1 WriteMakefile(
273     dist => {
274 root 1.2 PREOP => 'pod2text EV.pm | tee README >$(DISTVNAME)/README; chmod -R u=rwX,go=rX . ;',
275 root 1.1 COMPRESS => 'gzip -9v',
276     SUFFIX => '.gz',
277     },
278 root 1.10 depend => {
279 root 1.13 "EV.c" => "EV/EVAPI.h "
280 root 1.17 . "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c "
281 root 1.30 . "libev/ev_vars.h libev/ev_wrap.h",
282 root 1.10 },
283 root 1.8 INC => "-Ilibev",
284 root 1.11 DEFINE => "$DEFINE",
285 root 1.2 NAME => "EV",
286 root 1.11 LIBS => [$LIBS],
287 root 1.20 PREREQ_PM => {
288     @anyevent,
289 root 1.41 "common::sense" => 0,
290 root 1.20 },
291 root 1.2 VERSION_FROM => "EV.pm",
292 root 1.5 PM => {
293     'EV.pm' => '$(INST_LIBDIR)/EV.pm',
294     'EV/EVAPI.h' => '$(INST_LIBDIR)/EV/EVAPI.h',
295     'EV/MakeMaker.pm' => '$(INST_LIBDIR)/EV/MakeMaker.pm',
296 root 1.8 'libev/ev.h' => '$(INST_LIBDIR)/EV/ev.h',
297 root 1.35 'libev/ev.pod' => '$(INST_LIBDIR)/EV/libev.pod',
298 root 1.5 },
299 root 1.34 MAN3PODS => {
300     'EV.pm' => '$(INST_MAN3DIR)/EV.$(MAN3EXT)',
301     'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)',
302 root 1.35 'libev/ev.pod' => '$(INST_MAN3DIR)/EV::libev.$(MAN3EXT)',
303 root 1.34 },
304 root 1.1 );
305    
306 root 1.6