[ViewVC] Diff of: cvs/deliantra/server/lib/cf.pm

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.270 by root, Sat May 26 15:44:06 2007 UTC vs.
Revision 1.293 by root, Tue Jul 3 05:14:15 2007 UTC

…		…
20	use Coro::Signal;	20	use Coro::Signal;
21	use Coro::Semaphore;	21	use Coro::Semaphore;
22	use Coro::AIO;	22	use Coro::AIO;
23	use Coro::Storable;	23	use Coro::Storable;
24		24
		25	use JSON::XS 1.4 ();
25	use BDB ();	26	use BDB ();
26	use Data::Dumper;	27	use Data::Dumper;
27	use Digest::MD5;	28	use Digest::MD5;
28	use Fcntl;	29	use Fcntl;
29	use YAML::Syck ();	30	use YAML::Syck ();
…		…
49	our %COMMAND = ();	50	our %COMMAND = ();
50	our %COMMAND_TIME = ();	51	our %COMMAND_TIME = ();
51		52
52	our @EXTS = (); # list of extension package names	53	our @EXTS = (); # list of extension package names
53	our %EXTCMD = ();	54	our %EXTCMD = ();
		55	our %EXTICMD = ();
54	our %EXT_CORO = (); # coroutines bound to extensions	56	our %EXT_CORO = (); # coroutines bound to extensions
55	our %EXT_MAP = (); # pluggable maps	57	our %EXT_MAP = (); # pluggable maps
56		58
57	our $RELOAD; # number of reloads so far	59	our $RELOAD; # number of reloads so far
58	our @EVENT;	60	our @EVENT;
…		…
187	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';	189	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
188	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';	190	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
189	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';	191	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
190	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';	192	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
191	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';	193	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
		194	@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
192	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	195	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; # not really true (yet)
193		196
194	# we bless all objects into (empty) derived classes to force a method lookup	197	# we bless all objects into (empty) derived classes to force a method lookup
195	# within the Safe compartment.	198	# within the Safe compartment.
196	for my $pkg (qw(	199	for my $pkg (qw(
197	cf::global cf::attachable	200	cf::global cf::attachable
…		…
205	}	208	}
206		209
207	$Event::DIED = sub {	210	$Event::DIED = sub {
208	warn "error in event callback: @_";	211	warn "error in event callback: @_";
209	};	212	};
		213
		214	#############################################################################
210		215
211	=head2 UTILITY FUNCTIONS	216	=head2 UTILITY FUNCTIONS
212		217
213	=over 4	218	=over 4
214		219
…		…
233	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;	238	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
234	$d	239	$d
235	} \|\| "[unable to dump $_[0]: '$@']";	240	} \|\| "[unable to dump $_[0]: '$@']";
236	}	241	}
237		242
238	use JSON::XS qw(to_json from_json); # TODO# replace by JSON::PC once working
239
240	=item $ref = cf::from_json $json	243	=item $ref = cf::from_json $json
241		244
242	Converts a JSON string into the corresponding perl data structure.	245	Converts a JSON string into the corresponding perl data structure.
243		246
244	=item $json = cf::to_json $ref	247	=item $json = cf::to_json $ref
245		248
246	Converts a perl data structure into its JSON representation.	249	Converts a perl data structure into its JSON representation.
		250
		251	=cut
		252
		253	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
		254
		255	sub to_json ($) { $json_coder->encode ($_[0]) }
		256	sub from_json ($) { $json_coder->decode ($_[0]) }
247		257
248	=item cf::lock_wait $string	258	=item cf::lock_wait $string
249		259
250	Wait until the given lock is available. See cf::lock_acquire.	260	Wait until the given lock is available. See cf::lock_acquire.
251		261
…		…
317		327
318	BEGIN { *async = \&Coro::async_pool }	328	BEGIN { *async = \&Coro::async_pool }
319		329
320	=item cf::sync_job { BLOCK }	330	=item cf::sync_job { BLOCK }
321		331
322	The design of crossfire+ requires that the main coro ($Coro::main) is	332	The design of Crossfire TRT requires that the main coroutine ($Coro::main)
323	always able to handle events or runnable, as crossfire+ is only partly	333	is always able to handle events or runnable, as Crossfire TRT is only
324	reentrant. Thus "blocking" it by e.g. waiting for I/O is not acceptable.	334	partly reentrant. Thus "blocking" it by e.g. waiting for I/O is not
		335	acceptable.
