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.104 by root, Sat Dec 30 16:56:16 2006 UTC vs.
Revision 1.612 by root, Wed Nov 21 12:47:09 2012 UTC

		1	#
		2	# This file is part of Deliantra, the Roguelike Realtime MMORPG.
		3	#
		4	# Copyright (©) 2006,2007,2008,2009,2010,2011,2012 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
		5	#
		6	# Deliantra is free software: you can redistribute it and/or modify it under
		7	# the terms of the Affero GNU General Public License as published by the
		8	# Free Software Foundation, either version 3 of the License, or (at your
		9	# option) any later version.
		10	#
		11	# This program is distributed in the hope that it will be useful,
		12	# but WITHOUT ANY WARRANTY; without even the implied warranty of
		13	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
		14	# GNU General Public License for more details.
		15	#
		16	# You should have received a copy of the Affero GNU General Public License
		17	# and the GNU General Public License along with this program. If not, see
		18	# <http://www.gnu.org/licenses/>.
		19	#
		20	# The authors can be reached via e-mail to <support@deliantra.net>
		21	#
		22
1	package cf;	23	package cf;
2		24
3	use utf8;	25	use common::sense;
4	use strict;
5		26
6	use Symbol;	27	use Symbol;
7	use List::Util;	28	use List::Util;
8	use Storable;	29	use Socket;
		30	use EV;
9	use Opcode;	31	use Opcode;
10	use Safe;	32	use Safe;
11	use Safe::Hole;	33	use Safe::Hole;
		34	use Storable ();
		35	use Carp ();
12		36
		37	use AnyEvent ();
		38	use AnyEvent::IO ();
		39	use AnyEvent::DNS ();
		40
13	use Coro 3.3;	41	use Coro ();
		42	use Coro::State;
		43	use Coro::Handle;
		44	use Coro::EV;
14	use Coro::Event;	45	use Coro::AnyEvent;
15	use Coro::Timer;	46	use Coro::Timer;
16	use Coro::Signal;	47	use Coro::Signal;
17	use Coro::Semaphore;	48	use Coro::Semaphore;
		49	use Coro::SemaphoreSet;
		50	use Coro::AnyEvent;
		51	use Coro::AIO;
		52	use Coro::BDB 1.6;
		53	use Coro::Storable;
		54	use Coro::Util ();
18		55
19	use IO::AIO 2.3;	56	use Guard ();
		57	use JSON::XS 2.01 ();
		58	use BDB ();
		59	use Data::Dumper;
		60	use Fcntl;
20	use YAML::Syck ();	61	use YAML::XS ();
21	use Time::HiRes;	62	use IO::AIO ();
		63	use Compress::LZF;
		64	use Digest::MD5 ();
22		65
23	use Event; $Event::Eval = 1; # no idea why this is required, but it is	66	AnyEvent::detect;
24		67
25	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?	68	# configure various modules to our taste
26	$YAML::Syck::ImplicitUnicode = 1;	69	#
		70	$Storable::canonical = 1; # reduce rsync transfers
		71	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
27		72
28	$Coro::main->prio (2); # run main coroutine ("the server") with very high priority	73	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
		74
		75	# make sure c-lzf reinitialises itself
		76	Compress::LZF::set_serializer "Storable", "Storable::net_mstore", "Storable::mretrieve";
		77	Compress::LZF::sfreeze_cr { }; # prime Compress::LZF so it does not use require later
		78
		79	# strictly for debugging
		80	$SIG{QUIT} = sub { Carp::cluck "SIGQUIT" };
29		81
30	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload	82	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
		83
		84	our @ORIG_INC;
31		85
32	our %COMMAND = ();	86	our %COMMAND = ();
33	our %COMMAND_TIME = ();	87	our %COMMAND_TIME = ();
		88
		89	our @EXTS = (); # list of extension package names
34	our %EXTCMD = ();	90	our %EXTCMD = ();
		91	our %EXTACMD = ();
		92	our %EXTICMD = ();
		93	our %EXTIACMD = ();
		94	our %EXT_CORO = (); # coroutines bound to extensions
		95	our %EXT_MAP = (); # pluggable maps
35		96
		97	our $RELOAD; # number of reloads so far, non-zero while in reload
36	our @EVENT;	98	our @EVENT;
37	our $LIBDIR = datadir . "/ext";	99	our @REFLECT; # set by XS
		100	our %REFLECT; # set by us
38		101
39	our $TICK = MAX_TIME * 1e-6;	102	our $CONFDIR = confdir;
40	our $TICK_WATCHER;	103
		104	our $DATADIR = datadir;
		105	our $LIBDIR = "$DATADIR/ext";
		106	our $PODDIR = "$DATADIR/pod";
		107	our $MAPDIR = "$DATADIR/" . mapdir;
		108
		109	our $LOCALDIR = localdir;
		110	our $TMPDIR = "$LOCALDIR/" . tmpdir;
		111	our $UNIQUEDIR = "$LOCALDIR/" . uniquedir;
		112	our $PLAYERDIR = "$LOCALDIR/" . playerdir;
		113	our $RANDOMDIR = "$LOCALDIR/random";
		114	our $BDBDIR = "$LOCALDIR/db";
		115	our $PIDFILE = "$LOCALDIR/pid";
		116	our $RUNTIMEFILE = "$LOCALDIR/runtime";
		117
		118	#our %RESOURCE; # unused
		119
		120	our $OUTPUT_RATE_MIN = 3000;
		121	our $OUTPUT_RATE_MAX = 1000000;
		122
		123	our $MAX_LINKS = 32; # how many chained exits to follow
		124	our $VERBOSE_IO = 1;
		125
		126	our $TICK = MAX_TIME * 1e-6; # this is a CONSTANT(!)
		127	our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
41	our $NEXT_TICK;	128	our $NEXT_TICK;
		129	our $USE_FSYNC = 1; # use fsync to write maps - default on
		130
		131	our $BDB_DEADLOCK_WATCHER;
		132	our $BDB_CHECKPOINT_WATCHER;
		133	our $BDB_TRICKLE_WATCHER;
		134	our $DB_ENV;
		135
		136	our @EXTRA_MODULES = qw(pod match mapscript incloader);
		137
		138	our %CFG;
		139	our %EXT_CFG; # cfgkeyname => [var-ref, defaultvalue]
		140
		141	our $UPTIME; $UPTIME ||= time;
		142	our $RUNTIME = 0;
		143	our $SERVER_TICK = 0;
42	our $NOW;	144	our $NOW;
43		145
44	our %CFG;	146	our (%PLAYER, %PLAYER_LOADING); # all users
		147	our (%MAP, %MAP_LOADING ); # all maps
		148	our $LINK_MAP; # the special {link} map, which is always available
45		149
46	our $UPTIME; $UPTIME ||= time;	150	# used to convert map paths into valid unix filenames by replacing / by ∕
47	our $RUNTIME;	151	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
48		152
49	our %MAP; # all maps	153	our $LOAD; # a number between 0 (idle) and 1 (too many objects)
50	our $LINK_MAP; # the special {link} map	154	our $LOADAVG; # same thing, but with alpha-smoothing
51	our $FREEZE;	155	our $JITTER; # average jitter
		156	our $TICK_START; # for load detecting purposes
		157
		158	our @POST_INIT;
		159
		160	our $REATTACH_ON_RELOAD; # set to true to force object reattach on reload (slow)
		161	our $REALLY_UNLOOP; # never set to true, please :)
		162
		163	our $WAIT_FOR_TICK = new Coro::Signal;
		164	our @WAIT_FOR_TICK_BEGIN;
52		165
53	binmode STDOUT;	166	binmode STDOUT;
54	binmode STDERR;	167	binmode STDERR;
55		168
56	# read virtual server time, if available	169	# read virtual server time, if available
57	unless ($RUNTIME || !-e cf::localdir . "/runtime") {	170	unless ($RUNTIME || !-e $RUNTIMEFILE) {
58	open my $fh, "<", cf::localdir . "/runtime"	171	open my $fh, "<", $RUNTIMEFILE
59	or die "unable to read runtime file: $!";	172	or die "unable to read $RUNTIMEFILE file: $!";
60	$RUNTIME = <$fh> + 0.;	173	$RUNTIME = <$fh> + 0.;
61	}	174	}
62		175
63	mkdir cf::localdir;	176	eval "sub TICK() { $TICK } 1" or die;
64	mkdir cf::localdir . "/" . cf::playerdir;
65	mkdir cf::localdir . "/" . cf::tmpdir;
66	mkdir cf::localdir . "/" . cf::uniquedir;
67		177
68	our %EXT_CORO;	178	mkdir $_
		179	for $LOCALDIR, $TMPDIR, $UNIQUEDIR, $PLAYERDIR, $RANDOMDIR, $BDBDIR;
		180
		181	our $EMERGENCY_POSITION;
		182
		183	sub cf::map::normalise;
		184
		185	sub in_main() {
		186	$Coro::current == $Coro::main
		187	}
69		188
70	#############################################################################	189	#############################################################################
71		190
		191	%REFLECT = ();
		192	for (@REFLECT) {
		193	my $reflect = JSON::XS::decode_json $_;
		194	$REFLECT{$reflect->{class}} = $reflect;
		195	}
		196
		197	# this is decidedly evil
		198	$REFLECT{object}{flags} = { map +($_ => undef), grep $_, map /^FLAG_([A-Z0-9_]+)$/ && lc $1, keys %{"cf::"} };
		199
		200	#############################################################################
		201
72	=head2 GLOBAL VARIABLES	202	=head2 GLOBAL VARIABLES
73		203
74	=over 4	204	=over 4
75		205
76	=item $cf::UPTIME	206	=item $cf::UPTIME
77		207
78	The timestamp of the server start (so not actually an uptime).	208	The timestamp of the server start (so not actually an "uptime").
		209
		210	=item $cf::SERVER_TICK
		211
		212	An unsigned integer that starts at zero when the server is started and is
		213	incremented on every tick.
		214
		215	=item $cf::NOW
		216
		217	The (real) time of the last (current) server tick - updated before and
		218	after tick processing, so this is useful only as a rough "what time is it
		219	now" estimate.
		220
		221	=item $cf::TICK
		222
		223	The interval between each server tick, in seconds.
79		224
80	=item $cf::RUNTIME	225	=item $cf::RUNTIME
81		226
82	The time this server has run, starts at 0 and is increased by $cf::TICK on	227	The time this server has run, starts at 0 and is increased by $cf::TICK on
83	every server tick.	228	every server tick.
84		229
85	=item $cf::LIBDIR	230	=item $cf::CONFDIR $cf::DATADIR $cf::LIBDIR $cf::PODDIR
		231	$cf::MAPDIR $cf::LOCALDIR $cf::TMPDIR $cf::UNIQUEDIR
		232	$cf::PLAYERDIR $cf::RANDOMDIR $cf::BDBDIR
86		233
87	The perl library directory, where extensions and cf-specific modules can	234	Various directories - "/etc", read-only install directory, perl-library
88	be found. It will be added to C<@INC> automatically.	235	directory, pod-directory, read-only maps directory, "/var", "/var/tmp",
		236	unique-items directory, player file directory, random maps directory and
		237	database environment.
89		238
		239	=item $cf::LOADAVG
		240
		241	The current CPU load on the server (alpha-smoothed), as a value between 0
		242	(none) and 1 (overloaded), indicating how much time is spent on processing
		243	objects per tick. Healthy values are < 0.5.
		244
90	=item $cf::NOW	245	=item $cf::LOAD
91		246
92	The time of the last (current) server tick.	247	The raw value load value from the last tick.
93
94	=item $cf::TICK
95
96	The interval between server ticks, in seconds.
97		248
98	=item %cf::CFG	249	=item %cf::CFG
99		250
100	Configuration for the server, loaded from C</etc/crossfire/config>, or	251	Configuration for the server, loaded from C</etc/deliantra-server/config>, or
101	from wherever your confdir points to.	252	from wherever your confdir points to.
102		253
		254	=item cf::wait_for_tick, cf::wait_for_tick_begin
		255
		256	These are functions that inhibit the current coroutine one tick.
		257	cf::wait_for_tick_begin only returns directly I<after> the tick
		258	processing (and consequently, can only wake one thread per tick), while
		259	cf::wait_for_tick wakes up all waiters after tick processing.
		260
		261	Note that cf::wait_for_tick will immediately return when the server is not
		262	ticking, making it suitable for small pauses in threads that need to run
		263	when the server is paused. If that is not applicable (i.e. you I<really>
		264	want to wait, use C<$cf::WAIT_FOR_TICK>).
		265
		266	=item $cf::WAIT_FOR_TICK
		267
		268	Note that C<cf::wait_for_tick> is probably the correct thing to use. This
		269	variable contains a L<Coro::Signal> that is broadcats after every server
		270	tick. Calling C<< ->wait >> on it will suspend the caller until after the
		271	next server tick.
		272
		273	=cut
		274
		275	sub wait_for_tick();
		276	sub wait_for_tick_begin();
		277
		278	=item @cf::INVOKE_RESULTS
		279
		280	This array contains the results of the last C<invoke ()> call. When
		281	C<cf::override> is called C<@cf::INVOKE_RESULTS> is set to the parameters of
		282	that call.
		283
		284	=item %cf::REFLECT
		285
		286	Contains, for each (C++) class name, a hash reference with information
		287	about object members (methods, scalars, arrays and flags) and other
		288	metadata, which is useful for introspection.
		289
