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.252 by root, Wed Apr 18 15:28:18 2007 UTC vs.
Revision 1.371 by root, Thu Sep 13 16:16:01 2007 UTC

…		…
10	use Event;	10	use Event;
11	use Opcode;	11	use Opcode;
12	use Safe;	12	use Safe;
13	use Safe::Hole;	13	use Safe::Hole;
14		14
15	use Coro 3.61 ();	15	use Coro 3.64 ();
16	use Coro::State;	16	use Coro::State;
17	use Coro::Handle;	17	use Coro::Handle;
18	use Coro::Event;	18	use Coro::Event;
19	use Coro::Timer;	19	use Coro::Timer;
20	use Coro::Signal;	20	use Coro::Signal;
21	use Coro::Semaphore;	21	use Coro::Semaphore;
22	use Coro::AIO;	22	use Coro::AIO;
23	use Coro::Storable;	23	use Coro::Storable;
		24	use Coro::Util ();
24		25
		26	use JSON::XS ();
25	use BDB ();	27	use BDB ();
26	use Data::Dumper;	28	use Data::Dumper;
27	use Digest::MD5;	29	use Digest::MD5;
28	use Fcntl;	30	use Fcntl;
29	use YAML::Syck ();	31	use YAML::Syck ();
30	use IO::AIO 2.32 ();	32	use IO::AIO 2.32 ();
31	use Time::HiRes;	33	use Time::HiRes;
32	use Compress::LZF;	34	use Compress::LZF;
		35	use Digest::MD5 ();
33		36
34	# configure various modules to our taste	37	# configure various modules to our taste
35	#	38	#
36	$Storable::canonical = 1; # reduce rsync transfers	39	$Storable::canonical = 1; # reduce rsync transfers
37	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator	40	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
…		…
49	our %COMMAND = ();	52	our %COMMAND = ();
50	our %COMMAND_TIME = ();	53	our %COMMAND_TIME = ();
51		54
52	our @EXTS = (); # list of extension package names	55	our @EXTS = (); # list of extension package names
53	our %EXTCMD = ();	56	our %EXTCMD = ();
		57	our %EXTICMD = ();
54	our %EXT_CORO = (); # coroutines bound to extensions	58	our %EXT_CORO = (); # coroutines bound to extensions
55	our %EXT_MAP = (); # pluggable maps	59	our %EXT_MAP = (); # pluggable maps
56		60
57	our $RELOAD; # number of reloads so far	61	our $RELOAD; # number of reloads so far
58	our @EVENT;	62	our @EVENT;
59	our $LIBDIR = datadir . "/ext";	63
		64	our $CONFDIR = confdir;
		65	our $DATADIR = datadir;
		66	our $LIBDIR = "$DATADIR/ext";
		67	our $PODDIR = "$DATADIR/pod";
		68	our $MAPDIR = "$DATADIR/" . mapdir;
		69	our $LOCALDIR = localdir;
		70	our $TMPDIR = "$LOCALDIR/" . tmpdir;
		71	our $UNIQUEDIR = "$LOCALDIR/" . uniquedir;
		72	our $PLAYERDIR = "$LOCALDIR/" . playerdir;
		73	our $RANDOMDIR = "$LOCALDIR/random";
		74	our $BDBDIR = "$LOCALDIR/db";
60		75
61	our $TICK = MAX_TIME * 1e-6; # this is a CONSTANT(!)	76	our $TICK = MAX_TIME * 1e-6; # this is a CONSTANT(!)
62	our $TICK_WATCHER;	77	our $TICK_WATCHER;
63	our $AIO_POLL_WATCHER;	78	our $AIO_POLL_WATCHER;
64	our $NEXT_RUNTIME_WRITE; # when should the runtime file be written	79	our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
65	our $NEXT_TICK;	80	our $NEXT_TICK;
66	our $NOW;	81	our $NOW;
67	our $USE_FSYNC = 1; # use fsync to write maps - default off	82	our $USE_FSYNC = 1; # use fsync to write maps - default off
68		83
69	our $BDB_POLL_WATCHER;	84	our $BDB_POLL_WATCHER;
		85	our $BDB_DEADLOCK_WATCHER;
		86	our $BDB_CHECKPOINT_WATCHER;
		87	our $BDB_TRICKLE_WATCHER;
70	our $DB_ENV;	88	our $DB_ENV;
71		89
72	our %CFG;	90	our %CFG;
73		91
74	our $UPTIME; $UPTIME ||= time;	92	our $UPTIME; $UPTIME ||= time;
75	our $RUNTIME;	93	our $RUNTIME;
76		94
77	our %PLAYER; # all users	95	our (%PLAYER, %PLAYER_LOADING); # all users
78	our %MAP; # all maps	96	our (%MAP, %MAP_LOADING ); # all maps
79	our $LINK_MAP; # the special {link} map, which is always available	97	our $LINK_MAP; # the special {link} map, which is always available
80	our $RANDOM_MAPS = cf::localdir . "/random";
81	our $BDB_ENV_DIR = cf::localdir . "/db";
82		98
83	# used to convert map paths into valid unix filenames by replacing / by ∕	99	# used to convert map paths into valid unix filenames by replacing / by ∕
84	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons	100	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
85		101
		102	our $LOAD; # a number between 0 (idle) and 1 (too many objects)
		103	our $LOADAVG; # same thing, but with alpha-smoothing
		104	our $tick_start; # for load detecting purposes
		105
86	binmode STDOUT;	106	binmode STDOUT;
87	binmode STDERR;	107	binmode STDERR;
88		108
89	# read virtual server time, if available	109	# read virtual server time, if available
90	unless ($RUNTIME || !-e cf::localdir . "/runtime") {	110	unless ($RUNTIME || !-e "$LOCALDIR/runtime") {
91	open my $fh, "<", cf::localdir . "/runtime"	111	open my $fh, "<", "$LOCALDIR/runtime"
92	or die "unable to read runtime file: $!";	112	or die "unable to read runtime file: $!";
93	$RUNTIME = <$fh> + 0.;	113	$RUNTIME = <$fh> + 0.;
94	}	114	}
95		115
96	mkdir cf::localdir;	116	mkdir $_
97	mkdir cf::localdir . "/" . cf::playerdir;	117	for $LOCALDIR, $TMPDIR, $UNIQUEDIR, $PLAYERDIR, $RANDOMDIR, $BDBDIR;
98	mkdir cf::localdir . "/" . cf::tmpdir;
99	mkdir cf::localdir . "/" . cf::uniquedir;
100	mkdir $RANDOM_MAPS;
101	mkdir $BDB_ENV_DIR;
102		118
103	our $EMERGENCY_POSITION;	119	our $EMERGENCY_POSITION;
104		120
105	sub cf::map::normalise;	121	sub cf::map::normalise;
106		122
…		…
117	=item $cf::RUNTIME	133	=item $cf::RUNTIME
118		134
119	The time this server has run, starts at 0 and is increased by $cf::TICK on	135	The time this server has run, starts at 0 and is increased by $cf::TICK on
120	every server tick.	136	every server tick.
121		137
122	=item $cf::LIBDIR	138	=item $cf::CONFDIR $cf::DATADIR $cf::LIBDIR $cf::PODDIR
		139	$cf::MAPDIR $cf::LOCALDIR $cf::TMPDIR $cf::UNIQUEDIR
		140	$cf::PLAYERDIR $cf::RANDOMDIR $cf::BDBDIR
123		141
124	The perl library directory, where extensions and cf-specific modules can	142	Various directories - "/etc", read-only install directory, perl-library
125	be found. It will be added to C<@INC> automatically.	143	directory, pod-directory, read-only maps directory, "/var", "/var/tmp",
		144	unique-items directory, player file directory, random maps directory and
		145	database environment.
126		146
127	=item $cf::NOW	147	=item $cf::NOW
128		148
129	The time of the last (current) server tick.	149	The time of the last (current) server tick.
130		150
131	=item $cf::TICK	151	=item $cf::TICK
132		152
133	The interval between server ticks, in seconds.	153	The interval between server ticks, in seconds.
		154
		155	=item $cf::LOADAVG
		156
		157	The current CPU load on the server (alpha-smoothed), as a value between 0
		158	(none) and 1 (overloaded), indicating how much time is spent on processing
		159	objects per tick. Healthy values are < 0.5.
		160
		161	=item $cf::LOAD
		162
		163	The raw value load value from the last tick.
134		164
135	=item %cf::CFG	165	=item %cf::CFG
136		166
137	Configuration for the server, loaded from C</etc/crossfire/config>, or	167	Configuration for the server, loaded from C</etc/crossfire/config>, or
138	from wherever your confdir points to.	168	from wherever your confdir points to.
…		…
141		171
142	These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only	172	These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only
143	returns directly I<after> the tick processing (and consequently, can only wake one process	173	returns directly I<after> the tick processing (and consequently, can only wake one process
144	per tick), while cf::wait_for_tick wakes up all waiters after tick processing.	174	per tick), while cf::wait_for_tick wakes up all waiters after tick processing.
145		175
		176	=item @cf::INVOKE_RESULTS
		177
		178	This array contains the results of the last C<invoke ()> call. When
		179	C<cf::override> is called C<@cf::INVOKE_RESULTS> is set to the parameters of
		180	that call.
		181
146	=back	182	=back
147		183
148	=cut	184	=cut
149		185
150	BEGIN {	186	BEGIN {
…		…
152	my $msg = join "", @_;	188	my $msg = join "", @_;
153		189
154	$msg .= "\n"	190	$msg .= "\n"
155	unless $msg =~ /\n$/;	191	unless $msg =~ /\n$/;
156		192
157	$msg =~ s/([\x00-\x09\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;	193	$msg =~ s/([\x00-\x08\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
158		194
159	utf8::encode $msg;
160	LOG llevError, $msg;	195	LOG llevError, $msg;
161	};	196	};
162	}	197	}
163		198
164	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';	199	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
165	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';	200	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
166	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';	201	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
167	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';	202	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
168	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';	203	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
		204	@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
169	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	205	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; # not really true (yet)
170		206
171	# we bless all objects into (empty) derived classes to force a method lookup	207	# we bless all objects into (empty) derived classes to force a method lookup
172	# within the Safe compartment.	208	# within the Safe compartment.
173	for my $pkg (qw(	209	for my $pkg (qw(
174	cf::global cf::attachable	210	cf::global cf::attachable
…		…
182	}	218	}
183		219
184	$Event::DIED = sub {	220	$Event::DIED = sub {
185	warn "error in event callback: @_";	221	warn "error in event callback: @_";
186	};	222	};
		223
		224	#############################################################################
187		225
188	=head2 UTILITY FUNCTIONS	226	=head2 UTILITY FUNCTIONS
189		227
190	=over 4	228	=over 4
191		229
…		…
210	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;	248	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
211	$d	249	$d
212	} || "[unable to dump $_[0]: '$@']";	250	} || "[unable to dump $_[0]: '$@']";
213	}	251	}
214		252
215	use JSON::XS qw(to_json from_json); # TODO# replace by JSON::PC once working
216
217	=item $ref = cf::from_json $json	253	=item $ref = cf::from_json $json
218		254
219	Converts a JSON string into the corresponding perl data structure.	255	Converts a JSON string into the corresponding perl data structure.
220		256
221	=item $json = cf::to_json $ref	257	=item $json = cf::to_json $ref
222		258
223	Converts a perl data structure into its JSON representation.	259	Converts a perl data structure into its JSON representation.
		260
		261	=cut
		262
		263	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
		264
		265	sub to_json ($) { $json_coder->encode ($_[0]) }
		266	sub from_json ($) { $json_coder->decode ($_[0]) }
224		267
225	=item cf::lock_wait $string	268	=item cf::lock_wait $string
226		269
227	Wait until the given lock is available. See cf::lock_acquire.	270	Wait until the given lock is available. See cf::lock_acquire.
228		271
…		…
231	Wait until the given lock is available and then acquires it and returns	274	Wait until the given lock is available and then acquires it and returns
232	a Coro::guard object. If the guard object gets destroyed (goes out of scope,	275	a Coro::guard object. If the guard object gets destroyed (goes out of scope,
233	for example when the coroutine gets canceled), the lock is automatically	276	for example when the coroutine gets canceled), the lock is automatically
234	returned.	277	returned.
235		278
		279	Locks are *not* recursive, locking from the same coro twice results in a
		280	deadlocked coro.
		281
236	Lock names should begin with a unique identifier (for example, cf::map::find	282	Lock names should begin with a unique identifier (for example, cf::map::find
237	uses map_find and cf::map::load uses map_load).	283	uses map_find and cf::map::load uses map_load).
238		284
		285	=item $locked = cf::lock_active $string
		286
		287	Return true if the lock is currently active, i.e. somebody has locked it.
		288
239	=cut	289	=cut
240		290
241	our %LOCK;	291	our %LOCK;
		292	our %LOCKER;#d#
