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.78 by root, Tue Nov 7 00:15:27 2006 UTC vs.
Revision 1.434 by root, Thu May 29 03:27:37 2008 UTC

		1	#
		2	# This file is part of Deliantra, the Roguelike Realtime MMORPG.
		3	#
		4	# Copyright (©) 2006,2007,2008 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
		5	#
		6	# Deliantra is free software: you can redistribute it and/or modify
		7	# it under the terms of the GNU General Public License as published by
		8	# the Free Software Foundation, either version 3 of the License, or
		9	# (at your option) any later version.
		10	#
		11	# This program is distributed in the hope that it will be useful,
		12	# but WITHOUT ANY WARRANTY; without even the implied warranty of
		13	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
		14	# GNU General Public License for more details.
		15	#
		16	# You should have received a copy of the GNU General Public License
		17	# along with this program. If not, see <http://www.gnu.org/licenses/>.
		18	#
		19	# The authors can be reached via e-mail to <support@deliantra.net>
		20	#
		21
1	package cf;	22	package cf;
		23
		24	use utf8;
		25	use strict;
2		26
3	use Symbol;	27	use Symbol;
4	use List::Util;	28	use List::Util;
5	use Storable;	29	use Socket;
		30	use EV;
6	use Opcode;	31	use Opcode;
7	use Safe;	32	use Safe;
8	use Safe::Hole;	33	use Safe::Hole;
		34	use Storable ();
9		35
		36	use Coro ();
		37	use Coro::State;
		38	use Coro::Handle;
		39	use Coro::AnyEvent;
		40	use Coro::Timer;
		41	use Coro::Signal;
		42	use Coro::Semaphore;
		43	use Coro::AnyEvent;
		44	use Coro::AIO;
		45	use Coro::BDB;
		46	use Coro::Storable;
		47	use Coro::Util ();
		48
		49	use JSON::XS 2.01 ();
		50	use BDB ();
		51	use Data::Dumper;
		52	use Digest::MD5;
		53	use Fcntl;
		54	use YAML ();
10	use IO::AIO ();	55	use IO::AIO ();
11	use YAML::Syck ();
12	use Time::HiRes;	56	use Time::HiRes;
13	use Event;	57	use Compress::LZF;
14	$Event::Eval = 1; # no idea why this is required, but it is	58	use Digest::MD5 ();
15		59
16	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?	60	AnyEvent::detect;
17	$YAML::Syck::ImplicitUnicode = 1;
18		61
19	use strict;	62	IO::AIO::max_poll_reqs 1;#d#
20		63
21	_init_vars;	64	# configure various modules to our taste
		65	#
		66	$Storable::canonical = 1; # reduce rsync transfers
		67	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
		68	Compress::LZF::sfreeze_cr { }; # prime Compress::LZF so it does not use require later
22		69
		70	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
		71
		72	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
		73
23	our %COMMAND = ();	74	our %COMMAND = ();
		75	our %COMMAND_TIME = ();
		76
		77	our @EXTS = (); # list of extension package names
		78	our %EXTCMD = ();
		79	our %EXTICMD = ();
		80	our %EXT_CORO = (); # coroutines bound to extensions
		81	our %EXT_MAP = (); # pluggable maps
		82
		83	our $RELOAD; # number of reloads so far
24	our @EVENT;	84	our @EVENT;
25	our $LIBDIR = maps_directory "perl";
26		85
27	our $TICK = MAX_TIME * 1e-6;	86	our $CONFDIR = confdir;
28	our $TICK_WATCHER;	87	our $DATADIR = datadir;
		88	our $LIBDIR = "$DATADIR/ext";
		89	our $PODDIR = "$DATADIR/pod";
		90	our $MAPDIR = "$DATADIR/" . mapdir;
		91	our $LOCALDIR = localdir;
		92	our $TMPDIR = "$LOCALDIR/" . tmpdir;
		93	our $UNIQUEDIR = "$LOCALDIR/" . uniquedir;
		94	our $PLAYERDIR = "$LOCALDIR/" . playerdir;
		95	our $RANDOMDIR = "$LOCALDIR/random";
		96	our $BDBDIR = "$LOCALDIR/db";
		97	our %RESOURCE;
		98
		99	our $TICK = MAX_TIME * 1e-6; # this is a CONSTANT(!)
		100	our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
29	our $NEXT_TICK;	101	our $NEXT_TICK;
		102	our $USE_FSYNC = 1; # use fsync to write maps - default off
		103
		104	our $BDB_DEADLOCK_WATCHER;
		105	our $BDB_CHECKPOINT_WATCHER;
		106	our $BDB_TRICKLE_WATCHER;
		107	our $DB_ENV;
30		108
31	our %CFG;	109	our %CFG;
32		110
33	our $uptime;	111	our $UPTIME; $UPTIME ||= time;
		112	our $RUNTIME;
		113	our $NOW;
34		114
35	$uptime ||= time;	115	our (%PLAYER, %PLAYER_LOADING); # all users
		116	our (%MAP, %MAP_LOADING ); # all maps
		117	our $LINK_MAP; # the special {link} map, which is always available
		118
		119	# used to convert map paths into valid unix filenames by replacing / by ∕
		120	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
		121
		122	our $LOAD; # a number between 0 (idle) and 1 (too many objects)
		123	our $LOADAVG; # same thing, but with alpha-smoothing
		124	our $JITTER; # average jitter
		125	our $TICK_START; # for load detecting purposes
		126
		127	binmode STDOUT;
		128	binmode STDERR;
		129
		130	# read virtual server time, if available
		131	unless ($RUNTIME || !-e "$LOCALDIR/runtime") {
		132	open my $fh, "<", "$LOCALDIR/runtime"
		133	or die "unable to read runtime file: $!";
		134	$RUNTIME = <$fh> + 0.;
		135	}
		136
		137	mkdir $_
		138	for $LOCALDIR, $TMPDIR, $UNIQUEDIR, $PLAYERDIR, $RANDOMDIR, $BDBDIR;
		139
		140	our $EMERGENCY_POSITION;
		141
		142	sub cf::map::normalise;
36		143
37	#############################################################################	144	#############################################################################
38		145
39	=head2 GLOBAL VARIABLES	146	=head2 GLOBAL VARIABLES
40		147
41	=over 4	148	=over 4
42		149
43	=item $cf::LIBDIR	150	=item $cf::UPTIME
44		151
45	The perl library directory, where extensions and cf-specific modules can	152	The timestamp of the server start (so not actually an uptime).
46	be found. It will be added to C<@INC> automatically.	153
		154	=item $cf::RUNTIME
		155
		156	The time this server has run, starts at 0 and is increased by $cf::TICK on
		157	every server tick.
		158
		159	=item $cf::CONFDIR $cf::DATADIR $cf::LIBDIR $cf::PODDIR
		160	$cf::MAPDIR $cf::LOCALDIR $cf::TMPDIR $cf::UNIQUEDIR
		161	$cf::PLAYERDIR $cf::RANDOMDIR $cf::BDBDIR
		162
		163	Various directories - "/etc", read-only install directory, perl-library
		164	directory, pod-directory, read-only maps directory, "/var", "/var/tmp",
		165	unique-items directory, player file directory, random maps directory and
		166	database environment.
		167
		168	=item $cf::NOW
		169
		170	The time of the last (current) server tick.
47		171
48	=item $cf::TICK	172	=item $cf::TICK
49		173
50	The interval between server ticks, in seconds.	174	The interval between server ticks, in seconds.
51		175
		176	=item $cf::LOADAVG
		177
		178	The current CPU load on the server (alpha-smoothed), as a value between 0
		179	(none) and 1 (overloaded), indicating how much time is spent on processing
		180	objects per tick. Healthy values are < 0.5.
		181
		182	=item $cf::LOAD
		183
		184	The raw value load value from the last tick.
		185
52	=item %cf::CFG	186	=item %cf::CFG
53		187
54	Configuration for the server, loaded from C</etc/crossfire/config>, or	188	Configuration for the server, loaded from C</etc/deliantra-server/config>, or
55	from wherever your confdir points to.	189	from wherever your confdir points to.
		190
		191	=item cf::wait_for_tick, cf::wait_for_tick_begin
		192
		193	These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only
		194	returns directly I<after> the tick processing (and consequently, can only wake one process
		195	per tick), while cf::wait_for_tick wakes up all waiters after tick processing.
		196
		197	=item @cf::INVOKE_RESULTS
		198
		199	This array contains the results of the last C<invoke ()> call. When
		200	C<cf::override> is called C<@cf::INVOKE_RESULTS> is set to the parameters of
		201	that call.
56		202
57	=back	203	=back
58		204
59	=cut	205	=cut
60		206
61	BEGIN {	207	BEGIN {
62	*CORE::GLOBAL::warn = sub {	208	*CORE::GLOBAL::warn = sub {
63	my $msg = join "", @_;	209	my $msg = join "", @_;
		210
64	$msg .= "\n"	211	$msg .= "\n"
65	unless $msg =~ /\n$/;	212	unless $msg =~ /\n$/;
66		213
67	print STDERR "cfperl: $msg";	214	$msg =~ s/([\x00-\x08\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
		215
68	LOG llevError, "cfperl: $msg";	216	LOG llevError, $msg;
69	};	217	};
70	}	218	}
71		219
		220	$Coro::State::DIEHOOK = sub {
		221	return unless $^S eq 0; # "eq", not "=="
		222
		223	if ($Coro::current == $Coro::main) {#d#
		224	warn "DIEHOOK called in main context, Coro bug?\n";#d#
		225	return;#d#
		226	}#d#
		227
		228	# kill coroutine otherwise
		229	warn Carp::longmess $_[0];
		230	Coro::terminate
		231	};
		232
		233	$SIG{__DIE__} = sub { }; #d#?
		234
		235	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
		236	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
		237	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
		238	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
		239	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
		240	@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
72	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	241	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; # not really true (yet)
73		242
74	# we bless all objects into (empty) derived classes to force a method lookup	243	# we bless all objects into (empty) derived classes to force a method lookup
75	# within the Safe compartment.	244	# within the Safe compartment.
76	for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch cf::living)) {	245	for my $pkg (qw(
		246	cf::global cf::attachable
		247	cf::object cf::object::player
		248	cf::client cf::player
		249	cf::arch cf::living
		250	cf::map cf::party cf::region
		251	)) {
77	no strict 'refs';	252	no strict 'refs';
78	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;	253	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
79	}	254	}
80		255
81	$Event::DIED = sub {	256	$EV::DIED = sub {
82	warn "error in event callback: @_";	257	warn "error in event callback: @_";
83	};	258	};
84		259
85	my %ext_pkg;	260	#############################################################################
86	my @exts;
87	my @hook;
88	my %command;
89	my %extcmd;
90		261
91	=head2 UTILITY FUNCTIONS	262	=head2 UTILITY FUNCTIONS
92		263
93	=over 4	264	=over 4
94		265
95	=cut	266	=item dumpval $ref
96		267
97	use JSON::Syck (); # TODO# replace by JSON::PC once working	268	=cut
98		269
		270	sub dumpval {
		271	eval {
		272	local $SIG{__DIE__};
		273	my $d;
		274	if (1) {
		275	$d = new Data::Dumper([$_[0]], ["*var"]);
		276	$d->Terse(1);
		277	$d->Indent(2);
		278	$d->Quotekeys(0);
		279	$d->Useqq(1);
		280	#$d->Bless(...);
		281	$d->Seen($_[1]) if @_ > 1;
		282	$d = $d->Dump();
		283	}
		284	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
		285	$d
		286	} || "[unable to dump $_[0]: '$@']";
		287	}
		288