103	=back	290	=back
104		291
105	=cut	292	=cut
106		293
107	BEGIN {	294	sub error(@) { LOG llevError, join "", @_ }
108	*CORE::GLOBAL::warn = sub {	295	sub warn (@) { LOG llevWarn , join "", @_ }
		296	sub info (@) { LOG llevInfo , join "", @_ }
		297	sub debug(@) { LOG llevDebug, join "", @_ }
		298	sub trace(@) { LOG llevTrace, join "", @_ }
		299
		300	$Coro::State::WARNHOOK = sub {
109	my $msg = join "", @_;	301	my $msg = join "", @_;
110	utf8::encode $msg;
111		302
112	$msg .= "\n"	303	$msg .= "\n"
113	unless $msg =~ /\n$/;	304	unless $msg =~ /\n$/;
114		305
115	LOG llevError, "cfperl: $msg";	306	$msg =~ s/([\x00-\x08\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
116	};	307
117	}	308	LOG llevWarn, $msg;
		309	};
		310
		311	$Coro::State::DIEHOOK = sub {
		312	return unless $^S eq 0; # "eq", not "=="
		313
		314	error Carp::longmess $_[0];
		315
		316	if (in_main) {#d#
		317	error "DIEHOOK called in main context, Coro bug?\n";#d#
		318	return;#d#
		319	}#d#
		320
		321	# kill coroutine otherwise
		322	Coro::terminate
		323	};
118		324
119	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';	325	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
120	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';	326	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
121	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';	327	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
122	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';	328	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
123	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';	329	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
		330	@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
124	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	331	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; # not really true (yet)
125		332
126	# we bless all objects into (empty) derived classes to force a method lookup	333	# we bless all objects into (empty) derived classes to force a method lookup
127	# within the Safe compartment.	334	# within the Safe compartment.
128	for my $pkg (qw(	335	for my $pkg (qw(
129	cf::global cf::attachable	336	cf::global cf::attachable
130	cf::object cf::object::player	337	cf::object cf::object::player
131	cf::client cf::player	338	cf::client cf::player
132	cf::arch cf::living	339	cf::arch cf::living
		340	cf::map cf::mapspace
133	cf::map cf::party cf::region	341	cf::party cf::region
134	)) {	342	)) {
135	no strict 'refs';
136	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;	343	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
137	}	344	}
138		345
139	$Event::DIED = sub {	346	$EV::DIED = sub {
140	warn "error in event callback: @_";	347	warn "error in event callback: $@";
141	};	348	};
142		349
143	my %ext_pkg;	350	#############################################################################
144	my @exts;	351
145	my @hook;	352	sub fork_call(&@);
		353	sub get_slot($;$$);
		354
		355	#############################################################################
146		356
147	=head2 UTILITY FUNCTIONS	357	=head2 UTILITY FUNCTIONS
148		358
149	=over 4	359	=over 4
150		360
151	=cut	361	=item dumpval $ref
152		362
153	use JSON::Syck (); # TODO# replace by JSON::PC once working	363	=cut
154		364
		365	sub dumpval {
		366	eval {
		367	local $SIG{__DIE__};
		368	my $d;
		369	if (1) {
		370	$d = new Data::Dumper([$_[0]], ["*var"]);
		371	$d->Terse(1);
		372	$d->Indent(2);
		373	$d->Quotekeys(0);
		374	$d->Useqq(1);
		375	#$d->Bless(...);
		376	$d->Seen($_[1]) if @_ > 1;
		377	$d = $d->Dump();
		378	}
		379	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
		380	$d
		381	} || "[unable to dump $_[0]: '$@']";
		382	}
		383
		384	=item $scalar = cf::load_file $path
		385
		386	Loads the given file from path and returns its contents. Croaks on error
		387	and can block.
		388
		389	=cut
		390
		391	sub load_file($) {
		392	0 <= aio_load $_[0], my $data
		393	or Carp::croak "$_[0]: $!";
		394
		395	$data
		396	}
		397
		398	=item $success = cf::replace_file $path, $data, $sync
		399
		400	Atomically replaces the file at the given $path with new $data, and
		401	optionally $sync the data to disk before replacing the file.
		402
		403	=cut
		404
		405	sub replace_file($$;$) {
		406	my ($path, $data, $sync) = @_;
		407
		408	my $lock = cf::lock_acquire ("replace_file:$path");
		409
		410	my $fh = aio_open "$path~", Fcntl::O_WRONLY | Fcntl::O_CREAT | Fcntl::O_TRUNC, 0644
		411	or return;
		412
		413	$data = $data->() if ref $data;
		414
		415	length $data == aio_write $fh, 0, (length $data), $data, 0
		416	or return;
		417
		418	!$sync
		419	or !aio_fsync $fh
		420	or return;
		421
		422	aio_close $fh
		423	and return;
		424
		425	aio_rename "$path~", $path
		426	and return;
		427
		428	if ($sync) {
		429	$path =~ s%/[^/]*$%%;
		430	aio_pathsync $path;
		431	}
		432
		433	1
		434	}
		435
155	=item $ref = cf::from_json $json	436	=item $ref = cf::decode_json $json
156		437
157	Converts a JSON string into the corresponding perl data structure.	438	Converts a JSON string into the corresponding perl data structure.
158		439
159	=cut
160
161	sub from_json($) {
162	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
163	JSON::Syck::Load $_[0]
164	}
165
166	=item $json = cf::to_json $ref	440	=item $json = cf::encode_json $ref
167		441
168	Converts a perl data structure into its JSON representation.	442	Converts a perl data structure into its JSON representation.
169		443
170	=cut	444	=cut
171		445
172	sub to_json($) {	446	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
173	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
174	JSON::Syck::Dump $_[0]
175	}
176		447
		448	sub encode_json($) { $json_coder->encode ($_[0]) }
		449	sub decode_json($) { $json_coder->decode ($_[0]) }
		450
		451	=item $ref = cf::decode_storable $scalar
		452
		453	Same as Coro::Storable::thaw, so blocks.
		454
		455	=cut
		456
		457	BEGIN { *decode_storable = \&Coro::Storable::thaw }
		458
		459	=item $ref = cf::decode_yaml $scalar
		460
		461	Same as YAML::XS::Load, but doesn't leak, because it forks (and thus blocks).
		462
		463	=cut
		464
		465	sub decode_yaml($) {
		466	fork_call { YAML::XS::Load $_[0] } @_
		467	}
		468
		469	=item $scalar = cf::unlzf $scalar
		470
		471	Same as Compress::LZF::compress, but takes server ticks into account, so
		472	blocks.
		473
		474	=cut
		475
		476	sub unlzf($) {
		477	# we assume 100mb/s minimum decompression speed (noncompressible data on a ~2ghz machine)
		478	cf::get_slot +(length $_[0]) / 100_000_000, 0, "unlzf";
		479	Compress::LZF::decompress $_[0]
		480	}
		481
		482	=item cf::post_init { BLOCK }
		483
		484	Execute the given codeblock, I<after> all extensions have been (re-)loaded,
		485	but I<before> the server starts ticking again.
		486
		487	The codeblock will have a single boolean argument to indicate whether this
		488	is a reload or not.
		489
		490	=cut
		491
		492	sub post_init(&) {
		493	push @POST_INIT, shift;
		494	}
		495
		496	sub _post_init {
		497	trace "running post_init jobs";
		498
		499	# run them in parallel...
		500
		501	my @join;
		502
		503	while () {
		504	push @join, map &Coro::async ($_, 0), @POST_INIT;
		505	@POST_INIT = ();
		506
		507	@join or last;
		508
		509	(pop @join)->join;
		510	}
		511	}
		512
		513	=item cf::lock_wait $string
		514
		515	Wait until the given lock is available. See cf::lock_acquire.
		516
		517	=item my $lock = cf::lock_acquire $string
		518
		519	Wait until the given lock is available and then acquires it and returns
		520	a L<Guard> object. If the guard object gets destroyed (goes out of scope,
		521	for example when the coroutine gets canceled), the lock is automatically
		522	returned.
		523
		524	Locks are *not* recursive, locking from the same coro twice results in a
		525	deadlocked coro.
		526
		527	Lock names should begin with a unique identifier (for example, cf::map::find
		528	uses map_find and cf::map::load uses map_load).
		529
		530	=item $locked = cf::lock_active $string
		531
		532	Return true if the lock is currently active, i.e. somebody has locked it.
		533
		534	=cut
		535
		536	our $LOCKS = new Coro::SemaphoreSet;
		537
		538	sub lock_wait($) {
		539	$LOCKS->wait ($_[0]);
		540	}
		541
		542	sub lock_acquire($) {
		543	$LOCKS->guard ($_[0])
		544	}
		545
		546	sub lock_active($) {
		547	$LOCKS->count ($_[0]) < 1
		548	}
		549
		550	sub freeze_mainloop {
		551	tick_inhibit_inc;
		552
		553	&Guard::guard (\&tick_inhibit_dec);
		554	}
		555
		556	=item cf::periodic $interval, $cb
		557
		558	Like EV::periodic, but randomly selects a starting point so that the actions
		559	get spread over time.
		560
		561	=cut
		562
		563	sub periodic($$) {
		564	my ($interval, $cb) = @_;
		565
		566	my $start = rand List::Util::min 180, $interval;
		567
		568	EV::periodic $start, $interval, 0, $cb
		569	}
		570
		571	=item cf::get_slot $time[, $priority[, $name]]
		572
		573	Allocate $time seconds of blocking CPU time at priority C<$priority>
		574	(default: 0): This call blocks and returns only when you have at least
		575	C<$time> seconds of cpu time till the next tick. The slot is only valid
		576	till the next cede.
		577
		578	Background jobs should use a priority less than zero, interactive jobs
		579	should use 100 or more.
		580
		581	The optional C<$name> can be used to identify the job to run. It might be
		582	used for statistical purposes and should identify the same time-class.
		583
		584	Useful for short background jobs.
		585
		586	=cut
		587
		588	our @SLOT_QUEUE;
		589	our $SLOT_QUEUE;
		590	our $SLOT_DECAY = 0.9;
		591
		592	$SLOT_QUEUE->cancel if $SLOT_QUEUE;
		593	$SLOT_QUEUE = Coro::async {
		594	$Coro::current->desc ("timeslot manager");
		595
		596	my $signal = new Coro::Signal;
		597	my $busy;
		598
		599	while () {
		600	next_job:
		601
		602	Coro::cede;
		603
		604	my $avail = cf::till_tick;
		605
		606	for (0 .. $#SLOT_QUEUE) {
		607	if ($SLOT_QUEUE[$_][0] <= $avail) {
		608	$busy = 0;
		609	my $job = splice @SLOT_QUEUE, $_, 1, ();
		610	$job->[2]->send;
		611	goto next_job;
		612	} else {
		613	$SLOT_QUEUE[$_][0] *= $SLOT_DECAY;
		614	}
		615	}
		616
		617	if (@SLOT_QUEUE) {
		618	wait_for_tick;
		619	} else {
		620	$busy = 0;
		621	Coro::schedule;
		622	}
		623	}
		624	};
		625
		626	sub get_slot($;$$) {
		627	return if tick_inhibit || $Coro::current == $Coro::main;
		628
		629	my ($time, $pri, $name) = @_;
		630
		631	$time = clamp $time, 0.01, $TICK * .6;
		632
		633	my $sig = new Coro::Signal;
		634
		635	push @SLOT_QUEUE, [$time, $pri, $sig, $name];
		636	@SLOT_QUEUE = sort { $b->[1] <=> $a->[1] } @SLOT_QUEUE;
		637	$SLOT_QUEUE->ready;
		638	$sig->wait;
		639	}
		640
		641	=item cf::async { BLOCK }
		642
		643	Currently the same as Coro::async_pool, meaning you cannot use
		644	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
		645	thing you are allowed to do is call C<prio> on it.
		646
		647	=cut
		648
		649	BEGIN { *async = \&Coro::async_pool }
		650
		651	=item cf::sync_job { BLOCK }
		652
		653	The design of Deliantra requires that the main coroutine ($Coro::main)
		654	is always able to handle events or runnable, as Deliantra is only
		655	partly reentrant. Thus "blocking" it by e.g. waiting for I/O is not
		656	acceptable.
		657
		658	If it must be done, put the blocking parts into C<sync_job>. This will run
		659	the given BLOCK in another coroutine while waiting for the result. The
		660	server will be frozen during this time, so the block should either finish
		661	fast or be very important.
		662
		663	=cut
		664
		665	sub sync_job(&) {
		666	my ($job) = @_;
		667
		668	if (in_main) {
		669	my $time = AE::time;
		670
		671	# this is the main coro, too bad, we have to block
		672	# till the operation succeeds, freezing the server :/
		673
		674	#LOG llevError, Carp::longmess "sync job";#d#
		675
		676	my $freeze_guard = freeze_mainloop;
		677
		678	my $busy = 1;
		679	my @res;
		680
		681	(async {
		682	$Coro::current->desc ("sync job coro");
		683	@res = eval { $job->() };
		684	error $@ if $@;
		685	undef $busy;
		686	})->prio (Coro::PRIO_MAX);
		687
		688	while ($busy) {
		689	if (Coro::nready) {
		690	Coro::cede_notself;
		691	} else {
		692	EV::loop EV::LOOP_ONESHOT;
		693	}
		694	}
		695
		696	my $time = AE::time - $time;
		697
		698	$TICK_START += $time; # do not account sync jobs to server load
		699
		700	wantarray ? @res : $res[0]
		701	} else {
		702	# we are in another coroutine, how wonderful, everything just works
		703
		704	$job->()
		705	}
		706	}
		707
177	=item $coro = cf::coro { BLOCK }	708	=item $coro = cf::async_ext { BLOCK }
178		709
179	Creates and returns a new coro. This coro is automcatially being canceled	710	Like async, but this coro is automatically being canceled when the
180	when the extension calling this is being unloaded.	711	extension calling this is being unloaded.
181		712
182	=cut	713	=cut
183		714
184	sub coro(&) {	715	sub async_ext(&) {
185	my $cb = shift;	716	my $cb = shift;
186		717
187	my $coro; $coro = async {	718	my $coro = &Coro::async ($cb);
188	eval {
189	$cb->();
190	};
191	warn $@ if $@;
192	};
193		719
194	$coro->on_destroy (sub {	720	$coro->on_destroy (sub {
195	delete $EXT_CORO{$coro+0};	721	delete $EXT_CORO{$coro+0};
196	});	722	});
197	$EXT_CORO{$coro+0} = $coro;	723	$EXT_CORO{$coro+0} = $coro;
198		724
199	$coro	725	$coro
200	}	726	}
201		727
		728	=item fork_call { }, @args
		729
		730	Executes the given code block with the given arguments in a seperate
		731	process, returning the results. Everything must be serialisable with
		732	Coro::Storable. May, of course, block. Note that the executed sub may
		733	never block itself or use any form of event handling.
		734
		735	=cut
		736
		737	sub post_fork {
		738	reset_signals;
		739	}
		740
		741	sub fork_call(&@) {
		742	my ($cb, @args) = @_;
		743
		744	my @res = Coro::Util::fork_eval {
		745	cf::post_fork;
		746	&$cb
		747	} @args;
		748
		749	wantarray ? @res : $res[-1]
		750	}
		751
		752	sub objinfo {
		753	(
		754	"counter value" => cf::object::object_count,
		755	"objects created" => cf::object::create_count,
		756	"objects destroyed" => cf::object::destroy_count,
		757	"freelist size" => cf::object::free_count,
		758	"allocated objects" => cf::object::objects_size,
		759	"active objects" => cf::object::actives_size,
		760	)
		761	}
		762
		763	=item $coin = coin_from_name $name
		764
		765	=cut
		766
		767	our %coin_alias = (
		768	"silver" => "silvercoin",
		769	"silvercoin" => "silvercoin",
		770	"silvercoins" => "silvercoin",
		771	"gold" => "goldcoin",
		772	"goldcoin" => "goldcoin",
		773	"goldcoins" => "goldcoin",
		774	"platinum" => "platinacoin",
		775	"platinumcoin" => "platinacoin",
		776	"platinumcoins" => "platinacoin",
		777	"platina" => "platinacoin",
		778	"platinacoin" => "platinacoin",
		779	"platinacoins" => "platinacoin",
		780	"royalty" => "royalty",
		781	"royalties" => "royalty",
		782	);
		783
		784	sub coin_from_name($) {
		785	$coin_alias{$_[0]}
		786	? cf::arch::find $coin_alias{$_[0]}
		787	: undef
		788	}
		789
		790	=item $value = cf::db_get $family => $key
		791
		792	Returns a single value from the environment database.
		793
		794	=item cf::db_put $family => $key => $value
		795
		796	Stores the given C<$value> in the family. It can currently store binary
		797	data only (use Compress::LZF::sfreeze_cr/sthaw to convert to/from binary).
		798
		799	=item $db = cf::db_table "name"
		800
		801	Create and/or open a new database table. The string must not be "db" and must be unique
		802	within each server.
		803
		804	=cut
		805
		806	sub db_table($) {
		807	cf::error "db_get called from main context"
		808	if $Coro::current == $Coro::main;
		809
		810	my ($name) = @_;
		811	my $db = BDB::db_create $DB_ENV;
		812
		813	eval {
		814	$db->set_flags (BDB::CHKSUM);
		815
		816	utf8::encode $name;
		817	BDB::db_open $db, undef, $name, undef, BDB::BTREE,
		818	BDB::CREATE | BDB::AUTO_COMMIT, 0666;
		819	cf::cleanup "db_open(db): $!" if $!;
		820	};
		821	cf::cleanup "db_open(db): $@" if $@;
		822
		823	$db
		824	}
		825
		826	our $DB;
		827
		828	sub db_init {
		829	$DB ||= db_table "db";
		830	}
		831
		832	sub db_get($$) {
		833	my $key = "$_[0]/$_[1]";
		834
		835	cf::error "db_get called from main context"
		836	if $Coro::current == $Coro::main;
		837
		838	BDB::db_get $DB, undef, $key, my $data;
		839
		840	$! ? ()
		841	: $data
		842	}
		843
		844	sub db_put($$$) {
		845	BDB::dbreq_pri 4;
		846	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
		847	}
		848
		849	=item cf::cache $id => [$paths...], $processversion => $process
		850
		851	Generic caching function that returns the value of the resource $id,
		852	caching and regenerating as required.
		853
		854	This function can block.
		855
		856	=cut
		857
		858	sub cache {
		859	my ($id, $src, $processversion, $process) = @_;
		860
		861	my $meta =
		862	join "\x00",
		863	$processversion,
		864	map {
		865	aio_stat $_
		866	and Carp::croak "$_: $!";
		867
		868	($_, (stat _)[7,9])
		869	} @$src;
		870
		871	my $dbmeta = db_get cache => "$id/meta";
		872	if ($dbmeta ne $meta) {
		873	# changed, we may need to process
		874
		875	my @data;
		876	my $md5;
		877
		878	for (0 .. $#$src) {
		879	$data[$_] = load_file $src->[$_];
		880	}
		881
		882	# if processing is expensive, check
		883	# checksum first
		884	if (1) {
		885	$md5 =
		886	join "\x00",
		887	$processversion,
		888	map {
		889	cf::cede_to_tick;
		890	($src->[$_], Digest::MD5::md5_hex $data[$_])
		891	} 0.. $#$src;
		892
		893
		894	my $dbmd5 = db_get cache => "$id/md5";
		895	if ($dbmd5 eq $md5) {
		896	db_put cache => "$id/meta", $meta;
		897
		898	return db_get cache => "$id/data";
		899	}
		900	}
		901
		902	my $t1 = EV::time;
		903	my $data = $process->(\@data);
		904	my $t2 = EV::time;
		905
		906	info "cache: '$id' processed in ", $t2 - $t1, "s\n";
		907
		908	db_put cache => "$id/data", $data;
		909	db_put cache => "$id/md5" , $md5;
		910	db_put cache => "$id/meta", $meta;
		911
		912	return $data;
		913	}
		914
		915	db_get cache => "$id/data"
		916	}
		917
		918	=item cf::datalog type => key => value, ...
		919
		920	Log a datalog packet of the given type with the given key-value pairs.
		921
		922	=cut
		923
		924	sub datalog($@) {
		925	my ($type, %kv) = @_;
		926	info "DATALOG ", JSON::XS->new->ascii->encode ({ %kv, type => $type });
		927	}
		928
202	=back	929	=back
203		930
204	=cut	931	=cut
205		932
206	#############################################################################	933	#############################################################################
207		934
208	=head2 ATTACHABLE OBJECTS	935	=head2 ATTACHABLE OBJECTS
209		936
210	Many objects in crossfire are so-called attachable objects. That means you can	937	Many objects in deliantra are so-called attachable objects. That means you can
211	attach callbacks/event handlers (a collection of which is called an "attachment")	938	attach callbacks/event handlers (a collection of which is called an "attachment")
212	to it. All such attachable objects support the following methods.	939	to it. All such attachable objects support the following methods.
213		940
214	In the following description, CLASS can be any of C<global>, C<object>	941	In the following description, CLASS can be any of C<global>, C<object>
215	C<player>, C<client> or C<map> (i.e. the attachable objects in	942	C<player>, C<client> or C<map> (i.e. the attachable objects in
216	crossfire+).	943	Deliantra).
217		944
218	=over 4	945	=over 4
219		946
220	=item $attachable->attach ($attachment, key => $value...)	947	=item $attachable->attach ($attachment, key => $value...)
221		948
…		…
265	=item cf::CLASS::attachment $name, ...	992	=item cf::CLASS::attachment $name, ...
266		993
267	Register an attachment by C<$name> through which attachable objects of the	994	Register an attachment by C<$name> through which attachable objects of the
268	given CLASS can refer to this attachment.	995	given CLASS can refer to this attachment.
269		996
270	Some classes such as crossfire maps and objects can specify attachments	997	Some classes such as deliantra maps and objects can specify attachments
271	that are attached at load/instantiate time, thus the need for a name.	998	that are attached at load/instantiate time, thus the need for a name.
272		999
273	These calls expect any number of the following handler/hook descriptions:	1000	These calls expect any number of the following handler/hook descriptions:
274		1001
275	=over 4	1002	=over 4
…		…
335	our @CB_TYPE = (); # registry for type (cf-object class) based events	1062	our @CB_TYPE = (); # registry for type (cf-object class) based events
336	our @CB_MAP = ();	1063	our @CB_MAP = ();
337		1064
338	my %attachment;	1065	my %attachment;
339		1066
		1067	sub cf::attachable::thawer_merge {
		1068	# simply override everything except _meta
		1069	local $_[0]{_meta};
		1070	%{$_[0]} = %{$_[1]};
		1071	}
		1072
340	sub _attach_cb($$$$) {	1073	sub _attach_cb($$$$) {
341	my ($registry, $event, $prio, $cb) = @_;	1074	my ($registry, $event, $prio, $cb) = @_;
342		1075
343	use sort 'stable';	1076	use sort 'stable';
344		1077
…		…
378	$registry = $CB_TYPE[$object_type] ||= [];	1111	$registry = $CB_TYPE[$object_type] ||= [];
379		1112
380	} elsif ($type eq "subtype") {	1113	} elsif ($type eq "subtype") {
381	defined $object_type or Carp::croak "subtype specified without type";	1114	defined $object_type or Carp::croak "subtype specified without type";
382	my $object_subtype = shift @arg;	1115	my $object_subtype = shift @arg;
383	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_SUBTYPES] ||= [];	1116	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_TYPES] ||= [];
384		1117
385	} elsif ($type eq "package") {	1118	} elsif ($type eq "package") {
386	my $pkg = shift @arg;	1119	my $pkg = shift @arg;
387		1120
388	while (my ($name, $id) = each %cb_id) {	1121	while (my ($name, $id) = each %cb_id) {
…		…
393		1126
394	} elsif (exists $cb_id{$type}) {	1127	} elsif (exists $cb_id{$type}) {
395	_attach_cb $registry, $cb_id{$type}, $prio, shift @arg;	1128	_attach_cb $registry, $cb_id{$type}, $prio, shift @arg;
396		1129
397	} elsif (ref $type) {	1130	} elsif (ref $type) {
398	warn "attaching objects not supported, ignoring.\n";	1131	error "attaching objects not supported, ignoring.\n";
399		1132
400	} else {	1133	} else {
401	shift @arg;	1134	shift @arg;
402	warn "attach argument '$type' not supported, ignoring.\n";	1135	error "attach argument '$type' not supported, ignoring.\n";
403	}	1136	}
404	}	1137	}
405	}	1138	}
406		1139
407	sub _object_attach {	1140	sub _object_attach {
…		…
417	_attach $registry, $klass, @attach;	1150	_attach $registry, $klass, @attach;
418	}	1151	}
419		1152
420	$obj->{$name} = \%arg;	1153	$obj->{$name} = \%arg;
421	} else {	1154	} else {
422	warn "object uses attachment '$name' that is not available, postponing.\n";	1155	info "object uses attachment '$name' which is not available, postponing.\n";
423	}	1156	}
424		1157
425	$obj->{_attachment}{$name} = undef;	1158	$obj->{_attachment}{$name} = undef;
426	}	1159	}
427		1160
…		…
429	if (ref $_[0]) {	1162	if (ref $_[0]) {
430	_object_attach @_;	1163	_object_attach @_;
431	} else {	1164	} else {
432	_attach shift->_attach_registry, @_;	1165	_attach shift->_attach_registry, @_;
433	}	1166	}
		1167	_recalc_want;
434	};	1168	};
435		1169
436	# all those should be optimised	1170	# all those should be optimised
437	sub cf::attachable::detach {	1171	sub cf::attachable::detach {
438	my ($obj, $name) = @_;	1172	my ($obj, $name) = @_;
…		…
441	delete $obj->{_attachment}{$name};	1175	delete $obj->{_attachment}{$name};
442	reattach ($obj);	1176	reattach ($obj);
443	} else {	1177	} else {
444	Carp::croak "cannot, currently, detach class attachments";	1178	Carp::croak "cannot, currently, detach class attachments";
445	}	1179	}
		1180	_recalc_want;
