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

Diff Legend

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