ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/deliantra/server/lib/cf.pm

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.264 by root, Sun May 6 05:44:48 2007 UTC vs.
Revision 1.347 by root, Thu Aug 30 05:16:09 2007 UTC

…		…
10	use Event;	10	use Event;
11	use Opcode;	11	use Opcode;
12	use Safe;	12	use Safe;
13	use Safe::Hole;	13	use Safe::Hole;
14		14
15	use Coro 3.61 ();	15	use Coro 3.64 ();
16	use Coro::State;	16	use Coro::State;
17	use Coro::Handle;	17	use Coro::Handle;
18	use Coro::Event;	18	use Coro::Event;
19	use Coro::Timer;	19	use Coro::Timer;
20	use Coro::Signal;	20	use Coro::Signal;
21	use Coro::Semaphore;	21	use Coro::Semaphore;
22	use Coro::AIO;	22	use Coro::AIO;
23	use Coro::Storable;	23	use Coro::Storable;
		24	use Coro::Util ();
24		25
		26	use JSON::XS ();
25	use BDB ();	27	use BDB ();
26	use Data::Dumper;	28	use Data::Dumper;
27	use Digest::MD5;	29	use Digest::MD5;
28	use Fcntl;	30	use Fcntl;
29	use YAML::Syck ();	31	use YAML::Syck ();
30	use IO::AIO 2.32 ();	32	use IO::AIO 2.32 ();
31	use Time::HiRes;	33	use Time::HiRes;
32	use Compress::LZF;	34	use Compress::LZF;
		35	use Digest::MD5 ();
33		36
34	# configure various modules to our taste	37	# configure various modules to our taste
35	#	38	#
36	$Storable::canonical = 1; # reduce rsync transfers	39	$Storable::canonical = 1; # reduce rsync transfers
37	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator	40	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
…		…
49	our %COMMAND = ();	52	our %COMMAND = ();
50	our %COMMAND_TIME = ();	53	our %COMMAND_TIME = ();
51		54
52	our @EXTS = (); # list of extension package names	55	our @EXTS = (); # list of extension package names
53	our %EXTCMD = ();	56	our %EXTCMD = ();
		57	our %EXTICMD = ();
54	our %EXT_CORO = (); # coroutines bound to extensions	58	our %EXT_CORO = (); # coroutines bound to extensions
55	our %EXT_MAP = (); # pluggable maps	59	our %EXT_MAP = (); # pluggable maps
56		60
57	our $RELOAD; # number of reloads so far	61	our $RELOAD; # number of reloads so far
58	our @EVENT;	62	our @EVENT;
…		…
90	our $LINK_MAP; # the special {link} map, which is always available	94	our $LINK_MAP; # the special {link} map, which is always available
91		95
92	# used to convert map paths into valid unix filenames by replacing / by ∕	96	# used to convert map paths into valid unix filenames by replacing / by ∕
93	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons	97	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
94		98
		99	our $LOAD; # a number between 0 (idle) and 1 (too many objects)
		100	our $LOADAVG; # same thing, but with alpha-smoothing
		101	our $tick_start; # for load detecting purposes
		102
95	binmode STDOUT;	103	binmode STDOUT;
96	binmode STDERR;	104	binmode STDERR;
97		105
98	# read virtual server time, if available	106	# read virtual server time, if available
99	unless ($RUNTIME || !-e "$LOCALDIR/runtime") {	107	unless ($RUNTIME || !-e "$LOCALDIR/runtime") {
…		…
139		147
140	=item $cf::TICK	148	=item $cf::TICK
141		149
142	The interval between server ticks, in seconds.	150	The interval between server ticks, in seconds.
143		151
		152	=item $cf::LOADAVG
		153
		154	The current CPU load on the server (alpha-smoothed), as a value between 0
		155	(none) and 1 (overloaded), indicating how much time is spent on processing
		156	objects per tick. Healthy values are < 0.5.
		157
		158	=item $cf::LOAD
		159
		160	The raw value load value from the last tick.
		161
144	=item %cf::CFG	162	=item %cf::CFG
145		163
146	Configuration for the server, loaded from C</etc/crossfire/config>, or	164	Configuration for the server, loaded from C</etc/crossfire/config>, or
147	from wherever your confdir points to.	165	from wherever your confdir points to.
148		166
149	=item cf::wait_for_tick, cf::wait_for_tick_begin	167	=item cf::wait_for_tick, cf::wait_for_tick_begin
150		168
151	These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only	169	These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only
152	returns directly I<after> the tick processing (and consequently, can only wake one process	170	returns directly I<after> the tick processing (and consequently, can only wake one process
153	per tick), while cf::wait_for_tick wakes up all waiters after tick processing.	171	per tick), while cf::wait_for_tick wakes up all waiters after tick processing.
		172
		173	=item @cf::INVOKE_RESULTS
		174
		175	This array contains the results of the last C<invoke ()> call. When
		176	C<cf::override> is called C<@cf::INVOKE_RESULTS> is set to the parameters of
		177	that call.
154		178
155	=back	179	=back
156		180
157	=cut	181	=cut
158		182
…		…
173	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';	197	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
174	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';	198	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
175	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';	199	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
176	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';	200	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
177	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';	201	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
		202	@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
178	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	203	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; # not really true (yet)
179		204
180	# we bless all objects into (empty) derived classes to force a method lookup	205	# we bless all objects into (empty) derived classes to force a method lookup
181	# within the Safe compartment.	206	# within the Safe compartment.
182	for my $pkg (qw(	207	for my $pkg (qw(
183	cf::global cf::attachable	208	cf::global cf::attachable
…		…
191	}	216	}
192		217
193	$Event::DIED = sub {	218	$Event::DIED = sub {
194	warn "error in event callback: @_";	219	warn "error in event callback: @_";
195	};	220	};
		221
		222	#############################################################################
196		223
197	=head2 UTILITY FUNCTIONS	224	=head2 UTILITY FUNCTIONS
198		225
199	=over 4	226	=over 4
200		227
…		…
219	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;	246	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
220	$d	247	$d
221	} || "[unable to dump $_[0]: '$@']";	248	} || "[unable to dump $_[0]: '$@']";
222	}	249	}
223		250
224	use JSON::XS qw(to_json from_json); # TODO# replace by JSON::PC once working
225
226	=item $ref = cf::from_json $json	251	=item $ref = cf::from_json $json
227		252
228	Converts a JSON string into the corresponding perl data structure.	253	Converts a JSON string into the corresponding perl data structure.
229		254
230	=item $json = cf::to_json $ref	255	=item $json = cf::to_json $ref
231		256
232	Converts a perl data structure into its JSON representation.	257	Converts a perl data structure into its JSON representation.
		258
		259	=cut
		260
		261	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
		262
		263	sub to_json ($) { $json_coder->encode ($_[0]) }
		264	sub from_json ($) { $json_coder->decode ($_[0]) }
233		265
234	=item cf::lock_wait $string	266	=item cf::lock_wait $string
235		267
236	Wait until the given lock is available. See cf::lock_acquire.	268	Wait until the given lock is available. See cf::lock_acquire.
237		269
…		…
239		271
240	Wait until the given lock is available and then acquires it and returns	272	Wait until the given lock is available and then acquires it and returns
241	a Coro::guard object. If the guard object gets destroyed (goes out of scope,	273	a Coro::guard object. If the guard object gets destroyed (goes out of scope,
242	for example when the coroutine gets canceled), the lock is automatically	274	for example when the coroutine gets canceled), the lock is automatically
243	returned.	275	returned.
		276
		277	Locks are *not* recursive, locking from the same coro twice results in a
		278	deadlocked coro.
244		279
245	Lock names should begin with a unique identifier (for example, cf::map::find	280	Lock names should begin with a unique identifier (for example, cf::map::find
246	uses map_find and cf::map::load uses map_load).	281	uses map_find and cf::map::load uses map_load).
247		282
248	=item $locked = cf::lock_active $string	283	=item $locked = cf::lock_active $string
…		…
291	};	326	};
292	$TICK_WATCHER->stop;	327	$TICK_WATCHER->stop;
293	$guard	328	$guard
294	}	329	}
295		330
		331	=item cf::get_slot $time[, $priority[, $name]]
		332
		333	Allocate $time seconds of blocking CPU time at priority C<$priority>:
		334	This call blocks and returns only when you have at least C<$time> seconds
		335	of cpu time till the next tick. The slot is only valid till the next cede.
		336
		337	The optional C<$name> can be used to identify the job to run. It might be
		338	used for statistical purposes and should identify the same time-class.
		339
		340	Useful for short background jobs.
		341
		342	=cut
		343
		344	our @SLOT_QUEUE;
		345	our $SLOT_QUEUE;
		346
		347	$SLOT_QUEUE->cancel if $SLOT_QUEUE;
		348	$SLOT_QUEUE = Coro::async {
		349	my $signal = new Coro::Signal;
		350
		351	while () {
		352	next_job:
		353	my $avail = cf::till_tick;
		354	if ($avail > 0.01) {
		355	for (0 .. $#SLOT_QUEUE) {
		356	if ($SLOT_QUEUE[$_][0] < $avail) {
		357	my $job = splice @SLOT_QUEUE, $_, 1, ();
		358	$job->[2]->send;
		359	Coro::cede;
		360	goto next_job;
		361	}
		362	}
		363	}
		364
		365	if (@SLOT_QUEUE) {
		366	# we do not use wait_For_tick() as it returns immediately when tick is inactive
		367	push @cf::WAIT_FOR_TICK, $signal;
		368	$signal->wait;
		369	} else {
		370	Coro::schedule;
		371	}
		372	}
		373	};
		374
		375	sub get_slot($;$$) {
		376	my ($time, $pri, $name) = @_;
		377
		378	$time = $TICK * .6 if $time > $TICK * .6;
		379	my $sig = new Coro::Signal;
		380
		381	push @SLOT_QUEUE, [$time, $pri, $sig, $name];
		382	@SLOT_QUEUE = sort { $b->[1] <=> $a->[1] } @SLOT_QUEUE;
		383	$SLOT_QUEUE->ready;
		384	$sig->wait;
		385	}
		386
296	=item cf::async { BLOCK }	387	=item cf::async { BLOCK }
297		388
298	Currently the same as Coro::async_pool, meaning you cannot use	389	Currently the same as Coro::async_pool, meaning you cannot use
299	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only	390	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
300	thing you are allowed to do is call C<prio> on it.	391	thing you are allowed to do is call C<prio> on it.
…		…
303		394
304	BEGIN { *async = \&Coro::async_pool }	395	BEGIN { *async = \&Coro::async_pool }
305		396
306	=item cf::sync_job { BLOCK }	397	=item cf::sync_job { BLOCK }
307		398
308	The design of crossfire+ requires that the main coro ($Coro::main) is	399	The design of Crossfire TRT requires that the main coroutine ($Coro::main)
309	always able to handle events or runnable, as crossfire+ is only partly	400	is always able to handle events or runnable, as Crossfire TRT is only
310	reentrant. Thus "blocking" it by e.g. waiting for I/O is not acceptable.	401	partly reentrant. Thus "blocking" it by e.g. waiting for I/O is not
		402	acceptable.