446	};	1181	};
447		1182
448	sub cf::attachable::attached {	1183	sub cf::attachable::attached {
449	my ($obj, $name) = @_;	1184	my ($obj, $name) = @_;
450		1185
…		…
465	";	1200	";
466	die if $@;	1201	die if $@;
467	}	1202	}
468		1203
469	our $override;	1204	our $override;
470	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?	1205	our @INVOKE_RESULTS = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
471		1206
472	sub override {	1207	sub override {
473	$override = 1;	1208	$override = 1;
474	@invoke_results = ();	1209	@INVOKE_RESULTS = (@_);
475	}	1210	}
476		1211
477	sub do_invoke {	1212	sub do_invoke {
478	my $event = shift;	1213	my $event = shift;
479	my $callbacks = shift;	1214	my $callbacks = shift;
480		1215
481	@invoke_results = ();	1216	@INVOKE_RESULTS = ();
482		1217
483	local $override;	1218	local $override;
484		1219
485	for (@$callbacks) {	1220	for (@$callbacks) {
486	eval { &{$_->[1]} };	1221	eval { &{$_->[1]} };
487		1222
488	if ($@) {	1223	if ($@) {
489	warn "$@";
490	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";	1224	error "$@", "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
491	override;	1225	override;
492	}	1226	}
493		1227
494	return 1 if $override;	1228	return 1 if $override;
495	}	1229	}
496		1230
497	0	1231	0
498	}	1232	}
499		1233
500	=item $bool = cf::global::invoke (EVENT_CLASS_XXX, ...)	1234	=item $bool = cf::global->invoke (EVENT_CLASS_XXX, ...)
501		1235
502	=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)	1236	=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)
503		1237
504	Generate an object-specific event with the given arguments.	1238	Generate an object-specific event with the given arguments.
505		1239
506	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be	1240	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
507	removed in future versions), and there is no public API to access override	1241	removed in future versions), and there is no public API to access override
508	results (if you must, access C<@cf::invoke_results> directly).	1242	results (if you must, access C<@cf::INVOKE_RESULTS> directly).
509		1243
510	=back	1244	=back
511		1245
512	=cut	1246	=cut
513		1247
514	#############################################################################	1248	#############################################################################
515	# object support	1249	# object support
		1250
		1251	sub _object_equal($$);
		1252	sub _object_equal($$) {
		1253	my ($a, $b) = @_;
		1254
		1255	return 0 unless (ref $a) eq (ref $b);
		1256
		1257	if ("HASH" eq ref $a) {
		1258	my @ka = keys %$a;
		1259	my @kb = keys %$b;
		1260
		1261	return 0 if @ka != @kb;
		1262
		1263	for (0 .. $#ka) {
		1264	return 0 unless $ka[$_] eq $kb[$_];
		1265	return 0 unless _object_equal $a->{$ka[$_]}, $b->{$kb[$_]};
		1266	}
		1267
		1268	} elsif ("ARRAY" eq ref $a) {
		1269
		1270	return 0 if @$a != @$b;
		1271
		1272	for (0 .. $#$a) {
		1273	return 0 unless _object_equal $a->[$_], $b->[$_];
		1274	}
		1275
		1276	} elsif ($a ne $b) {
		1277	return 0;
		1278	}
		1279
		1280	1
		1281	}
		1282
		1283	our $SLOW_MERGES;#d#
		1284	sub _can_merge {
		1285	my ($ob1, $ob2) = @_;
		1286
		1287	++$SLOW_MERGES;#d#
		1288
		1289	# we do the slow way here
		1290	return _object_equal $ob1, $ob2
		1291	}
516		1292
517	sub reattach {	1293	sub reattach {
518	# basically do the same as instantiate, without calling instantiate	1294	# basically do the same as instantiate, without calling instantiate
519	my ($obj) = @_;	1295	my ($obj) = @_;
		1296
		1297	# no longer needed after getting rid of delete_package?
		1298	#bless $obj, ref $obj; # re-bless in case extensions have been reloaded
520		1299
521	my $registry = $obj->registry;	1300	my $registry = $obj->registry;
522		1301
523	@$registry = ();	1302	@$registry = ();
524		1303
…		…
529	for (@$attach) {	1308	for (@$attach) {
530	my ($klass, @attach) = @$_;	1309	my ($klass, @attach) = @$_;
531	_attach $registry, $klass, @attach;	1310	_attach $registry, $klass, @attach;
532	}	1311	}
533	} else {	1312	} else {
534	warn "object uses attachment '$name' that is not available, postponing.\n";	1313	info "object uses attachment '$name' that is not available, postponing.\n";
535	}	1314	}
536	}	1315	}
537	}	1316	}
538		1317
539	cf::attachable->attach (	1318	cf::attachable->attach (
540	prio => -1000000,	1319	prio => -1000000,
541	on_instantiate => sub {	1320	on_instantiate => sub {
542	my ($obj, $data) = @_;	1321	my ($obj, $data) = @_;
543		1322
544	$data = from_json $data;	1323	$data = decode_json $data;
545		1324
546	for (@$data) {	1325	for (@$data) {
547	my ($name, $args) = @$_;	1326	my ($name, $args) = @$_;
548		1327
549	$obj->attach ($name, %{$args || {} });	1328	$obj->attach ($name, %{$args || {} });
…		…
563	);	1342	);
564		1343
565	sub object_freezer_save {	1344	sub object_freezer_save {
566	my ($filename, $rdata, $objs) = @_;	1345	my ($filename, $rdata, $objs) = @_;
567		1346
		1347	sync_job {
568	if (length $$rdata) {	1348	if (length $$rdata) {
		1349	utf8::decode (my $decname = $filename);
569	warn sprintf "saving %s (%d,%d)\n",	1350	trace sprintf "saving %s (%d,%d)\n",
570	$filename, length $$rdata, scalar @$objs;	1351	$decname, length $$rdata, scalar @$objs
		1352	if $VERBOSE_IO;
571		1353
572	if (open my $fh, ">:raw", "$filename~") {	1354	if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {
573	chmod SAVE_MODE, $fh;
574	syswrite $fh, $$rdata;
575	close $fh;
576
577	if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
578	chmod SAVE_MODE, $fh;	1355	aio_chmod $fh, SAVE_MODE;
579	syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };	1356	aio_write $fh, 0, (length $$rdata), $$rdata, 0;
		1357	if ($cf::USE_FSYNC) {
		1358	aio_sync_file_range $fh, 0, 0, IO::AIO::SYNC_FILE_RANGE_WAIT_BEFORE | IO::AIO::SYNC_FILE_RANGE_WRITE | IO::AIO::SYNC_FILE_RANGE_WAIT_AFTER;
		1359	aio_fsync $fh;
		1360	}
580	close $fh;	1361	aio_close $fh;
		1362
		1363	if (@$objs) {
		1364	if (my $fh = aio_open "$filename.pst~", O_WRONLY | O_CREAT, 0600) {
		1365	aio_chmod $fh, SAVE_MODE;
		1366	my $data = Coro::Storable::nfreeze { version => 1, objs => $objs };
		1367	aio_write $fh, 0, (length $data), $data, 0;
		1368	if ($cf::USE_FSYNC) {
		1369	aio_sync_file_range $fh, 0, 0, IO::AIO::SYNC_FILE_RANGE_WAIT_BEFORE | IO::AIO::SYNC_FILE_RANGE_WRITE | IO::AIO::SYNC_FILE_RANGE_WAIT_AFTER;
		1370	aio_fsync $fh;
		1371	}
		1372	aio_close $fh;
581	rename "$filename.pst~", "$filename.pst";	1373	aio_rename "$filename.pst~", "$filename.pst";
		1374	}
		1375	} else {
		1376	aio_unlink "$filename.pst";
		1377	}
		1378
		1379	aio_rename "$filename~", $filename;
		1380
		1381	$filename =~ s%/[^/]+$%%;
		1382	aio_pathsync $filename if $cf::USE_FSYNC;
582	} else {	1383	} else {
583	unlink "$filename.pst";	1384	error "unable to save objects: $filename~: $!\n";
584	}	1385	}
585
586	rename "$filename~", $filename;
587	} else {	1386	} else {
588	warn "FATAL: $filename~: $!\n";
589	}
590	} else {
591	unlink $filename;	1387	aio_unlink $filename;
592	unlink "$filename.pst";	1388	aio_unlink "$filename.pst";
		1389	}
593	}	1390	};
594	}	1391	}
595		1392
596	sub object_freezer_as_string {	1393	sub object_freezer_as_string {
597	my ($rdata, $objs) = @_;	1394	my ($rdata, $objs) = @_;
598		1395
…		…
602	}	1399	}
603		1400
604	sub object_thawer_load {	1401	sub object_thawer_load {
605	my ($filename) = @_;	1402	my ($filename) = @_;
606		1403
607	local $/;
608
609	my $av;
610
611	#TODO: use sysread etc.
612	if (open my $data, "<:raw:perlio", $filename) {
613	$data = <$data>;
614	if (open my $pst, "<:raw:perlio", "$filename.pst") {
615	$av = eval { (Storable::thaw <$pst>)->{objs} };
616	}
617	return ($data, $av);	1404	my ($data, $av);
618	}
619		1405
620	()	1406	(aio_load $filename, $data) >= 0
		1407	or return;
		1408
		1409	unless (aio_stat "$filename.pst") {
		1410	(aio_load "$filename.pst", $av) >= 0
		1411	or return;
		1412
		1413	my $st = eval { Coro::Storable::thaw $av };
		1414	$av = $st->{objs};
		1415	}
		1416
		1417	utf8::decode (my $decname = $filename);
		1418	trace sprintf "loading %s (%d,%d)\n",
		1419	$decname, length $data, scalar @{$av || []}
		1420	if $VERBOSE_IO;
		1421
		1422	($data, $av)
621	}	1423	}
		1424
		1425	=head2 COMMAND CALLBACKS
		1426
		1427	=over 4
		1428
		1429	=cut
622		1430
623	#############################################################################	1431	#############################################################################
624	# command handling &c	1432	# command handling &c
625		1433
626	=item cf::register_command $name => \&callback($ob,$args);	1434	=item cf::register_command $name => \&callback($ob,$args)
627		1435
628	Register a callback for execution when the client sends the user command	1436	Register a callback for execution when the client sends the user command
629	$name.	1437	$name.
630		1438
631	=cut	1439	=cut
…		…
637	#warn "registering command '$name/$time' to '$caller'";	1445	#warn "registering command '$name/$time' to '$caller'";
638		1446
639	push @{ $COMMAND{$name} }, [$caller, $cb];	1447	push @{ $COMMAND{$name} }, [$caller, $cb];
640	}	1448	}
641		1449
642	=item cf::register_extcmd $name => \&callback($pl,$packet);	1450	=item cf::register_extcmd $name => \&callback($pl,@args)
643		1451
644	Register a callbackf ro execution when the client sends an extcmd packet.	1452	Register a callback for execution when the client sends an (synchronous)
		1453	extcmd packet. Ext commands will be processed in the order they are
		1454	received by the server, like other user commands. The first argument is
		1455	the logged-in player. Ext commands can only be processed after a player
		1456	has logged in successfully.
645		1457
646	If the callback returns something, it is sent back as if reply was being	1458	The values will be sent back to the client.
647	called.
648		1459
649	=cut	1460	=item cf::register_async_extcmd $name => \&callback($pl,$reply->(...),@args)
650		1461
		1462	Same as C<cf::register_extcmd>, but instead of returning values, the
		1463	callback needs to clal the C<$reply> function.
		1464
		1465	=item cf::register_exticmd $name => \&callback($ns,@args)
		1466
		1467	Register a callback for execution when the client sends an (asynchronous)
		1468	exticmd packet. Exti commands are processed by the server as soon as they
		1469	are received, i.e. out of order w.r.t. other commands. The first argument
		1470	is a client socket. Exti commands can be received anytime, even before
		1471	log-in.
		1472
		1473	The values will be sent back to the client.
		1474
		1475	=item cf::register_async_exticmd $name => \&callback($ns,$reply->(...),@args)
		1476
		1477	Same as C<cf::register_extcmd>, but instead of returning values, the
		1478	callback needs to clal the C<$reply> function.
		1479
		1480	=cut
		1481
651	sub register_extcmd {	1482	sub register_extcmd($$) {
652	my ($name, $cb) = @_;	1483	my ($name, $cb) = @_;
653		1484
654	my $caller = caller;
655	#warn "registering extcmd '$name' to '$caller'";
656
657	$EXTCMD{$name} = [$cb, $caller];	1485	$EXTCMD{$name} = $cb;
658	}	1486	}
		1487
		1488	sub register_async_extcmd($$) {
		1489	my ($name, $cb) = @_;
		1490
		1491	$EXTACMD{$name} = $cb;
		1492	}
		1493
		1494	sub register_exticmd($$) {
		1495	my ($name, $cb) = @_;
		1496
		1497	$EXTICMD{$name} = $cb;
		1498	}
		1499
		1500	sub register_async_exticmd($$) {
		1501	my ($name, $cb) = @_;
		1502
		1503	$EXTIACMD{$name} = $cb;
		1504	}
		1505
		1506	use File::Glob ();
659		1507
660	cf::player->attach (	1508	cf::player->attach (
661	on_command => sub {	1509	on_unknown_command => sub {
662	my ($pl, $name, $params) = @_;	1510	my ($pl, $name, $params) = @_;
663		1511
664	my $cb = $COMMAND{$name}	1512	my $cb = $COMMAND{$name}
665	or return;	1513	or return;
666		1514
…		…
671	cf::override;	1519	cf::override;
672	},	1520	},
673	on_extcmd => sub {	1521	on_extcmd => sub {
674	my ($pl, $buf) = @_;	1522	my ($pl, $buf) = @_;
675		1523
676	my $msg = eval { from_json $buf };	1524	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
677		1525
678	if (ref $msg) {	1526	if (ref $msg) {
		1527	my ($type, $reply, @payload) = @$msg; # version 1 used %type, $id, %$hash
		1528
679	if (my $cb = $EXTCMD{$msg->{msgtype}}) {	1529	if (my $cb = $EXTACMD{$type}) {
680	if (my %reply = $cb->[0]->($pl, $msg)) {	1530	$cb->(
681	$pl->ext_reply ($msg->{msgid}, %reply);	1531	$pl,
		1532	sub {
		1533	$pl->ext_msg ("reply-$reply", @_)
		1534	if $reply;
		1535	},
		1536	@payload
		1537	);
		1538	} else {
		1539	my @reply;
		1540
		1541	if (my $cb = $EXTCMD{$type}) {
		1542	@reply = $cb->($pl, @payload);
682	}	1543	}
		1544
		1545	$pl->ext_msg ("reply-$reply", @reply)
		1546	if $reply;
683	}	1547	}
		1548
684	} else {	1549	} else {
685	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";	1550	error "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
686	}	1551	}
687		1552
688	cf::override;	1553	cf::override;
689	},	1554	},
690	);	1555	);
691		1556
692	sub register {	1557	# "readahead" all extensions
693	my ($base, $pkg) = @_;
694
695	#TODO
696	}
697
698	sub load_extension {	1558	sub cache_extensions {
699	my ($path) = @_;	1559	my $grp = IO::AIO::aio_group;
700		1560
701	$path =~ /([^\/\\]+)\.ext$/ or die "$path";	1561	add $grp IO::AIO::aio_readdirx $LIBDIR, IO::AIO::READDIR_STAT_ORDER, sub {
702	my $base = $1;	1562	for (grep /\.ext$/, @{$_[0]}) {
703	my $pkg = $1;	1563	add $grp IO::AIO::aio_load "$LIBDIR/$_", my $data;
704	$pkg =~ s/[^[:word:]]/_/g;
705	$pkg = "ext::$pkg";
706
707	warn "loading '$path' into '$pkg'\n";
708
709	open my $fh, "<:utf8", $path
710	or die "$path: $!";
711
712	my $source =
713	"package $pkg; use strict; use utf8;\n"
714	. "#line 1 \"$path\"\n{\n"
715	. (do { local $/; <$fh> })
716	. "\n};\n1";
717
718	eval $source
719	or die $@ ? "$path: $@\n"
720	: "extension disabled.\n";
721
722	push @exts, $pkg;
723	$ext_pkg{$base} = $pkg;
724
725	# no strict 'refs';
726	# @{"$pkg\::ISA"} = ext::;
727
728	register $base, $pkg;
729	}
730
731	sub unload_extension {
732	my ($pkg) = @_;
733
734	warn "removing extension $pkg\n";
735
736	# remove hooks
737	#TODO
738	# for my $idx (0 .. $#PLUGIN_EVENT) {
739	# delete $hook[$idx]{$pkg};
740	# }
741
742	# remove commands
743	for my $name (keys %COMMAND) {
744	my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };
745
746	if (@cb) {
747	$COMMAND{$name} = \@cb;
748	} else {
749	delete $COMMAND{$name};
750	}	1564	}
751	}	1565	};
752		1566
753	# remove extcmds	1567	$grp
754	for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {	1568	}
755	delete $EXTCMD{$name};
756	}
757		1569
758	if (my $cb = $pkg->can ("unload")) {	1570	sub _ext_cfg_reg($$$$) {
759	eval {	1571	my ($rvar, $varname, $cfgname, $default) = @_;
760	$cb->($pkg);
761	1
762	} or warn "$pkg unloaded, but with errors: $@";
763	}
764		1572
765	Symbol::delete_package $pkg;	1573	$cfgname = lc $varname
		1574	unless length $cfgname;
		1575
		1576	$EXT_CFG{$cfgname} = [$rvar, $default];
		1577
		1578	$$rvar = exists $CFG{$cfgname} ? $CFG{$cfgname} : $default;
766	}	1579	}
767		1580
768	sub load_extensions {	1581	sub load_extensions {
		1582	info "loading extensions...";
		1583
		1584	%EXT_CFG = ();
		1585
		1586	cf::sync_job {
		1587	my %todo;
		1588
769	for my $ext (<$LIBDIR/*.ext>) {	1589	for my $path (<$LIBDIR/*.ext>) {
770	next unless -r $ext;	1590	next unless -r $path;
771	eval {	1591
772	load_extension $ext;	1592	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
		1593	my $base = $1;
		1594	my $pkg = $1;
		1595	$pkg =~ s/[^[:word:]]/_/g;
		1596	$pkg = "ext::$pkg";
		1597
		1598	open my $fh, "<:utf8", $path
		1599	or die "$path: $!";
		1600
		1601	my $source = do { local $/; <$fh> };
		1602
		1603	my %ext = (
		1604	path => $path,
		1605	base => $base,
		1606	pkg => $pkg,
		1607	);
		1608
		1609	$ext{meta} = { map { (split /=/, $_, 2)[0, 1] } split /\s+/, $1 }
		1610	if $source =~ /\A#!.*?perl.*?#\s*(.*)$/m;
		1611
		1612	$ext{source} =
		1613	"package $pkg; use common::sense;\n"
		1614	. "#line 1 \"$path\"\n{\n"
		1615	. $source
		1616	. "\n};\n1";
		1617
		1618	$todo{$base} = \%ext;
		1619	}
		1620
		1621	my $pass = 0;
		1622	my %done;
		1623	while (%todo) {
		1624	my $progress;
		1625
		1626	++$pass;
		1627
		1628	ext:
		1629	while (my ($k, $v) = each %todo) {
		1630	for (split /,\s*/, $v->{meta}{depends}) {
		1631	next ext
		1632	unless exists $done{$_};
		1633	}
		1634
		1635	trace "... pass $pass, loading '$k' into '$v->{pkg}'\n";
		1636
		1637	my $source = $v->{source};
		1638
		1639	# support "CONF varname :confname = default" pseudo-statements
		1640	$source =~ s{
		1641	^ CONF \s+ ([^\s:=]+) \s* (?:: \s* ([^\s:=]+) \s* )? = ([^\n#]+)
		1642	}{
		1643	"our \$$1; BEGIN { cf::_ext_cfg_reg \\\$$1, q\x00$1\x00, q\x00$2\x00, $3 }";
		1644	}gmxe;
		1645
		1646	my $active = eval $source;
		1647
		1648	if (length $@) {
		1649	error "$v->{path}: $@\n";
		1650
		1651	cf::cleanup "mandatory extension '$k' failed to load, exiting."
		1652	if exists $v->{meta}{mandatory};
		1653
		1654	warn "$v->{base}: optional extension cannot be loaded, skipping.\n";
		1655	delete $todo{$k};
		1656	} else {
		1657	$done{$k} = delete $todo{$k};
		1658	push @EXTS, $v->{pkg};
		1659	$progress = 1;
		1660
		1661	info "$v->{base}: extension inactive.\n"
		1662	unless $active;
		1663	}
773	1	1664	}
774	} or warn "$ext not loaded: $@";	1665
		1666	unless ($progress) {
		1667	warn "cannot load " . (join ", ", keys %todo) . ": unable to resolve dependencies\n";
		1668
		1669	while (my ($k, $v) = each %todo) {
		1670	cf::cleanup "mandatory extension '$k' has unresolved dependencies, exiting."
		1671	if exists $v->{meta}{mandatory};
		1672	}
		1673
		1674	last;
		1675	}
		1676	}
775	}	1677	};
776	}	1678	}
777		1679
778	#############################################################################	1680	#############################################################################
779	# load/save/clean perl data associated with a map
780		1681
781	*cf::mapsupport::on_clean = sub {	1682	=back
		1683
		1684	=head2 CORE EXTENSIONS
		1685
		1686	Functions and methods that extend core deliantra objects.
		1687
		1688	=cut
		1689
		1690	package cf::player;
		1691
		1692	use Coro::AIO;
		1693
		1694	=head3 cf::player
		1695
		1696	=over 4
		1697
		1698	=item cf::player::num_playing
		1699
		1700	Returns the official number of playing players, as per the Crossfire metaserver rules.
		1701
		1702	=cut
		1703
		1704	sub num_playing {
		1705	scalar grep
		1706	$_->ob->map
		1707	&& !$_->hidden
		1708	&& !$_->ob->flag (cf::FLAG_WIZ),
		1709	cf::player::list
		1710	}
		1711
		1712	=item cf::player::find $login
		1713
		1714	Returns the given player object, loading it if necessary (might block).
		1715
		1716	=cut
		1717
		1718	sub playerdir($) {
		1719	"$PLAYERDIR/"
		1720	. (ref $_[0] ? $_[0]->ob->name : $_[0])
		1721	}
		1722
		1723	sub path($) {
		1724	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
		1725
		1726	(playerdir $login) . "/playerdata"
		1727	}
		1728
		1729	sub find_active($) {
		1730	$cf::PLAYER{$_[0]}
		1731	and $cf::PLAYER{$_[0]}->active
		1732	and $cf::PLAYER{$_[0]}
		1733	}
		1734
		1735	sub exists($) {
782	my ($map) = @_;	1736	my ($login) = @_;
783		1737
784	my $path = $map->tmpname;	1738	$cf::PLAYER{$login}
785	defined $path or return;	1739	or !aio_stat path $login
786
787	unlink "$path.pst";
788	};
789
790	cf::map->attach (prio => -10000, package => cf::mapsupport::);
791
792	#############################################################################
793	# load/save perl data associated with player->ob objects
794
795	sub all_objects(@) {
796	@_, map all_objects ($_->inv), @_
797	}	1740	}
798		1741
799	# TODO: compatibility cruft, remove when no longer needed	1742	sub find($) {
		1743	return $cf::PLAYER{$_[0]} || do {
		1744	my $login = $_[0];
		1745
		1746	my $guard = cf::lock_acquire "user_find:$login";
		1747
		1748	$cf::PLAYER{$_[0]} || do {
		1749	# rename old playerfiles to new ones
		1750	#TODO: remove when no longer required
		1751	aio_link +(playerdir $login) . "/$login.pl.pst", (playerdir $login) . "/playerdata.pst";
		1752	aio_link +(playerdir $login) . "/$login.pl" , (playerdir $login) . "/playerdata";
		1753	aio_unlink +(playerdir $login) . "/$login.pl.pst";
		1754	aio_unlink +(playerdir $login) . "/$login.pl";
		1755
		1756	my $f = new_from_file cf::object::thawer path $login
		1757	or return;
		1758
		1759	my $pl = cf::player::load_pl $f
		1760	or return;
		1761
		1762	local $cf::PLAYER_LOADING{$login} = $pl;
		1763	$f->resolve_delayed_derefs;
		1764	$cf::PLAYER{$login} = $pl
		1765	}
		1766	}
		1767	}
		1768
