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

Comparing EV/Makefile.PL (file contents):
Revision 1.21 by root, Fri Nov 16 01:46:26 2007 UTC vs.
Revision 1.22 by root, Sat Nov 17 01:41:33 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*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
136
143 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
145on many BSD systems (it seems to be broken on Mac OS X though, but what 139on many BSD systems (it seems to be broken on Mac OS X though, but what
146isn't broken on that shoddy platform... ah yes, the cash gushing by apple, 140isn't broken on that shoddy platform... ah yes, the cash gushing by apple,
147selling defective software works perfectly there). Support for kqueue will 141selling defective software works perfectly there). Support for kqueue will
148be detected at runtime, with a safe fallback to other methods when it 142be detected at runtime, with a safe fallback to other methods when it
149cannot be used. 143cannot be used.
150 144
151EOF 145EOF
152 146
153if (prompt ("Enable kqueue backend (y/n)?", (-e "/usr/include/sys/event.h") ? "y" : "n") =~ /[yY]/) { 147$DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", (-e "/usr/include/sys/event.h") ? "y" : "n") =~ /[yY]/));
154 $DEFINE .= " -DEV_USE_KQUEUE";
155}
156 148
157print <<EOF; 149print <<EOF;
158 150
159
160*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 151*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
152
161 153
162Similarly to the kqueue backend above, EV can take advantage of the 154Similarly to the kqueue backend above, EV can take advantage of the
163solaris 10 port interface. Support for port will be detected at runtime, 155solaris 10 port interface. Support for port will be detected at runtime,
164with a safe fallback to other methods when it cannot be used. 156with a safe fallback to other methods when it cannot be used.
165 157
166EOF 158EOF
167 159
168if (prompt ("Enable port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/) { 160$DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/));
169 $DEFINE .= " -DEV_USE_PORT";
170}
171 161
172print <<EOF; 162print <<EOF;
173 163
174
175*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 164*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
165
176 166
177EV needs the functions pthread_atfork and clock_gettime. On most systems 167EV needs the functions pthread_atfork and clock_gettime. On most systems
178you need some special libraries for this (such as -lrt and -lpthread). You 168you need some special libraries for this (such as -lrt and -lpthread). You
179can specify additional libraries to provide these calls now, or accept the 169can specify additional libraries to provide these calls now, or accept the
180default. 170default.
… …
184$LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "-lpthread -lrt"; 174$LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "-lpthread -lrt";
185 175
186 176
187print <<EOF; 177print <<EOF;
188 178
189
190*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 179*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
180
191 181
192EOF 182EOF
193 183
194my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 2.6 } ? (AnyEvent => 2.6) : (); 184my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 2.6 } ? (AnyEvent => 2.6) : ();
195 185

Diff Legend

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