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.73 by root, Sun Oct 1 11:46:51 2006 UTC vs.
Revision 1.403 by root, Mon Dec 17 07:09:18 2007 UTC

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

Diff Legend

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