800	cf::player->attach (	1769	cf::player->attach (
801	on_load => sub {	1770	on_load => sub {
802	my ($pl, $path) = @_;	1771	my ($pl, $path) = @_;
803		1772
804	for my $o (all_objects $pl->ob) {	1773	# restore slots saved in save, below
805	if (my $value = $o->get_ob_key_value ("_perl_data")) {	1774	my $slots = delete $pl->{_slots};
806	$o->set_ob_key_value ("_perl_data");
807		1775
808	%$o = %{ Storable::thaw pack "H*", $value };	1776	$pl->ob->current_weapon ($slots->[0]);
809	}	1777	$pl->combat_ob ($slots->[1]);
810	}	1778	$pl->ranged_ob ($slots->[2]);
811	},	1779	},
812	);	1780	);
813		1781
814	#############################################################################	1782	sub save($) {
		1783	my ($pl) = @_;
815		1784
816	=head2 CORE EXTENSIONS	1785	return if $pl->{deny_save};
817		1786
818	Functions and methods that extend core crossfire objects.	1787	my $path = path $pl;
		1788	my $guard = cf::lock_acquire "user_save:$path";
819		1789
820	=head3 cf::player	1790	return if $pl->{deny_save};
		1791
		1792	aio_mkdir playerdir $pl, 0770;
		1793	$pl->{last_save} = $cf::RUNTIME;
		1794
		1795	cf::get_slot 0.01;
		1796
		1797	# save slots, to be restored later
		1798	local $pl->{_slots} = [$pl->ob->current_weapon, $pl->combat_ob, $pl->ranged_ob];
		1799
		1800	$pl->save_pl ($path);
		1801	cf::cede_to_tick;
		1802	}
		1803
		1804	sub new($) {
		1805	my ($login) = @_;
		1806
		1807	my $self = create;
		1808
		1809	$self->ob->name ($login);
		1810	$self->{deny_save} = 1;
		1811
		1812	$cf::PLAYER{$login} = $self;
		1813
		1814	$self
		1815	}
		1816
		1817	=item $player->send_msg ($channel, $msg, $color, [extra...])
		1818
		1819	=cut
		1820
		1821	sub send_msg {
		1822	my $ns = shift->ns
		1823	or return;
		1824	$ns->send_msg (@_);
		1825	}
		1826
		1827	=item $pl->quit_character
		1828
		1829	Nukes the player without looking back. If logged in, the connection will
		1830	be destroyed. May block for a long time.
		1831
		1832	=cut
		1833
		1834	sub quit_character {
		1835	my ($pl) = @_;
		1836
		1837	my $name = $pl->ob->name;
		1838
		1839	$pl->{deny_save} = 1;
		1840	$pl->password ("*"); # this should lock out the player until we have nuked the dir
		1841
		1842	$pl->invoke (cf::EVENT_PLAYER_LOGOUT, 1) if $pl->ns;
		1843	$pl->deactivate;
		1844
		1845	my $killer = cf::arch::get "killer_quit"; $pl->killer ($killer); $killer->destroy;
		1846	$pl->invoke (cf::EVENT_PLAYER_QUIT) if $pl->ns;
		1847	ext::highscore::check ($pl->ob);
		1848
		1849	$pl->ns->destroy if $pl->ns;
		1850
		1851	my $path = playerdir $pl;
		1852	my $temp = "$path~$cf::RUNTIME~deleting~";
		1853	aio_rename $path, $temp;
		1854	delete $cf::PLAYER{$pl->ob->name};
		1855	$pl->destroy;
		1856
		1857	my $prefix = qr<^~\Q$name\E/>;
		1858
		1859	# nuke player maps
		1860	$cf::MAP{$_}->nuke for grep /$prefix/, keys %cf::MAP;
		1861
		1862	IO::AIO::aio_rmtree $temp;
		1863	}
		1864
		1865	=item $pl->kick
		1866
		1867	Kicks a player out of the game. This destroys the connection.
		1868
		1869	=cut
		1870
		1871	sub kick {
		1872	my ($pl, $kicker) = @_;
		1873
		1874	$pl->invoke (cf::EVENT_PLAYER_KICK, $kicker);
		1875	$pl->killer ("kicked");
		1876	$pl->ns->destroy;
		1877	}
		1878
		1879	=item cf::player::list_logins
		1880
		1881	Returns am arrayref of all valid playernames in the system, can take a
		1882	while and may block, so not sync_job-capable, ever.
		1883
		1884	=cut
		1885
		1886	sub list_logins {
		1887	my $dirs = aio_readdir $PLAYERDIR
		1888	or return [];
		1889
		1890	my @logins;
		1891
		1892	for my $login (@$dirs) {
		1893	my $path = path $login;
		1894
		1895	# a .pst is a dead give-away for a valid player
		1896	# if no pst file found, open and chekc for blocked users
		1897	if (aio_stat "$path.pst") {
		1898	my $fh = aio_open $path, Fcntl::O_RDONLY, 0 or next;
		1899	aio_read $fh, 0, 512, my $buf, 0 or next;
		1900	$buf !~ /^password -------------$/m or next; # official not-valid tag
		1901	}
		1902
		1903	utf8::decode $login;
		1904	push @logins, $login;
		1905	}
		1906
		1907	\@logins
		1908	}
		1909
		1910	=item $player->maps
		1911
		1912	=item cf::player::maps $login
		1913
		1914	Returns an arrayref of map paths that are private for this
		1915	player. May block.
		1916
		1917	=cut
		1918
		1919	sub maps($) {
		1920	my ($pl) = @_;
		1921
		1922	$pl = ref $pl ? $pl->ob->name : $pl;
		1923
		1924	my $files = aio_readdir playerdir $pl
		1925	or return;
		1926
		1927	my @paths;
		1928
		1929	for (@$files) {
		1930	utf8::decode $_;
		1931	next if /\.(?:pl|pst)$/;
		1932	next unless /^$PATH_SEP/o;
		1933
		1934	push @paths, cf::map::normalise "~$pl/$_";
		1935	}
		1936
		1937	\@paths
		1938	}
		1939
		1940	=item $protocol_xml = $player->expand_cfpod ($cfpod)
		1941
		1942	Expand deliantra pod fragments into protocol xml.
		1943
		1944	=item $player->ext_msg ($type, @msg)
		1945
		1946	Sends an ext event to the client.
		1947
		1948	=cut
		1949
		1950	sub ext_msg($$@) {
		1951	my ($self, $type, @msg) = @_;
		1952
		1953	$self->ns->ext_msg ($type, @msg);
		1954	}
		1955
		1956	=head3 cf::region
821		1957
822	=over 4	1958	=over 4
823		1959
824	=item cf::player::exists $login
825
826	Returns true when the given account exists.
827
828	=cut	1960	=cut
829		1961
830	sub cf::player::exists($) {	1962	package cf::region;
831	cf::player::find $_[0]
832	or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
833	}
834		1963
835	=item $player->ext_reply ($msgid, $msgtype, %msg)	1964	=item cf::region::find_by_path $path
836		1965
837	Sends an ext reply to the player.	1966	Tries to decuce the likely region for a map knowing only its path.
838		1967
839	=cut	1968	=cut
840		1969
841	sub cf::player::ext_reply($$$%) {	1970	sub find_by_path($) {
		1971	my ($path) = @_;
		1972
		1973	$path =~ s/^~[^\/]*//; # skip ~login
		1974
		1975	my ($match, $specificity);
		1976
		1977	for my $region (list) {
		1978	if ($region->{match} && $path =~ $region->{match}) {
		1979	($match, $specificity) = ($region, $region->specificity)
		1980	if $region->specificity > $specificity;
		1981	}
		1982	}
		1983
		1984	$match
		1985	}
		1986
		1987	=back
		1988
		1989	=head3 cf::map
		1990
		1991	=over 4
		1992
		1993	=cut
		1994
		1995	package cf::map;
		1996
		1997	use Fcntl;
		1998	use Coro::AIO;
		1999
		2000	use overload
		2001	'""' => \&as_string,
		2002	fallback => 1;
		2003
		2004	our $MAX_RESET = 3600;
		2005	our $DEFAULT_RESET = 3000;
		2006
		2007	sub generate_random_map {
		2008	my ($self, $rmp) = @_;
		2009
		2010	my $lock = cf::lock_acquire "generate_random_map"; # the random map generator is NOT reentrant ATM
		2011
		2012	$self->_create_random_map ($rmp);
		2013	}
		2014
		2015	=item cf::map->register ($regex, $prio)
		2016
		2017	Register a handler for the map path matching the given regex at the
		2018	givne priority (higher is better, built-in handlers have priority 0, the
		2019	default).
		2020
		2021	=cut
		2022
		2023	sub register {
		2024	my (undef, $regex, $prio) = @_;
		2025	my $pkg = caller;
		2026
		2027	push @{"$pkg\::ISA"}, __PACKAGE__;
		2028
		2029	$EXT_MAP{$pkg} = [$prio, qr<$regex>];
		2030	}
		2031
		2032	# also paths starting with '/'
		2033	$EXT_MAP{"cf::map::wrap"} = [0, qr{^(?=/)}];
		2034
		2035	sub thawer_merge {
842	my ($self, $id, %msg) = @_;	2036	my ($self, $merge) = @_;
843		2037
844	$msg{msgid} = $id;	2038	# we have to keep some variables in memory intact
		2039	local $self->{path};
		2040	local $self->{load_path};
845		2041
846	$self->send ("ext " . to_json \%msg);	2042	$self->SUPER::thawer_merge ($merge);
847	}	2043	}
		2044
		2045	sub normalise {
		2046	my ($path, $base) = @_;
		2047
		2048	$path = "$path"; # make sure it's a string
		2049
		2050	$path =~ s/\.map$//;
		2051
		2052	# map plan:
		2053	#
		2054	# /! non-realised random map exit (special hack!)
		2055	# {... are special paths that are not being touched
		2056	# ?xxx/... are special absolute paths
		2057	# ?random/... random maps
		2058	# /... normal maps
		2059	# ~user/... per-player map of a specific user
		2060
		2061	$path =~ s/$PATH_SEP/\//go;
		2062
		2063	# treat it as relative path if it starts with
		2064	# something that looks reasonable
		2065	if ($path =~ m{^(?:\./|\.\./|\w)}) {
		2066	$base or Carp::carp "normalise called with relative path and no base: '$path'";
		2067
		2068	$base =~ s{[^/]+/?$}{};
		2069	$path = "$base/$path";
		2070	}
		2071
		2072	for ($path) {
		2073	redo if s{/\.?/}{/};
		2074	redo if s{/[^/]+/\.\./}{/};
		2075	}
		2076
		2077	$path
		2078	}
		2079
		2080	sub new_from_path {
		2081	my (undef, $path, $base) = @_;
		2082
		2083	return $path if UNIVERSAL::isa $path, "cf::map"; # already a map object
		2084
		2085	$path = normalise $path, $base;
		2086
		2087	for my $pkg (sort { $EXT_MAP{$b}[0] <=> $EXT_MAP{$a}[0] } keys %EXT_MAP) {
		2088	if ($path =~ $EXT_MAP{$pkg}[1]) {
		2089	my $self = bless cf::map::new, $pkg;
		2090	$self->{path} = $path; $self->path ($path);
		2091	$self->init; # pass $1 etc.
		2092	return $self;
		2093	}
		2094	}
		2095
		2096	Carp::cluck "unable to resolve path '$path' (base '$base')";
		2097	()
		2098	}
		2099
		2100	# may re-bless or do other evil things
		2101	sub init {
		2102	my ($self) = @_;
		2103
		2104	$self
		2105	}
		2106
		2107	sub as_string {
		2108	my ($self) = @_;
		2109
		2110	"$self->{path}"
		2111	}
		2112
		2113	# the displayed name, this is a one way mapping
		2114	sub visible_name {
		2115	&as_string
		2116	}
		2117
		2118	# the original (read-only) location
		2119	sub load_path {
		2120	my ($self) = @_;
		2121
		2122	"$MAPDIR/$self->{path}.map"
		2123	}
		2124
		2125	# the temporary/swap location
		2126	sub save_path {
		2127	my ($self) = @_;
		2128
		2129	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/go;
		2130	"$TMPDIR/$path.map"
		2131	}
		2132
		2133	# the unique path, undef == no special unique path
		2134	sub uniq_path {
		2135	my ($self) = @_;
		2136
		2137	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/go;
		2138	"$UNIQUEDIR/$path"
		2139	}
		2140
		2141	sub decay_objects {
		2142	my ($self) = @_;
		2143
		2144	return if $self->{deny_reset};
		2145
		2146	$self->do_decay_objects;
		2147	}
		2148
		2149	sub unlink_save {
		2150	my ($self) = @_;
		2151
		2152	utf8::encode (my $save = $self->save_path);
		2153	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
		2154	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink "$save.pst";
		2155	}
		2156
		2157	sub load_header_from($) {
		2158	my ($self, $path) = @_;
		2159
		2160	utf8::encode $path;
		2161	my $f = new_from_file cf::object::thawer $path
		2162	or return;
		2163
		2164	$self->_load_header ($f)
		2165	or return;
		2166
		2167	local $MAP_LOADING{$self->{path}} = $self;
		2168	$f->resolve_delayed_derefs;
		2169
		2170	$self->{load_path} = $path;
		2171
		2172	1
		2173	}
		2174
		2175	# used to laod the header of an original map
		2176	sub load_header_orig {
		2177	my ($self) = @_;
		2178
		2179	$self->load_header_from ($self->load_path)
		2180	}
		2181
		2182	# used to laod the header of an instantiated map
		2183	sub load_header_temp {
		2184	my ($self) = @_;
		2185
		2186	$self->load_header_from ($self->save_path)
		2187	}
		2188
		2189	# called after loading the header from an instantiated map
		2190	sub prepare_temp {
		2191	my ($self) = @_;
		2192
		2193	$self->last_access ((delete $self->{last_access})
		2194	|| $cf::RUNTIME); #d#
		2195	# safety
		2196	$self->{instantiate_time} = $cf::RUNTIME
		2197	if $self->{instantiate_time} > $cf::RUNTIME;
		2198	}
		2199
		2200	# called after loading the header from an original map
		2201	sub prepare_orig {
		2202	my ($self) = @_;
		2203
		2204	$self->{load_original} = 1;
		2205	$self->{instantiate_time} = $cf::RUNTIME;
		2206	$self->last_access ($cf::RUNTIME);
		2207	$self->instantiate;
		2208	}
		2209
		2210	sub load_header {
		2211	my ($self) = @_;
		2212
		2213	if ($self->load_header_temp) {
		2214	$self->prepare_temp;
		2215	} else {
		2216	$self->load_header_orig
		2217	or return;
		2218	$self->prepare_orig;
		2219	}
		2220
		2221	$self->{deny_reset} = 1
		2222	if $self->no_reset;
		2223
		2224	$self->default_region (cf::region::find_by_path $self->{path})
		2225	unless $self->default_region;
		2226
		2227	1
		2228	}
		2229
		2230	sub find;
		2231	sub find {
		2232	my ($path, $origin) = @_;
		2233
		2234	cf::cede_to_tick;
		2235
		2236	$path = normalise $path, $origin;
		2237
		2238	my $guard1 = cf::lock_acquire "map_data:$path";#d#remove
		2239	my $guard2 = cf::lock_acquire "map_find:$path";
		2240
		2241	$cf::MAP{$path} || do {
		2242	my $map = new_from_path cf::map $path
		2243	or return;
		2244
		2245	$map->{last_save} = $cf::RUNTIME;
		2246
		2247	$map->load_header
		2248	or return;
		2249
		2250	if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
		2251	# doing this can freeze the server in a sync job, obviously
		2252	#$cf::WAIT_FOR_TICK->wait;
		2253	undef $guard2;
		2254	undef $guard1;
		2255	$map->reset;
		2256	return find $path;
		2257	}
		2258
		2259	$cf::MAP{$path} = $map
		2260	}
		2261	}
		2262
		2263	sub pre_load { }
		2264	#sub post_load { } # XS
		2265
		2266	sub load {
		2267	my ($self) = @_;
		2268
		2269	local $self->{deny_reset} = 1; # loading can take a long time
		2270
		2271	my $path = $self->{path};
		2272
		2273	{
		2274	my $guard = cf::lock_acquire "map_data:$path";
		2275
		2276	return unless $self->valid;
		2277	return unless $self->state == cf::MAP_SWAPPED;
		2278
		2279	$self->alloc;
		2280
		2281	$self->pre_load;
		2282	cf::cede_to_tick;
		2283
		2284	if (exists $self->{load_path}) {
		2285	my $f = new_from_file cf::object::thawer $self->{load_path};
		2286	$f->skip_block;
		2287	$self->_load_objects ($f)
		2288	or return;
		2289
		2290	$self->post_load_original
		2291	if delete $self->{load_original};
		2292
		2293	if (my $uniq = $self->uniq_path) {
		2294	utf8::encode $uniq;
		2295	unless (aio_stat $uniq) {
		2296	if (my $f = new_from_file cf::object::thawer $uniq) {
		2297	$self->clear_unique_items;
		2298	$self->_load_objects ($f);
		2299	$f->resolve_delayed_derefs;
		2300	}
		2301	}
		2302	}
		2303
		2304	$f->resolve_delayed_derefs;
		2305	} else {
		2306	$self->post_load_original
		2307	if delete $self->{load_original};
		2308	}
		2309
		2310	$self->state (cf::MAP_INACTIVE);
		2311
		2312	cf::cede_to_tick;
		2313	# now do the right thing for maps
		2314	$self->link_multipart_objects;
		2315	$self->difficulty ($self->estimate_difficulty)
		2316	unless $self->difficulty;
		2317	cf::cede_to_tick;
		2318
		2319	unless ($self->{deny_activate}) {
		2320	$self->decay_objects;
		2321	$self->fix_auto_apply;
		2322	$self->update_buttons;
		2323	cf::cede_to_tick;
		2324	#$self->activate; # no longer activate maps automatically
		2325	}
		2326
		2327	$self->{last_save} = $cf::RUNTIME;
		2328	$self->last_access ($cf::RUNTIME);
		2329	}
		2330
		2331	$self->post_load;
		2332
		2333	1
		2334	}
		2335
		2336	# customize the map for a given player, i.e.
		2337	# return the _real_ map. used by e.g. per-player
		2338	# maps to change the path to ~playername/mappath
		2339	sub customise_for {
		2340	my ($self, $ob) = @_;
		2341
		2342	return find "~" . $ob->name . "/" . $self->{path}
		2343	if $self->per_player;
		2344
		2345	# return find "?party/" . $ob->name . "/" . $self->{path}
		2346	# if $self->per_party;
		2347
		2348	$self
		2349	}
		2350
		2351	sub find_sync {
		2352	my ($path, $origin) = @_;
		2353
		2354	# it's a bug to call this from the main context
		2355	return cf::LOG cf::llevError | cf::logBacktrace, "do_find_sync"
		2356	if $Coro::current == $Coro::main;
		2357
		2358	find $path, $origin
		2359	}
		2360
		2361	sub do_load_sync {
		2362	my ($map) = @_;
		2363
		2364	# it's a bug to call this from the main context
		2365	return cf::LOG cf::llevError | cf::logBacktrace, "do_load_sync"
		2366	if $Coro::current == $Coro::main;
		2367
		2368	$map->load;
		2369	}
		2370
		2371	our %MAP_PREFETCH;
		2372	our $MAP_PREFETCHER = undef;
		2373
		2374	sub find_async {
		2375	my ($path, $origin, $load) = @_;
		2376
		2377	$path = normalise $path, $origin;
		2378
		2379	if (my $map = $cf::MAP{$path}) {
		2380	return $map if !$load || $map->linkable;
		2381	}
		2382
		2383	$MAP_PREFETCH{$path} |= $load;
		2384
		2385	$MAP_PREFETCHER ||= cf::async {
		2386	$Coro::current->{desc} = "map prefetcher";
		2387
		2388	while (%MAP_PREFETCH) {
		2389	while (my ($k, $v) = each %MAP_PREFETCH) {
		2390	if (my $map = find $k) {
		2391	$map->load if $v;
		2392	}
		2393
		2394	delete $MAP_PREFETCH{$k};
		2395	}
		2396	}
		2397	undef $MAP_PREFETCHER;
		2398	};
		2399	$MAP_PREFETCHER->prio (6);
		2400
		2401	()
		2402	}
		2403
		2404	# common code, used by both ->save and ->swapout
		2405	sub _save {
		2406	my ($self) = @_;
		2407
		2408	$self->{last_save} = $cf::RUNTIME;
		2409
		2410	return unless $self->dirty;
		2411
		2412	my $save = $self->save_path; utf8::encode $save;
		2413	my $uniq = $self->uniq_path; utf8::encode $uniq;
		2414
		2415	$self->{load_path} = $save;
		2416
		2417	return if $self->{deny_save};
		2418
		2419	local $self->{last_access} = $self->last_access;#d#
		2420
		2421	cf::async {
		2422	$Coro::current->{desc} = "map player save";
		2423	$_->contr->save for $self->players;
		2424	};
		2425
		2426	cf::get_slot 0.02;
		2427
		2428	if ($uniq) {
		2429	$self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
		2430	$self->_save_objects ($uniq, cf::IO_UNIQUES);
		2431	} else {
		2432	$self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
		2433	}
		2434	}
		2435
		2436	sub save {
		2437	my ($self) = @_;
		2438
		2439	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2440
		2441	$self->_save;
		2442	}
		2443
		2444	sub swap_out {
		2445	my ($self) = @_;
		2446
		2447	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2448
		2449	return if !$self->linkable;
		2450	return if $self->{deny_save};
		2451	return if $self->players;
		2452
		2453	# first deactivate the map and "unlink" it from the core
		2454	$self->deactivate;
		2455	$_->clear_links_to ($self) for values %cf::MAP;
		2456	$self->state (cf::MAP_SWAPPED);
		2457
		2458	# then atomically save
		2459	$self->_save;
		2460
		2461	# then free the map
		2462	$self->clear;
		2463	}
		2464
		2465	sub reset_at {
		2466	my ($self) = @_;
		2467
		2468	# TODO: safety, remove and allow resettable per-player maps
		2469	return 1e99 if $self->{deny_reset};
		2470
		2471	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
		2472	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
		2473
		2474	$time + $to
		2475	}
		2476
		2477	sub should_reset {
		2478	my ($self) = @_;
		2479
		2480	$self->reset_at <= $cf::RUNTIME
		2481	}
		2482
		2483	sub reset {
		2484	my ($self) = @_;
		2485
		2486	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2487
		2488	return if $self->players;
		2489
		2490	cf::trace "resetting map ", $self->path, "\n";
		2491
		2492	$self->state (cf::MAP_SWAPPED);
		2493
		2494	# need to save uniques path
		2495	unless ($self->{deny_save}) {
		2496	my $uniq = $self->uniq_path; utf8::encode $uniq;
		2497
		2498	$self->_save_objects ($uniq, cf::IO_UNIQUES)
		2499	if $uniq;
		2500	}
		2501
		2502	delete $cf::MAP{$self->path};
		2503
		2504	$self->deactivate;
		2505	$_->clear_links_to ($self) for values %cf::MAP;
		2506	$self->clear;
		2507
		2508	$self->unlink_save;
		2509	$self->destroy;
		2510	}
		2511
		2512	my $nuke_counter = "aaaa";
		2513
		2514	sub nuke {
		2515	my ($self) = @_;
		2516
		2517	{
		2518	my $lock = cf::lock_acquire "map_data:$self->{path}";
		2519
		2520	delete $cf::MAP{$self->path};
		2521
		2522	$self->unlink_save;
		2523
		2524	bless $self, "cf::map::wrap";
		2525	delete $self->{deny_reset};
		2526	$self->{deny_save} = 1;
		2527	$self->reset_timeout (1);
		2528	$self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));
		2529
		2530	$cf::MAP{$self->path} = $self;
		2531	}
		2532
		2533	$self->reset; # polite request, might not happen
		2534	}
		2535
		2536	=item $maps = cf::map::tmp_maps
		2537
		2538	Returns an arrayref with all map paths of currently instantiated and saved
		2539	maps. May block.
		2540
		2541	=cut
		2542
		2543	sub tmp_maps() {
		2544	[
		2545	map {
		2546	utf8::decode $_;
		2547	/\.map$/
		2548	? normalise $_
		2549	: ()
		2550	} @{ aio_readdir $TMPDIR or [] }
		2551	]
		2552	}
		2553
		2554	=item $maps = cf::map::random_maps
		2555
		2556	Returns an arrayref with all map paths of currently instantiated and saved
		2557	random maps. May block.
		2558
		2559	=cut
		2560
		2561	sub random_maps() {
		2562	[
		2563	map {
		2564	utf8::decode $_;
		2565	/\.map$/
		2566	? normalise "?random/$_"
		2567	: ()
		2568	} @{ aio_readdir $RANDOMDIR or [] }
		2569	]
		2570	}
		2571
		2572	=item cf::map::unique_maps
		2573
		2574	Returns an arrayref of paths of all shared maps that have
		2575	instantiated unique items. May block.
		2576
		2577	=cut
		2578
		2579	sub unique_maps() {
		2580	[
		2581	map {
		2582	utf8::decode $_;
		2583	s/\.map$//; # TODO future compatibility hack
		2584	/\.pst$/ || !/^$PATH_SEP/o # TODO unique maps apparebntly lack the .map suffix :/
		2585	? ()
		2586	: normalise $_
		2587	} @{ aio_readdir $UNIQUEDIR or [] }
		2588	]
		2589	}
		2590
		2591	=item cf::map::static_maps
		2592
		2593	Returns an arrayref if paths of all static maps (all preinstalled F<.map>
		2594	file in the shared directory excluding F</styles> and F</editor>). May
		2595	block.
		2596
		2597	=cut
		2598
		2599	sub static_maps() {
		2600	my @dirs = "";
		2601	my @maps;
		2602
		2603	while (@dirs) {
		2604	my $dir = shift @dirs;
		2605
		2606	next if $dir eq "/styles" || $dir eq "/editor";
		2607
		2608	my ($dirs, $files) = Coro::AIO::aio_scandir "$MAPDIR$dir", 2
		2609	or return;
		2610
		2611	for (@$files) {
		2612	s/\.map$// or next;
		2613	utf8::decode $_;
		2614	push @maps, "$dir/$_";
		2615	}
		2616
		2617	push @dirs, map "$dir/$_", @$dirs;
		2618	}
		2619
		2620	\@maps
		2621	}
		2622
		2623	=back
		2624
		2625	=head3 cf::object
		2626
		2627	=cut
		2628
		2629	package cf::object;
		2630
		2631	=over 4
		2632
		2633	=item $ob->inv_recursive
		2634
		2635	Returns the inventory of the object I<and> their inventories, recursively,
		2636	but I<not> the object itself.
		2637
		2638	=cut
		2639
		2640	sub inv_recursive_;
		2641	sub inv_recursive_ {
		2642	map { $_, inv_recursive_ $_->inv } @_
		2643	}
		2644
		2645	sub inv_recursive {
		2646	inv_recursive_ inv $_[0]
		2647	}
		2648
		2649	=item $ref = $ob->ref
		2650
		2651	Creates and returns a persistent reference to an object that can be stored as a string.
		2652
		2653	=item $ob = cf::object::deref ($refstring)
		2654
		2655	returns the objetc referenced by refstring. may return undef when it cannot find the object,
		2656	even if the object actually exists. May block.
		2657
		2658	=cut
		2659
		2660	sub deref {
		2661	my ($ref) = @_;
		2662
		2663	if ($ref =~ m{^player\/(<1\.[0-9a-f]+>)/(.*)$}) {
		2664	my ($uuid, $name) = ($1, $2);
		2665	my $pl = $cf::PLAYER_LOADING{$name} || cf::player::find $name
		2666	or return;
		2667	$pl->ob->uuid eq $uuid
		2668	or return;
		2669
		2670	$pl->ob
		2671	} else {
		2672	warn "$ref: cannot resolve object reference\n";
		2673	undef
		2674	}
		2675	}
		2676
		2677	package cf;
