1 | use 5.006; |
1 | use 5.008002; |
2 | |
2 | |
|
|
3 | use strict qw(vars subs); |
3 | use Config; |
4 | use Config; |
4 | use ExtUtils::MakeMaker; |
5 | use ExtUtils::MakeMaker; |
5 | |
6 | |
6 | unless (-e "libev/ev_epoll.c") { |
7 | unless (-e "libev/ev_epoll.c") { |
7 | print <<EOF; |
8 | print <<EOF; |
… | |
… | |
34 | |
35 | |
35 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
36 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
36 | |
37 | |
37 | |
38 | |
38 | POSIX optionally offers support for a monotonic clock source. EV |
39 | POSIX optionally offers support for a monotonic clock source. EV |
39 | can take advantage of this clock source to detect time jumps |
40 | can take advantage of this clock source to detect time jumps more |
40 | reliably. Unfortunately, some systems are bound to be broken, so you can |
41 | reliably. Unfortunately, some systems are bound to be broken, so you can |
41 | disable this here: you can completely disable the detection and use of |
42 | disable this here: you can completely disable the detection and use of |
42 | the monotonic clock by answering 'n' here. Support for this clock type |
43 | the monotonic clock by answering 'n' here. Support for this clock type |
43 | will otherwise be autodetected at both compile- and runtime. |
44 | will otherwise be autodetected at both compile- and runtime. (this setting |
|
|
45 | currently affects the use of nanosleep over select as well). |
44 | |
46 | |
45 | EOF |
47 | EOF |
46 | |
48 | |
47 | $DEFINE .= " -DEV_USE_MONOTONIC=" . (0 + (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/)); |
49 | my $DEFINE .= " -DEV_USE_MONOTONIC=" . (0 + (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/)); |
48 | |
50 | |
49 | print <<EOF; |
51 | print <<EOF; |
50 | |
52 | |
51 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
53 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
52 | |
54 | |
53 | |
55 | |
54 | POSIX optionally offers support for a (potentially) high-resolution |
56 | POSIX optionally offers support for a (potentially) high-resolution |
55 | realtime clock interface. In a good implementation, using it is faster |
57 | realtime clock interface. In a good implementation, using it is faster |
56 | than the normal method of using gettimeofday. Unfortunately, this option |
58 | than the normal method of using gettimeofday. Unfortunately, this option |
57 | is also bound to be broken on some systems, so you can disable use and |
59 | is also bound to be broken on some systems, and current EV versions do not |
58 | probing of this feature altogether here. Otherwise support for this clock |
60 | actually call gettimeofday very often, so it defaults to no. |
59 | type will be autodetected at compiletime. |
|
|
60 | |
61 | |
61 | EOF |
62 | EOF |
62 | |
63 | |
63 | $DEFINE .= " -DEV_USE_REALTIME=" . (0 + (prompt ("Prefer clock_gettime (CLOCK_REALTIME) over gettimeofday (y/n)?", "y") =~ /[yY]/)); |
64 | $DEFINE .= " -DEV_USE_REALTIME=" . (0 + (prompt ("Prefer clock_gettime (CLOCK_REALTIME) over gettimeofday (y/n)?", "n") =~ /[yY]/)); |
64 | |
65 | |
65 | print <<EOF; |
66 | print <<EOF; |
66 | |
67 | |
67 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
68 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
68 | |
69 | |
69 | |
70 | |
70 | EV can use various backends with various portability issue. The select |
71 | EV can use various backends with various portability issues. The select |
71 | backend is the most portable and makes for a good fallback, but it can be |
72 | backend is the most portable and makes for a good fallback, but it can be |
72 | limited to a low number of file descriptors and/or might not compile. If |
73 | limited to a low number of file descriptors and/or might not compile. If |
73 | you have problems with compiling ev_select.c, you might try to play around |
74 | you have problems with compiling ev_select.c, you might try to play around |
74 | with disabling it here, or forcing it to use the fd_set provided by your |
75 | with disabling it here, or forcing it to use the fd_set provided by your |
75 | OS, via the next question. I highly recommend keeping it in. |
76 | OS, via the next question. I highly recommend keeping it in. |
… | |
… | |
116 | print <<EOF; |
117 | print <<EOF; |
117 | |
118 | |
118 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
119 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
119 | |
120 | |
120 | |
121 | |
121 | EV by default uses select, which makes it hard to write efficient servers, |
122 | Select and poll make it hard to write efficient servers, especially if the |
122 | especially if the number of active connections is much lower than the open |
123 | number of active connections is much lower than the watched ones. GNU/Linux |
123 | ones. GNU/Linux systems have a more scalable method called "epoll", which |
124 | systems have a more scalable method called "epoll", which EV can use. For |
124 | EV can use. For this to work, both your kernel and glibc have to support |
125 | this to work, both your kernel and glibc have to support epoll, but if you |
125 | epoll, but if you can compile it, the detection will be done at runtime, |
126 | can compile it, the detection will be done at runtime, and EV will safely |
126 | and EV will safely fall back to using select when epoll isn't available. |
127 | fall back to using select when epoll isn't available. If unsure, accept |
127 | If unsure, accept the default. |
128 | the default. |
128 | |
129 | |
129 | EOF |
130 | EOF |
130 | |
131 | |
|
|
132 | my $can_epoll = -e "/usr/include/sys/epoll.h"; |
|
|
133 | $can_epoll = $ENV{EV_EPOLL} if exists $ENV{EV_EPOLL}; |
131 | $DEFINE .= " -DEV_USE_EPOLL=" . (0 + (prompt ("Enable epoll backend (y/n)?", (-e "/usr/include/sys/epoll.h") ? "y" : "n") =~ /[yY]/)); |
134 | $DEFINE .= " -DEV_USE_EPOLL=" . (0 + (prompt ("Enable epoll backend (y/n)?", $can_epoll ? "y" : "n") =~ /[yY]/)); |
132 | |
135 | |
133 | print <<EOF; |
136 | print <<EOF; |
134 | |
137 | |
135 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
138 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
136 | |
139 | |
137 | |
140 | |
138 | Similarly to the epoll backend above, EV can take advantage of kqueue |
141 | Similarly to the epoll backend above, EV can take advantage of kqueue on |
139 | on many BSD systems (it seems to be broken on Mac OS X though, but what |
142 | many BSD systems. Support for kqueue will be detected at runtime, with a |
140 | isn't broken on that shoddy platform... ah yes, the cash gushing by apple, |
143 | safe fallback to other methods when it cannot be used. |
141 | selling defective software works perfectly there). Support for kqueue will |
|
|
142 | be detected at runtime, with a safe fallback to other methods when it |
|
|
143 | cannot be used. |
|
|
144 | |
144 | |
145 | EOF |
145 | 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 | loop with kqueue backend if you ask specifically for it. |
146 | |
148 | |
|
|
149 | Here is what we know: |
|
|
150 | |
|
|
151 | 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 | sockets *likely* work, ptys definitely don't. |
|
|
154 | OpenBSD: reports indicate that it likely doesn't work |
|
|
155 | (similar problems as on FreeBSD). |
|
|
156 | OS X: completely, utterly broken on at least <= 10.6. |
|
|
157 | |
|
|
158 | EOF |
|
|
159 | |
|
|
160 | my $can_kqueue = -e "/usr/include/sys/event.h"; |
|
|
161 | $can_kqueue = $ENV{EV_KQUEUE} if exists $ENV{EV_KQUEUE}; |
147 | $DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", (-e "/usr/include/sys/event.h") ? "y" : "n") =~ /[yY]/)); |
162 | $DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", $can_kqueue ? "y" : "n") =~ /[yY]/)); |
148 | |
163 | |
149 | print <<EOF; |
164 | print <<EOF; |
150 | |
165 | |
151 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
166 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
152 | |
167 | |
153 | |
168 | |
154 | Similarly to the kqueue backend above, EV can take advantage of the |
169 | Similarly to the kqueue backend above, EV can take advantage of the |
155 | solaris 10 port interface. Support for port will be detected at runtime, |
170 | solaris 10 event port interface. Support for event ports will be detected |
156 | with a safe fallback to other methods when it cannot be used. |
171 | at runtime, with a safe fallback to other methods when it cannot be used. |
157 | |
172 | |
158 | EOF |
173 | EOF |
159 | |
174 | |
160 | $DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/)); |
175 | $DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable event port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/)); |
161 | |
176 | |
162 | print <<EOF; |
177 | print <<EOF; |
163 | |
178 | |
164 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
179 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
165 | |
180 | |
166 | |
181 | |
167 | EV needs the functions pthread_atfork and clock_gettime. On most systems |
182 | EV needs the functions pthread_atfork and clock_gettime. On most systems |
168 | you need some special libraries for this (such as -lrt and -lpthread). You |
183 | you need some special libraries for this (such as -lrt and -lpthread). You |
169 | can specify additional libraries to provide these calls now, or accept the |
184 | can specify additional libraries to provide these calls (and any other |
170 | default. |
185 | required by EV) now, or accept the default. |
171 | |
186 | |
172 | EOF |
187 | On GNU/Linux systems, EV uses the LSB 3.1 __register_atfork function |
|
|
188 | to avoid the dependency on libpthread, and directly uses the clock_gettime |
|
|
189 | syscall to avoid a dependency on librt. |
173 | |
190 | |
|
|
191 | EOF |
|
|
192 | |
|
|
193 | my $solaris_libs = $^O =~ /solaris/i ? "-lsocket -lnsl" : ""; |
|
|
194 | my $librt = $^O =~ /linux/i ? "" : "-lpthread -lrt"; |
|
|
195 | my $LIBS = exists $ENV{EV_LIBS} ? $ENV{EV_LIBS} : "$librt $solaris_libs"; |
174 | $LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "-lpthread -lrt"; |
196 | $LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", $LIBS; |
175 | |
197 | |
176 | |
198 | |
177 | print <<EOF; |
199 | print <<EOF; |
178 | |
200 | |
179 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
201 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
180 | |
202 | |
181 | |
203 | |
182 | EOF |
204 | A backend of a different kind is the Linux inotify(7) interface, which can |
|
|
205 | be used to speed up (and reduce resource consumption) of stat watchers. If |
|
|
206 | you have the include file and libc support for it, it is usually a good |
|
|
207 | idea to enable it, as kernel availability is detected at runtime. |
183 | |
208 | |
|
|
209 | EOF |
|
|
210 | |
|
|
211 | my $can_inotify = -e "/usr/include/sys/inotify.h"; |
|
|
212 | $can_inotify = $ENV{EV_INOTIFY} if exists $ENV{EV_INOTIFY}; |
|
|
213 | $DEFINE .= " -DEV_USE_INOTIFY=" . (0 + (prompt ("Enable inotify support (y/n)?", $can_inotify ? "y" : "n") =~ /[yY]/)); |
|
|
214 | |
|
|
215 | print <<EOF; |
|
|
216 | |
|
|
217 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
|
|
218 | |
|
|
219 | |
|
|
220 | Another useful bit of functionality is the Linux eventfd, which is useful |
|
|
221 | for faster signal handling (don't care) and intra-thread communications |
|
|
222 | (more relevant). Kernel support for this will be probed at runtime, but |
|
|
223 | your libc must contain the necessary wrapper. Glibc 2.7 and later should |
|
|
224 | have this wrapper. |
|
|
225 | |
|
|
226 | EOF |
|
|
227 | |
|
|
228 | my $can_eventfd = -e "/usr/include/sys/eventfd.h"; |
|
|
229 | $can_eventfd = $ENV{EV_EVENTFD} if exists $ENV{EV_EVENTFD}; |
|
|
230 | $DEFINE .= " -DEV_USE_EVENTFD=" . (0 + (prompt ("Enable linux eventfd support (y/n)?", $can_eventfd ? "y" : "n") =~ /[yY]/)); |
|
|
231 | |
|
|
232 | print <<EOF; |
|
|
233 | |
|
|
234 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
|
|
235 | |
|
|
236 | |
|
|
237 | Another sometimes useful bit of functionality is the Linux signalfd, which |
|
|
238 | is useful for faster signal handling (don't care). Kernel support for |
|
|
239 | this will be probed at runtime, but your libc must contain the necessary |
|
|
240 | wrapper. Glibc 2.7 and later should have this wrapper. |
|
|
241 | |
|
|
242 | EOF |
|
|
243 | |
|
|
244 | my $can_signalfd = -e "/usr/include/sys/signalfd.h"; |
|
|
245 | $can_signalfd = $ENV{EV_SIGNALFD} if exists $ENV{EV_SIGNALFD}; |
|
|
246 | $DEFINE .= " -DEV_USE_SIGNALFD=" . (0 + (prompt ("Enable linux signalfd support (y/n)?", $can_signalfd ? "y" : "n") =~ /[yY]/)); |
|
|
247 | |
|
|
248 | print <<EOF; |
|
|
249 | |
|
|
250 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
|
|
251 | |
|
|
252 | |
|
|
253 | Very rarely, people want to tweak EV even more, e.g. to exclude |
|
|
254 | or include certain watcher types or backends. This can be done by adding |
|
|
255 | extra -D options here, or via the EV_EXTRA_DEFS environment variable. |
|
|
256 | |
|
|
257 | For example, if you run into compile problems because of missing memory |
|
|
258 | fences (or you just want extra performance), you can tell EV to not support |
|
|
259 | smp and threads via -DEV_NO_THREADS. |
|
|
260 | |
|
|
261 | Normal persons just press enter. |
|
|
262 | |
|
|
263 | EOF |
|
|
264 | |
|
|
265 | $DEFINE .= " " . prompt "Any extra -D options?", "$ENV{EV_EXTRA_DEFS}"; |
|
|
266 | |
|
|
267 | print <<EOF; |
|
|
268 | |
|
|
269 | *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** |
|
|
270 | |
|
|
271 | |
|
|
272 | EOF |
|
|
273 | |
184 | my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 2.6 } ? (AnyEvent => 2.6) : (); |
274 | my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 5.29 } ? (AnyEvent => 5.29) : (); |
185 | |
275 | |
186 | WriteMakefile( |
276 | WriteMakefile( |
187 | dist => { |
277 | dist => { |
188 | PREOP => 'pod2text EV.pm | tee README >$(DISTVNAME)/README; chmod -R u=rwX,go=rX . ;', |
278 | PREOP => 'pod2text EV.pm | tee README >$(DISTVNAME)/README; chmod -R u=rwX,go=rX . ;', |
189 | COMPRESS => 'gzip -9v', |
279 | COMPRESS => 'gzip -9v', |
190 | SUFFIX => '.gz', |
280 | SUFFIX => '.gz', |
191 | }, |
281 | }, |
192 | depend => { |
282 | depend => { |
193 | "EV.c" => "EV/EVAPI.h " |
283 | "EV.c" => "EV/EVAPI.h " |
194 | . "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c " |
284 | . "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c " |
195 | . "libev/event.h libev/event.c evdns.h evdns.c libev/ev_vars.h libev/ev_wrap.h", |
285 | . "libev/ev_vars.h libev/ev_wrap.h", |
196 | }, |
286 | }, |
197 | INC => "-Ilibev", |
287 | INC => "-Ilibev", |
198 | DEFINE => "$DEFINE", |
288 | DEFINE => "$DEFINE", |
199 | NAME => "EV", |
289 | NAME => "EV", |
200 | LIBS => [$LIBS], |
290 | LIBS => [$LIBS], |
201 | PREREQ_PM => { |
291 | PREREQ_PM => { |
202 | @anyevent, |
292 | @anyevent, |
|
|
293 | "common::sense" => 0, |
203 | }, |
294 | }, |
204 | VERSION_FROM => "EV.pm", |
295 | VERSION_FROM => "EV.pm", |
205 | PM => { |
296 | PM => { |
206 | 'EV.pm' => '$(INST_LIBDIR)/EV.pm', |
297 | 'EV.pm' => '$(INST_LIB)/EV.pm', |
207 | 'EV/DNS.pm' => '$(INST_LIBDIR)/EV/DNS.pm', |
|
|
208 | 'EV/EVAPI.h' => '$(INST_LIBDIR)/EV/EVAPI.h', |
298 | 'EV/EVAPI.h' => '$(INST_LIB)/EV/EVAPI.h', |
209 | 'EV/MakeMaker.pm' => '$(INST_LIBDIR)/EV/MakeMaker.pm', |
299 | 'EV/MakeMaker.pm' => '$(INST_LIB)/EV/MakeMaker.pm', |
210 | 'libev/ev.h' => '$(INST_LIBDIR)/EV/ev.h', |
300 | 'libev/ev.h' => '$(INST_LIB)/EV/ev.h', |
|
|
301 | 'libev/ev.pod' => '$(INST_LIB)/EV/libev.pod', |
211 | }, |
302 | }, |
|
|
303 | MAN3PODS => { |
|
|
304 | 'EV.pm' => '$(INST_MAN3DIR)/EV.$(MAN3EXT)', |
|
|
305 | 'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)', |
|
|
306 | 'libev/ev.pod' => '$(INST_MAN3DIR)/EV::libev.$(MAN3EXT)', |
|
|
307 | }, |
212 | ); |
308 | ); |
213 | |
309 | |
214 | |
310 | |