325		336
326	If it must be done, put the blocking parts into C<sync_job>. This will run	337	If it must be done, put the blocking parts into C<sync_job>. This will run
327	the given BLOCK in another coroutine while waiting for the result. The	338	the given BLOCK in another coroutine while waiting for the result. The
328	server will be frozen during this time, so the block should either finish	339	server will be frozen during this time, so the block should either finish
329	fast or be very important.	340	fast or be very important.
…		…
389	$EXT_CORO{$coro+0} = $coro;	400	$EXT_CORO{$coro+0} = $coro;
390		401
391	$coro	402	$coro
392	}	403	}
393		404
394	sub write_runtime {	405	=item fork_call { }, $args
395	my $runtime = "$LOCALDIR/runtime";
396		406
397	# first touch the runtime file to show we are still running:	407	Executes the given code block with the given arguments in a seperate
398	# the fsync below can take a very very long time.	408	process, returning the results. Everything must be serialisable with
		409	Coro::Storable. May, of course, block. Note that the executed sub may
		410	never block itself or use any form of Event handling.
399		411
400	if (my $fh = aio_open $runtime, O_WRONLY, 0) {	412	=cut
401	utime undef, undef, $fh;
402	}
403		413
404	my $guard = cf::lock_acquire "write_runtime";	414	sub fork_call(&@) {
		415	my ($cb, @args) = @_;
405		416
406	my $fh = aio_open "$runtime~", O_WRONLY \| O_CREAT, 0644	417	# socketpair my $fh1, my $fh2, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC
407	or return;	418	# or die "socketpair: $!";
		419	pipe my $fh1, my $fh2
		420	or die "pipe: $!";
408		421
409	my $value = $cf::RUNTIME + 90 + 10;	422	if (my $pid = fork) {
410	# 10 is the runtime save interval, for a monotonic clock
411	# 60 allows for the watchdog to kill the server.
412
413	(aio_write $fh, 0, (length $value), $value, 0) <= 0
414	and return;
415
416	# always fsync - this file is important
417	aio_fsync $fh
418	and return;
419
420	# touch it again to show we are up-to-date
421	utime undef, undef, $fh;
422
423	close $fh	423	close $fh2;
424	or return;
425		424
426	aio_rename "$runtime~", $runtime	425	my $res = (Coro::Handle::unblock $fh1)->readline (undef);
427	and return;	426	$res = Coro::Storable::thaw $res;
428		427
429	warn "runtime file written.\n";#d#	428	waitpid $pid, 0; # should not block anymore, we expect the child to simply behave
430		429
		430	die $$res unless "ARRAY" eq ref $res;
		431
		432	return wantarray ? @$res : $res->[-1];
		433	} else {
		434	reset_signals;
		435	local $SIG{__WARN__};
		436	local $SIG{__DIE__};
		437	eval {
		438	close $fh1;
		439
		440	my @res = eval { $cb->(@args) };
		441	syswrite $fh2, Coro::Storable::freeze +($@ ? \"$@" : \@res);
		442	};
		443
		444	warn $@ if $@;
		445	_exit 0;
431	1	446	}
		447	}
		448
		449	=item $value = cf::db_get $family => $key
		450
		451	Returns a single value from the environment database.
		452
		453	=item cf::db_put $family => $key => $value
		454
		455	Stores the given C<$value> in the family. It can currently store binary
		456	data only (use Compress::LZF::sfreeze_cr/sthaw to convert to/from binary).
		457
		458	=cut
		459
		460	our $DB;
		461
		462	sub db_init {
		463	unless ($DB) {
		464	$DB = BDB::db_create $DB_ENV;
		465
		466	cf::sync_job {
		467	eval {
		468	$DB->set_flags (BDB::CHKSUM);
		469
		470	BDB::db_open $DB, undef, "db", undef, BDB::BTREE,
		471	BDB::CREATE \| BDB::AUTO_COMMIT, 0666;
		472	cf::cleanup "db_open(db): $!" if $!;
		473	};
		474	cf::cleanup "db_open(db): $@" if $@;
		475	};
		476	}
		477	}
		478
		479	sub db_get($$) {
		480	my $key = "$_[0]/$_[1]";
		481
		482	cf::sync_job {
		483	BDB::db_get $DB, undef, $key, my $data;
		484
		485	$! ? ()
		486	: $data
		487	}
		488	}
		489
		490	sub db_put($$$) {
		491	BDB::dbreq_pri 4;
		492	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
		493	}
		494
		495	=item cf::cache $id => [$paths...], $processversion => $process
		496
		497	Generic caching function that returns the value of the resource $id,
		498	caching and regenerating as required.
		499
		500	This function can block.
		501
		502	=cut
		503
		504	sub cache {
		505	my ($id, $src, $processversion, $process) = @_;
		506
		507	my $meta =
		508	join "\x00",
		509	$processversion,
		510	map {
		511	aio_stat $_
		512	and Carp::croak "$_: $!";
		513
		514	($_, (stat _)[7,9])
		515	} @$src;
		516
		517	my $dbmeta = db_get cache => "$id/meta";
		518	if ($dbmeta ne $meta) {
		519	# changed, we may need to process
		520
		521	my @data;
		522	my $md5;
		523
		524	for (0 .. $#$src) {
		525	0 <= aio_load $src->[$_], $data[$_]
		526	or Carp::croak "$src->[$_]: $!";
		527	}
		528
		529	# if processing is expensive, check
		530	# checksum first
		531	if (1) {
		532	$md5 =
		533	join "\x00",
		534	$processversion,
		535	map {
		536	Coro::cede;
		537	($src->[$_], Digest::MD5::md5_hex $data[$_])
		538	} 0.. $#$src;
		539
		540
		541	my $dbmd5 = db_get cache => "$id/md5";
		542	if ($dbmd5 eq $md5) {
		543	db_put cache => "$id/meta", $meta;
		544
		545	return db_get cache => "$id/data";
		546	}
		547	}
		548
		549	my $t1 = Time::HiRes::time;
		550	my $data = $process->(\@data);
		551	my $t2 = Time::HiRes::time;
		552
		553	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
		554
		555	db_put cache => "$id/data", $data;
		556	db_put cache => "$id/md5" , $md5;
		557	db_put cache => "$id/meta", $meta;
		558
		559	return $data;
		560	}
		561
		562	db_get cache => "$id/data"
432	}	563	}
433		564
434	=item cf::datalog type => key => value, ...	565	=item cf::datalog type => key => value, ...
435		566
436	Log a datalog packet of the given type with the given key-value pairs.	567	Log a datalog packet of the given type with the given key-value pairs.
…		…
454	attach callbacks/event handlers (a collection of which is called an "attachment")	585	attach callbacks/event handlers (a collection of which is called an "attachment")
455	to it. All such attachable objects support the following methods.	586	to it. All such attachable objects support the following methods.
456		587
457	In the following description, CLASS can be any of C<global>, C<object>	588	In the following description, CLASS can be any of C<global>, C<object>
458	C<player>, C<client> or C<map> (i.e. the attachable objects in	589	C<player>, C<client> or C<map> (i.e. the attachable objects in
459	crossfire+).	590	Crossfire TRT).
460		591
461	=over 4	592	=over 4
462		593
463	=item $attachable->attach ($attachment, key => $value...)	594	=item $attachable->attach ($attachment, key => $value...)
464		595
…		…
666	_attach $registry, $klass, @attach;	797	_attach $registry, $klass, @attach;
667	}	798	}
668		799
669	$obj->{$name} = \%arg;	800	$obj->{$name} = \%arg;
670	} else {	801	} else {
671	warn "object uses attachment '$name' that is not available, postponing.\n";	802	warn "object uses attachment '$name' which is not available, postponing.\n";
672	}	803	}
673		804
674	$obj->{_attachment}{$name} = undef;	805	$obj->{_attachment}{$name} = undef;
675	}	806	}
676		807
…		…
874	or return;	1005	or return;
875	$av = eval { (Storable::thaw $av)->{objs} };	1006	$av = eval { (Storable::thaw $av)->{objs} };
876	}	1007	}
877		1008
878	warn sprintf "loading %s (%d)\n",	1009	warn sprintf "loading %s (%d)\n",
879	$filename, length $data, scalar @{$av \|\| []};#d#	1010	$filename, length $data, scalar @{$av \|\| []};
880	return ($data, $av);	1011	return ($data, $av);
881	}	1012	}
		1013
		1014	=head2 COMMAND CALLBACKS
		1015
		1016	=over 4
		1017
		1018	=cut
