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

Comparing EV/Makefile.PL (file contents):
Revision 1.5 by root, Mon Oct 29 08:48:07 2007 UTC vs.
Revision 1.34 by root, Thu Oct 2 12:26:25 2008 UTC

1	use 5.006;	1	use 5.006;
2		2
		3	use Config;
3	use ExtUtils::MakeMaker;	4	use ExtUtils::MakeMaker;
4		5
		6	unless (-e "libev/ev_epoll.c") {
5	print <<EOF;	7	print <<EOF;
6		8
7	***	9	***
8	*** You need to install libevent (http://monkey.org/~provos/libevent/) separately	10	*** ERROR: libev is missing or damaged. If you used a CVS check-out of EV,
9	*** first in a way so that the Makefile.PL can find both -levent and the event.h	11	*** you also have to check-out the "libev" module from the same CVS
10	*** and evdns.h include files.	12	*** repository into the EV dir (i.e. EV/libev from outside).
11	***	13	***
12	*** Version 1.3e or higher is recommended, but older 1.3 versions likely work too.
13	***
14		14
15	EOF	15	EOF
		16	exit 1;
		17	}
		18
		19	print <<EOF;
		20
		21	* * * * * * * * * * * * * * * * * *
		22
		23
		24	Welcome to EV configuration. If you are in a hurry, just press return here
		25	and hope for the best. The defaults should usually do.
		26
		27	EOF
		28
		29	if (prompt ("Skip further questions and use defaults (y/n)?", "y") =~ /[yY]/) {
		30	$ENV{PERL_MM_USE_DEFAULT} = 1;
		31	}
		32
		33	print <<EOF;
		34
		35	* * * * * * * * * * * * * * * * * *
		36
		37
		38	POSIX optionally offers support for a monotonic clock source. EV
		39	can take advantage of this clock source to detect time jumps
		40	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	the monotonic clock by answering 'n' here. Support for this clock type
		43	will otherwise be autodetected at both compile- and runtime. (this setting
		44	currently affects the use of nanosleep over select as well).
		45
		46	EOF
		47
		48	$DEFINE .= " -DEV_USE_MONOTONIC=" . (0 + (prompt ("Enable optional support for CLOCK_MONOTONIC (y/n)?", "y") =~ /[yY]/));
		49
		50	print <<EOF;
		51
		52	* * * * * * * * * * * * * * * * * *
		53
		54
		55	POSIX optionally offers support for a (potentially) high-resolution
		56	realtime clock interface. In a good implementation, using it is faster
		57	than the normal method of using gettimeofday. Unfortunately, this option
		58	is also bound to be broken on some systems, so you can disable use and
		59	probing of this feature altogether here. Otherwise support for this clock
		60	type will be autodetected at compiletime.
		61
		62	EOF
		63
		64	$DEFINE .= " -DEV_USE_REALTIME=" . (0 + (prompt ("Prefer clock_gettime (CLOCK_REALTIME) over gettimeofday (y/n)?", "y") =~ /[yY]/));
		65
		66	print <<EOF;
		67
		68	* * * * * * * * * * * * * * * * * *
		69
		70
		71	Another useful bit of functionality is the Linux eventfd, which is useful
		72	for faster signal handling (don't care) and intra-thread communications
		73	(mostly useful for embedding). Kernel support for this will be probed at
		74	runtime, but your libc must contain the necessary wrapper. Glibc 2.7 and
		75	later should have this wrapper.
		76
		77	EOF
		78
		79	$DEFINE .= " -DEV_USE_EVENTFD=" . (0 + (prompt ("Enable linux eventfd support (y/n)?", (-e "/usr/include/sys/eventfd.h") \|\| $ENV{EV_EVENTFD} ? "y" : "n") =~ /[yY]/));
		80
		81	print <<EOF;
		82
		83	* * * * * * * * * * * * * * * * * *
		84
		85
		86	EV can use various backends with various portability issue. The select
		87	backend is the most portable and makes for a good fallback, but it can be
		88	limited to a low number of file descriptors and/or might not compile. If
		89	you have problems with compiling ev_select.c, you might try to play around
		90	with disabling it here, or forcing it to use the fd_set provided by your
		91	OS, via the next question. I highly recommend keeping it in.
		92
		93	EOF
		94
		95	if (prompt ("Enable select backend (y/n)?", "y") =~ /[yY]/) {
		96	$DEFINE .= " -DEV_USE_SELECT=1";
		97
		98	print <<EOF;
		99
		100	* * * * * * * * * * * * * * * * * *
		101
		102
		103	The select backend can operate in two modes. One uses the system-provided
		104	fd_set and is usually limited to 1024 file descriptors (64 on windows),
		105	the other requires your header files to define NFDBITS and declare a
		106	suitable fd_mask type. If you run into problems compiling ev_select.c, you
		107	can try forcing the use of the system fd_set here.
		108
		109	EOF
		110
		111	if (prompt ("Force use of system fd_set for select backend (y/n)?", "n") =~ /[yY]/) {
		112	$DEFINE .= " -DEV_SELECT_USE_FD_SET";
		113	}
		114	} else {
		115	$DEFINE .= " -DEV_USE_SELECT=0";
		116	}
		117
		118	print <<EOF;
		119
		120	* * * * * * * * * * * * * * * * * *
		121
		122
		123	The second very portable backend is poll(2). It does not exist on windows
		124	and various versions of Mac OS X (and on the other versions it simply
		125	doesn't work), but works basically everywhere else. It is recommended to use
		126	the default here unless you run into compile problems in ev_poll.c.
		127
		128	EOF
		129
		130	$DEFINE .= " -DEV_USE_POLL=" . (0 + (prompt ("Enable poll backend (y/n)?", (-e "/usr/include/poll.h") ? "y" : "n") =~ /[yY]/));
		131
		132	print <<EOF;
		133
		134	* * * * * * * * * * * * * * * * * *
		135
		136
		137	Select and poll make it hard to write efficient servers, especially if the
		138	number of active connections is much lower than the watched ones. GNU/Linux
		139	systems have a more scalable method called "epoll", which EV can use. For
		140	this to work, both your kernel and glibc have to support epoll, but if you
		141	can compile it, the detection will be done at runtime, and EV will safely
		142	fall back to using select when epoll isn't available. If unsure, accept
		143	the default.
		144
		145	EOF
		146
		147	$DEFINE .= " -DEV_USE_EPOLL=" . (0 + (prompt ("Enable epoll backend (y/n)?", (-e "/usr/include/sys/epoll.h") ? "y" : "n") =~ /[yY]/));
		148
		149	print <<EOF;
		150
		151	* * * * * * * * * * * * * * * * * *
		152
		153
		154	Similarly to the epoll backend above, EV can take advantage of kqueue on
		155	many BSD systems. Support for kqueue will be detected at runtime, with a
		156	safe fallback to other methods when it cannot be used.
		157
		158	Note that kqueue is broken on most operating systems, so by default it
		159	won't be used on many platforms, but you can still create your own event
		160	loop with qkueue backend.
		161
		162	Here is what we know:
		163
		164	NetBSD: partially working in at least 3.1. Yeah! :)
		165	FreeBSD: broken on at least 6.2-STABLE,
		166	sockets likely work, ptys definitely don't.
		167	OpenBSD: reports indicate that it likely doesn't work
		168	(similar problems as on FreeBSD).
		169	OS X: completely, utterly broken on at least < 10.5.
		170
		171	EOF
		172
		173	my $can_kqueue = -e "/usr/include/sys/event.h";
		174
		175	$DEFINE .= " -DEV_USE_KQUEUE=" . (0 + (prompt ("Enable kqueue backend (y/n)?", $can_kqueue ? "y" : "n") =~ /[yY]/));
		176
		177	print <<EOF;
		178
		179	* * * * * * * * * * * * * * * * * *
		180
		181
		182	Similarly to the kqueue backend above, EV can take advantage of the
		183	solaris 10 event port interface. Support for event ports will be detected
		184	at runtime, with a safe fallback to other methods when it cannot be used.
		185
		186	EOF
		187
		188	$DEFINE .= " -DEV_USE_PORT=" . (0 + (prompt ("Enable event port backend (y/n)?", (-e "/usr/include/sys/port.h") ? "y" : "n") =~ /[yY]/));
		189
		190	print <<EOF;
		191
		192	* * * * * * * * * * * * * * * * * *
		193
		194
		195	EV needs the functions pthread_atfork and clock_gettime. On most systems
		196	you need some special libraries for this (such as -lrt and -lpthread). You
		197	can specify additional libraries to provide these calls (and any other
		198	required by EV) now, or accept the default.
		199
		200	EOF
		201
		202	$SOLARIS_LIBS = $^O =~ /solaris/ ? " -lsocket -lnsl" : "";
		203
		204	$LIBS = prompt "Extra libraries for pthread_atfork and clock_gettime?", "-lpthread -lrt$SOLARIS_LIBS";
		205
		206
		207	print <<EOF;
		208
		209	* * * * * * * * * * * * * * * * * *
		210
		211
		212	A backend of a different kind is the Linux inotify(7) interface, which can
		213	be used to speed up (and reduce resource consumption) of stat watchers. If
		214	you have it, it is usually a good idea to enable it.
		215
		216	EOF
		217
		218	my $can_inotify = -e "/usr/include/sys/inotify.h";
		219
		220	$DEFINE .= " -DEV_USE_INOTIFY=" . (0 + (prompt ("Enable inotify support (y/n)?", $can_inotify ? "y" : "n") =~ /[yY]/));
		221
		222	print <<EOF;
		223
		224	* * * * * * * * * * * * * * * * * *
		225
		226
		227	EOF
		228
		229	my @anyevent = eval { require AnyEvent; $AnyEvent::VERSION < 2.6 } ? (AnyEvent => 2.6) : ();
16		230
17	WriteMakefile(	231	WriteMakefile(
18	dist => {	232	dist => {
19	PREOP => 'pod2text EV.pm \| tee README >$(DISTVNAME)/README; chmod -R u=rwX,go=rX . ;',	233	PREOP => 'pod2text EV.pm \| tee README >$(DISTVNAME)/README; chmod -R u=rwX,go=rX . ;',
20	COMPRESS => 'gzip -9v',	234	COMPRESS => 'gzip -9v',
21	SUFFIX => '.gz',	235	SUFFIX => '.gz',
22	},	236	},
23	LIBS => ["-levent"],	237	depend => {
		238	"EV.c" => "EV/EVAPI.h "
		239	. "libev/ev.c libev/ev.h libev/ev_epoll.c libev/ev_select.c libev/ev_kqueue.c libev/ev_poll.c "
		240	. "libev/ev_vars.h libev/ev_wrap.h",
		241	},
		242	INC => "-Ilibev",
		243	DEFINE => "$DEFINE",
24	NAME => "EV",	244	NAME => "EV",
		245	LIBS => [$LIBS],
		246	PREREQ_PM => {
		247	@anyevent,
		248	},
25	VERSION_FROM => "EV.pm",	249	VERSION_FROM => "EV.pm",
26	PM => {	250	PM => {
27	'EV.pm' => '$(INST_LIBDIR)/EV.pm',	251	'EV.pm' => '$(INST_LIBDIR)/EV.pm',
28	'EV/AnyEvent.pm' => '$(INST_LIBDIR)/EV/AnyEvent.pm',
29	'EV/DNS.pm' => '$(INST_LIBDIR)/EV/DNS.pm',
30	'EV/EVAPI.h' => '$(INST_LIBDIR)/EV/EVAPI.h',	252	'EV/EVAPI.h' => '$(INST_LIBDIR)/EV/EVAPI.h',
31	'EV/MakeMaker.pm' => '$(INST_LIBDIR)/EV/MakeMaker.pm',	253	'EV/MakeMaker.pm' => '$(INST_LIBDIR)/EV/MakeMaker.pm',
		254	'libev/ev.h' => '$(INST_LIBDIR)/EV/ev.h',
		255	'libev/ev.pod' => '$(INST_LIBDIR)/EV/c_doc.pod',
32	},	256	},
		257	MAN3PODS => {
		258	'EV.pm' => '$(INST_MAN3DIR)/EV.$(MAN3EXT)',
		259	'EV/MakeMaker.pm' => '$(INST_MAN3DIR)/EV::MakeMaker.$(MAN3EXT)',
		260	'libev/ev.pod' => '$(INST_MAN3DIR)/EV::c_doc.$(MAN3EXT)',
		261	},
33	);	262	);
34		263
		264

Diff Legend

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

Comparing EV/Makefile.PL (file contents): Revision 1.5 by root, Mon Oct 29 08:48:07 2007 UTC vs. Revision 1.34 by root, Thu Oct 2 12:26:25 2008 UTC

Diff Legend

Comparing EV/Makefile.PL (file contents):
Revision 1.5 by root, Mon Oct 29 08:48:07 2007 UTC vs.
Revision 1.34 by root, Thu Oct 2 12:26:25 2008 UTC