311		403
312	If it must be done, put the blocking parts into C<sync_job>. This will run	404	If it must be done, put the blocking parts into C<sync_job>. This will run
313	the given BLOCK in another coroutine while waiting for the result. The	405	the given BLOCK in another coroutine while waiting for the result. The
314	server will be frozen during this time, so the block should either finish	406	server will be frozen during this time, so the block should either finish
315	fast or be very important.	407	fast or be very important.
…		…
318		410
319	sub sync_job(&) {	411	sub sync_job(&) {
320	my ($job) = @_;	412	my ($job) = @_;
321		413
322	if ($Coro::current == $Coro::main) {	414	if ($Coro::current == $Coro::main) {
		415	my $time = Event::time;
		416
323	# this is the main coro, too bad, we have to block	417	# this is the main coro, too bad, we have to block
324	# till the operation succeeds, freezing the server :/	418	# till the operation succeeds, freezing the server :/
325		419
326	# TODO: use suspend/resume instead	420	# TODO: use suspend/resume instead
327	# (but this is cancel-safe)	421	# (but this is cancel-safe)
…		…
338		432
339	while ($busy) {	433	while ($busy) {
340	Coro::cede or Event::one_event;	434	Coro::cede or Event::one_event;
341	}	435	}
342		436
		437	$time = Event::time - $time;
		438
		439	LOG llevError | logBacktrace, Carp::longmess "long sync job"
		440	if $time > $TICK * 0.5 && $TICK_WATCHER->is_active;
		441
		442	$tick_start += $time; # do not account sync jobs to server load
		443
343	wantarray ? @res : $res[0]	444	wantarray ? @res : $res[0]
344	} else {	445	} else {
345	# we are in another coroutine, how wonderful, everything just works	446	# we are in another coroutine, how wonderful, everything just works
346		447
347	$job->()	448	$job->()
…		…
366	$EXT_CORO{$coro+0} = $coro;	467	$EXT_CORO{$coro+0} = $coro;
367		468
368	$coro	469	$coro
369	}	470	}
370		471
371	sub write_runtime {	472	=item fork_call { }, $args
372	my $runtime = "$LOCALDIR/runtime";
373		473
374	# first touch the runtime file to show we are still running:	474	Executes the given code block with the given arguments in a seperate
375	# the fsync below can take a very very long time.	475	process, returning the results. Everything must be serialisable with
		476	Coro::Storable. May, of course, block. Note that the executed sub may
		477	never block itself or use any form of Event handling.
376		478
377	warn "touching runtime...\n";#d#	479	=cut
378	if (my $fh = aio_open $runtime, O_WRONLY, 0) {
379	utime undef, undef, $fh;
380	}
381		480
382	my $guard = cf::lock_acquire "write_runtime";	481	sub fork_call(&@) {
		482	my ($cb, @args) = @_;
383		483
384	warn "starting to write runtime...\n";#d#	484	# we seemingly have to make a local copy of the whole thing,
385	my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644	485	# otherwise perl prematurely frees the stuff :/
386	or return;	486	# TODO: investigate and fix (liekly this will be rather laborious)
387		487
388	my $value = $cf::RUNTIME + 90 + 10;	488	my @res = Coro::Util::fork_eval {
389	# 10 is the runtime save interval, for a monotonic clock	489	reset_signals;
390	# 60 allows for the watchdog to kill the server.	490	&$cb
		491	}, @args;
391		492
392	(aio_write $fh, 0, (length $value), $value, 0) <= 0	493	wantarray ? @res : $res[-1]
393	and return;	494	}
394		495
395	# always fsync - this file is important	496	=item $value = cf::db_get $family => $key
396	aio_fsync $fh
397	and return;
398		497
399	# touch it again to show we are up-to-date	498	Returns a single value from the environment database.
400	utime undef, undef, $fh;
401		499
402	close $fh	500	=item cf::db_put $family => $key => $value
403	or return;
404		501
405	aio_rename "$runtime~", $runtime	502	Stores the given C<$value> in the family. It can currently store binary
406	and return;	503	data only (use Compress::LZF::sfreeze_cr/sthaw to convert to/from binary).
407		504
408	warn "... done writing runtime.\n";#d#	505	=cut
409		506
		507	our $DB;
		508
		509	sub db_init {
		510	unless ($DB) {
		511	$DB = BDB::db_create $DB_ENV;
		512
		513	cf::sync_job {
		514	eval {
		515	$DB->set_flags (BDB::CHKSUM);
		516
		517	BDB::db_open $DB, undef, "db", undef, BDB::BTREE,
		518	BDB::CREATE | BDB::AUTO_COMMIT, 0666;
		519	cf::cleanup "db_open(db): $!" if $!;
		520	};
		521	cf::cleanup "db_open(db): $@" if $@;
		522	};
410	1	523	}
		524	}
		525
		526	sub db_get($$) {
		527	my $key = "$_[0]/$_[1]";
		528
		529	cf::sync_job {
		530	BDB::db_get $DB, undef, $key, my $data;
		531
		532	$! ? ()
		533	: $data
		534	}
		535	}
		536
		537	sub db_put($$$) {
		538	BDB::dbreq_pri 4;
		539	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
		540	}
		541
		542	=item cf::cache $id => [$paths...], $processversion => $process
		543
		544	Generic caching function that returns the value of the resource $id,
		545	caching and regenerating as required.
		546
		547	This function can block.
		548
		549	=cut
		550
		551	sub cache {
		552	my ($id, $src, $processversion, $process) = @_;
		553
		554	my $meta =
		555	join "\x00",
		556	$processversion,
		557	map {
		558	aio_stat $_
		559	and Carp::croak "$_: $!";
		560
		561	($_, (stat _)[7,9])
		562	} @$src;
		563
		564	my $dbmeta = db_get cache => "$id/meta";
		565	if ($dbmeta ne $meta) {
		566	# changed, we may need to process
		567
		568	my @data;
		569	my $md5;
		570
		571	for (0 .. $#$src) {
		572	0 <= aio_load $src->[$_], $data[$_]
		573	or Carp::croak "$src->[$_]: $!";
		574	}
		575
		576	# if processing is expensive, check
		577	# checksum first
		578	if (1) {
		579	$md5 =
		580	join "\x00",
		581	$processversion,
		582	map {
		583	cf::cede_to_tick;
		584	($src->[$_], Digest::MD5::md5_hex $data[$_])
		585	} 0.. $#$src;
		586
		587
		588	my $dbmd5 = db_get cache => "$id/md5";
		589	if ($dbmd5 eq $md5) {
		590	db_put cache => "$id/meta", $meta;
		591
		592	return db_get cache => "$id/data";
		593	}
		594	}
		595
		596	my $t1 = Time::HiRes::time;
		597	my $data = $process->(\@data);
		598	my $t2 = Time::HiRes::time;
		599
		600	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
		601
		602	db_put cache => "$id/data", $data;
		603	db_put cache => "$id/md5" , $md5;
		604	db_put cache => "$id/meta", $meta;
		605
		606	return $data;
		607	}
		608
		609	db_get cache => "$id/data"
411	}	610	}
412		611
413	=item cf::datalog type => key => value, ...	612	=item cf::datalog type => key => value, ...
414		613
415	Log a datalog packet of the given type with the given key-value pairs.	614	Log a datalog packet of the given type with the given key-value pairs.
…		…
433	attach callbacks/event handlers (a collection of which is called an "attachment")	632	attach callbacks/event handlers (a collection of which is called an "attachment")
434	to it. All such attachable objects support the following methods.	633	to it. All such attachable objects support the following methods.
435		634
436	In the following description, CLASS can be any of C<global>, C<object>	635	In the following description, CLASS can be any of C<global>, C<object>
437	C<player>, C<client> or C<map> (i.e. the attachable objects in	636	C<player>, C<client> or C<map> (i.e. the attachable objects in
438	crossfire+).	637	Crossfire TRT).
439		638
440	=over 4	639	=over 4
441		640
442	=item $attachable->attach ($attachment, key => $value...)	641	=item $attachable->attach ($attachment, key => $value...)
443		642
…		…
606	$registry = $CB_TYPE[$object_type] ||= [];	805	$registry = $CB_TYPE[$object_type] ||= [];
607		806
608	} elsif ($type eq "subtype") {	807	} elsif ($type eq "subtype") {
609	defined $object_type or Carp::croak "subtype specified without type";	808	defined $object_type or Carp::croak "subtype specified without type";
610	my $object_subtype = shift @arg;	809	my $object_subtype = shift @arg;
611	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_SUBTYPES] ||= [];	810	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_TYPES] ||= [];
612		811
613	} elsif ($type eq "package") {	812	} elsif ($type eq "package") {
614	my $pkg = shift @arg;	813	my $pkg = shift @arg;
615		814
616	while (my ($name, $id) = each %cb_id) {	815	while (my ($name, $id) = each %cb_id) {
…		…
645	_attach $registry, $klass, @attach;	844	_attach $registry, $klass, @attach;
646	}	845	}
647		846
648	$obj->{$name} = \%arg;	847	$obj->{$name} = \%arg;
649	} else {	848	} else {
650	warn "object uses attachment '$name' that is not available, postponing.\n";	849	warn "object uses attachment '$name' which is not available, postponing.\n";
651	}	850	}
652		851
653	$obj->{_attachment}{$name} = undef;	852	$obj->{_attachment}{$name} = undef;
654	}	853	}
655		854
…		…
657	if (ref $_[0]) {	856	if (ref $_[0]) {
658	_object_attach @_;	857	_object_attach @_;
659	} else {	858	} else {
660	_attach shift->_attach_registry, @_;	859	_attach shift->_attach_registry, @_;
661	}	860	}
		861	_recalc_want;
662	};	862	};
663		863
664	# all those should be optimised	864	# all those should be optimised
665	sub cf::attachable::detach {	865	sub cf::attachable::detach {
666	my ($obj, $name) = @_;	866	my ($obj, $name) = @_;
…		…
669	delete $obj->{_attachment}{$name};	869	delete $obj->{_attachment}{$name};
670	reattach ($obj);	870	reattach ($obj);
671	} else {	871	} else {
672	Carp::croak "cannot, currently, detach class attachments";	872	Carp::croak "cannot, currently, detach class attachments";
673	}	873	}
		874	_recalc_want;