882		1019
883	#############################################################################	1020	#############################################################################
884	# command handling &c	1021	# command handling &c
885		1022
886	=item cf::register_command $name => \&callback($ob,$args);	1023	=item cf::register_command $name => \&callback($ob,$args);
…		…
899	push @{ $COMMAND{$name} }, [$caller, $cb];	1036	push @{ $COMMAND{$name} }, [$caller, $cb];
900	}	1037	}
901		1038
902	=item cf::register_extcmd $name => \&callback($pl,$packet);	1039	=item cf::register_extcmd $name => \&callback($pl,$packet);
903		1040
904	Register a callbackf ro execution when the client sends an extcmd packet.	1041	Register a callback for execution when the client sends an (synchronous)
		1042	extcmd packet. Ext commands will be processed in the order they are
		1043	received by the server, like other user commands. The first argument is
		1044	the logged-in player. Ext commands can only be processed after a player
		1045	has logged in successfully.
905		1046
906	If the callback returns something, it is sent back as if reply was being	1047	If the callback returns something, it is sent back as if reply was being
907	called.	1048	called.
908		1049
		1050	=item cf::register_exticmd $name => \&callback($ns,$packet);
		1051
		1052	Register a callback for execution when the client sends an (asynchronous)
		1053	exticmd packet. Exti commands are processed by the server as soon as they
		1054	are received, i.e. out of order w.r.t. other commands. The first argument
		1055	is a client socket. Exti commands can be received anytime, even before
		1056	log-in.
		1057
		1058	If the callback returns something, it is sent back as if reply was being
		1059	called.
		1060