242		293
243	sub lock_wait($) {	294	sub lock_wait($) {
244	my ($key) = @_;	295	my ($key) = @_;
		296
		297	if ($LOCKER{$key} == $Coro::current) {#d#
		298	Carp::cluck "lock_wait($key) for already-acquired lock";#d#
		299	return;#d#
		300	}#d#
245		301
246	# wait for lock, if any	302	# wait for lock, if any
247	while ($LOCK{$key}) {	303	while ($LOCK{$key}) {
248	push @{ $LOCK{$key} }, $Coro::current;	304	push @{ $LOCK{$key} }, $Coro::current;
249	Coro::schedule;	305	Coro::schedule;
…		…
255		311
256	# wait, to be sure we are not locked	312	# wait, to be sure we are not locked
257	lock_wait $key;	313	lock_wait $key;
258		314
259	$LOCK{$key} = [];	315	$LOCK{$key} = [];
		316	$LOCKER{$key} = $Coro::current;#d#
260		317
261	Coro::guard {	318	Coro::guard {
		319	delete $LOCKER{$key};#d#
262	# wake up all waiters, to be on the safe side	320	# wake up all waiters, to be on the safe side
263	$_->ready for @{ delete $LOCK{$key} };	321	$_->ready for @{ delete $LOCK{$key} };
264	}	322	}
		323	}
		324
		325	sub lock_active($) {
		326	my ($key) = @_;
		327
		328	! ! $LOCK{$key}
265	}	329	}
266		330
267	sub freeze_mainloop {	331	sub freeze_mainloop {
268	return unless $TICK_WATCHER->is_active;	332	return unless $TICK_WATCHER->is_active;
269		333
…		…
272	};	336	};
273	$TICK_WATCHER->stop;	337	$TICK_WATCHER->stop;
274	$guard	338	$guard
275	}	339	}
276		340
		341	=item cf::get_slot $time[, $priority[, $name]]
		342
		343	Allocate $time seconds of blocking CPU time at priority C<$priority>:
		344	This call blocks and returns only when you have at least C<$time> seconds
		345	of cpu time till the next tick. The slot is only valid till the next cede.
		346
		347	The optional C<$name> can be used to identify the job to run. It might be
		348	used for statistical purposes and should identify the same time-class.
		349
		350	Useful for short background jobs.
		351
		352	=cut
		353
		354	our @SLOT_QUEUE;
		355	our $SLOT_QUEUE;
		356
		357	$SLOT_QUEUE->cancel if $SLOT_QUEUE;
		358	$SLOT_QUEUE = Coro::async {
		359	my $signal = new Coro::Signal;
		360
		361	while () {
		362	next_job:
		363	my $avail = cf::till_tick;
		364	if ($avail > 0.01) {
		365	for (0 .. $#SLOT_QUEUE) {
		366	if ($SLOT_QUEUE[$_][0] < $avail) {
		367	my $job = splice @SLOT_QUEUE, $_, 1, ();
		368	$job->[2]->send;
		369	Coro::cede;
		370	goto next_job;
		371	}
		372	}
		373	}
		374
		375	if (@SLOT_QUEUE) {
		376	# we do not use wait_For_tick() as it returns immediately when tick is inactive
		377	push @cf::WAIT_FOR_TICK, $signal;
		378	$signal->wait;
		379	} else {
		380	Coro::schedule;
		381	}
		382	}
		383	};
		384
		385	sub get_slot($;$$) {
		386	my ($time, $pri, $name) = @_;
		387
		388	$time = $TICK * .6 if $time > $TICK * .6;
		389	my $sig = new Coro::Signal;
		390
		391	push @SLOT_QUEUE, [$time, $pri, $sig, $name];
		392	@SLOT_QUEUE = sort { $b->[1] <=> $a->[1] } @SLOT_QUEUE;
		393	$SLOT_QUEUE->ready;
		394	$sig->wait;
		395	}
		396
277	=item cf::async { BLOCK }	397	=item cf::async { BLOCK }
278		398
279	Currently the same as Coro::async_pool, meaning you cannot use	399	Currently the same as Coro::async_pool, meaning you cannot use
280	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only	400	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
281	thing you are allowed to do is call C<prio> on it.	401	thing you are allowed to do is call C<prio> on it.
…		…
284		404
285	BEGIN { *async = \&Coro::async_pool }	405	BEGIN { *async = \&Coro::async_pool }
286		406
287	=item cf::sync_job { BLOCK }	407	=item cf::sync_job { BLOCK }
288		408
289	The design of crossfire+ requires that the main coro ($Coro::main) is	409	The design of Crossfire TRT requires that the main coroutine ($Coro::main)
290	always able to handle events or runnable, as crossfire+ is only partly	410	is always able to handle events or runnable, as Crossfire TRT is only
291	reentrant. Thus "blocking" it by e.g. waiting for I/O is not acceptable.	411	partly reentrant. Thus "blocking" it by e.g. waiting for I/O is not
		412	acceptable.
292		413
293	If it must be done, put the blocking parts into C<sync_job>. This will run	414	If it must be done, put the blocking parts into C<sync_job>. This will run
294	the given BLOCK in another coroutine while waiting for the result. The	415	the given BLOCK in another coroutine while waiting for the result. The
295	server will be frozen during this time, so the block should either finish	416	server will be frozen during this time, so the block should either finish
296	fast or be very important.	417	fast or be very important.
…		…
299		420
300	sub sync_job(&) {	421	sub sync_job(&) {
301	my ($job) = @_;	422	my ($job) = @_;
302		423
303	if ($Coro::current == $Coro::main) {	424	if ($Coro::current == $Coro::main) {
		425	my $time = Event::time;
		426
304	# this is the main coro, too bad, we have to block	427	# this is the main coro, too bad, we have to block
305	# till the operation succeeds, freezing the server :/	428	# till the operation succeeds, freezing the server :/
306		429
307	# TODO: use suspend/resume instead	430	# TODO: use suspend/resume instead
308	# (but this is cancel-safe)	431	# (but this is cancel-safe)
…		…
319		442
320	while ($busy) {	443	while ($busy) {
321	Coro::cede or Event::one_event;	444	Coro::cede or Event::one_event;
322	}	445	}
323		446
		447	$time = Event::time - $time;
		448
		449	LOG llevError | logBacktrace, Carp::longmess "long sync job"
		450	if $time > $TICK * 0.5 && $TICK_WATCHER->is_active;
		451
		452	$tick_start += $time; # do not account sync jobs to server load
		453
324	wantarray ? @res : $res[0]	454	wantarray ? @res : $res[0]
325	} else {	455	} else {
326	# we are in another coroutine, how wonderful, everything just works	456	# we are in another coroutine, how wonderful, everything just works
327		457
328	$job->()	458	$job->()
…		…
347	$EXT_CORO{$coro+0} = $coro;	477	$EXT_CORO{$coro+0} = $coro;
348		478
349	$coro	479	$coro
350	}	480	}
351		481
352	sub write_runtime {	482	=item fork_call { }, $args
353	my $guard = cf::lock_acquire "write_runtime";
354		483
355	my $runtime = cf::localdir . "/runtime";	484	Executes the given code block with the given arguments in a seperate
		485	process, returning the results. Everything must be serialisable with
		486	Coro::Storable. May, of course, block. Note that the executed sub may
		487	never block itself or use any form of Event handling.
356		488
357	my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644	489	=cut
358	or return;
359		490
360	my $value = $cf::RUNTIME + 90 + 10;	491	sub fork_call(&@) {
361	# 10 is the runtime save interval, for a monotonic clock	492	my ($cb, @args) = @_;
362	# 60 allows for the watchdog to kill the server.
363		493
364	(aio_write $fh, 0, (length $value), $value, 0) <= 0	494	# we seemingly have to make a local copy of the whole thing,
365	and return;	495	# otherwise perl prematurely frees the stuff :/
		496	# TODO: investigate and fix (likely this will be rather laborious)
366		497
367	# always fsync - this file is important	498	my @res = Coro::Util::fork_eval {
368	aio_fsync $fh	499	reset_signals;
369	and return;	500	&$cb
		501	}, @args;
370		502
371	close $fh	503	wantarray ? @res : $res[-1]
372	or return;	504	}
373		505
374	aio_rename "$runtime~", $runtime	506	=item $value = cf::db_get $family => $key
375	and return;
376		507
		508	Returns a single value from the environment database.
		509
		510	=item cf::db_put $family => $key => $value
		511
		512	Stores the given C<$value> in the family. It can currently store binary
		513	data only (use Compress::LZF::sfreeze_cr/sthaw to convert to/from binary).
		514
		515	=item $db = cf::db_table "name"
		516
		517	Create and/or open a new database table. The string must not be "db" and must be unique
		518	within each server.
		519
		520	=cut
		521
		522	sub db_table($) {
		523	my ($name) = @_;
		524	my $db = BDB::db_create $DB_ENV;
		525
		526	eval {
		527	$db->set_flags (BDB::CHKSUM);
		528
		529	utf8::encode $name;
		530	BDB::db_open $db, undef, $name, undef, BDB::BTREE,
		531	BDB::CREATE | BDB::AUTO_COMMIT, 0666;
		532	cf::cleanup "db_open(db): $!" if $!;
		533	};
		534	cf::cleanup "db_open(db): $@" if $@;
		535
		536	$db
		537	}
		538
		539	our $DB;
		540
		541	sub db_init {
		542	cf::sync_job {
		543	$DB ||= db_table "db";
		544	};
		545	}
		546
		547	sub db_get($$) {
		548	my $key = "$_[0]/$_[1]";
		549
		550	cf::sync_job {
		551	BDB::db_get $DB, undef, $key, my $data;
		552
		553	$! ? ()
		554	: $data
377	1	555	}
		556	}
		557
		558	sub db_put($$$) {
		559	BDB::dbreq_pri 4;
		560	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
		561	}
		562
		563	=item cf::cache $id => [$paths...], $processversion => $process
		564
		565	Generic caching function that returns the value of the resource $id,
		566	caching and regenerating as required.
		567
		568	This function can block.
		569
		570	=cut
		571
		572	sub cache {
		573	my ($id, $src, $processversion, $process) = @_;
		574
		575	my $meta =
		576	join "\x00",
		577	$processversion,
		578	map {
		579	aio_stat $_
		580	and Carp::croak "$_: $!";
		581
		582	($_, (stat _)[7,9])
		583	} @$src;
		584
		585	my $dbmeta = db_get cache => "$id/meta";
		586	if ($dbmeta ne $meta) {
		587	# changed, we may need to process
		588
		589	my @data;
		590	my $md5;
		591
		592	for (0 .. $#$src) {
		593	0 <= aio_load $src->[$_], $data[$_]
		594	or Carp::croak "$src->[$_]: $!";
		595	}
		596
		597	# if processing is expensive, check
		598	# checksum first
		599	if (1) {
		600	$md5 =
		601	join "\x00",
		602	$processversion,
		603	map {
		604	cf::cede_to_tick;
		605	($src->[$_], Digest::MD5::md5_hex $data[$_])
		606	} 0.. $#$src;
		607
		608
		609	my $dbmd5 = db_get cache => "$id/md5";
		610	if ($dbmd5 eq $md5) {
		611	db_put cache => "$id/meta", $meta;
		612
		613	return db_get cache => "$id/data";
		614	}
		615	}
		616
		617	my $t1 = Time::HiRes::time;
		618	my $data = $process->(\@data);
		619	my $t2 = Time::HiRes::time;
		620
		621	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
		622
		623	db_put cache => "$id/data", $data;
		624	db_put cache => "$id/md5" , $md5;
		625	db_put cache => "$id/meta", $meta;
		626
		627	return $data;
		628	}
		629
		630	db_get cache => "$id/data"
378	}	631	}
379		632
380	=item cf::datalog type => key => value, ...	633	=item cf::datalog type => key => value, ...
381		634
382	Log a datalog packet of the given type with the given key-value pairs.	635	Log a datalog packet of the given type with the given key-value pairs.
…		…
400	attach callbacks/event handlers (a collection of which is called an "attachment")	653	attach callbacks/event handlers (a collection of which is called an "attachment")
401	to it. All such attachable objects support the following methods.	654	to it. All such attachable objects support the following methods.
402		655
403	In the following description, CLASS can be any of C<global>, C<object>	656	In the following description, CLASS can be any of C<global>, C<object>
404	C<player>, C<client> or C<map> (i.e. the attachable objects in	657	C<player>, C<client> or C<map> (i.e. the attachable objects in
405	crossfire+).	658	Crossfire TRT).
406		659
407	=over 4	660	=over 4
408		661
409	=item $attachable->attach ($attachment, key => $value...)	662	=item $attachable->attach ($attachment, key => $value...)
410		663
…		…
573	$registry = $CB_TYPE[$object_type] ||= [];	826	$registry = $CB_TYPE[$object_type] ||= [];
574		827
575	} elsif ($type eq "subtype") {	828	} elsif ($type eq "subtype") {
576	defined $object_type or Carp::croak "subtype specified without type";	829	defined $object_type or Carp::croak "subtype specified without type";
577	my $object_subtype = shift @arg;	830	my $object_subtype = shift @arg;
578	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_SUBTYPES] ||= [];	831	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_TYPES] ||= [];
579		832
580	} elsif ($type eq "package") {	833	} elsif ($type eq "package") {
581	my $pkg = shift @arg;	834	my $pkg = shift @arg;
582		835
583	while (my ($name, $id) = each %cb_id) {	836	while (my ($name, $id) = each %cb_id) {
…		…
612	_attach $registry, $klass, @attach;	865	_attach $registry, $klass, @attach;
613	}	866	}
614		867
615	$obj->{$name} = \%arg;	868	$obj->{$name} = \%arg;
616	} else {	869	} else {
617	warn "object uses attachment '$name' that is not available, postponing.\n";	870	warn "object uses attachment '$name' which is not available, postponing.\n";
618	}	871	}
619		872
620	$obj->{_attachment}{$name} = undef;	873	$obj->{_attachment}{$name} = undef;
621	}	874	}
622		875
…		…
624	if (ref $_[0]) {	877	if (ref $_[0]) {
625	_object_attach @_;	878	_object_attach @_;
626	} else {	879	} else {
627	_attach shift->_attach_registry, @_;	880	_attach shift->_attach_registry, @_;
628	}	881	}
		882	_recalc_want;
629	};	883	};
630		884
631	# all those should be optimised	885	# all those should be optimised
632	sub cf::attachable::detach {	886	sub cf::attachable::detach {
633	my ($obj, $name) = @_;	887	my ($obj, $name) = @_;
…		…
636	delete $obj->{_attachment}{$name};	890	delete $obj->{_attachment}{$name};
637	reattach ($obj);	891	reattach ($obj);
638	} else {	892	} else {
639	Carp::croak "cannot, currently, detach class attachments";	893	Carp::croak "cannot, currently, detach class attachments";
640	}	894	}
		895	_recalc_want;