99	=item $ref = cf::from_json $json	289	=item $ref = cf::decode_json $json
100		290
101	Converts a JSON string into the corresponding perl data structure.	291	Converts a JSON string into the corresponding perl data structure.
102		292
103	=cut
104
105	sub from_json($) {
106	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
107	JSON::Syck::Load $_[0]
108	}
109
110	=item $json = cf::to_json $ref	293	=item $json = cf::encode_json $ref
111		294
112	Converts a perl data structure into its JSON representation.	295	Converts a perl data structure into its JSON representation.
113		296
114	=cut	297	=cut
115		298
116	sub to_json($) {	299	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
117	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs	300
118	JSON::Syck::Dump $_[0]	301	sub encode_json($) { $json_coder->encode ($_[0]) }
		302	sub decode_json($) { $json_coder->decode ($_[0]) }
		303
		304	=item cf::lock_wait $string
		305
		306	Wait until the given lock is available. See cf::lock_acquire.
		307
		308	=item my $lock = cf::lock_acquire $string
		309
		310	Wait until the given lock is available and then acquires it and returns
		311	a Coro::guard object. If the guard object gets destroyed (goes out of scope,
		312	for example when the coroutine gets canceled), the lock is automatically
		313	returned.
		314
		315	Locks are *not* recursive, locking from the same coro twice results in a
		316	deadlocked coro.
		317
		318	Lock names should begin with a unique identifier (for example, cf::map::find
		319	uses map_find and cf::map::load uses map_load).
		320
		321	=item $locked = cf::lock_active $string
		322
		323	Return true if the lock is currently active, i.e. somebody has locked it.
		324
		325	=cut
		326
		327	our %LOCK;
		328	our %LOCKER;#d#
		329
		330	sub lock_wait($) {
		331	my ($key) = @_;
		332
		333	if ($LOCKER{$key} == $Coro::current) {#d#
		334	Carp::cluck "lock_wait($key) for already-acquired lock";#d#
		335	return;#d#
		336	}#d#
		337
		338	# wait for lock, if any
		339	while ($LOCK{$key}) {
		340	push @{ $LOCK{$key} }, $Coro::current;
		341	Coro::schedule;
		342	}
		343	}
		344
		345	sub lock_acquire($) {
		346	my ($key) = @_;
		347
		348	# wait, to be sure we are not locked
		349	lock_wait $key;
		350
		351	$LOCK{$key} = [];
		352	$LOCKER{$key} = $Coro::current;#d#
		353
		354	Coro::guard {
		355	delete $LOCKER{$key};#d#
		356	# wake up all waiters, to be on the safe side
		357	$_->ready for @{ delete $LOCK{$key} };
		358	}
		359	}
		360
		361	sub lock_active($) {
		362	my ($key) = @_;
		363
		364	! ! $LOCK{$key}
		365	}
		366
		367	sub freeze_mainloop {
		368	tick_inhibit_inc;
		369
		370	Coro::guard \&tick_inhibit_dec;
		371	}
		372
		373	=item cf::periodic $interval, $cb
		374
		375	Like EV::periodic, but randomly selects a starting point so that the actions
		376	get spread over timer.
		377
		378	=cut
		379
		380	sub periodic($$) {
		381	my ($interval, $cb) = @_;
		382
		383	my $start = rand List::Util::min 180, $interval;
		384
		385	EV::periodic $start, $interval, 0, $cb
		386	}
		387
		388	=item cf::get_slot $time[, $priority[, $name]]
		389
		390	Allocate $time seconds of blocking CPU time at priority C<$priority>:
		391	This call blocks and returns only when you have at least C<$time> seconds
		392	of cpu time till the next tick. The slot is only valid till the next cede.
		393
		394	The optional C<$name> can be used to identify the job to run. It might be
		395	used for statistical purposes and should identify the same time-class.
		396
		397	Useful for short background jobs.
		398
		399	=cut
		400
		401	our @SLOT_QUEUE;
		402	our $SLOT_QUEUE;
		403
		404	$SLOT_QUEUE->cancel if $SLOT_QUEUE;
		405	$SLOT_QUEUE = Coro::async {
		406	$Coro::current->desc ("timeslot manager");
		407
		408	my $signal = new Coro::Signal;
		409
		410	while () {
		411	next_job:
		412	my $avail = cf::till_tick;
		413	if ($avail > 0.01) {
		414	for (0 .. $#SLOT_QUEUE) {
		415	if ($SLOT_QUEUE[$_][0] < $avail) {
		416	my $job = splice @SLOT_QUEUE, $_, 1, ();
		417	$job->[2]->send;
		418	Coro::cede;
		419	goto next_job;
		420	}
		421	}
		422	}
		423
		424	if (@SLOT_QUEUE) {
		425	# we do not use wait_for_tick() as it returns immediately when tick is inactive
		426	push @cf::WAIT_FOR_TICK, $signal;
		427	$signal->wait;
		428	} else {
		429	Coro::schedule;
		430	}
		431	}
		432	};
		433
		434	sub get_slot($;$$) {
		435	return if tick_inhibit || $Coro::current == $Coro::main;
		436
		437	my ($time, $pri, $name) = @_;
		438
		439	$time = $TICK * .6 if $time > $TICK * .6;
		440	my $sig = new Coro::Signal;
		441
		442	push @SLOT_QUEUE, [$time, $pri, $sig, $name];
		443	@SLOT_QUEUE = sort { $b->[1] <=> $a->[1] } @SLOT_QUEUE;
		444	$SLOT_QUEUE->ready;
		445	$sig->wait;
		446	}
		447
		448	=item cf::async { BLOCK }
		449
		450	Currently the same as Coro::async_pool, meaning you cannot use
		451	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
		452	thing you are allowed to do is call C<prio> on it.
		453
		454	=cut
		455
		456	BEGIN { *async = \&Coro::async_pool }
		457
		458	=item cf::sync_job { BLOCK }
		459
		460	The design of Deliantra requires that the main coroutine ($Coro::main)
		461	is always able to handle events or runnable, as Deliantra is only
		462	partly reentrant. Thus "blocking" it by e.g. waiting for I/O is not
		463	acceptable.
		464
		465	If it must be done, put the blocking parts into C<sync_job>. This will run
		466	the given BLOCK in another coroutine while waiting for the result. The
		467	server will be frozen during this time, so the block should either finish
		468	fast or be very important.
		469
		470	=cut
		471
		472	sub sync_job(&) {
		473	my ($job) = @_;
		474
		475	if ($Coro::current == $Coro::main) {
		476	my $time = EV::time;
		477
		478	# this is the main coro, too bad, we have to block
		479	# till the operation succeeds, freezing the server :/
		480
		481	LOG llevError, Carp::longmess "sync job";#d#
		482
		483	my $freeze_guard = freeze_mainloop;
		484
		485	my $busy = 1;
		486	my @res;
		487
		488	(async {
		489	$Coro::current->desc ("sync job coro");
		490	@res = eval { $job->() };
		491	warn $@ if $@;
		492	undef $busy;
		493	})->prio (Coro::PRIO_MAX);
		494
		495	while ($busy) {
		496	if (Coro::nready) {
		497	Coro::cede_notself;
		498	} else {
		499	EV::loop EV::LOOP_ONESHOT;
		500	}
		501	}
		502
		503	my $time = EV::time - $time;
		504
		505	$TICK_START += $time; # do not account sync jobs to server load
		506
		507	wantarray ? @res : $res[0]
		508	} else {
		509	# we are in another coroutine, how wonderful, everything just works
		510
		511	$job->()
		512	}
		513	}
		514
		515	=item $coro = cf::async_ext { BLOCK }
		516
		517	Like async, but this coro is automatically being canceled when the
		518	extension calling this is being unloaded.
		519
		520	=cut
		521
		522	sub async_ext(&) {
		523	my $cb = shift;
		524
		525	my $coro = &Coro::async ($cb);
		526
		527	$coro->on_destroy (sub {
		528	delete $EXT_CORO{$coro+0};
		529	});
		530	$EXT_CORO{$coro+0} = $coro;
		531
		532	$coro
		533	}
		534
		535	=item fork_call { }, $args
		536
		537	Executes the given code block with the given arguments in a seperate
		538	process, returning the results. Everything must be serialisable with
		539	Coro::Storable. May, of course, block. Note that the executed sub may
		540	never block itself or use any form of event handling.
		541
		542	=cut
		543
		544	sub fork_call(&@) {
		545	my ($cb, @args) = @_;
		546
		547	# we seemingly have to make a local copy of the whole thing,
		548	# otherwise perl prematurely frees the stuff :/
		549	# TODO: investigate and fix (likely this will be rather laborious)
		550
		551	my @res = Coro::Util::fork_eval {
		552	reset_signals;
		553	&$cb
		554	}, @args;
		555
		556	wantarray ? @res : $res[-1]
		557	}
		558
		559	=item $coin = coin_from_name $name
		560
		561	=cut
		562
		563	our %coin_alias = (
		564	"silver" => "silvercoin",
		565	"silvercoin" => "silvercoin",
		566	"silvercoins" => "silvercoin",
		567	"gold" => "goldcoin",
		568	"goldcoin" => "goldcoin",
		569	"goldcoins" => "goldcoin",
		570	"platinum" => "platinacoin",
		571	"platinumcoin" => "platinacoin",
		572	"platinumcoins" => "platinacoin",
		573	"platina" => "platinacoin",
		574	"platinacoin" => "platinacoin",
		575	"platinacoins" => "platinacoin",
		576	"royalty" => "royalty",
		577	"royalties" => "royalty",
		578	);
		579
		580	sub coin_from_name($) {
		581	$coin_alias{$_[0]}
		582	? cf::arch::find $coin_alias{$_[0]}
		583	: undef
		584	}
		585
		586	=item $value = cf::db_get $family => $key
		587
		588	Returns a single value from the environment database.
		589
		590	=item cf::db_put $family => $key => $value
		591
		592	Stores the given C<$value> in the family. It can currently store binary
		593	data only (use Compress::LZF::sfreeze_cr/sthaw to convert to/from binary).
		594
		595	=item $db = cf::db_table "name"
		596
		597	Create and/or open a new database table. The string must not be "db" and must be unique
		598	within each server.
		599
		600	=cut
		601
		602	sub db_table($) {
		603	my ($name) = @_;
		604	my $db = BDB::db_create $DB_ENV;
		605
		606	eval {
		607	$db->set_flags (BDB::CHKSUM);
		608
		609	utf8::encode $name;
		610	BDB::db_open $db, undef, $name, undef, BDB::BTREE,
		611	BDB::CREATE | BDB::AUTO_COMMIT, 0666;
		612	cf::cleanup "db_open(db): $!" if $!;
		613	};
		614	cf::cleanup "db_open(db): $@" if $@;
		615
		616	$db
		617	}
		618
		619	our $DB;
		620
		621	sub db_init {
		622	cf::sync_job {
		623	$DB ||= db_table "db";
		624	};
		625	}
		626
		627	sub db_get($$) {
		628	my $key = "$_[0]/$_[1]";
		629
		630	cf::sync_job {
		631	BDB::db_get $DB, undef, $key, my $data;
		632
		633	$! ? ()
		634	: $data
		635	}
		636	}
		637
		638	sub db_put($$$) {
		639	BDB::dbreq_pri 4;
		640	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
		641	}
		642
		643	=item cf::cache $id => [$paths...], $processversion => $process
		644
		645	Generic caching function that returns the value of the resource $id,
		646	caching and regenerating as required.
		647
		648	This function can block.
		649
		650	=cut
		651
		652	sub cache {
		653	my ($id, $src, $processversion, $process) = @_;
		654
		655	my $meta =
		656	join "\x00",
		657	$processversion,
		658	map {
		659	aio_stat $_
		660	and Carp::croak "$_: $!";
		661
		662	($_, (stat _)[7,9])
		663	} @$src;
		664
		665	my $dbmeta = db_get cache => "$id/meta";
		666	if ($dbmeta ne $meta) {
		667	# changed, we may need to process
		668
		669	my @data;
		670	my $md5;
		671
		672	for (0 .. $#$src) {
		673	0 <= aio_load $src->[$_], $data[$_]
		674	or Carp::croak "$src->[$_]: $!";
		675	}
		676
		677	# if processing is expensive, check
		678	# checksum first
		679	if (1) {
		680	$md5 =
		681	join "\x00",
		682	$processversion,
		683	map {
		684	cf::cede_to_tick;
		685	($src->[$_], Digest::MD5::md5_hex $data[$_])
		686	} 0.. $#$src;
		687
		688
		689	my $dbmd5 = db_get cache => "$id/md5";
		690	if ($dbmd5 eq $md5) {
		691	db_put cache => "$id/meta", $meta;
		692
		693	return db_get cache => "$id/data";
		694	}
		695	}
		696
		697	my $t1 = Time::HiRes::time;
		698	my $data = $process->(\@data);
		699	my $t2 = Time::HiRes::time;
		700
		701	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
		702
		703	db_put cache => "$id/data", $data;
		704	db_put cache => "$id/md5" , $md5;
		705	db_put cache => "$id/meta", $meta;
		706
		707	return $data;
		708	}
		709
		710	db_get cache => "$id/data"
		711	}
		712
		713	=item cf::datalog type => key => value, ...
		714
		715	Log a datalog packet of the given type with the given key-value pairs.
		716
		717	=cut
		718
		719	sub datalog($@) {
		720	my ($type, %kv) = @_;
		721	warn "DATALOG ", JSON::XS->new->ascii->encode ({ %kv, type => $type });
119	}	722	}
120		723
121	=back	724	=back
122		725
123	=cut	726	=cut
124		727
125	#############################################################################	728	#############################################################################
126		729
127	=head2 EVENTS AND OBJECT ATTACHMENTS	730	=head2 ATTACHABLE OBJECTS
		731
		732	Many objects in crossfire are so-called attachable objects. That means you can
		733	attach callbacks/event handlers (a collection of which is called an "attachment")
		734	to it. All such attachable objects support the following methods.
		735
		736	In the following description, CLASS can be any of C<global>, C<object>
		737	C<player>, C<client> or C<map> (i.e. the attachable objects in
		738	Deliantra).
128		739
129	=over 4	740	=over 4
130		741
131	=item $object->attach ($attachment, key => $value...)
132
133	=item $object->detach ($attachment)
134
135	Attach/detach a pre-registered attachment to an object.
136
137	=item $player->attach ($attachment, key => $value...)
138
139	=item $player->detach ($attachment)
140
141	Attach/detach a pre-registered attachment to a player.
142
143	=item $map->attach ($attachment, key => $value...)	742	=item $attachable->attach ($attachment, key => $value...)
144		743
145	=item $map->detach ($attachment)	744	=item $attachable->detach ($attachment)
146		745
147	Attach/detach a pre-registered attachment to a map.	746	Attach/detach a pre-registered attachment to a specific object and give it
		747	the specified key/value pairs as arguments.
148		748
149	=item $bool = $object->attached ($name)	749	Example, attach a minesweeper attachment to the given object, making it a
		750	10x10 minesweeper game:
150		751
151	=item $bool = $player->attached ($name)	752	$obj->attach (minesweeper => width => 10, height => 10);
152		753
153	=item $bool = $map->attached ($name)	754	=item $bool = $attachable->attached ($name)
154		755
155	Checks wether the named attachment is currently attached to the object.	756	Checks wether the named attachment is currently attached to the object.
156		757
157	=item cf::attach_global ...	758	=item cf::CLASS->attach ...
158		759
159	Attach handlers for global events.	760	=item cf::CLASS->detach ...
160		761
161	This and all following C<attach_*>-functions expect any number of the	762	Define an anonymous attachment and attach it to all objects of the given
162	following handler/hook descriptions:	763	CLASS. See the next function for an explanation of its arguments.
		764
		765	You can attach to global events by using the C<cf::global> class.
		766
		767	Example, log all player logins:
		768
		769	cf::player->attach (
		770	on_login => sub {
		771	my ($pl) = @_;
		772	...
		773	},
		774	);
		775
		776	Example, attach to the jeweler skill:
		777
		778	cf::object->attach (
		779	type => cf::SKILL,
		780	subtype => cf::SK_JEWELER,
		781	on_use_skill => sub {
		782	my ($sk, $ob, $part, $dir, $msg) = @_;
		783	...
		784	},
		785	);
		786
		787	=item cf::CLASS::attachment $name, ...
		788
		789	Register an attachment by C<$name> through which attachable objects of the
		790	given CLASS can refer to this attachment.
		791
		792	Some classes such as crossfire maps and objects can specify attachments
		793	that are attached at load/instantiate time, thus the need for a name.
		794
		795	These calls expect any number of the following handler/hook descriptions:
163		796
164	=over 4	797	=over 4
165		798
166	=item prio => $number	799	=item prio => $number
167		800
…		…
169	by another C<prio> setting). Lower priority handlers get executed	802	by another C<prio> setting). Lower priority handlers get executed
170	earlier. The default priority is C<0>, and many built-in handlers are	803	earlier. The default priority is C<0>, and many built-in handlers are
171	registered at priority C<-1000>, so lower priorities should not be used	804	registered at priority C<-1000>, so lower priorities should not be used
172	unless you know what you are doing.	805	unless you know what you are doing.
173		806
		807	=item type => $type
		808
		809	(Only for C<< cf::object->attach >> calls), limits the attachment to the
		810	given type of objects only (the additional parameter C<subtype> can be
		811	used to further limit to the given subtype).
		812
174	=item on_I<event> => \&cb	813	=item on_I<event> => \&cb
175		814
176	Call the given code reference whenever the named event happens (event is	815	Call the given code reference whenever the named event happens (event is
177	something like C<instantiate>, C<apply>, C<use_skill> and so on, and which	816	something like C<instantiate>, C<apply>, C<use_skill> and so on, and which
178	handlers are recognised generally depends on the type of object these	817	handlers are recognised generally depends on the type of object these
…		…
187	package and register them. Only handlers for eevents supported by the	826	package and register them. Only handlers for eevents supported by the
188	object/class are recognised.	827	object/class are recognised.
189		828
190	=back	829	=back
191		830
192	=item cf::attach_to_type $object_type, $subtype, ...	831	Example, define an attachment called "sockpuppet" that calls the given
		832	event handler when a monster attacks:
193		833
194	Attach handlers for a specific object type (e.g. TRANSPORT) and	834	cf::object::attachment sockpuppet =>
195	subtype. If C<$subtype> is zero or undef, matches all objects of the given	835	on_skill_attack => sub {
196	type.	836	my ($self, $victim) = @_;
197		837	...
198	=item cf::attach_to_objects ...
199
200	Attach handlers to all objects. Do not use this except for debugging or
201	very rare events, as handlers are (obviously) called for I<all> objects in
202	the game.
203
204	=item cf::attach_to_players ...
205
206	Attach handlers to all players.
207
208	=item cf::attach_to_maps ...
209
210	Attach handlers to all maps.
211
212	=item cf:register_attachment $name, ...
213
214	Register an attachment by name through which objects can refer to this
215	attachment.
216
217	=item cf:register_player_attachment $name, ...
218
219	Register an attachment by name through which players can refer to this
220	attachment.
221
222	=item cf:register_map_attachment $name, ...
223
224	Register an attachment by name through which maps can refer to this
225	attachment.
226
227	=cut
228
229	# the following variables are defined in .xs and must not be re-created
230	our @CB_GLOBAL = (); # registry for all global events
231	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
232	our @CB_PLAYER = ();
233	our @CB_TYPE = (); # registry for type (cf-object class) based events
234	our @CB_MAP = ();
235
236	my %attachment;
237
238	sub _attach_cb($\%$$$) {
239	my ($registry, $undo, $event, $prio, $cb) = @_;
240
241	use sort 'stable';
242
243	$cb = [$prio, $cb];
244
245	@{$registry->[$event]} = sort
246	{ $a->[0] cmp $b->[0] }
247	@{$registry->[$event] || []}, $cb;
248
249	push @{$undo->{cb}}, [$event, $cb];
250	}
251
252	# attach handles attaching event callbacks
253	# the only thing the caller has to do is pass the correct
254	# registry (== where the callback attaches to).
255	sub _attach(\@$@) {
256	my ($registry, $klass, @arg) = @_;
257
258	my $prio = 0;
259
260	my %undo = (
261	registry => $registry,
262	cb => [],
263	);
264
265	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
266
267	while (@arg) {
268	my $type = shift @arg;
269
270	if ($type eq "prio") {
271	$prio = shift @arg;
272
273	} elsif ($type eq "package") {
274	my $pkg = shift @arg;
275
276	while (my ($name, $id) = each %cb_id) {
277	if (my $cb = $pkg->can ($name)) {
278	_attach_cb $registry, %undo, $id, $prio, $cb;
279	}
280	}	838	}
281
282	} elsif (exists $cb_id{$type}) {
283	_attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @arg;
284
285	} elsif (ref $type) {
286	warn "attaching objects not supported, ignoring.\n";
287
288	} else {
289	shift @arg;
290	warn "attach argument '$type' not supported, ignoring.\n";
291	}
292	}
293
294	\%undo
295	}
296
297	sub _attach_attachment {
298	my ($obj, $name, %arg) = @_;
299
300	return if exists $obj->{_attachment}{$name};
301
302	my $res;
303
304	if (my $attach = $attachment{$name}) {
305	my $registry = $obj->registry;
306
307	for (@$attach) {
308	my ($klass, @attach) = @$_;
309	$res = _attach @$registry, $klass, @attach;
310	}
311
312	$obj->{$name} = \%arg;
313	} else {
314	warn "object uses attachment '$name' that is not available, postponing.\n";
315	}
316
317	$obj->{_attachment}{$name} = undef;
318
319	$res->{attachment} = $name;
320	$res
321	}
322
323	*cf::object::attach =
324	*cf::player::attach =
325	*cf::map::attach = sub {
326	my ($obj, $name, %arg) = @_;
327
328	_attach_attachment $obj, $name, %arg;
329	};
330
331	# all those should be optimised
332	*cf::object::detach =
333	*cf::player::detach =
334	*cf::map::detach = sub {
335	my ($obj, $name) = @_;
336
337	delete $obj->{_attachment}{$name};
338	reattach ($obj);
339	};
340
341	*cf::object::attached =
342	*cf::player::attached =
343	*cf::map::attached = sub {
344	my ($obj, $name) = @_;
345
346	exists $obj->{_attachment}{$name}
347	};
348
349	sub attach_global {
350	_attach @CB_GLOBAL, KLASS_GLOBAL, @_
351	}
352
353	sub attach_to_type {
354	my $type = shift;
355	my $subtype = shift;
356
357	_attach @{$CB_TYPE[$type + $subtype * NUM_SUBTYPES]}, KLASS_OBJECT, @_
358	}
359
360	sub attach_to_objects {
361	_attach @CB_OBJECT, KLASS_OBJECT, @_
362	}
363
364	sub attach_to_players {
365	_attach @CB_PLAYER, KLASS_PLAYER, @_
366	}
367
368	sub attach_to_maps {
369	_attach @CB_MAP, KLASS_MAP, @_
370	}
371
372	sub register_attachment {
373	my $name = shift;
374
375	$attachment{$name} = [[KLASS_OBJECT, @_]];
376	}
377
378	sub register_player_attachment {
379	my $name = shift;
380
381	$attachment{$name} = [[KLASS_PLAYER, @_]];
382	}
383
384	sub register_map_attachment {
385	my $name = shift;
386
387	$attachment{$name} = [[KLASS_MAP, @_]];
388	}
389
390	our $override;
391	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
392
393	sub override {
394	$override = 1;
395	@invoke_results = ();
396	}
397
398	sub do_invoke {
399	my $event = shift;
400	my $callbacks = shift;
401
402	@invoke_results = ();
403
404	local $override;
405
406	for (@$callbacks) {
407	eval { &{$_->[1]} };
408
409	if ($@) {
410	warn "$@";
411	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
412	override;
413	}
414
415	return 1 if $override;
416	}
417
418	0	839	}
419	}
420		840
421	=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...	841	=item $attachable->valid
422
423	=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
424
425	=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
426
427	=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
428
429	Generate a global/object/player/map-specific event with the given arguments.
430
431	This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
432	removed in future versions), and there is no public API to access override
433	results (if you must, access C<@cf::invoke_results> directly).
434
435	=back
436
437	=cut
438
439	#############################################################################
440
441	=head2 METHODS VALID FOR ALL CORE OBJECTS
442
443	=over 4
444
445	=item $object->valid, $player->valid, $map->valid
446		842
447	Just because you have a perl object does not mean that the corresponding	843	Just because you have a perl object does not mean that the corresponding
448	C-level object still exists. If you try to access an object that has no	844	C-level object still exists. If you try to access an object that has no
449	valid C counterpart anymore you get an exception at runtime. This method	845	valid C counterpart anymore you get an exception at runtime. This method
450	can be used to test for existence of the C object part without causing an	846	can be used to test for existence of the C object part without causing an
451	exception.	847	exception.
452		848
		849	=cut
		850
		851	# the following variables are defined in .xs and must not be re-created
		852	our @CB_GLOBAL = (); # registry for all global events
		853	our @CB_ATTACHABLE = (); # registry for all attachables
		854	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
		855	our @CB_PLAYER = ();
		856	our @CB_CLIENT = ();
		857	our @CB_TYPE = (); # registry for type (cf-object class) based events
		858	our @CB_MAP = ();
		859
		860	my %attachment;
		861
		862	sub cf::attachable::thawer_merge {
		863	# simply override everything except _meta
		864	local $_[0]{_meta};
		865	%{$_[0]} = %{$_[1]};
		866	}
		867
		868	sub _attach_cb($$$$) {
		869	my ($registry, $event, $prio, $cb) = @_;
		870
		871	use sort 'stable';
		872
		873	$cb = [$prio, $cb];
		874
		875	@{$registry->[$event]} = sort
		876	{ $a->[0] cmp $b->[0] }
		877	@{$registry->[$event] || []}, $cb;
		878	}
		879
		880	# hack
		881	my %attachable_klass = map +($_ => 1), KLASS_OBJECT, KLASS_CLIENT, KLASS_PLAYER, KLASS_MAP;
		882
		883	# attach handles attaching event callbacks
		884	# the only thing the caller has to do is pass the correct
		885	# registry (== where the callback attaches to).
		886	sub _attach {
		887	my ($registry, $klass, @arg) = @_;
		888
		889	my $object_type;
		890	my $prio = 0;
		891	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
		892
		893	#TODO: get rid of this hack
		894	if ($attachable_klass{$klass}) {
		895	%cb_id = (%cb_id, map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == KLASS_ATTACHABLE, 0 .. $#EVENT);
		896	}
		897
		898	while (@arg) {
		899	my $type = shift @arg;
		900
		901	if ($type eq "prio") {
		902	$prio = shift @arg;
		903
		904	} elsif ($type eq "type") {
		905	$object_type = shift @arg;
		906	$registry = $CB_TYPE[$object_type] ||= [];
		907
		908	} elsif ($type eq "subtype") {
		909	defined $object_type or Carp::croak "subtype specified without type";
		910	my $object_subtype = shift @arg;
		911	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_TYPES] ||= [];
		912
		913	} elsif ($type eq "package") {
		914	my $pkg = shift @arg;
		915
		916	while (my ($name, $id) = each %cb_id) {
		917	if (my $cb = $pkg->can ($name)) {
		918	_attach_cb $registry, $id, $prio, $cb;
		919	}
		920	}
		921
		922	} elsif (exists $cb_id{$type}) {
		923	_attach_cb $registry, $cb_id{$type}, $prio, shift @arg;
		924
		925	} elsif (ref $type) {
		926	warn "attaching objects not supported, ignoring.\n";
		927
		928	} else {
		929	shift @arg;
		930	warn "attach argument '$type' not supported, ignoring.\n";
		931	}
		932	}
		933	}
		934
		935	sub _object_attach {
		936	my ($obj, $name, %arg) = @_;
		937
		938	return if exists $obj->{_attachment}{$name};
		939
		940	if (my $attach = $attachment{$name}) {
		941	my $registry = $obj->registry;
		942
		943	for (@$attach) {
		944	my ($klass, @attach) = @$_;
		945	_attach $registry, $klass, @attach;
		946	}
		947
		948	$obj->{$name} = \%arg;
		949	} else {
		950	warn "object uses attachment '$name' which is not available, postponing.\n";
		951	}
		952
		953	$obj->{_attachment}{$name} = undef;
		954	}
		955
		956	sub cf::attachable::attach {
		957	if (ref $_[0]) {
		958	_object_attach @_;
		959	} else {
		960	_attach shift->_attach_registry, @_;
		961	}
		962	_recalc_want;
		963	};
		964
		965	# all those should be optimised
		966	sub cf::attachable::detach {
		967	my ($obj, $name) = @_;
		968
		969	if (ref $obj) {
		970	delete $obj->{_attachment}{$name};
		971	reattach ($obj);
		972	} else {
		973	Carp::croak "cannot, currently, detach class attachments";
		974	}
		975	_recalc_want;
		976	};
		977
		978	sub cf::attachable::attached {
		979	my ($obj, $name) = @_;
		980
		981	exists $obj->{_attachment}{$name}
		982	}
		983
		984	for my $klass (qw(ATTACHABLE GLOBAL OBJECT PLAYER CLIENT MAP)) {
		985	eval "#line " . __LINE__ . " 'cf.pm'
		986	sub cf::\L$klass\E::_attach_registry {
		987	(\\\@CB_$klass, KLASS_$klass)
		988	}
		989
		990	sub cf::\L$klass\E::attachment {
		991	my \$name = shift;
		992
		993	\$attachment{\$name} = [[KLASS_$klass, \@_]];
		994	}
		995	";
		996	die if $@;
		997	}
		998
		999	our $override;
		1000	our @INVOKE_RESULTS = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
		1001
		1002	sub override {
		1003	$override = 1;
		1004	@INVOKE_RESULTS = (@_);
		1005	}
		1006
		1007	sub do_invoke {
		1008	my $event = shift;
		1009	my $callbacks = shift;
		1010
		1011	@INVOKE_RESULTS = ();
		1012
		1013	local $override;
		1014
		1015	for (@$callbacks) {
		1016	eval { &{$_->[1]} };
		1017
		1018	if ($@) {
		1019	warn "$@";
		1020	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
		1021	override;
		1022	}
		1023
		1024	return 1 if $override;
		1025	}
		1026
		1027	0
		1028	}
		1029
		1030	=item $bool = cf::global->invoke (EVENT_CLASS_XXX, ...)
		1031
		1032	=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)
		1033
		1034	Generate an object-specific event with the given arguments.
		1035
		1036	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
		1037	removed in future versions), and there is no public API to access override
		1038	results (if you must, access C<@cf::INVOKE_RESULTS> directly).
		1039