909	=cut	1061	=cut
910		1062
911	sub register_extcmd {	1063	sub register_extcmd {
912	my ($name, $cb) = @_;	1064	my ($name, $cb) = @_;
913		1065
914	$EXTCMD{$name} = $cb;	1066	$EXTCMD{$name} = $cb;
		1067	}
		1068
		1069	sub register_exticmd {
		1070	my ($name, $cb) = @_;
		1071
		1072	$EXTICMD{$name} = $cb;
915	}	1073	}
916		1074
917	cf::player->attach (	1075	cf::player->attach (
918	on_command => sub {	1076	on_command => sub {
919	my ($pl, $name, $params) = @_;	1077	my ($pl, $name, $params) = @_;
…		…
928	cf::override;	1086	cf::override;
929	},	1087	},
930	on_extcmd => sub {	1088	on_extcmd => sub {
931	my ($pl, $buf) = @_;	1089	my ($pl, $buf) = @_;
932		1090
933	my $msg = eval { from_json $buf };	1091	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
934		1092
935	if (ref $msg) {	1093	if (ref $msg) {
936	if (my $cb = $EXTCMD{$msg->{msgtype}}) {	1094	if (my $cb = $EXTCMD{$msg->{msgtype}}) {
937	if (my %reply = $cb->($pl, $msg)) {	1095	if (my %reply = $cb->($pl, $msg)) {
938	$pl->ext_reply ($msg->{msgid}, %reply);	1096	$pl->ext_reply ($msg->{msgid}, %reply);
…		…
944		1102
945	cf::override;	1103	cf::override;
946	},	1104	},
947	);	1105	);
948		1106
949	sub load_extension {
950	my ($path) = @_;
951
952	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
953	my $base = $1;
954	my $pkg = $1;
955	$pkg =~ s/[^[:word:]]/_/g;
956	$pkg = "ext::$pkg";
957
958	warn "... loading '$path' into '$pkg'\n";
959
960	open my $fh, "<:utf8", $path
961	or die "$path: $!";
962
963	my $source =
964	"package $pkg; use strict; use utf8;\n"
965	. "#line 1 \"$path\"\n{\n"
966	. (do { local $/; <$fh> })
967	. "\n};\n1";
968
969	unless (eval $source) {
970	my $msg = $@ ? "$path: $@\n"
971	: "extension disabled.\n";
972	if ($source =~ /^#!.perl.#.*MANDATORY/m) { # ugly match
973	warn $@;
974	warn "mandatory extension failed to load, exiting.\n";
975	exit 1;
976	}
977	die $@;
978	}
979
980	push @EXTS, $pkg;
981	}
982
983	sub load_extensions {	1107	sub load_extensions {
		1108	cf::sync_job {
		1109	my %todo;
		1110
984	for my $ext (<$LIBDIR/*.ext>) {	1111	for my $path (<$LIBDIR/*.ext>) {
985	next unless -r $ext;	1112	next unless -r $path;
986	eval {	1113
987	load_extension $ext;	1114	$path =~ /([^\/\\]+)\.ext$/ or die "$path";
		1115	my $base = $1;
		1116	my $pkg = $1;
		1117	$pkg =~ s/[^[:word:]]/_/g;
		1118	$pkg = "ext::$pkg";
		1119
		1120	open my $fh, "<:utf8", $path
		1121	or die "$path: $!";
		1122
		1123	my $source = do { local $/; <$fh> };
		1124
		1125	my %ext = (
		1126	path => $path,
		1127	base => $base,
		1128	pkg => $pkg,
		1129	);
		1130
		1131	$ext{meta} = { map { (split /=/, $_, 2)[0, 1] } split /\s+/, $1 }
		1132	if $source =~ /\A#!.?perl.?#\s(.)$/m;
		1133
		1134	$ext{source} =
		1135	"package $pkg; use strict; use utf8;\n"
		1136	. "#line 1 \"$path\"\n{\n"
		1137	. $source
		1138	. "\n};\n1";
		1139
		1140	$todo{$base} = \%ext;
		1141	}
		1142
		1143	my %done;
		1144	while (%todo) {
		1145	my $progress;
		1146
		1147	while (my ($k, $v) = each %todo) {
		1148	for (split /,\s*/, $v->{meta}{depends}) {
		1149	goto skip
		1150	unless exists $done{$_};
		1151	}
		1152
		1153	warn "... loading '$k' into '$v->{pkg}'\n";
		1154
		1155	unless (eval $v->{source}) {
		1156	my $msg = $@ ? "$v->{path}: $@\n"
		1157	: "$v->{base}: extension inactive.\n";
		1158
		1159	if (exists $v->{meta}{mandatory}) {
		1160	warn $msg;
		1161	warn "mandatory extension failed to load, exiting.\n";
		1162	exit 1;
		1163	}
		1164
		1165	warn $msg;
		1166	}
		1167
		1168	$done{$k} = delete $todo{$k};
		1169	push @EXTS, $v->{pkg};
		1170	$progress = 1;
988	1	1171	}
989	} or warn "$ext not loaded: $@";	1172
		1173	skip:
		1174	die "cannot load " . (join ", ", keys %todo) . ": unable to resolve dependencies\n"
		1175	unless $progress;
		1176	}
990	}	1177	};
991	}	1178	}
992		1179
993	#############################################################################	1180	#############################################################################
		1181
		1182	=back
994		1183
995	=head2 CORE EXTENSIONS	1184	=head2 CORE EXTENSIONS
996		1185
997	Functions and methods that extend core crossfire objects.	1186	Functions and methods that extend core crossfire objects.
998		1187
…		…
1186	}	1375	}
1187		1376
1188	\@paths	1377	\@paths
1189	}	1378	}
1190		1379
		1380	=item $protocol_xml = $player->expand_cfpod ($crossfire_pod)
		1381
		1382	Expand crossfire pod fragments into protocol xml.
		1383
		1384	=cut
		1385
		1386	sub expand_cfpod {
		1387	((my $self), (local $_)) = @_;
		1388
		1389	# escape & and <
		1390	s/&/&/g;
		1391	s/(?<![BIUGH])</</g;
		1392
		1393	# this is buggy, it needs to properly take care of nested <'s
		1394
		1395	1 while
		1396	# replace B<>, I<>, U<> etc.
		1397	s/B<([^\>]*)>/<b>$1<\/b>/
		1398	\|\| s/I<([^\>]*)>/<i>$1<\/i>/
		1399	\|\| s/U<([^\>]*)>/<u>$1<\/u>/
		1400	# replace G<male\|female> tags
		1401	\|\| s{G<([^>\|])\\|([^>])>}{
		1402	$self->gender ? $2 : $1
		1403	}ge
		1404	# replace H<hint text>
		1405	\|\| s{H<([^\>]*)>}
		1406	{
		1407	("<fg name=\"lightblue\">[$1 (Use hintmode to suppress hints)]</fg>",
		1408	"<fg name=\"lightblue\">[Hint suppressed, see hintmode]</fg>",
		1409	"")
		1410	[$self->{hintmode}]
		1411	}ge;
		1412
		1413	# create single paragraphs (very hackish)
		1414	s/(?<=\S)\n(?=\w)/ /g;
		1415
		1416	# compress some whitespace
		1417	1 while s/\s\n\s\n\s*/\n/;
		1418
		1419	s/^\s+//;
		1420	s/\s+$//;
		1421
		1422	$_
		1423	}
		1424
		1425	sub hintmode {
		1426	$_[0]{hintmode} = $_[1] if @_ > 1;
		1427	$_[0]{hintmode}
		1428	}
		1429
1191	=item $player->ext_reply ($msgid, %msg)	1430	=item $player->ext_reply ($msgid, %msg)
1192		1431
1193	Sends an ext reply to the player.	1432	Sends an ext reply to the player.
1194		1433
1195	=cut	1434	=cut
1196		1435
1197	sub ext_reply($$%) {	1436	sub ext_reply($$%) {
1198	my ($self, $id, %msg) = @_;	1437	my ($self, $id, %msg) = @_;
1199		1438
1200	$msg{msgid} = $id;	1439	$msg{msgid} = $id;
1201		1440	$self->send ("ext " . $self->ns->{json_coder}->encode (\%msg));
1202	$self->send ("ext " . cf::to_json \%msg);
1203	}	1441	}
1204		1442
1205	=item $player->ext_event ($type, %msg)	1443	=item $player->ext_event ($type, %msg)
1206		1444
1207	Sends an ext event to the client.	1445	Sends an ext event to the client.
…		…
1222		1460
1223	package cf::region;	1461	package cf::region;
1224		1462
1225	=item cf::region::find_by_path $path	1463	=item cf::region::find_by_path $path
1226		1464
1227	Tries to decuce the probable region for a map knowing only its path.	1465	Tries to decuce the likely region for a map knowing only its path.
1228		1466
1229	=cut	1467	=cut
1230		1468
1231	sub find_by_path($) {	1469	sub find_by_path($) {
1232	my ($path) = @_;	1470	my ($path) = @_;
…		…
1306	my ($self, $merge) = @_;	1544	my ($self, $merge) = @_;
1307		1545
1308	# we have to keep some variables in memory intact	1546	# we have to keep some variables in memory intact
1309	local $self->{path};	1547	local $self->{path};
1310	local $self->{load_path};	1548	local $self->{load_path};
1311	local $self->{deny_save};
1312	local $self->{deny_reset};
1313		1549
1314	$self->SUPER::thawer_merge ($merge);	1550	$self->SUPER::thawer_merge ($merge);
1315	}	1551	}
1316		1552
1317	sub normalise {	1553	sub normalise {
…		…
1417		1653
1418	$_->change_map_light ($change)	1654	$_->change_map_light ($change)
1419	for grep $_->outdoor, values %cf::MAP;	1655	for grep $_->outdoor, values %cf::MAP;
1420	}	1656	}
1421		1657
		1658	sub decay_objects {
		1659	my ($self) = @_;
		1660
		1661	return if $self->{deny_reset};
		1662
		1663	$self->do_decay_objects;
		1664	}
		1665
