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

Diff Legend

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