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

Diff Legend

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