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.97 by root, Fri Dec 22 06:03:20 2006 UTC vs.
Revision 1.525 by root, Wed Apr 21 03:34:26 2010 UTC

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

Diff Legend

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