674	};	875	};
675		876
676	sub cf::attachable::attached {	877	sub cf::attachable::attached {
677	my ($obj, $name) = @_;	878	my ($obj, $name) = @_;
678		879
…		…
693	";	894	";
694	die if $@;	895	die if $@;
695	}	896	}
696		897
697	our $override;	898	our $override;
698	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?	899	our @INVOKE_RESULTS = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
699		900
700	sub override {	901	sub override {
701	$override = 1;	902	$override = 1;
702	@invoke_results = ();	903	@INVOKE_RESULTS = (@_);
703	}	904	}
704		905
705	sub do_invoke {	906	sub do_invoke {
706	my $event = shift;	907	my $event = shift;
707	my $callbacks = shift;	908	my $callbacks = shift;
708		909
709	@invoke_results = ();	910	@INVOKE_RESULTS = ();
710		911
711	local $override;	912	local $override;
712		913
713	for (@$callbacks) {	914	for (@$callbacks) {
714	eval { &{$_->[1]} };	915	eval { &{$_->[1]} };
…		…
731		932
732	Generate an object-specific event with the given arguments.	933	Generate an object-specific event with the given arguments.
733		934
734	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be	935	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
735	removed in future versions), and there is no public API to access override	936	removed in future versions), and there is no public API to access override
736	results (if you must, access C<@cf::invoke_results> directly).	937	results (if you must, access C<@cf::INVOKE_RESULTS> directly).
737		938
738	=back	939	=back
739		940
740	=cut	941	=cut
741		942
742	#############################################################################	943	#############################################################################
743	# object support	944	# object support
		945	#
		946
		947	sub _can_merge {
		948	my ($ob1, $ob2) = @_;
		949
		950	local $Storable::canonical = 1;
		951	my $fob1 = Storable::freeze $ob1;
		952	my $fob2 = Storable::freeze $ob2;
		953
		954	$fob1 eq $fob2
		955	}
744		956
745	sub reattach {	957	sub reattach {
746	# basically do the same as instantiate, without calling instantiate	958	# basically do the same as instantiate, without calling instantiate
747	my ($obj) = @_;	959	my ($obj) = @_;
748		960
…		…
851	or return;	1063	or return;
852	$av = eval { (Storable::thaw $av)->{objs} };	1064	$av = eval { (Storable::thaw $av)->{objs} };
853	}	1065	}
854		1066
855	warn sprintf "loading %s (%d)\n",	1067	warn sprintf "loading %s (%d)\n",
856	$filename, length $data, scalar @{$av || []};#d#	1068	$filename, length $data, scalar @{$av || []};
857	return ($data, $av);	1069	return ($data, $av);
858	}	1070	}
		1071
		1072	=head2 COMMAND CALLBACKS
		1073
		1074	=over 4
		1075
		1076	=cut
859		1077
860	#############################################################################	1078	#############################################################################
861	# command handling &c	1079	# command handling &c
862		1080
863	=item cf::register_command $name => \&callback($ob,$args);	1081	=item cf::register_command $name => \&callback($ob,$args);
…		…
876	push @{ $COMMAND{$name} }, [$caller, $cb];	1094	push @{ $COMMAND{$name} }, [$caller, $cb];
877	}	1095	}
878		1096
879	=item cf::register_extcmd $name => \&callback($pl,$packet);	1097	=item cf::register_extcmd $name => \&callback($pl,$packet);
880		1098
881	Register a callbackf ro execution when the client sends an extcmd packet.	1099	Register a callback for execution when the client sends an (synchronous)
		1100	extcmd packet. Ext commands will be processed in the order they are
		1101	received by the server, like other user commands. The first argument is
		1102	the logged-in player. Ext commands can only be processed after a player
		1103	has logged in successfully.
882		1104
883	If the callback returns something, it is sent back as if reply was being	1105	If the callback returns something, it is sent back as if reply was being
884	called.	1106	called.
885		1107
		1108	=item cf::register_exticmd $name => \&callback($ns,$packet);
		1109
		1110	Register a callback for execution when the client sends an (asynchronous)
		1111	exticmd packet. Exti commands are processed by the server as soon as they
		1112	are received, i.e. out of order w.r.t. other commands. The first argument
		1113	is a client socket. Exti commands can be received anytime, even before
		1114	log-in.
		1115
		1116	If the callback returns something, it is sent back as if reply was being
		1117	called.
		1118
886	=cut	1119	=cut
887		1120
888	sub register_extcmd {	1121	sub register_extcmd {
889	my ($name, $cb) = @_;	1122	my ($name, $cb) = @_;
890		1123
891	$EXTCMD{$name} = $cb;	1124	$EXTCMD{$name} = $cb;
		1125	}
		1126
		1127	sub register_exticmd {
		1128	my ($name, $cb) = @_;
		1129
		1130	$EXTICMD{$name} = $cb;
892	}	1131	}
893		1132
894	cf::player->attach (	1133	cf::player->attach (
895	on_command => sub {	1134	on_command => sub {
896	my ($pl, $name, $params) = @_;	1135	my ($pl, $name, $params) = @_;
…		…
905	cf::override;	1144	cf::override;
906	},	1145	},
907	on_extcmd => sub {	1146	on_extcmd => sub {
908	my ($pl, $buf) = @_;	1147	my ($pl, $buf) = @_;
909		1148
910	my $msg = eval { from_json $buf };	1149	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
911		1150
912	if (ref $msg) {	1151	if (ref $msg) {
		1152	my ($type, $reply, @payload) =
		1153	"ARRAY" eq ref $msg
		1154	? @$msg
		1155	: ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
		1156
		1157	my @reply;
		1158
913	if (my $cb = $EXTCMD{$msg->{msgtype}}) {	1159	if (my $cb = $EXTCMD{$type}) {
914	if (my %reply = $cb->($pl, $msg)) {	1160	@reply = $cb->($pl, @payload);
915	$pl->ext_reply ($msg->{msgid}, %reply);
916	}
917	}	1161	}
		1162
		1163	$pl->ext_reply ($reply, @reply)
		1164	if $reply;
		1165
918	} else {	1166	} else {
919	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";	1167	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
920	}	1168	}
921		1169
922	cf::override;	1170	cf::override;
923	},	1171	},
924	);	1172	);
925		1173
926	sub load_extension {
927	my ($path) = @_;
928
929	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
930	my $base = $1;
931	my $pkg = $1;
932	$pkg =~ s/[^[:word:]]/_/g;
933	$pkg = "ext::$pkg";
934
935	warn "... loading '$path' into '$pkg'\n";
936
937	open my $fh, "<:utf8", $path
938	or die "$path: $!";
939
940	my $source =
941	"package $pkg; use strict; use utf8;\n"
942	. "#line 1 \"$path\"\n{\n"
943	. (do { local $/; <$fh> })
944	. "\n};\n1";
945
946	unless (eval $source) {
947	my $msg = $@ ? "$path: $@\n"
948	: "extension disabled.\n";
949	if ($source =~ /^#!.*perl.*#.*MANDATORY/m) { # ugly match
950	warn $@;
951	warn "mandatory extension failed to load, exiting.\n";
952	exit 1;
953	}
954	die $@;
955	}
956
957	push @EXTS, $pkg;
958	}
959
960	sub load_extensions {	1174	sub load_extensions {
		1175	cf::sync_job {
		1176	my %todo;
		1177
961	for my $ext (<$LIBDIR/*.ext>) {	1178	for my $path (<$LIBDIR/*.ext>) {
962	next unless -r $ext;	1179	next unless -r $path;
963	eval {	1180
964	load_extension $ext;	1181	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
		1182	my $base = $1;
		1183	my $pkg = $1;
		1184	$pkg =~ s/[^[:word:]]/_/g;
		1185	$pkg = "ext::$pkg";
		1186
		1187	open my $fh, "<:utf8", $path
		1188	or die "$path: $!";
		1189
		1190	my $source = do { local $/; <$fh> };
		1191
		1192	my %ext = (
		1193	path => $path,
		1194	base => $base,
		1195	pkg => $pkg,
		1196	);
		1197
		1198	$ext{meta} = { map { (split /=/, $_, 2)[0, 1] } split /\s+/, $1 }
		1199	if $source =~ /\A#!.*?perl.*?#\s*(.*)$/m;
		1200
		1201	$ext{source} =
		1202	"package $pkg; use strict; use utf8;\n"
		1203	. "#line 1 \"$path\"\n{\n"
		1204	. $source
		1205	. "\n};\n1";
		1206
		1207	$todo{$base} = \%ext;
		1208	}
		1209
		1210	my %done;
		1211	while (%todo) {
		1212	my $progress;
		1213
		1214	while (my ($k, $v) = each %todo) {
		1215	for (split /,\s*/, $v->{meta}{depends}) {
		1216	goto skip
		1217	unless exists $done{$_};
		1218	}
		1219
		1220	warn "... loading '$k' into '$v->{pkg}'\n";
		1221
		1222	unless (eval $v->{source}) {
		1223	my $msg = $@ ? "$v->{path}: $@\n"
		1224	: "$v->{base}: extension inactive.\n";
		1225
		1226	if (exists $v->{meta}{mandatory}) {
		1227	warn $msg;
		1228	warn "mandatory extension failed to load, exiting.\n";
		1229	exit 1;
		1230	}
		1231
		1232	warn $msg;
		1233	}
		1234
		1235	$done{$k} = delete $todo{$k};
		1236	push @EXTS, $v->{pkg};
		1237	$progress = 1;
965	1	1238	}
966	} or warn "$ext not loaded: $@";	1239
		1240	skip:
		1241	die "cannot load " . (join ", ", keys %todo) . ": unable to resolve dependencies\n"
		1242	unless $progress;
		1243	}
967	}	1244	};
968	}	1245	}
969		1246
970	#############################################################################	1247	#############################################################################
		1248
		1249	=back
971		1250
972	=head2 CORE EXTENSIONS	1251	=head2 CORE EXTENSIONS
973		1252
974	Functions and methods that extend core crossfire objects.	1253	Functions and methods that extend core crossfire objects.
975		1254
…		…
1046		1325
1047	aio_mkdir playerdir $pl, 0770;	1326	aio_mkdir playerdir $pl, 0770;
1048	$pl->{last_save} = $cf::RUNTIME;	1327	$pl->{last_save} = $cf::RUNTIME;
1049		1328
1050	$pl->save_pl ($path);	1329	$pl->save_pl ($path);
1051	Coro::cede;	1330	cf::cede_to_tick;
1052	}	1331	}
1053		1332
1054	sub new($) {	1333	sub new($) {
1055	my ($login) = @_;	1334	my ($login) = @_;
1056		1335
…		…
1060	$self->{deny_save} = 1;	1339	$self->{deny_save} = 1;
1061		1340
1062	$cf::PLAYER{$login} = $self;	1341	$cf::PLAYER{$login} = $self;
1063		1342
1064	$self	1343	$self
		1344	}
		1345
		1346	=item $player->send_msg ($channel, $msg, $color, [extra...])
		1347
		1348	=cut
		1349
		1350	sub send_msg {
		1351	my $ns = shift->ns
		1352	or return;
		1353	$ns->send_msg (@_);
1065	}	1354	}
1066		1355
1067	=item $pl->quit_character	1356	=item $pl->quit_character
1068		1357
1069	Nukes the player without looking back. If logged in, the connection will	1358	Nukes the player without looking back. If logged in, the connection will
…		…
1163	}	1452	}
1164		1453
1165	\@paths	1454	\@paths
1166	}	1455	}
1167		1456
		1457	=item $protocol_xml = $player->expand_cfpod ($crossfire_pod)
		1458
		1459	Expand crossfire pod fragments into protocol xml.
		1460
		1461	=cut
		1462
		1463	sub expand_cfpod {
		1464	((my $self), (local $_)) = @_;
		1465
		1466	# escape & and <
		1467	s/&/&amp;/g;
		1468	s/(?<![BIUGH])</&lt;/g;
		1469
		1470	# this is buggy, it needs to properly take care of nested <'s
		1471
		1472	1 while
		1473	# replace B<>, I<>, U<> etc.
		1474	s/B<([^\>]*)>/<b>$1<\/b>/
		1475	|| s/I<([^\>]*)>/<i>$1<\/i>/
		1476	|| s/U<([^\>]*)>/<u>$1<\/u>/
		1477	# replace G<male|female> tags
		1478	|| s{G<([^>|]*)\|([^>]*)>}{
		1479	$self->gender ? $2 : $1
		1480	}ge
		1481	# replace H<hint text>
		1482	|| s{H<([^\>]*)>}
		1483	{
		1484	("<fg name=\"lightblue\">[$1 (Use hintmode to suppress hints)]</fg>",
		1485	"<fg name=\"lightblue\">[Hint suppressed, see hintmode]</fg>",
		1486	"")
		1487	[$self->{hintmode}]
		1488	}ge;
		1489
		1490	# create single paragraphs (very hackish)
		1491	s/(?<=\S)\n(?=\w)/ /g;
		1492
		1493	# compress some whitespace
		1494	s/\s+\n/\n/g; # ws line-ends
		1495	s/\n\n+/\n/g; # double lines
		1496	s/^\n+//; # beginning lines
		1497	s/\n+$//; # ending lines
		1498
		1499	$_
		1500	}
		1501
		1502	sub hintmode {
		1503	$_[0]{hintmode} = $_[1] if @_ > 1;
		1504	$_[0]{hintmode}
		1505	}
		1506
