ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/EV/Makefile.PL
(Generate patch)

Comparing EV/Makefile.PL (file contents):
Revision 1.20 by root, Wed Nov 14 22:30:50 2007 UTC vs.
Revision 1.23 by root, Thu Nov 22 04:52:24 2007 UTC

… …
16 exit 1; 16 exit 1;
17} 17}
18 18
19print <<EOF; 19print <<EOF;
20 20
21
22*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 21*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
22
23 23
24Welcome to EV configuration. If you are in a hurry, just press return here 24Welcome to EV configuration. If you are in a hurry, just press return here
25and hope for the best. The defaults should usually do. 25and hope for the best. The defaults should usually do.
26 26
27EOF 27EOF
… …
30 $ENV{PERL_MM_USE_DEFAULT} = 1; 30 $ENV{PERL_MM_USE_DEFAULT} = 1;
31} 31}
32 32
33print <<EOF; 33print <<EOF;
34 34
35
36*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 35*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
36
37 37
38POSIX optionally offers support for a monotonic clock source. EV 38POSIX optionally offers support for a monotonic clock source. EV
39can take advantage of this clock source to detect time jumps 39can take advantage of this clock source to detect time jumps
40reliably. Unfortunately, some systems are bound to be broken, so you can 40reliably. Unfortunately, some systems are bound to be broken, so you can
41disable this here: you can completely disable the detection and use of 41disable this here: you can completely disable the detection and use of
42the monotonic clock by answering 'n' here. Support for this clock type 42the monotonic clock by answering 'n' here. Support for this clock type
43will otherwise be autodetected at both compile- and runtime. 43will otherwise be autodetected at both compile- and runtime.
44 44
45EOF 45EOF
46 46
47if (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/) { 47$DEFINE .= " -DEV_USE_MONOTONIC=" . (0 + (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/));
48 $DEFINE .= " -DEV_USE_MONOTONIC";
49}
50 48
51print <<EOF; 49print <<EOF;
52 50
53
54*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 51*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
52
55 53
56POSIX optionally offers support for a (potentially) high-resolution 54POSIX optionally offers support for a (potentially) high-resolution
57realtime clock interface. In a good implementation, using it is faster 55realtime clock interface. In a good implementation, using it is faster
58than the normal method of using gettimeofday. Unfortunately, this option 56than the normal method of using gettimeofday. Unfortunately, this option
59is also bound to be broken on some systems, so you can disable use and 57is also bound to be broken on some systems, so you can disable use and
60probing of this feature altogether here. Otherwise support for this clock 58probing of this feature altogether here. Otherwise support for this clock
61type will be autodetected at compiletime. 59type will be autodetected at compiletime.
62 60
63EOF 61EOF
64 62
65if (prompt ("Prefer clock_gettime (CLOCK_REALTIME) over gettimeofday (y/n)?", "y") !~ /[yY]/) { 63$DEFINE .= " -DEV_USE_REALTIME=" . (0 + (prompt ("Prefer clock_gettime (CLOCK_REALTIME) over gettimeofday (y/n)?", "y") =~ /[yY]/));
66 $DEFINE .= " -DEV_USE_REALTIME=0";
67}
68 64
69print <<EOF; 65print <<EOF;
70 66
71
72*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 67*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
68
73 69
74EV can use various backends with various portability issue. The select 70EV can use various backends with various portability issue. The select
75backend is the most portable and makes for a good fallback, but it can be 71backend is the most portable and makes for a good fallback, but it can be
76limited to a low number of file descriptors and/or might not compile. If 72limited to a low number of file descriptors and/or might not compile. If
77you have problems with compiling ev_select., you might try to play around 73you have problems with compiling ev_select.c, you might try to play around
78with disabling it here, or forcing it to use the fd_set provided by your 74with disabling it here, or forcing it to use the fd_set provided by your
79OS, via the next question. I highly recommend keeping it in. 75OS, via the next question. I highly recommend keeping it in.
80 76
81EOF 77EOF
82 78
83if (prompt ("Enable select backend (y/n)?", "y") =~ /[yY]/) { 79if (prompt ("Enable select backend (y/n)?", "y") =~ /[yY]/) {
84 $DEFINE .= " -DEV_USE_SELECT"; 80 $DEFINE .= " -DEV_USE_SELECT=1";
85 81
86 print <<EOF; 82 print <<EOF;
87 83
88
89*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 84*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
85
90 86
91The select backend can operate in two modes. One uses the system-provided 87The select backend can operate in two modes. One uses the system-provided
92fd_set and is usually limited to 1024 file descriptors (64 on windows), 88fd_set and is usually limited to 1024 file descriptors (64 on windows),
93the other requires your header files to define NFDBITS and declare a 89the other requires your header files to define NFDBITS and declare a
94suitable fd_mask type. If you run into problems compiling ev_select.c, you 90suitable fd_mask type. If you run into problems compiling ev_select.c, you
… …
97EOF 93EOF
98 94
99 if (prompt ("Force use of system fd_set for select backend (y/n)?", "n") =~ /[yY]/) { 95 if (prompt ("Force use of system fd_set for select backend (y/n)?", "n") =~ /[yY]/) {
100 $DEFINE .= " -DEV_SELECT_USE_FD_SET"; 96 $DEFINE .= " -DEV_SELECT_USE_FD_SET";
101 } 97 }
98} else {
99 $DEFINE .= " -DEV_USE_SELECT=0";
102} 100}
103 101
104print <<EOF; 102print <<EOF;
105 103
106
107*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 104*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
105
108 106
109The second very portable backend is poll(2). It does not exist on windows 107The second very portable backend is poll(2). It does not exist on windows
110and various versions of Mac OS X (and on the other versions it simply 108and various versions of Mac OS X (and on the other versions it simply
111doesn't work), but works basically everywhere else. It is recommended to use 109doesn't work), but works basically everywhere else. It is recommended to use
112the default here unless you run into compile problems in ev_poll.c. 110the default here unless you run into compile problems in ev_poll.c.
113 111
114EOF 112EOF
115 113
116if (prompt ("Enable poll backend (y/n)?", (-e "/usr/include/poll.h") ? "y" : "n") =~ /[yY]/) { 114$DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (-e "/usr/include/poll.h") ? "y" : "n") =~ /[yY]/));
117 $DEFINE .= " -DEV_USE_POLL";
118}
119 115
120print <<EOF; 116print <<EOF;
121 117
122
123*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 118*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
119
124 120
125EV by default uses select, which makes it hard to write efficient servers, 121EV by default uses select, which makes it hard to write efficient servers,
126especially if the number of active conencitons is much lower than the open 122especially if the number of active connections is much lower than the open
127ones. GNU/Linux systems have a more scalable method called "epoll", which 123ones. GNU/Linux systems have a more scalable method called "epoll", which
128EV can use. For this to work, both your kernel and glibc have to support 124EV can use. For this to work, both your kernel and glibc have to support
129epoll, but if you can compile it, the detection will be done at runtime, 125epoll, but if you can compile it, the detection will be done at runtime,
130and EV will safely fall back to using select when epoll isn't available. 126and EV will safely fall back to using select when epoll isn't available.
131If unsure, accept the default. 127If unsure, accept the default.
132 128
133EOF 129EOF
134 130
135if (prompt ("Enable epoll backend (y/n)?", (-e "/usr/include/sys/epoll.h") ? "y" : "n") =~ /[yY]/) { 131$DEFINE .= " -DEV_USE_EPOLL=" . (0 + (prompt ("Enable epoll backend (y/n)?", (-e "/usr/include/sys/epoll.h") ? "y" : "n") =~ /[yY]/));
136 $DEFINE .= " -DEV_USE_EPOLL";
137}
138 132
139print <<EOF; 133print <<EOF;
140 134
141
142*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 135*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
143 136
137
144Similarly to the epoll backend above, EV can take advantage of kqueue 138Similarly to the epoll backend above, EV can take advantage of kqueue on
145on many BSD systems (it seems to be broken on Mac OS X though, but what 139many BSD systems. Support for kqueue will be detected at runtime, with a
146isn't broken on that shoddy platform... ah yes, the cash gushing by apple, 140safe fallback to other methods when it cannot be used.
147selling defective software works perfectly there). Support for kqueue will
148be detected at runtime, with a safe fallback to other methods when it
149cannot be used.
150 141
151EOF 142Note that kqueue is broken on most operating systems, so it defaults to
143'n' on most platforms that claim to support it. Here is what we know:
152 144
145OS X: completely, utterly broken on at least <= 10.5.
146FreeBSD: broken on at least <= 6.2-STABLE,
147 sockets and pipes *might* work, ptys definitely don't.
148NetBSD: reports indicate that it likely WORKS. Yeah! :)
149OpenBSD: reports indicate that it likely doesn't work
150 (similar problems as on FreeBSD).
151
152EOF
153
154my $can_kqueue = $^O =~ /netbsd/i && -e "/usr/include/sys/event.h";
155
156$DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", $can_kqueue ? "y" : "n") =~ /[yY]/));
157
158print <<EOF;
159
160*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
161
162
163Similarly to the kqueue backend above, EV can take advantage of the
164solaris 10 port interface. Support for port will be detected at runtime,
165with a safe fallback to other methods when it cannot be used.
166
167EOF
168
153if (prompt ("Enable kqueue backend (y/n)?", (-e "/usr/include/sys/event.h") ? "y" : "n") =~ /[yY]/) { 169$DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/));
154 $DEFINE .= " -DEV_USE_KQUEUE";
155}
156 170
157print <<EOF; 171print <<EOF;
158 172
159
160*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 173*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
174
161 175
162EV needs the functions pthread_atfork and clock_gettime. On most systems 176EV needs the functions pthread_atfork and clock_gettime. On most systems
163you need some special libraries for this (such as -lrt and -lpthread). You 177you need some special libraries for this (such as -lrt and -lpthread). You
164can specify additional libraries to provide these calls now, or accept the 178can specify additional libraries to provide these calls (and any other
165default. 179required by EV) now, or accept the default.
166 180
167EOF 181EOF
168 182
183$SOLARIS_LIBS = $^O =~ /solaris/ ? " -lsocket -lnsl" : "";
184
169$LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "-lpthread -lrt"; 185$LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "-lpthread -lrt$SOLARIS_LIBS";
170 186
171 187
172print <<EOF; 188print <<EOF;
173 189
174
175*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 190*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
191
176 192
177EOF 193EOF
178 194
179my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 2.6 } ? (AnyEvent => 2.6) : (); 195my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 2.6 } ? (AnyEvent => 2.6) : ();
180 196

Diff Legend

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