1422	sub unlink_save {	1666	sub unlink_save {
1423	my ($self) = @_;	1667	my ($self) = @_;
1424		1668
1425	utf8::encode (my $save = $self->save_path);	1669	utf8::encode (my $save = $self->save_path);
1426	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;	1670	IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
…		…
1482	$self->load_header_orig	1726	$self->load_header_orig
1483	or return;	1727	or return;
1484	$self->prepare_orig;	1728	$self->prepare_orig;
1485	}	1729	}
1486		1730
		1731	$self->{deny_reset} = 1
		1732	if $self->no_reset;
		1733
1487	$self->default_region (cf::region::find_by_path $self->{path})	1734	$self->default_region (cf::region::find_by_path $self->{path})
1488	unless $self->default_region;	1735	unless $self->default_region;
1489		1736
1490	1	1737	1
1491	}	1738	}
…		…
1506	$map->{last_save} = $cf::RUNTIME;	1753	$map->{last_save} = $cf::RUNTIME;
1507		1754
1508	$map->load_header	1755	$map->load_header
1509	or return;	1756	or return;
1510		1757
1511	if ($map->should_reset && 0) {#d#TODO# disabled, crashy (locking issue?)	1758	if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
1512	# doing this can freeze the server in a sync job, obviously	1759	# doing this can freeze the server in a sync job, obviously
1513	#$cf::WAIT_FOR_TICK->wait;	1760	#$cf::WAIT_FOR_TICK->wait;
1514	$map->reset;	1761	$map->reset;
1515	undef $guard;	1762	undef $guard;
1516	return find $path;	1763	return find $path;
…		…
1583	my ($self, $ob) = @_;	1830	my ($self, $ob) = @_;
1584		1831
1585	return find "~" . $ob->name . "/" . $self->{path}	1832	return find "~" . $ob->name . "/" . $self->{path}
1586	if $self->per_player;	1833	if $self->per_player;
1587		1834
		1835	# return find "?party/" . $ob->name . "/" . $self->{path}
		1836	# if $self->per_party;
		1837
1588	$self	1838	$self
1589	}	1839	}
1590		1840
1591	# find and load all maps in the 3x3 area around a map	1841	# find and load all maps in the 3x3 area around a map
1592	sub load_diag {	1842	sub load_diag {
…		…
1702		1952
1703	sub reset_at {	1953	sub reset_at {
1704	my ($self) = @_;	1954	my ($self) = @_;
1705		1955
1706	# TODO: safety, remove and allow resettable per-player maps	1956	# TODO: safety, remove and allow resettable per-player maps
1707	return 1e99 if $self->isa ("ext::map_per_player");#d#
1708	return 1e99 if $self->{deny_reset};	1957	return 1e99 if $self->{deny_reset};
1709		1958
1710	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;	1959	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
1711	my $to = List::Util::min $MAX_RESET, $self->reset_timeout \|\| $DEFAULT_RESET;	1960	my $to = List::Util::min $MAX_RESET, $self->reset_timeout \|\| $DEFAULT_RESET;
1712		1961
…		…
1723	my ($self) = @_;	1972	my ($self) = @_;
1724		1973
1725	my $lock = cf::lock_acquire "map_data:$self->{path}";	1974	my $lock = cf::lock_acquire "map_data:$self->{path}";
1726		1975
1727	return if $self->players;	1976	return if $self->players;
1728	return if $self->isa ("ext::map_per_player");#d#
1729		1977
1730	warn "resetting map ", $self->path;#d#	1978	warn "resetting map ", $self->path;
1731		1979
1732	$self->in_memory (cf::MAP_SWAPPED);	1980	$self->in_memory (cf::MAP_SWAPPED);
1733		1981
1734	# need to save uniques path	1982	# need to save uniques path
1735	unless ($self->{deny_save}) {	1983	unless ($self->{deny_save}) {
…		…
1767	$cf::MAP{$self->path} = $self;	2015	$cf::MAP{$self->path} = $self;
1768		2016
1769	$self->reset; # polite request, might not happen	2017	$self->reset; # polite request, might not happen
1770	}	2018	}
1771		2019
		2020	=item $maps = cf::map::tmp_maps
		2021
		2022	Returns an arrayref with all map paths of currently instantiated and saved
		2023	maps. May block.
		2024
		2025	=cut
		2026
		2027	sub tmp_maps() {
		2028	[
		2029	map {
		2030	utf8::decode $_;
		2031	/\.map$/
		2032	? normalise $_
		2033	: ()
		2034	} @{ aio_readdir $TMPDIR or [] }
		2035	]
		2036	}
		2037
		2038	=item $maps = cf::map::random_maps
		2039
		2040	Returns an arrayref with all map paths of currently instantiated and saved
		2041	random maps. May block.
		2042
		2043	=cut
		2044
		2045	sub random_maps() {
		2046	[
		2047	map {
		2048	utf8::decode $_;
		2049	/\.map$/
		2050	? normalise "?random/$_"
		2051	: ()
		2052	} @{ aio_readdir $RANDOMDIR or [] }
		2053	]
		2054	}
		2055
1772	=item cf::map::unique_maps	2056	=item cf::map::unique_maps
1773		2057
1774	Returns an arrayref of paths of all shared maps that have	2058	Returns an arrayref of paths of all shared maps that have
1775	instantiated unique items. May block.	2059	instantiated unique items. May block.
1776		2060
1777	=cut	2061	=cut
1778		2062
1779	sub unique_maps() {	2063	sub unique_maps() {
1780	my $files = aio_readdir $UNIQUEDIR	2064	[
1781	or return;	2065	map {
1782
1783	my @paths;
1784
1785	for (@$files) {
1786	utf8::decode $_;	2066	utf8::decode $_;
1787	next if /\.pst$/;	2067	/\.map$/
1788	next unless /^$PATH_SEP/o;	2068	? normalise $_
1789		2069	: ()
1790	push @paths, cf::map::normalise $_;	2070	} @{ aio_readdir $UNIQUEDIR or [] }
1791	}	2071	]
1792
1793	\@paths
1794	}	2072	}
1795		2073
1796	package cf;	2074	package cf;
1797		2075
1798	=back	2076	=back
…		…
1844		2122
1845	$flags = cf::NDI_BROWN \| cf::NDI_UNIQUE unless @_ >= 4;	2123	$flags = cf::NDI_BROWN \| cf::NDI_UNIQUE unless @_ >= 4;
1846		2124
1847	if ($self->{record_replies}) {	2125	if ($self->{record_replies}) {
1848	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2126	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2127
1849	} else {	2128	} else {
		2129	my $pl = $self->contr;
		2130
		2131	if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
		2132	my $diag = $pl->{npc_dialog};
		2133	$diag->{pl}->ext_reply (
		2134	$diag->{id},
		2135	msgtype => "reply",
		2136	msg => $diag->{pl}->expand_cfpod ($msg),
		2137	add_topics => []
		2138	);
		2139
		2140	} else {
1850	$msg = $npc->name . " says: $msg" if $npc;	2141	$msg = $npc->name . " says: $msg" if $npc;
1851	$self->message ($msg, $flags);	2142	$self->message ($msg, $flags);
		2143	}
1852	}	2144	}
1853	}	2145	}
1854		2146
1855	=item $player_object->may ("access")	2147	=item $player_object->may ("access")
1856		2148
…		…
2101		2393
2102	utf8::encode $text;	2394	utf8::encode $text;
2103	$self->send_packet (sprintf "drawinfo %d %s", $flags \|\| cf::NDI_BLACK, $text);	2395	$self->send_packet (sprintf "drawinfo %d %s", $flags \|\| cf::NDI_BLACK, $text);
2104	}	2396	}
2105		2397
		2398	=item $client->send_msg ($color, $type, $msg, [extra...])
		2399
		2400	Send a drawinfo or msg packet to the client, formatting the msg for the
		2401	client if neccessary. C<$type> should be a string identifying the type of
		2402	the message, with C<log> being the default. If C<$color> is negative, suppress
		2403	the message unless the client supports the msg packet.
		2404
		2405	=cut
		2406
		2407	sub cf::client::send_msg {
		2408	my ($self, $color, $type, $msg, @extra) = @_;
		2409
		2410	$msg = $self->pl->expand_cfpod ($msg);
		2411
		2412	if ($self->can_msg) {
		2413	$self->send_packet ("msg " . $self->{json_coder}->encode ([$color, $type, $msg, @extra]));
		2414	} else {
		2415	# replace some tags by gcfclient-compatible ones
		2416	for ($msg) {
		2417	1 while
		2418	s/<b>([^<]*)<\/b>/[b]${1}[\/b]/
		2419	\|\| s/<i>([^<]*)<\/i>/[i]${1}[\/i]/
		2420	\|\| s/<u>([^<]*)<\/u>/[ul]${1}[\/ul]/
		2421	\|\| s/<tt>([^<]*)<\/tt>/[fixed]${1}[\/fixed]/
		2422	\|\| s/<fg name=\"([^"]+)\">([^<]*)<\/fg>/[color=$1]${2}[\/color]/;
		2423	}
		2424
		2425	if ($color >= 0) {
		2426	if (0 && $msg =~ /\[/) {
		2427	$self->send_packet ("drawextinfo $color 4 0 $msg")
		2428	} else {
		2429	$msg =~ s/\[\/?(?:b\|i\|u\|fixed\|color)[^\]]*\]//g;
		2430	$self->send_packet ("drawinfo $color $msg")
		2431	}
		2432	}
		2433	}
		2434	}
		2435