641	};	896	};
642		897
643	sub cf::attachable::attached {	898	sub cf::attachable::attached {
644	my ($obj, $name) = @_;	899	my ($obj, $name) = @_;
645		900
…		…
660	";	915	";
661	die if $@;	916	die if $@;
662	}	917	}
663		918
664	our $override;	919	our $override;
665	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?	920	our @INVOKE_RESULTS = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
666		921
667	sub override {	922	sub override {
668	$override = 1;	923	$override = 1;
669	@invoke_results = ();	924	@INVOKE_RESULTS = (@_);
670	}	925	}
671		926
672	sub do_invoke {	927	sub do_invoke {
673	my $event = shift;	928	my $event = shift;
674	my $callbacks = shift;	929	my $callbacks = shift;
675		930
676	@invoke_results = ();	931	@INVOKE_RESULTS = ();
677		932
678	local $override;	933	local $override;
679		934
680	for (@$callbacks) {	935	for (@$callbacks) {
681	eval { &{$_->[1]} };	936	eval { &{$_->[1]} };
…		…
698		953
699	Generate an object-specific event with the given arguments.	954	Generate an object-specific event with the given arguments.
700		955
701	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be	956	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
702	removed in future versions), and there is no public API to access override	957	removed in future versions), and there is no public API to access override
703	results (if you must, access C<@cf::invoke_results> directly).	958	results (if you must, access C<@cf::INVOKE_RESULTS> directly).
704		959
705	=back	960	=back
706		961
707	=cut	962	=cut
708		963
709	#############################################################################	964	#############################################################################
710	# object support	965	# object support
		966	#
		967
		968	sub _can_merge {
		969	my ($ob1, $ob2) = @_;
		970
		971	local $Storable::canonical = 1;
		972	my $fob1 = Storable::freeze $ob1;
		973	my $fob2 = Storable::freeze $ob2;
		974
		975	$fob1 eq $fob2
		976	}
711		977
712	sub reattach {	978	sub reattach {
713	# basically do the same as instantiate, without calling instantiate	979	# basically do the same as instantiate, without calling instantiate
714	my ($obj) = @_;	980	my ($obj) = @_;
715		981
…		…
760	);	1026	);
761		1027
762	sub object_freezer_save {	1028	sub object_freezer_save {
763	my ($filename, $rdata, $objs) = @_;	1029	my ($filename, $rdata, $objs) = @_;
764		1030
		1031	my $guard = cf::lock_acquire "io";
		1032
765	sync_job {	1033	sync_job {
766	if (length $$rdata) {	1034	if (length $$rdata) {
		1035	utf8::decode (my $decname = $filename);
767	warn sprintf "saving %s (%d,%d)\n",	1036	warn sprintf "saving %s (%d,%d)\n",
768	$filename, length $$rdata, scalar @$objs;	1037	$decname, length $$rdata, scalar @$objs;
769		1038
770	if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {	1039	if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {
771	chmod SAVE_MODE, $fh;	1040	chmod SAVE_MODE, $fh;
772	aio_write $fh, 0, (length $$rdata), $$rdata, 0;	1041	aio_write $fh, 0, (length $$rdata), $$rdata, 0;
773	aio_fsync $fh if $cf::USE_FSYNC;	1042	aio_fsync $fh if $cf::USE_FSYNC;
…		…
792	}	1061	}
793	} else {	1062	} else {
794	aio_unlink $filename;	1063	aio_unlink $filename;
795	aio_unlink "$filename.pst";	1064	aio_unlink "$filename.pst";
796	}	1065	}
797	}	1066	};
		1067
		1068	undef $guard;
798	}	1069	}
799		1070
800	sub object_freezer_as_string {	1071	sub object_freezer_as_string {
801	my ($rdata, $objs) = @_;	1072	my ($rdata, $objs) = @_;
802		1073
…		…
807		1078
808	sub object_thawer_load {	1079	sub object_thawer_load {
809	my ($filename) = @_;	1080	my ($filename) = @_;
810		1081
811	my ($data, $av);	1082	my ($data, $av);
		1083
		1084	my $guard = cf::lock_acquire "io";
812		1085
813	(aio_load $filename, $data) >= 0	1086	(aio_load $filename, $data) >= 0
814	or return;	1087	or return;
815		1088
816	unless (aio_stat "$filename.pst") {	1089	unless (aio_stat "$filename.pst") {
817	(aio_load "$filename.pst", $av) >= 0	1090	(aio_load "$filename.pst", $av) >= 0
818	or return;	1091	or return;
		1092
		1093	undef $guard;
819	$av = eval { (Storable::thaw $av)->{objs} };	1094	$av = eval { (Storable::thaw $av)->{objs} };
820	}	1095	}
821		1096
		1097	utf8::decode (my $decname = $filename);
822	warn sprintf "loading %s (%d)\n",	1098	warn sprintf "loading %s (%d,%d)\n",
823	$filename, length $data, scalar @{$av || []};#d#	1099	$decname, length $data, scalar @{$av || []};
		1100
824	return ($data, $av);	1101	($data, $av)
825	}	1102	}
		1103
		1104	=head2 COMMAND CALLBACKS
		1105
		1106	=over 4
		1107
		1108	=cut
826		1109
827	#############################################################################	1110	#############################################################################
828	# command handling &c	1111	# command handling &c
829		1112
830	=item cf::register_command $name => \&callback($ob,$args);	1113	=item cf::register_command $name => \&callback($ob,$args);
…		…
843	push @{ $COMMAND{$name} }, [$caller, $cb];	1126	push @{ $COMMAND{$name} }, [$caller, $cb];
844	}	1127	}
845		1128
846	=item cf::register_extcmd $name => \&callback($pl,$packet);	1129	=item cf::register_extcmd $name => \&callback($pl,$packet);
847		1130
848	Register a callbackf ro execution when the client sends an extcmd packet.	1131	Register a callback for execution when the client sends an (synchronous)
		1132	extcmd packet. Ext commands will be processed in the order they are
		1133	received by the server, like other user commands. The first argument is
		1134	the logged-in player. Ext commands can only be processed after a player
		1135	has logged in successfully.
849		1136
850	If the callback returns something, it is sent back as if reply was being	1137	If the callback returns something, it is sent back as if reply was being
851	called.	1138	called.
852		1139
		1140	=item cf::register_exticmd $name => \&callback($ns,$packet);
		1141
		1142	Register a callback for execution when the client sends an (asynchronous)
		1143	exticmd packet. Exti commands are processed by the server as soon as they
		1144	are received, i.e. out of order w.r.t. other commands. The first argument
		1145	is a client socket. Exti commands can be received anytime, even before
		1146	log-in.
		1147
		1148	If the callback returns something, it is sent back as if reply was being
		1149	called.
		1150
853	=cut	1151	=cut
854		1152
855	sub register_extcmd {	1153	sub register_extcmd {
856	my ($name, $cb) = @_;	1154	my ($name, $cb) = @_;
857		1155
858	$EXTCMD{$name} = $cb;	1156	$EXTCMD{$name} = $cb;
		1157	}
		1158
		1159	sub register_exticmd {
		1160	my ($name, $cb) = @_;
		1161
		1162	$EXTICMD{$name} = $cb;
859	}	1163	}
860		1164
861	cf::player->attach (	1165	cf::player->attach (
862	on_command => sub {	1166	on_command => sub {
863	my ($pl, $name, $params) = @_;	1167	my ($pl, $name, $params) = @_;
…		…
872	cf::override;	1176	cf::override;
873	},	1177	},
874	on_extcmd => sub {	1178	on_extcmd => sub {
875	my ($pl, $buf) = @_;	1179	my ($pl, $buf) = @_;
876		1180
877	my $msg = eval { from_json $buf };	1181	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
878		1182
879	if (ref $msg) {	1183	if (ref $msg) {
		1184	my ($type, $reply, @payload) =
		1185	"ARRAY" eq ref $msg
		1186	? @$msg
		1187	: ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
		1188
		1189	my @reply;
		1190
880	if (my $cb = $EXTCMD{$msg->{msgtype}}) {	1191	if (my $cb = $EXTCMD{$type}) {
881	if (my %reply = $cb->($pl, $msg)) {	1192	@reply = $cb->($pl, @payload);
882	$pl->ext_reply ($msg->{msgid}, %reply);
883	}
884	}	1193	}
		1194
		1195	$pl->ext_reply ($reply, @reply)
		1196	if $reply;
		1197
885	} else {	1198	} else {
886	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";	1199	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
887	}	1200	}
888		1201
889	cf::override;	1202	cf::override;
890	},	1203	},
891	);	1204	);
892		1205
893	sub load_extension {
894	my ($path) = @_;
895
896	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
897	my $base = $1;
898	my $pkg = $1;
899	$pkg =~ s/[^[:word:]]/_/g;
900	$pkg = "ext::$pkg";
901
902	warn "... loading '$path' into '$pkg'\n";
903
904	open my $fh, "<:utf8", $path
905	or die "$path: $!";
906
907	my $source =
908	"package $pkg; use strict; use utf8;\n"
909	. "#line 1 \"$path\"\n{\n"
910	. (do { local $/; <$fh> })
911	. "\n};\n1";
912
913	unless (eval $source) {
914	my $msg = $@ ? "$path: $@\n"
915	: "extension disabled.\n";
916	if ($source =~ /^#!.*perl.*#.*MANDATORY/m) { # ugly match
917	warn $@;
918	warn "mandatory extension failed to load, exiting.\n";
919	exit 1;
920	}
921	die $@;
922	}
923
924	push @EXTS, $pkg;
925	}
926
927	sub load_extensions {	1206	sub load_extensions {
		1207	cf::sync_job {
		1208	my %todo;
		1209
928	for my $ext (<$LIBDIR/*.ext>) {	1210	for my $path (<$LIBDIR/*.ext>) {
929	next unless -r $ext;	1211	next unless -r $path;
930	eval {	1212
931	load_extension $ext;	1213	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
		1214	my $base = $1;
		1215	my $pkg = $1;
		1216	$pkg =~ s/[^[:word:]]/_/g;
		1217	$pkg = "ext::$pkg";
		1218
		1219	open my $fh, "<:utf8", $path
		1220	or die "$path: $!";
		1221
		1222	my $source = do { local $/; <$fh> };
		1223
		1224	my %ext = (
		1225	path => $path,
		1226	base => $base,
		1227	pkg => $pkg,
		1228	);
		1229
		1230	$ext{meta} = { map { (split /=/, $_, 2)[0, 1] } split /\s+/, $1 }
		1231	if $source =~ /\A#!.*?perl.*?#\s*(.*)$/m;
		1232
		1233	$ext{source} =
		1234	"package $pkg; use strict; use utf8;\n"
		1235	. "#line 1 \"$path\"\n{\n"
		1236	. $source
		1237	. "\n};\n1";
		1238
		1239	$todo{$base} = \%ext;
		1240	}
		1241
		1242	my %done;
		1243	while (%todo) {
		1244	my $progress;
		1245
		1246	while (my ($k, $v) = each %todo) {
		1247	for (split /,\s*/, $v->{meta}{depends}) {
		1248	goto skip
		1249	unless exists $done{$_};
		1250	}
		1251
		1252	warn "... loading '$k' into '$v->{pkg}'\n";
		1253
		1254	unless (eval $v->{source}) {
		1255	my $msg = $@ ? "$v->{path}: $@\n"
		1256	: "$v->{base}: extension inactive.\n";
		1257
		1258	if (exists $v->{meta}{mandatory}) {
		1259	warn $msg;
		1260	warn "mandatory extension failed to load, exiting.\n";
		1261	exit 1;
		1262	}
		1263
		1264	warn $msg;
		1265	}
		1266
		1267	$done{$k} = delete $todo{$k};
		1268	push @EXTS, $v->{pkg};
		1269	$progress = 1;
932	1	1270	}
933	} or warn "$ext not loaded: $@";	1271
		1272	skip:
		1273	die "cannot load " . (join ", ", keys %todo) . ": unable to resolve dependencies\n"
		1274	unless $progress;
		1275	}
934	}	1276	};
935	}	1277	}
936		1278
937	#############################################################################	1279	#############################################################################
938		1280
		1281	=back
		1282
939	=head2 CORE EXTENSIONS	1283	=head2 CORE EXTENSIONS
940		1284
941	Functions and methods that extend core crossfire objects.	1285	Functions and methods that extend core crossfire objects.
942		1286
943	=cut	1287	=cut
…		…
948		1292
949	=head3 cf::player	1293	=head3 cf::player
950		1294
951	=over 4	1295	=over 4
952		1296
		1297	=item cf::player::num_playing
		1298
		1299	Returns the official number of playing players, as per the Crossfire metaserver rules.
		1300
		1301	=cut
		1302
		1303	sub num_playing {
		1304	scalar grep
		1305	$_->ob->map
		1306	&& !$_->hidden
		1307	&& !$_->ob->flag (cf::FLAG_WIZ),
		1308	cf::player::list
		1309	}
		1310
