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

Diff Legend

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