453	=back	1040	=back
454		1041
455	=cut	1042	=cut
456
457	*cf::object::valid =
458	*cf::player::valid =
459	*cf::map::valid = \&cf::_valid;
460		1043
461	#############################################################################	1044	#############################################################################
462	# object support	1045	# object support
463		1046
464	sub instantiate {	1047	sub _object_equal($$);
		1048	sub _object_equal($$) {
		1049	my ($a, $b) = @_;
		1050
		1051	return 0 unless (ref $a) eq (ref $b);
		1052
		1053	if ("HASH" eq ref $a) {
		1054	my @ka = keys %$a;
		1055	my @kb = keys %$b;
		1056
		1057	return 0 if @ka != @kb;
		1058
		1059	for (0 .. $#ka) {
		1060	return 0 unless $ka[$_] eq $kb[$_];
		1061	return 0 unless _object_equal $a->{$ka[$_]}, $b->{$kb[$_]};
		1062	}
		1063
		1064	} elsif ("ARRAY" eq ref $a) {
		1065
		1066	return 0 if @$a != @$b;
		1067
		1068	for (0 .. $#$a) {
		1069	return 0 unless _object_equal $a->[$_], $b->[$_];
		1070	}
		1071
		1072	} elsif ($a ne $b) {
		1073	return 0;
		1074	}
		1075
		1076	1
		1077	}
		1078
		1079	our $SLOW_MERGES;#d#
		1080	sub _can_merge {
465	my ($obj, $data) = @_;	1081	my ($ob1, $ob2) = @_;
466		1082
467	$data = from_json $data;	1083	++$SLOW_MERGES;#d#
468		1084
469	for (@$data) {	1085	# we do the slow way here
470	my ($name, $args) = @$_;	1086	return _object_equal $ob1, $ob2
471
472	$obj->attach ($name, %{$args || {} });
473	}
474	}	1087	}
475		1088
476	# basically do the same as instantiate, without calling instantiate
477	sub reattach {	1089	sub reattach {
		1090	# basically do the same as instantiate, without calling instantiate
478	my ($obj) = @_;	1091	my ($obj) = @_;
		1092
		1093	bless $obj, ref $obj; # re-bless in case extensions have been reloaded
		1094
479	my $registry = $obj->registry;	1095	my $registry = $obj->registry;
480		1096
481	@$registry = ();	1097	@$registry = ();
482		1098
483	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };	1099	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
484		1100
485	for my $name (keys %{ $obj->{_attachment} || {} }) {	1101	for my $name (keys %{ $obj->{_attachment} || {} }) {
486	if (my $attach = $attachment{$name}) {	1102	if (my $attach = $attachment{$name}) {
487	for (@$attach) {	1103	for (@$attach) {
488	my ($klass, @attach) = @$_;	1104	my ($klass, @attach) = @$_;
489	_attach @$registry, $klass, @attach;	1105	_attach $registry, $klass, @attach;
490	}	1106	}
491	} else {	1107	} else {
492	warn "object uses attachment '$name' that is not available, postponing.\n";	1108	warn "object uses attachment '$name' that is not available, postponing.\n";
493	}	1109	}
494	}	1110	}
495	}	1111	}
496		1112
497	sub object_freezer_save {	1113	cf::attachable->attach (
498	my ($filename, $rdata, $objs) = @_;
499
500	if (length $$rdata) {
501	warn sprintf "saving %s (%d,%d)\n",
502	$filename, length $$rdata, scalar @$objs;
503
504	if (open my $fh, ">:raw", "$filename~") {
505	chmod SAVE_MODE, $fh;
506	syswrite $fh, $$rdata;
507	close $fh;
508
509	if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
510	chmod SAVE_MODE, $fh;
511	syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
512	close $fh;
513	rename "$filename.pst~", "$filename.pst";
514	} else {
515	unlink "$filename.pst";
516	}
517
518	rename "$filename~", $filename;
519	} else {
520	warn "FATAL: $filename~: $!\n";
521	}
522	} else {
523	unlink $filename;
524	unlink "$filename.pst";
525	}
526	}
527
528	sub object_thawer_load {
529	my ($filename) = @_;
530
531	local $/;
532
533	my $av;
534
535	#TODO: use sysread etc.
536	if (open my $data, "<:raw:perlio", $filename) {
537	$data = <$data>;
538	if (open my $pst, "<:raw:perlio", "$filename.pst") {
539	$av = eval { (Storable::thaw <$pst>)->{objs} };
540	}
541	return ($data, $av);
542	}
543
544	()
545	}
546
547	attach_to_objects
548	prio => -1000000,	1114	prio => -1000000,
		1115	on_instantiate => sub {
		1116	my ($obj, $data) = @_;
		1117
		1118	$data = decode_json $data;
		1119
		1120	for (@$data) {
		1121	my ($name, $args) = @$_;
		1122
		1123	$obj->attach ($name, %{$args || {} });
		1124	}
		1125	},
		1126	on_reattach => \&reattach,
549	on_clone => sub {	1127	on_clone => sub {
550	my ($src, $dst) = @_;	1128	my ($src, $dst) = @_;
551		1129
552	@{$dst->registry} = @{$src->registry};	1130	@{$dst->registry} = @{$src->registry};
553		1131
554	%$dst = %$src;	1132	%$dst = %$src;
555		1133
556	%{$dst->{_attachment}} = %{$src->{_attachment}}	1134	%{$dst->{_attachment}} = %{$src->{_attachment}}
557	if exists $src->{_attachment};	1135	if exists $src->{_attachment};
558	},	1136	},
559	;	1137	);
		1138
		1139	sub object_freezer_save {
		1140	my ($filename, $rdata, $objs) = @_;
		1141
		1142	sync_job {
		1143	if (length $$rdata) {
		1144	utf8::decode (my $decname = $filename);
		1145	warn sprintf "saving %s (%d,%d)\n",
		1146	$decname, length $$rdata, scalar @$objs;
		1147
		1148	if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {
		1149	aio_chmod $fh, SAVE_MODE;
		1150	aio_write $fh, 0, (length $$rdata), $$rdata, 0;
		1151	aio_fsync $fh if $cf::USE_FSYNC;
		1152	aio_close $fh;
		1153
		1154	if (@$objs) {
		1155	if (my $fh = aio_open "$filename.pst~", O_WRONLY | O_CREAT, 0600) {
		1156	aio_chmod $fh, SAVE_MODE;
		1157	my $data = Coro::Storable::nfreeze { version => 1, objs => $objs };
		1158	aio_write $fh, 0, (length $data), $data, 0;
		1159	aio_fsync $fh if $cf::USE_FSYNC;
		1160	aio_close $fh;
		1161	aio_rename "$filename.pst~", "$filename.pst";
		1162	}
		1163	} else {
		1164	aio_unlink "$filename.pst";
		1165	}
		1166
		1167	aio_rename "$filename~", $filename;
		1168	} else {
		1169	warn "FATAL: $filename~: $!\n";
		1170	}
		1171	} else {
		1172	aio_unlink $filename;
		1173	aio_unlink "$filename.pst";
		1174	}
		1175	};
		1176	}
		1177
		1178	sub object_freezer_as_string {
		1179	my ($rdata, $objs) = @_;
		1180
		1181	use Data::Dumper;
		1182
		1183	$$rdata . Dumper $objs
		1184	}
		1185
		1186	sub object_thawer_load {
		1187	my ($filename) = @_;
		1188
		1189	my ($data, $av);
		1190
		1191	(aio_load $filename, $data) >= 0
		1192	or return;
		1193
		1194	unless (aio_stat "$filename.pst") {
		1195	(aio_load "$filename.pst", $av) >= 0
		1196	or return;
		1197
		1198	my $st = eval { Coro::Storable::thaw $av };
		1199	$av = $st->{objs};
		1200	}
		1201
		1202	utf8::decode (my $decname = $filename);
		1203	warn sprintf "loading %s (%d,%d)\n",
		1204	$decname, length $data, scalar @{$av || []};
		1205
		1206	($data, $av)
		1207	}
		1208
		1209	=head2 COMMAND CALLBACKS
		1210
		1211	=over 4
		1212
		1213	=cut
560		1214
561	#############################################################################	1215	#############################################################################
562	# old plug-in events	1216	# command handling &c
563		1217
564	sub inject_event {	1218	=item cf::register_command $name => \&callback($ob,$args);
565	my $extension = shift;
566	my $event_code = shift;
567		1219
568	my $cb = $hook[$event_code]{$extension}	1220	Register a callback for execution when the client sends the user command
569	or return;	1221	$name.
570		1222
571	&$cb	1223	=cut
572	}
573
574	sub inject_global_event {
575	my $event = shift;
576
577	my $cb = $hook[$event]
578	or return;
579
580	List::Util::max map &$_, values %$cb
581	}
582
583	sub inject_command {
584	my ($name, $obj, $params) = @_;
585
586	for my $cmd (@{ $command{$name} }) {
587	$cmd->[1]->($obj, $params);
588	}
589
590	-1
591	}
592		1224
593	sub register_command {	1225	sub register_command {
594	my ($name, $time, $cb) = @_;	1226	my ($name, $cb) = @_;
595		1227
596	my $caller = caller;	1228	my $caller = caller;
597	#warn "registering command '$name/$time' to '$caller'";	1229	#warn "registering command '$name/$time' to '$caller'";
598		1230
599	push @{ $command{$name} }, [$time, $cb, $caller];	1231	push @{ $COMMAND{$name} }, [$caller, $cb];
600	$COMMAND{"$name\000"} = List::Util::max map $_->[0], @{ $command{$name} };
601	}	1232	}
		1233
		1234	=item cf::register_extcmd $name => \&callback($pl,$packet);
		1235
		1236	Register a callback for execution when the client sends an (synchronous)
		1237	extcmd packet. Ext commands will be processed in the order they are
		1238	received by the server, like other user commands. The first argument is
		1239	the logged-in player. Ext commands can only be processed after a player
		1240	has logged in successfully.
		1241
		1242	If the callback returns something, it is sent back as if reply was being
		1243	called.
		1244
		1245	=item cf::register_exticmd $name => \&callback($ns,$packet);
		1246
		1247	Register a callback for execution when the client sends an (asynchronous)
		1248	exticmd packet. Exti commands are processed by the server as soon as they
		1249	are received, i.e. out of order w.r.t. other commands. The first argument
		1250	is a client socket. Exti commands can be received anytime, even before
		1251	log-in.
		1252
		1253	If the callback returns something, it is sent back as if reply was being
		1254	called.
		1255
		1256	=cut