848		2678
849	=back	2679	=back
850		2680
851	=head3 cf::object::player	2681	=head3 cf::object::player
852		2682
…		…
857	Sends a message to the player, as if the npc C<$npc> replied. C<$npc>	2687	Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
858	can be C<undef>. Does the right thing when the player is currently in a	2688	can be C<undef>. Does the right thing when the player is currently in a
859	dialogue with the given NPC character.	2689	dialogue with the given NPC character.
860		2690
861	=cut	2691	=cut
		2692
		2693	our $SAY_CHANNEL = {
		2694	id => "say",
		2695	title => "Map",
		2696	reply => "say ",
		2697	tooltip => "Things said to and replied from NPCs near you and other players on the same map only.",
		2698	};
		2699
		2700	our $CHAT_CHANNEL = {
		2701	id => "chat",
		2702	title => "Chat",
		2703	reply => "chat ",
		2704	tooltip => "Player chat and shouts, global to the server.",
		2705	};
862		2706
863	# rough implementation of a future "reply" method that works	2707	# rough implementation of a future "reply" method that works
864	# with dialog boxes.	2708	# with dialog boxes.
865	#TODO: the first argument must go, split into a $npc->reply_to ( method	2709	#TODO: the first argument must go, split into a $npc->reply_to ( method
866	sub cf::object::player::reply($$$;$) {	2710	sub cf::object::player::reply($$$;$) {
…		…
868		2712
869	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	2713	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
870		2714
871	if ($self->{record_replies}) {	2715	if ($self->{record_replies}) {
872	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2716	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2717
873	} else {	2718	} else {
		2719	my $pl = $self->contr;
		2720
		2721	if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
		2722	my $dialog = $pl->{npc_dialog};
		2723	$dialog->{pl}->ext_msg ($dialog->{id}, update => msg => $dialog->{pl}->expand_cfpod ($msg));
		2724
		2725	} else {
874	$msg = $npc->name . " says: $msg" if $npc;	2726	$msg = $npc->name . " says: $msg" if $npc;
875	$self->message ($msg, $flags);	2727	$self->send_msg ($SAY_CHANNEL => $msg, $flags);
		2728	}
876	}	2729	}
		2730	}
		2731
		2732	=item $object->send_msg ($channel, $msg, $color, [extra...])
		2733
		2734	=cut
		2735
		2736	sub cf::object::send_msg {
		2737	my $pl = shift->contr
		2738	or return;
		2739	$pl->send_msg (@_);
877	}	2740	}
878		2741
879	=item $player_object->may ("access")	2742	=item $player_object->may ("access")
880		2743
881	Returns wether the given player is authorized to access resource "access"	2744	Returns wether the given player is authorized to access resource "access"
…		…
890	(ref $cf::CFG{"may_$access"}	2753	(ref $cf::CFG{"may_$access"}
891	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}	2754	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
892	: $cf::CFG{"may_$access"})	2755	: $cf::CFG{"may_$access"})
893	}	2756	}
894		2757
		2758	=item $player_object->enter_link
		2759
		2760	Freezes the player and moves him/her to a special map (C<{link}>).
		2761
		2762	The player should be reasonably safe there for short amounts of time (e.g.
		2763	for loading a map). You I<MUST> call C<leave_link> as soon as possible,
		2764	though, as the player cannot control the character while it is on the link
		2765	map.
		2766
		2767	Will never block.
		2768
		2769	=item $player_object->leave_link ($map, $x, $y)
		2770
		2771	Moves the player out of the special C<{link}> map onto the specified
		2772	map. If the map is not valid (or omitted), the player will be moved back
		2773	to the location he/she was before the call to C<enter_link>, or, if that
		2774	fails, to the emergency map position.
		2775
		2776	Might block.
		2777
		2778	=cut
		2779
		2780	sub link_map {
		2781	unless ($LINK_MAP) {
		2782	$LINK_MAP = cf::map::find "{link}"
		2783	or cf::cleanup "FATAL: unable to provide {link} map, exiting.";
		2784	$LINK_MAP->load;
		2785	}
		2786
		2787	$LINK_MAP
		2788	}
		2789
		2790	sub cf::object::player::enter_link {
		2791	my ($self) = @_;
		2792
		2793	$self->deactivate_recursive;
		2794
		2795	++$self->{_link_recursion};
		2796
		2797	return if UNIVERSAL::isa $self->map, "ext::map_link";
		2798
		2799	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
		2800	if $self->map && $self->map->{path} ne "{link}";
		2801
		2802	$self->enter_map ($LINK_MAP || link_map, 3, 3);
		2803	}
		2804
		2805	sub cf::object::player::leave_link {
		2806	my ($self, $map, $x, $y) = @_;
		2807
		2808	return unless $self->contr->active;
		2809
		2810	my $link_pos = delete $self->{_link_pos};
		2811
		2812	unless ($map) {
		2813	# restore original map position
		2814	($map, $x, $y) = @{ $link_pos || [] };
		2815	$map = cf::map::find $map;
		2816
		2817	unless ($map) {
		2818	($map, $x, $y) = @$EMERGENCY_POSITION;
		2819	$map = cf::map::find $map
		2820	or die "FATAL: cannot load emergency map\n";
		2821	}
		2822	}
		2823
		2824	($x, $y) = (-1, -1)
		2825	unless (defined $x) && (defined $y);
		2826
		2827	# use -1 or undef as default coordinates, not 0, 0
		2828	($x, $y) = ($map->enter_x, $map->enter_y)
		2829	if $x <= 0 && $y <= 0;
		2830
		2831	$map->load;
		2832
		2833	return unless $self->contr->active;
		2834
		2835	local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
		2836	if ($self->enter_map ($map, $x, $y)) {
		2837	# entering was successful
		2838	delete $self->{_link_recursion};
		2839	# only activate afterwards, to support waiting in hooks
		2840	$self->activate_recursive;
		2841	}
		2842
		2843	}
		2844
		2845	=item $player_object->goto ($path, $x, $y[, $check->($map, $x, $y, $player)[, $done->($player)]])
		2846
		2847	Moves the player to the given map-path and coordinates by first freezing
		2848	her, loading and preparing them map, calling the provided $check callback
		2849	that has to return the map if sucecssful, and then unfreezes the player on
		2850	the new (success) or old (failed) map position. In either case, $done will
		2851	be called at the end of this process.
		2852
		2853	Note that $check will be called with a potentially non-loaded map, so if
		2854	it needs a loaded map it has to call C<< ->load >>.
		2855
		2856	=cut
		2857
		2858	our $GOTOGEN;
		2859
		2860	sub cf::object::player::goto {
		2861	my ($self, $path, $x, $y, $check, $done) = @_;
		2862
		2863	if ($self->{_link_recursion} >= $MAX_LINKS) {
		2864	error "FATAL: link recursion exceeded, ", $self->name, " goto $path $x $y, redirecting.";
		2865	$self->failmsg ("Something went wrong inside the server - please contact an administrator!");
		2866	($path, $x, $y) = @$EMERGENCY_POSITION;
		2867	}
		2868
		2869	# do generation counting so two concurrent goto's will be executed in-order
		2870	my $gen = $self->{_goto_generation} = ++$GOTOGEN;
		2871
		2872	$self->enter_link;
		2873
		2874	(async {
		2875	$Coro::current->{desc} = "player::goto $path $x $y";
		2876
		2877	# *tag paths override both path and x|y
		2878	if ($path =~ /^\*(.*)$/) {
		2879	if (my @obs = grep $_->map, ext::map_tags::find $1) {
		2880	my $ob = $obs[rand @obs];
		2881
		2882	# see if we actually can go there
		2883	if (@obs = grep !$self->blocked ($_->map, $_->x, $_->y), $ob, $ob->tail) {
		2884	$ob = $obs[rand @obs];
		2885	} else {
		2886	$self->message ("Wow, it's pretty crowded in there.", cf::NDI_UNIQUE | cf::NDI_RED);
		2887	}
		2888	# else put us there anyways for now #d#
		2889
		2890	($path, $x, $y) = ($ob->map, $ob->x, $ob->y);
		2891	} else {
		2892	($path, $x, $y) = (undef, undef, undef);
		2893	}
		2894	}
		2895
		2896	my $map = eval {
		2897	my $map = defined $path ? cf::map::find $path, $self->map : undef;
		2898
		2899	if ($map) {
		2900	$map = $map->customise_for ($self);
		2901	$map = $check->($map, $x, $y, $self) if $check && $map;
		2902	} else {
		2903	$self->message ("The exit to '$path' is closed.", cf::NDI_UNIQUE | cf::NDI_RED);
		2904	}
		2905
		2906	$map
		2907	};
		2908
		2909	if ($@) {
		2910	$self->message ("Something went wrong within the server, please report this incident!", cf::NDI_UNIQUE | cf::NDI_RED);
		2911	LOG llevError | logBacktrace, Carp::longmess $@;
		2912	}
		2913
		2914	if ($gen == $self->{_goto_generation}) {
		2915	delete $self->{_goto_generation};
		2916	$self->leave_link ($map, $x, $y);
		2917	}
		2918
		2919	$done->($self) if $done;
		2920	})->prio (1);
		2921	}
		2922
		2923	=item $player_object->enter_exit ($exit_object)
		2924
		2925	=cut
		2926
		2927	sub parse_random_map_params {
		2928	my ($spec) = @_;
		2929
		2930	my $rmp = { # defaults
		2931	xsize => (cf::rndm 15, 40),
		2932	ysize => (cf::rndm 15, 40),
		2933	symmetry => (cf::rndm 1, cf::SYMMETRY_XY),
		2934	#layout => string,
		2935	};
		2936
		2937	for (split /\n/, $spec) {
		2938	my ($k, $v) = split /\s+/, $_, 2;
		2939
		2940	$rmp->{lc $k} = $v if (length $k) && (length $v);
		2941	}
		2942
		2943	$rmp
		2944	}
		2945
		2946	sub prepare_random_map {
		2947	my ($exit) = @_;
		2948
		2949	# all this does is basically replace the /! path by
		2950	# a new random map path (?random/...) with a seed
		2951	# that depends on the exit object
		2952
		2953	my $rmp = parse_random_map_params $exit->msg;
		2954
		2955	if ($exit->map) {
		2956	$rmp->{region} = $exit->region->name;
		2957	$rmp->{origin_map} = $exit->map->path;
		2958	$rmp->{origin_x} = $exit->x;
		2959	$rmp->{origin_y} = $exit->y;
		2960
		2961	$exit->map->touch;
		2962	}
		2963
		2964	$rmp->{random_seed} ||= $exit->random_seed;
		2965
		2966	my $data = JSON::XS->new->utf8->pretty->canonical->encode ($rmp);
		2967	my $md5 = Digest::MD5::md5_hex $data;
		2968	my $meta = "$RANDOMDIR/$md5.meta";
		2969
		2970	if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {
		2971	aio_write $fh, 0, (length $data), $data, 0;
		2972	undef $fh;
		2973	aio_rename "$meta~", $meta;
		2974
		2975	my $slaying = "?random/$md5";
		2976
		2977	if ($exit->valid) {
		2978	$exit->slaying ("?random/$md5");
		2979	$exit->msg (undef);
		2980	}
		2981	}
		2982	}
		2983
		2984	sub cf::object::player::enter_exit {
		2985	my ($self, $exit) = @_;
		2986
		2987	return unless $self->type == cf::PLAYER;
		2988
		2989	$self->enter_link;
		2990
		2991	(async {
		2992	$Coro::current->{desc} = "enter_exit";
		2993
		2994	unless (eval {
		2995	$self->deactivate_recursive; # just to be sure
		2996
		2997	my $map = cf::map::normalise $exit->slaying, $exit->map;
		2998	my $x = $exit->stats->hp;
		2999	my $y = $exit->stats->sp;
		3000
		3001	# special map handling
		3002	my $slaying = $exit->slaying;
		3003
		3004	# special map handling
		3005	if ($slaying eq "/!") {
		3006	my $guard = cf::lock_acquire "exit_prepare:$exit";
		3007
		3008	prepare_random_map $exit
		3009	if $exit->slaying eq "/!"; # need to re-check after getting the lock
		3010
		3011	$map = $exit->slaying;
		3012
		3013	} elsif ($slaying eq '!up') {
		3014	$map = $exit->map->tile_path (cf::TILE_UP);
		3015	$x = $exit->x;
		3016	$y = $exit->y;
		3017
		3018	} elsif ($slaying eq '!down') {
		3019	$map = $exit->map->tile_path (cf::TILE_DOWN);
		3020	$x = $exit->x;
		3021	$y = $exit->y;
		3022	}
		3023
		3024	$self->goto ($map, $x, $y);
		3025
		3026	# if exit is damned, update players death & WoR home-position
		3027	$self->contr->savebed ($map, $x, $y)
		3028	if $exit->flag (cf::FLAG_DAMNED);
		3029
		3030	1
		3031	}) {
		3032	$self->message ("Something went wrong deep within the deliantra server. "
		3033	. "I'll try to bring you back to the map you were before. "
		3034	. "Please report this to the dungeon master!",
		3035	cf::NDI_UNIQUE | cf::NDI_RED);
		3036
		3037	error "ERROR in enter_exit: $@";
		3038	$self->leave_link;
		3039	}
		3040	})->prio (1);
		3041	}
		3042