953	=item cf::player::find $login	1311	=item cf::player::find $login
954		1312
955	Returns the given player object, loading it if necessary (might block).	1313	Returns the given player object, loading it if necessary (might block).
956		1314
957	=cut	1315	=cut
958		1316
959	sub playerdir($) {	1317	sub playerdir($) {
960	cf::localdir	1318	"$PLAYERDIR/"
961	. "/"
962	. cf::playerdir
963	. "/"
964	. (ref $_[0] ? $_[0]->ob->name : $_[0])	1319	. (ref $_[0] ? $_[0]->ob->name : $_[0])
965	}	1320	}
966		1321
967	sub path($) {	1322	sub path($) {
968	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];	1323	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
…		…
995	aio_link +(playerdir $login) . "/$login.pl.pst", (playerdir $login) . "/playerdata.pst";	1350	aio_link +(playerdir $login) . "/$login.pl.pst", (playerdir $login) . "/playerdata.pst";
996	aio_link +(playerdir $login) . "/$login.pl" , (playerdir $login) . "/playerdata";	1351	aio_link +(playerdir $login) . "/$login.pl" , (playerdir $login) . "/playerdata";
997	aio_unlink +(playerdir $login) . "/$login.pl.pst";	1352	aio_unlink +(playerdir $login) . "/$login.pl.pst";
998	aio_unlink +(playerdir $login) . "/$login.pl";	1353	aio_unlink +(playerdir $login) . "/$login.pl";
999		1354
1000	my $pl = load_pl path $login	1355	my $f = new_from_file cf::object::thawer path $login
1001	or return;	1356	or return;
		1357
		1358	$f->next;
		1359	my $pl = cf::player::load_pl $f
		1360	or return;
		1361	local $cf::PLAYER_LOADING{$login} = $pl;
		1362	$f->resolve_delayed_derefs;
1002	$cf::PLAYER{$login} = $pl	1363	$cf::PLAYER{$login} = $pl
1003	}	1364	}
1004	}	1365	}
1005	}	1366	}
1006		1367
…		…
1016		1377
1017	aio_mkdir playerdir $pl, 0770;	1378	aio_mkdir playerdir $pl, 0770;
1018	$pl->{last_save} = $cf::RUNTIME;	1379	$pl->{last_save} = $cf::RUNTIME;
1019		1380
1020	$pl->save_pl ($path);	1381	$pl->save_pl ($path);
1021	Coro::cede;	1382	cf::cede_to_tick;
1022	}	1383	}
1023		1384
1024	sub new($) {	1385	sub new($) {
1025	my ($login) = @_;	1386	my ($login) = @_;
1026		1387
…		…
1030	$self->{deny_save} = 1;	1391	$self->{deny_save} = 1;
1031		1392
1032	$cf::PLAYER{$login} = $self;	1393	$cf::PLAYER{$login} = $self;
1033		1394
1034	$self	1395	$self
		1396	}
		1397
		1398	=item $player->send_msg ($channel, $msg, $color, [extra...])
		1399
		1400	=cut
		1401
		1402	sub send_msg {
		1403	my $ns = shift->ns
		1404	or return;
		1405	$ns->send_msg (@_);
1035	}	1406	}
1036		1407
1037	=item $pl->quit_character	1408	=item $pl->quit_character
1038		1409
1039	Nukes the player without looking back. If logged in, the connection will	1410	Nukes the player without looking back. If logged in, the connection will
…		…
1088	while and may block, so not sync_job-capable, ever.	1459	while and may block, so not sync_job-capable, ever.
1089		1460
1090	=cut	1461	=cut
1091		1462
1092	sub list_logins {	1463	sub list_logins {
1093	my $dirs = aio_readdir cf::localdir . "/" . cf::playerdir	1464	my $dirs = aio_readdir $PLAYERDIR
1094	or return [];	1465	or return [];
1095		1466
1096	my @logins;	1467	my @logins;
1097		1468
1098	for my $login (@$dirs) {	1469	for my $login (@$dirs) {
		1470	my $path = path $login;
		1471
		1472	# a .pst is a dead give-away for a valid player
		1473	unless (-e "$path.pst") {
1099	my $fh = aio_open path $login, Fcntl::O_RDONLY, 0 or next;	1474	my $fh = aio_open $path, Fcntl::O_RDONLY, 0 or next;
1100	aio_read $fh, 0, 512, my $buf, 0 or next;	1475	aio_read $fh, 0, 512, my $buf, 0 or next;
1101	$buf !~ /^password -------------$/m or next; # official not-valid tag	1476	$buf !~ /^password -------------$/m or next; # official not-valid tag
		1477	}
1102		1478
1103	utf8::decode $login;	1479	utf8::decode $login;
1104	push @logins, $login;	1480	push @logins, $login;
1105	}	1481	}
1106		1482
…		…
1133	}	1509	}
1134		1510
1135	\@paths	1511	\@paths
1136	}	1512	}
1137		1513
		1514	=item $protocol_xml = $player->expand_cfpod ($crossfire_pod)
		1515
		1516	Expand crossfire pod fragments into protocol xml.
		1517
		1518	=cut
		1519
		1520	sub expand_cfpod {
		1521	((my $self), (local $_)) = @_;
		1522
		1523	# escape & and <
		1524	s/&/&amp;/g;
		1525	s/(?<![BIUGHT])</&lt;/g;
		1526
		1527	# this is buggy, it needs to properly take care of nested <'s
		1528
		1529	1 while
		1530	# replace B<>, I<>, U<> etc.
		1531	s/B<([^\>]*)>/<b>$1<\/b>/
		1532	|| s/I<([^\>]*)>/<i>$1<\/i>/
		1533	|| s/U<([^\>]*)>/<u>$1<\/u>/
		1534	|| s/T<([^\>]*)>/<big><b>$1<\/b><\/big>/
		1535	# replace G<male|female> tags
		1536	|| s{G<([^>|]*)\|([^>]*)>}{
		1537	$self->gender ? $2 : $1
		1538	}ge
		1539	# replace H<hint text>
		1540	|| s{H<([^\>]*)>}
		1541	{
		1542	("<fg name=\"lightblue\">[$1 (Use hintmode to suppress hints)]</fg>",
		1543	"<fg name=\"lightblue\">[Hint suppressed, see hintmode]</fg>",
		1544	"")
		1545	[$self->{hintmode}]
		1546	}ge;
		1547
		1548	# create single paragraphs (very hackish)
		1549	s/(?<=\S)\n(?=\w)/ /g;
		1550
		1551	# compress some whitespace
		1552	s/\s+\n/\n/g; # ws line-ends
		1553	s/\n\n+/\n/g; # double lines
		1554	s/^\n+//; # beginning lines
		1555	s/\n+$//; # ending lines
		1556
		1557	$_
		1558	}
		1559
		1560	sub hintmode {
		1561	$_[0]{hintmode} = $_[1] if @_ > 1;
		1562	$_[0]{hintmode}
		1563	}
		1564
1138	=item $player->ext_reply ($msgid, %msg)	1565	=item $player->ext_reply ($msgid, @msg)
1139		1566
1140	Sends an ext reply to the player.	1567	Sends an ext reply to the player.
1141		1568
1142	=cut	1569	=cut
1143		1570
1144	sub ext_reply($$%) {	1571	sub ext_reply($$@) {
1145	my ($self, $id, %msg) = @_;	1572	my ($self, $id, @msg) = @_;
1146		1573
1147	$msg{msgid} = $id;	1574	$self->ns->ext_reply ($id, @msg)
1148
1149	$self->send ("ext " . cf::to_json \%msg);
1150	}	1575	}
1151		1576
1152	=item $player->ext_event ($type, %msg)	1577	=item $player->ext_msg ($type, @msg)
1153		1578
1154	Sends an ext event to the client.	1579	Sends an ext event to the client.
1155		1580
1156	=cut	1581	=cut
1157		1582
1158	sub ext_event($$%) {	1583	sub ext_msg($$@) {
1159	my ($self, $type, %msg) = @_;	1584	my ($self, $type, @msg) = @_;
1160		1585
1161	$self->ns->ext_event ($type, %msg);	1586	$self->ns->ext_msg ($type, @msg);
1162	}	1587	}
1163		1588
1164	=head3 cf::region	1589	=head3 cf::region
1165		1590
1166	=over 4	1591	=over 4
…		…
1169		1594
1170	package cf::region;	1595	package cf::region;
1171		1596
1172	=item cf::region::find_by_path $path	1597	=item cf::region::find_by_path $path
1173		1598
1174	Tries to decuce the probable region for a map knowing only its path.	1599	Tries to decuce the likely region for a map knowing only its path.
1175		1600
1176	=cut	1601	=cut
1177		1602
1178	sub find_by_path($) {	1603	sub find_by_path($) {
1179	my ($path) = @_;	1604	my ($path) = @_;
1180		1605
1181	my ($match, $specificity);	1606	my ($match, $specificity);
1182		1607
1183	for my $region (list) {	1608	for my $region (list) {
1184	if ($region->match && $path =~ $region->match) {	1609	if ($region->{match} && $path =~ $region->{match}) {
1185	($match, $specificity) = ($region, $region->specificity)	1610	($match, $specificity) = ($region, $region->specificity)
1186	if $region->specificity > $specificity;	1611	if $region->specificity > $specificity;
1187	}	1612	}
1188	}	1613	}
1189		1614
…		…
1253	my ($self, $merge) = @_;	1678	my ($self, $merge) = @_;
1254		1679
1255	# we have to keep some variables in memory intact	1680	# we have to keep some variables in memory intact
1256	local $self->{path};	1681	local $self->{path};
1257	local $self->{load_path};	1682	local $self->{load_path};
1258	local $self->{deny_save};
1259	local $self->{deny_reset};
1260		1683
1261	$self->SUPER::thawer_merge ($merge);	1684	$self->SUPER::thawer_merge ($merge);
1262	}	1685	}
1263		1686
1264	sub normalise {	1687	sub normalise {
…		…
1311	$self->init; # pass $1 etc.	1734	$self->init; # pass $1 etc.
1312	return $self;	1735	return $self;
1313	}	1736	}
1314	}	1737	}
1315		1738
1316	Carp::carp "unable to resolve path '$path' (base '$base').";	1739	Carp::cluck "unable to resolve path '$path' (base '$base').";
1317	()	1740	()
1318	}	1741	}
1319		1742
1320	sub init {	1743	sub init {
1321	my ($self) = @_;	1744	my ($self) = @_;
…		…
1336		1759
1337	# the original (read-only) location	1760	# the original (read-only) location
1338	sub load_path {	1761	sub load_path {
1339	my ($self) = @_;	1762	my ($self) = @_;
1340		1763
1341	sprintf "%s/%s/%s.map", cf::datadir, cf::mapdir, $self->{path}	1764	"$MAPDIR/$self->{path}.map"
1342	}	1765	}
1343		1766
1344	# the temporary/swap location	1767	# the temporary/swap location
1345	sub save_path {	1768	sub save_path {
1346	my ($self) = @_;	1769	my ($self) = @_;
1347		1770
1348	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;	1771	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1349	sprintf "%s/%s/%s.map", cf::localdir, cf::tmpdir, $path	1772	"$TMPDIR/$path.map"
1350	}	1773	}
1351		1774
1352	# the unique path, undef == no special unique path	1775	# the unique path, undef == no special unique path
1353	sub uniq_path {	1776	sub uniq_path {
1354	my ($self) = @_;	1777	my ($self) = @_;
1355		1778
1356	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;	1779	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1357	sprintf "%s/%s/%s", cf::localdir, cf::uniquedir, $path	1780	"$UNIQUEDIR/$path"
1358	}	1781	}
1359		1782
1360	# and all this just because we cannot iterate over	1783	# and all this just because we cannot iterate over
1361	# all maps in C++...	1784	# all maps in C++...
1362	sub change_all_map_light {	1785	sub change_all_map_light {
…		…
1364		1787
1365	$_->change_map_light ($change)	1788	$_->change_map_light ($change)
1366	for grep $_->outdoor, values %cf::MAP;	1789	for grep $_->outdoor, values %cf::MAP;
1367	}	1790	}
1368		1791
		1792	sub decay_objects {
		1793	my ($self) = @_;
		1794
		1795	return if $self->{deny_reset};
		1796
		1797	$self->do_decay_objects;
		1798	}
		1799
1369	sub unlink_save {	1800	sub unlink_save {
1370	my ($self) = @_;	1801	my ($self) = @_;
1371		1802
1372	utf8::encode (my $save = $self->save_path);	1803	utf8::encode (my $save = $self->save_path);
1373	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;	1804	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
…		…
1376		1807
1377	sub load_header_from($) {	1808	sub load_header_from($) {
1378	my ($self, $path) = @_;	1809	my ($self, $path) = @_;
1379		1810
1380	utf8::encode $path;	1811	utf8::encode $path;
1381	#aio_open $path, O_RDONLY, 0	1812	my $f = new_from_file cf::object::thawer $path
1382	# or return;
1383
1384	$self->_load_header ($path)
1385	or return;	1813	or return;
		1814
		1815	$self->_load_header ($f)
		1816	or return;
		1817
		1818	local $MAP_LOADING{$self->{path}} = $self;
		1819	$f->resolve_delayed_derefs;
1386		1820
1387	$self->{load_path} = $path;	1821	$self->{load_path} = $path;
1388		1822
1389	1	1823	1
1390	}	1824	}
…		…
1429	$self->load_header_orig	1863	$self->load_header_orig
1430	or return;	1864	or return;
1431	$self->prepare_orig;	1865	$self->prepare_orig;
1432	}	1866	}
1433		1867
		1868	$self->{deny_reset} = 1
		1869	if $self->no_reset;
		1870
1434	$self->default_region (cf::region::find_by_path $self->{path})	1871	$self->default_region (cf::region::find_by_path $self->{path})
1435	unless $self->default_region;	1872	unless $self->default_region;
1436		1873
1437	1	1874	1
1438	}	1875	}
…		…
1441	sub find {	1878	sub find {
1442	my ($path, $origin) = @_;	1879	my ($path, $origin) = @_;
1443		1880
1444	$path = normalise $path, $origin && $origin->path;	1881	$path = normalise $path, $origin && $origin->path;
1445		1882
		1883	cf::lock_wait "map_data:$path";#d#remove
1446	cf::lock_wait "map_find:$path";	1884	cf::lock_wait "map_find:$path";
1447		1885
1448	$cf::MAP{$path} || do {	1886	$cf::MAP{$path} || do {
1449	my $guard = cf::lock_acquire "map_find:$path";	1887	my $guard1 = cf::lock_acquire "map_find:$path";
		1888	my $guard2 = cf::lock_acquire "map_data:$path"; # just for the fun of it
		1889
1450	my $map = new_from_path cf::map $path	1890	my $map = new_from_path cf::map $path
1451	or return;	1891	or return;
1452		1892
1453	$map->{last_save} = $cf::RUNTIME;	1893	$map->{last_save} = $cf::RUNTIME;
1454		1894
1455	$map->load_header	1895	$map->load_header
1456	or return;	1896	or return;
1457		1897
1458	if ($map->should_reset && 0) {#d#TODO# disabled, crashy (locking issue?)	1898	if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
1459	# doing this can freeze the server in a sync job, obviously	1899	# doing this can freeze the server in a sync job, obviously
1460	#$cf::WAIT_FOR_TICK->wait;	1900	#$cf::WAIT_FOR_TICK->wait;
		1901	undef $guard1;
		1902	undef $guard2;
1461	$map->reset;	1903	$map->reset;
1462	undef $guard;
1463	return find $path;	1904	return find $path;
1464	}	1905	}
1465		1906
1466	$cf::MAP{$path} = $map	1907	$cf::MAP{$path} = $map
1467	}	1908	}
…		…
1474	my ($self) = @_;	1915	my ($self) = @_;
1475		1916
1476	local $self->{deny_reset} = 1; # loading can take a long time	1917	local $self->{deny_reset} = 1; # loading can take a long time
1477		1918
1478	my $path = $self->{path};	1919	my $path = $self->{path};
		1920
		1921	{
1479	my $guard = cf::lock_acquire "map_load:$path";	1922	my $guard = cf::lock_acquire "map_data:$path";
1480		1923
		1924	return unless $self->valid;
1481	return if $self->in_memory != cf::MAP_SWAPPED;	1925	return unless $self->in_memory == cf::MAP_SWAPPED;
1482		1926
1483	$self->in_memory (cf::MAP_LOADING);	1927	$self->in_memory (cf::MAP_LOADING);
1484		1928
1485	$self->alloc;	1929	$self->alloc;
1486		1930
1487	$self->pre_load;	1931	$self->pre_load;
1488	Coro::cede;	1932	cf::cede_to_tick;
1489		1933
1490	$self->_load_objects ($self->{load_path}, 1)	1934	my $f = new_from_file cf::object::thawer $self->{load_path};
		1935	$f->skip_block;
		1936	$self->_load_objects ($f)
1491	or return;	1937	or return;
1492		1938
1493	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)	1939	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
1494	if delete $self->{load_original};	1940	if delete $self->{load_original};
1495		1941
1496	if (my $uniq = $self->uniq_path) {	1942	if (my $uniq = $self->uniq_path) {
1497	utf8::encode $uniq;	1943	utf8::encode $uniq;
1498	if (aio_open $uniq, O_RDONLY, 0) {	1944	unless (aio_stat $uniq) {
		1945	if (my $f = new_from_file cf::object::thawer $uniq) {
1499	$self->clear_unique_items;	1946	$self->clear_unique_items;
1500	$self->_load_objects ($uniq, 0);	1947	$self->_load_objects ($f);
		1948	$f->resolve_delayed_derefs;
		1949	}
1501	}	1950	}
1502	}	1951	}
1503		1952
1504	Coro::cede;	1953	$f->resolve_delayed_derefs;
		1954
		1955	cf::cede_to_tick;
1505	# now do the right thing for maps	1956	# now do the right thing for maps
1506	$self->link_multipart_objects;	1957	$self->link_multipart_objects;
1507	Coro::cede;
1508
1509	unless ($self->{deny_activate}) {
1510	$self->decay_objects;
1511	$self->fix_auto_apply;
1512	$self->update_buttons;
1513	Coro::cede;
1514	$self->set_darkness_map;
1515	$self->difficulty ($self->estimate_difficulty)	1958	$self->difficulty ($self->estimate_difficulty)
1516	unless $self->difficulty;	1959	unless $self->difficulty;
1517	Coro::cede;	1960	cf::cede_to_tick;
		1961
		1962	unless ($self->{deny_activate}) {
		1963	$self->decay_objects;
		1964	$self->fix_auto_apply;
		1965	$self->update_buttons;
		1966	cf::cede_to_tick;
		1967	$self->set_darkness_map;
		1968	cf::cede_to_tick;
1518	$self->activate;	1969	$self->activate;
1519	Coro::cede;	1970	}
		1971
		1972	$self->{last_save} = $cf::RUNTIME;
		1973	$self->last_access ($cf::RUNTIME);
		1974
		1975	$self->in_memory (cf::MAP_IN_MEMORY);
1520	}	1976	}
1521		1977
1522	$self->post_load;	1978	$self->post_load;
1523	Coro::cede;
1524
1525	$self->in_memory (cf::MAP_IN_MEMORY);
1526	}	1979	}
1527		1980
1528	sub customise_for {	1981	sub customise_for {
1529	my ($self, $ob) = @_;	1982	my ($self, $ob) = @_;
1530		1983
1531	return find "~" . $ob->name . "/" . $self->{path}	1984	return find "~" . $ob->name . "/" . $self->{path}
1532	if $self->per_player;	1985	if $self->per_player;
1533		1986
		1987	# return find "?party/" . $ob->name . "/" . $self->{path}
		1988	# if $self->per_party;
		1989
1534	$self	1990	$self
1535	}	1991	}
1536		1992
1537	# find and load all maps in the 3x3 area around a map	1993	# find and load all maps in the 3x3 area around a map
1538	sub load_diag {	1994	sub load_neighbours {
1539	my ($map) = @_;	1995	my ($map) = @_;
1540		1996
1541	my @diag; # diagonal neighbours	1997	my @neigh; # diagonal neighbours
1542		1998
1543	for (0 .. 3) {	1999	for (0 .. 3) {
1544	my $neigh = $map->tile_path ($_)	2000	my $neigh = $map->tile_path ($_)
1545	or next;	2001	or next;
1546	$neigh = find $neigh, $map	2002	$neigh = find $neigh, $map
1547	or next;	2003	or next;
1548	$neigh->load;	2004	$neigh->load;
1549		2005
		2006	push @neigh,
1550	push @diag, [$neigh->tile_path (($_ + 3) % 4), $neigh],	2007	[$neigh->tile_path (($_ + 3) % 4), $neigh],
1551	[$neigh->tile_path (($_ + 1) % 4), $neigh];	2008	[$neigh->tile_path (($_ + 1) % 4), $neigh];
1552	}	2009	}
1553		2010
1554	for (@diag) {	2011	for (grep defined $_->[0], @neigh) {
		2012	my ($path, $origin) = @$_;
1555	my $neigh = find @$_	2013	my $neigh = find $path, $origin
1556	or next;	2014	or next;
1557	$neigh->load;	2015	$neigh->load;
1558	}	2016	}
1559	}	2017	}
1560		2018
…		…
1565	}	2023	}
1566		2024
1567	sub do_load_sync {	2025	sub do_load_sync {
1568	my ($map) = @_;	2026	my ($map) = @_;
1569		2027
		2028	cf::LOG cf::llevDebug | cf::logBacktrace, "do_load_sync"
		2029	if $Coro::current == $Coro::main;
		2030
1570	cf::sync_job { $map->load };	2031	cf::sync_job { $map->load };
1571	}	2032	}
1572		2033
1573	our %MAP_PREFETCH;	2034	our %MAP_PREFETCH;
1574	our $MAP_PREFETCHER = undef;	2035	our $MAP_PREFETCHER = undef;
1575		2036
1576	sub find_async {	2037	sub find_async {
1577	my ($path, $origin) = @_;	2038	my ($path, $origin, $load) = @_;
1578		2039
1579	$path = normalise $path, $origin && $origin->{path};	2040	$path = normalise $path, $origin && $origin->{path};
1580		2041
1581	if (my $map = $cf::MAP{$path}) {	2042	if (my $map = $cf::MAP{$path}) {
1582	return $map if $map->in_memory == cf::MAP_IN_MEMORY;	2043	return $map if !$load || $map->in_memory == cf::MAP_IN_MEMORY;
1583	}	2044	}
1584		2045
1585	undef $MAP_PREFETCH{$path};	2046	$MAP_PREFETCH{$path} |= $load;
		2047
1586	$MAP_PREFETCHER ||= cf::async {	2048	$MAP_PREFETCHER ||= cf::async {
1587	while (%MAP_PREFETCH) {	2049	while (%MAP_PREFETCH) {
1588	for my $path (keys %MAP_PREFETCH) {	2050	while (my ($k, $v) = each %MAP_PREFETCH) {
1589	my $map = find $path	2051	if (my $map = find $k) {
1590	or next;
1591	$map->load;	2052	$map->load if $v;
		2053	}
1592		2054
1593	delete $MAP_PREFETCH{$path};	2055	delete $MAP_PREFETCH{$k};
1594	}	2056	}
1595	}	2057	}
1596	undef $MAP_PREFETCHER;	2058	undef $MAP_PREFETCHER;
1597	};	2059	};
1598	$MAP_PREFETCHER->prio (6);	2060	$MAP_PREFETCHER->prio (6);
…		…
1601	}	2063	}
1602		2064
1603	sub save {	2065	sub save {
1604	my ($self) = @_;	2066	my ($self) = @_;
1605		2067
1606	my $lock = cf::lock_acquire "map_data:" . $self->path;	2068	my $lock = cf::lock_acquire "map_data:$self->{path}";
1607		2069
1608	$self->{last_save} = $cf::RUNTIME;	2070	$self->{last_save} = $cf::RUNTIME;
1609		2071
1610	return unless $self->dirty;	2072	return unless $self->dirty;
1611		2073
…		…
1634	my ($self) = @_;	2096	my ($self) = @_;
1635		2097
1636	# save first because save cedes	2098	# save first because save cedes
1637	$self->save;	2099	$self->save;
1638		2100
1639	my $lock = cf::lock_acquire "map_data:" . $self->path;	2101	my $lock = cf::lock_acquire "map_data:$self->{path}";
1640		2102
1641	return if $self->players;	2103	return if $self->players;
1642	return if $self->in_memory != cf::MAP_IN_MEMORY;	2104	return if $self->in_memory != cf::MAP_IN_MEMORY;
1643	return if $self->{deny_save};	2105	return if $self->{deny_save};
1644		2106
		2107	$self->in_memory (cf::MAP_SWAPPED);
		2108
		2109	$self->deactivate;
		2110	$_->clear_links_to ($self) for values %cf::MAP;
1645	$self->clear;	2111	$self->clear;
1646	$self->in_memory (cf::MAP_SWAPPED);
1647	}	2112	}
1648		2113
1649	sub reset_at {	2114	sub reset_at {
1650	my ($self) = @_;	2115	my ($self) = @_;
1651		2116
1652	# TODO: safety, remove and allow resettable per-player maps	2117	# TODO: safety, remove and allow resettable per-player maps
1653	return 1e99 if $self->isa ("ext::map_per_player");#d#
1654	return 1e99 if $self->{deny_reset};	2118	return 1e99 if $self->{deny_reset};
1655		2119
1656	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;	2120	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
1657	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;	2121	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
1658		2122
…		…
1669	my ($self) = @_;	2133	my ($self) = @_;
1670		2134
1671	my $lock = cf::lock_acquire "map_data:$self->{path}";	2135	my $lock = cf::lock_acquire "map_data:$self->{path}";
1672		2136
1673	return if $self->players;	2137	return if $self->players;
1674	return if $self->isa ("ext::map_per_player");#d#
1675		2138
1676	warn "resetting map ", $self->path;#d#	2139	warn "resetting map ", $self->path;
1677		2140
1678	$self->in_memory (cf::MAP_SWAPPED);	2141	$self->in_memory (cf::MAP_SWAPPED);
1679		2142
1680	# need to save uniques path	2143	# need to save uniques path
1681	unless ($self->{deny_save}) {	2144	unless ($self->{deny_save}) {
…		…
1685	if $uniq;	2148	if $uniq;
1686	}	2149	}
1687		2150
1688	delete $cf::MAP{$self->path};	2151	delete $cf::MAP{$self->path};
1689		2152
		2153	$self->deactivate;
		2154	$_->clear_links_to ($self) for values %cf::MAP;
1690	$self->clear;	2155	$self->clear;
1691
1692	$_->clear_links_to ($self) for values %cf::MAP;
1693		2156
1694	$self->unlink_save;	2157	$self->unlink_save;
1695	$self->destroy;	2158	$self->destroy;
1696	}	2159	}
1697		2160
1698	my $nuke_counter = "aaaa";	2161	my $nuke_counter = "aaaa";
1699		2162
1700	sub nuke {	2163	sub nuke {
1701	my ($self) = @_;	2164	my ($self) = @_;
1702		2165
		2166	{
		2167	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2168
1703	delete $cf::MAP{$self->path};	2169	delete $cf::MAP{$self->path};
1704		2170
1705	$self->unlink_save;	2171	$self->unlink_save;
1706		2172
1707	bless $self, "cf::map";	2173	bless $self, "cf::map";
1708	delete $self->{deny_reset};	2174	delete $self->{deny_reset};
1709	$self->{deny_save} = 1;	2175	$self->{deny_save} = 1;
1710	$self->reset_timeout (1);	2176	$self->reset_timeout (1);
1711	$self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));	2177	$self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));
1712		2178
1713	$cf::MAP{$self->path} = $self;	2179	$cf::MAP{$self->path} = $self;
		2180	}