1168	=item $player->ext_reply ($msgid, %msg)	1507	=item $player->ext_reply ($msgid, @msg)
1169		1508
1170	Sends an ext reply to the player.	1509	Sends an ext reply to the player.
1171		1510
1172	=cut	1511	=cut
1173		1512
1174	sub ext_reply($$%) {	1513	sub ext_reply($$@) {
1175	my ($self, $id, %msg) = @_;	1514	my ($self, $id, @msg) = @_;
1176		1515
1177	$msg{msgid} = $id;	1516	$self->ns->ext_reply ($id, @msg)
1178
1179	$self->send ("ext " . cf::to_json \%msg);
1180	}	1517	}
1181		1518
1182	=item $player->ext_event ($type, %msg)	1519	=item $player->ext_msg ($type, @msg)
1183		1520
1184	Sends an ext event to the client.	1521	Sends an ext event to the client.
1185		1522
1186	=cut	1523	=cut
1187		1524
1188	sub ext_event($$%) {	1525	sub ext_msg($$@) {
1189	my ($self, $type, %msg) = @_;	1526	my ($self, $type, @msg) = @_;
1190		1527
1191	$self->ns->ext_event ($type, %msg);	1528	$self->ns->ext_msg ($type, @msg);
1192	}	1529	}
1193		1530
1194	=head3 cf::region	1531	=head3 cf::region
1195		1532
1196	=over 4	1533	=over 4
…		…
1199		1536
1200	package cf::region;	1537	package cf::region;
1201		1538
1202	=item cf::region::find_by_path $path	1539	=item cf::region::find_by_path $path
1203		1540
1204	Tries to decuce the probable region for a map knowing only its path.	1541	Tries to decuce the likely region for a map knowing only its path.
1205		1542
1206	=cut	1543	=cut
1207		1544
1208	sub find_by_path($) {	1545	sub find_by_path($) {
1209	my ($path) = @_;	1546	my ($path) = @_;
1210		1547
1211	my ($match, $specificity);	1548	my ($match, $specificity);
1212		1549
1213	for my $region (list) {	1550	for my $region (list) {
1214	if ($region->match && $path =~ $region->match) {	1551	if ($region->{match} && $path =~ $region->{match}) {
1215	($match, $specificity) = ($region, $region->specificity)	1552	($match, $specificity) = ($region, $region->specificity)
1216	if $region->specificity > $specificity;	1553	if $region->specificity > $specificity;
1217	}	1554	}
1218	}	1555	}
1219		1556
…		…
1283	my ($self, $merge) = @_;	1620	my ($self, $merge) = @_;
1284		1621
1285	# we have to keep some variables in memory intact	1622	# we have to keep some variables in memory intact
1286	local $self->{path};	1623	local $self->{path};
1287	local $self->{load_path};	1624	local $self->{load_path};
1288	local $self->{deny_save};
1289	local $self->{deny_reset};
1290		1625
1291	$self->SUPER::thawer_merge ($merge);	1626	$self->SUPER::thawer_merge ($merge);
1292	}	1627	}
1293		1628
1294	sub normalise {	1629	sub normalise {
…		…
1341	$self->init; # pass $1 etc.	1676	$self->init; # pass $1 etc.
1342	return $self;	1677	return $self;
1343	}	1678	}
1344	}	1679	}
1345		1680
1346	Carp::carp "unable to resolve path '$path' (base '$base').";	1681	Carp::cluck "unable to resolve path '$path' (base '$base').";
1347	()	1682	()
1348	}	1683	}
1349		1684
1350	sub init {	1685	sub init {
1351	my ($self) = @_;	1686	my ($self) = @_;
…		…
1392	sub change_all_map_light {	1727	sub change_all_map_light {
1393	my ($change) = @_;	1728	my ($change) = @_;
1394		1729
1395	$_->change_map_light ($change)	1730	$_->change_map_light ($change)
1396	for grep $_->outdoor, values %cf::MAP;	1731	for grep $_->outdoor, values %cf::MAP;
		1732	}
		1733
		1734	sub decay_objects {
		1735	my ($self) = @_;
		1736
		1737	return if $self->{deny_reset};
		1738
		1739	$self->do_decay_objects;
1397	}	1740	}
1398		1741
1399	sub unlink_save {	1742	sub unlink_save {
1400	my ($self) = @_;	1743	my ($self) = @_;
1401		1744
…		…
1459	$self->load_header_orig	1802	$self->load_header_orig
1460	or return;	1803	or return;
1461	$self->prepare_orig;	1804	$self->prepare_orig;
1462	}	1805	}
1463		1806
		1807	$self->{deny_reset} = 1
		1808	if $self->no_reset;
		1809
1464	$self->default_region (cf::region::find_by_path $self->{path})	1810	$self->default_region (cf::region::find_by_path $self->{path})
1465	unless $self->default_region;	1811	unless $self->default_region;
1466		1812
1467	1	1813	1
1468	}	1814	}
…		…
1483	$map->{last_save} = $cf::RUNTIME;	1829	$map->{last_save} = $cf::RUNTIME;
1484		1830
1485	$map->load_header	1831	$map->load_header
1486	or return;	1832	or return;
1487		1833
1488	if ($map->should_reset && 0) {#d#TODO# disabled, crashy (locking issue?)	1834	if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
1489	# doing this can freeze the server in a sync job, obviously	1835	# doing this can freeze the server in a sync job, obviously
1490	#$cf::WAIT_FOR_TICK->wait;	1836	#$cf::WAIT_FOR_TICK->wait;
1491	$map->reset;	1837	$map->reset;
1492	undef $guard;	1838	undef $guard;
1493	return find $path;	1839	return find $path;
…		…
1506	local $self->{deny_reset} = 1; # loading can take a long time	1852	local $self->{deny_reset} = 1; # loading can take a long time
1507		1853
1508	my $path = $self->{path};	1854	my $path = $self->{path};
1509		1855
1510	{	1856	{
		1857	my $guard1 = cf::lock_acquire "map_data:$path";
1511	my $guard = cf::lock_acquire "map_load:$path";	1858	my $guard2 = cf::lock_acquire "map_load:$path";
1512		1859
1513	return if $self->in_memory != cf::MAP_SWAPPED;	1860	return if $self->in_memory != cf::MAP_SWAPPED;
1514		1861
1515	$self->in_memory (cf::MAP_LOADING);	1862	$self->in_memory (cf::MAP_LOADING);
1516		1863
1517	$self->alloc;	1864	$self->alloc;
1518		1865
1519	$self->pre_load;	1866	$self->pre_load;
1520	Coro::cede;	1867	cf::cede_to_tick;
1521		1868
1522	$self->_load_objects ($self->{load_path}, 1)	1869	$self->_load_objects ($self->{load_path}, 1)
1523	or return;	1870	or return;
1524		1871
1525	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)	1872	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
…		…
1531	$self->clear_unique_items;	1878	$self->clear_unique_items;
1532	$self->_load_objects ($uniq, 0);	1879	$self->_load_objects ($uniq, 0);
1533	}	1880	}
1534	}	1881	}
1535		1882
1536	Coro::cede;	1883	cf::cede_to_tick;
1537	# now do the right thing for maps	1884	# now do the right thing for maps
1538	$self->link_multipart_objects;	1885	$self->link_multipart_objects;
1539	$self->difficulty ($self->estimate_difficulty)	1886	$self->difficulty ($self->estimate_difficulty)
1540	unless $self->difficulty;	1887	unless $self->difficulty;
1541	Coro::cede;	1888	cf::cede_to_tick;
1542		1889
1543	unless ($self->{deny_activate}) {	1890	unless ($self->{deny_activate}) {
1544	$self->decay_objects;	1891	$self->decay_objects;
1545	$self->fix_auto_apply;	1892	$self->fix_auto_apply;
1546	$self->update_buttons;	1893	$self->update_buttons;
1547	Coro::cede;	1894	cf::cede_to_tick;
1548	$self->set_darkness_map;	1895	$self->set_darkness_map;
1549	Coro::cede;	1896	cf::cede_to_tick;
1550	$self->activate;	1897	$self->activate;
1551	}	1898	}
		1899
		1900	$self->{last_save} = $cf::RUNTIME;
		1901	$self->last_access ($cf::RUNTIME);
1552		1902
1553	$self->in_memory (cf::MAP_IN_MEMORY);	1903	$self->in_memory (cf::MAP_IN_MEMORY);
1554	}	1904	}
1555		1905
1556	$self->post_load;	1906	$self->post_load;
…		…
1560	my ($self, $ob) = @_;	1910	my ($self, $ob) = @_;
1561		1911
1562	return find "~" . $ob->name . "/" . $self->{path}	1912	return find "~" . $ob->name . "/" . $self->{path}
1563	if $self->per_player;	1913	if $self->per_player;
1564		1914
		1915	# return find "?party/" . $ob->name . "/" . $self->{path}
		1916	# if $self->per_party;
		1917
