[ViewVC] Diff of: cvs/EV/Makefile.PL

Comparing EV/Makefile.PL (file contents):
Revision 1.50 by root, Thu Dec 30 07:43:03 2010 UTC vs.
Revision 1.68 by root, Tue Feb 18 18:26:47 2020 UTC

…		…
1	use 5.008002;
2
3	use strict qw(vars subs);	1	use strict qw(vars subs);
		2	use Canary::Stability EV => 1, 5.008002;
4	use Config;	3	use Config;
5	use ExtUtils::MakeMaker;	4	use ExtUtils::MakeMaker;
6		5
		6	sub have_inc($) {
		7	scalar grep -r "$_/$_[0]", $Config{usrinc}, split / /, $Config{incpth}
		8	}
		9
		10	my $DEFINE;
		11
7	unless (-e "libev/ev_epoll.c") {	12	unless (-e "libev/ev_iouring.c") {
8	print <<EOF;	13	print <<EOF;
9		14
10	***	15	***
11	*** ERROR: libev is missing or damaged. If you used a CVS check-out of EV,	16	*** 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	17	*** you also have to check-out the "libev" module from the same CVS
44	will otherwise be autodetected at both compile- and runtime. (this setting	49	will otherwise be autodetected at both compile- and runtime. (this setting
45	currently affects the use of nanosleep over select as well).	50	currently affects the use of nanosleep over select as well).
46		51
47	EOF	52	EOF
48		53
49	my $DEFINE .= " -DEV_USE_MONOTONIC=" . (0 + (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/));	54	unless (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/) {
		55	$DEFINE .= " -DEV_USE_MONOTONIC=0";
		56	}
50		57
51	print <<EOF;	58	print <<EOF;
52		59
53	* * * * * * * * * * * * * * * * * *	60	* * * * * * * * * * * * * * * * * *
54		61
…		…
93		100
94	EOF	101	EOF
95		102
96	if (prompt ("Force use of system fd_set for select backend (y/n)?", "n") =~ /[yY]/) {	103	if (prompt ("Force use of system fd_set for select backend (y/n)?", "n") =~ /[yY]/) {
97	$DEFINE .= " -DEV_SELECT_USE_FD_SET";	104	$DEFINE .= " -DEV_SELECT_USE_FD_SET";
98	}	105	}
99	} else {	106	} else {
100	$DEFINE .= " -DEV_USE_SELECT=0";	107	$DEFINE .= " -DEV_USE_SELECT=0";
101	}	108	}
102		109
103	print <<EOF;	110	print <<EOF;
104		111
105	* * * * * * * * * * * * * * * * * *	112	* * * * * * * * * * * * * * * * * *
106		113
107		114
108	The second very portable backend is poll(2). It does not exist on windows	115	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	116	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	117	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.	118	the default here unless you run into compilation problems in ev_poll.c.
112		119
113	EOF	120	EOF
114		121
115	$DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (-e "/usr/include/poll.h") ? "y" : "n") =~ /[yY]/));	122	$DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (have_inc "poll.h") ? "y" : "n") =~ /[yY]/));
116		123
117	print <<EOF;	124	print <<EOF;
118		125
119	* * * * * * * * * * * * * * * * * *	126	* * * * * * * * * * * * * * * * * *
120		127
…		…
127	fall back to using select when epoll isn't available. If unsure, accept	134	fall back to using select when epoll isn't available. If unsure, accept
128	the default.	135	the default.
129		136
130	EOF	137	EOF
131		138
132	my $can_epoll = -e "/usr/include/sys/epoll.h";	139	my $can_epoll = have_inc "sys/epoll.h";
133	$can_epoll = $ENV{EV_EPOLL} if exists $ENV{EV_EPOLL};	140	$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]/));	141	$DEFINE .= " -DEV_USE_EPOLL=" . (0 + (prompt ("Enable epoll backend (y/n)?", $can_epoll ? "y" : "n") =~ /[yY]/));
135		142
136	print <<EOF;	143	print <<EOF;
137		144
138	* * * * * * * * * * * * * * * * * *	145	* * * * * * * * * * * * * * * * * *
139		146
140		147
141	Similarly to the epoll backend above, EV can take advantage of kqueue on	148	Linux 4.18 introduced another event polling interface, this time using
142	many BSD systems. Support for kqueue will be detected at runtime, with a	149	the Linux AIO API. While this API is far superior to epoll and almost
143	safe fallback to other methods when it cannot be used.	150	rivals kqueue, it also suffers from the same issues as kqueue typically
		151	does: only a subset of file types are supported (as of 4.19, I have seen
		152	eventfd, pipes, sockets files and some devices, but no ttys). It also
		153	is subject arbitrary system-wide limits imposed on it. Therefore, this
		154	backend is not used by default, even when it is compiled in, and you have
		155	to request it explicitly, e.g. with LIBEV_FLAGS=64. If unsure, accept the
		156	default.