1714		2181
1715	$self->reset; # polite request, might not happen	2182	$self->reset; # polite request, might not happen
		2183	}
		2184
		2185	=item $maps = cf::map::tmp_maps
		2186
		2187	Returns an arrayref with all map paths of currently instantiated and saved
		2188	maps. May block.
		2189
		2190	=cut
		2191
		2192	sub tmp_maps() {
		2193	[
		2194	map {
		2195	utf8::decode $_;
		2196	/\.map$/
		2197	? normalise $_
		2198	: ()
		2199	} @{ aio_readdir $TMPDIR or [] }
		2200	]
		2201	}
		2202
		2203	=item $maps = cf::map::random_maps
		2204
		2205	Returns an arrayref with all map paths of currently instantiated and saved
		2206	random maps. May block.
		2207
		2208	=cut
		2209
		2210	sub random_maps() {
		2211	[
		2212	map {
		2213	utf8::decode $_;
		2214	/\.map$/
		2215	? normalise "?random/$_"
		2216	: ()
		2217	} @{ aio_readdir $RANDOMDIR or [] }
		2218	]
1716	}	2219	}
1717		2220
1718	=item cf::map::unique_maps	2221	=item cf::map::unique_maps
1719		2222
1720	Returns an arrayref of paths of all shared maps that have	2223	Returns an arrayref of paths of all shared maps that have
1721	instantiated unique items. May block.	2224	instantiated unique items. May block.
1722		2225
1723	=cut	2226	=cut
1724		2227
1725	sub unique_maps() {	2228	sub unique_maps() {
1726	my $files = aio_readdir cf::localdir . "/" . cf::uniquedir	2229	[
1727	or return;	2230	map {
1728
1729	my @paths;
1730
1731	for (@$files) {
1732	utf8::decode $_;	2231	utf8::decode $_;
1733	next if /\.pst$/;	2232	/\.map$/
1734	next unless /^$PATH_SEP/o;	2233	? normalise $_
1735		2234	: ()
1736	push @paths, cf::map::normalise $_;	2235	} @{ aio_readdir $UNIQUEDIR or [] }
1737	}	2236	]
1738
1739	\@paths
1740	}	2237	}
1741		2238
1742	package cf;	2239	package cf;
1743		2240
1744	=back	2241	=back
…		…
1762	map { $_, inv_recursive_ $_->inv } @_	2259	map { $_, inv_recursive_ $_->inv } @_
1763	}	2260	}
1764		2261
1765	sub inv_recursive {	2262	sub inv_recursive {
1766	inv_recursive_ inv $_[0]	2263	inv_recursive_ inv $_[0]
		2264	}
		2265
		2266	=item $ref = $ob->ref
		2267
		2268	creates and returns a persistent reference to an objetc that can be stored as a string.
		2269
		2270	=item $ob = cf::object::deref ($refstring)
		2271
		2272	returns the objetc referenced by refstring. may return undef when it cnanot find the object,
		2273	even if the object actually exists. May block.
		2274
		2275	=cut
		2276
		2277	sub deref {
		2278	my ($ref) = @_;
		2279
		2280	# temporary compatibility#TODO#remove
		2281	$ref =~ s{^<}{player/<};
		2282
		2283	if ($ref =~ m{^player\/(<1\.\d+>)/(.*)$}) {
		2284	my ($uuid, $name) = ($1, $2);
		2285	my $pl = $cf::PLAYER_LOADING{$name} || cf::player::find $name
		2286	or return;
		2287	$pl->ob->uuid eq $uuid
		2288	or return;
		2289
		2290	$pl->ob
		2291	} else {
		2292	warn "$ref: cannot resolve object reference\n";
		2293	undef
		2294	}
1767	}	2295	}
1768		2296
1769	package cf;	2297	package cf;
1770		2298
1771	=back	2299	=back
…		…
1790		2318
1791	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	2319	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
1792		2320
1793	if ($self->{record_replies}) {	2321	if ($self->{record_replies}) {
1794	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2322	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2323
1795	} else {	2324	} else {
		2325	my $pl = $self->contr;
		2326
		2327	if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
		2328	my $dialog = $pl->{npc_dialog};
		2329	$dialog->{pl}->ext_msg ($dialog->{id}, update => msg => $dialog->{pl}->expand_cfpod ($msg));
		2330
		2331	} else {
1796	$msg = $npc->name . " says: $msg" if $npc;	2332	$msg = $npc->name . " says: $msg" if $npc;
1797	$self->message ($msg, $flags);	2333	$self->message ($msg, $flags);
		2334	}
1798	}	2335	}
		2336	}
		2337
		2338	=item $object->send_msg ($channel, $msg, $color, [extra...])
		2339
		2340	=cut
		2341
		2342	sub cf::object::send_msg {
		2343	my $pl = shift->contr
		2344	or return;
		2345	$pl->send_msg (@_);
1799	}	2346	}
1800		2347
1801	=item $player_object->may ("access")	2348	=item $player_object->may ("access")
1802		2349
1803	Returns wether the given player is authorized to access resource "access"	2350	Returns wether the given player is authorized to access resource "access"
…		…
1850	$self->deactivate_recursive;	2397	$self->deactivate_recursive;
1851		2398
1852	return if UNIVERSAL::isa $self->map, "ext::map_link";	2399	return if UNIVERSAL::isa $self->map, "ext::map_link";
1853		2400
1854	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]	2401	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
1855	if $self->map;	2402	if $self->map && $self->map->{path} ne "{link}";
1856		2403
1857	$self->enter_map ($LINK_MAP || link_map, 10, 10);	2404	$self->enter_map ($LINK_MAP || link_map, 10, 10);
1858	}	2405	}
1859		2406
1860	sub cf::object::player::leave_link {	2407	sub cf::object::player::leave_link {
1861	my ($self, $map, $x, $y) = @_;	2408	my ($self, $map, $x, $y) = @_;
		2409
		2410	return unless $self->contr->active;
1862		2411
1863	my $link_pos = delete $self->{_link_pos};	2412	my $link_pos = delete $self->{_link_pos};
1864		2413
1865	unless ($map) {	2414	unless ($map) {
1866	# restore original map position	2415	# restore original map position
…		…
1880	# use -1 or undef as default coordinates, not 0, 0	2429	# use -1 or undef as default coordinates, not 0, 0
1881	($x, $y) = ($map->enter_x, $map->enter_y)	2430	($x, $y) = ($map->enter_x, $map->enter_y)
1882	if $x <=0 && $y <= 0;	2431	if $x <=0 && $y <= 0;
1883		2432
1884	$map->load;	2433	$map->load;
1885	$map->load_diag;	2434	$map->load_neighbours;
1886		2435
1887	return unless $self->contr->active;	2436	return unless $self->contr->active;
1888	$self->activate_recursive;	2437	$self->activate_recursive;
1889		2438
1890	local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext	2439	local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
1891	$self->enter_map ($map, $x, $y);	2440	$self->enter_map ($map, $x, $y);
1892	}	2441	}
1893		2442
1894	cf::player->attach (	2443	=item $player_object->goto ($path, $x, $y[, $check->($map)[, $done->()]])
1895	on_logout => sub {
1896	my ($pl) = @_;
1897		2444
1898	# abort map switching before logout	2445	Moves the player to the given map-path and coordinates by first freezing
1899	if ($pl->ob->{_link_pos}) {	2446	her, loading and preparing them map, calling the provided $check callback
1900	cf::sync_job {	2447	that has to return the map if sucecssful, and then unfreezes the player on
1901	$pl->ob->leave_link	2448	the new (success) or old (failed) map position. In either case, $done will
1902	};	2449	be called at the end of this process.
1903	}
1904	},
1905	on_login => sub {
1906	my ($pl) = @_;
1907		2450
1908	# try to abort aborted map switching on player login :)
1909	# should happen only on crashes
1910	if ($pl->ob->{_link_pos}) {
1911	$pl->ob->enter_link;
1912	(async {
1913	$pl->ob->reply (undef,
1914	"There was an internal problem at your last logout, "
1915	. "the server will try to bring you to your intended destination in a second.",
1916	cf::NDI_RED);
1917	# we need this sleep as the login has a concurrent enter_exit running
1918	# and this sleep increases chances of the player not ending up in scorn
1919	Coro::Timer::sleep 1;
1920	$pl->ob->leave_link;
1921	})->prio (2);
1922	}
1923	},
1924	);
1925
1926	=item $player_object->goto ($path, $x, $y)
1927
1928	=cut	2451	=cut
		2452
		2453	our $GOTOGEN;
1929		2454
1930	sub cf::object::player::goto {	2455	sub cf::object::player::goto {
1931	my ($self, $path, $x, $y) = @_;	2456	my ($self, $path, $x, $y, $check, $done) = @_;
		2457
		2458	# do generation counting so two concurrent goto's will be executed in-order
		2459	my $gen = $self->{_goto_generation} = ++$GOTOGEN;
1932		2460
1933	$self->enter_link;	2461	$self->enter_link;
1934		2462
1935	(async {	2463	(async {
		2464	# *tag paths override both path and x|y
		2465	if ($path =~ /^\*(.*)$/) {
		2466	if (my @obs = grep $_->map, ext::map_tags::find $1) {
		2467	my $ob = $obs[rand @obs];
		2468
		2469	# see if we actually can go there
		2470	if (@obs = grep !$self->blocked ($_->map, $_->x, $_->y), $ob, $ob->tail) {
		2471	$ob = $obs[rand @obs];
		2472	} else {
		2473	$self->message ("Wow, it's pretty crowded in there.", cf::NDI_UNIQUE | cf::NDI_RED);
		2474	}
		2475	# else put us there anyways for now #d#
		2476
		2477	($path, $x, $y) = ($ob->map, $ob->x, $ob->y);
		2478	} else {
		2479	($path, $x, $y) = (undef, undef, undef);
		2480	}
		2481	}
		2482
1936	my $map = eval {	2483	my $map = eval {
1937	my $map = cf::map::find $path;	2484	my $map = defined $path ? cf::map::find $path : undef;
		2485
		2486	if ($map) {
1938	$map = $map->customise_for ($self) if $map;	2487	$map = $map->customise_for ($self);
		2488	$map = $check->($map) if $check && $map;
		2489	} else {
		2490	$self->message ("The exit to '$path' is closed.", cf::NDI_UNIQUE | cf::NDI_RED);
		2491	}
		2492
1939	$map	2493	$map
		2494	};
		2495
		2496	if ($@) {
		2497	$self->message ("Something went wrong within the server, please report this incident!", cf::NDI_UNIQUE | cf::NDI_RED);
		2498	LOG llevError | logBacktrace, Carp::longmess $@;
1940	} or	2499	}
1941	$self->message ("The exit to '$path' is closed", cf::NDI_UNIQUE | cf::NDI_RED);
1942		2500
		2501	if ($gen == $self->{_goto_generation}) {
		2502	delete $self->{_goto_generation};
1943	$self->leave_link ($map, $x, $y);	2503	$self->leave_link ($map, $x, $y);
		2504	}
		2505
		2506	$done->() if $done;
1944	})->prio (1);	2507	})->prio (1);
1945	}	2508	}
1946		2509
1947	=item $player_object->enter_exit ($exit_object)	2510	=item $player_object->enter_exit ($exit_object)
1948		2511
…		…
1987		2550
1988	$rmp->{random_seed} ||= $exit->random_seed;	2551	$rmp->{random_seed} ||= $exit->random_seed;
1989		2552
1990	my $data = cf::to_json $rmp;	2553	my $data = cf::to_json $rmp;
1991	my $md5 = Digest::MD5::md5_hex $data;	2554	my $md5 = Digest::MD5::md5_hex $data;
1992	my $meta = "$cf::RANDOM_MAPS/$md5.meta";	2555	my $meta = "$RANDOMDIR/$md5.meta";
1993		2556
1994	if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {	2557	if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {
1995	aio_write $fh, 0, (length $data), $data, 0;	2558	aio_write $fh, 0, (length $data), $data, 0;
1996	undef $fh;	2559	undef $fh;
1997	aio_rename "$meta~", $meta;	2560	aio_rename "$meta~", $meta;
…		…
2016	my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;	2579	my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;
2017	my $hp = $exit->stats->hp;	2580	my $hp = $exit->stats->hp;
2018	my $sp = $exit->stats->sp;	2581	my $sp = $exit->stats->sp;
2019		2582
2020	$self->enter_link;	2583	$self->enter_link;
		2584
		2585	# if exit is damned, update players death & WoR home-position
		2586	$self->contr->savebed ($slaying, $hp, $sp)
		2587	if $exit->flag (FLAG_DAMNED);
2021		2588
2022	(async {	2589	(async {
2023	$self->deactivate_recursive; # just to be sure	2590	$self->deactivate_recursive; # just to be sure
2024	unless (eval {	2591	unless (eval {
2025	$self->goto ($slaying, $hp, $sp);	2592	$self->goto ($slaying, $hp, $sp);
…		…
2053		2620
2054	utf8::encode $text;	2621	utf8::encode $text;
2055	$self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);	2622	$self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);
2056	}	2623	}
2057		2624
		2625	=item $client->send_msg ($channel, $msg, $color, [extra...])
		2626
		2627	Send a drawinfo or msg packet to the client, formatting the msg for the
		2628	client if neccessary. C<$type> should be a string identifying the type of
		2629	the message, with C<log> being the default. If C<$color> is negative, suppress
		2630	the message unless the client supports the msg packet.
		2631
		2632	=cut
		2633
		2634	our %CHANNEL = (
		2635	"c/identify" => {
		2636	id => "identify",
		2637	title => "Identify",
		2638	reply => undef,
		2639	tooltip => "Items recently identified",
		2640	},
		2641	"c/examine" => {
		2642	id => "examine",
		2643	title => "Examine",
		2644	reply => undef,
		2645	tooltip => "Signs and other items you examined",
		2646	},
		2647	);
		2648
		2649	sub cf::client::send_msg {
		2650	my ($self, $channel, $msg, $color, @extra) = @_;
		2651
		2652	$msg = $self->pl->expand_cfpod ($msg);
		2653
		2654	$color &= cf::NDI_CLIENT_MASK; # just in case...
		2655
		2656	# check predefined channels, for the benefit of C
		2657	$channel = $CHANNEL{$channel} if $CHANNEL{$channel};
		2658
		2659	if (ref $channel) {
		2660	# send meta info to client, if not yet sent
		2661	unless (exists $self->{channel}{$channel->{id}}) {
		2662	$self->{channel}{$channel->{id}} = $channel;
		2663	$self->ext_msg (channel_info => $channel)
		2664	if $self->can_msg;
		2665	}
		2666
		2667	$channel = $channel->{id};
		2668	}
		2669
		2670	return unless @extra || length $msg;
		2671
		2672	if ($self->can_msg) {
		2673	# default colour, mask it out
		2674	$color &= ~(cf::NDI_COLOR_MASK | cf::NDI_DEF)
		2675	if $color & cf::NDI_DEF;
		2676
		2677	$self->send_packet ("msg " . $self->{json_coder}->encode (
		2678	[$color & cf::NDI_CLIENT_MASK, $channel, $msg, @extra]));
		2679	} else {
		2680	if ($color >= 0) {
		2681	# replace some tags by gcfclient-compatible ones
		2682	for ($msg) {
		2683	1 while
		2684	s/<b>([^<]*)<\/b>/[b]${1}[\/b]/
		2685	|| s/<i>([^<]*)<\/i>/[i]${1}[\/i]/
		2686	|| s/<u>([^<]*)<\/u>/[ul]${1}[\/ul]/
		2687	|| s/<tt>([^<]*)<\/tt>/[fixed]${1}[\/fixed]/
		2688	|| s/<fg name=\"([^"]+)\">([^<]*)<\/fg>/[color=$1]${2}[\/color]/;
		2689	}
		2690
		2691	$color &= cf::NDI_COLOR_MASK;
		2692
		2693	utf8::encode $msg;
		2694
		2695	if (0 && $msg =~ /\[/) {
		2696	# COMMAND/INFO
		2697	$self->send_packet ("drawextinfo $color 10 8 $msg")
		2698	} else {
		2699	$msg =~ s/\[\/?(?:b|i|u|fixed|color)[^\]]*\]//g;
		2700	$self->send_packet ("drawinfo $color $msg")
		2701	}
		2702	}
		2703	}
		2704	}
		2705
2058	=item $client->ext_event ($type, %msg)	2706	=item $client->ext_msg ($type, @msg)
2059		2707
2060	Sends an exti event to the client.	2708	Sends an ext event to the client.
2061		2709
2062	=cut	2710	=cut
2063		2711
2064	sub cf::client::ext_event($$%) {	2712	sub cf::client::ext_msg($$@) {
2065	my ($self, $type, %msg) = @_;	2713	my ($self, $type, @msg) = @_;
2066		2714
		2715	if ($self->extcmd == 2) {
		2716	$self->send_packet ("ext " . $self->{json_coder}->encode ([$type, @msg]));
		2717	} elsif ($self->extcmd == 1) { # TODO: remove
2067	$msg{msgtype} = "event_$type";	2718	push @msg, msgtype => "event_$type";
2068	$self->send_packet ("ext " . cf::to_json \%msg);	2719	$self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
		2720	}
		2721	}
		2722
		2723	=item $client->ext_reply ($msgid, @msg)
		2724
		2725	Sends an ext reply to the client.
		2726
		2727	=cut
		2728
		2729	sub cf::client::ext_reply($$@) {
		2730	my ($self, $id, @msg) = @_;
		2731
		2732	if ($self->extcmd == 2) {
		2733	$self->send_packet ("ext " . $self->{json_coder}->encode (["reply-$id", @msg]));
		2734	} elsif ($self->extcmd == 1) {
		2735	#TODO: version 1, remove
		2736	unshift @msg, msgtype => "reply", msgid => $id;
		2737	$self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
		2738	}
2069	}	2739	}
2070		2740
2071	=item $success = $client->query ($flags, "text", \&cb)	2741	=item $success = $client->query ($flags, "text", \&cb)
2072		2742
2073	Queues a query to the client, calling the given callback with	2743	Queues a query to the client, calling the given callback with
2074	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,	2744	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
2075	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.	2745	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
2076		2746
2077	Queries can fail, so check the return code. Or don't, as queries will become	2747	Queries can fail, so check the return code. Or don't, as queries will
2078	reliable at some point in the future.	2748	become reliable at some point in the future.
2079		2749
2080	=cut	2750	=cut
2081		2751
2082	sub cf::client::query {	2752	sub cf::client::query {
2083	my ($self, $flags, $text, $cb) = @_;	2753	my ($self, $flags, $text, $cb) = @_;
…		…
2091	utf8::encode $text;	2761	utf8::encode $text;
2092	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];	2762	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
2093		2763
2094	$self->send_packet ($self->{query_queue}[0][0])	2764	$self->send_packet ($self->{query_queue}[0][0])
2095	if @{ $self->{query_queue} } == 1;	2765	if @{ $self->{query_queue} } == 1;
		2766
		2767	1
2096	}	2768	}
2097		2769
2098	cf::client->attach (	2770	cf::client->attach (
		2771	on_connect => sub {
		2772	my ($ns) = @_;
		2773
		2774	$ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
		2775	},
2099	on_reply => sub {	2776	on_reply => sub {
2100	my ($ns, $msg) = @_;	2777	my ($ns, $msg) = @_;
2101		2778
2102	# this weird shuffling is so that direct followup queries	2779	# this weird shuffling is so that direct followup queries
2103	# get handled first	2780	# get handled first
…		…
2115	} else {	2792	} else {
2116	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;	2793	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2117	}	2794	}
2118	}	2795	}
2119	},	2796	},
		2797	on_exticmd => sub {
		2798	my ($ns, $buf) = @_;
		2799
		2800	my $msg = eval { $ns->{json_coder}->decode ($buf) };
		2801
		2802	if (ref $msg) {
		2803	my ($type, $reply, @payload) =
		2804	"ARRAY" eq ref $msg
		2805	? @$msg
		2806	: ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
		2807
		2808	my @reply;
		2809
		2810	if (my $cb = $EXTICMD{$type}) {
		2811	@reply = $cb->($ns, @payload);
		2812	}
		2813
		2814	$ns->ext_reply ($reply, @reply)
		2815	if $reply;
		2816
		2817	} else {
		2818	warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
		2819	}
		2820
		2821	cf::override;
		2822	},
2120	);	2823	);
2121		2824
2122	=item $client->async (\&cb)	2825	=item $client->async (\&cb)
2123		2826
2124	Create a new coroutine, running the specified callback. The coroutine will	2827	Create a new coroutine, running the specified callback. The coroutine will
…		…
2165	our $safe = new Safe "safe";	2868	our $safe = new Safe "safe";
2166	our $safe_hole = new Safe::Hole;	2869	our $safe_hole = new Safe::Hole;
2167		2870
2168	$SIG{FPE} = 'IGNORE';	2871	$SIG{FPE} = 'IGNORE';
2169		2872
2170	$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));	2873	$safe->permit_only (Opcode::opset qw(
		2874	:base_core :base_mem :base_orig :base_math
		2875	grepstart grepwhile mapstart mapwhile
		2876	sort time
		2877	));