602		1257
603	sub register_extcmd {	1258	sub register_extcmd {
604	my ($name, $cb) = @_;	1259	my ($name, $cb) = @_;
605		1260
606	my $caller = caller;	1261	$EXTCMD{$name} = $cb;
607	#warn "registering extcmd '$name' to '$caller'";
608
609	$extcmd{$name} = [$cb, $caller];
610	}	1262	}
611		1263
612	sub register {	1264	sub register_exticmd {
613	my ($base, $pkg) = @_;	1265	my ($name, $cb) = @_;
614		1266
615	#TODO	1267	$EXTICMD{$name} = $cb;
616	}	1268	}
617		1269
618	sub load_extension {	1270	cf::player->attach (
619	my ($path) = @_;	1271	on_command => sub {
		1272	my ($pl, $name, $params) = @_;
620		1273
621	$path =~ /([^\/\\]+)\.ext$/ or die "$path";	1274	my $cb = $COMMAND{$name}
622	my $base = $1;	1275	or return;
623	my $pkg = $1;
624	$pkg =~ s/[^[:word:]]/_/g;
625	$pkg = "ext::$pkg";
626		1276
627	warn "loading '$path' into '$pkg'\n";	1277	for my $cmd (@$cb) {
628		1278	$cmd->[1]->($pl->ob, $params);
629	open my $fh, "<:utf8", $path
630	or die "$path: $!";
631
632	my $source =
633	"package $pkg; use strict; use utf8;\n"
634	. "#line 1 \"$path\"\n{\n"
635	. (do { local $/; <$fh> })
636	. "\n};\n1";
637
638	eval $source
639	or die "$path: $@";
640
641	push @exts, $pkg;
642	$ext_pkg{$base} = $pkg;
643
644	# no strict 'refs';
645	# @{"$pkg\::ISA"} = ext::;
646
647	register $base, $pkg;
648	}
649
650	sub unload_extension {
651	my ($pkg) = @_;
652
653	warn "removing extension $pkg\n";
654
655	# remove hooks
656	#TODO
657	# for my $idx (0 .. $#PLUGIN_EVENT) {
658	# delete $hook[$idx]{$pkg};
659	# }
660
661	# remove commands
662	for my $name (keys %command) {
663	my @cb = grep $_->[2] ne $pkg, @{ $command{$name} };
664
665	if (@cb) {
666	$command{$name} = \@cb;
667	$COMMAND{"$name\000"} = List::Util::max map $_->[0], @cb;
668	} else {
669	delete $command{$name};
670	delete $COMMAND{"$name\000"};
671	}	1279	}
		1280
		1281	cf::override;
672	}	1282	},
673
674	# remove extcmds
675	for my $name (grep $extcmd{$_}[1] eq $pkg, keys %extcmd) {
676	delete $extcmd{$name};
677	}
678
679	if (my $cb = $pkg->can ("unload")) {
680	eval {
681	$cb->($pkg);
682	1
683	} or warn "$pkg unloaded, but with errors: $@";
684	}
685
686	Symbol::delete_package $pkg;
687	}
688
689	sub load_extensions {
690	my $LIBDIR = maps_directory "perl";
691
692	for my $ext (<$LIBDIR/*.ext>) {
693	next unless -r $ext;
694	eval {
695	load_extension $ext;
696	1
697	} or warn "$ext not loaded: $@";
698	}
699	}
700
701	#############################################################################
702	# extcmd framework, basically convert ext <msg>
703	# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
704
705	attach_to_players
706	on_extcmd => sub {	1283	on_extcmd => sub {
707	my ($pl, $buf) = @_;	1284	my ($pl, $buf) = @_;
708		1285
709	my $msg = eval { from_json $buf };	1286	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
710		1287
711	if (ref $msg) {	1288	if (ref $msg) {
		1289	my ($type, $reply, @payload) =
		1290	"ARRAY" eq ref $msg
		1291	? @$msg
		1292	: ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
		1293
		1294	my @reply;
		1295
712	if (my $cb = $extcmd{$msg->{msgtype}}) {	1296	if (my $cb = $EXTCMD{$type}) {
713	if (my %reply = $cb->[0]->($pl, $msg)) {	1297	@reply = $cb->($pl, @payload);
714	$pl->ext_reply ($msg->{msgid}, %reply);	1298	}
		1299
		1300	$pl->ext_reply ($reply, @reply)
		1301	if $reply;
		1302
		1303	} else {
		1304	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
		1305	}
		1306
		1307	cf::override;
		1308	},
		1309	);
		1310
		1311	sub load_extensions {
		1312	cf::sync_job {
		1313	my %todo;
		1314
		1315	for my $path (<$LIBDIR/*.ext>) {
		1316	next unless -r $path;
		1317
		1318	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
		1319	my $base = $1;
		1320	my $pkg = $1;
		1321	$pkg =~ s/[^[:word:]]/_/g;
		1322	$pkg = "ext::$pkg";
		1323
		1324	open my $fh, "<:utf8", $path
		1325	or die "$path: $!";
		1326
		1327	my $source = do { local $/; <$fh> };
		1328
		1329	my %ext = (
		1330	path => $path,
		1331	base => $base,
		1332	pkg => $pkg,
		1333	);
		1334
		1335	$ext{meta} = { map { (split /=/, $_, 2)[0, 1] } split /\s+/, $1 }
		1336	if $source =~ /\A#!.*?perl.*?#\s*(.*)$/m;
		1337
		1338	$ext{source} =
		1339	"package $pkg; use strict; use utf8;\n"
		1340	. "#line 1 \"$path\"\n{\n"
		1341	. $source
		1342	. "\n};\n1";
		1343
		1344	$todo{$base} = \%ext;
		1345	}
		1346
		1347	my %done;
		1348	while (%todo) {
		1349	my $progress;
		1350
		1351	while (my ($k, $v) = each %todo) {
		1352	for (split /,\s*/, $v->{meta}{depends}) {
		1353	goto skip
		1354	unless exists $done{$_};
		1355	}
		1356
		1357	warn "... loading '$k' into '$v->{pkg}'\n";
		1358
		1359	unless (eval $v->{source}) {
		1360	my $msg = $@ ? "$v->{path}: $@\n"
		1361	: "$v->{base}: extension inactive.\n";
		1362
		1363	if (exists $v->{meta}{mandatory}) {
		1364	warn $msg;
		1365	cf::cleanup "mandatory extension failed to load, exiting.";
		1366	}
		1367
		1368	warn $msg;
		1369	}
		1370
		1371	$done{$k} = delete $todo{$k};
		1372	push @EXTS, $v->{pkg};
		1373	$progress = 1;
		1374	}
		1375
		1376	skip:
		1377	die "cannot load " . (join ", ", keys %todo) . ": unable to resolve dependencies\n"
		1378	unless $progress;
		1379	}
		1380	};
		1381	}
		1382
		1383	#############################################################################
		1384
		1385	=back
		1386
		1387	=head2 CORE EXTENSIONS
		1388
		1389	Functions and methods that extend core crossfire objects.
		1390
		1391	=cut
		1392
		1393	package cf::player;
		1394
		1395	use Coro::AIO;
		1396
		1397	=head3 cf::player
		1398
		1399	=over 4
		1400
		1401	=item cf::player::num_playing
		1402
		1403	Returns the official number of playing players, as per the Crossfire metaserver rules.
		1404
		1405	=cut
		1406
		1407	sub num_playing {
		1408	scalar grep
		1409	$_->ob->map
		1410	&& !$_->hidden
		1411	&& !$_->ob->flag (cf::FLAG_WIZ),
		1412	cf::player::list
		1413	}
		1414
		1415	=item cf::player::find $login
		1416
		1417	Returns the given player object, loading it if necessary (might block).
		1418
		1419	=cut
		1420
		1421	sub playerdir($) {
		1422	"$PLAYERDIR/"
		1423	. (ref $_[0] ? $_[0]->ob->name : $_[0])
		1424	}
		1425
		1426	sub path($) {
		1427	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
		1428
		1429	(playerdir $login) . "/playerdata"
		1430	}
		1431
		1432	sub find_active($) {
		1433	$cf::PLAYER{$_[0]}
		1434	and $cf::PLAYER{$_[0]}->active
		1435	and $cf::PLAYER{$_[0]}
		1436	}
		1437
		1438	sub exists($) {
		1439	my ($login) = @_;
		1440
		1441	$cf::PLAYER{$login}
		1442	or cf::sync_job { !aio_stat path $login }
		1443	}
		1444
		1445	sub find($) {
		1446	return $cf::PLAYER{$_[0]} || do {
		1447	my $login = $_[0];
		1448
		1449	my $guard = cf::lock_acquire "user_find:$login";
		1450
		1451	$cf::PLAYER{$_[0]} || do {
		1452	# rename old playerfiles to new ones
		1453	#TODO: remove when no longer required
		1454	aio_link +(playerdir $login) . "/$login.pl.pst", (playerdir $login) . "/playerdata.pst";
		1455	aio_link +(playerdir $login) . "/$login.pl" , (playerdir $login) . "/playerdata";
		1456	aio_unlink +(playerdir $login) . "/$login.pl.pst";
		1457	aio_unlink +(playerdir $login) . "/$login.pl";
		1458
		1459	my $f = new_from_file cf::object::thawer path $login
		1460	or return;
		1461
		1462	my $pl = cf::player::load_pl $f
		1463	or return;
		1464
		1465	local $cf::PLAYER_LOADING{$login} = $pl;
		1466	$f->resolve_delayed_derefs;
		1467	$cf::PLAYER{$login} = $pl
		1468	}
		1469	}
		1470	}
		1471
		1472	sub save($) {
		1473	my ($pl) = @_;
		1474
		1475	return if $pl->{deny_save};
		1476
		1477	my $path = path $pl;
		1478	my $guard = cf::lock_acquire "user_save:$path";
		1479
		1480	return if $pl->{deny_save};
		1481
		1482	aio_mkdir playerdir $pl, 0770;
		1483	$pl->{last_save} = $cf::RUNTIME;
		1484
		1485	cf::get_slot 0.01;
		1486
		1487	$pl->save_pl ($path);
		1488	cf::cede_to_tick;
		1489	}
		1490
		1491	sub new($) {
		1492	my ($login) = @_;
		1493
		1494	my $self = create;
		1495
		1496	$self->ob->name ($login);
		1497	$self->{deny_save} = 1;
		1498
		1499	$cf::PLAYER{$login} = $self;
		1500
		1501	$self
		1502	}
		1503
		1504	=item $player->send_msg ($channel, $msg, $color, [extra...])
		1505
		1506	=cut
		1507
		1508	sub send_msg {
		1509	my $ns = shift->ns
		1510	or return;
		1511	$ns->send_msg (@_);
		1512	}
		1513
		1514	=item $pl->quit_character
		1515
		1516	Nukes the player without looking back. If logged in, the connection will
		1517	be destroyed. May block for a long time.
		1518
		1519	=cut
		1520
		1521	sub quit_character {
		1522	my ($pl) = @_;
		1523
		1524	my $name = $pl->ob->name;
		1525
		1526	$pl->{deny_save} = 1;
		1527	$pl->password ("*"); # this should lock out the player until we nuked the dir
		1528
		1529	$pl->invoke (cf::EVENT_PLAYER_LOGOUT, 1) if $pl->active;
		1530	$pl->deactivate;
		1531	my $killer = cf::arch::get "killer_quit"; $pl->killer ($killer); $killer->destroy;
		1532	$pl->ob->check_score;
		1533	$pl->invoke (cf::EVENT_PLAYER_QUIT);
		1534	$pl->ns->destroy if $pl->ns;
		1535
		1536	my $path = playerdir $pl;
		1537	my $temp = "$path~$cf::RUNTIME~deleting~";
		1538	aio_rename $path, $temp;
		1539	delete $cf::PLAYER{$pl->ob->name};
		1540	$pl->destroy;
		1541
		1542	my $prefix = qr<^~\Q$name\E/>;
		1543
		1544	# nuke player maps
		1545	$cf::MAP{$_}->nuke for grep /$prefix/, keys %cf::MAP;
		1546
		1547	IO::AIO::aio_rmtree $temp;
		1548	}
		1549
		1550	=item $pl->kick
		1551
		1552	Kicks a player out of the game. This destroys the connection.
		1553
		1554	=cut
		1555
		1556	sub kick {
		1557	my ($pl, $kicker) = @_;
		1558
		1559	$pl->invoke (cf::EVENT_PLAYER_KICK, $kicker);
		1560	$pl->killer ("kicked");
		1561	$pl->ns->destroy;
		1562	}
		1563
		1564	=item cf::player::list_logins
		1565
		1566	Returns am arrayref of all valid playernames in the system, can take a
		1567	while and may block, so not sync_job-capable, ever.
		1568
		1569	=cut
		1570
		1571	sub list_logins {
		1572	my $dirs = aio_readdir $PLAYERDIR
		1573	or return [];
		1574
		1575	my @logins;
		1576
		1577	for my $login (@$dirs) {
		1578	my $path = path $login;
		1579
		1580	# a .pst is a dead give-away for a valid player
		1581	# if no pst file found, open and chekc for blocked users
		1582	if (aio_stat "$path.pst") {
		1583	my $fh = aio_open $path, Fcntl::O_RDONLY, 0 or next;
		1584	aio_read $fh, 0, 512, my $buf, 0 or next;
		1585	$buf !~ /^password -------------$/m or next; # official not-valid tag
		1586	}
		1587
		1588	utf8::decode $login;
		1589	push @logins, $login;
		1590	}
		1591
		1592	\@logins
		1593	}
		1594
		1595	=item $player->maps
		1596
		1597	Returns an arrayref of map paths that are private for this
		1598	player. May block.
		1599
		1600	=cut
		1601
		1602	sub maps($) {
		1603	my ($pl) = @_;
		1604
		1605	$pl = ref $pl ? $pl->ob->name : $pl;
		1606
		1607	my $files = aio_readdir playerdir $pl
		1608	or return;
		1609
		1610	my @paths;
		1611
		1612	for (@$files) {
		1613	utf8::decode $_;
		1614	next if /\.(?:pl|pst)$/;
		1615	next unless /^$PATH_SEP/o;
		1616
		1617	push @paths, cf::map::normalise "~$pl/$_";
		1618	}
		1619
		1620	\@paths
		1621	}
		1622
		1623	=item $protocol_xml = $player->expand_cfpod ($crossfire_pod)
		1624
		1625	Expand crossfire pod fragments into protocol xml.
		1626
		1627	=cut
		1628
		1629	use re 'eval';
		1630
		1631	my $group;
		1632	my $interior; $interior = qr{
		1633	# match a pod interior sequence sans C<< >>
		1634	(?:
		1635	\ (.*?)\ (?{ $group = $^N })
		1636	| < (??{$interior}) >
		1637	)
		1638	}x;
		1639
		1640	sub expand_cfpod {
		1641	my ($self, $pod) = @_;
		1642
		1643	my $xml;
		1644
		1645	while () {
		1646	if ($pod =~ /\G( (?: [^BCGHITU]+ | .(?!<) )+ )/xgcs) {
		1647	$group = $1;
		1648
		1649	$group =~ s/&/&amp;/g;
		1650	$group =~ s/</&lt;/g;
		1651
		1652	$xml .= $group;
		1653	} elsif ($pod =~ m%\G
		1654	([BCGHITU])
		1655	<
		1656	(?:
		1657	([^<>]*) (?{ $group = $^N })
		1658	| < $interior >
		1659	)
		1660	>
		1661	%gcsx
		1662	) {
		1663	my ($code, $data) = ($1, $group);
		1664
		1665	if ($code eq "B") {
		1666	$xml .= "<b>" . expand_cfpod ($self, $data) . "</b>";
		1667	} elsif ($code eq "I") {
		1668	$xml .= "<i>" . expand_cfpod ($self, $data) . "</i>";
		1669	} elsif ($code eq "U") {
		1670	$xml .= "<u>" . expand_cfpod ($self, $data) . "</u>";
		1671	} elsif ($code eq "C") {
		1672	$xml .= "<tt>" . expand_cfpod ($self, $data) . "</tt>";
		1673	} elsif ($code eq "T") {
		1674	$xml .= "<big><b>" . expand_cfpod ($self, $data) . "</b></big>";
		1675	} elsif ($code eq "G") {
		1676	my ($male, $female) = split /\|/, $data;
		1677	$data = $self->gender ? $female : $male;
		1678	$xml .= expand_cfpod ($self, $data);
		1679	} elsif ($code eq "H") {
		1680	$xml .= ("<fg name=\"lightblue\">[" . expand_cfpod ($self, $data) . " (Use hintmode to suppress hints)]</fg>",
		1681	"<fg name=\"lightblue\">[Hint suppressed, see hintmode]</fg>",
		1682	"")
		1683	[$self->{hintmode}];
		1684	} else {
		1685	$xml .= "error processing '$code($data)' directive";
		1686	}
		1687	} else {
		1688	if ($pod =~ /\G(.+)/) {
		1689	warn "parse error while expanding $pod (at $1)";
		1690	}
		1691	last;
		1692	}
		1693	}
		1694
		1695	for ($xml) {
		1696	# create single paragraphs (very hackish)
		1697	s/(?<=\S)\n(?=\w)/ /g;
		1698
		1699	# compress some whitespace
		1700	s/\s+\n/\n/g; # ws line-ends
		1701	s/\n\n+/\n/g; # double lines
		1702	s/^\n+//; # beginning lines
		1703	s/\n+$//; # ending lines
		1704	}
		1705
		1706	$xml
		1707	}
		1708
		1709	no re 'eval';
		1710
		1711	sub hintmode {
		1712	$_[0]{hintmode} = $_[1] if @_ > 1;
		1713	$_[0]{hintmode}
		1714	}
		1715
		1716	=item $player->ext_reply ($msgid, @msg)
		1717
		1718	Sends an ext reply to the player.
		1719
		1720	=cut
		1721
		1722	sub ext_reply($$@) {
		1723	my ($self, $id, @msg) = @_;
		1724
		1725	$self->ns->ext_reply ($id, @msg)
		1726	}
		1727
		1728	=item $player->ext_msg ($type, @msg)
		1729
		1730	Sends an ext event to the client.
		1731
		1732	=cut
		1733
		1734	sub ext_msg($$@) {
		1735	my ($self, $type, @msg) = @_;
		1736
		1737	$self->ns->ext_msg ($type, @msg);
		1738	}
		1739
		1740	=head3 cf::region
		1741
		1742	=over 4
		1743
		1744	=cut
		1745
		1746	package cf::region;
		1747
		1748	=item cf::region::find_by_path $path
		1749
		1750	Tries to decuce the likely region for a map knowing only its path.
		1751
		1752	=cut
		1753
		1754	sub find_by_path($) {
		1755	my ($path) = @_;
		1756
		1757	my ($match, $specificity);
		1758
		1759	for my $region (list) {
		1760	if ($region->{match} && $path =~ $region->{match}) {
		1761	($match, $specificity) = ($region, $region->specificity)
		1762	if $region->specificity > $specificity;
		1763	}
		1764	}
		1765
		1766	$match
		1767	}
		1768
		1769	=back
		1770
		1771	=head3 cf::map
		1772
		1773	=over 4
		1774
		1775	=cut
		1776
		1777	package cf::map;
		1778
		1779	use Fcntl;
		1780	use Coro::AIO;
		1781
		1782	use overload
		1783	'""' => \&as_string,
		1784	fallback => 1;
		1785
		1786	our $MAX_RESET = 3600;
		1787	our $DEFAULT_RESET = 3000;
		1788
		1789	sub generate_random_map {
		1790	my ($self, $rmp) = @_;
		1791
		1792	my $lock = cf::lock_acquire "generate_random_map"; # the random map generator is NOT reentrant ATM
		1793
		1794	# mit "rum" bekleckern, nicht
		1795	$self->_create_random_map (
		1796	$rmp->{wallstyle}, $rmp->{wall_name}, $rmp->{floorstyle}, $rmp->{monsterstyle},
		1797	$rmp->{treasurestyle}, $rmp->{layoutstyle}, $rmp->{doorstyle}, $rmp->{decorstyle},
		1798	$rmp->{origin_map}, $rmp->{final_map}, $rmp->{exitstyle}, $rmp->{this_map},
		1799	$rmp->{exit_on_final_map},
		1800	$rmp->{xsize}, $rmp->{ysize},
		1801	$rmp->{expand2x}, $rmp->{layoutoptions1}, $rmp->{layoutoptions2}, $rmp->{layoutoptions3},
		1802	$rmp->{symmetry}, $rmp->{difficulty}, $rmp->{difficulty_given}, $rmp->{difficulty_increase},
		1803	$rmp->{dungeon_level}, $rmp->{dungeon_depth}, $rmp->{decoroptions}, $rmp->{orientation},
		1804	$rmp->{origin_y}, $rmp->{origin_x}, $rmp->{random_seed}, $rmp->{total_map_hp},
		1805	$rmp->{map_layout_style}, $rmp->{treasureoptions}, $rmp->{symmetry_used},
		1806	(cf::region::find $rmp->{region}), $rmp->{custom}
		1807	)
		1808	}
		1809
		1810	=item cf::map->register ($regex, $prio)
		1811
		1812	Register a handler for the map path matching the given regex at the
		1813	givne priority (higher is better, built-in handlers have priority 0, the
		1814	default).
		1815
		1816	=cut
		1817
		1818	sub register {
		1819	my (undef, $regex, $prio) = @_;
		1820	my $pkg = caller;
		1821
		1822	no strict;
		1823	push @{"$pkg\::ISA"}, __PACKAGE__;
		1824
		1825	$EXT_MAP{$pkg} = [$prio, qr<$regex>];
		1826	}
		1827
		1828	# also paths starting with '/'
		1829	$EXT_MAP{"cf::map"} = [0, qr{^(?=/)}];
		1830
		1831	sub thawer_merge {
		1832	my ($self, $merge) = @_;
		1833
		1834	# we have to keep some variables in memory intact
		1835	local $self->{path};
		1836	local $self->{load_path};
		1837
		1838	$self->SUPER::thawer_merge ($merge);
		1839	}
		1840
		1841	sub normalise {
		1842	my ($path, $base) = @_;
		1843
		1844	$path = "$path"; # make sure its a string
		1845
		1846	$path =~ s/\.map$//;
		1847
		1848	# map plan:
		1849	#
		1850	# /! non-realised random map exit (special hack!)
		1851	# {... are special paths that are not being touched
		1852	# ?xxx/... are special absolute paths
		1853	# ?random/... random maps
		1854	# /... normal maps
		1855	# ~user/... per-player map of a specific user
		1856
		1857	$path =~ s/$PATH_SEP/\//go;
		1858
		1859	# treat it as relative path if it starts with
		1860	# something that looks reasonable
		1861	if ($path =~ m{^(?:\./|\.\./|\w)}) {
		1862	$base or Carp::carp "normalise called with relative path and no base: '$path'";
		1863
		1864	$base =~ s{[^/]+/?$}{};
		1865	$path = "$base/$path";
		1866	}
		1867
		1868	for ($path) {
		1869	redo if s{//}{/};
		1870	redo if s{/\.?/}{/};
		1871	redo if s{/[^/]+/\.\./}{/};
		1872	}
		1873
		1874	$path
		1875	}
		1876
		1877	sub new_from_path {
		1878	my (undef, $path, $base) = @_;
		1879
		1880	return $path if UNIVERSAL::isa $path, "cf::map"; # already a map object
		1881
		1882	$path = normalise $path, $base;
		1883
		1884	for my $pkg (sort { $EXT_MAP{$b}[0] <=> $EXT_MAP{$a}[0] } keys %EXT_MAP) {
		1885	if ($path =~ $EXT_MAP{$pkg}[1]) {
		1886	my $self = bless cf::map::new, $pkg;
		1887	$self->{path} = $path; $self->path ($path);
		1888	$self->init; # pass $1 etc.
		1889	return $self;
		1890	}
		1891	}
		1892
		1893	Carp::cluck "unable to resolve path '$path' (base '$base').";
		1894	()
		1895	}
		1896
		1897	sub init {
		1898	my ($self) = @_;
		1899
		1900	$self
		1901	}
		1902
		1903	sub as_string {
		1904	my ($self) = @_;
		1905
		1906	"$self->{path}"
		1907	}
		1908
		1909	# the displayed name, this is a one way mapping
		1910	sub visible_name {
		1911	&as_string
		1912	}
		1913
		1914	# the original (read-only) location
		1915	sub load_path {
		1916	my ($self) = @_;
		1917
		1918	"$MAPDIR/$self->{path}.map"
		1919	}
		1920
		1921	# the temporary/swap location
		1922	sub save_path {
		1923	my ($self) = @_;
		1924
		1925	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/go;
		1926	"$TMPDIR/$path.map"
		1927	}
		1928
		1929	# the unique path, undef == no special unique path
		1930	sub uniq_path {
		1931	my ($self) = @_;
		1932
		1933	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/go;
		1934	"$UNIQUEDIR/$path"
		1935	}
		1936
		1937	# and all this just because we cannot iterate over
		1938	# all maps in C++...
		1939	sub change_all_map_light {
		1940	my ($change) = @_;
		1941
		1942	$_->change_map_light ($change)
		1943	for grep $_->outdoor, values %cf::MAP;
		1944	}
		1945
		1946	sub decay_objects {
		1947	my ($self) = @_;
		1948
		1949	return if $self->{deny_reset};
		1950
		1951	$self->do_decay_objects;
		1952	}
		1953
		1954	sub unlink_save {
		1955	my ($self) = @_;
		1956
		1957	utf8::encode (my $save = $self->save_path);
		1958	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
		1959	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink "$save.pst";
		1960	}
		1961
		1962	sub load_header_from($) {
		1963	my ($self, $path) = @_;
		1964
		1965	utf8::encode $path;
		1966	my $f = new_from_file cf::object::thawer $path
		1967	or return;
		1968
		1969	$self->_load_header ($f)
		1970	or return;
		1971
		1972	local $MAP_LOADING{$self->{path}} = $self;
		1973	$f->resolve_delayed_derefs;
		1974
		1975	$self->{load_path} = $path;
		1976
		1977	1
		1978	}
		1979
		1980	sub load_header_orig {
		1981	my ($self) = @_;
		1982
		1983	$self->load_header_from ($self->load_path)
		1984	}
		1985
		1986	sub load_header_temp {
		1987	my ($self) = @_;
		1988
		1989	$self->load_header_from ($self->save_path)
		1990	}
		1991
		1992	sub prepare_temp {
		1993	my ($self) = @_;
		1994
		1995	$self->last_access ((delete $self->{last_access})
		1996	|| $cf::RUNTIME); #d#
		1997	# safety
		1998	$self->{instantiate_time} = $cf::RUNTIME
		1999	if $self->{instantiate_time} > $cf::RUNTIME;
		2000	}
		2001
		2002	sub prepare_orig {
		2003	my ($self) = @_;
		2004
		2005	$self->{load_original} = 1;
		2006	$self->{instantiate_time} = $cf::RUNTIME;
		2007	$self->last_access ($cf::RUNTIME);
		2008	$self->instantiate;
		2009	}
		2010
		2011	sub load_header {
		2012	my ($self) = @_;
		2013
		2014	if ($self->load_header_temp) {
		2015	$self->prepare_temp;
		2016	} else {
		2017	$self->load_header_orig
		2018	or return;
		2019	$self->prepare_orig;
		2020	}
		2021
		2022	$self->{deny_reset} = 1
		2023	if $self->no_reset;
		2024
		2025	$self->default_region (cf::region::find_by_path $self->{path})
		2026	unless $self->default_region;
		2027
		2028	1
		2029	}
		2030
		2031	sub find;
		2032	sub find {
		2033	my ($path, $origin) = @_;
		2034
		2035	$path = normalise $path, $origin && $origin->path;
		2036
		2037	cf::lock_wait "map_data:$path";#d#remove
		2038	cf::lock_wait "map_find:$path";
		2039
		2040	$cf::MAP{$path} || do {
		2041	my $guard1 = cf::lock_acquire "map_data:$path"; # just for the fun of it
		2042	my $guard2 = cf::lock_acquire "map_find:$path";
		2043
		2044	my $map = new_from_path cf::map $path
		2045	or return;
		2046
		2047	$map->{last_save} = $cf::RUNTIME;
		2048
		2049	$map->load_header
		2050	or return;
		2051
		2052	if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
		2053	# doing this can freeze the server in a sync job, obviously
		2054	#$cf::WAIT_FOR_TICK->wait;
		2055	undef $guard2;
		2056	undef $guard1;
		2057	$map->reset;
		2058	return find $path;
		2059	}
		2060
		2061	$cf::MAP{$path} = $map
		2062	}
		2063	}
		2064
		2065	sub pre_load { }
		2066	sub post_load { }
		2067
		2068	sub load {
		2069	my ($self) = @_;
		2070
		2071	local $self->{deny_reset} = 1; # loading can take a long time
		2072
		2073	my $path = $self->{path};
		2074
		2075	{
		2076	my $guard = cf::lock_acquire "map_data:$path";
		2077
		2078	return unless $self->valid;
		2079	return unless $self->in_memory == cf::MAP_SWAPPED;
		2080
		2081	$self->in_memory (cf::MAP_LOADING);
		2082
		2083	$self->alloc;
		2084
		2085	$self->pre_load;
		2086	cf::cede_to_tick;
		2087
		2088	my $f = new_from_file cf::object::thawer $self->{load_path};
		2089	$f->skip_block;
		2090	$self->_load_objects ($f)
		2091	or return;
		2092
		2093	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
		2094	if delete $self->{load_original};
		2095
		2096	if (my $uniq = $self->uniq_path) {
		2097	utf8::encode $uniq;
		2098	unless (aio_stat $uniq) {
		2099	if (my $f = new_from_file cf::object::thawer $uniq) {
		2100	$self->clear_unique_items;
		2101	$self->_load_objects ($f);
		2102	$f->resolve_delayed_derefs;
715	}	2103	}
716	}	2104	}
717	} else {
718	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
719	}	2105	}
720		2106
721	cf::override;	2107	$f->resolve_delayed_derefs;
		2108
		2109	cf::cede_to_tick;
		2110	# now do the right thing for maps
		2111	$self->link_multipart_objects;
		2112	$self->difficulty ($self->estimate_difficulty)
		2113	unless $self->difficulty;
		2114	cf::cede_to_tick;
		2115
		2116	unless ($self->{deny_activate}) {
		2117	$self->decay_objects;
		2118	$self->fix_auto_apply;
		2119	$self->update_buttons;
		2120	cf::cede_to_tick;
		2121	$self->set_darkness_map;
		2122	cf::cede_to_tick;
		2123	$self->activate;
		2124	}
		2125
		2126	$self->{last_save} = $cf::RUNTIME;
		2127	$self->last_access ($cf::RUNTIME);
		2128
		2129	$self->in_memory (cf::MAP_ACTIVE);