895	=head3 cf::client	3043	=head3 cf::client
896		3044
897	=over 4	3045	=over 4
898		3046
899	=item $client->send_drawinfo ($text, $flags)	3047	=item $client->send_big_packet ($pkt)
900		3048
901	Sends a drawinfo packet to the client. Circumvents output buffering so	3049	Like C<send_packet>, but tries to compress large packets, and fragments
902	should not be used under normal circumstances.	3050	them as required.
903		3051
904	=cut	3052	=cut
905		3053
		3054	our $MAXFRAGSIZE = cf::MAXSOCKBUF - 64;
		3055
		3056	sub cf::client::send_big_packet {
		3057	my ($self, $pkt) = @_;
		3058
		3059	# try lzf for large packets
		3060	$pkt = "lzf " . Compress::LZF::compress $pkt
		3061	if 1024 <= length $pkt and $self->{can_lzf};
		3062
		3063	# split very large packets
		3064	if ($MAXFRAGSIZE < length $pkt and $self->{can_lzf}) {
		3065	$self->send_packet ("frag $_") for unpack "(a$MAXFRAGSIZE)*", $pkt;
		3066	$pkt = "frag";
		3067	}
		3068
		3069	$self->send_packet ($pkt);
		3070	}
		3071
		3072	=item $client->send_msg ($channel, $msg, $color, [extra...])
		3073
		3074	Send a msg packet to the client, formatting the msg for the client if
		3075	necessary. C<$type> should be a string identifying the type of the
		3076	message, with C<log> being the default. If C<$color> is negative, suppress
		3077	the message unless the client supports the msg packet.
		3078
		3079	=cut
		3080
		3081	# non-persistent channels (usually the info channel)
		3082	our %CHANNEL = (
		3083	"c/motd" => {
		3084	id => "infobox",
		3085	title => "MOTD",
		3086	reply => undef,
		3087	tooltip => "The message of the day",
		3088	},
		3089	"c/identify" => {
		3090	id => "infobox",
		3091	title => "Identify",
		3092	reply => undef,
		3093	tooltip => "Items recently identified",
		3094	},
		3095	"c/examine" => {
		3096	id => "infobox",
		3097	title => "Examine",
		3098	reply => undef,
		3099	tooltip => "Signs and other items you examined",
		3100	},
		3101	"c/shopinfo" => {
		3102	id => "infobox",
		3103	title => "Shop Info",
		3104	reply => undef,
		3105	tooltip => "What your bargaining skill tells you about the shop",
		3106	},
		3107	"c/book" => {
		3108	id => "infobox",
		3109	title => "Book",
		3110	reply => undef,
		3111	tooltip => "The contents of a note or book",
		3112	},
		3113	"c/lookat" => {
		3114	id => "infobox",
		3115	title => "Look",
		3116	reply => undef,
		3117	tooltip => "What you saw there",
		3118	},
		3119	"c/who" => {
		3120	id => "infobox",
		3121	title => "Players",
		3122	reply => undef,
		3123	tooltip => "Shows players who are currently online",
		3124	},
		3125	"c/body" => {
		3126	id => "infobox",
		3127	title => "Body Parts",
		3128	reply => undef,
		3129	tooltip => "Shows which body parts you posess and are available",
		3130	},
		3131	"c/statistics" => {
		3132	id => "infobox",
		3133	title => "Statistics",
		3134	reply => undef,
		3135	tooltip => "Shows your primary statistics",
		3136	},
		3137	"c/skills" => {
		3138	id => "infobox",
		3139	title => "Skills",
		3140	reply => undef,
		3141	tooltip => "Shows your experience per skill and item power",
		3142	},
		3143	"c/shopitems" => {
		3144	id => "infobox",
		3145	title => "Shop Items",
		3146	reply => undef,
		3147	tooltip => "Shows the items currently for sale in this shop",
		3148	},
		3149	"c/resistances" => {
		3150	id => "infobox",
		3151	title => "Resistances",
		3152	reply => undef,
		3153	tooltip => "Shows your resistances",
		3154	},
		3155	"c/pets" => {
		3156	id => "infobox",
		3157	title => "Pets",
		3158	reply => undef,
		3159	tooltip => "Shows information abotu your pets/a specific pet",
		3160	},
		3161	"c/perceiveself" => {
		3162	id => "infobox",
		3163	title => "Perceive Self",
		3164	reply => undef,
		3165	tooltip => "You gained detailed knowledge about yourself",
		3166	},
		3167	"c/uptime" => {
		3168	id => "infobox",
		3169	title => "Uptime",
		3170	reply => undef,
		3171	tooltip => "How long the server has been running since last restart",
		3172	},
		3173	"c/mapinfo" => {
		3174	id => "infobox",
		3175	title => "Map Info",
		3176	reply => undef,
		3177	tooltip => "Information related to the maps",
		3178	},
		3179	"c/party" => {
		3180	id => "party",
		3181	title => "Party",
		3182	reply => "gsay ",
		3183	tooltip => "Messages and chat related to your party",
		3184	},
		3185	"c/death" => {
		3186	id => "death",
		3187	title => "Death",
		3188	reply => undef,
		3189	tooltip => "Reason for and more info about your most recent death",
		3190	},
		3191	"c/fatal" => {
		3192	id => "fatal",
		3193	title => "Fatal Error",
		3194	reply => undef,
		3195	tooltip => "Reason for the server disconnect",
		3196	},
		3197	"c/say" => $SAY_CHANNEL,
		3198	"c/chat" => $CHAT_CHANNEL,
		3199	);
		3200
906	sub cf::client::send_drawinfo {	3201	sub cf::client::send_msg {
		3202	my ($self, $channel, $msg, $color, @extra) = @_;
		3203
		3204	$msg = $self->pl->expand_cfpod ($msg)
		3205	unless $color & cf::NDI_VERBATIM;
		3206
		3207	$color &= cf::NDI_CLIENT_MASK; # just in case...
		3208
		3209	# check predefined channels, for the benefit of C
		3210	if ($CHANNEL{$channel}) {
		3211	$channel = $CHANNEL{$channel};
		3212
		3213	$self->ext_msg (channel_info => $channel);
		3214	$channel = $channel->{id};
		3215
		3216	} elsif (ref $channel) {
		3217	# send meta info to client, if not yet sent
		3218	unless (exists $self->{channel}{$channel->{id}}) {
		3219	$self->{channel}{$channel->{id}} = $channel;
		3220	$self->ext_msg (channel_info => $channel);
		3221	}
		3222
		3223	$channel = $channel->{id};
		3224	}
		3225
		3226	return unless @extra || length $msg;
		3227
		3228	# default colour, mask it out
		3229	$color &= ~(cf::NDI_COLOR_MASK | cf::NDI_DEF)
		3230	if $color & cf::NDI_DEF;
		3231
		3232	my $pkt = "msg "
		3233	. $self->{json_coder}->encode (
		3234	[$color & cf::NDI_CLIENT_MASK, $channel, $msg, @extra]
		3235	);
		3236
		3237	$self->send_big_packet ($pkt);
		3238	}
		3239
		3240	=item $client->ext_msg ($type, @msg)
		3241
		3242	Sends an ext event to the client.
		3243
		3244	=cut
		3245
		3246	sub cf::client::ext_msg($$@) {
907	my ($self, $text, $flags) = @_;	3247	my ($self, $type, @msg) = @_;
908		3248
909	utf8::encode $text;	3249	$self->send_big_packet ("ext " . $self->{json_coder}->encode ([$type, @msg]));
910	$self->send_packet (sprintf "drawinfo %d %s", $flags, $text);
911	}	3250	}
912
913		3251
914	=item $success = $client->query ($flags, "text", \&cb)	3252	=item $success = $client->query ($flags, "text", \&cb)
915		3253
916	Queues a query to the client, calling the given callback with	3254	Queues a query to the client, calling the given callback with
917	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,	3255	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
918	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.	3256	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
919		3257
920	Queries can fail, so check the return code. Or don't, as queries will become	3258	Queries can fail, so check the return code. Or don't, as queries will
921	reliable at some point in the future.	3259	become reliable at some point in the future.
922		3260
923	=cut	3261	=cut
924		3262
925	sub cf::client::query {	3263	sub cf::client::query {
926	my ($self, $flags, $text, $cb) = @_;	3264	my ($self, $flags, $text, $cb) = @_;
…		…
934	utf8::encode $text;	3272	utf8::encode $text;
935	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];	3273	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
936		3274
937	$self->send_packet ($self->{query_queue}[0][0])	3275	$self->send_packet ($self->{query_queue}[0][0])
938	if @{ $self->{query_queue} } == 1;	3276	if @{ $self->{query_queue} } == 1;
		3277
		3278	1
		3279	}
		3280
		3281	=item $client->update_command_faces
		3282
		3283	=cut
		3284
		3285	our %COMMAND_FACE;
		3286
		3287	sub cf::client::update_command_faces {
		3288	my ($self) = @_;
		3289
		3290	my @faces = grep $_,
		3291	$COMMAND_FACE{standard},
		3292	$COMMAND_FACE{emote},
		3293	$COMMAND_FACE{skill},
		3294	$self->pl->ob->flag (cf::FLAG_WIZ) ? $COMMAND_FACE{dm} : (),
		3295	;
		3296
		3297	$self->send_face ($_)
		3298	for @faces;
		3299	$self->flush_fx;
		3300
		3301	$self->ext_msg (command_list => @faces);
		3302	}
		3303
		3304	=item cf::client::set_command_face $type, $commands
		3305
		3306	=cut
		3307
		3308	sub cf::client::set_command_face {
		3309	my ($type, $list) = @_;
		3310
		3311	my $idx = &cf::face::set ( #d# ugly forward reference
		3312	"command_list/$type" => cf::FT_RSRC,
		3313	JSON::XS->new->utf8->encode ([ sort @$list ])
		3314	);
		3315
		3316	$COMMAND_FACE{$type} = $idx;
939	}	3317	}
940		3318
941	cf::client->attach (	3319	cf::client->attach (
		3320	on_connect => sub {
		3321	my ($ns) = @_;
		3322
		3323	$ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
		3324	},
942	on_reply => sub {	3325	on_reply => sub {
943	my ($ns, $msg) = @_;	3326	my ($ns, $msg) = @_;
944		3327
945	# this weird shuffling is so that direct followup queries	3328	# this weird shuffling is so that direct followup queries
946	# get handled first	3329	# get handled first
947	my $queue = delete $ns->{query_queue};	3330	my $queue = delete $ns->{query_queue}
		3331	or return; # be conservative, not sure how that can happen, but we saw a crash here
948		3332
949	(shift @$queue)->[1]->($msg);	3333	(shift @$queue)->[1]->($msg);
		3334	return unless $ns->valid; # temporary(?) workaround for callback destroying socket
950		3335
951	push @{ $ns->{query_queue} }, @$queue;	3336	push @{ $ns->{query_queue} }, @$queue;
952		3337
953	if (@{ $ns->{query_queue} } == @$queue) {	3338	if (@{ $ns->{query_queue} } == @$queue) {
954	if (@$queue) {	3339	if (@$queue) {
…		…
956	} else {	3341	} else {
957	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;	3342	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
958	}	3343	}
959	}	3344	}
960	},	3345	},
		3346	on_exticmd => sub {
		3347	my ($ns, $buf) = @_;
		3348
		3349	my $msg = eval { $ns->{json_coder}->decode ($buf) };
		3350
		3351	if (ref $msg) {
		3352	my ($type, $reply, @payload) = @$msg; # version 1 used %type, $id, %$hash
		3353
		3354	if (my $cb = $EXTIACMD{$type}) {
		3355	$cb->(
		3356	$ns,
		3357	sub {
		3358	$ns->ext_msg ("reply-$reply", @_)
		3359	if $reply;
		3360	},
		3361	@payload
		3362	);
		3363	} else {
		3364	my @reply;
		3365
		3366	if (my $cb = $EXTICMD{$type}) {
		3367	@reply = $cb->($ns, @payload);
		3368	}
		3369
		3370	$ns->ext_msg ("reply-$reply", @reply)
		3371	if $reply;
		3372	}
		3373	} else {
		3374	error "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
		3375	}
		3376
		3377	cf::override;
		3378	},
961	);	3379	);
962		3380
963	=item $client->coro (\&cb)	3381	=item $client->async (\&cb)
964		3382
965	Create a new coroutine, running the specified callback. The coroutine will	3383	Create a new coroutine, running the specified callback. The coroutine will
966	be automatically cancelled when the client gets destroyed (e.g. on logout,	3384	be automatically cancelled when the client gets destroyed (e.g. on logout,
967	or loss of connection).	3385	or loss of connection).
968		3386
969	=cut	3387	=cut
970		3388
971	sub cf::client::coro {	3389	sub cf::client::async {
972	my ($self, $cb) = @_;	3390	my ($self, $cb) = @_;
973		3391
974	my $coro; $coro = async {	3392	my $coro = &Coro::async ($cb);
975	eval {
976	$cb->();
977	};
978	warn $@ if $@;
979	};
980		3393
981	$coro->on_destroy (sub {	3394	$coro->on_destroy (sub {
982	delete $self->{_coro}{$coro+0};	3395	delete $self->{_coro}{$coro+0};
983	});	3396	});
984		3397
…		…
986		3399
987	$coro	3400	$coro
988	}	3401	}
989		3402
990	cf::client->attach (	3403	cf::client->attach (
991	on_destroy => sub {	3404	on_client_destroy => sub {
992	my ($ns) = @_;	3405	my ($ns) = @_;
993		3406
994	$_->cancel for values %{ (delete $ns->{_coro}) || {} };	3407	$_->cancel for values %{ (delete $ns->{_coro}) || {} };
995	},	3408	},
996	);	3409	);
…		…
1011	our $safe = new Safe "safe";	3424	our $safe = new Safe "safe";
1012	our $safe_hole = new Safe::Hole;	3425	our $safe_hole = new Safe::Hole;
1013		3426
1014	$SIG{FPE} = 'IGNORE';	3427	$SIG{FPE} = 'IGNORE';
1015		3428
1016	$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));	3429	$safe->permit_only (Opcode::opset qw(
		3430	:base_core :base_mem :base_orig :base_math :base_loop
		3431	grepstart grepwhile mapstart mapwhile
		3432	sort time
		3433	));
1017		3434
1018	# here we export the classes and methods available to script code	3435	# here we export the classes and methods available to script code
1019		3436
1020	=pod	3437	=pod
1021		3438
1022	The following fucntions and emthods are available within a safe environment:	3439	The following functions and methods are available within a safe environment:
1023		3440
1024	cf::object contr pay_amount pay_player map	3441	cf::object
		3442	contr pay_amount pay_player map x y force_find force_add destroy
		3443	insert remove name archname title slaying race decrease split
		3444	value
		3445
1025	cf::object::player player	3446	cf::object::player
1026	cf::player peaceful	3447	player
1027	cf::map trigger	3448
		3449	cf::player
		3450	peaceful
		3451
		3452	cf::map
		3453	trigger
1028		3454
1029	=cut	3455	=cut
1030		3456
1031	for (	3457	for (
1032	["cf::object" => qw(contr pay_amount pay_player map)],	3458	["cf::object" => qw(contr pay_amount pay_player map force_find force_add x y
		3459	insert remove inv nrof name archname title slaying race
		3460	decrease split destroy change_exp value msg lore send_msg)],
1033	["cf::object::player" => qw(player)],	3461	["cf::object::player" => qw(player)],
1034	["cf::player" => qw(peaceful)],	3462	["cf::player" => qw(peaceful send_msg)],
1035	["cf::map" => qw(trigger)],	3463	["cf::map" => qw(trigger)],
1036	) {	3464	) {
1037	no strict 'refs';
1038	my ($pkg, @funs) = @$_;	3465	my ($pkg, @funs) = @$_;
1039	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})	3466	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
1040	for @funs;	3467	for @funs;
1041	}	3468	}
1042		3469
…		…
1057		3484
1058	my $qcode = $code;	3485	my $qcode = $code;
1059	$qcode =~ s/"/‟/g; # not allowed in #line filenames	3486	$qcode =~ s/"/‟/g; # not allowed in #line filenames
1060	$qcode =~ s/\n/\\n/g;	3487	$qcode =~ s/\n/\\n/g;
1061		3488
		3489	%vars = (_dummy => 0) unless %vars;
		3490
		3491	my @res;
1062	local $_;	3492	local $_;
1063	local @safe::cf::_safe_eval_args = values %vars;
1064		3493
1065	my $eval =	3494	my $eval =
1066	"do {\n"	3495	"do {\n"
1067	. "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"	3496	. "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"
1068	. "#line 0 \"{$qcode}\"\n"	3497	. "#line 0 \"{$qcode}\"\n"
1069	. $code	3498	. $code
1070	. "\n}"	3499	. "\n}"
1071	;	3500	;
1072		3501
		3502	if ($CFG{safe_eval}) {
1073	sub_generation_inc;	3503	sub_generation_inc;
		3504	local @safe::cf::_safe_eval_args = values %vars;
1074	my @res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);	3505	@res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);
1075	sub_generation_inc;	3506	sub_generation_inc;
		3507	} else {
		3508	local @cf::_safe_eval_args = values %vars;
		3509	@res = wantarray ? eval eval : scalar eval $eval;
		3510	}