1565	$self	1918	$self
1566	}	1919	}
1567		1920
1568	# find and load all maps in the 3x3 area around a map	1921	# find and load all maps in the 3x3 area around a map
1569	sub load_diag {	1922	sub load_neighbours {
1570	my ($map) = @_;	1923	my ($map) = @_;
1571		1924
1572	my @diag; # diagonal neighbours	1925	my @neigh; # diagonal neighbours
1573		1926
1574	for (0 .. 3) {	1927	for (0 .. 3) {
1575	my $neigh = $map->tile_path ($_)	1928	my $neigh = $map->tile_path ($_)
1576	or next;	1929	or next;
1577	$neigh = find $neigh, $map	1930	$neigh = find $neigh, $map
1578	or next;	1931	or next;
1579	$neigh->load;	1932	$neigh->load;
1580		1933
		1934	push @neigh,
1581	push @diag, [$neigh->tile_path (($_ + 3) % 4), $neigh],	1935	[$neigh->tile_path (($_ + 3) % 4), $neigh],
1582	[$neigh->tile_path (($_ + 1) % 4), $neigh];	1936	[$neigh->tile_path (($_ + 1) % 4), $neigh];
1583	}	1937	}
1584		1938
1585	for (@diag) {	1939	for (grep defined $_->[0], @neigh) {
		1940	my ($path, $origin) = @$_;
1586	my $neigh = find @$_	1941	my $neigh = find $path, $origin
1587	or next;	1942	or next;
1588	$neigh->load;	1943	$neigh->load;
1589	}	1944	}
1590	}	1945	}
1591		1946
…		…
1596	}	1951	}
1597		1952
1598	sub do_load_sync {	1953	sub do_load_sync {
1599	my ($map) = @_;	1954	my ($map) = @_;
1600		1955
		1956	cf::LOG cf::llevDebug | cf::logBacktrace, "do_load_sync"
		1957	if $Coro::current == $Coro::main;
		1958
1601	cf::sync_job { $map->load };	1959	cf::sync_job { $map->load };
1602	}	1960	}
1603		1961
1604	our %MAP_PREFETCH;	1962	our %MAP_PREFETCH;
1605	our $MAP_PREFETCHER = undef;	1963	our $MAP_PREFETCHER = undef;
1606		1964
1607	sub find_async {	1965	sub find_async {
1608	my ($path, $origin) = @_;	1966	my ($path, $origin, $load) = @_;
1609		1967
1610	$path = normalise $path, $origin && $origin->{path};	1968	$path = normalise $path, $origin && $origin->{path};
1611		1969
1612	if (my $map = $cf::MAP{$path}) {	1970	if (my $map = $cf::MAP{$path}) {
1613	return $map if $map->in_memory == cf::MAP_IN_MEMORY;	1971	return $map if !$load || $map->in_memory == cf::MAP_IN_MEMORY;
1614	}	1972	}
1615		1973
1616	undef $MAP_PREFETCH{$path};	1974	$MAP_PREFETCH{$path} |= $load;
		1975
1617	$MAP_PREFETCHER ||= cf::async {	1976	$MAP_PREFETCHER ||= cf::async {
1618	while (%MAP_PREFETCH) {	1977	while (%MAP_PREFETCH) {
1619	for my $path (keys %MAP_PREFETCH) {	1978	while (my ($k, $v) = each %MAP_PREFETCH) {
1620	my $map = find $path	1979	if (my $map = find $k) {
1621	or next;
1622	$map->load;	1980	$map->load if $v;
		1981	}
1623		1982
1624	delete $MAP_PREFETCH{$path};	1983	delete $MAP_PREFETCH{$k};
1625	}	1984	}
1626	}	1985	}
1627	undef $MAP_PREFETCHER;	1986	undef $MAP_PREFETCHER;
1628	};	1987	};
1629	$MAP_PREFETCHER->prio (6);	1988	$MAP_PREFETCHER->prio (6);
…		…
1632	}	1991	}
1633		1992
1634	sub save {	1993	sub save {
1635	my ($self) = @_;	1994	my ($self) = @_;
1636		1995
1637	my $lock = cf::lock_acquire "map_data:" . $self->path;	1996	my $lock = cf::lock_acquire "map_data:$self->{path}";
1638		1997
1639	$self->{last_save} = $cf::RUNTIME;	1998	$self->{last_save} = $cf::RUNTIME;
1640		1999
1641	return unless $self->dirty;	2000	return unless $self->dirty;
1642		2001
…		…
1665	my ($self) = @_;	2024	my ($self) = @_;
1666		2025
1667	# save first because save cedes	2026	# save first because save cedes
1668	$self->save;	2027	$self->save;
1669		2028
1670	my $lock = cf::lock_acquire "map_data:" . $self->path;	2029	my $lock = cf::lock_acquire "map_data:$self->{path}";
1671		2030
1672	return if $self->players;	2031	return if $self->players;
1673	return if $self->in_memory != cf::MAP_IN_MEMORY;	2032	return if $self->in_memory != cf::MAP_IN_MEMORY;
1674	return if $self->{deny_save};	2033	return if $self->{deny_save};
1675		2034
…		…
1679		2038
1680	sub reset_at {	2039	sub reset_at {
1681	my ($self) = @_;	2040	my ($self) = @_;
1682		2041
1683	# TODO: safety, remove and allow resettable per-player maps	2042	# TODO: safety, remove and allow resettable per-player maps
1684	return 1e99 if $self->isa ("ext::map_per_player");#d#
1685	return 1e99 if $self->{deny_reset};	2043	return 1e99 if $self->{deny_reset};
1686		2044
1687	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;	2045	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
1688	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;	2046	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
1689		2047
…		…
1700	my ($self) = @_;	2058	my ($self) = @_;
1701		2059
1702	my $lock = cf::lock_acquire "map_data:$self->{path}";	2060	my $lock = cf::lock_acquire "map_data:$self->{path}";
1703		2061
1704	return if $self->players;	2062	return if $self->players;
1705	return if $self->isa ("ext::map_per_player");#d#
1706		2063
1707	warn "resetting map ", $self->path;#d#	2064	warn "resetting map ", $self->path;
1708		2065
1709	$self->in_memory (cf::MAP_SWAPPED);	2066	$self->in_memory (cf::MAP_SWAPPED);
1710		2067
1711	# need to save uniques path	2068	# need to save uniques path
1712	unless ($self->{deny_save}) {	2069	unless ($self->{deny_save}) {
…		…
1744	$cf::MAP{$self->path} = $self;	2101	$cf::MAP{$self->path} = $self;
1745		2102
1746	$self->reset; # polite request, might not happen	2103	$self->reset; # polite request, might not happen
1747	}	2104	}
1748		2105
		2106	=item $maps = cf::map::tmp_maps
		2107
		2108	Returns an arrayref with all map paths of currently instantiated and saved
		2109	maps. May block.
		2110
		2111	=cut
		2112
		2113	sub tmp_maps() {
		2114	[
		2115	map {
		2116	utf8::decode $_;
		2117	/\.map$/
		2118	? normalise $_
		2119	: ()
		2120	} @{ aio_readdir $TMPDIR or [] }
		2121	]
		2122	}
		2123
		2124	=item $maps = cf::map::random_maps
		2125
		2126	Returns an arrayref with all map paths of currently instantiated and saved
		2127	random maps. May block.
		2128
		2129	=cut
		2130
		2131	sub random_maps() {
		2132	[
		2133	map {
		2134	utf8::decode $_;
		2135	/\.map$/
		2136	? normalise "?random/$_"
		2137	: ()
		2138	} @{ aio_readdir $RANDOMDIR or [] }
		2139	]
		2140	}
		2141
1749	=item cf::map::unique_maps	2142	=item cf::map::unique_maps
1750		2143
1751	Returns an arrayref of paths of all shared maps that have	2144	Returns an arrayref of paths of all shared maps that have
1752	instantiated unique items. May block.	2145	instantiated unique items. May block.
1753		2146
1754	=cut	2147	=cut
1755		2148
1756	sub unique_maps() {	2149	sub unique_maps() {
1757	my $files = aio_readdir $UNIQUEDIR	2150	[
1758	or return;	2151	map {
1759
1760	my @paths;
1761
1762	for (@$files) {
1763	utf8::decode $_;	2152	utf8::decode $_;
1764	next if /\.pst$/;	2153	/\.map$/
1765	next unless /^$PATH_SEP/o;	2154	? normalise $_
1766		2155	: ()
1767	push @paths, cf::map::normalise $_;	2156	} @{ aio_readdir $UNIQUEDIR or [] }
1768	}	2157	]
1769
1770	\@paths
1771	}	2158	}
1772		2159
1773	package cf;	2160	package cf;
1774		2161
1775	=back	2162	=back
…		…
1821		2208
1822	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	2209	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
1823		2210
1824	if ($self->{record_replies}) {	2211	if ($self->{record_replies}) {
1825	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2212	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2213
1826	} else {	2214	} else {
		2215	my $pl = $self->contr;
		2216
		2217	if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
		2218	my $dialog = $pl->{npc_dialog};
		2219	$dialog->{pl}->ext_msg ($dialog->{id}, update => msg => $dialog->{pl}->expand_cfpod ($msg));
		2220
		2221	} else {
1827	$msg = $npc->name . " says: $msg" if $npc;	2222	$msg = $npc->name . " says: $msg" if $npc;
1828	$self->message ($msg, $flags);	2223	$self->message ($msg, $flags);
		2224	}
1829	}	2225	}
		2226	}
		2227
		2228	=item $object->send_msg ($channel, $msg, $color, [extra...])
		2229
		2230	=cut
		2231
		2232	sub cf::object::send_msg {
		2233	my $pl = shift->contr
		2234	or return;
		2235	$pl->send_msg (@_);
1830	}	2236	}
1831		2237
1832	=item $player_object->may ("access")	2238	=item $player_object->may ("access")
1833		2239
1834	Returns wether the given player is authorized to access resource "access"	2240	Returns wether the given player is authorized to access resource "access"
…		…
1881	$self->deactivate_recursive;	2287	$self->deactivate_recursive;
1882		2288
1883	return if UNIVERSAL::isa $self->map, "ext::map_link";	2289	return if UNIVERSAL::isa $self->map, "ext::map_link";
1884		2290
1885	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]	2291	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
1886	if $self->map;	2292	if $self->map && $self->map->{path} ne "{link}";
1887		2293
1888	$self->enter_map ($LINK_MAP || link_map, 10, 10);	2294	$self->enter_map ($LINK_MAP || link_map, 10, 10);
1889	}	2295	}
1890		2296
1891	sub cf::object::player::leave_link {	2297	sub cf::object::player::leave_link {
1892	my ($self, $map, $x, $y) = @_;	2298	my ($self, $map, $x, $y) = @_;
		2299
		2300	return unless $self->contr->active;
1893		2301
1894	my $link_pos = delete $self->{_link_pos};	2302	my $link_pos = delete $self->{_link_pos};
1895		2303
1896	unless ($map) {	2304	unless ($map) {
1897	# restore original map position	2305	# restore original map position
…		…
1911	# use -1 or undef as default coordinates, not 0, 0	2319	# use -1 or undef as default coordinates, not 0, 0
1912	($x, $y) = ($map->enter_x, $map->enter_y)	2320	($x, $y) = ($map->enter_x, $map->enter_y)
1913	if $x <=0 && $y <= 0;	2321	if $x <=0 && $y <= 0;
1914		2322
1915	$map->load;	2323	$map->load;
1916	$map->load_diag;	2324	$map->load_neighbours;
1917		2325
1918	return unless $self->contr->active;	2326	return unless $self->contr->active;
1919	$self->activate_recursive;	2327	$self->activate_recursive;
1920		2328
1921	local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext	2329	local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
1922	$self->enter_map ($map, $x, $y);	2330	$self->enter_map ($map, $x, $y);
1923	}	2331	}
1924		2332
1925	cf::player->attach (	2333	=item $player_object->goto ($path, $x, $y[, $check->($map)[, $done->()]])
1926	on_logout => sub {
1927	my ($pl) = @_;
1928		2334
1929	# abort map switching before logout	2335	Moves the player to the given map-path and coordinates by first freezing
1930	if ($pl->ob->{_link_pos}) {	2336	her, loading and preparing them map, calling the provided $check callback
1931	cf::sync_job {	2337	that has to return the map if sucecssful, and then unfreezes the player on
1932	$pl->ob->leave_link	2338	the new (success) or old (failed) map position. In either case, $done will
1933	};	2339	be called at the end of this process.
1934	}
1935	},
1936	on_login => sub {
1937	my ($pl) = @_;
1938		2340
1939	# try to abort aborted map switching on player login :)
1940	# should happen only on crashes
1941	if ($pl->ob->{_link_pos}) {
1942	$pl->ob->enter_link;
1943	(async {
1944	$pl->ob->reply (undef,
1945	"There was an internal problem at your last logout, "
1946	. "the server will try to bring you to your intended destination in a second.",
1947	cf::NDI_RED);
1948	# we need this sleep as the login has a concurrent enter_exit running
1949	# and this sleep increases chances of the player not ending up in scorn
1950	Coro::Timer::sleep 1;
1951	$pl->ob->leave_link;
1952	})->prio (2);
1953	}
1954	},
1955	);
1956
1957	=item $player_object->goto ($path, $x, $y)
1958
1959	=cut	2341	=cut
		2342
		2343	our $GOTOGEN;
1960		2344
1961	sub cf::object::player::goto {	2345	sub cf::object::player::goto {
1962	my ($self, $path, $x, $y) = @_;	2346	my ($self, $path, $x, $y, $check, $done) = @_;
		2347
		2348	# do generation counting so two concurrent goto's will be executed in-order
		2349	my $gen = $self->{_goto_generation} = ++$GOTOGEN;
1963		2350
1964	$self->enter_link;	2351	$self->enter_link;
1965		2352
1966	(async {	2353	(async {
1967	my $map = eval {	2354	my $map = eval {
1968	my $map = cf::map::find $path;	2355	my $map = cf::map::find $path;
		2356
		2357	if ($map) {
1969	$map = $map->customise_for ($self) if $map;	2358	$map = $map->customise_for ($self);
		2359	$map = $check->($map) if $check && $map;
		2360	} else {
		2361	$self->message ("The exit to '$path' is closed", cf::NDI_UNIQUE | cf::NDI_RED);
		2362	}
		2363
1970	$map	2364	$map
		2365	};
		2366
		2367	if ($@) {
		2368	$self->message ("Something went wrong within the server, please report this incident!", cf::NDI_UNIQUE | cf::NDI_RED);
		2369	LOG llevError | logBacktrace, Carp::longmess $@;
1971	} or	2370	}
1972	$self->message ("The exit to '$path' is closed", cf::NDI_UNIQUE | cf::NDI_RED);
1973		2371
		2372	if ($gen == $self->{_goto_generation}) {
		2373	delete $self->{_goto_generation};
1974	$self->leave_link ($map, $x, $y);	2374	$self->leave_link ($map, $x, $y);
		2375	}
		2376
		2377	$done->() if $done;
1975	})->prio (1);	2378	})->prio (1);
1976	}	2379	}
1977		2380
1978	=item $player_object->enter_exit ($exit_object)	2381	=item $player_object->enter_exit ($exit_object)
1979		2382
…		…
2048	my $hp = $exit->stats->hp;	2451	my $hp = $exit->stats->hp;
2049	my $sp = $exit->stats->sp;	2452	my $sp = $exit->stats->sp;
2050		2453
2051	$self->enter_link;	2454	$self->enter_link;
2052		2455
		2456	# if exit is damned, update players death & WoR home-position
		2457	$self->contr->savebed ($slaying, $hp, $sp)
		2458	if $exit->flag (FLAG_DAMNED);
		2459
2053	(async {	2460	(async {
2054	$self->deactivate_recursive; # just to be sure	2461	$self->deactivate_recursive; # just to be sure
2055	unless (eval {	2462	unless (eval {
2056	$self->goto ($slaying, $hp, $sp);	2463	$self->goto ($slaying, $hp, $sp);
2057		2464
…		…
2084		2491
2085	utf8::encode $text;	2492	utf8::encode $text;
2086	$self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);	2493	$self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);
2087	}	2494	}
2088		2495
		2496	=item $client->send_msg ($channel, $msg, $color, [extra...])
		2497
		2498	Send a drawinfo or msg packet to the client, formatting the msg for the
		2499	client if neccessary. C<$type> should be a string identifying the type of
		2500	the message, with C<log> being the default. If C<$color> is negative, suppress
		2501	the message unless the client supports the msg packet.
		2502
		2503	=cut
		2504
		2505	sub cf::client::send_msg {
		2506	my ($self, $channel, $msg, $color, @extra) = @_;
		2507
		2508	$msg = $self->pl->expand_cfpod ($msg);
		2509
		2510	$color &= cf::NDI_CLIENT_MASK; # just in case...
		2511
		2512	if (ref $channel) {
		2513	# send meta info to client, if not yet sent
		2514	unless (exists $self->{channel}{$channel->{id}}) {
		2515	$self->{channel}{$channel->{id}} = $channel;
		2516	$self->ext_msg (channel_info => $channel);
		2517	}
		2518
		2519	$channel = $channel->{id};
		2520	}
		2521
		2522	return unless @extra || length $msg;
		2523
		2524	if ($self->can_msg) {
		2525	# default colour, mask it out
		2526	$color &= ~(cf::NDI_COLOR_MASK | cf::NDI_DEF)
		2527	if $color & cf::NDI_DEF;
		2528
		2529	$self->send_packet ("msg " . $self->{json_coder}->encode (
		2530	[$color & cf::NDI_CLIENT_MASK, $channel, $msg, @extra]));
		2531	} else {
		2532	if ($color >= 0) {
		2533	# replace some tags by gcfclient-compatible ones
		2534	for ($msg) {
		2535	1 while
		2536	s/<b>([^<]*)<\/b>/[b]${1}[\/b]/
		2537	|| s/<i>([^<]*)<\/i>/[i]${1}[\/i]/
		2538	|| s/<u>([^<]*)<\/u>/[ul]${1}[\/ul]/
		2539	|| s/<tt>([^<]*)<\/tt>/[fixed]${1}[\/fixed]/
		2540	|| s/<fg name=\"([^"]+)\">([^<]*)<\/fg>/[color=$1]${2}[\/color]/;
		2541	}
		2542
		2543	$color &= cf::NDI_COLOR_MASK;
		2544
		2545	utf8::encode $msg;
		2546
		2547	if (0 && $msg =~ /\[/) {
		2548	# COMMAND/INFO
		2549	$self->send_packet ("drawextinfo $color 10 8 $msg")
		2550	} else {
		2551	$msg =~ s/\[\/?(?:b|i|u|fixed|color)[^\]]*\]//g;
		2552	$self->send_packet ("drawinfo $color $msg")
		2553	}
		2554	}
		2555	}
		2556	}
		2557
2089	=item $client->ext_event ($type, %msg)	2558	=item $client->ext_msg ($type, @msg)
2090		2559
2091	Sends an exti event to the client.	2560	Sends an ext event to the client.
2092		2561
2093	=cut	2562	=cut
2094		2563
2095	sub cf::client::ext_event($$%) {	2564	sub cf::client::ext_msg($$@) {
2096	my ($self, $type, %msg) = @_;	2565	my ($self, $type, @msg) = @_;
2097		2566
		2567	if ($self->extcmd == 2) {
		2568	$self->send_packet ("ext " . $self->{json_coder}->encode ([$type, @msg]));
		2569	} elsif ($self->extcmd == 1) { # TODO: remove
2098	$msg{msgtype} = "event_$type";	2570	push @msg, msgtype => "event_$type";
2099	$self->send_packet ("ext " . cf::to_json \%msg);	2571	$self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
		2572	}
		2573	}
		2574
		2575	=item $client->ext_reply ($msgid, @msg)
		2576
		2577	Sends an ext reply to the client.
		2578
		2579	=cut
		2580
		2581	sub cf::client::ext_reply($$@) {
		2582	my ($self, $id, @msg) = @_;
		2583
		2584	if ($self->extcmd == 2) {
		2585	$self->send_packet ("ext " . $self->{json_coder}->encode (["reply-$id", @msg]));
		2586	} elsif ($self->extcmd == 1) {
		2587	#TODO: version 1, remove
		2588	unshift @msg, msgtype => "reply", msgid => $id;
		2589	$self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
		2590	}
2100	}	2591	}
2101		2592
2102	=item $success = $client->query ($flags, "text", \&cb)	2593	=item $success = $client->query ($flags, "text", \&cb)
2103		2594
2104	Queues a query to the client, calling the given callback with	2595	Queues a query to the client, calling the given callback with
2105	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,	2596	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
2106	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.	2597	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
2107		2598
2108	Queries can fail, so check the return code. Or don't, as queries will become	2599	Queries can fail, so check the return code. Or don't, as queries will
2109	reliable at some point in the future.	2600	become reliable at some point in the future.
2110		2601
2111	=cut	2602	=cut
2112		2603
2113	sub cf::client::query {	2604	sub cf::client::query {
2114	my ($self, $flags, $text, $cb) = @_;	2605	my ($self, $flags, $text, $cb) = @_;
…		…
2122	utf8::encode $text;	2613	utf8::encode $text;
2123	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];	2614	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
2124		2615
2125	$self->send_packet ($self->{query_queue}[0][0])	2616	$self->send_packet ($self->{query_queue}[0][0])
2126	if @{ $self->{query_queue} } == 1;	2617	if @{ $self->{query_queue} } == 1;
		2618
		2619	1
2127	}	2620	}
2128		2621
2129	cf::client->attach (	2622	cf::client->attach (
		2623	on_connect => sub {
		2624	my ($ns) = @_;
		2625
		2626	$ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
		2627	},
2130	on_reply => sub {	2628	on_reply => sub {
2131	my ($ns, $msg) = @_;	2629	my ($ns, $msg) = @_;
2132		2630
2133	# this weird shuffling is so that direct followup queries	2631	# this weird shuffling is so that direct followup queries
2134	# get handled first	2632	# get handled first
…		…
2146	} else {	2644	} else {
2147	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;	2645	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2148	}	2646	}
2149	}	2647	}
2150	},	2648	},
		2649	on_exticmd => sub {
		2650	my ($ns, $buf) = @_;
		2651
		2652	my $msg = eval { $ns->{json_coder}->decode ($buf) };
		2653
		2654	if (ref $msg) {
		2655	my ($type, $reply, @payload) =
		2656	"ARRAY" eq ref $msg
		2657	? @$msg
		2658	: ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
		2659
		2660	my @reply;
		2661
		2662	if (my $cb = $EXTICMD{$type}) {
		2663	@reply = $cb->($ns, @payload);
		2664	}
		2665
		2666	$ns->ext_reply ($reply, @reply)
		2667	if $reply;
		2668
		2669	} else {
		2670	warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
		2671	}
		2672
		2673	cf::override;
		2674	},
2151	);	2675	);
2152		2676
2153	=item $client->async (\&cb)	2677	=item $client->async (\&cb)
2154		2678
2155	Create a new coroutine, running the specified callback. The coroutine will	2679	Create a new coroutine, running the specified callback. The coroutine will
…		…
2196	our $safe = new Safe "safe";	2720	our $safe = new Safe "safe";
2197	our $safe_hole = new Safe::Hole;	2721	our $safe_hole = new Safe::Hole;
2198		2722
2199	$SIG{FPE} = 'IGNORE';	2723	$SIG{FPE} = 'IGNORE';
2200		2724
2201	$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));	2725	$safe->permit_only (Opcode::opset qw(
		2726	:base_core :base_mem :base_orig :base_math
		2727	grepstart grepwhile mapstart mapwhile
		2728	sort time
		2729	));