722	},	2130	}
723	;
724		2131
725	#############################################################################	2132	$self->post_load;
726	# load/save/clean perl data associated with a map	2133	}
727		2134
728	*cf::mapsupport::on_clean = sub {	2135	sub customise_for {
		2136	my ($self, $ob) = @_;
		2137
		2138	return find "~" . $ob->name . "/" . $self->{path}
		2139	if $self->per_player;
		2140
		2141	# return find "?party/" . $ob->name . "/" . $self->{path}
		2142	# if $self->per_party;
		2143
		2144	$self
		2145	}
		2146
		2147	# find and load all maps in the 3x3 area around a map
		2148	sub load_neighbours {
729	my ($map) = @_;	2149	my ($map) = @_;
730		2150
731	my $path = $map->tmpname;	2151	my @neigh; # diagonal neighbours
732	defined $path or return;
733		2152
734	unlink "$path.pst";	2153	for (0 .. 3) {
735	};	2154	my $neigh = $map->tile_path ($_)
		2155	or next;
		2156	$neigh = find $neigh, $map
		2157	or next;
		2158	$neigh->load;
736		2159
737	attach_to_maps prio => -10000, package => cf::mapsupport::;	2160	push @neigh,
		2161	[$neigh->tile_path (($_ + 3) % 4), $neigh],
		2162	[$neigh->tile_path (($_ + 1) % 4), $neigh];
		2163	}
738		2164
739	#############################################################################	2165	for (grep defined $_->[0], @neigh) {
740	# load/save perl data associated with player->ob objects	2166	my ($path, $origin) = @$_;
741		2167	my $neigh = find $path, $origin
742	sub all_objects(@) {	2168	or next;
743	@_, map all_objects ($_->inv), @_	2169	$neigh->load;
		2170	}
744	}	2171	}
745		2172
746	# TODO: compatibility cruft, remove when no longer needed	2173	sub find_sync {
747	attach_to_players	2174	my ($path, $origin) = @_;
748	on_load => sub {
749	my ($pl, $path) = @_;
750		2175
751	for my $o (all_objects $pl->ob) {	2176	cf::sync_job { find $path, $origin }
752	if (my $value = $o->get_ob_key_value ("_perl_data")) {	2177	}
753	$o->set_ob_key_value ("_perl_data");
754		2178
755	%$o = %{ Storable::thaw pack "H*", $value };	2179	sub do_load_sync {
		2180	my ($map) = @_;
		2181
		2182	cf::LOG cf::llevDebug | cf::logBacktrace, "do_load_sync"
		2183	if $Coro::current == $Coro::main;
		2184
		2185	cf::sync_job { $map->load };
		2186	}
		2187
		2188	our %MAP_PREFETCH;
		2189	our $MAP_PREFETCHER = undef;
		2190
		2191	sub find_async {
		2192	my ($path, $origin, $load) = @_;
		2193
		2194	$path = normalise $path, $origin && $origin->{path};
		2195
		2196	if (my $map = $cf::MAP{$path}) {
		2197	return $map if !$load || $map->in_memory == cf::MAP_ACTIVE;
		2198	}
		2199
		2200	$MAP_PREFETCH{$path} |= $load;
		2201
		2202	$MAP_PREFETCHER ||= cf::async {
		2203	$Coro::current->{desc} = "map prefetcher";
		2204
		2205	while (%MAP_PREFETCH) {
		2206	while (my ($k, $v) = each %MAP_PREFETCH) {
		2207	if (my $map = find $k) {
		2208	$map->load if $v;
		2209	}
		2210
		2211	delete $MAP_PREFETCH{$k};
756	}	2212	}
757	}	2213	}
		2214	undef $MAP_PREFETCHER;
		2215	};
		2216	$MAP_PREFETCHER->prio (6);
		2217
		2218	()
		2219	}
		2220
		2221	sub save {
		2222	my ($self) = @_;
		2223
		2224	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2225
		2226	$self->{last_save} = $cf::RUNTIME;
		2227
		2228	return unless $self->dirty;
		2229
		2230	my $save = $self->save_path; utf8::encode $save;
		2231	my $uniq = $self->uniq_path; utf8::encode $uniq;
		2232
		2233	$self->{load_path} = $save;
		2234
		2235	return if $self->{deny_save};
		2236
		2237	local $self->{last_access} = $self->last_access;#d#
		2238
		2239	cf::async {
		2240	$Coro::current->{desc} = "map player save";
		2241	$_->contr->save for $self->players;
		2242	};
		2243
		2244	cf::get_slot 0.02;
		2245
		2246	if ($uniq) {
		2247	$self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
		2248	$self->_save_objects ($uniq, cf::IO_UNIQUES);
		2249	} else {
		2250	$self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
758	},	2251	}
759	;	2252	}
760		2253
761	#############################################################################	2254	sub swap_out {
		2255	my ($self) = @_;
762		2256
763	=head2 CORE EXTENSIONS	2257	# save first because save cedes
		2258	$self->save;
764		2259
765	Functions and methods that extend core crossfire objects.	2260	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2261
		2262	return if $self->players;
		2263	return if $self->in_memory != cf::MAP_ACTIVE;
		2264	return if $self->{deny_save};
		2265
		2266	$self->in_memory (cf::MAP_SWAPPED);
		2267
		2268	$self->deactivate;
		2269	$_->clear_links_to ($self) for values %cf::MAP;
		2270	$self->clear;
		2271	}
		2272
		2273	sub reset_at {
		2274	my ($self) = @_;
		2275
		2276	# TODO: safety, remove and allow resettable per-player maps
		2277	return 1e99 if $self->{deny_reset};
		2278
		2279	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
		2280	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
		2281
		2282	$time + $to
		2283	}
		2284
		2285	sub should_reset {
		2286	my ($self) = @_;
		2287
		2288	$self->reset_at <= $cf::RUNTIME
		2289	}
		2290
		2291	sub reset {
		2292	my ($self) = @_;
		2293
		2294	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2295
		2296	return if $self->players;
		2297
		2298	warn "resetting map ", $self->path;
		2299
		2300	$self->in_memory (cf::MAP_SWAPPED);
		2301
		2302	# need to save uniques path
		2303	unless ($self->{deny_save}) {
		2304	my $uniq = $self->uniq_path; utf8::encode $uniq;
		2305
		2306	$self->_save_objects ($uniq, cf::IO_UNIQUES)
		2307	if $uniq;
		2308	}
		2309
		2310	delete $cf::MAP{$self->path};
		2311
		2312	$self->deactivate;
		2313	$_->clear_links_to ($self) for values %cf::MAP;
		2314	$self->clear;
		2315
		2316	$self->unlink_save;
		2317	$self->destroy;
		2318	}
		2319
		2320	my $nuke_counter = "aaaa";
		2321
		2322	sub nuke {
		2323	my ($self) = @_;
		2324
		2325	{
		2326	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2327
		2328	delete $cf::MAP{$self->path};
		2329
		2330	$self->unlink_save;
		2331
		2332	bless $self, "cf::map";
		2333	delete $self->{deny_reset};
		2334	$self->{deny_save} = 1;
		2335	$self->reset_timeout (1);
		2336	$self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));
		2337
		2338	$cf::MAP{$self->path} = $self;
		2339	}
		2340
		2341	$self->reset; # polite request, might not happen
		2342	}
		2343
		2344	=item $maps = cf::map::tmp_maps
		2345
		2346	Returns an arrayref with all map paths of currently instantiated and saved
		2347	maps. May block.
		2348
		2349	=cut
		2350
		2351	sub tmp_maps() {
		2352	[
		2353	map {
		2354	utf8::decode $_;
		2355	/\.map$/
		2356	? normalise $_
		2357	: ()
		2358	} @{ aio_readdir $TMPDIR or [] }
		2359	]
		2360	}
		2361
		2362	=item $maps = cf::map::random_maps
		2363
		2364	Returns an arrayref with all map paths of currently instantiated and saved
		2365	random maps. May block.
		2366
		2367	=cut
		2368
		2369	sub random_maps() {
		2370	[
		2371	map {
		2372	utf8::decode $_;
		2373	/\.map$/
		2374	? normalise "?random/$_"
		2375	: ()
		2376	} @{ aio_readdir $RANDOMDIR or [] }
		2377	]
		2378	}
		2379
		2380	=item cf::map::unique_maps
		2381
		2382	Returns an arrayref of paths of all shared maps that have
		2383	instantiated unique items. May block.
		2384
		2385	=cut
		2386
		2387	sub unique_maps() {
		2388	[
		2389	map {
		2390	utf8::decode $_;
		2391	s/\.map$//; # TODO future compatibility hack
		2392	/\.pst$/ || !/^$PATH_SEP/o # TODO unique maps apparebntly lack the .map suffix :/
		2393	? ()
		2394	: normalise $_
		2395	} @{ aio_readdir $UNIQUEDIR or [] }
		2396	]
		2397	}
		2398
		2399	=back
		2400
		2401	=head3 cf::object
		2402
		2403	=cut
		2404
		2405	package cf::object;