1076		3511
1077	if ($@) {	3512	if ($@) {
1078	warn "$@";	3513	warn "$@",
1079	warn "while executing safe code '$code'\n";	3514	"while executing safe code '$code'\n",
1080	warn "with arguments " . (join " ", %vars) . "\n";	3515	"with arguments " . (join " ", %vars) . "\n";
1081	}	3516	}
1082		3517
1083	wantarray ? @res : $res[0]	3518	wantarray ? @res : $res[0]
1084	}	3519	}
1085		3520
…		…
1099	=cut	3534	=cut
1100		3535
1101	sub register_script_function {	3536	sub register_script_function {
1102	my ($fun, $cb) = @_;	3537	my ($fun, $cb) = @_;
1103		3538
1104	no strict 'refs';	3539	$fun = "safe::$fun" if $CFG{safe_eval};
1105	*{"safe::$fun"} = $safe_hole->wrap ($cb);	3540	*$fun = $safe_hole->wrap ($cb);
1106	}	3541	}
1107		3542
1108	=back	3543	=back
1109		3544
1110	=cut	3545	=cut
1111		3546
1112	#############################################################################	3547	#############################################################################
1113		3548	# the server's init and main functions
1114	=head2 EXTENSION DATABASE SUPPORT
1115
1116	Crossfire maintains a very simple database for extension use. It can
1117	currently store anything that can be serialised using Storable, which
1118	excludes objects.
1119
1120	The parameter C<$family> should best start with the name of the extension
1121	using it, it should be unique.
1122
1123	=over 4
1124
1125	=item $hashref = cf::db_get $family
1126
1127	Return a hashref for use by the extension C<$family>, which can be
1128	modified. After modifications, you have to call C<cf::db_dirty> or
1129	C<cf::db_sync>.
1130
1131	=item $value = cf::db_get $family => $key
1132
1133	Returns a single value from the database
1134
1135	=item cf::db_put $family => $hashref
1136
1137	Stores the given family hashref into the database. Updates are delayed, if
1138	you want the data to be synced to disk immediately, use C<cf::db_sync>.
1139
1140	=item cf::db_put $family => $key => $value
1141
1142	Stores the given C<$value> in the family hash. Updates are delayed, if you
1143	want the data to be synced to disk immediately, use C<cf::db_sync>.
1144
1145	=item cf::db_dirty
1146
1147	Marks the database as dirty, to be updated at a later time.
1148
1149	=item cf::db_sync
1150
1151	Immediately write the database to disk I<if it is dirty>.
1152
1153	=cut
1154
1155	our $DB;
1156		3549
1157	{	3550	{
1158	my $path = cf::localdir . "/database.pst";	3551	package cf::face;
1159		3552
1160	sub db_load() {	3553	our %HASH; # hash => idx
1161	warn "loading database $path\n";#d# remove later	3554	our @DATA; # dynamically-created facedata, only faceste 0 used
1162	$DB = stat $path ? Storable::retrieve $path : { };	3555	our @FOFS; # file offset, if > 0
1163	}	3556	our @SIZE; # size of face, in octets
		3557	our @META; # meta hash of face, if any
		3558	our $DATAFH; # facedata filehandle
1164		3559
1165	my $pid;	3560	# internal api, not finalised
		3561	sub set {
		3562	my ($name, $type, $data) = @_;
1166		3563
1167	sub db_save() {	3564	my $idx = cf::face::find $name;
1168	warn "saving database $path\n";#d# remove later
1169	waitpid $pid, 0 if $pid;
1170	if (0 == ($pid = fork)) {
1171	$DB->{_meta}{version} = 1;
1172	Storable::nstore $DB, "$path~";
1173	rename "$path~", $path;
1174	cf::_exit 0 if defined $pid;
1175	}
1176	}
1177		3565
1178	my $dirty;	3566	if ($idx) {
1179		3567	delete $HASH{cf::face::get_csum $idx};
1180	sub db_sync() {
1181	db_save if $dirty;
1182	undef $dirty;
1183	}
1184
1185	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1186	db_sync;
1187	});
1188
1189	sub db_dirty() {
1190	$dirty = 1;
1191	$idle->start;
1192	}
1193
1194	sub db_get($;$) {
1195	@_ >= 2
1196	? $DB->{$_[0]}{$_[1]}
1197	: ($DB->{$_[0]} ||= { })
1198	}
1199
1200	sub db_put($$;$) {
1201	if (@_ >= 3) {
1202	$DB->{$_[0]}{$_[1]} = $_[2];
1203	} else {	3568	} else {
1204	$DB->{$_[0]} = $_[1];	3569	$idx = cf::face::alloc $name;
1205	}
1206	db_dirty;
1207	}
1208
1209	cf::global->attach (
1210	prio => 10000,
1211	on_cleanup => sub {
1212	db_sync;
1213	},	3570	}
		3571
		3572	my $hash = cf::face::mangle_csum Digest::MD5::md5 $data;
		3573
		3574	cf::face::set_type $idx, $type;
		3575	cf::face::set_csum $idx, 0, $hash;
		3576
		3577	# we need to destroy the SV itself, not just modify it, as a running ix
		3578	# might hold a reference to it: "delete" achieves that.
		3579	delete $FOFS[0][$idx];
		3580	delete $DATA[0][$idx];
		3581	$DATA[0][$idx] = $data;
		3582	$SIZE[0][$idx] = length $data;
		3583	delete $META[$idx];
		3584	$HASH{$hash} = $idx;#d#
		3585
		3586	$idx
		3587	}
		3588
		3589	sub _get_data($$$) {
		3590	my ($idx, $set, $cb) = @_;
		3591
		3592	if (defined $DATA[$set][$idx]) {
		3593	$cb->($DATA[$set][$idx]);
		3594	} elsif (my $fofs = $FOFS[$set][$idx]) {
		3595	my $size = $SIZE[$set][$idx];
		3596	my $buf;
		3597	IO::AIO::aio_read $DATAFH, $fofs, $size, $buf, 0, sub {
		3598	if ($_[0] == $size) {
		3599	#cf::debug "read face $idx, $size from $fofs as ", length $buf;#d#
		3600	$cb->($buf);
		3601	} else {
		3602	cf::error "INTERNAL ERROR: unable to read facedata for face $idx#$set ($size, $fofs), ignoring request.";
		3603	}
		3604	};
		3605	} else {
		3606	cf::error "requested facedata for unknown face $idx#$set, ignoring.";
		3607	}
		3608	}
		3609
		3610	# rather ineffient
		3611	sub cf::face::get_data($;$) {
		3612	my ($idx, $set) = @_;
		3613
		3614	_get_data $idx, $set, Coro::rouse_cb;
		3615	Coro::rouse_wait
		3616	}
		3617
		3618	sub cf::face::ix {
		3619	my ($ns, $set, $idx, $pri) = @_;
		3620
		3621	_get_data $idx, $set, sub {
		3622	$ns->ix_send ($idx, $pri, $_[0]);
		3623	};
		3624	}
		3625	}
		3626
		3627	sub load_facedata($) {
		3628	my ($path) = @_;
		3629
		3630	my $enc = JSON::XS->new->utf8->canonical->relaxed;
		3631
		3632	trace "loading facedata from $path\n";
		3633
		3634	my $facedata = decode_storable load_file "$path/faceinfo";
		3635
		3636	$facedata->{version} == 2
		3637	or cf::cleanup "$path/faceinfo: version mismatch, cannot proceed.";
		3638
		3639	my $fh = aio_open "$DATADIR/facedata", IO::AIO::O_RDONLY, 0
		3640	or cf::cleanup "$path/facedata: $!, cannot proceed.";
		3641
		3642	get_slot 1, -100, "load_facedata"; # make sure we get a very big slot
		3643
		3644	# BEGIN ATOMIC
		3645	# from here on, everything must be atomic - no thread switch allowed
		3646	my $t1 = EV::time;
		3647
		3648	{
		3649	my $faces = $facedata->{faceinfo};
		3650
		3651	for my $face (sort keys %$faces) {
		3652	my $info = $faces->{$face};
		3653	my $idx = (cf::face::find $face) || cf::face::alloc $face;
		3654
		3655	cf::face::set_visibility $idx, $info->{visibility};
		3656	cf::face::set_magicmap $idx, $info->{magicmap};
		3657	cf::face::set_csum $idx, 0, $info->{hash64}; $cf::face::SIZE[0][$idx] = $info->{size64}; $cf::face::FOFS[0][$idx] = $info->{fofs64};
		3658	cf::face::set_csum $idx, 1, $info->{hash32}; $cf::face::SIZE[1][$idx] = $info->{size32}; $cf::face::FOFS[1][$idx] = $info->{fofs32};
		3659	cf::face::set_csum $idx, 2, $info->{glyph}; $cf::face::DATA[2][$idx] = $info->{glyph};
		3660	$cf::face::HASH{$info->{hash64}} = $idx;
		3661	delete $cf::face::META[$idx];
		3662	}
		3663
		3664	while (my ($face, $info) = each %$faces) {
		3665	next unless $info->{smooth};
		3666
		3667	my $idx = cf::face::find $face
		3668	or next;
		3669
		3670	if (my $smooth = cf::face::find $info->{smooth}) {
		3671	cf::face::set_smooth $idx, $smooth;
		3672	cf::face::set_smoothlevel $idx, $info->{smoothlevel};
		3673	} else {
		3674	error "smooth face '$info->{smooth}' not found for face '$face'";
		3675	}
		3676	}
		3677	}
		3678
		3679	{
		3680	my $anims = $facedata->{animinfo};
		3681
		3682	while (my ($anim, $info) = each %$anims) {
		3683	cf::anim::set $anim, $info->{frames}, $info->{facings};
		3684	}
		3685
		3686	cf::anim::invalidate_all; # d'oh
		3687	}
		3688
		3689	{
		3690	my $res = $facedata->{resource};
		3691
		3692	while (my ($name, $info) = each %$res) {
		3693	if (defined (my $type = $info->{type})) {
		3694	# TODO: different hash - must free and use new index, or cache ixface data queue
		3695	my $idx = (cf::face::find $name) || cf::face::alloc $name;
		3696
		3697	cf::face::set_type $idx, $type;
		3698	cf::face::set_csum $idx, 0, $info->{hash};
		3699	$cf::face::SIZE[0][$idx] = $info->{size};
		3700	$cf::face::FOFS[0][$idx] = $info->{fofs};
		3701	$cf::face::META[$idx] = $type & 1 ? undef : $info->{meta}; # preserve meta unless prepended already
		3702	$cf::face::HASH{$info->{hash}} = $idx;
		3703	} else {
		3704	# $RESOURCE{$name} = $info; # unused
		3705	}
		3706	}
		3707	}
		3708
		3709	($fh, $cf::face::DATAFH) = ($cf::face::DATAFH, $fh);
		3710
		3711	# HACK to clear player env face cache, we need some signal framework
		3712	# for this (global event?)
		3713	%ext::player_env::MUSIC_FACE_CACHE = ();
		3714
		3715	# END ATOMIC
		3716
		3717	cf::debug "facedata atomic update time ", EV::time - $t1;
		3718
		3719	cf::global->invoke (EVENT_GLOBAL_RESOURCE_UPDATE);
		3720
		3721	aio_close $fh if $fh; # close old facedata
		3722
		3723	1
		3724	}
		3725
		3726	register_exticmd fx_want => sub {
		3727	my ($ns, $want) = @_;
		3728
		3729	while (my ($k, $v) = each %$want) {
		3730	$ns->fx_want ($k, $v);
		3731	}
		3732	};
		3733
		3734	sub load_resource_file($) {
		3735	my $guard = lock_acquire "load_resource_file";
		3736
		3737	my $status = load_resource_file_ $_[0];
		3738	get_slot 0.1, 100;
		3739	cf::arch::commit_load;
		3740
		3741	$status
		3742	}
		3743
		3744	sub reload_exp_table {
		3745	_reload_exp_table;
		3746
		3747	cf::face::set
		3748	"res/exp_table" => FT_RSRC,
		3749	JSON::XS->new->utf8->canonical->encode (
		3750	[map cf::level_to_min_exp $_, 1 .. cf::settings->max_level]
		3751	);
		3752	}
		3753
		3754	sub reload_materials {
		3755	_reload_materials;
		3756	}
		3757
		3758	sub reload_regions {
		3759	# HACK to clear player env face cache, we need some signal framework
		3760	# for this (global event?)
		3761	%ext::player_env::MUSIC_FACE_CACHE = ();
		3762
		3763	load_resource_file "$MAPDIR/regions"
		3764	or die "unable to load regions file\n";
		3765
		3766	for (cf::region::list) {
		3767	$_->{match} = qr/$_->{match}/
		3768	if exists $_->{match};
		3769	}
		3770	}
		3771
		3772	sub reload_facedata {
		3773	load_facedata $DATADIR
		3774	or die "unable to load facedata\n";
		3775	}
		3776
		3777	sub reload_archetypes {
		3778	load_resource_file "$DATADIR/archetypes"
		3779	or die "unable to load archetypes\n";
		3780
		3781	cf::face::set
		3782	"res/skill_info" => FT_RSRC,
		3783	JSON::XS->new->utf8->canonical->encode (
		3784	[map [cf::arch::skillvec ($_)->name], 0 .. cf::arch::skillvec_size - 1]
		3785	);
		3786
		3787	cf::face::set
		3788	"res/spell_paths" => FT_RSRC,
		3789	JSON::XS->new->utf8->canonical->encode (
		3790	[map [cf::spellpathnames ($_)], 0 .. NRSPELLPATHS - 1]
		3791	);
		3792
		3793	# command completion
		3794	my @commands;
		3795
		3796	for (0..cf::arch::skillvec_size - 1) {
		3797	my $skill = cf::arch::skillvec $_;
		3798	my $name = $skill->name;
		3799	my $flags = cf::skill_flags $skill->subtype;
		3800
		3801	push @commands, "ready_skill $name" if $flags & (SF_COMBAT | SF_RANGED | SF_GRACE);
		3802	push @commands, "use_skill $name" if $flags & (SF_USE | SF_AUTARK | SF_GRACE);
		3803	}
		3804
		3805	cf::client::set_command_face skill => \@commands;
		3806	}
		3807
		3808	sub reload_treasures {
		3809	load_resource_file "$DATADIR/treasures"
		3810	or die "unable to load treasurelists\n";
		3811	}
		3812
		3813	sub reload_sound {
		3814	trace "loading sound config from $DATADIR/sound\n";
		3815
		3816	my $soundconf = JSON::XS->new->utf8->relaxed->decode (load_file "$DATADIR/sound");
		3817
		3818	for (0 .. SOUND_CAST_SPELL_0 - 1) {
		3819	my $sound = $soundconf->{compat}[$_]
		3820	or next;
		3821
		3822	my $face = cf::face::find "sound/$sound->[1]";
		3823	cf::sound::set $sound->[0] => $face;
		3824	cf::sound::old_sound_index $_, $face; # gcfclient-compat
		3825	}
		3826
		3827	while (my ($k, $v) = each %{$soundconf->{event}}) {
		3828	my $face = cf::face::find "sound/$v";
		3829	cf::sound::set $k => $face;
		3830	}
		3831	}
		3832
		3833	sub reload_resources {
		3834	trace "reloading resource files...\n";
		3835
		3836	reload_materials;
		3837	reload_facedata;
		3838	reload_exp_table;
		3839	reload_sound;
		3840	reload_archetypes;
		3841	reload_regions;
		3842	reload_treasures;
		3843
		3844	trace "finished reloading resource files\n";
		3845	}
		3846
		3847	sub reload_config {
		3848	trace "reloading config file...\n";
		3849
		3850	my $config = load_file "$CONFDIR/config";
		3851	utf8::decode $config;
		3852	*CFG = decode_yaml $config;
		3853
		3854	$EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_104_115", 49, 38];
		3855
		3856	$cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
		3857	$cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
		3858
		3859	if (exists $CFG{mlockall}) {
		3860	eval {
		3861	$CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
		3862	and die "WARNING: m(un)lockall failed: $!\n";
		3863	};
		3864	warn $@ if $@;
		3865	}
		3866	}
		3867
		3868	sub pidfile() {
		3869	sysopen my $fh, $PIDFILE, O_RDWR | O_CREAT
		3870	or die "$PIDFILE: $!";
		3871	flock $fh, &Fcntl::LOCK_EX
		3872	or die "$PIDFILE: flock: $!";
		3873	$fh
		3874	}
		3875
		3876	# make sure only one server instance is running at any one time
		3877	sub atomic {
		3878	my $fh = pidfile;
		3879
		3880	my $pid = <$fh>;
		3881	kill 9, $pid if $pid > 0;
		3882
		3883	seek $fh, 0, 0;
		3884	print $fh $$;
		3885	}
		3886
		3887	sub main_loop {
		3888	trace "EV::loop starting\n";
		3889	if (1) {
		3890	EV::loop;
		3891	}
		3892	trace "EV::loop returned\n";
		3893	goto &main_loop unless $REALLY_UNLOOP;
		3894	}
		3895
		3896	sub main {
		3897	cf::init_globals; # initialise logging
		3898
		3899	LOG llevInfo, "Welcome to Deliantra, v" . VERSION;
		3900	LOG llevInfo, "Copyright (C) 2005-2012 Marc Alexander Lehmann / Robin Redeker / the Deliantra team.";
		3901	LOG llevInfo, "Copyright (C) 1994 Mark Wedel.";
		3902	LOG llevInfo, "Copyright (C) 1992 Frank Tore Johansen.";
		3903
		3904	$Coro::current->prio (Coro::PRIO_MAX); # give the main loop max. priority
		3905
		3906	# we must not ever block the main coroutine
		3907	$Coro::idle = sub {
		3908	Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
		3909	(async {
		3910	$Coro::current->{desc} = "IDLE BUG HANDLER";
		3911	EV::loop EV::LOOP_ONESHOT;
		3912	})->prio (Coro::PRIO_MAX);
1214	);	3913	};
		3914
		3915	evthread_start IO::AIO::poll_fileno;
		3916
		3917	cf::sync_job {
		3918	cf::incloader::init ();
		3919
		3920	db_init;
		3921
		3922	cf::init_anim;
		3923	cf::init_attackmess;
		3924	cf::init_dynamic;
		3925
		3926	cf::load_settings;
		3927
		3928	reload_resources;
		3929	reload_config;
		3930
		3931	cf::init_uuid;
		3932	cf::init_signals;
		3933	cf::init_skills;
		3934
		3935	cf::init_beforeplay;
		3936
		3937	atomic;
		3938
		3939	load_extensions;
		3940
		3941	utime time, time, $RUNTIMEFILE;
		3942
		3943	# no (long-running) fork's whatsoever before this point(!)
		3944	use POSIX ();
		3945	POSIX::close delete $ENV{LOCKUTIL_LOCK_FD} if exists $ENV{LOCKUTIL_LOCK_FD};
		3946
		3947	cf::_post_init 0;
		3948	};
		3949
		3950	cf::object::thawer::errors_are_fatal 0;
		3951	info "parse errors in files are no longer fatal from this point on.\n";
		3952
		3953	AE::postpone {
		3954	undef &main; # free gobs of memory :)
		3955	};
		3956
		3957	goto &main_loop;