144		157
		158	EOF
		159
		160	my $can_linuxaio = have_inc "linux/aio_abi.h";
		161	$can_linuxaio = $ENV{EV_LINUXAIO} if exists $ENV{EV_LINUXAIO};
		162	$can_linuxaio = 0 + (prompt ("Enable linux aio backend (y/n)?", $can_linuxaio ? "y" : "n") =~ /[yY]/);
		163	$DEFINE .= " -DEV_USE_LINUXAIO=$can_linuxaio";
		164
		165	if ($can_linuxaio) {
		166	print <<EOF;
		167
		168	* * * * * * * * * * * * * * * * * *
		169
		170
		171	The previously mentioned Linux AIO backend is experimental and will not
		172	be used unless requested explicitly. You can, howeer, choose to make ti a
		173	recommended basckend, which means it will be chosen if available even when
		174	not explicitly asked for, in preference to epoll on GNU/Linux. This option
		175	is likely temporary. When unsure, accept the default.
		176
		177	EOF
		178
		179	my $recommend_linuxaio = 0;
		180	$recommend_linuxaio = $ENV{EV_RECOMMEND_LINUXAIO} if exists $ENV{EV_RECOMMEND_LINUXAIO};
		181	$recommend_linuxaio = 0 + (prompt ("Treat linux aio as a recommended backend (y/n)?", $recommend_linuxaio ? "y" : "n") =~ /[yY]/);
		182	$DEFINE .= " -DEV_RECOMMEND_LINUXAIO=$recommend_linuxaio";
		183	}
		184
		185	print <<EOF;
		186
		187	* * * * * * * * * * * * * * * * * *
		188
		189
		190	Linux 4.19 introduced another event polling interface, "io_uring". While
		191	this API is far superior to epoll and almost rivals linuxaio, it also
		192	suffers from the same issues as kqueue typically does: only a subset of
		193	file types are supported (as of 5.2). It is also very buggy still, and
		194	most importantly, very very slow for most workloads. Therefore, this
		195	backend is not used by default, even when it is compiled in, and you have
		196	to request it explicitly, e.g. with LIBEV_FLAGS=128. If unsure, accept the
		197	default.
		198
		199	EOF
		200
		201	my $can_iouring = have_inc "linux/fs.h";
		202	$can_iouring = $ENV{EV_IOURING} if exists $ENV{EV_IOURING};
		203	$can_iouring = 0 + (prompt ("Enable linux io_uring backend (y/n)?", $can_iouring ? "y" : "n") =~ /[yY]/);
		204	$DEFINE .= " -DEV_USE_IOURING=$can_iouring";
		205
		206	if ($can_iouring) {
		207	print <<EOF;
		208
		209	* * * * * * * * * * * * * * * * * *
		210
		211
		212	The previously mentioned Linux io_uring is experimental and will not be
		213	used unless requested explicitly. You can, howeer, choose to make ti a
		214	recommended basckend, which means it will be chosen if available even when
		215	not explicitly asked for, in preference to epoll on GNU/Linux. This option
		216	is likely temporary. When unsure, accept the default.
		217
		218	EOF
		219
		220	my $recommend_iouring = 0;
		221	$recommend_iouring = $ENV{EV_RECOMMEND_IOURING} if exists $ENV{EV_RECOMMEND_IOURING};
		222	$recommend_iouring = 0 + (prompt ("Treat io_uring as a recommended backend (y/n)?", $recommend_iouring ? "y" : "n") =~ /[yY]/);
		223	$DEFINE .= " -DEV_RECOMMEND_IOURING=$recommend_iouring";
		224	}
		225
		226	print <<EOF;
		227
		228	* * * * * * * * * * * * * * * * * *
		229
		230
		231	EV can take advantage of kqueue on many BSD systems. Support for kqueue
		232	will be detected at runtime, with a safe fallback to other methods when it
		233	cannot be used.
		234