2106	=item $client->ext_event ($type, %msg)	2436	=item $client->ext_event ($type, %msg)
2107		2437
2108	Sends an exti event to the client.	2438	Sends an ext event to the client.
2109		2439
2110	=cut	2440	=cut
2111		2441
2112	sub cf::client::ext_event($$%) {	2442	sub cf::client::ext_event($$%) {
2113	my ($self, $type, %msg) = @_;	2443	my ($self, $type, %msg) = @_;
2114		2444
2115	$msg{msgtype} = "event_$type";	2445	$msg{msgtype} = "event_$type";
2116	$self->send_packet ("ext " . cf::to_json \%msg);	2446	$self->send_packet ("ext " . $self->{json_coder}->encode (\%msg));
2117	}	2447	}
2118		2448
2119	=item $success = $client->query ($flags, "text", \&cb)	2449	=item $success = $client->query ($flags, "text", \&cb)
2120		2450
2121	Queues a query to the client, calling the given callback with	2451	Queues a query to the client, calling the given callback with
2122	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,	2452	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
2123	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.	2453	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
2124		2454
2125	Queries can fail, so check the return code. Or don't, as queries will become	2455	Queries can fail, so check the return code. Or don't, as queries will
2126	reliable at some point in the future.	2456	become reliable at some point in the future.
2127		2457
2128	=cut	2458	=cut
2129		2459
2130	sub cf::client::query {	2460	sub cf::client::query {
2131	my ($self, $flags, $text, $cb) = @_;	2461	my ($self, $flags, $text, $cb) = @_;
…		…
2139	utf8::encode $text;	2469	utf8::encode $text;
2140	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];	2470	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
2141		2471
2142	$self->send_packet ($self->{query_queue}[0][0])	2472	$self->send_packet ($self->{query_queue}[0][0])
2143	if @{ $self->{query_queue} } == 1;	2473	if @{ $self->{query_queue} } == 1;
		2474
		2475	1
2144	}	2476	}
2145		2477
2146	cf::client->attach (	2478	cf::client->attach (
		2479	on_connect => sub {
		2480	my ($ns) = @_;
		2481
		2482	$ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
		2483	},
2147	on_reply => sub {	2484	on_reply => sub {
2148	my ($ns, $msg) = @_;	2485	my ($ns, $msg) = @_;
2149		2486
2150	# this weird shuffling is so that direct followup queries	2487	# this weird shuffling is so that direct followup queries
2151	# get handled first	2488	# get handled first
…		…
2162	$ns->send_packet ($ns->{query_queue}[0][0]);	2499	$ns->send_packet ($ns->{query_queue}[0][0]);
2163	} else {	2500	} else {
2164	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;	2501	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2165	}	2502	}
2166	}	2503	}
		2504	},
		2505	on_exticmd => sub {
		2506	my ($ns, $buf) = @_;
		2507
		2508	my $msg = eval { $ns->{json_coder}->decode ($buf) };
		2509
		2510	if (ref $msg) {
		2511	if (my $cb = $EXTICMD{$msg->{msgtype}}) {
		2512	if (my %reply = $cb->($ns, $msg)) {
		2513	$reply{msgid} = $msg->{msgid};
		2514	$ns->send ("ext " . $ns->{json_coder}->encode (\%reply));
		2515	}
		2516	}
		2517	} else {
		2518	warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
		2519	}
		2520
		2521	cf::override;
2167	},	2522	},
2168	);	2523	);
2169		2524
2170	=item $client->async (\&cb)	2525	=item $client->async (\&cb)
2171		2526
…		…
2310	=back	2665	=back
2311		2666
2312	=cut	2667	=cut
2313		2668
2314	#############################################################################	2669	#############################################################################
2315
2316	=head2 EXTENSION DATABASE SUPPORT
2317
2318	Crossfire maintains a very simple database for extension use. It can
2319	currently store binary data only (use Compress::LZF::sfreeze_cr/sthaw to
2320	convert to/from binary).
2321
2322	The parameter C<$family> should best start with the name of the extension
2323	using it, it should be unique.
2324
2325	=over 4
2326
2327	=item $value = cf::db_get $family => $key
2328
2329	Returns a single value from the database.
2330
2331	=item cf::db_put $family => $key => $value
2332
2333	Stores the given C<$value> in the family.
2334
2335	=cut
2336
2337	our $DB;
2338
2339	sub db_init {
2340	unless ($DB) {
2341	$DB = BDB::db_create $DB_ENV;
2342
2343	cf::sync_job {
2344	eval {
2345	$DB->set_flags (BDB::CHKSUM);
2346
2347	BDB::db_open $DB, undef, "db", undef, BDB::BTREE,
2348	BDB::CREATE \| BDB::AUTO_COMMIT, 0666;
2349	cf::cleanup "db_open(db): $!" if $!;
2350	};
2351	cf::cleanup "db_open(db): $@" if $@;
2352	};
2353	}
2354	}
2355
2356	sub db_get($$) {
2357	my $key = "$_[0]/$_[1]";
2358
2359	cf::sync_job {
2360	BDB::db_get $DB, undef, $key, my $data;
2361
2362	$! ? ()
2363	: $data
2364	}
2365	}
2366
2367	sub db_put($$$) {
2368	BDB::dbreq_pri 4;
2369	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
2370	}
2371
2372	=item cf::cache $id => [$paths...], $processversion => $process
2373
2374	Generic caching function that returns the value of the resource $id,
2375	caching and regenerating as required.
2376
2377	This function can block.
2378
2379	=cut
2380
2381	sub cache {
2382	my ($id, $src, $processversion, $process) = @_;
2383
2384	my $meta =
2385	join "\x00",
2386	$processversion,
2387	map {
2388	aio_stat $_
2389	and Carp::croak "$_: $!";
2390
2391	($_, (stat _)[7,9])
2392	} @$src;
2393
2394	my $dbmeta = db_get cache => "$id/meta";
2395	if ($dbmeta ne $meta) {
2396	# changed, we may need to process
2397
2398	my @data;
2399	my $md5;
2400
2401	for (0 .. $#$src) {
2402	0 <= aio_load $src->[$_], $data[$_]
2403	or Carp::croak "$src->[$_]: $!";
2404	}
2405
2406	# if processing is expensive, check
2407	# checksum first
2408	if (1) {
2409	$md5 =
2410	join "\x00",
2411	$processversion,
2412	map {
2413	Coro::cede;
2414	($src->[$_], Digest::MD5::md5_hex $data[$_])
2415	} 0.. $#$src;
2416
2417
2418	my $dbmd5 = db_get cache => "$id/md5";
2419	if ($dbmd5 eq $md5) {
2420	db_put cache => "$id/meta", $meta;
2421
2422	return db_get cache => "$id/data";
2423	}
2424	}
2425
2426	my $t1 = Time::HiRes::time;
2427	my $data = $process->(\@data);
2428	my $t2 = Time::HiRes::time;
2429
2430	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
2431
2432	db_put cache => "$id/data", $data;
2433	db_put cache => "$id/md5" , $md5;
2434	db_put cache => "$id/meta", $meta;
2435
2436	return $data;
2437	}
2438
2439	db_get cache => "$id/data"
2440	}
2441
2442	=item fork_call { }, $args
2443
2444	Executes the given code block with the given arguments in a seperate
2445	process, returning the results. Everything must be serialisable with
2446	Coro::Storable. May, of course, block. Note that the executed sub may
2447	never block itself or use any form of Event handling.
2448
2449	=cut
2450
2451	sub fork_call(&@) {
2452	my ($cb, @args) = @_;
2453
2454	# socketpair my $fh1, my $fh2, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC
2455	# or die "socketpair: $!";
2456	pipe my $fh1, my $fh2
2457	or die "pipe: $!";
2458
2459	if (my $pid = fork) {
2460	close $fh2;
2461
2462	my $res = (Coro::Handle::unblock $fh1)->readline (undef);
2463	$res = Coro::Storable::thaw $res;
2464
2465	waitpid $pid, 0; # should not block anymore, we expect the child to simply behave
2466
2467	die $$res unless "ARRAY" eq ref $res;
2468
2469	return wantarray ? @$res : $res->[-1];
2470	} else {
2471	reset_signals;
2472	local $SIG{__WARN__};
2473	local $SIG{__DIE__};
2474	eval {
2475	close $fh1;
2476
2477	my @res = eval { $cb->(@args) };
2478	syswrite $fh2, Coro::Storable::freeze +($@ ? \"$@" : \@res);
2479	};
2480
2481	warn $@ if $@;
2482	_exit 0;
2483	}
2484	}
2485
2486
2487
2488	#############################################################################
2489	# the server's init and main functions	2670	# the server's init and main functions
2490		2671
2491	sub load_facedata($) {	2672	sub load_facedata($) {
2492	my ($path) = @_;	2673	my ($path) = @_;
2493		2674
…		…
2551	}	2732	}
2552		2733
2553	sub reload_archetypes {	2734	sub reload_archetypes {
2554	load_resource_file "$DATADIR/archetypes"	2735	load_resource_file "$DATADIR/archetypes"
2555	or die "unable to load archetypes\n";	2736	or die "unable to load archetypes\n";
		2737	#d# NEED to laod twice to resolve forward references
		2738	# this really needs to be done in an extra post-pass
		2739	# (which needs to be synchronous, so solve it differently)
		2740	load_resource_file "$DATADIR/archetypes"
		2741	or die "unable to load archetypes\n";
2556	}	2742	}
2557		2743
2558	sub reload_treasures {	2744	sub reload_treasures {
2559	load_resource_file "$DATADIR/treasures"	2745	load_resource_file "$DATADIR/treasures"
2560	or die "unable to load treasurelists\n";	2746	or die "unable to load treasurelists\n";
…		…
2563	sub reload_resources {	2749	sub reload_resources {
2564	warn "reloading resource files...\n";	2750	warn "reloading resource files...\n";
2565		2751
2566	reload_regions;	2752	reload_regions;
2567	reload_facedata;	2753	reload_facedata;
		2754	#reload_archetypes;#d#
2568	reload_archetypes;	2755	reload_archetypes;
2569	reload_treasures;	2756	reload_treasures;
2570		2757
2571	warn "finished reloading resource files\n";	2758	warn "finished reloading resource files\n";
2572	}	2759	}
…		…
2629	},	2816	},
2630	);	2817	);
2631	}	2818	}
2632	}	2819	}
2633		2820
		2821	sub write_runtime {
		2822	my $runtime = "$LOCALDIR/runtime";
		2823
		2824	# first touch the runtime file to show we are still running:
		2825	# the fsync below can take a very very long time.
		2826
		2827	IO::AIO::aio_utime $runtime, undef, undef;
		2828
		2829	my $guard = cf::lock_acquire "write_runtime";
		2830
		2831	my $fh = aio_open "$runtime~", O_WRONLY \| O_CREAT, 0644
		2832	or return;
		2833
		2834	my $value = $cf::RUNTIME + 90 + 10;
		2835	# 10 is the runtime save interval, for a monotonic clock
		2836	# 60 allows for the watchdog to kill the server.
		2837
		2838	(aio_write $fh, 0, (length $value), $value, 0) <= 0
		2839	and return;
		2840
		2841	# always fsync - this file is important
		2842	aio_fsync $fh
		2843	and return;
		2844
		2845	# touch it again to show we are up-to-date
		2846	aio_utime $fh, undef, undef;
		2847
		2848	close $fh
		2849	or return;
		2850
		2851	aio_rename "$runtime~", $runtime
		2852	and return;
		2853
		2854	warn "runtime file written.\n";
		2855
		2856	1
		2857	}
		2858