2202		2730
2203	# here we export the classes and methods available to script code	2731	# here we export the classes and methods available to script code
2204		2732
2205	=pod	2733	=pod
2206		2734
2207	The following functions and methods are available within a safe environment:	2735	The following functions and methods are available within a safe environment:
2208		2736
2209	cf::object contr pay_amount pay_player map	2737	cf::object
		2738	contr pay_amount pay_player map x y force_find force_add
		2739	insert remove name archname title slaying race decrease_ob_nr
		2740
2210	cf::object::player player	2741	cf::object::player
2211	cf::player peaceful	2742	player
2212	cf::map trigger	2743
		2744	cf::player
		2745	peaceful
		2746
		2747	cf::map
		2748	trigger
2213		2749
2214	=cut	2750	=cut
2215		2751
2216	for (	2752	for (
2217	["cf::object" => qw(contr pay_amount pay_player map)],	2753	["cf::object" => qw(contr pay_amount pay_player map force_find force_add x y
		2754	insert remove inv name archname title slaying race
		2755	decrease_ob_nr)],
2218	["cf::object::player" => qw(player)],	2756	["cf::object::player" => qw(player)],
2219	["cf::player" => qw(peaceful)],	2757	["cf::player" => qw(peaceful)],
2220	["cf::map" => qw(trigger)],	2758	["cf::map" => qw(trigger)],
2221	) {	2759	) {
2222	no strict 'refs';	2760	no strict 'refs';
…		…
2293	=back	2831	=back
2294		2832
2295	=cut	2833	=cut
2296		2834
2297	#############################################################################	2835	#############################################################################
2298
2299	=head2 EXTENSION DATABASE SUPPORT
2300
2301	Crossfire maintains a very simple database for extension use. It can
2302	currently store binary data only (use Compress::LZF::sfreeze_cr/sthaw to
2303	convert to/from binary).
2304
2305	The parameter C<$family> should best start with the name of the extension
2306	using it, it should be unique.
2307
2308	=over 4
2309
2310	=item $value = cf::db_get $family => $key
2311
2312	Returns a single value from the database.
2313
2314	=item cf::db_put $family => $key => $value
2315
2316	Stores the given C<$value> in the family.
2317
2318	=cut
2319
2320	our $DB;
2321
2322	sub db_init {
2323	unless ($DB) {
2324	$DB = BDB::db_create $DB_ENV;
2325
2326	cf::sync_job {
2327	eval {
2328	$DB->set_flags (BDB::CHKSUM);
2329
2330	BDB::db_open $DB, undef, "db", undef, BDB::BTREE,
2331	BDB::CREATE | BDB::AUTO_COMMIT, 0666;
2332	cf::cleanup "db_open(db): $!" if $!;
2333	};
2334	cf::cleanup "db_open(db): $@" if $@;
2335	};
2336	}
2337	}
2338
2339	sub db_get($$) {
2340	my $key = "$_[0]/$_[1]";
2341
2342	cf::sync_job {
2343	BDB::db_get $DB, undef, $key, my $data;
2344
2345	$! ? ()
2346	: $data
2347	}
2348	}
2349
2350	sub db_put($$$) {
2351	BDB::dbreq_pri 4;
2352	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
2353	}
2354
2355	=item cf::cache $id => [$paths...], $processversion => $process
2356
2357	Generic caching function that returns the value of the resource $id,
2358	caching and regenerating as required.
2359
2360	This function can block.
2361
2362	=cut
2363
2364	sub cache {
2365	my ($id, $src, $processversion, $process) = @_;
2366
2367	my $meta =
2368	join "\x00",
2369	$processversion,
2370	map {
2371	aio_stat $_
2372	and Carp::croak "$_: $!";
2373
2374	($_, (stat _)[7,9])
2375	} @$src;
2376
2377	my $dbmeta = db_get cache => "$id/meta";
2378	if ($dbmeta ne $meta) {
2379	# changed, we may need to process
2380
2381	my @data;
2382	my $md5;
2383
2384	for (0 .. $#$src) {
2385	0 <= aio_load $src->[$_], $data[$_]
2386	or Carp::croak "$src->[$_]: $!";
2387	}
2388
2389	# if processing is expensive, check
2390	# checksum first
2391	if (1) {
2392	$md5 =
2393	join "\x00",
2394	$processversion,
2395	map {
2396	Coro::cede;
2397	($src->[$_], Digest::MD5::md5_hex $data[$_])
2398	} 0.. $#$src;
2399
2400
2401	my $dbmd5 = db_get cache => "$id/md5";
2402	if ($dbmd5 eq $md5) {
2403	db_put cache => "$id/meta", $meta;
2404
2405	return db_get cache => "$id/data";
2406	}
2407	}
2408
2409	my $t1 = Time::HiRes::time;
2410	my $data = $process->(\@data);
2411	my $t2 = Time::HiRes::time;
2412
2413	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
2414
2415	db_put cache => "$id/data", $data;
2416	db_put cache => "$id/md5" , $md5;
2417	db_put cache => "$id/meta", $meta;
2418
2419	return $data;
2420	}
2421
2422	db_get cache => "$id/data"
2423	}
2424
2425	=item fork_call { }, $args
2426
2427	Executes the given code block with the given arguments in a seperate
2428	process, returning the results. Everything must be serialisable with
2429	Coro::Storable. May, of course, block. Note that the executed sub may
2430	never block itself or use any form of Event handling.
2431
2432	=cut
2433
2434	sub fork_call(&@) {
2435	my ($cb, @args) = @_;
2436
2437	# socketpair my $fh1, my $fh2, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC
2438	# or die "socketpair: $!";
2439	pipe my $fh1, my $fh2
2440	or die "pipe: $!";
2441
2442	if (my $pid = fork) {
2443	close $fh2;
2444
2445	my $res = (Coro::Handle::unblock $fh1)->readline (undef);
2446	$res = Coro::Storable::thaw $res;
2447
2448	waitpid $pid, 0; # should not block anymore, we expect the child to simply behave
2449
2450	die $$res unless "ARRAY" eq ref $res;
2451
2452	return wantarray ? @$res : $res->[-1];
2453	} else {
2454	reset_signals;
2455	local $SIG{__WARN__};
2456	local $SIG{__DIE__};
2457	eval {
2458	close $fh1;
2459
2460	my @res = eval { $cb->(@args) };
2461	syswrite $fh2, Coro::Storable::freeze +($@ ? \"$@" : \@res);
2462	};
2463
2464	warn $@ if $@;
2465	_exit 0;
2466	}
2467	}
2468
2469
2470
2471	#############################################################################
2472	# the server's init and main functions	2836	# the server's init and main functions
2473		2837
2474	sub load_facedata($) {	2838	sub load_facedata($) {
2475	my ($path) = @_;	2839	my ($path) = @_;
		2840
		2841	my $enc = JSON::XS->new->utf8->canonical->relaxed;
2476		2842
2477	warn "loading facedata from $path\n";	2843	warn "loading facedata from $path\n";
2478		2844
2479	my $facedata;	2845	my $facedata;
2480	0 < aio_load $path, $facedata	2846	0 < aio_load $path, $facedata
…		…
2483	$facedata = Coro::Storable::thaw $facedata;	2849	$facedata = Coro::Storable::thaw $facedata;
2484		2850
2485	$facedata->{version} == 2	2851	$facedata->{version} == 2
2486	or cf::cleanup "$path: version mismatch, cannot proceed.";	2852	or cf::cleanup "$path: version mismatch, cannot proceed.";
2487		2853
		2854	# patch in the exptable
		2855	$facedata->{resource}{"res/exp_table"} = {
		2856	type => FT_RSRC,
		2857	data => $enc->encode ([map cf::level_to_min_exp $_, 1 .. cf::settings->max_level]),
		2858	};
		2859	cf::cede_to_tick;
		2860
2488	{	2861	{
2489	my $faces = $facedata->{faceinfo};	2862	my $faces = $facedata->{faceinfo};
2490		2863
2491	while (my ($face, $info) = each %$faces) {	2864	while (my ($face, $info) = each %$faces) {
2492	my $idx = (cf::face::find $face) || cf::face::alloc $face;	2865	my $idx = (cf::face::find $face) || cf::face::alloc $face;
2493	cf::face::set $idx, $info->{visibility}, $info->{magicmap};	2866	cf::face::set_visibility $idx, $info->{visibility};
		2867	cf::face::set_magicmap $idx, $info->{magicmap};
2494	cf::face::set_data $idx, 0, $info->{data32}, $info->{chksum32};	2868	cf::face::set_data $idx, 0, $info->{data32}, Digest::MD5::md5 $info->{data32};
2495	cf::face::set_data $idx, 1, $info->{data64}, $info->{chksum64};	2869	cf::face::set_data $idx, 1, $info->{data64}, Digest::MD5::md5 $info->{data64};
2496	Coro::cede;	2870
		2871	cf::cede_to_tick;
2497	}	2872	}
2498		2873
2499	while (my ($face, $info) = each %$faces) {	2874	while (my ($face, $info) = each %$faces) {
2500	next unless $info->{smooth};	2875	next unless $info->{smooth};
2501	my $idx = cf::face::find $face	2876	my $idx = cf::face::find $face
2502	or next;	2877	or next;
2503	if (my $smooth = cf::face::find $info->{smooth}) {	2878	if (my $smooth = cf::face::find $info->{smooth}) {
		2879	cf::face::set_smooth $idx, $smooth;
2504	cf::face::set_smooth $idx, $smooth, $info->{smoothlevel};	2880	cf::face::set_smoothlevel $idx, $info->{smoothlevel};
2505	} else {	2881	} else {
2506	warn "smooth face '$info->{smooth}' not found for face '$face'";	2882	warn "smooth face '$info->{smooth}' not found for face '$face'";
2507	}	2883	}
2508	Coro::cede;	2884
		2885	cf::cede_to_tick;
2509	}	2886	}
2510	}	2887	}
2511		2888
2512	{	2889	{
2513	my $anims = $facedata->{animinfo};	2890	my $anims = $facedata->{animinfo};
2514		2891
2515	while (my ($anim, $info) = each %$anims) {	2892	while (my ($anim, $info) = each %$anims) {
2516	cf::anim::set $anim, $info->{frames}, $info->{facings};	2893	cf::anim::set $anim, $info->{frames}, $info->{facings};
2517	Coro::cede;	2894	cf::cede_to_tick;
2518	}	2895	}
2519		2896
2520	cf::anim::invalidate_all; # d'oh	2897	cf::anim::invalidate_all; # d'oh
2521	}	2898	}
2522		2899
		2900	{
		2901	# TODO: for gcfclient pleasure, we should give resources
		2902	# that gcfclient doesn't grok a >10000 face index.
		2903	my $res = $facedata->{resource};
		2904
		2905	my $soundconf = delete $res->{"res/sound.conf"};
		2906
		2907	while (my ($name, $info) = each %$res) {
		2908	my $idx = (cf::face::find $name) || cf::face::alloc $name;
		2909	my $data;
		2910
		2911	if ($info->{type} & 1) {
		2912	# prepend meta info
		2913
		2914	my $meta = $enc->encode ({
		2915	name => $name,
		2916	%{ $info->{meta} || {} },
		2917	});
		2918
		2919	$data = pack "(w/a*)*", $meta, $info->{data};
		2920	} else {
		2921	$data = $info->{data};
		2922	}
		2923
		2924	cf::face::set_data $idx, 0, $data, Digest::MD5::md5 $data;
		2925	cf::face::set_type $idx, $info->{type};
		2926
		2927	cf::cede_to_tick;
		2928	}
		2929
		2930	if ($soundconf) {
		2931	$soundconf = $enc->decode (delete $soundconf->{data});
		2932
		2933	for (0 .. SOUND_CAST_SPELL_0 - 1) {
		2934	my $sound = $soundconf->{compat}[$_]
		2935	or next;
		2936
		2937	my $face = cf::face::find "sound/$sound->[1]";
		2938	cf::sound::set $sound->[0] => $face;
		2939	cf::sound::old_sound_index $_, $face; # gcfclient-compat
		2940	}
		2941
		2942	while (my ($k, $v) = each %{$soundconf->{event}}) {
		2943	my $face = cf::face::find "sound/$v";
		2944	cf::sound::set $k => $face;
		2945	}
		2946	}
		2947	}
		2948
2523	1	2949	1
2524	}	2950	}
		2951
		2952	register_exticmd fx_want => sub {
		2953	my ($ns, $want) = @_;
		2954
		2955	while (my ($k, $v) = each %$want) {
		2956	$ns->fx_want ($k, $v);
		2957	}
		2958	};
2525		2959
2526	sub reload_regions {	2960	sub reload_regions {
2527	load_resource_file "$MAPDIR/regions"	2961	load_resource_file "$MAPDIR/regions"
2528	or die "unable to load regions file\n";	2962	or die "unable to load regions file\n";
		2963
		2964	for (cf::region::list) {
		2965	$_->{match} = qr/$_->{match}/
		2966	if exists $_->{match};
		2967	}
2529	}	2968	}
2530		2969
2531	sub reload_facedata {	2970	sub reload_facedata {
2532	load_facedata "$DATADIR/facedata"	2971	load_facedata "$DATADIR/facedata"
2533	or die "unable to load facedata\n";	2972	or die "unable to load facedata\n";
2534	}	2973	}
2535		2974
2536	sub reload_archetypes {	2975	sub reload_archetypes {
2537	load_resource_file "$DATADIR/archetypes"	2976	load_resource_file "$DATADIR/archetypes"
2538	or die "unable to load archetypes\n";	2977	or die "unable to load archetypes\n";
		2978	#d# NEED to laod twice to resolve forward references
		2979	# this really needs to be done in an extra post-pass
		2980	# (which needs to be synchronous, so solve it differently)
		2981	load_resource_file "$DATADIR/archetypes"
		2982	or die "unable to load archetypes\n";
2539	}	2983	}
2540		2984
2541	sub reload_treasures {	2985	sub reload_treasures {
2542	load_resource_file "$DATADIR/treasures"	2986	load_resource_file "$DATADIR/treasures"
2543	or die "unable to load treasurelists\n";	2987	or die "unable to load treasurelists\n";
…		…
2546	sub reload_resources {	2990	sub reload_resources {
2547	warn "reloading resource files...\n";	2991	warn "reloading resource files...\n";
2548		2992
2549	reload_regions;	2993	reload_regions;
2550	reload_facedata;	2994	reload_facedata;
		2995	#reload_archetypes;#d#
2551	reload_archetypes;	2996	reload_archetypes;
2552	reload_treasures;	2997	reload_treasures;
2553		2998
2554	warn "finished reloading resource files\n";	2999	warn "finished reloading resource files\n";
2555	}	3000	}
2556		3001
2557	sub init {	3002	sub init {
2558	reload_resources;	3003	reload_resources;
2559	}	3004	}
2560		3005
2561	sub cfg_load {	3006	sub reload_config {
2562	open my $fh, "<:utf8", "$CONFDIR/config"	3007	open my $fh, "<:utf8", "$CONFDIR/config"
2563	or return;	3008	or return;
2564		3009
2565	local $/;	3010	local $/;
2566	*CFG = YAML::Syck::Load <$fh>;	3011	*CFG = YAML::Syck::Load <$fh>;
…		…
2586	(async {	3031	(async {
2587	Event::one_event;	3032	Event::one_event;
2588	})->prio (Coro::PRIO_MAX);	3033	})->prio (Coro::PRIO_MAX);
2589	};	3034	};
2590		3035
2591	cfg_load;	3036	reload_config;
2592	db_init;	3037	db_init;
2593	load_extensions;	3038	load_extensions;
2594		3039
2595	$TICK_WATCHER->start;	3040	$TICK_WATCHER->start;
2596	Event::loop;	3041	Event::loop;
…		…
2612	},	3057	},
2613	);	3058	);
2614	}	3059	}
2615	}	3060	}
2616		3061
		3062	sub write_runtime {
		3063	my $runtime = "$LOCALDIR/runtime";
		3064
		3065	# first touch the runtime file to show we are still running:
		3066	# the fsync below can take a very very long time.
		3067
		3068	IO::AIO::aio_utime $runtime, undef, undef;
		3069
		3070	my $guard = cf::lock_acquire "write_runtime";
		3071
		3072	my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
		3073	or return;
		3074
		3075	my $value = $cf::RUNTIME + 90 + 10;
		3076	# 10 is the runtime save interval, for a monotonic clock
		3077	# 60 allows for the watchdog to kill the server.
		3078
		3079	(aio_write $fh, 0, (length $value), $value, 0) <= 0
		3080	and return;
		3081
		3082	# always fsync - this file is important
		3083	aio_fsync $fh
		3084	and return;
		3085
		3086	# touch it again to show we are up-to-date
		3087	aio_utime $fh, undef, undef;
		3088
		3089	close $fh
		3090	or return;
		3091
		3092	aio_rename "$runtime~", $runtime
		3093	and return;
		3094
		3095	warn "runtime file written.\n";
		3096
		3097	1
		3098	}
		3099