145	Note that kqueue is broken on most operating systems, so by default it	235	Note that kqueue is subtly broken on most operating systems, so by default
146	won't be used on many platforms, but you can still create your own event	236	it won't be used on many platforms, but you can still create your own
147	loop with kqueue backend if you ask specifically for it.	237	event loop with kqueue backend if you ask specifically for it.
148		238
149	Here is what we know:	239	Here is what we know:
150		240
151	NetBSD: partially working in at least 3.1 and later. Yeah! :)	241	NetBSD: partially working in at least 3.1 and later. Yeah! :)
152	FreeBSD: broken on at least 6.2-STABLE, spotty in later versions,	242	FreeBSD: broken on at least 6.2-STABLE, spotty in later versions,
…		…
155	(similar problems as on FreeBSD).	245	(similar problems as on FreeBSD).
156	OS X: completely, utterly broken on at least <= 10.6.	246	OS X: completely, utterly broken on at least <= 10.6.
157		247
158	EOF	248	EOF
159		249
160	my $can_kqueue = -e "/usr/include/sys/event.h";	250	# minix has all the header files, but no implementation. won-der-ful.
		251	my $can_kqueue = have_inc "sys/event.h" && $^O ne "minix";
161	$can_kqueue = $ENV{EV_KQUEUE} if exists $ENV{EV_KQUEUE};	252	$can_kqueue = $ENV{EV_KQUEUE} if exists $ENV{EV_KQUEUE};
162	$DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", $can_kqueue ? "y" : "n") =~ /[yY]/));	253	$DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", $can_kqueue ? "y" : "n") =~ /[yY]/));
163		254
164	print <<EOF;	255	print <<EOF;
165		256
…		…
170	solaris 10 event port interface. Support for event ports will be detected	261	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.	262	at runtime, with a safe fallback to other methods when it cannot be used.
172		263
173	EOF	264	EOF
174		265
175	$DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable event port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/));	266	$DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable event port backend (y/n)?", (have_inc "sys/port.h") ? "y" : "n") =~ /[yY]/));
176		267
177	print <<EOF;	268	print <<EOF;
178		269
179	* * * * * * * * * * * * * * * * * *	270	* * * * * * * * * * * * * * * * * *
180		271
…		…
182	EV needs the functions pthread_atfork and clock_gettime. On most systems	273	EV needs the functions pthread_atfork and clock_gettime. On most systems
183	you need some special libraries for this (such as -lrt and -lpthread). You	274	you need some special libraries for this (such as -lrt and -lpthread). You
184	can specify additional libraries to provide these calls (and any other	275	can specify additional libraries to provide these calls (and any other
185	required by EV) now, or accept the default.	276	required by EV) now, or accept the default.
186		277
		278	On GNU/Linux systems, EV uses the LSB 3.1 __register_atfork function
		279	to avoid the dependency on libpthread, and directly uses the clock_gettime
		280	syscall to avoid a dependency on librt.
		281