766		2406
767	=over 4	2407	=over 4
768		2408
769	=item cf::player::exists $login	2409	=item $ob->inv_recursive
770		2410
771	Returns true when the given account exists.	2411	Returns the inventory of the object I<and> their inventories, recursively,
		2412	but I<not> the object itself.
772		2413
773	=cut	2414	=cut
774		2415
775	sub cf::player::exists($) {	2416	sub inv_recursive_;
776	cf::player::find $_[0]	2417	sub inv_recursive_ {
777	or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;	2418	map { $_, inv_recursive_ $_->inv } @_
778	}	2419	}
779		2420
		2421	sub inv_recursive {
		2422	inv_recursive_ inv $_[0]
		2423	}
		2424
		2425	=item $ref = $ob->ref
		2426
		2427	Creates and returns a persistent reference to an object that can be stored as a string.
		2428
		2429	=item $ob = cf::object::deref ($refstring)
		2430
		2431	returns the objetc referenced by refstring. may return undef when it cnanot find the object,
		2432	even if the object actually exists. May block.
		2433
		2434	=cut
		2435
		2436	sub deref {
		2437	my ($ref) = @_;
		2438
		2439	if ($ref =~ m{^player\/(<1\.[0-9a-f]+>)/(.*)$}) {
		2440	my ($uuid, $name) = ($1, $2);
		2441	my $pl = $cf::PLAYER_LOADING{$name} || cf::player::find $name
		2442	or return;
		2443	$pl->ob->uuid eq $uuid
		2444	or return;
		2445
		2446	$pl->ob
		2447	} else {
		2448	warn "$ref: cannot resolve object reference\n";
		2449	undef
		2450	}
		2451	}
		2452
		2453	package cf;
		2454
		2455	=back
		2456
		2457	=head3 cf::object::player
		2458
		2459	=over 4
		2460
780	=item $object->reply ($npc, $msg[, $flags])	2461	=item $player_object->reply ($npc, $msg[, $flags])
781		2462
782	Sends a message to the player, as if the npc C<$npc> replied. C<$npc>	2463	Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
783	can be C<undef>. Does the right thing when the player is currently in a	2464	can be C<undef>. Does the right thing when the player is currently in a
784	dialogue with the given NPC character.	2465	dialogue with the given NPC character.
785		2466
786	=cut	2467	=cut
787		2468
		2469	our $SAY_CHANNEL = {
		2470	id => "say",
		2471	title => "Map",
		2472	reply => "say ",
		2473	tooltip => "Things said to and replied from npcs near you and other players on the same map only.",
		2474	};
		2475
		2476	our $CHAT_CHANNEL = {
		2477	id => "chat",
		2478	title => "Chat",
		2479	reply => "chat ",
		2480	tooltip => "Player chat and shouts, global to the server.",
		2481	};
		2482
788	# rough implementation of a future "reply" method that works	2483	# rough implementation of a future "reply" method that works
789	# with dialog boxes.	2484	# with dialog boxes.
		2485	#TODO: the first argument must go, split into a $npc->reply_to ( method
790	sub cf::object::player::reply($$$;$) {	2486	sub cf::object::player::reply($$$;$) {
791	my ($self, $npc, $msg, $flags) = @_;	2487	my ($self, $npc, $msg, $flags) = @_;
792		2488
793	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	2489	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
794		2490
795	if ($self->{record_replies}) {	2491	if ($self->{record_replies}) {
796	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2492	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2493
797	} else {	2494	} else {
		2495	my $pl = $self->contr;
		2496
		2497	if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
		2498	my $dialog = $pl->{npc_dialog};
		2499	$dialog->{pl}->ext_msg ($dialog->{id}, update => msg => $dialog->{pl}->expand_cfpod ($msg));
		2500
		2501	} else {
798	$msg = $npc->name . " says: $msg" if $npc;	2502	$msg = $npc->name . " says: $msg" if $npc;
799	$self->message ($msg, $flags);	2503	$self->send_msg ($SAY_CHANNEL => $msg, $flags);
		2504	}
		2505	}
		2506	}
		2507
		2508	=item $object->send_msg ($channel, $msg, $color, [extra...])
		2509
		2510	=cut
		2511
		2512	sub cf::object::send_msg {
		2513	my $pl = shift->contr
		2514	or return;
		2515	$pl->send_msg (@_);
		2516	}
		2517
		2518	=item $player_object->may ("access")
		2519
		2520	Returns wether the given player is authorized to access resource "access"
		2521	(e.g. "command_wizcast").
		2522
		2523	=cut
		2524
		2525	sub cf::object::player::may {
		2526	my ($self, $access) = @_;
		2527
		2528	$self->flag (cf::FLAG_WIZ) ||
		2529	(ref $cf::CFG{"may_$access"}
		2530	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
		2531	: $cf::CFG{"may_$access"})
		2532	}
		2533
		2534	=item $player_object->enter_link
		2535
		2536	Freezes the player and moves him/her to a special map (C<{link}>).
		2537
		2538	The player should be reasonably safe there for short amounts of time. You
		2539	I<MUST> call C<leave_link> as soon as possible, though.
		2540
		2541	Will never block.
		2542
		2543	=item $player_object->leave_link ($map, $x, $y)
		2544
		2545	Moves the player out of the special C<{link}> map onto the specified
		2546	map. If the map is not valid (or omitted), the player will be moved back
		2547	to the location he/she was before the call to C<enter_link>, or, if that
		2548	fails, to the emergency map position.
		2549
		2550	Might block.
		2551
		2552	=cut
		2553
		2554	sub link_map {
		2555	unless ($LINK_MAP) {
		2556	$LINK_MAP = cf::map::find "{link}"
		2557	or cf::cleanup "FATAL: unable to provide {link} map, exiting.";
		2558	$LINK_MAP->load;
		2559	}
		2560
		2561	$LINK_MAP
		2562	}
		2563
		2564	sub cf::object::player::enter_link {
		2565	my ($self) = @_;
		2566
		2567	$self->deactivate_recursive;
		2568
		2569	return if UNIVERSAL::isa $self->map, "ext::map_link";
		2570
		2571	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
		2572	if $self->map && $self->map->{path} ne "{link}";
		2573
		2574	$self->enter_map ($LINK_MAP || link_map, 10, 10);
		2575	}
		2576
		2577	sub cf::object::player::leave_link {
		2578	my ($self, $map, $x, $y) = @_;
		2579
		2580	return unless $self->contr->active;
		2581
		2582	my $link_pos = delete $self->{_link_pos};
		2583
		2584	unless ($map) {
		2585	# restore original map position
		2586	($map, $x, $y) = @{ $link_pos || [] };
		2587	$map = cf::map::find $map;
		2588
		2589	unless ($map) {
		2590	($map, $x, $y) = @$EMERGENCY_POSITION;
		2591	$map = cf::map::find $map
		2592	or die "FATAL: cannot load emergency map\n";
		2593	}
		2594	}
		2595
		2596	($x, $y) = (-1, -1)
		2597	unless (defined $x) && (defined $y);
		2598
		2599	# use -1 or undef as default coordinates, not 0, 0
		2600	($x, $y) = ($map->enter_x, $map->enter_y)
		2601	if $x <=0 && $y <= 0;
		2602
		2603	$map->load;
		2604	$map->load_neighbours;
		2605
		2606	return unless $self->contr->active;
		2607	$self->activate_recursive;
		2608
		2609	local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
		2610	$self->enter_map ($map, $x, $y);
		2611	}
		2612
		2613	=item $player_object->goto ($path, $x, $y[, $check->($map)[, $done->()]])
		2614
		2615	Moves the player to the given map-path and coordinates by first freezing
		2616	her, loading and preparing them map, calling the provided $check callback
		2617	that has to return the map if sucecssful, and then unfreezes the player on
		2618	the new (success) or old (failed) map position. In either case, $done will
		2619	be called at the end of this process.
		2620
		2621	=cut
		2622
		2623	our $GOTOGEN;
		2624
		2625	sub cf::object::player::goto {
		2626	my ($self, $path, $x, $y, $check, $done) = @_;
		2627
		2628	# do generation counting so two concurrent goto's will be executed in-order
		2629	my $gen = $self->{_goto_generation} = ++$GOTOGEN;
		2630
		2631	$self->enter_link;
		2632
		2633	(async {
		2634	$Coro::current->{desc} = "player::goto $path $x $y";
		2635
		2636	# *tag paths override both path and x|y
		2637	if ($path =~ /^\*(.*)$/) {
		2638	if (my @obs = grep $_->map, ext::map_tags::find $1) {
		2639	my $ob = $obs[rand @obs];
		2640
		2641	# see if we actually can go there
		2642	if (@obs = grep !$self->blocked ($_->map, $_->x, $_->y), $ob, $ob->tail) {
		2643	$ob = $obs[rand @obs];
		2644	} else {
		2645	$self->message ("Wow, it's pretty crowded in there.", cf::NDI_UNIQUE | cf::NDI_RED);
		2646	}
		2647	# else put us there anyways for now #d#
		2648
		2649	($path, $x, $y) = ($ob->map, $ob->x, $ob->y);
		2650	} else {
		2651	($path, $x, $y) = (undef, undef, undef);
		2652	}
		2653	}
		2654
		2655	my $map = eval {
		2656	my $map = defined $path ? cf::map::find $path : undef;
		2657
		2658	if ($map) {
		2659	$map = $map->customise_for ($self);
		2660	$map = $check->($map) if $check && $map;
		2661	} else {
		2662	$self->message ("The exit to '$path' is closed.", cf::NDI_UNIQUE | cf::NDI_RED);
		2663	}
		2664
		2665	$map
		2666	};
		2667
		2668	if ($@) {
		2669	$self->message ("Something went wrong within the server, please report this incident!", cf::NDI_UNIQUE | cf::NDI_RED);
		2670	LOG llevError | logBacktrace, Carp::longmess $@;
		2671	}
		2672
		2673	if ($gen == $self->{_goto_generation}) {
		2674	delete $self->{_goto_generation};
		2675	$self->leave_link ($map, $x, $y);
		2676	}
		2677
		2678	$done->() if $done;
		2679	})->prio (1);
		2680	}
		2681
		2682	=item $player_object->enter_exit ($exit_object)
		2683
		2684	=cut
		2685
		2686	sub parse_random_map_params {
		2687	my ($spec) = @_;
		2688
		2689	my $rmp = { # defaults
		2690	xsize => (cf::rndm 15, 40),
		2691	ysize => (cf::rndm 15, 40),
		2692	symmetry => (cf::rndm 1, cf::SYMMETRY_XY),
		2693	#layout => string,
800	}	2694	};
801	}
802		2695
		2696	for (split /\n/, $spec) {
		2697	my ($k, $v) = split /\s+/, $_, 2;
		2698
		2699	$rmp->{lc $k} = $v if (length $k) && (length $v);
		2700	}
		2701
		2702	$rmp
		2703	}
		2704
		2705	sub prepare_random_map {
		2706	my ($exit) = @_;
		2707
		2708	# all this does is basically replace the /! path by
		2709	# a new random map path (?random/...) with a seed
		2710	# that depends on the exit object
		2711
		2712	my $rmp = parse_random_map_params $exit->msg;
		2713
		2714	if ($exit->map) {
		2715	$rmp->{region} = $exit->region->name;
		2716	$rmp->{origin_map} = $exit->map->path;
		2717	$rmp->{origin_x} = $exit->x;
		2718	$rmp->{origin_y} = $exit->y;
		2719
		2720	$exit->map->touch;
		2721	}
		2722
		2723	$rmp->{random_seed} ||= $exit->random_seed;
		2724
		2725	my $data = JSON::XS->new->utf8->pretty->canonical->encode ($rmp);
		2726	my $md5 = Digest::MD5::md5_hex $data;
		2727	my $meta = "$RANDOMDIR/$md5.meta";
		2728
		2729	if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {
		2730	aio_write $fh, 0, (length $data), $data, 0;
		2731	undef $fh;
		2732	aio_rename "$meta~", $meta;
		2733
		2734	my $slaying = "?random/$md5";
		2735
		2736	if ($exit->valid) {
		2737	$exit->slaying ("?random/$md5");
		2738	$exit->msg (undef);
		2739	}
		2740	}
		2741	}
		2742
		2743	sub cf::object::player::enter_exit {
		2744	my ($self, $exit) = @_;
		2745
		2746	return unless $self->type == cf::PLAYER;
		2747
		2748	$self->enter_link;
		2749
		2750	(async {
		2751	$Coro::current->{desc} = "enter_exit";
		2752
		2753	unless (eval {
		2754	$self->deactivate_recursive; # just to be sure
		2755
		2756	# random map handling
		2757	{
		2758	my $guard = cf::lock_acquire "exit_prepare:$exit";
		2759
		2760	prepare_random_map $exit
		2761	if $exit->slaying eq "/!";
		2762	}
		2763
		2764	my $map = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;
		2765	my $x = $exit->stats->hp;
		2766	my $y = $exit->stats->sp;
		2767
		2768	$self->goto ($map, $x, $y);
		2769
		2770	# if exit is damned, update players death & WoR home-position
		2771	$self->contr->savebed ($map, $x, $y)
		2772	if $exit->flag (cf::FLAG_DAMNED);
		2773
		2774	1
		2775	}) {
		2776	$self->message ("Something went wrong deep within the crossfire server. "
		2777	. "I'll try to bring you back to the map you were before. "
		2778	. "Please report this to the dungeon master!",
		2779	cf::NDI_UNIQUE | cf::NDI_RED);
		2780
		2781	warn "ERROR in enter_exit: $@";
		2782	$self->leave_link;
		2783	}
		2784	})->prio (1);
		2785	}
		2786
		2787	=head3 cf::client
		2788
		2789	=over 4
		2790
		2791	=item $client->send_drawinfo ($text, $flags)
		2792
		2793	Sends a drawinfo packet to the client. Circumvents output buffering so
		2794	should not be used under normal circumstances.
		2795
		2796	=cut
		2797
		2798	sub cf::client::send_drawinfo {
		2799	my ($self, $text, $flags) = @_;
		2800
		2801	utf8::encode $text;
		2802	$self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);
		2803	}
		2804
		2805	=item $client->send_msg ($channel, $msg, $color, [extra...])
		2806
		2807	Send a drawinfo or msg packet to the client, formatting the msg for the
		2808	client if neccessary. C<$type> should be a string identifying the type of
		2809	the message, with C<log> being the default. If C<$color> is negative, suppress
		2810	the message unless the client supports the msg packet.
		2811
		2812	=cut
		2813
		2814	# non-persistent channels (usually the info channel)
		2815	our %CHANNEL = (
		2816	"c/identify" => {
		2817	id => "infobox",
		2818	title => "Identify",
		2819	reply => undef,
		2820	tooltip => "Items recently identified",
		2821	},
		2822	"c/examine" => {
		2823	id => "infobox",
		2824	title => "Examine",
		2825	reply => undef,
		2826	tooltip => "Signs and other items you examined",
		2827	},
		2828	"c/book" => {
		2829	id => "infobox",
		2830	title => "Book",
		2831	reply => undef,
		2832	tooltip => "The contents of a note or book",
		2833	},
		2834	"c/lookat" => {
		2835	id => "infobox",
		2836	title => "Look",
		2837	reply => undef,
		2838	tooltip => "What you saw there",
		2839	},
		2840	"c/who" => {
		2841	id => "infobox",
		2842	title => "Players",
		2843	reply => undef,
		2844	tooltip => "Shows players who are currently online",
		2845	},
		2846	"c/body" => {
		2847	id => "infobox",
		2848	title => "Body Parts",
		2849	reply => undef,
		2850	tooltip => "Shows which body parts you posess and are available",
		2851	},
		2852	"c/uptime" => {
		2853	id => "infobox",
		2854	title => "Uptime",
		2855	reply => undef,
		2856	tooltip => "How long the server has been running since last restart",
		2857	},
		2858	"c/mapinfo" => {
		2859	id => "infobox",
		2860	title => "Map Info",
		2861	reply => undef,
		2862	tooltip => "Information related to the maps",
		2863	},
		2864	"c/party" => {
		2865	id => "party",
		2866	title => "Party",
		2867	reply => "gsay ",
		2868	tooltip => "Messages and chat related to your party",
		2869	},
		2870	);
		2871
		2872	sub cf::client::send_msg {
		2873	my ($self, $channel, $msg, $color, @extra) = @_;
		2874
		2875	$msg = $self->pl->expand_cfpod ($msg);
		2876
		2877	$color &= cf::NDI_CLIENT_MASK; # just in case...
		2878
		2879	# check predefined channels, for the benefit of C
		2880	if ($CHANNEL{$channel}) {
		2881	$channel = $CHANNEL{$channel};
		2882
		2883	$self->ext_msg (channel_info => $channel)
		2884	if $self->can_msg;
		2885
		2886	$channel = $channel->{id};
		2887
		2888	} elsif (ref $channel) {
		2889	# send meta info to client, if not yet sent
		2890	unless (exists $self->{channel}{$channel->{id}}) {
		2891	$self->{channel}{$channel->{id}} = $channel;
		2892	$self->ext_msg (channel_info => $channel)
		2893	if $self->can_msg;
		2894	}
		2895
		2896	$channel = $channel->{id};
		2897	}
		2898
		2899	return unless @extra || length $msg;
		2900
		2901	if ($self->can_msg) {
		2902	# default colour, mask it out
		2903	$color &= ~(cf::NDI_COLOR_MASK | cf::NDI_DEF)
		2904	if $color & cf::NDI_DEF;
		2905
		2906	$self->send_packet ("msg " . $self->{json_coder}->encode (
		2907	[$color & cf::NDI_CLIENT_MASK, $channel, $msg, @extra]));
		2908	} else {
		2909	if ($color >= 0) {
		2910	# replace some tags by gcfclient-compatible ones
		2911	for ($msg) {
		2912	1 while
		2913	s/<b>([^<]*)<\/b>/[b]${1}[\/b]/
		2914	|| s/<i>([^<]*)<\/i>/[i]${1}[\/i]/
		2915	|| s/<u>([^<]*)<\/u>/[ul]${1}[\/ul]/
		2916	|| s/<tt>([^<]*)<\/tt>/[fixed]${1}[\/fixed]/
		2917	|| s/<fg name=\"([^"]+)\">([^<]*)<\/fg>/[color=$1]${2}[\/color]/;
		2918	}
		2919
		2920	$color &= cf::NDI_COLOR_MASK;
		2921
		2922	utf8::encode $msg;
		2923
		2924	if (0 && $msg =~ /\[/) {
		2925	# COMMAND/INFO
		2926	$self->send_packet ("drawextinfo $color 10 8 $msg")
		2927	} else {
		2928	$msg =~ s/\[\/?(?:b|i|u|fixed|color)[^\]]*\]//g;
		2929	$self->send_packet ("drawinfo $color $msg")
		2930	}
		2931	}
		2932	}
		2933	}
		2934
		2935	=item $client->ext_msg ($type, @msg)
		2936
		2937	Sends an ext event to the client.
		2938
		2939	=cut
		2940
		2941	sub cf::client::ext_msg($$@) {
		2942	my ($self, $type, @msg) = @_;
		2943
		2944	if ($self->extcmd == 2) {
		2945	$self->send_packet ("ext " . $self->{json_coder}->encode ([$type, @msg]));
		2946	} elsif ($self->extcmd == 1) { # TODO: remove
		2947	push @msg, msgtype => "event_$type";
		2948	$self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
		2949	}
		2950	}
		2951