2171		2878
2172	# here we export the classes and methods available to script code	2879	# here we export the classes and methods available to script code
2173		2880
2174	=pod	2881	=pod
2175		2882
2176	The following functions and methods are available within a safe environment:	2883	The following functions and methods are available within a safe environment:
2177		2884
2178	cf::object contr pay_amount pay_player map	2885	cf::object
		2886	contr pay_amount pay_player map x y force_find force_add
		2887	insert remove name archname title slaying race decrease_ob_nr
		2888
2179	cf::object::player player	2889	cf::object::player
2180	cf::player peaceful	2890	player
2181	cf::map trigger	2891
		2892	cf::player
		2893	peaceful
		2894
		2895	cf::map
		2896	trigger
2182		2897
2183	=cut	2898	=cut
2184		2899
2185	for (	2900	for (
2186	["cf::object" => qw(contr pay_amount pay_player map)],	2901	["cf::object" => qw(contr pay_amount pay_player map force_find force_add x y
		2902	insert remove inv name archname title slaying race
		2903	decrease_ob_nr)],
2187	["cf::object::player" => qw(player)],	2904	["cf::object::player" => qw(player)],
2188	["cf::player" => qw(peaceful)],	2905	["cf::player" => qw(peaceful)],
2189	["cf::map" => qw(trigger)],	2906	["cf::map" => qw(trigger)],
2190	) {	2907	) {
2191	no strict 'refs';	2908	no strict 'refs';
…		…
2262	=back	2979	=back
2263		2980
2264	=cut	2981	=cut
2265		2982
2266	#############################################################################	2983	#############################################################################
2267
2268	=head2 EXTENSION DATABASE SUPPORT
2269
2270	Crossfire maintains a very simple database for extension use. It can
2271	currently store binary data only (use Compress::LZF::sfreeze_cr/sthaw to
2272	convert to/from binary).
2273
2274	The parameter C<$family> should best start with the name of the extension
2275	using it, it should be unique.
2276
2277	=over 4
2278
2279	=item $value = cf::db_get $family => $key
2280
2281	Returns a single value from the database.
2282
2283	=item cf::db_put $family => $key => $value
2284
2285	Stores the given C<$value> in the family.
2286
2287	=cut
2288
2289	our $DB;
2290
2291	sub db_init {
2292	unless ($DB) {
2293	$DB = BDB::db_create $DB_ENV;
2294
2295	cf::sync_job {
2296	eval {
2297	$DB->set_flags (BDB::CHKSUM);
2298
2299	BDB::db_open $DB, undef, "db", undef, BDB::BTREE,
2300	BDB::CREATE | BDB::AUTO_COMMIT, 0666;
2301	cf::cleanup "db_open(db): $!" if $!;
2302	};
2303	cf::cleanup "db_open(db): $@" if $@;
2304	};
2305	}
2306	}
2307
2308	sub db_get($$) {
2309	my $key = "$_[0]/$_[1]";
2310
2311	cf::sync_job {
2312	BDB::db_get $DB, undef, $key, my $data;
2313
2314	$! ? ()
2315	: $data
2316	}
2317	}
2318
2319	sub db_put($$$) {
2320	BDB::dbreq_pri 4;
2321	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
2322	}
2323
2324	=item cf::cache $id => [$paths...], $processversion => $process
2325
2326	Generic caching function that returns the value of the resource $id,
2327	caching and regenerating as required.
2328
2329	This function can block.
2330
2331	=cut
2332
2333	sub cache {
2334	my ($id, $src, $processversion, $process) = @_;
2335
2336	my $meta =
2337	join "\x00",
2338	$processversion,
2339	map {
2340	aio_stat $_
2341	and Carp::croak "$_: $!";
2342
2343	($_, (stat _)[7,9])
2344	} @$src;
2345
2346	my $dbmeta = db_get cache => "$id/meta";
2347	if ($dbmeta ne $meta) {
2348	# changed, we may need to process
2349
2350	my @data;
2351	my $md5;
2352
2353	for (0 .. $#$src) {
2354	0 <= aio_load $src->[$_], $data[$_]
2355	or Carp::croak "$src->[$_]: $!";
2356	}
2357
2358	# if processing is expensive, check
2359	# checksum first
2360	if (1) {
2361	$md5 =
2362	join "\x00",
2363	$processversion,
2364	map {
2365	Coro::cede;
2366	($src->[$_], Digest::MD5::md5_hex $data[$_])
2367	} 0.. $#$src;
2368
2369
2370	my $dbmd5 = db_get cache => "$id/md5";
2371	if ($dbmd5 eq $md5) {
2372	db_put cache => "$id/meta", $meta;
2373
2374	return db_get cache => "$id/data";
2375	}
2376	}
2377
2378	my $data = $process->(\@data);
2379
2380	db_put cache => "$id/data", $data;
2381	db_put cache => "$id/md5" , $md5;
2382	db_put cache => "$id/meta", $meta;
2383
2384	return $data;
2385	}
2386
2387	db_get cache => "$id/data"
2388	}
2389
2390	=item fork_call { }, $args
2391
2392	Executes the given code block with the given arguments in a seperate
2393	process, returning the results. Everything must be serialisable with
2394	Coro::Storable. May, of course, block. Note that the executed sub may
2395	never block itself or use any form of Event handling.
2396
2397	=cut
2398
2399	sub fork_call(&@) {
2400	my ($cb, @args) = @_;
2401
2402	# socketpair my $fh1, my $fh2, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC
2403	# or die "socketpair: $!";
2404	pipe my $fh1, my $fh2
2405	or die "pipe: $!";
2406
2407	if (my $pid = fork) {
2408	close $fh2;
2409
2410	my $res = (Coro::Handle::unblock $fh1)->readline (undef);
2411	$res = Coro::Storable::thaw $res;
2412
2413	waitpid $pid, 0; # should not block anymore, we expect the child to simply behave
2414
2415	die $$res unless "ARRAY" eq ref $res;
2416
2417	return wantarray ? @$res : $res->[-1];
2418	} else {
2419	local $SIG{__WARN__};
2420	eval {
2421	local $SIG{__DIE__};
2422	close $fh1;
2423
2424	my @res = eval { $cb->(@args) };
2425	syswrite $fh2, Coro::Storable::freeze +($@ ? \"$@" : \@res);
2426	};
2427
2428	warn $@ if $@;
2429	_exit 0;
2430	}
2431	}
2432
2433
2434
2435	#############################################################################
2436	# the server's init and main functions	2984	# the server's init and main functions
2437		2985
2438	sub load_facedata($) {	2986	sub load_facedata($) {
2439	my ($path) = @_;	2987	my ($path) = @_;
		2988
		2989	# HACK to clear player env face cache, we need some signal framework
		2990	# for this (global event?)
		2991	%ext::player_env::MUSIC_FACE_CACHE = ();
		2992
		2993	my $enc = JSON::XS->new->utf8->canonical->relaxed;
2440		2994
2441	warn "loading facedata from $path\n";	2995	warn "loading facedata from $path\n";
2442		2996
2443	my $facedata;	2997	my $facedata;
2444	0 < aio_load $path, $facedata	2998	0 < aio_load $path, $facedata
…		…
2447	$facedata = Coro::Storable::thaw $facedata;	3001	$facedata = Coro::Storable::thaw $facedata;
2448		3002
2449	$facedata->{version} == 2	3003	$facedata->{version} == 2
2450	or cf::cleanup "$path: version mismatch, cannot proceed.";	3004	or cf::cleanup "$path: version mismatch, cannot proceed.";
2451		3005
		3006	# patch in the exptable
		3007	$facedata->{resource}{"res/exp_table"} = {
		3008	type => FT_RSRC,
		3009	data => $enc->encode ([map cf::level_to_min_exp $_, 1 .. cf::settings->max_level]),
		3010	};
		3011	cf::cede_to_tick;
		3012
2452	{	3013	{
2453	my $faces = $facedata->{faceinfo};	3014	my $faces = $facedata->{faceinfo};
2454		3015
2455	while (my ($face, $info) = each %$faces) {	3016	while (my ($face, $info) = each %$faces) {
2456	my $idx = (cf::face::find $face) || cf::face::alloc $face;	3017	my $idx = (cf::face::find $face) || cf::face::alloc $face;
2457	cf::face::set $idx, $info->{visibility}, $info->{magicmap};	3018	cf::face::set_visibility $idx, $info->{visibility};
		3019	cf::face::set_magicmap $idx, $info->{magicmap};
2458	cf::face::set_data $idx, 0, $info->{data32}, $info->{chksum32};	3020	cf::face::set_data $idx, 0, $info->{data32}, Digest::MD5::md5 $info->{data32};
2459	cf::face::set_data $idx, 1, $info->{data64}, $info->{chksum64};	3021	cf::face::set_data $idx, 1, $info->{data64}, Digest::MD5::md5 $info->{data64};
2460	Coro::cede;	3022
		3023	cf::cede_to_tick;
2461	}	3024	}
2462		3025
2463	while (my ($face, $info) = each %$faces) {	3026	while (my ($face, $info) = each %$faces) {
2464	next unless $info->{smooth};	3027	next unless $info->{smooth};
2465	my $idx = cf::face::find $face	3028	my $idx = cf::face::find $face
2466	or next;	3029	or next;
2467	if (my $smooth = cf::face::find $info->{smooth}) {	3030	if (my $smooth = cf::face::find $info->{smooth}) {
		3031	cf::face::set_smooth $idx, $smooth;
2468	cf::face::set_smooth $idx, $smooth, $info->{smoothlevel};	3032	cf::face::set_smoothlevel $idx, $info->{smoothlevel};
2469	} else {	3033	} else {
2470	warn "smooth face '$info->{smooth}' not found for face '$face'";	3034	warn "smooth face '$info->{smooth}' not found for face '$face'";
2471	}	3035	}
2472	Coro::cede;	3036
		3037	cf::cede_to_tick;
2473	}	3038	}
2474	}	3039	}
2475		3040
2476	{	3041	{
2477	my $anims = $facedata->{animinfo};	3042	my $anims = $facedata->{animinfo};
2478		3043
2479	while (my ($anim, $info) = each %$anims) {	3044	while (my ($anim, $info) = each %$anims) {
2480	cf::anim::set $anim, $info->{frames}, $info->{facings};	3045	cf::anim::set $anim, $info->{frames}, $info->{facings};
2481	Coro::cede;	3046	cf::cede_to_tick;
2482	}	3047	}
2483		3048
2484	cf::anim::invalidate_all; # d'oh	3049	cf::anim::invalidate_all; # d'oh
2485	}	3050	}
2486		3051
		3052	{
		3053	# TODO: for gcfclient pleasure, we should give resources
		3054	# that gcfclient doesn't grok a >10000 face index.
		3055	my $res = $facedata->{resource};
		3056
		3057	my $soundconf = delete $res->{"res/sound.conf"};
		3058
		3059	while (my ($name, $info) = each %$res) {
		3060	my $idx = (cf::face::find $name) || cf::face::alloc $name;
		3061	my $data;
		3062
		3063	if ($info->{type} & 1) {
		3064	# prepend meta info
		3065
		3066	my $meta = $enc->encode ({
		3067	name => $name,
		3068	%{ $info->{meta} || {} },
		3069	});
		3070
		3071	$data = pack "(w/a*)*", $meta, $info->{data};
		3072	} else {
		3073	$data = $info->{data};
		3074	}
		3075
		3076	cf::face::set_data $idx, 0, $data, Digest::MD5::md5 $data;
		3077	cf::face::set_type $idx, $info->{type};
		3078
		3079	cf::cede_to_tick;
		3080	}
		3081
		3082	if ($soundconf) {
		3083	$soundconf = $enc->decode (delete $soundconf->{data});
		3084
		3085	for (0 .. SOUND_CAST_SPELL_0 - 1) {
		3086	my $sound = $soundconf->{compat}[$_]
		3087	or next;
		3088
		3089	my $face = cf::face::find "sound/$sound->[1]";
		3090	cf::sound::set $sound->[0] => $face;
		3091	cf::sound::old_sound_index $_, $face; # gcfclient-compat
		3092	}
		3093
		3094	while (my ($k, $v) = each %{$soundconf->{event}}) {
		3095	my $face = cf::face::find "sound/$v";
		3096	cf::sound::set $k => $face;
		3097	}
		3098	}
		3099	}
		3100
2487	1	3101	1
2488	}	3102	}
2489		3103
		3104	register_exticmd fx_want => sub {
		3105	my ($ns, $want) = @_;
		3106
		3107	while (my ($k, $v) = each %$want) {
		3108	$ns->fx_want ($k, $v);
		3109	}
		3110	};
		3111
		3112	sub reload_regions {
		3113	# HACK to clear player env face cache, we need some signal framework
		3114	# for this (global event?)
		3115	%ext::player_env::MUSIC_FACE_CACHE = ();
		3116
		3117	load_resource_file "$MAPDIR/regions"
		3118	or die "unable to load regions file\n";
		3119
		3120	for (cf::region::list) {
		3121	$_->{match} = qr/$_->{match}/
		3122	if exists $_->{match};
		3123	}
		3124	}
		3125
2490	sub reload_facedata {	3126	sub reload_facedata {
2491	load_facedata sprintf "%s/facedata", cf::datadir	3127	load_facedata "$DATADIR/facedata"
2492	or die "unable to load facedata\n";	3128	or die "unable to load facedata\n";
2493	}	3129	}
2494		3130
2495	sub reload_regions {
2496	load_resource_file sprintf "%s/%s/regions", cf::datadir, cf::mapdir
2497	or die "unable to load regions file\n";
2498	}
2499
2500	sub reload_archetypes {	3131	sub reload_archetypes {
2501	load_resource_file sprintf "%s/archetypes", cf::datadir	3132	load_resource_file "$DATADIR/archetypes"
2502	or die "unable to load archetypes\n";	3133	or die "unable to load archetypes\n";
		3134	#d# NEED to laod twice to resolve forward references
		3135	# this really needs to be done in an extra post-pass
		3136	# (which needs to be synchronous, so solve it differently)
		3137	load_resource_file "$DATADIR/archetypes"
		3138	or die "unable to load archetypes\n";
2503	}	3139	}
2504		3140
2505	sub reload_treasures {	3141	sub reload_treasures {
2506	load_resource_file sprintf "%s/treasures", cf::datadir	3142	load_resource_file "$DATADIR/treasures"
2507	or die "unable to load treasurelists\n";	3143	or die "unable to load treasurelists\n";
2508	}	3144	}
2509		3145
2510	sub reload_resources {	3146	sub reload_resources {
2511	warn "reloading resource files...\n";	3147	warn "reloading resource files...\n";
2512		3148
2513	reload_regions;	3149	reload_regions;
2514	reload_facedata;	3150	reload_facedata;
		3151	#reload_archetypes;#d#
2515	reload_archetypes;	3152	reload_archetypes;
2516	reload_treasures;	3153	reload_treasures;
2517		3154
2518	warn "finished reloading resource files\n";	3155	warn "finished reloading resource files\n";
2519	}	3156	}
2520		3157
2521	sub init {	3158	sub init {
2522	reload_resources;	3159	reload_resources;
2523	}	3160	}
2524		3161
2525	sub cfg_load {	3162	sub reload_config {
2526	open my $fh, "<:utf8", cf::confdir . "/config"	3163	open my $fh, "<:utf8", "$CONFDIR/config"
2527	or return;	3164	or return;
2528		3165
2529	local $/;	3166	local $/;
2530	*CFG = YAML::Syck::Load <$fh>;	3167	*CFG = YAML::Syck::Load <$fh>;
2531		3168
…		…
2550	(async {	3187	(async {
2551	Event::one_event;	3188	Event::one_event;
2552	})->prio (Coro::PRIO_MAX);	3189	})->prio (Coro::PRIO_MAX);
2553	};	3190	};
2554		3191
2555	cfg_load;	3192	reload_config;
2556	db_init;	3193	db_init;
2557	load_extensions;	3194	load_extensions;
2558		3195
2559	$TICK_WATCHER->start;	3196	$TICK_WATCHER->start;
2560	Event::loop;	3197	Event::loop;
…		…
2576	},	3213	},
2577	);	3214	);
2578	}	3215	}
2579	}	3216	}
2580		3217
		3218	sub write_runtime {
		3219	my $runtime = "$LOCALDIR/runtime";
		3220
		3221	# first touch the runtime file to show we are still running:
		3222	# the fsync below can take a very very long time.
		3223
		3224	IO::AIO::aio_utime $runtime, undef, undef;
		3225
		3226	my $guard = cf::lock_acquire "write_runtime";
		3227
		3228	my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
		3229	or return;
		3230
		3231	my $value = $cf::RUNTIME + 90 + 10;
		3232	# 10 is the runtime save interval, for a monotonic clock
		3233	# 60 allows for the watchdog to kill the server.
		3234
		3235	(aio_write $fh, 0, (length $value), $value, 0) <= 0
		3236	and return;
		3237
		3238	# always fsync - this file is important
		3239	aio_fsync $fh
		3240	and return;
		3241
		3242	# touch it again to show we are up-to-date
		3243	aio_utime $fh, undef, undef;
		3244
		3245	close $fh
		3246	or return;
		3247
		3248	aio_rename "$runtime~", $runtime
		3249	and return;
		3250
		3251	warn "runtime file written.\n";
		3252
		3253	1
		3254	}
		3255