187	EOF	282	EOF
188		283
189	my $solaris_libs = $^O =~ /solaris/i ? "-lsocket -lnsl" : "";	284	my $solaris_libs = $^O =~ /solaris/i ? "-lsocket -lnsl" : "";
190	#my $librt = $^O =~ /linux/i ? "-lpthread" : "-lpthread -lrt";	285	my $librt = $^O =~ /linux/i ? "" : "-lpthread -lrt";
191	my $librt = "-lpthread -lrt";	286	my $LIBS = exists $ENV{EV_LIBS} ? $ENV{EV_LIBS} : "$librt $solaris_libs";
192	my $LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "$librt $solaris_libs";	287	$LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", $LIBS;
193		288
194		289
195	print <<EOF;	290	print <<EOF;
196		291
197	* * * * * * * * * * * * * * * * * *	292	* * * * * * * * * * * * * * * * * *
…		…
202	you have the include file and libc support for it, it is usually a good	297	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.	298	idea to enable it, as kernel availability is detected at runtime.
204		299
205	EOF	300	EOF
206		301
207	my $can_inotify = -e "/usr/include/sys/inotify.h";	302	my $can_inotify = have_inc "sys/inotify.h";
208	$can_inotify = $ENV{EV_INOTIFY} if exists $ENV{EV_INOTIFY};	303	$can_inotify = $ENV{EV_INOTIFY} if exists $ENV{EV_INOTIFY};
209	$DEFINE .= " -DEV_USE_INOTIFY=" . (0 + (prompt ("Enable inotify support (y/n)?", $can_inotify ? "y" : "n") =~ /[yY]/));	304	$DEFINE .= " -DEV_USE_INOTIFY=" . (0 + (prompt ("Enable inotify support (y/n)?", $can_inotify ? "y" : "n") =~ /[yY]/));
210		305
211	print <<EOF;	306	print <<EOF;
212		307
…		…
219	your libc must contain the necessary wrapper. Glibc 2.7 and later should	314	your libc must contain the necessary wrapper. Glibc 2.7 and later should
220	have this wrapper.	315	have this wrapper.
221		316
222	EOF	317	EOF
223		318
224	my $can_eventfd = -e "/usr/include/sys/eventfd.h";	319	my $can_eventfd = have_inc "sys/eventfd.h";
225	$can_eventfd = $ENV{EV_EVENTFD} if exists $ENV{EV_EVENTFD};	320	$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]/));	321	$DEFINE .= " -DEV_USE_EVENTFD=" . (0 + (prompt ("Enable linux eventfd support (y/n)?", $can_eventfd ? "y" : "n") =~ /[yY]/));
227		322
228	print <<EOF;	323	print <<EOF;
229		324
…		…
235	this will be probed at runtime, but your libc must contain the necessary	330	this will be probed at runtime, but your libc must contain the necessary
236	wrapper. Glibc 2.7 and later should have this wrapper.	331	wrapper. Glibc 2.7 and later should have this wrapper.
237		332
238	EOF	333	EOF
239		334
240	my $can_signalfd = -e "/usr/include/sys/signalfd.h";	335	my $can_signalfd = have_inc "sys/signalfd.h";
241	$can_signalfd = $ENV{EV_SIGNALFD} if exists $ENV{EV_SIGNALFD};	336	$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]/));	337	$DEFINE .= " -DEV_USE_SIGNALFD=" . (0 + (prompt ("Enable linux signalfd support (y/n)?", $can_signalfd ? "y" : "n") =~ /[yY]/));
243		338
244	print <<EOF;	339	print <<EOF;
245		340
246	* * * * * * * * * * * * * * * * * *	341	* * * * * * * * * * * * * * * * * *
247		342
248		343
		344	Linux kernels can notify userspace about realtime clock timejumps
		345	using timerfd. Libev by default will try to take advantage of this if
		346	possible. You can completely disable the detection and use of timerfd for
		347	this purpose by answering 'n' here. Support for timerfd will otherwise be
		348	autodetected at both compile- and runtime.
		349
		350	EOF
		351
		352	unless (prompt ("Enable optional support for timerfd to detect timejumps (y/n)?", "y") =~ /[yY]/) {
		353	$DEFINE .= " -DEV_USE_TIMERFD=0";
		354	}
		355
		356	print <<EOF;
		357
		358	* * * * * * * * * * * * * * * * * *
		359
		360
		361	Libev contains numerous internal assert() invocations to check for
		362	consistency and user errors. These are normally enabled, but most
		363	perl builds disable this error reporting mechanism by default. You
		364	can re-enable these asserts here. Enabling them might help you catch
		365	programming bugs earlier, but might cause a small slowdown. Also, failures
		366	will be reported by aboritng your program, instead of throwing a perl
		367	exception.
		368
		369	If unsure, enable this if you only use this perl installation for
		370	development, and leave it off for use in production environments.
		371
		372	EOF
		373
		374	my $enable_assertions = 0;
		375	$enable_assertions = 0 + (prompt ("Make sure assertions are enabled? (y/n)?", $enable_assertions ? "y" : "n") =~ /[yY]/);
		376	$DEFINE .= " -DEV_ENABLE_ASSERTIONS=1" if $enable_assertions;
		377
		378	print <<EOF;
		379
		380	* * * * * * * * * * * * * * * * * *
		381
		382