803	=item $player->ext_reply ($msgid, $msgtype, %msg)	2952	=item $client->ext_reply ($msgid, @msg)
804		2953
805	Sends an ext reply to the player.	2954	Sends an ext reply to the client.
806		2955
807	=cut	2956	=cut
808		2957
809	sub cf::player::ext_reply($$$%) {	2958	sub cf::client::ext_reply($$@) {
810	my ($self, $id, %msg) = @_;	2959	my ($self, $id, @msg) = @_;
811		2960
812	$msg{msgid} = $id;	2961	if ($self->extcmd == 2) {
813		2962	$self->send_packet ("ext " . $self->{json_coder}->encode (["reply-$id", @msg]));
814	$self->send ("ext " . to_json \%msg);	2963	} elsif ($self->extcmd == 1) {
		2964	#TODO: version 1, remove
		2965	unshift @msg, msgtype => "reply", msgid => $id;
		2966	$self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
		2967	}
815	}	2968	}
		2969
		2970	=item $success = $client->query ($flags, "text", \&cb)
		2971
		2972	Queues a query to the client, calling the given callback with
		2973	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
		2974	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
		2975
		2976	Queries can fail, so check the return code. Or don't, as queries will
		2977	become reliable at some point in the future.
		2978
		2979	=cut
		2980
		2981	sub cf::client::query {
		2982	my ($self, $flags, $text, $cb) = @_;
		2983
		2984	return unless $self->state == ST_PLAYING
		2985	|| $self->state == ST_SETUP
		2986	|| $self->state == ST_CUSTOM;
		2987
		2988	$self->state (ST_CUSTOM);
		2989
		2990	utf8::encode $text;
		2991	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
		2992
		2993	$self->send_packet ($self->{query_queue}[0][0])
		2994	if @{ $self->{query_queue} } == 1;
		2995
		2996	1
		2997	}
		2998
		2999	cf::client->attach (
		3000	on_connect => sub {
		3001	my ($ns) = @_;
		3002
		3003	$ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
		3004	},
		3005	on_reply => sub {
		3006	my ($ns, $msg) = @_;
		3007
		3008	# this weird shuffling is so that direct followup queries
		3009	# get handled first
		3010	my $queue = delete $ns->{query_queue}
		3011	or return; # be conservative, not sure how that can happen, but we saw a crash here
		3012
		3013	(shift @$queue)->[1]->($msg);
		3014	return unless $ns->valid; # temporary(?) workaround for callback destroying socket
		3015
		3016	push @{ $ns->{query_queue} }, @$queue;
		3017
		3018	if (@{ $ns->{query_queue} } == @$queue) {
		3019	if (@$queue) {
		3020	$ns->send_packet ($ns->{query_queue}[0][0]);
		3021	} else {
		3022	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
		3023	}
		3024	}
		3025	},
		3026	on_exticmd => sub {
		3027	my ($ns, $buf) = @_;
		3028
		3029	my $msg = eval { $ns->{json_coder}->decode ($buf) };
		3030
		3031	if (ref $msg) {
		3032	my ($type, $reply, @payload) =
		3033	"ARRAY" eq ref $msg
		3034	? @$msg
		3035	: ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
		3036
		3037	my @reply;
		3038
		3039	if (my $cb = $EXTICMD{$type}) {
		3040	@reply = $cb->($ns, @payload);
		3041	}
		3042
		3043	$ns->ext_reply ($reply, @reply)
		3044	if $reply;
		3045
		3046	} else {
		3047	warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
		3048	}
		3049
		3050	cf::override;
		3051	},
		3052	);
		3053
		3054	=item $client->async (\&cb)
		3055
		3056	Create a new coroutine, running the specified callback. The coroutine will
		3057	be automatically cancelled when the client gets destroyed (e.g. on logout,
		3058	or loss of connection).
		3059
		3060	=cut
		3061
		3062	sub cf::client::async {
		3063	my ($self, $cb) = @_;
		3064
		3065	my $coro = &Coro::async ($cb);
		3066
		3067	$coro->on_destroy (sub {
		3068	delete $self->{_coro}{$coro+0};
		3069	});
		3070
		3071	$self->{_coro}{$coro+0} = $coro;
		3072
		3073	$coro
		3074	}
		3075
		3076	cf::client->attach (
		3077	on_destroy => sub {
		3078	my ($ns) = @_;
		3079
		3080	$_->cancel for values %{ (delete $ns->{_coro}) || {} };
		3081	},
		3082	);
816		3083
817	=back	3084	=back
818		3085
819	=cut
820
821	#############################################################################
822		3086
823	=head2 SAFE SCRIPTING	3087	=head2 SAFE SCRIPTING
824		3088
825	Functions that provide a safe environment to compile and execute	3089	Functions that provide a safe environment to compile and execute
826	snippets of perl code without them endangering the safety of the server	3090	snippets of perl code without them endangering the safety of the server
827	itself. Looping constructs, I/O operators and other built-in functionality	3091	itself. Looping constructs, I/O operators and other built-in functionality
828	is not available in the safe scripting environment, and the number of	3092	is not available in the safe scripting environment, and the number of
829	functions and methods that cna be called is greatly reduced.	3093	functions and methods that can be called is greatly reduced.
830		3094
831	=cut	3095	=cut
832		3096
833	our $safe = new Safe "safe";	3097	our $safe = new Safe "safe";
834	our $safe_hole = new Safe::Hole;	3098	our $safe_hole = new Safe::Hole;
835		3099
836	$SIG{FPE} = 'IGNORE';	3100	$SIG{FPE} = 'IGNORE';
837		3101
838	$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));	3102	$safe->permit_only (Opcode::opset qw(
		3103	:base_core :base_mem :base_orig :base_math
		3104	grepstart grepwhile mapstart mapwhile
		3105	sort time
		3106	));
839		3107
840	# here we export the classes and methods available to script code	3108	# here we export the classes and methods available to script code
841		3109
842	=pod	3110	=pod
843		3111
844	The following fucntions and emthods are available within a safe environment:	3112	The following functions and methods are available within a safe environment:
845		3113
846	cf::object contr pay_amount pay_player	3114	cf::object
		3115	contr pay_amount pay_player map x y force_find force_add destroy
		3116	insert remove name archname title slaying race decrease split
		3117
847	cf::object::player player	3118	cf::object::player
848	cf::player peaceful	3119	player
		3120
		3121	cf::player
		3122	peaceful
		3123
		3124	cf::map
		3125	trigger
849		3126
850	=cut	3127	=cut
851		3128
852	for (	3129	for (
853	["cf::object" => qw(contr pay_amount pay_player)],	3130	["cf::object" => qw(contr pay_amount pay_player map force_find force_add x y
		3131	insert remove inv nrof name archname title slaying race
		3132	decrease split destroy)],
854	["cf::object::player" => qw(player)],	3133	["cf::object::player" => qw(player)],
855	["cf::player" => qw(peaceful)],	3134	["cf::player" => qw(peaceful)],
		3135	["cf::map" => qw(trigger)],
856	) {	3136	) {
857	no strict 'refs';	3137	no strict 'refs';
858	my ($pkg, @funs) = @$_;	3138	my ($pkg, @funs) = @$_;
859	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})	3139	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
860	for @funs;	3140	for @funs;
…		…
928	=back	3208	=back
929		3209
930	=cut	3210	=cut
931		3211
932	#############################################################################	3212	#############################################################################
		3213	# the server's init and main functions