2634	sub emergency_save() {	2859	sub emergency_save() {
2635	my $freeze_guard = cf::freeze_mainloop;	2860	my $freeze_guard = cf::freeze_mainloop;
2636		2861
2637	warn "enter emergency perl save\n";	2862	warn "enter emergency perl save\n";
2638		2863
…		…
2713	%EXT_CORO = ();	2938	%EXT_CORO = ();
2714		2939
2715	warn "removing commands";	2940	warn "removing commands";
2716	%COMMAND = ();	2941	%COMMAND = ();
2717		2942
2718	warn "removing ext commands";	2943	warn "removing ext/exti commands";
2719	%EXTCMD = ();	2944	%EXTCMD = ();
		2945	%EXTICMD = ();
2720		2946
2721	warn "unloading/nuking all extensions";	2947	warn "unloading/nuking all extensions";
2722	for my $pkg (@EXTS) {	2948	for my $pkg (@EXTS) {
2723	warn "... unloading $pkg";	2949	warn "... unloading $pkg";
2724		2950

Diff Legend

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

Comparing deliantra/server/lib/cf.pm (file contents): Revision 1.270 by root, Sat May 26 15:44:06 2007 UTC vs. Revision 1.293 by root, Tue Jul 3 05:14:15 2007 UTC

Diff Legend

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.270 by root, Sat May 26 15:44:06 2007 UTC vs.
Revision 1.293 by root, Tue Jul 3 05:14:15 2007 UTC