249	Very rarely, people want to tweak EV even more, e.g. to exclude	383	Very rarely, people want to tweak EV even more, e.g. to exclude
250	or incldue certain watcher types or backends. Thisc na be done by adding	384	or include certain watcher types or backends. This can be done by adding
251	extra -D options here, or via the EV_EXTRA_DEFS environment variable.	385	extra -D options here, or via the EV_EXTRA_DEFS environment variable.
252	Normal persons just press enter.	386
		387	For example, if you run into compilation problems because of missing memory
		388	fences (or you just want extra performance), you can tell EV to not support
		389	smp and threads via -DEV_NO_THREADS.
		390
		391	Most people would just press enter.
253		392
254	EOF	393	EOF
255		394
256	$DEFINE .= " " . prompt "Any extra -D options?", "$ENV{EV_EXTRA_DEFS}";	395	$DEFINE .= " " . prompt "Any extra -D options?", "$ENV{EV_EXTRA_DEFS}";
257		396
…		…
270	COMPRESS => 'gzip -9v',	409	COMPRESS => 'gzip -9v',
271	SUFFIX => '.gz',	410	SUFFIX => '.gz',
272	},	411	},
273	depend => {	412	depend => {
274	"EV.c" => "EV/EVAPI.h "	413	"EV.c" => "EV/EVAPI.h "
275	. "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c "	414	. "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c libev/ev_linuxaio.c "
276	. "libev/ev_vars.h libev/ev_wrap.h",	415	. "libev/ev_vars.h libev/ev_wrap.h",
277	},	416	},
278	INC => "-Ilibev",	417	INC => "-Ilibev",
279	DEFINE => "$DEFINE",	418	DEFINE => "$DEFINE",
280	NAME => "EV",	419	NAME => "EV",
281	LIBS => [$LIBS],	420	LIBS => [$LIBS],
282	PREREQ_PM => {	421	PREREQ_PM => {
283	@anyevent,	422	@anyevent,
284	"common::sense" => 0,	423	"common::sense" => 0,
285	},	424	},
		425	CONFIGURE_REQUIRES => { "ExtUtils::MakeMaker" => 6.52, "Canary::Stability" => 0 },
286	VERSION_FROM => "EV.pm",	426	VERSION_FROM => "EV.pm",
287	PM => {	427	PM => {
288	'EV.pm' => '$(INST_LIBDIR)/EV.pm',	428	'EV.pm' => '$(INST_LIB)/EV.pm',
289	'EV/EVAPI.h' => '$(INST_LIBDIR)/EV/EVAPI.h',	429	'EV/EVAPI.h' => '$(INST_LIB)/EV/EVAPI.h',
290	'EV/MakeMaker.pm' => '$(INST_LIBDIR)/EV/MakeMaker.pm',	430	'EV/MakeMaker.pm' => '$(INST_LIB)/EV/MakeMaker.pm',
291	'libev/ev.h' => '$(INST_LIBDIR)/EV/ev.h',	431	'libev/ev.h' => '$(INST_LIB)/EV/ev.h',
292	'libev/ev.pod' => '$(INST_LIBDIR)/EV/libev.pod',	432	'libev/ev.pod' => '$(INST_LIB)/EV/libev.pod',
293	},	433	},
294	MAN3PODS => {	434	MAN3PODS => {
295	'EV.pm' => '$(INST_MAN3DIR)/EV.$(MAN3EXT)',	435	'EV.pm' => '$(INST_MAN3DIR)/EV.$(MAN3EXT)',
296	'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)',	436	'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)',
297	'libev/ev.pod' => '$(INST_MAN3DIR)/EV::libev.$(MAN3EXT)',	437	'libev/ev.pod' => '$(INST_MAN3DIR)/EV::libev.$(MAN3EXT)',
298	},	438	},
299	);	439	);
300		440
301

Diff Legend

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

Comparing EV/Makefile.PL (file contents): Revision 1.50 by root, Thu Dec 30 07:43:03 2010 UTC vs. Revision 1.68 by root, Tue Feb 18 18:26:47 2020 UTC

Diff Legend

Comparing EV/Makefile.PL (file contents):
Revision 1.50 by root, Thu Dec 30 07:43:03 2010 UTC vs.
Revision 1.68 by root, Tue Feb 18 18:26:47 2020 UTC