933		3214
934	=head2 EXTENSION DATABASE SUPPORT	3215	sub load_facedata($) {
		3216	my ($path) = @_;
935		3217
936	Crossfire maintains a very simple database for extension use. It can	3218	# HACK to clear player env face cache, we need some signal framework
937	currently store anything that can be serialised using Storable, which	3219	# for this (global event?)
938	excludes objects.	3220	%ext::player_env::MUSIC_FACE_CACHE = ();
939		3221
940	The parameter C<$family> should best start with the name of the extension	3222	my $enc = JSON::XS->new->utf8->canonical->relaxed;
941	using it, it should be unique.
942		3223
943	=over 4	3224	warn "loading facedata from $path\n";
944		3225
945	=item $hashref = cf::db_get $family	3226	my $facedata;
		3227	0 < aio_load $path, $facedata
		3228	or die "$path: $!";
946		3229
947	Return a hashref for use by the extension C<$family>, which can be	3230	$facedata = Coro::Storable::thaw $facedata;
948	modified. After modifications, you have to call C<cf::db_dirty> or
949	C<cf::db_sync>.
950		3231
951	=item $value = cf::db_get $family => $key	3232	$facedata->{version} == 2
		3233	or cf::cleanup "$path: version mismatch, cannot proceed.";
952		3234
953	Returns a single value from the database	3235	# patch in the exptable
954		3236	$facedata->{resource}{"res/exp_table"} = {
955	=item cf::db_put $family => $hashref	3237	type => FT_RSRC,
956		3238	data => $enc->encode ([map cf::level_to_min_exp $_, 1 .. cf::settings->max_level]),
957	Stores the given family hashref into the database. Updates are delayed, if
958	you want the data to be synced to disk immediately, use C<cf::db_sync>.
959
960	=item cf::db_put $family => $key => $value
961
962	Stores the given C<$value> in the family hash. Updates are delayed, if you
963	want the data to be synced to disk immediately, use C<cf::db_sync>.
964
965	=item cf::db_dirty
966
967	Marks the database as dirty, to be updated at a later time.
968
969	=item cf::db_sync
970
971	Immediately write the database to disk I<if it is dirty>.
972
973	=cut
974
975	our $DB;
976
977	{
978	my $path = cf::localdir . "/database.pst";
979
980	sub db_load() {
981	warn "loading database $path\n";#d# remove later
982	$DB = stat $path ? Storable::retrieve $path : { };
983	}
984
985	my $pid;
986
987	sub db_save() {
988	warn "saving database $path\n";#d# remove later
989	waitpid $pid, 0 if $pid;
990	if (0 == ($pid = fork)) {
991	$DB->{_meta}{version} = 1;
992	Storable::nstore $DB, "$path~";
993	rename "$path~", $path;
994	cf::_exit 0 if defined $pid;
995	}
996	}
997
998	my $dirty;
999
1000	sub db_sync() {
1001	db_save if $dirty;
1002	undef $dirty;
1003	}
1004
1005	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, cb => sub {
1006	db_sync;
1007	});	3239	};
		3240	cf::cede_to_tick;
1008		3241
1009	sub db_dirty() {
1010	$dirty = 1;
1011	$idle->start;
1012	}	3242	{
		3243	my $faces = $facedata->{faceinfo};
1013		3244
1014	sub db_get($;$) {	3245	while (my ($face, $info) = each %$faces) {
1015	@_ >= 2	3246	my $idx = (cf::face::find $face) || cf::face::alloc $face;
1016	? $DB->{$_[0]}{$_[1]}
1017	: ($DB->{$_[0]} ||= { })
1018	}
1019		3247
1020	sub db_put($$;$) {	3248	cf::face::set_visibility $idx, $info->{visibility};
1021	if (@_ >= 3) {	3249	cf::face::set_magicmap $idx, $info->{magicmap};
1022	$DB->{$_[0]}{$_[1]} = $_[2];	3250	cf::face::set_data $idx, 0, $info->{data32}, Digest::MD5::md5 $info->{data32};
1023	} else {	3251	cf::face::set_data $idx, 1, $info->{data64}, Digest::MD5::md5 $info->{data64};
1024	$DB->{$_[0]} = $_[1];
1025	}
1026	db_dirty;
1027	}
1028		3252
1029	attach_global	3253	cf::cede_to_tick;
1030	prio => 10000,
1031	on_cleanup => sub {
1032	db_sync;
1033	},	3254	}
		3255
		3256	while (my ($face, $info) = each %$faces) {
		3257	next unless $info->{smooth};
		3258
		3259	my $idx = cf::face::find $face
		3260	or next;
		3261
		3262	if (my $smooth = cf::face::find $info->{smooth}) {
		3263	cf::face::set_smooth $idx, $smooth;
		3264	cf::face::set_smoothlevel $idx, $info->{smoothlevel};
		3265	} else {
		3266	warn "smooth face '$info->{smooth}' not found for face '$face'";
		3267	}
		3268
		3269	cf::cede_to_tick;
		3270	}
		3271	}
		3272
		3273	{
		3274	my $anims = $facedata->{animinfo};
		3275
		3276	while (my ($anim, $info) = each %$anims) {
		3277	cf::anim::set $anim, $info->{frames}, $info->{facings};
		3278	cf::cede_to_tick;
		3279	}
		3280
		3281	cf::anim::invalidate_all; # d'oh
		3282	}
		3283
		3284	{
		3285	# TODO: for gcfclient pleasure, we should give resources
		3286	# that gcfclient doesn't grok a >10000 face index.
		3287	my $res = $facedata->{resource};
		3288
		3289	while (my ($name, $info) = each %$res) {
		3290	if (defined $info->{type}) {
		3291	my $idx = (cf::face::find $name) || cf::face::alloc $name;
		3292	my $data;
		3293
		3294	if ($info->{type} & 1) {
		3295	# prepend meta info
		3296
		3297	my $meta = $enc->encode ({
		3298	name => $name,
		3299	%{ $info->{meta} || {} },
		3300	});
		3301
		3302	$data = pack "(w/a*)*", $meta, $info->{data};
		3303	} else {
		3304	$data = $info->{data};
		3305	}
		3306
		3307	cf::face::set_data $idx, 0, $data, Digest::MD5::md5 $data;
		3308	cf::face::set_type $idx, $info->{type};
		3309	} else {
		3310	$RESOURCE{$name} = $info;
		3311	}
		3312
		3313	cf::cede_to_tick;
		3314	}
		3315	}
		3316
		3317	cf::global->invoke (EVENT_GLOBAL_RESOURCE_UPDATE);
		3318
		3319	1
		3320	}
		3321
		3322	cf::global->attach (on_resource_update => sub {
		3323	if (my $soundconf = $RESOURCE{"res/sound.conf"}) {
		3324	$soundconf = JSON::XS->new->utf8->relaxed->decode ($soundconf->{data});
		3325
		3326	for (0 .. SOUND_CAST_SPELL_0 - 1) {
		3327	my $sound = $soundconf->{compat}[$_]
		3328	or next;
		3329
		3330	my $face = cf::face::find "sound/$sound->[1]";
		3331	cf::sound::set $sound->[0] => $face;
		3332	cf::sound::old_sound_index $_, $face; # gcfclient-compat
		3333	}
		3334
		3335	while (my ($k, $v) = each %{$soundconf->{event}}) {
		3336	my $face = cf::face::find "sound/$v";
		3337	cf::sound::set $k => $face;
		3338	}
		3339	}
		3340	});
		3341
		3342	register_exticmd fx_want => sub {
		3343	my ($ns, $want) = @_;
		3344
		3345	while (my ($k, $v) = each %$want) {
		3346	$ns->fx_want ($k, $v);
		3347	}
		3348	};
		3349
		3350	sub load_resource_file($) {
		3351	my $guard = lock_acquire "load_resource_file";
		3352
		3353	my $status = load_resource_file_ $_[0];
		3354	get_slot 0.1, 100;
		3355	cf::arch::commit_load;
		3356
		3357	$status
		3358	}
		3359
		3360	sub reload_regions {
		3361	# HACK to clear player env face cache, we need some signal framework
		3362	# for this (global event?)
		3363	%ext::player_env::MUSIC_FACE_CACHE = ();
		3364
		3365	load_resource_file "$MAPDIR/regions"
		3366	or die "unable to load regions file\n";
		3367
		3368	for (cf::region::list) {
		3369	$_->{match} = qr/$_->{match}/
		3370	if exists $_->{match};
		3371	}
		3372	}
		3373
		3374	sub reload_facedata {
		3375	load_facedata "$DATADIR/facedata"
		3376	or die "unable to load facedata\n";
		3377	}
		3378
		3379	sub reload_archetypes {
		3380	load_resource_file "$DATADIR/archetypes"
		3381	or die "unable to load archetypes\n";
		3382	}
		3383
		3384	sub reload_treasures {
		3385	load_resource_file "$DATADIR/treasures"
		3386	or die "unable to load treasurelists\n";
		3387	}
		3388
		3389	sub reload_resources {
		3390	warn "reloading resource files...\n";
		3391
		3392	reload_facedata;
		3393	reload_archetypes;
		3394	reload_regions;
		3395	reload_treasures;
		3396
		3397	warn "finished reloading resource files\n";
		3398	}
		3399
		3400	sub init {
		3401	my $guard = freeze_mainloop;
		3402
		3403	reload_resources;
		3404	}
		3405
		3406	sub reload_config {
		3407	open my $fh, "<:utf8", "$CONFDIR/config"
		3408	or return;
		3409
		3410	local $/;
		3411	*CFG = YAML::Load <$fh>;
		3412
		3413	$EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_105_115", 5, 37];
		3414
		3415	$cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
		3416	$cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
		3417
		3418	if (exists $CFG{mlockall}) {
		3419	eval {
		3420	$CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
		3421	and die "WARNING: m(un)lockall failed: $!\n";
		3422	};
		3423	warn $@ if $@;
		3424	}
		3425	}
		3426
		3427	sub main {
		3428	# we must not ever block the main coroutine
		3429	local $Coro::idle = sub {
		3430	Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
		3431	(async {
		3432	$Coro::current->{desc} = "IDLE BUG HANDLER";
		3433	EV::loop EV::LOOP_ONESHOT;
		3434	})->prio (Coro::PRIO_MAX);
1034	;	3435	};
		3436
		3437	{
		3438	my $guard = freeze_mainloop;
		3439	reload_config;
		3440	db_init;
		3441	load_extensions;
		3442
		3443	$Coro::current->prio (Coro::PRIO_MAX); # give the main loop max. priority
		3444	}
		3445
		3446	EV::loop;
1035	}	3447	}
1036		3448
1037	#############################################################################	3449	#############################################################################
1038	# the server's main()	3450	# initialisation and cleanup
1039		3451
1040	sub cfg_load {	3452	# install some emergency cleanup handlers
1041	open my $fh, "<:utf8", cf::confdir . "/config"	3453	BEGIN {
		3454	our %SIGWATCHER = ();
		3455	for my $signal (qw(INT HUP TERM)) {
		3456	$SIGWATCHER{$signal} = EV::signal $signal, sub {
		3457	cf::cleanup "SIG$signal";
		3458	};
		3459	}
		3460	}
		3461
		3462	sub write_runtime_sync {
		3463	my $runtime = "$LOCALDIR/runtime";
		3464
		3465	# first touch the runtime file to show we are still running:
		3466	# the fsync below can take a very very long time.
		3467
		3468	IO::AIO::aio_utime $runtime, undef, undef;
		3469
		3470	my $guard = cf::lock_acquire "write_runtime";
		3471
		3472	my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
1042	or return;	3473	or return;
1043		3474
1044	local $/;	3475	my $value = $cf::RUNTIME + 90 + 10;
1045	*CFG = YAML::Syck::Load <$fh>;	3476	# 10 is the runtime save interval, for a monotonic clock
1046	}	3477	# 60 allows for the watchdog to kill the server.
1047		3478
1048	sub main {	3479	(aio_write $fh, 0, (length $value), $value, 0) <= 0
1049	cfg_load;	3480	and return;
1050	db_load;
1051	load_extensions;
1052	Event::loop;
1053	}
1054		3481
1055	#############################################################################	3482	# always fsync - this file is important
1056	# initialisation	3483	aio_fsync $fh
		3484	and return;
1057		3485
1058	sub _perl_reload(&) {	3486	# touch it again to show we are up-to-date
		3487	aio_utime $fh, undef, undef;
		3488
		3489	close $fh
		3490	or return;
		3491
		3492	aio_rename "$runtime~", $runtime
		3493	and return;
		3494
		3495	warn "runtime file written.\n";
		3496
		3497	1
		3498	}
		3499
		3500	our $uuid_lock;
		3501	our $uuid_skip;
		3502
		3503	sub write_uuid_sync($) {
		3504	$uuid_skip ||= $_[0];
		3505
		3506	return if $uuid_lock;
		3507	local $uuid_lock = 1;
		3508
		3509	my $uuid = "$LOCALDIR/uuid";
		3510
		3511	my $fh = aio_open "$uuid~", O_WRONLY | O_CREAT, 0644
		3512	or return;
		3513
		3514	my $value = uuid_str $uuid_skip + uuid_seq uuid_cur;
		3515	$uuid_skip = 0;
		3516
		3517	(aio_write $fh, 0, (length $value), $value, 0) <= 0
		3518	and return;
		3519
		3520	# always fsync - this file is important
		3521	aio_fsync $fh
		3522	and return;
		3523
		3524	close $fh
		3525	or return;
		3526
		3527	aio_rename "$uuid~", $uuid
		3528	and return;
		3529
		3530	warn "uuid file written ($value).\n";
		3531
		3532	1
		3533
		3534	}
		3535
		3536	sub write_uuid($$) {
		3537	my ($skip, $sync) = @_;
		3538
		3539	$sync ? write_uuid_sync $skip
		3540	: async { write_uuid_sync $skip };
		3541	}
		3542
		3543	sub emergency_save() {
		3544	my $freeze_guard = cf::freeze_mainloop;
		3545
		3546	warn "enter emergency perl save\n";
		3547
		3548	cf::sync_job {
		3549	# use a peculiar iteration method to avoid tripping on perl
		3550	# refcount bugs in for. also avoids problems with players
		3551	# and maps saved/destroyed asynchronously.
		3552	warn "begin emergency player save\n";
		3553	for my $login (keys %cf::PLAYER) {
		3554	my $pl = $cf::PLAYER{$login} or next;
		3555	$pl->valid or next;
		3556	delete $pl->{unclean_save}; # not strictly necessary, but cannot hurt
		3557	$pl->save;
		3558	}
		3559	warn "end emergency player save\n";
		3560
		3561	warn "begin emergency map save\n";
		3562	for my $path (keys %cf::MAP) {
		3563	my $map = $cf::MAP{$path} or next;
		3564	$map->valid or next;
		3565	$map->save;
		3566	}
		3567	warn "end emergency map save\n";
		3568
		3569	warn "begin emergency database checkpoint\n";
		3570	BDB::db_env_txn_checkpoint $DB_ENV;
		3571	warn "end emergency database checkpoint\n";
		3572
		3573	warn "begin write uuid\n";
		3574	write_uuid_sync 1;
		3575	warn "end write uuid\n";
		3576	};
		3577
		3578	warn "leave emergency perl save\n";
		3579	}
		3580
		3581	sub post_cleanup {
1059	my ($msg) = @_;	3582	my ($make_core) = @_;
1060		3583
1061	$msg->("reloading...");	3584	warn Carp::longmess "post_cleanup backtrace"
		3585	if $make_core;
		3586	}
1062		3587
1063	eval {	3588	sub do_reload_perl() {
1064	# cancel all watchers	3589	# can/must only be called in main
1065	$_->cancel for Event::all_watchers;	3590	if ($Coro::current != $Coro::main) {
		3591	warn "can only reload from main coroutine";
		3592	return;
		3593	}
1066		3594
1067	# unload all extensions	3595	warn "reloading...";
		3596
		3597	warn "entering sync_job";
		3598
		3599	cf::sync_job {
		3600	cf::write_runtime_sync; # external watchdog should not bark
		3601	cf::emergency_save;
		3602	cf::write_runtime_sync; # external watchdog should not bark
		3603
		3604	warn "syncing database to disk";
		3605	BDB::db_env_txn_checkpoint $DB_ENV;
		3606
		3607	# if anything goes wrong in here, we should simply crash as we already saved
		3608
		3609	warn "flushing outstanding aio requests";
1068	for (@exts) {	3610	for (;;) {
1069	$msg->("unloading <$_>");	3611	BDB::flush;
1070	unload_extension $_;	3612	IO::AIO::flush;
		3613	Coro::cede_notself;
		3614	last unless IO::AIO::nreqs || BDB::nreqs;
		3615	warn "iterate...";
		3616	}
		3617
		3618	++$RELOAD;
		3619
		3620	warn "cancelling all extension coros";
		3621	$_->cancel for values %EXT_CORO;
		3622	%EXT_CORO = ();
		3623
		3624	warn "removing commands";
		3625	%COMMAND = ();
		3626
		3627	warn "removing ext/exti commands";
		3628	%EXTCMD = ();
		3629	%EXTICMD = ();
		3630
		3631	warn "unloading/nuking all extensions";
		3632	for my $pkg (@EXTS) {
		3633	warn "... unloading $pkg";
		3634
		3635	if (my $cb = $pkg->can ("unload")) {
		3636	eval {
		3637	$cb->($pkg);
		3638	1
		3639	} or warn "$pkg unloaded, but with errors: $@";
1071	}	3640	}
1072		3641
		3642	warn "... nuking $pkg";
		3643	Symbol::delete_package $pkg;
		3644	}
		3645
1073	# unload all modules loaded from $LIBDIR	3646	warn "unloading all perl modules loaded from $LIBDIR";
1074	while (my ($k, $v) = each %INC) {	3647	while (my ($k, $v) = each %INC) {
1075	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;	3648	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1076		3649
1077	$msg->("removing <$k>");	3650	warn "... unloading $k";
1078	delete $INC{$k};	3651	delete $INC{$k};
1079		3652
1080	$k =~ s/\.pm$//;	3653	$k =~ s/\.pm$//;
1081	$k =~ s/\//::/g;	3654	$k =~ s/\//::/g;
1082		3655
…		…
1085	}	3658	}
1086		3659
1087	Symbol::delete_package $k;	3660	Symbol::delete_package $k;
1088	}	3661	}
1089		3662
1090	# sync database to disk
1091	cf::db_sync;
1092
1093	# get rid of safe::, as good as possible	3663	warn "getting rid of safe::, as good as possible";
1094	Symbol::delete_package "safe::$_"	3664	Symbol::delete_package "safe::$_"
1095	for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);	3665	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
1096		3666
1097	# remove register_script_function callbacks
1098	# TODO
1099
1100	# unload cf.pm "a bit"	3667	warn "unloading cf.pm \"a bit\"";
1101	delete $INC{"cf.pm"};	3668	delete $INC{"cf.pm"};
		3669	delete $INC{"cf/pod.pm"};
1102		3670
1103	# don't, removes xs symbols, too,	3671	# don't, removes xs symbols, too,
1104	# and global variables created in xs	3672	# and global variables created in xs
1105	#Symbol::delete_package __PACKAGE__;	3673	#Symbol::delete_package __PACKAGE__;
1106		3674
1107	# reload cf.pm	3675	warn "unload completed, starting to reload now";
		3676
1108	$msg->("reloading cf.pm");	3677	warn "reloading cf.pm";
1109	require cf;	3678	require cf;
		3679	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
1110		3680
1111	# load config and database again	3681	warn "loading config and database again";
1112	cf::cfg_load;	3682	cf::reload_config;
1113	cf::db_load;
1114		3683
1115	# load extensions	3684	warn "loading extensions";
1116	$msg->("load extensions");
1117	cf::load_extensions;	3685	cf::load_extensions;
1118		3686
1119	# reattach attachments to objects	3687	warn "reattaching attachments to objects/players";
1120	$msg->("reattach");	3688	_global_reattach; # objects, sockets
1121	_global_reattach;	3689	warn "reattaching attachments to maps";
		3690	reattach $_ for values %MAP;
		3691	warn "reattaching attachments to players";
		3692	reattach $_ for values %PLAYER;
		3693
		3694	warn "leaving sync_job";
		3695
		3696	1
		3697	} or do {
		3698	warn $@;
		3699	cf::cleanup "error while reloading, exiting.";
1122	};	3700	};
1123	$msg->($@) if $@;
1124		3701
1125	$msg->("reloaded");	3702	warn "reloaded";
1126	};	3703	};
1127		3704
1128	sub perl_reload() {	3705	our $RELOAD_WATCHER; # used only during reload
1129	_perl_reload {	3706
1130	warn $_[0];	3707	sub reload_perl() {
1131	print "$_[0]\n";	3708	# doing reload synchronously and two reloads happen back-to-back,
		3709	# coro crashes during coro_state_free->destroy here.
		3710
		3711	$RELOAD_WATCHER ||= EV::timer 0, 0, sub {
		3712	do_reload_perl;
		3713	undef $RELOAD_WATCHER;
1132	};	3714	};
1133	}	3715	}
1134		3716
1135	register_command "perl-reload", 0, sub {	3717	register_command "reload" => sub {
1136	my ($who, $arg) = @_;	3718	my ($who, $arg) = @_;
1137		3719
1138	if ($who->flag (FLAG_WIZ)) {	3720	if ($who->flag (FLAG_WIZ)) {
1139	_perl_reload {	3721	$who->message ("reloading server.");
1140	warn $_[0];	3722	async {
1141	$who->message ($_[0]);	3723	$Coro::current->{desc} = "perl_reload";
		3724	reload_perl;
1142	};	3725	};
1143	}	3726	}
1144	};	3727	};
1145		3728
1146	register "<global>", __PACKAGE__;
1147
1148	unshift @INC, $LIBDIR;	3729	unshift @INC, $LIBDIR;
1149		3730
1150	$TICK_WATCHER = Event->timer (	3731	my $bug_warning = 0;
1151	prio => 1,	3732
1152	async => 1,	3733	our @WAIT_FOR_TICK;
1153	at => $NEXT_TICK || 1,	3734	our @WAIT_FOR_TICK_BEGIN;
1154	cb => sub {	3735
		3736	sub wait_for_tick {
		3737	return if tick_inhibit || $Coro::current == $Coro::main;
		3738
		3739	my $signal = new Coro::Signal;
		3740	push @WAIT_FOR_TICK, $signal;
		3741	$signal->wait;
		3742	}
		3743
		3744	sub wait_for_tick_begin {
		3745	return if tick_inhibit || $Coro::current == $Coro::main;
		3746
		3747	my $signal = new Coro::Signal;
		3748	push @WAIT_FOR_TICK_BEGIN, $signal;
		3749	$signal->wait;
		3750	}
		3751
		3752	sub tick {
		3753	if ($Coro::current != $Coro::main) {
		3754	Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
		3755	unless ++$bug_warning > 10;
		3756	return;
		3757	}
		3758
1155	cf::server_tick; # one server iteration	3759	cf::server_tick; # one server iteration
1156		3760
1157	my $NOW = Event::time;	3761	if ($NOW >= $NEXT_RUNTIME_WRITE) {
1158	$NEXT_TICK += $TICK;	3762	$NEXT_RUNTIME_WRITE = List::Util::max $NEXT_RUNTIME_WRITE + 10, $NOW + 5.;
1159		3763	Coro::async_pool {
1160	# if we are delayed by four ticks or more, skip them all	3764	$Coro::current->{desc} = "runtime saver";
1161	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;	3765	write_runtime_sync
1162		3766	or warn "ERROR: unable to write runtime file: $!";
1163	$TICK_WATCHER->at ($NEXT_TICK);	3767	};
1164	$TICK_WATCHER->start;
1165	},	3768	}
1166	);
1167		3769
1168	eval { IO::AIO::max_poll_time $TICK * 0.2 }; #d# remove eval after restart	3770	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
		3771	$sig->send;
		3772	}
		3773	while (my $sig = shift @WAIT_FOR_TICK) {
		3774	$sig->send;
		3775	}
1169		3776
1170	Event->io (fd => IO::AIO::poll_fileno,	3777	$LOAD = ($NOW - $TICK_START) / $TICK;
1171	poll => 'r',	3778	$LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
1172	prio => 5,	3779
1173	cb => \&IO::AIO::poll_cb);	3780	if (0) {
		3781	if ($NEXT_TICK) {
		3782	my $jitter = $TICK_START - $NEXT_TICK;
		3783	$JITTER = $JITTER * 0.75 + $jitter * 0.25;
		3784	warn "jitter $JITTER\n";#d#
		3785	}
		3786	}
		3787	}
		3788
		3789	{
		3790	# configure BDB
		3791
		3792	BDB::min_parallel 8;
		3793	BDB::max_poll_reqs $TICK * 0.1;
		3794	$AnyEvent::BDB::WATCHER->priority (1);
		3795
		3796	unless ($DB_ENV) {
		3797	$DB_ENV = BDB::db_env_create;
		3798	$DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC
		3799	| BDB::LOG_AUTOREMOVE, 1);
		3800	$DB_ENV->set_timeout (30, BDB::SET_TXN_TIMEOUT);
		3801	$DB_ENV->set_timeout (30, BDB::SET_LOCK_TIMEOUT);
		3802
		3803	cf::sync_job {
		3804	eval {
		3805	BDB::db_env_open
		3806	$DB_ENV,
		3807	$BDBDIR,
		3808	BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
		3809	| BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
		3810	0666;
		3811
		3812	cf::cleanup "db_env_open($BDBDIR): $!" if $!;
		3813	};
		3814
		3815	cf::cleanup "db_env_open(db): $@" if $@;
		3816	};
		3817	}
		3818
		3819	$BDB_DEADLOCK_WATCHER = EV::periodic 0, 3, 0, sub {
		3820	BDB::db_env_lock_detect $DB_ENV, 0, BDB::LOCK_DEFAULT, 0, sub { };
		3821	};
		3822	$BDB_CHECKPOINT_WATCHER = EV::periodic 0, 60, 0, sub {
		3823	BDB::db_env_txn_checkpoint $DB_ENV, 0, 0, 0, sub { };
		3824	};
		3825	$BDB_TRICKLE_WATCHER = EV::periodic 0, 10, 0, sub {
		3826	BDB::db_env_memp_trickle $DB_ENV, 20, 0, sub { };
		3827	};
		3828	}
		3829
		3830	{
		3831	# configure IO::AIO
		3832
		3833	IO::AIO::min_parallel 8;
		3834	IO::AIO::max_poll_time $TICK * 0.1;
		3835	#undef $AnyEvent::AIO::WATCHER;
		3836	}
		3837
		3838	my $_log_backtrace;
		3839
		3840	sub _log_backtrace {
		3841	my ($msg, @addr) = @_;
		3842
		3843	$msg =~ s/\n//;
		3844
		3845	# limit the # of concurrent backtraces
		3846	if ($_log_backtrace < 2) {
		3847	++$_log_backtrace;
		3848	async {
		3849	$Coro::current->{desc} = "abt $msg";
		3850
		3851	my @bt = fork_call {
		3852	@addr = map { sprintf "%x", $_ } @addr;
		3853	my $self = (-f "/proc/$$/exe") ? "/proc/$$/exe" : $^X;
		3854	open my $fh, "exec addr2line -C -f -i -e \Q$self\E @addr 2>&1 |"
		3855	or die "addr2line: $!";
		3856
		3857	my @funcs;
		3858	my @res = <$fh>;
		3859	chomp for @res;
		3860	while (@res) {
		3861	my ($func, $line) = splice @res, 0, 2, ();
		3862	push @funcs, "[$func] $line";
		3863	}
		3864
		3865	@funcs
		3866	};
		3867
		3868	LOG llevInfo, "[ABT] $msg\n";
		3869	LOG llevInfo, "[ABT] $_\n" for @bt;
		3870	--$_log_backtrace;
		3871	};
		3872	} else {
		3873	LOG llevInfo, "[ABT] $msg\n";
		3874	LOG llevInfo, "[ABT] [suppressed]\n";
		3875	}
		3876	}
		3877
		3878	# load additional modules
		3879	use cf::pod;
		3880
		3881	END { cf::emergency_save }
		3882
		3883	evthread_start IO::AIO::poll_fileno;
1174		3884
1175	1	3885	1
1176		3886

Diff Legend

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