1215	}	3958	}
1216		3959
1217	#############################################################################	3960	#############################################################################
1218	# the server's main()	3961	# initialisation and cleanup
1219		3962
1220	sub cfg_load {	3963	# install some emergency cleanup handlers
1221	open my $fh, "<:utf8", cf::confdir . "/config"	3964	BEGIN {
		3965	our %SIGWATCHER = ();
		3966	for my $signal (qw(INT HUP TERM)) {
		3967	$SIGWATCHER{$signal} = AE::signal $signal, sub {
		3968	cf::cleanup "SIG$signal";
		3969	};
		3970	}
		3971	}
		3972
		3973	sub write_runtime_sync {
		3974	my $t0 = AE::time;
		3975
		3976	# first touch the runtime file to show we are still running:
		3977	# the fsync below can take a very very long time.
		3978
		3979	IO::AIO::aio_utime $RUNTIMEFILE, undef, undef;
		3980
		3981	my $guard = cf::lock_acquire "write_runtime";
		3982
		3983	my $fh = aio_open "$RUNTIMEFILE~", O_WRONLY | O_CREAT | O_TRUNC, 0644
1222	or return;	3984	or return;
1223		3985
1224	local $/;	3986	my $value = $cf::RUNTIME + 90 + 10;
1225	*CFG = YAML::Syck::Load <$fh>;	3987	# 10 is the runtime save interval, for a monotonic clock
1226	}	3988	# 60 allows for the watchdog to kill the server.
1227		3989
1228	sub main {	3990	(aio_write $fh, 0, (length $value), $value, 0) <= 0
1229	cfg_load;	3991	and return;
1230	db_load;	3992
		3993	# always fsync - this file is important
		3994	aio_fsync $fh
		3995	and return;
		3996
		3997	# touch it again to show we are up-to-date
		3998	aio_utime $fh, undef, undef;
		3999
		4000	close $fh
		4001	or return;
		4002
		4003	aio_rename "$RUNTIMEFILE~", $RUNTIMEFILE
		4004	and return;
		4005
		4006	trace sprintf "runtime file written (%gs).\n", AE::time - $t0;
		4007
		4008	1
		4009	}
		4010
		4011	our $uuid_lock;
		4012	our $uuid_skip;
		4013
		4014	sub write_uuid_sync($) {
		4015	$uuid_skip ||= $_[0];
		4016
		4017	return if $uuid_lock;
		4018	local $uuid_lock = 1;
		4019
		4020	my $uuid = "$LOCALDIR/uuid";
		4021
		4022	my $fh = aio_open "$uuid~", O_WRONLY | O_CREAT, 0644
		4023	or return;
		4024
		4025	my $value = uuid_seq uuid_cur;
		4026
		4027	unless ($value) {
		4028	info "cowardly refusing to write zero uuid value!\n";
		4029	return;
		4030	}
		4031
		4032	my $value = uuid_str $value + $uuid_skip;
		4033	$uuid_skip = 0;
		4034
		4035	(aio_write $fh, 0, (length $value), $value, 0) <= 0
		4036	and return;
		4037
		4038	# always fsync - this file is important
		4039	aio_fsync $fh
		4040	and return;
		4041
		4042	close $fh
		4043	or return;
		4044
		4045	aio_rename "$uuid~", $uuid
		4046	and return;
		4047
		4048	trace "uuid file written ($value).\n";
		4049
		4050	1
		4051
		4052	}
		4053
		4054	sub write_uuid($$) {
		4055	my ($skip, $sync) = @_;
		4056
		4057	$sync ? write_uuid_sync $skip
		4058	: async { write_uuid_sync $skip };
		4059	}
		4060
		4061	sub emergency_save() {
		4062	my $freeze_guard = cf::freeze_mainloop;
		4063
		4064	info "emergency_perl_save: enter\n";
		4065
		4066	# this is a trade-off: we want to be very quick here, so
		4067	# save all maps without fsync, and later call a global sync
		4068	# (which in turn might be very very slow)
		4069	local $USE_FSYNC = 0;
		4070
		4071	cf::sync_job {
		4072	cf::write_runtime_sync; # external watchdog should not bark
		4073
		4074	# use a peculiar iteration method to avoid tripping on perl
		4075	# refcount bugs in for. also avoids problems with players
		4076	# and maps saved/destroyed asynchronously.
		4077	info "emergency_perl_save: begin player save\n";
		4078	for my $login (keys %cf::PLAYER) {
		4079	my $pl = $cf::PLAYER{$login} or next;
		4080	$pl->valid or next;
		4081	delete $pl->{unclean_save}; # not strictly necessary, but cannot hurt
		4082	$pl->save;
		4083	}
		4084	info "emergency_perl_save: end player save\n";
		4085
		4086	cf::write_runtime_sync; # external watchdog should not bark
		4087
		4088	info "emergency_perl_save: begin map save\n";
		4089	for my $path (keys %cf::MAP) {
		4090	my $map = $cf::MAP{$path} or next;
		4091	$map->valid or next;
		4092	$map->save;
		4093	}
		4094	info "emergency_perl_save: end map save\n";
		4095
		4096	cf::write_runtime_sync; # external watchdog should not bark
		4097
		4098	info "emergency_perl_save: begin database checkpoint\n";
		4099	BDB::db_env_txn_checkpoint $DB_ENV;
		4100	info "emergency_perl_save: end database checkpoint\n";
		4101
		4102	info "emergency_perl_save: begin write uuid\n";
		4103	write_uuid_sync 1;
		4104	info "emergency_perl_save: end write uuid\n";
		4105
		4106	cf::write_runtime_sync; # external watchdog should not bark
		4107
		4108	trace "emergency_perl_save: syncing database to disk";
		4109	BDB::db_env_txn_checkpoint $DB_ENV;
		4110
		4111	info "emergency_perl_save: starting sync\n";
		4112	IO::AIO::aio_sync sub {
		4113	info "emergency_perl_save: finished sync\n";
		4114	};
		4115
		4116	cf::write_runtime_sync; # external watchdog should not bark
		4117
		4118	trace "emergency_perl_save: flushing outstanding aio requests";
		4119	while (IO::AIO::nreqs || BDB::nreqs) {
		4120	Coro::AnyEvent::sleep 0.01; # let the sync_job do it's thing
		4121	}
		4122
		4123	cf::write_runtime_sync; # external watchdog should not bark
		4124	};
		4125
		4126	info "emergency_perl_save: leave\n";
		4127	}
		4128
		4129	sub post_cleanup {
		4130	my ($make_core) = @_;
		4131
		4132	IO::AIO::flush;
		4133
		4134	error Carp::longmess "post_cleanup backtrace"
		4135	if $make_core;
		4136
		4137	my $fh = pidfile;
		4138	unlink $PIDFILE if <$fh> == $$;
		4139	}
		4140
		4141	# a safer delete_package, copied from Symbol
		4142	sub clear_package($) {
		4143	my $pkg = shift;
		4144
		4145	# expand to full symbol table name if needed
		4146	unless ($pkg =~ /^main::.*::$/) {
		4147	$pkg = "main$pkg" if $pkg =~ /^::/;
		4148	$pkg = "main::$pkg" unless $pkg =~ /^main::/;
		4149	$pkg .= '::' unless $pkg =~ /::$/;
		4150	}
		4151
		4152	my($stem, $leaf) = $pkg =~ m/(.*::)(\w+::)$/;
		4153	my $stem_symtab = *{$stem}{HASH};
		4154
		4155	defined $stem_symtab and exists $stem_symtab->{$leaf}
		4156	or return;
		4157
		4158	# clear all symbols
		4159	my $leaf_symtab = *{$stem_symtab->{$leaf}}{HASH};
		4160	for my $name (keys %$leaf_symtab) {
		4161	_gv_clear *{"$pkg$name"};
		4162	# use PApp::Util; PApp::Util::sv_dump *{"$pkg$name"};
		4163	}
		4164	}
		4165
		4166	sub do_reload_perl() {
		4167	# can/must only be called in main
		4168	unless (in_main) {
		4169	error "can only reload from main coroutine";
		4170	return;
		4171	}
		4172
		4173	return if $RELOAD++;
		4174
		4175	my $t1 = AE::time;
		4176
		4177	while ($RELOAD) {
		4178	cf::get_slot 0.1, -1, "reload_perl";
		4179	info "perl_reload: reloading...";
		4180
		4181	trace "perl_reload: entering sync_job";
		4182
		4183	cf::sync_job {
		4184	#cf::emergency_save;
		4185
		4186	trace "perl_reload: cancelling all extension coros";
		4187	$_->cancel for values %EXT_CORO;
		4188	%EXT_CORO = ();
		4189
		4190	trace "perl_reload: removing commands";
		4191	%COMMAND = ();
		4192
		4193	trace "perl_reload: removing ext/exti commands";
		4194	%EXTCMD = ();
		4195	%EXTICMD = ();
		4196
		4197	trace "perl_reload: unloading/nuking all extensions";
		4198	for my $pkg (@EXTS) {
		4199	trace "... unloading $pkg";
		4200
		4201	if (my $cb = $pkg->can ("unload")) {
		4202	eval {
		4203	$cb->($pkg);
		4204	1
		4205	} or error "$pkg unloaded, but with errors: $@";
		4206	}
		4207
		4208	trace "... clearing $pkg";
		4209	clear_package $pkg;
		4210	}
		4211
		4212	trace "perl_reload: unloading all perl modules loaded from $LIBDIR";
		4213	while (my ($k, $v) = each %INC) {
		4214	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
		4215
		4216	trace "... unloading $k";
		4217	delete $INC{$k};
		4218
		4219	$k =~ s/\.pm$//;
		4220	$k =~ s/\//::/g;
		4221
		4222	if (my $cb = $k->can ("unload_module")) {
		4223	$cb->();
		4224	}
		4225
		4226	clear_package $k;
		4227	}
		4228
		4229	trace "perl_reload: getting rid of safe::, as good as possible";
		4230	clear_package "safe::$_"
		4231	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
		4232
		4233	trace "perl_reload: unloading cf.pm \"a bit\"";
		4234	delete $INC{"cf.pm"};
		4235	delete $INC{"cf/$_.pm"} for @EXTRA_MODULES;
		4236
		4237	# don't, removes xs symbols, too,
		4238	# and global variables created in xs
		4239	#clear_package __PACKAGE__;
		4240
		4241	info "perl_reload: unload completed, starting to reload now";
		4242
		4243	trace "perl_reload: reloading cf.pm";
		4244	require cf;
		4245	cf::_connect_to_perl_1;
		4246
		4247	trace "perl_reload: loading config and database again";
		4248	cf::reload_config;
		4249
		4250	trace "perl_reload: loading extensions";
1231	load_extensions;	4251	cf::load_extensions;
1232	Event::loop;	4252
		4253	if ($REATTACH_ON_RELOAD) {
		4254	trace "perl_reload: reattaching attachments to objects/players";
		4255	_global_reattach; # objects, sockets
		4256	trace "perl_reload: reattaching attachments to maps";
		4257	reattach $_ for values %MAP;
		4258	trace "perl_reload: reattaching attachments to players";
		4259	reattach $_ for values %PLAYER;
		4260	}
		4261
		4262	cf::_post_init 1;
		4263
		4264	trace "perl_reload: leaving sync_job";
		4265
		4266	1
		4267	} or do {
		4268	error $@;
		4269	cf::cleanup "perl_reload: error, exiting.";
		4270	};
		4271
		4272	--$RELOAD;
		4273	}
		4274
		4275	$t1 = AE::time - $t1;
		4276	info "perl_reload: completed in ${t1}s\n";
		4277	};
		4278
		4279	our $RELOAD_WATCHER; # used only during reload
		4280
		4281	sub reload_perl() {
		4282	# doing reload synchronously and two reloads happen back-to-back,
		4283	# coro crashes during coro_state_free->destroy here.
		4284
		4285	$RELOAD_WATCHER ||= cf::async {
		4286	Coro::AIO::aio_wait cache_extensions;
		4287
		4288	$RELOAD_WATCHER = AE::timer $TICK * 1.5, 0, sub {
		4289	do_reload_perl;
		4290	undef $RELOAD_WATCHER;
		4291	};
		4292	};
1233	}	4293	}
		4294
		4295	register_command "reload" => sub {
		4296	my ($who, $arg) = @_;
		4297
		4298	if ($who->flag (FLAG_WIZ)) {
		4299	$who->message ("reloading server.");
		4300	async {
		4301	$Coro::current->{desc} = "perl_reload";
		4302	reload_perl;
		4303	};
		4304	}
		4305	};
1234		4306
1235	#############################################################################	4307	#############################################################################
1236	# initialisation
1237		4308
1238	sub _perl_reload() {	4309	my $bug_warning = 0;
1239	warn "reloading...";
1240		4310
1241	eval {	4311	sub wait_for_tick() {
1242	local $FREEZE = 1;	4312	return Coro::AnyEvent::poll if tick_inhibit || $Coro::current == $Coro::main;
1243		4313
1244	cf::emergency_save;	4314	$WAIT_FOR_TICK->wait;
		4315	}
1245		4316
1246	# cancel all watchers	4317	sub wait_for_tick_begin() {
1247	for (Event::all_watchers) {	4318	return Coro::AnyEvent::poll if tick_inhibit || $Coro::current == $Coro::main;
1248	$_->cancel if $_->data & WF_AUTOCANCEL;	4319
		4320	my $signal = new Coro::Signal;
		4321	push @WAIT_FOR_TICK_BEGIN, $signal;
		4322	$signal->wait;
		4323	}
		4324
		4325	sub tick {
		4326	if ($Coro::current != $Coro::main) {
		4327	Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
		4328	unless ++$bug_warning > 10;
		4329	return;
		4330	}
		4331
		4332	cf::one_tick; # one server iteration
		4333
		4334	#for(1..3e6){} AE::now_update; $NOW=AE::now; # generate load #d#
		4335
		4336	if ($NOW >= $NEXT_RUNTIME_WRITE) {
		4337	$NEXT_RUNTIME_WRITE = List::Util::max $NEXT_RUNTIME_WRITE + 10, $NOW + 5.;
		4338	Coro::async_pool {
		4339	$Coro::current->{desc} = "runtime saver";
		4340	write_runtime_sync
		4341	or error "ERROR: unable to write runtime file: $!";
1249	}	4342	};
		4343	}
1250		4344
1251	# cancel all extension coros	4345	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
1252	$_->cancel for values %EXT_CORO;	4346	$sig->send;
1253	%EXT_CORO = ();	4347	}
		4348	$WAIT_FOR_TICK->broadcast;
1254		4349
1255	# unload all extensions	4350	$LOAD = ($NOW - $TICK_START) / $TICK;
1256	for (@exts) {	4351	$LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
1257	warn "unloading <$_>";
1258	unload_extension $_;
1259	}
1260		4352
1261	# unload all modules loaded from $LIBDIR	4353	if (0) {
1262	while (my ($k, $v) = each %INC) {	4354	if ($NEXT_TICK) {
1263	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;	4355	my $jitter = $TICK_START - $NEXT_TICK;
		4356	$JITTER = $JITTER * 0.75 + $jitter * 0.25;
		4357	debug "jitter $JITTER\n";#d#
		4358	}
		4359	}
		4360	}
1264		4361
1265	warn "removing <$k>";	4362	{
1266	delete $INC{$k};	4363	# configure BDB
		4364	info "initialising database";
1267		4365
1268	$k =~ s/\.pm$//;	4366	BDB::min_parallel 16;
1269	$k =~ s/\//::/g;	4367	BDB::max_poll_reqs $TICK * 0.1;
		4368	#$AnyEvent::BDB::WATCHER->priority (1);
1270		4369
1271	if (my $cb = $k->can ("unload_module")) {	4370	unless ($DB_ENV) {
1272	$cb->();	4371	$DB_ENV = BDB::db_env_create;
		4372	$DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT);
		4373	$DB_ENV->set_flags (&BDB::LOG_AUTOREMOVE ) if BDB::VERSION v0, v4.7;
		4374	$DB_ENV->log_set_config (&BDB::LOG_AUTO_REMOVE) if BDB::VERSION v4.7;
		4375	$DB_ENV->set_timeout (30, BDB::SET_TXN_TIMEOUT);
		4376	$DB_ENV->set_timeout (30, BDB::SET_LOCK_TIMEOUT);
		4377
		4378	cf::sync_job {
		4379	eval {
		4380	BDB::db_env_open
		4381	$DB_ENV,
		4382	$BDBDIR,
		4383	BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
		4384	| BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
		4385	0666;
		4386
		4387	cf::cleanup "db_env_open($BDBDIR): $!" if $!;
1273	}	4388	};
1274		4389
1275	Symbol::delete_package $k;	4390	cf::cleanup "db_env_open(db): $@" if $@;
1276	}	4391	};
		4392	}
1277		4393
1278	# sync database to disk	4394	$BDB_DEADLOCK_WATCHER = EV::periodic 0, 3, 0, sub {
1279	cf::db_sync;	4395	BDB::db_env_lock_detect $DB_ENV, 0, BDB::LOCK_DEFAULT, 0, sub { };
1280	IO::AIO::flush;
1281
1282	# get rid of safe::, as good as possible
1283	Symbol::delete_package "safe::$_"
1284	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
1285
1286	# remove register_script_function callbacks
1287	# TODO
1288
1289	# unload cf.pm "a bit"
1290	delete $INC{"cf.pm"};
1291
1292	# don't, removes xs symbols, too,
1293	# and global variables created in xs
1294	#Symbol::delete_package __PACKAGE__;
1295
1296	# reload cf.pm
1297	warn "reloading cf.pm";
1298	require cf;
1299	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
1300
1301	# load config and database again
1302	cf::cfg_load;
1303	cf::db_load;
1304
1305	# load extensions
1306	warn "load extensions";
1307	cf::load_extensions;
1308
1309	# reattach attachments to objects
1310	warn "reattach";
1311	_global_reattach;
1312	};	4396	};
1313	warn $@ if $@;	4397	$BDB_CHECKPOINT_WATCHER = EV::periodic 0, 60, 0, sub {
1314		4398	BDB::db_env_txn_checkpoint $DB_ENV, 0, 0, 0, sub { };
1315	warn "reloaded";
1316	};
1317
1318	sub perl_reload() {
1319	_perl_reload;
1320	}
1321
1322	register "<global>", __PACKAGE__;
1323
1324	register_command "perl-reload" => sub {
1325	my ($who, $arg) = @_;
1326
1327	if ($who->flag (FLAG_WIZ)) {
1328	$who->message ("reloading...");
1329	_perl_reload;
1330	}	4399	};
1331	};	4400	$BDB_TRICKLE_WATCHER = EV::periodic 0, 10, 0, sub {
		4401	BDB::db_env_memp_trickle $DB_ENV, 20, 0, sub { };
		4402	};
1332		4403
1333	unshift @INC, $LIBDIR;	4404	info "database initialised";
		4405	}
1334		4406
1335	$TICK_WATCHER = Event->timer (	4407	{
1336	reentrant => 0,	4408	# configure IO::AIO
1337	prio => 0,	4409
1338	at => $NEXT_TICK || $TICK,	4410	info "initialising aio";
1339	data => WF_AUTOCANCEL,	4411	IO::AIO::min_parallel 8;
1340	cb => sub {	4412	IO::AIO::max_poll_time $TICK * 0.1;
1341	unless ($FREEZE) {	4413	undef $AnyEvent::AIO::WATCHER;
1342	cf::server_tick; # one server iteration	4414	info "aio initialised";
1343	$RUNTIME += $TICK;	4415	}
		4416
		4417	our $_log_backtrace;
		4418	our $_log_backtrace_last;
		4419
		4420	sub _log_backtrace {
		4421	my ($msg, @addr) = @_;
		4422
		4423	$msg =~ s/\n$//;
		4424
		4425	if ($_log_backtrace_last eq $msg) {
		4426	LOG llevInfo, "[ABT] $msg\n";
		4427	LOG llevInfo, "[ABT] [duplicate, suppressed]\n";
		4428	# limit the # of concurrent backtraces
		4429	} elsif ($_log_backtrace < 2) {
		4430	$_log_backtrace_last = $msg;
		4431	++$_log_backtrace;
		4432	my $perl_bt = Carp::longmess $msg;
		4433	async {
		4434	$Coro::current->{desc} = "abt $msg";
		4435
		4436	my @bt = fork_call {
		4437	@addr = map { sprintf "%x", $_ } @addr;
		4438	my $self = (-f "/proc/$$/exe") ? "/proc/$$/exe" : $^X;
		4439	open my $fh, "exec addr2line -C -f -i -e \Q$self\E @addr 2>&1 |"
		4440	or die "addr2line: $!";
		4441
		4442	my @funcs;
		4443	my @res = <$fh>;
		4444	chomp for @res;
		4445	while (@res) {
		4446	my ($func, $line) = splice @res, 0, 2, ();
		4447	push @funcs, "[$func] $line";
		4448	}
		4449
		4450	@funcs
		4451	};
		4452
		4453	LOG llevInfo, "[ABT] $perl_bt\n";
		4454	LOG llevInfo, "[ABT] --- C backtrace follows ---\n";
		4455	LOG llevInfo, "[ABT] $_\n" for @bt;
		4456	--$_log_backtrace;
1344	}	4457	};
1345		4458	} else {
1346	$NEXT_TICK += $TICK;	4459	LOG llevInfo, "[ABT] $msg\n";
1347		4460	LOG llevInfo, "[ABT] [overload, suppressed]\n";
1348	# if we are delayed by four ticks or more, skip them all
1349	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;
1350
1351	$TICK_WATCHER->at ($NEXT_TICK);
1352	$TICK_WATCHER->start;
1353	},	4461	}
1354	);	4462	}
1355		4463
1356	IO::AIO::max_poll_time $TICK * 0.2;	4464	# load additional modules
		4465	require "cf/$_.pm" for @EXTRA_MODULES;
		4466	cf::_connect_to_perl_2;
1357		4467
1358	Event->io (fd => IO::AIO::poll_fileno,	4468	END { cf::emergency_save }
1359	poll => 'r',
1360	prio => 5,
1361	data => WF_AUTOCANCEL,
1362	cb => \&IO::AIO::poll_cb);
1363
1364	# we must not ever block the main coroutine
1365	$Coro::idle = sub {
1366	#Carp::cluck "FATAL: Coro::idle was called, major BUG\n";#d#
1367	warn "FATAL: Coro::idle was called, major BUG\n";
1368	(Coro::unblock_sub {
1369	Event::one_event;
1370	})->();
1371	};
1372		4469
1373	1	4470	1
1374		4471

Diff Legend

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