2581	sub emergency_save() {	3256	sub emergency_save() {
2582	my $freeze_guard = cf::freeze_mainloop;	3257	my $freeze_guard = cf::freeze_mainloop;
2583		3258
2584	warn "enter emergency perl save\n";	3259	warn "enter emergency perl save\n";
2585		3260
…		…
2660	%EXT_CORO = ();	3335	%EXT_CORO = ();
2661		3336
2662	warn "removing commands";	3337	warn "removing commands";
2663	%COMMAND = ();	3338	%COMMAND = ();
2664		3339
2665	warn "removing ext commands";	3340	warn "removing ext/exti commands";
2666	%EXTCMD = ();	3341	%EXTCMD = ();
		3342	%EXTICMD = ();
2667		3343
2668	warn "unloading/nuking all extensions";	3344	warn "unloading/nuking all extensions";
2669	for my $pkg (@EXTS) {	3345	for my $pkg (@EXTS) {
2670	warn "... unloading $pkg";	3346	warn "... unloading $pkg";
2671		3347
…		…
2714	warn "reloading cf.pm";	3390	warn "reloading cf.pm";
2715	require cf;	3391	require cf;
2716	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt	3392	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
2717		3393
2718	warn "loading config and database again";	3394	warn "loading config and database again";
2719	cf::cfg_load;	3395	cf::reload_config;
2720		3396
2721	warn "loading extensions";	3397	warn "loading extensions";
2722	cf::load_extensions;	3398	cf::load_extensions;
2723		3399
2724	warn "reattaching attachments to objects/players";	3400	warn "reattaching attachments to objects/players";
…		…
2802	Carp::cluck "major BUG: server tick called outside of main coro, skipping it"	3478	Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
2803	unless ++$bug_warning > 10;	3479	unless ++$bug_warning > 10;
2804	return;	3480	return;
2805	}	3481	}
2806		3482
2807	$NOW = Event::time;	3483	$NOW = $tick_start = Event::time;
2808		3484
2809	cf::server_tick; # one server iteration	3485	cf::server_tick; # one server iteration
2810		3486
2811	$RUNTIME += $TICK;	3487	$RUNTIME += $TICK;
2812	$NEXT_TICK += $TICK;	3488	$NEXT_TICK += $TICK;
…		…
2817	write_runtime	3493	write_runtime
2818	or warn "ERROR: unable to write runtime file: $!";	3494	or warn "ERROR: unable to write runtime file: $!";
2819	};	3495	};
2820	}	3496	}
2821		3497
2822	# my $AFTER = Event::time;	3498	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
2823	# warn $AFTER - $NOW;#d#	3499	$sig->send;
		3500	}
		3501	while (my $sig = shift @WAIT_FOR_TICK) {
		3502	$sig->send;
		3503	}
		3504
		3505	$NOW = Event::time;