2617	sub emergency_save() {	3100	sub emergency_save() {
2618	my $freeze_guard = cf::freeze_mainloop;	3101	my $freeze_guard = cf::freeze_mainloop;
2619		3102
2620	warn "enter emergency perl save\n";	3103	warn "enter emergency perl save\n";
2621		3104
…		…
2696	%EXT_CORO = ();	3179	%EXT_CORO = ();
2697		3180
2698	warn "removing commands";	3181	warn "removing commands";
2699	%COMMAND = ();	3182	%COMMAND = ();
2700		3183
2701	warn "removing ext commands";	3184	warn "removing ext/exti commands";
2702	%EXTCMD = ();	3185	%EXTCMD = ();
		3186	%EXTICMD = ();
2703		3187
2704	warn "unloading/nuking all extensions";	3188	warn "unloading/nuking all extensions";
2705	for my $pkg (@EXTS) {	3189	for my $pkg (@EXTS) {
2706	warn "... unloading $pkg";	3190	warn "... unloading $pkg";
2707		3191
…		…
2750	warn "reloading cf.pm";	3234	warn "reloading cf.pm";
2751	require cf;	3235	require cf;
2752	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt	3236	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
2753		3237
2754	warn "loading config and database again";	3238	warn "loading config and database again";
2755	cf::cfg_load;	3239	cf::reload_config;
2756		3240
2757	warn "loading extensions";	3241	warn "loading extensions";
2758	cf::load_extensions;	3242	cf::load_extensions;
2759		3243
2760	warn "reattaching attachments to objects/players";	3244	warn "reattaching attachments to objects/players";
…		…
2825	my $signal = new Coro::Signal;	3309	my $signal = new Coro::Signal;
2826	push @WAIT_FOR_TICK_BEGIN, $signal;	3310	push @WAIT_FOR_TICK_BEGIN, $signal;
2827	$signal->wait;	3311	$signal->wait;
2828	}	3312	}
2829		3313
		3314	my $min = 1e6;#d#
		3315	my $avg = 10;
2830	$TICK_WATCHER = Event->timer (	3316	$TICK_WATCHER = Event->timer (
2831	reentrant => 0,	3317	reentrant => 0,
2832	parked => 1,	3318	parked => 1,
2833	prio => 0,	3319	prio => 0,
2834	at => $NEXT_TICK || $TICK,	3320	at => $NEXT_TICK || $TICK,
…		…
2838	Carp::cluck "major BUG: server tick called outside of main coro, skipping it"	3324	Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
2839	unless ++$bug_warning > 10;	3325	unless ++$bug_warning > 10;
2840	return;	3326	return;
2841	}	3327	}
2842		3328
2843	$NOW = Event::time;	3329	$NOW = $tick_start = Event::time;
2844		3330
2845	cf::server_tick; # one server iteration	3331	cf::server_tick; # one server iteration
		3332
		3333	0 && sync_job {#d#
		3334	for(1..10) {
		3335	my $t = Event::time;
		3336	my $map = my $map = new_from_path cf::map "/tmp/x.map"
		3337	or die;
		3338
		3339	$map->width (50);
		3340	$map->height (50);
		3341	$map->alloc;
		3342	$map->_load_objects ("/tmp/x.map", 1);
		3343	my $t = Event::time - $t;
		3344
		3345	#next unless $t < 0.0013;#d#
		3346	if ($t < $min) {
		3347	$min = $t;
		3348	}
		3349	$avg = $avg * 0.99 + $t * 0.01;
		3350	}
		3351	warn "XXXXXXXXXXXXXXXXXX min $min avg $avg\n";#d#
		3352	exit 0;
		3353	# 2007-05-22 02:33:04.569 min 0.00112509727478027 avg 0.0012259249572477
		3354	};
2846		3355
2847	$RUNTIME += $TICK;	3356	$RUNTIME += $TICK;
2848	$NEXT_TICK += $TICK;	3357	$NEXT_TICK += $TICK;
2849		3358
2850	if ($NOW >= $NEXT_RUNTIME_WRITE) {	3359	if ($NOW >= $NEXT_RUNTIME_WRITE) {
…		…
2856	}	3365	}
2857		3366
2858	# my $AFTER = Event::time;	3367	# my $AFTER = Event::time;
2859	# warn $AFTER - $NOW;#d#	3368	# warn $AFTER - $NOW;#d#
2860		3369
		3370	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
		3371	$sig->send;
		3372	}
		3373	while (my $sig = shift @WAIT_FOR_TICK) {
		3374	$sig->send;
		3375	}
		3376
		3377	$NOW = Event::time;
		3378
2861	# if we are delayed by four ticks or more, skip them all	3379	# if we are delayed by four ticks or more, skip them all
2862	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;	3380	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
2863		3381
2864	$TICK_WATCHER->at ($NEXT_TICK);	3382	$TICK_WATCHER->at ($NEXT_TICK);
2865	$TICK_WATCHER->start;	3383	$TICK_WATCHER->start;
2866		3384
2867	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {	3385	$LOAD = ($NOW - $tick_start) / $TICK;
2868	$sig->send;	3386	$LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
2869	}
2870	while (my $sig = shift @WAIT_FOR_TICK) {
2871	$sig->send;
2872	}
2873		3387
2874	_post_tick;	3388	_post_tick;
		3389
		3390
2875	},	3391	},
2876	);	3392	);
2877		3393
2878	{	3394	{
2879	BDB::max_poll_time $TICK * 0.1;	3395	BDB::max_poll_time $TICK * 0.1;

Diff Legend

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