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

Comparing EV/Makefile.PL (file contents):
Revision 1.57 by root, Sat Jun 20 11:11:01 2015 UTC vs.
Revision 1.65 by root, Fri Nov 22 14:43:49 2019 UTC

…		…
7	scalar grep -r "$_/$_[0]", $Config{usrinc}, split / /, $Config{incpth}	7	scalar grep -r "$_/$_[0]", $Config{usrinc}, split / /, $Config{incpth}
8	}	8	}
9		9
10	my $DEFINE;	10	my $DEFINE;
11		11
12	unless (-e "libev/ev_epoll.c") {	12	unless (-e "libev/ev_iouring.c") {
13	print <<EOF;	13	print <<EOF;
14		14
15	***	15	***
16	*** 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,
17	*** 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
…		…
113		113
114		114
115	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
116	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
117	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
118	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.
119		119
120	EOF	120	EOF
121		121
122	$DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (have_inc "poll.h") ? "y" : "n") =~ /[yY]/));	122	$DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (have_inc "poll.h") ? "y" : "n") =~ /[yY]/));
123		123
…		…
143	print <<EOF;	143	print <<EOF;
144		144
145	* * * * * * * * * * * * * * * * * *	145	* * * * * * * * * * * * * * * * * *
146		146
147		147
148	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
149	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
150	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.
151		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
152	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
153	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
154	loop with kqueue backend if you ask specifically for it.	237	event loop with kqueue backend if you ask specifically for it.
155		238
156	Here is what we know:	239	Here is what we know:
157		240
158	NetBSD: partially working in at least 3.1 and later. Yeah! :)	241	NetBSD: partially working in at least 3.1 and later. Yeah! :)
159	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,
…		…
162	(similar problems as on FreeBSD).	245	(similar problems as on FreeBSD).
163	OS X: completely, utterly broken on at least <= 10.6.	246	OS X: completely, utterly broken on at least <= 10.6.
164		247
165	EOF	248	EOF
166		249
		250	# minix has all the header files, but no implementation. won-der-ful.
167	my $can_kqueue = have_inc "sys/event.h";	251	my $can_kqueue = have_inc "sys/event.h" && $^O ne "minix";
168	$can_kqueue = $ENV{EV_KQUEUE} if exists $ENV{EV_KQUEUE};	252	$can_kqueue = $ENV{EV_KQUEUE} if exists $ENV{EV_KQUEUE};
169	$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]/));
170		254
171	print <<EOF;	255	print <<EOF;
172		256
…		…
255	print <<EOF;	339	print <<EOF;
256		340
257	* * * * * * * * * * * * * * * * * *	341	* * * * * * * * * * * * * * * * * *
258		342
259		343
		344	Libev contains numerous internal assert() invocations to check for
		345	consistency and user errors. These are normally enabled, but most
		346	perl builds disable this error reporting mechanism by default. You
		347	can re-enable these asserts here. Enabling them might help you catch
		348	programming bugs earlier, but might cause a small slowdown. Also, failures
		349	will be reported by aboritng your program, instead of throwing a perl
		350	exception.
		351
		352	If unsure, enable this if you only use this perl installation for
		353	development, and leave it off for use in production environments.
		354
		355	EOF
		356
		357	my $enable_assertions = 0;
		358	$enable_assertions = 0 + (prompt ("Make sure assertions are enabled? (y/n)?", $enable_assertions ? "y" : "n") =~ /[yY]/);
		359	$DEFINE .= " -DEV_ENABLE_ASERTIONS=1" if $enable_assertions;
		360
		361	print <<EOF;
		362
		363	* * * * * * * * * * * * * * * * * *
		364
		365
260	Very rarely, people want to tweak EV even more, e.g. to exclude	366	Very rarely, people want to tweak EV even more, e.g. to exclude
261	or include certain watcher types or backends. This can be done by adding	367	or include certain watcher types or backends. This can be done by adding
262	extra -D options here, or via the EV_EXTRA_DEFS environment variable.	368	extra -D options here, or via the EV_EXTRA_DEFS environment variable.
263		369
264	For example, if you run into compile problems because of missing memory	370	For example, if you run into compilation problems because of missing memory
265	fences (or you just want extra performance), you can tell EV to not support	371	fences (or you just want extra performance), you can tell EV to not support
266	smp and threads via -DEV_NO_THREADS.	372	smp and threads via -DEV_NO_THREADS.
267		373
268	Normal persons just press enter.	374	Normal persons just press enter.
269		375
…		…
286	COMPRESS => 'gzip -9v',	392	COMPRESS => 'gzip -9v',
287	SUFFIX => '.gz',	393	SUFFIX => '.gz',
288	},	394	},
289	depend => {	395	depend => {
290	"EV.c" => "EV/EVAPI.h "	396	"EV.c" => "EV/EVAPI.h "
291	. "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c "	397	. "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 "
292	. "libev/ev_vars.h libev/ev_wrap.h",	398	. "libev/ev_vars.h libev/ev_wrap.h",
293	},	399	},
294	INC => "-Ilibev",	400	INC => "-Ilibev",
295	DEFINE => "$DEFINE",	401	DEFINE => "$DEFINE",
296	NAME => "EV",	402	NAME => "EV",
…		…
313	'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)',	419	'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)',
314	'libev/ev.pod' => '$(INST_MAN3DIR)/EV::libev.$(MAN3EXT)',	420	'libev/ev.pod' => '$(INST_MAN3DIR)/EV::libev.$(MAN3EXT)',
315	},	421	},
316	);	422	);
317		423
318

Diff Legend

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

Comparing EV/Makefile.PL (file contents): Revision 1.57 by root, Sat Jun 20 11:11:01 2015 UTC vs. Revision 1.65 by root, Fri Nov 22 14:43:49 2019 UTC

Diff Legend

Comparing EV/Makefile.PL (file contents):
Revision 1.57 by root, Sat Jun 20 11:11:01 2015 UTC vs.
Revision 1.65 by root, Fri Nov 22 14:43:49 2019 UTC