2824		3506
2825	# if we are delayed by four ticks or more, skip them all	3507	# if we are delayed by four ticks or more, skip them all
2826	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;	3508	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
2827		3509
2828	$TICK_WATCHER->at ($NEXT_TICK);	3510	$TICK_WATCHER->at ($NEXT_TICK);
2829	$TICK_WATCHER->start;	3511	$TICK_WATCHER->start;
2830		3512
2831	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {	3513	$LOAD = ($NOW - $tick_start) / $TICK;
2832	$sig->send;	3514	$LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
2833	}
2834	while (my $sig = shift @WAIT_FOR_TICK) {
2835	$sig->send;
2836	}
2837		3515
2838	_post_tick;	3516	_post_tick;
2839	},	3517	},
2840	);	3518	);
2841		3519
2842	{	3520	{
		3521	BDB::min_parallel 8;
2843	BDB::max_poll_time $TICK * 0.1;	3522	BDB::max_poll_time $TICK * 0.1;
2844	$BDB_POLL_WATCHER = Event->io (	3523	$BDB_POLL_WATCHER = Event->io (
2845	reentrant => 0,	3524	reentrant => 0,
2846	fd => BDB::poll_fileno,	3525	fd => BDB::poll_fileno,
2847	poll => 'r',	3526	poll => 'r',
2848	prio => 0,	3527	prio => 0,
2849	data => WF_AUTOCANCEL,	3528	data => WF_AUTOCANCEL,
2850	cb => \&BDB::poll_cb,	3529	cb => \&BDB::poll_cb,
2851	);	3530	);
2852	BDB::min_parallel 8;
2853		3531
2854	BDB::set_sync_prepare {	3532	BDB::set_sync_prepare {
2855	my $status;	3533	my $status;
2856	my $current = $Coro::current;	3534	my $current = $Coro::current;
2857	(	3535	(
…		…
2866	)	3544	)
2867	};	3545	};
2868		3546
2869	unless ($DB_ENV) {	3547	unless ($DB_ENV) {
2870	$DB_ENV = BDB::db_env_create;	3548	$DB_ENV = BDB::db_env_create;
		3549	$DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC
		3550	| BDB::LOG_AUTOREMOVE, 1);
		3551	$DB_ENV->set_timeout (30, BDB::SET_TXN_TIMEOUT);
		3552	$DB_ENV->set_timeout (30, BDB::SET_LOCK_TIMEOUT);
2871		3553
2872	cf::sync_job {	3554	cf::sync_job {
2873	eval {	3555	eval {
2874	BDB::db_env_open	3556	BDB::db_env_open
2875	$DB_ENV,	3557	$DB_ENV,
2876	$BDB_ENV_DIR,	3558	$BDBDIR,
2877	BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN	3559	BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
2878	| BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,	3560	| BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
2879	0666;	3561	0666;
2880		3562
2881	cf::cleanup "db_env_open($BDB_ENV_DIR): $!" if $!;	3563	cf::cleanup "db_env_open($BDBDIR): $!" if $!;
2882
2883	$DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC, 1);
2884	$DB_ENV->set_lk_detect;
2885	};	3564	};
2886		3565
2887	cf::cleanup "db_env_open(db): $@" if $@;	3566	cf::cleanup "db_env_open(db): $@" if $@;
2888	};	3567	};
2889	}	3568	}
		3569
		3570	$BDB_DEADLOCK_WATCHER = Event->timer (
		3571	after => 3,
		3572	interval => 1,
		3573	hard => 1,
		3574	prio => 0,
		3575	data => WF_AUTOCANCEL,
		3576	cb => sub {
		3577	BDB::db_env_lock_detect $DB_ENV, 0, BDB::LOCK_DEFAULT, 0, sub { };
		3578	},
		3579	);
		3580	$BDB_CHECKPOINT_WATCHER = Event->timer (
		3581	after => 11,
		3582	interval => 60,
		3583	hard => 1,
		3584	prio => 0,
		3585	data => WF_AUTOCANCEL,
		3586	cb => sub {
		3587	BDB::db_env_txn_checkpoint $DB_ENV, 0, 0, 0, sub { };
		3588	},
		3589	);
		3590	$BDB_TRICKLE_WATCHER = Event->timer (
		3591	after => 5,
		3592	interval => 10,
		3593	hard => 1,
		3594	prio => 0,
		3595	data => WF_AUTOCANCEL,
		3596	cb => sub {
		3597	BDB::db_env_memp_trickle $DB_ENV, 20, 0, sub { };
		3598	},
		3599	);
2890	}	3600	}
2891		3601
2892	{	3602	{
2893	IO::AIO::min_parallel 8;	3603	IO::AIO::min_parallel 8;
2894		3604
…		…
2902	prio => 6,	3612	prio => 6,
2903	cb => \&IO::AIO::poll_cb,	3613	cb => \&IO::AIO::poll_cb,
2904	);	3614	);
2905	}	3615	}
2906		3616
		3617	my $_log_backtrace;
		3618
		3619	sub _log_backtrace {
		3620	my ($msg, @addr) = @_;
		3621
		3622	$msg =~ s/\n//;
		3623
		3624	# limit the # of concurrent backtraces
		3625	if ($_log_backtrace < 2) {
		3626	++$_log_backtrace;
		3627	async {
		3628	my @bt = fork_call {
		3629	@addr = map { sprintf "%x", $_ } @addr;
		3630	my $self = (-f "/proc/$$/exe") ? "/proc/$$/exe" : $^X;
		3631	open my $fh, "exec addr2line -C -f -i -e \Q$self\E @addr 2>&1 |"
		3632	or die "addr2line: $!";
		3633
		3634	my @funcs;
		3635	my @res = <$fh>;
		3636	chomp for @res;
		3637	while (@res) {
		3638	my ($func, $line) = splice @res, 0, 2, ();
		3639	push @funcs, "[$func] $line";
		3640	}
		3641
		3642	@funcs
		3643	};
		3644
		3645	LOG llevInfo, "[ABT] $msg\n";
		3646	LOG llevInfo, "[ABT] $_\n" for @bt;
		3647	--$_log_backtrace;
		3648	};
		3649	} else {
		3650	LOG llevInfo, "[ABT] $msg\n";
		3651	LOG llevInfo, "[ABT] [suppressed]\n";
		3652	}
		3653	}
		3654
2907	# load additional modules	3655	# load additional modules
2908	use cf::pod;	3656	use cf::pod;
2909		3657
2910	END { cf::emergency_save }	3658	END { cf::emergency_save }
2911		3659

Diff Legend

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