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

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.224 by root, Mon Mar 12 21:42:12 2007 UTC vs.
Revision 1.253 by root, Wed Apr 18 17:32:07 2007 UTC

…		…
3	use utf8;	3	use utf8;
4	use strict;	4	use strict;
5		5
6	use Symbol;	6	use Symbol;
7	use List::Util;	7	use List::Util;
		8	use Socket;
8	use Storable;	9	use Storable;
9	use Event;	10	use Event;
10	use Opcode;	11	use Opcode;
11	use Safe;	12	use Safe;
12	use Safe::Hole;	13	use Safe::Hole;
13		14
14	use Coro 3.52 ();	15	use Coro 3.61 ();
15	use Coro::State;	16	use Coro::State;
		17	use Coro::Handle;
16	use Coro::Event;	18	use Coro::Event;
17	use Coro::Timer;	19	use Coro::Timer;
18	use Coro::Signal;	20	use Coro::Signal;
19	use Coro::Semaphore;	21	use Coro::Semaphore;
20	use Coro::AIO;	22	use Coro::AIO;
		23	use Coro::Storable;
21		24
22	use BDB ();	25	use BDB ();
23	use Data::Dumper;	26	use Data::Dumper;
24	use Digest::MD5;	27	use Digest::MD5;
25	use Fcntl;	28	use Fcntl;
		29	use YAML::Syck ();
26	use IO::AIO 2.32 ();	30	use IO::AIO 2.32 ();
27	use YAML::Syck ();
28	use Time::HiRes;	31	use Time::HiRes;
29	use Compress::LZF;	32	use Compress::LZF;
30		33
		34	# configure various modules to our taste
		35	#
		36	$Storable::canonical = 1; # reduce rsync transfers
31	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator	37	Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
32	Compress::LZF::sfreeze_cr { }; # prime Compress::LZF so it does not use require later	38	Compress::LZF::sfreeze_cr { }; # prime Compress::LZF so it does not use require later
		39
33	$Event::Eval = 1; # no idea why this is required, but it is	40	$Event::Eval = 1; # no idea why this is required, but it is
34
35	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
36		41
37	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?	42	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
38	$YAML::Syck::ImplicitUnicode = 1;	43	$YAML::Syck::ImplicitUnicode = 1;
39		44
40	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority	45	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
		46
		47	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
41		48
42	our %COMMAND = ();	49	our %COMMAND = ();
43	our %COMMAND_TIME = ();	50	our %COMMAND_TIME = ();
44		51
45	our @EXTS = (); # list of extension package names	52	our @EXTS = (); # list of extension package names
…		…
47	our %EXT_CORO = (); # coroutines bound to extensions	54	our %EXT_CORO = (); # coroutines bound to extensions
48	our %EXT_MAP = (); # pluggable maps	55	our %EXT_MAP = (); # pluggable maps
49		56
50	our $RELOAD; # number of reloads so far	57	our $RELOAD; # number of reloads so far
51	our @EVENT;	58	our @EVENT;
52	our $LIBDIR = datadir . "/ext";
53		59
54	our $TICK = MAX_TIME * 1e-6;	60	our $CONFDIR = confdir;
		61	our $DATADIR = datadir;
		62	our $LIBDIR = "$DATADIR/ext";
		63	our $PODDIR = "$DATADIR/pod";
		64	our $MAPDIR = "$DATADIR/" . mapdir;
		65	our $LOCALDIR = localdir;
		66	our $TMPDIR = "$LOCALDIR/" . tmpdir;
		67	our $UNIQUEDIR = "$LOCALDIR/" . uniquedir;
		68	our $PLAYERDIR = "$LOCALDIR/" . playerdir;
		69	our $RANDOMDIR = "$LOCALDIR/random";
		70	our $BDBDIR = "$LOCALDIR/db";
		71
		72	our $TICK = MAX_TIME * 1e-6; # this is a CONSTANT(!)
55	our $TICK_WATCHER;	73	our $TICK_WATCHER;
56	our $AIO_POLL_WATCHER;	74	our $AIO_POLL_WATCHER;
57	our $NEXT_RUNTIME_WRITE; # when should the runtime file be written	75	our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
58	our $NEXT_TICK;	76	our $NEXT_TICK;
59	our $NOW;	77	our $NOW;
…		…
68	our $RUNTIME;	86	our $RUNTIME;
69		87
70	our %PLAYER; # all users	88	our %PLAYER; # all users
71	our %MAP; # all maps	89	our %MAP; # all maps
72	our $LINK_MAP; # the special {link} map, which is always available	90	our $LINK_MAP; # the special {link} map, which is always available
73	our $RANDOM_MAPS = cf::localdir . "/random";
74	our $BDB_ENV_DIR = cf::localdir . "/db";
75
76	our $WAIT_FOR_TICK; $WAIT_FOR_TICK \|\|= new Coro::Signal;
77	our $WAIT_FOR_TICK_ONE; $WAIT_FOR_TICK_ONE \|\|= new Coro::Signal;
78		91
79	# used to convert map paths into valid unix filenames by replacing / by ∕	92	# used to convert map paths into valid unix filenames by replacing / by ∕
80	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons	93	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
81		94
82	binmode STDOUT;	95	binmode STDOUT;
83	binmode STDERR;	96	binmode STDERR;
84		97
85	# read virtual server time, if available	98	# read virtual server time, if available
86	unless ($RUNTIME \|\| !-e cf::localdir . "/runtime") {	99	unless ($RUNTIME \|\| !-e "$LOCALDIR/runtime") {
87	open my $fh, "<", cf::localdir . "/runtime"	100	open my $fh, "<", "$LOCALDIR/runtime"
88	or die "unable to read runtime file: $!";	101	or die "unable to read runtime file: $!";
89	$RUNTIME = <$fh> + 0.;	102	$RUNTIME = <$fh> + 0.;
90	}	103	}
91		104
92	mkdir cf::localdir;	105	mkdir $_
93	mkdir cf::localdir . "/" . cf::playerdir;	106	for $LOCALDIR, $TMPDIR, $UNIQUEDIR, $PLAYERDIR, $RANDOMDIR, $BDBDIR;
94	mkdir cf::localdir . "/" . cf::tmpdir;
95	mkdir cf::localdir . "/" . cf::uniquedir;
96	mkdir $RANDOM_MAPS;
97	mkdir $BDB_ENV_DIR;
98		107
99	our $EMERGENCY_POSITION;	108	our $EMERGENCY_POSITION;
100		109
101	sub cf::map::normalise;	110	sub cf::map::normalise;
102		111
…		…
113	=item $cf::RUNTIME	122	=item $cf::RUNTIME
114		123
115	The time this server has run, starts at 0 and is increased by $cf::TICK on	124	The time this server has run, starts at 0 and is increased by $cf::TICK on
116	every server tick.	125	every server tick.
117		126
118	=item $cf::LIBDIR	127	=item $cf::CONFDIR $cf::DATADIR $cf::LIBDIR $cf::PODDIR
		128	$cf::MAPDIR $cf::LOCALDIR $cf::TMPDIR $cf::UNIQUEDIR
		129	$cf::PLAYERDIR $cf::RANDOMDIR $cf::BDBDIR
119		130
120	The perl library directory, where extensions and cf-specific modules can	131	Various directories - "/etc", read-only install directory, perl-library
121	be found. It will be added to C<@INC> automatically.	132	directory, pod-directory, read-only maps directory, "/var", "/var/tmp",
		133	unique-items directory, player file directory, random maps directory and
		134	database environment.
122		135
123	=item $cf::NOW	136	=item $cf::NOW
124		137
125	The time of the last (current) server tick.	138	The time of the last (current) server tick.
126		139
…		…
131	=item %cf::CFG	144	=item %cf::CFG
132		145
133	Configuration for the server, loaded from C</etc/crossfire/config>, or	146	Configuration for the server, loaded from C</etc/crossfire/config>, or
134	from wherever your confdir points to.	147	from wherever your confdir points to.
135		148
136	=item $cf::WAIT_FOR_TICK, $cf::WAIT_FOR_TICK_ONE	149	=item cf::wait_for_tick, cf::wait_for_tick_begin
137		150
138	These are Coro::Signal objects that are C<< ->broadcast >> (WAIT_FOR_TICK)	151	These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only
139	or C<< ->send >> (WAIT_FOR_TICK_ONE) on after normal server tick	152	returns directly I<after> the tick processing (and consequently, can only wake one process
140	processing has been done. Call C<< ->wait >> on them to maximise the	153	per tick), while cf::wait_for_tick wakes up all waiters after tick processing.
141	window of cpu time available, or simply to synchronise to the server tick.
142		154
143	=back	155	=back
144		156
145	=cut	157	=cut
146		158
147	BEGIN {	159	BEGIN {
148	*CORE::GLOBAL::warn = sub {	160	*CORE::GLOBAL::warn = sub {
149	my $msg = join "", @_;	161	my $msg = join "", @_;
150	utf8::encode $msg;
151		162
152	$msg .= "\n"	163	$msg .= "\n"
153	unless $msg =~ /\n$/;	164	unless $msg =~ /\n$/;
154		165
		166	$msg =~ s/([\x00-\x09\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
		167
		168	utf8::encode $msg;
155	LOG llevError, $msg;	169	LOG llevError, $msg;
156	};	170	};
157	}	171	}
158		172
159	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';	173	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
…		…
205	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;	219	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
206	$d	220	$d
207	} \|\| "[unable to dump $_[0]: '$@']";	221	} \|\| "[unable to dump $_[0]: '$@']";
208	}	222	}
209		223
210	use JSON::Syck (); # TODO# replace by JSON::PC once working	224	use JSON::XS qw(to_json from_json); # TODO# replace by JSON::PC once working
211		225
212	=item $ref = cf::from_json $json	226	=item $ref = cf::from_json $json
213		227
214	Converts a JSON string into the corresponding perl data structure.	228	Converts a JSON string into the corresponding perl data structure.
215		229
216	=cut
217
218	sub from_json($) {
219	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
220	JSON::Syck::Load $_[0]
221	}
222
223	=item $json = cf::to_json $ref	230	=item $json = cf::to_json $ref
224		231
225	Converts a perl data structure into its JSON representation.	232	Converts a perl data structure into its JSON representation.
226
227	=cut
228
229	sub to_json($) {
230	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
231	JSON::Syck::Dump $_[0]
232	}
233		233
234	=item cf::lock_wait $string	234	=item cf::lock_wait $string
235		235
236	Wait until the given lock is available. See cf::lock_acquire.	236	Wait until the given lock is available. See cf::lock_acquire.
237		237
…		…
243	returned.	243	returned.
244		244
245	Lock names should begin with a unique identifier (for example, cf::map::find	245	Lock names should begin with a unique identifier (for example, cf::map::find
246	uses map_find and cf::map::load uses map_load).	246	uses map_find and cf::map::load uses map_load).
247		247
		248	=item $locked = cf::lock_active $string
		249
		250	Return true if the lock is currently active, i.e. somebody has locked it.
		251
248	=cut	252	=cut
249		253
250	our %LOCK;	254	our %LOCK;
251		255
252	sub lock_wait($) {	256	sub lock_wait($) {
…		…
269		273
270	Coro::guard {	274	Coro::guard {
271	# wake up all waiters, to be on the safe side	275	# wake up all waiters, to be on the safe side
272	$_->ready for @{ delete $LOCK{$key} };	276	$_->ready for @{ delete $LOCK{$key} };
273	}	277	}
		278	}
		279
		280	sub lock_active($) {
		281	my ($key) = @_;
		282
		283	! ! $LOCK{$key}
274	}	284	}
275		285
276	sub freeze_mainloop {	286	sub freeze_mainloop {
277	return unless $TICK_WATCHER->is_active;	287	return unless $TICK_WATCHER->is_active;
278		288
…		…
359	}	369	}
360		370
361	sub write_runtime {	371	sub write_runtime {
362	my $guard = cf::lock_acquire "write_runtime";	372	my $guard = cf::lock_acquire "write_runtime";
363		373
364	my $runtime = cf::localdir . "/runtime";	374	my $runtime = "$LOCALDIR/runtime";
365		375
366	my $fh = aio_open "$runtime~", O_WRONLY \| O_CREAT, 0644	376	my $fh = aio_open "$runtime~", O_WRONLY \| O_CREAT, 0644
367	or return;	377	or return;
368		378
369	my $value = $cf::RUNTIME + 90 + 10;	379	my $value = $cf::RUNTIME + 90 + 10;
…		…
382		392
383	aio_rename "$runtime~", $runtime	393	aio_rename "$runtime~", $runtime
384	and return;	394	and return;
385		395
386	1	396	1
		397	}
		398
		399	=item cf::datalog type => key => value, ...
		400
		401	Log a datalog packet of the given type with the given key-value pairs.
		402
		403	=cut
		404
		405	sub datalog($@) {
		406	my ($type, %kv) = @_;
		407	warn "DATALOG ", JSON::XS->new->ascii->encode ({ %kv, type => $type });
387	}	408	}
388		409
389	=back	410	=back
390		411
391	=cut	412	=cut
…		…
953	Returns the given player object, loading it if necessary (might block).	974	Returns the given player object, loading it if necessary (might block).
954		975
955	=cut	976	=cut
956		977
957	sub playerdir($) {	978	sub playerdir($) {
958	cf::localdir	979	"$PLAYERDIR/"
959	. "/"
960	. cf::playerdir
961	. "/"
962	. (ref $_[0] ? $_[0]->ob->name : $_[0])	980	. (ref $_[0] ? $_[0]->ob->name : $_[0])
963	}	981	}
964		982
965	sub path($) {	983	sub path($) {
966	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];	984	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
967		985
968	(playerdir $login) . "/$login.pl"	986	(playerdir $login) . "/playerdata"
969	}	987	}
970		988
971	sub find_active($) {	989	sub find_active($) {
972	$cf::PLAYER{$_[0]}	990	$cf::PLAYER{$_[0]}
973	and $cf::PLAYER{$_[0]}->active	991	and $cf::PLAYER{$_[0]}->active
…		…
986	my $login = $_[0];	1004	my $login = $_[0];
987		1005
988	my $guard = cf::lock_acquire "user_find:$login";	1006	my $guard = cf::lock_acquire "user_find:$login";
989		1007
990	$cf::PLAYER{$_[0]} \|\| do {	1008	$cf::PLAYER{$_[0]} \|\| do {
		1009	# rename old playerfiles to new ones
		1010	#TODO: remove when no longer required
		1011	aio_link +(playerdir $login) . "/$login.pl.pst", (playerdir $login) . "/playerdata.pst";
		1012	aio_link +(playerdir $login) . "/$login.pl" , (playerdir $login) . "/playerdata";
		1013	aio_unlink +(playerdir $login) . "/$login.pl.pst";
		1014	aio_unlink +(playerdir $login) . "/$login.pl";
		1015
991	my $pl = load_pl path $login	1016	my $pl = load_pl path $login
992	or return;	1017	or return;
993	$cf::PLAYER{$login} = $pl	1018	$cf::PLAYER{$login} = $pl
994	}	1019	}
995	}	1020	}
…		…
1079	while and may block, so not sync_job-capable, ever.	1104	while and may block, so not sync_job-capable, ever.
1080		1105
1081	=cut	1106	=cut
1082		1107
1083	sub list_logins {	1108	sub list_logins {
1084	my $dirs = aio_readdir cf::localdir . "/" . cf::playerdir	1109	my $dirs = aio_readdir $PLAYERDIR
1085	or return [];	1110	or return [];
1086		1111
1087	my @logins;	1112	my @logins;
1088		1113
1089	for my $login (@$dirs) {	1114	for my $login (@$dirs) {
…		…
1124	}	1149	}
1125		1150
1126	\@paths	1151	\@paths
1127	}	1152	}
1128		1153
1129	=item $player->ext_reply ($msgid, $msgtype, %msg)	1154	=item $player->ext_reply ($msgid, %msg)
1130		1155
1131	Sends an ext reply to the player.	1156	Sends an ext reply to the player.
1132		1157
1133	=cut	1158	=cut
1134		1159
1135	sub ext_reply($$$%) {	1160	sub ext_reply($$%) {
1136	my ($self, $id, %msg) = @_;	1161	my ($self, $id, %msg) = @_;
1137		1162
1138	$msg{msgid} = $id;	1163	$msg{msgid} = $id;
1139		1164
1140	$self->send ("ext " . cf::to_json \%msg);	1165	$self->send ("ext " . cf::to_json \%msg);
1141	}	1166	}
1142		1167
1143	package cf;	1168	=item $player->ext_event ($type, %msg)
		1169
		1170	Sends an ext event to the client.
		1171
		1172	=cut
		1173
		1174	sub ext_event($$%) {
		1175	my ($self, $type, %msg) = @_;
		1176
		1177	$self->ns->ext_event ($type, %msg);
		1178	}
		1179
		1180	=head3 cf::region
		1181
		1182	=over 4
		1183
		1184	=cut
		1185
		1186	package cf::region;
		1187
		1188	=item cf::region::find_by_path $path
		1189
		1190	Tries to decuce the probable region for a map knowing only its path.
		1191
		1192	=cut
		1193
		1194	sub find_by_path($) {
		1195	my ($path) = @_;
		1196
		1197	my ($match, $specificity);
		1198
		1199	for my $region (list) {
		1200	if ($region->match && $path =~ $region->match) {
		1201	($match, $specificity) = ($region, $region->specificity)
		1202	if $region->specificity > $specificity;
		1203	}
		1204	}
		1205
		1206	$match
		1207	}
1144		1208
1145	=back	1209	=back
1146
1147		1210
1148	=head3 cf::map	1211	=head3 cf::map
1149		1212
1150	=over 4	1213	=over 4
1151		1214
…		…
1289		1352
1290	# the original (read-only) location	1353	# the original (read-only) location
1291	sub load_path {	1354	sub load_path {
1292	my ($self) = @_;	1355	my ($self) = @_;
1293		1356
1294	sprintf "%s/%s/%s.map", cf::datadir, cf::mapdir, $self->{path}	1357	"$MAPDIR($self->{path}"
1295	}	1358	}
1296		1359
1297	# the temporary/swap location	1360	# the temporary/swap location
1298	sub save_path {	1361	sub save_path {
1299	my ($self) = @_;	1362	my ($self) = @_;
1300		1363
1301	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;	1364	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1302	sprintf "%s/%s/%s.map", cf::localdir, cf::tmpdir, $path	1365	"$TMPDIR/$path"
1303	}	1366	}
1304		1367
1305	# the unique path, undef == no special unique path	1368	# the unique path, undef == no special unique path
1306	sub uniq_path {	1369	sub uniq_path {
1307	my ($self) = @_;	1370	my ($self) = @_;
1308		1371
1309	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;	1372	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1310	sprintf "%s/%s/%s", cf::localdir, cf::uniquedir, $path	1373	"$UNIQUEDIR/$path"
1311	}	1374	}
1312		1375
1313	# and all this just because we cannot iterate over	1376	# and all this just because we cannot iterate over
1314	# all maps in C++...	1377	# all maps in C++...
1315	sub change_all_map_light {	1378	sub change_all_map_light {
…		…
1382	$self->load_header_orig	1445	$self->load_header_orig
1383	or return;	1446	or return;
1384	$self->prepare_orig;	1447	$self->prepare_orig;
1385	}	1448	}
1386		1449
		1450	$self->default_region (cf::region::find_by_path $self->{path})
		1451	unless $self->default_region;
		1452
1387	1	1453	1
1388	}	1454	}
1389		1455
1390	sub find;	1456	sub find;
1391	sub find {	1457	sub find {
…		…
1433	$self->in_memory (cf::MAP_LOADING);	1499	$self->in_memory (cf::MAP_LOADING);
1434		1500
1435	$self->alloc;	1501	$self->alloc;
1436		1502
1437	$self->pre_load;	1503	$self->pre_load;
		1504	Coro::cede;
1438		1505
1439	$self->_load_objects ($self->{load_path}, 1)	1506	$self->_load_objects ($self->{load_path}, 1)
1440	or return;	1507	or return;
1441		1508
1442	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)	1509	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
…		…
1449	$self->_load_objects ($uniq, 0);	1516	$self->_load_objects ($uniq, 0);
1450	}	1517	}
1451	}	1518	}
1452		1519
1453	Coro::cede;	1520	Coro::cede;
1454
1455	# now do the right thing for maps	1521	# now do the right thing for maps
1456	$self->link_multipart_objects;	1522	$self->link_multipart_objects;
		1523	Coro::cede;
1457		1524
1458	unless ($self->{deny_activate}) {	1525	unless ($self->{deny_activate}) {
1459	$self->decay_objects;	1526	$self->decay_objects;
1460	$self->fix_auto_apply;	1527	$self->fix_auto_apply;
1461	$self->update_buttons;	1528	$self->update_buttons;
…		…
1463	$self->set_darkness_map;	1530	$self->set_darkness_map;
1464	$self->difficulty ($self->estimate_difficulty)	1531	$self->difficulty ($self->estimate_difficulty)
1465	unless $self->difficulty;	1532	unless $self->difficulty;
1466	Coro::cede;	1533	Coro::cede;
1467	$self->activate;	1534	$self->activate;
		1535	Coro::cede;
1468	}	1536	}
1469		1537
1470	$self->post_load;	1538	$self->post_load;
		1539	Coro::cede;
1471		1540
1472	$self->in_memory (cf::MAP_IN_MEMORY);	1541	$self->in_memory (cf::MAP_IN_MEMORY);
1473	}	1542	}
1474		1543
1475	sub customise_for {	1544	sub customise_for {
…		…
1668	instantiated unique items. May block.	1737	instantiated unique items. May block.
1669		1738
1670	=cut	1739	=cut
1671		1740
1672	sub unique_maps() {	1741	sub unique_maps() {
1673	my $files = aio_readdir cf::localdir . "/" . cf::uniquedir	1742	my $files = aio_readdir $UNIQUEDIR
1674	or return;	1743	or return;
1675		1744
1676	my @paths;	1745	my @paths;
1677		1746
1678	for (@$files) {	1747	for (@$files) {
…		…
1934		2003
1935	$rmp->{random_seed} \|\|= $exit->random_seed;	2004	$rmp->{random_seed} \|\|= $exit->random_seed;
1936		2005
1937	my $data = cf::to_json $rmp;	2006	my $data = cf::to_json $rmp;
1938	my $md5 = Digest::MD5::md5_hex $data;	2007	my $md5 = Digest::MD5::md5_hex $data;
1939	my $meta = "$cf::RANDOM_MAPS/$md5.meta";	2008	my $meta = "$RANDOMDIR/$md5.meta";
1940		2009
1941	if (my $fh = aio_open "$meta~", O_WRONLY \| O_CREAT, 0666) {	2010	if (my $fh = aio_open "$meta~", O_WRONLY \| O_CREAT, 0666) {
1942	aio_write $fh, 0, (length $data), $data, 0;	2011	aio_write $fh, 0, (length $data), $data, 0;
1943	undef $fh;	2012	undef $fh;
1944	aio_rename "$meta~", $meta;	2013	aio_rename "$meta~", $meta;
…		…
1953		2022
1954	return unless $self->type == cf::PLAYER;	2023	return unless $self->type == cf::PLAYER;
1955		2024
1956	if ($exit->slaying eq "/!") {	2025	if ($exit->slaying eq "/!") {
1957	#TODO: this should de-fi-ni-te-ly not be a sync-job	2026	#TODO: this should de-fi-ni-te-ly not be a sync-job
		2027	# the problem is that $exit might not survive long enough
		2028	# so it needs to be done right now, right here
1958	cf::sync_job { prepare_random_map $exit };	2029	cf::sync_job { prepare_random_map $exit };
1959	}	2030	}
1960		2031
1961	my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;	2032	my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;
1962	my $hp = $exit->stats->hp;	2033	my $hp = $exit->stats->hp;
…		…
1970	$self->goto ($slaying, $hp, $sp);	2041	$self->goto ($slaying, $hp, $sp);
1971		2042
1972	1;	2043	1;
1973	}) {	2044	}) {
1974	$self->message ("Something went wrong deep within the crossfire server. "	2045	$self->message ("Something went wrong deep within the crossfire server. "
1975	. "I'll try to bring you back to the map you were before. "	2046	. "I'll try to bring you back to the map you were before. "
1976	. "Please report this to the dungeon master!",	2047	. "Please report this to the dungeon master!",
1977	cf::NDI_UNIQUE \| cf::NDI_RED);	2048	cf::NDI_UNIQUE \| cf::NDI_RED);
1978		2049
1979	warn "ERROR in enter_exit: $@";	2050	warn "ERROR in enter_exit: $@";
1980	$self->leave_link;	2051	$self->leave_link;
1981	}	2052	}
1982	})->prio (1);	2053	})->prio (1);
…		…
1995		2066
1996	sub cf::client::send_drawinfo {	2067	sub cf::client::send_drawinfo {
1997	my ($self, $text, $flags) = @_;	2068	my ($self, $text, $flags) = @_;
1998		2069
1999	utf8::encode $text;	2070	utf8::encode $text;
2000	$self->send_packet (sprintf "drawinfo %d %s", $flags, $text);	2071	$self->send_packet (sprintf "drawinfo %d %s", $flags \|\| cf::NDI_BLACK, $text);
2001	}	2072	}
2002		2073
		2074	=item $client->ext_event ($type, %msg)
		2075
		2076	Sends an exti event to the client.
		2077
		2078	=cut
		2079
		2080	sub cf::client::ext_event($$%) {
		2081	my ($self, $type, %msg) = @_;
		2082
		2083	$msg{msgtype} = "event_$type";
		2084	$self->send_packet ("ext " . cf::to_json \%msg);
		2085	}
2003		2086
2004	=item $success = $client->query ($flags, "text", \&cb)	2087	=item $success = $client->query ($flags, "text", \&cb)
2005		2088
2006	Queues a query to the client, calling the given callback with	2089	Queues a query to the client, calling the given callback with
2007	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,	2090	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
…		…
2104		2187
2105	# here we export the classes and methods available to script code	2188	# here we export the classes and methods available to script code
2106		2189
2107	=pod	2190	=pod
2108		2191
2109	The following fucntions and emthods are available within a safe environment:	2192	The following functions and methods are available within a safe environment:
2110		2193
2111	cf::object contr pay_amount pay_player map	2194	cf::object contr pay_amount pay_player map
2112	cf::object::player player	2195	cf::object::player player
2113	cf::player peaceful	2196	cf::player peaceful
2114	cf::map trigger	2197	cf::map trigger
…		…
2199	#############################################################################	2282	#############################################################################
2200		2283
2201	=head2 EXTENSION DATABASE SUPPORT	2284	=head2 EXTENSION DATABASE SUPPORT
2202		2285
2203	Crossfire maintains a very simple database for extension use. It can	2286	Crossfire maintains a very simple database for extension use. It can
2204	currently store anything that can be serialised using Storable, which	2287	currently store binary data only (use Compress::LZF::sfreeze_cr/sthaw to
2205	excludes objects.	2288	convert to/from binary).
2206		2289
2207	The parameter C<$family> should best start with the name of the extension	2290	The parameter C<$family> should best start with the name of the extension
2208	using it, it should be unique.	2291	using it, it should be unique.
2209		2292
2210	=over 4	2293	=over 4
…		…
2233	BDB::CREATE \| BDB::AUTO_COMMIT, 0666;	2316	BDB::CREATE \| BDB::AUTO_COMMIT, 0666;
2234	cf::cleanup "db_open(db): $!" if $!;	2317	cf::cleanup "db_open(db): $!" if $!;
2235	};	2318	};
2236	cf::cleanup "db_open(db): $@" if $@;	2319	cf::cleanup "db_open(db): $@" if $@;
2237	};	2320	};
2238
2239	my $path = cf::localdir . "/database.pst";
2240	if (stat $path) {
2241	cf::sync_job {
2242	my $pst = Storable::retrieve $path;
2243
2244	cf::db_put (board => data => $pst->{board});
2245	cf::db_put (guildrules => data => $pst->{guildrules});
2246	cf::db_put (rent => balance => $pst->{rent}{balance});
2247	BDB::db_env_txn_checkpoint $DB_ENV;
2248
2249	unlink $path;
2250	};
2251	}
2252	}	2321	}
2253	}	2322	}
2254		2323
2255	sub db_get($$) {	2324	sub db_get($$) {
2256	my $key = "$_[0]/$_[1]";	2325	my $key = "$_[0]/$_[1]";
2257		2326
2258	cf::sync_job {	2327	cf::sync_job {
2259	BDB::db_get $DB, undef, $key, my $data;	2328	BDB::db_get $DB, undef, $key, my $data;
2260		2329
2261	$! ? ()	2330	$! ? ()
2262	: Compress::LZF::sthaw $data	2331	: $data
2263	}	2332	}
2264	}	2333	}
2265		2334
2266	sub db_put($$$) {	2335	sub db_put($$$) {
2267	BDB::dbreq_pri 4;	2336	BDB::dbreq_pri 4;
2268	BDB::db_put $DB, undef, "$_[0]/$_[1]", Compress::LZF::sfreeze_cr $_[2], 0, sub { };	2337	BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
2269	}	2338	}
		2339
		2340	=item cf::cache $id => [$paths...], $processversion => $process
		2341
		2342	Generic caching function that returns the value of the resource $id,
		2343	caching and regenerating as required.
		2344
		2345	This function can block.
		2346
		2347	=cut
		2348
		2349	sub cache {
		2350	my ($id, $src, $processversion, $process) = @_;
		2351
		2352	my $meta =
		2353	join "\x00",
		2354	$processversion,
		2355	map {
		2356	aio_stat $_
		2357	and Carp::croak "$_: $!";
		2358
		2359	($_, (stat _)[7,9])
		2360	} @$src;
		2361
		2362	my $dbmeta = db_get cache => "$id/meta";
		2363	if ($dbmeta ne $meta) {
		2364	# changed, we may need to process
		2365
		2366	my @data;
		2367	my $md5;
		2368
		2369	for (0 .. $#$src) {
		2370	0 <= aio_load $src->[$_], $data[$_]
		2371	or Carp::croak "$src->[$_]: $!";
		2372	}
		2373
		2374	# if processing is expensive, check
		2375	# checksum first
		2376	if (1) {
		2377	$md5 =
		2378	join "\x00",
		2379	$processversion,
		2380	map {
		2381	Coro::cede;
		2382	($src->[$_], Digest::MD5::md5_hex $data[$_])
		2383	} 0.. $#$src;
		2384
		2385
		2386	my $dbmd5 = db_get cache => "$id/md5";
		2387	if ($dbmd5 eq $md5) {
		2388	db_put cache => "$id/meta", $meta;
		2389
		2390	return db_get cache => "$id/data";
		2391	}
		2392	}
		2393
		2394	my $t1 = Time::HiRes::time;
		2395	my $data = $process->(\@data);
		2396	my $t2 = Time::HiRes::time;
		2397
		2398	warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
		2399
		2400	db_put cache => "$id/data", $data;
		2401	db_put cache => "$id/md5" , $md5;
		2402	db_put cache => "$id/meta", $meta;
		2403
		2404	return $data;
		2405	}
		2406
		2407	db_get cache => "$id/data"
		2408	}
		2409
		2410	=item fork_call { }, $args
		2411
		2412	Executes the given code block with the given arguments in a seperate
		2413	process, returning the results. Everything must be serialisable with
		2414	Coro::Storable. May, of course, block. Note that the executed sub may
		2415	never block itself or use any form of Event handling.
		2416
		2417	=cut
		2418
		2419	sub fork_call(&@) {
		2420	my ($cb, @args) = @_;
		2421
		2422	# socketpair my $fh1, my $fh2, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC
		2423	# or die "socketpair: $!";
		2424	pipe my $fh1, my $fh2
		2425	or die "pipe: $!";
		2426
		2427	if (my $pid = fork) {
		2428	close $fh2;
		2429
		2430	my $res = (Coro::Handle::unblock $fh1)->readline (undef);
		2431	$res = Coro::Storable::thaw $res;
		2432
		2433	waitpid $pid, 0; # should not block anymore, we expect the child to simply behave
		2434
		2435	die $$res unless "ARRAY" eq ref $res;
		2436
		2437	return wantarray ? @$res : $res->[-1];
		2438	} else {
		2439	local $SIG{__WARN__};
		2440	eval {
		2441	local $SIG{__DIE__};
		2442	close $fh1;
		2443
		2444	my @res = eval { $cb->(@args) };
		2445	syswrite $fh2, Coro::Storable::freeze +($@ ? \"$@" : \@res);
		2446	};
		2447
		2448	warn $@ if $@;
		2449	_exit 0;
		2450	}
		2451	}
		2452
		2453
2270		2454
2271	#############################################################################	2455	#############################################################################
2272	# the server's init and main functions	2456	# the server's init and main functions
2273		2457
2274	sub load_faces {	2458	sub load_facedata($) {
2275	my $path = sprintf "%s/faces", cf::datadir;	2459	my ($path) = @_;
2276		2460
2277	warn "loading faces from $path\n";	2461	warn "loading facedata from $path\n";
2278		2462
2279	my $faces;	2463	my $facedata;
2280	0 < aio_load $path, $faces	2464	0 < aio_load $path, $facedata
2281	or die "$path: $!";	2465	or die "$path: $!";
2282		2466
2283	Coro::cede;
2284	$faces = Storable::thaw $faces;	2467	$facedata = Coro::Storable::thaw $facedata;
2285	Coro::cede;
2286		2468
		2469	$facedata->{version} == 2
		2470	or cf::cleanup "$path: version mismatch, cannot proceed.";
		2471
		2472	{
		2473	my $faces = $facedata->{faceinfo};
		2474
2287	while (my ($face, $info) = each %$faces) {	2475	while (my ($face, $info) = each %$faces) {
2288	my $idx = (cf::face::find $face) \|\| cf::face::alloc $face;	2476	my $idx = (cf::face::find $face) \|\| cf::face::alloc $face;
2289	cf::face::set $idx, $info->{visibility}, $info->{magicmap};	2477	cf::face::set $idx, $info->{visibility}, $info->{magicmap};
2290	cf::face::set_data $idx, 0, $info->{data32}, $info->{chksum32};	2478	cf::face::set_data $idx, 0, $info->{data32}, $info->{chksum32};
		2479	cf::face::set_data $idx, 1, $info->{data64}, $info->{chksum64};
2291	Coro::cede;	2480	Coro::cede;
		2481	}
		2482
		2483	while (my ($face, $info) = each %$faces) {
		2484	next unless $info->{smooth};
		2485	my $idx = cf::face::find $face
		2486	or next;
		2487	if (my $smooth = cf::face::find $info->{smooth}) {
		2488	cf::face::set_smooth $idx, $smooth, $info->{smoothlevel};
		2489	} else {
		2490	warn "smooth face '$info->{smooth}' not found for face '$face'";
		2491	}
		2492	Coro::cede;
		2493	}
		2494	}
		2495
		2496	{
		2497	my $anims = $facedata->{animinfo};
		2498
		2499	while (my ($anim, $info) = each %$anims) {
		2500	cf::anim::set $anim, $info->{frames}, $info->{facings};
		2501	Coro::cede;
		2502	}
		2503
		2504	cf::anim::invalidate_all; # d'oh
2292	}	2505	}
2293		2506
2294	1	2507	1
2295	}	2508	}
2296		2509
		2510	sub reload_regions {
		2511	load_resource_file "$MAPDIR/regions"
		2512	or die "unable to load regions file\n";
		2513	}
		2514
		2515	sub reload_facedata {
		2516	load_facedata "$DATADIR/facedata"
		2517	or die "unable to load facedata\n";
		2518	}
		2519
		2520	sub reload_archetypes {
		2521	load_resource_file "$DATADIR/archetypes"
		2522	or die "unable to load archetypes\n";
		2523	}
		2524
		2525	sub reload_treasures {
		2526	load_resource_file "$DATADIR/treasures"
		2527	or die "unable to load treasurelists\n";
		2528	}
		2529
2297	sub reload_resources {	2530	sub reload_resources {
2298	load_resource_file sprintf "%s/%s/regions", cf::datadir, cf::mapdir	2531	warn "reloading resource files...\n";
2299	or die "unable to load regions file\n";#d#	2532
		2533	reload_regions;
2300	load_faces	2534	reload_facedata;
2301	or die "unable to load faces\n";#d#	2535	reload_archetypes;
		2536	reload_treasures;
		2537
		2538	warn "finished reloading resource files\n";
2302	}	2539	}
2303		2540
2304	sub init {	2541	sub init {
2305	reload_resources;	2542	reload_resources;
2306	}	2543	}
2307		2544
2308	sub cfg_load {	2545	sub cfg_load {
2309	open my $fh, "<:utf8", cf::confdir . "/config"	2546	open my $fh, "<:utf8", "$CONFDIR/config"
2310	or return;	2547	or return;
2311		2548
2312	local $/;	2549	local $/;
2313	*CFG = YAML::Syck::Load <$fh>;	2550	*CFG = YAML::Syck::Load <$fh>;
2314		2551
…		…
2399		2636
2400	warn Carp::longmess "post_cleanup backtrace"	2637	warn Carp::longmess "post_cleanup backtrace"
2401	if $make_core;	2638	if $make_core;
2402	}	2639	}
2403		2640
2404	sub reload() {	2641	sub do_reload_perl() {
2405	# can/must only be called in main	2642	# can/must only be called in main
2406	if ($Coro::current != $Coro::main) {	2643	if ($Coro::current != $Coro::main) {
2407	warn "can only reload from main coroutine";	2644	warn "can only reload from main coroutine";
2408	return;	2645	return;
2409	}	2646	}
…		…
2484	Symbol::delete_package "safe::$_"	2721	Symbol::delete_package "safe::$_"
2485	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);	2722	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
2486		2723
2487	warn "unloading cf.pm \"a bit\"";	2724	warn "unloading cf.pm \"a bit\"";
2488	delete $INC{"cf.pm"};	2725	delete $INC{"cf.pm"};
		2726	delete $INC{"cf/pod.pm"};
2489		2727
2490	# don't, removes xs symbols, too,	2728	# don't, removes xs symbols, too,
2491	# and global variables created in xs	2729	# and global variables created in xs
2492	#Symbol::delete_package __PACKAGE__;	2730	#Symbol::delete_package __PACKAGE__;
2493		2731
…		…
2508	warn "reattaching attachments to maps";	2746	warn "reattaching attachments to maps";
2509	reattach $_ for values %MAP;	2747	reattach $_ for values %MAP;
2510	warn "reattaching attachments to players";	2748	warn "reattaching attachments to players";
2511	reattach $_ for values %PLAYER;	2749	reattach $_ for values %PLAYER;
2512		2750
2513	warn "loading reloadable resources";
2514	reload_resources;
2515
2516	warn "leaving sync_job";	2751	warn "leaving sync_job";
2517		2752
2518	1	2753	1
2519	} or do {	2754	} or do {
2520	warn $@;	2755	warn $@;
…		…
2525	warn "reloaded";	2760	warn "reloaded";
2526	};	2761	};
2527		2762
2528	our $RELOAD_WATCHER; # used only during reload	2763	our $RELOAD_WATCHER; # used only during reload
2529		2764
		2765	sub reload_perl() {
		2766	# doing reload synchronously and two reloads happen back-to-back,
		2767	# coro crashes during coro_state_free->destroy here.
		2768
		2769	$RELOAD_WATCHER \|\|= Event->timer (
		2770	reentrant => 0,
		2771	after => 0,
		2772	data => WF_AUTOCANCEL,
		2773	cb => sub {
		2774	do_reload_perl;
		2775	undef $RELOAD_WATCHER;
		2776	},
		2777	);
		2778	}
		2779
2530	register_command "reload" => sub {	2780	register_command "reload" => sub {
2531	my ($who, $arg) = @_;	2781	my ($who, $arg) = @_;
2532		2782
2533	if ($who->flag (FLAG_WIZ)) {	2783	if ($who->flag (FLAG_WIZ)) {
2534	$who->message ("reloading server.");	2784	$who->message ("reloading server.");
2535		2785	async { reload_perl };
2536	# doing reload synchronously and two reloads happen back-to-back,
2537	# coro crashes during coro_state_free->destroy here.
2538
2539	$RELOAD_WATCHER \|\|= Event->timer (
2540	reentrant => 0,
2541	after => 0,
2542	data => WF_AUTOCANCEL,
2543	cb => sub {
2544	reload;
2545	undef $RELOAD_WATCHER;
2546	},
2547	);
2548	}	2786	}
2549	};	2787	};
2550		2788
2551	unshift @INC, $LIBDIR;	2789	unshift @INC, $LIBDIR;
2552		2790
2553	my $bug_warning = 0;	2791	my $bug_warning = 0;
		2792
		2793	our @WAIT_FOR_TICK;
		2794	our @WAIT_FOR_TICK_BEGIN;
		2795
		2796	sub wait_for_tick {
		2797	return unless $TICK_WATCHER->is_active;
		2798	return if $Coro::current == $Coro::main;
		2799
		2800	my $signal = new Coro::Signal;
		2801	push @WAIT_FOR_TICK, $signal;
		2802	$signal->wait;
		2803	}
		2804
		2805	sub wait_for_tick_begin {
		2806	return unless $TICK_WATCHER->is_active;
		2807	return if $Coro::current == $Coro::main;
		2808
		2809	my $signal = new Coro::Signal;
		2810	push @WAIT_FOR_TICK_BEGIN, $signal;
		2811	$signal->wait;
		2812	}
2554		2813
2555	$TICK_WATCHER = Event->timer (	2814	$TICK_WATCHER = Event->timer (
2556	reentrant => 0,	2815	reentrant => 0,
2557	parked => 1,	2816	parked => 1,
2558	prio => 0,	2817	prio => 0,
…		…
2566	}	2825	}
2567		2826
2568	$NOW = Event::time;	2827	$NOW = Event::time;
2569		2828
2570	cf::server_tick; # one server iteration	2829	cf::server_tick; # one server iteration
		2830
2571	$RUNTIME += $TICK;	2831	$RUNTIME += $TICK;
2572	$NEXT_TICK += $TICK;	2832	$NEXT_TICK += $TICK;
2573		2833
2574	if ($NOW >= $NEXT_RUNTIME_WRITE) {	2834	if ($NOW >= $NEXT_RUNTIME_WRITE) {
2575	$NEXT_RUNTIME_WRITE = $NOW + 10;	2835	$NEXT_RUNTIME_WRITE = $NOW + 10;
…		…
2577	write_runtime	2837	write_runtime
2578	or warn "ERROR: unable to write runtime file: $!";	2838	or warn "ERROR: unable to write runtime file: $!";
2579	};	2839	};
2580	}	2840	}
2581		2841
2582	$WAIT_FOR_TICK->broadcast;
2583	$WAIT_FOR_TICK_ONE->send if $WAIT_FOR_TICK_ONE->awaited;
2584
2585	# my $AFTER = Event::time;	2842	# my $AFTER = Event::time;
2586	# warn $AFTER - $NOW;#d#	2843	# warn $AFTER - $NOW;#d#
2587		2844
2588	# if we are delayed by four ticks or more, skip them all	2845	# if we are delayed by four ticks or more, skip them all
2589	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;	2846	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;
2590		2847
2591	$TICK_WATCHER->at ($NEXT_TICK);	2848	$TICK_WATCHER->at ($NEXT_TICK);
2592	$TICK_WATCHER->start;	2849	$TICK_WATCHER->start;
		2850
		2851	if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
		2852	$sig->send;
		2853	}
		2854	while (my $sig = shift @WAIT_FOR_TICK) {
		2855	$sig->send;
		2856	}
		2857
		2858	_post_tick;
2593	},	2859	},
2594	);	2860	);
2595		2861
2596	{	2862	{
2597	BDB::max_poll_time $TICK * 0.1;	2863	BDB::max_poll_time $TICK * 0.1;
…		…
2625		2891
2626	cf::sync_job {	2892	cf::sync_job {
2627	eval {	2893	eval {
2628	BDB::db_env_open	2894	BDB::db_env_open
2629	$DB_ENV,	2895	$DB_ENV,
2630	$BDB_ENV_DIR,	2896	$BDBDIR,
2631	BDB::INIT_LOCK \| BDB::INIT_LOG \| BDB::INIT_MPOOL \| BDB::INIT_TXN	2897	BDB::INIT_LOCK \| BDB::INIT_LOG \| BDB::INIT_MPOOL \| BDB::INIT_TXN
2632	\| BDB::RECOVER \| BDB::REGISTER \| BDB::USE_ENVIRON \| BDB::CREATE,	2898	\| BDB::RECOVER \| BDB::REGISTER \| BDB::USE_ENVIRON \| BDB::CREATE,
2633	0666;	2899	0666;
2634		2900
2635	cf::cleanup "db_env_open($BDB_ENV_DIR): $!" if $!;	2901	cf::cleanup "db_env_open($BDBDIR): $!" if $!;
2636		2902
2637	$DB_ENV->set_flags (BDB::AUTO_COMMIT \| BDB::REGION_INIT \| BDB::TXN_NOSYNC, 1);	2903	$DB_ENV->set_flags (BDB::AUTO_COMMIT \| BDB::REGION_INIT \| BDB::TXN_NOSYNC, 1);
2638	$DB_ENV->set_lk_detect;	2904	$DB_ENV->set_lk_detect;
2639	};	2905	};
2640		2906
…		…
2656	prio => 6,	2922	prio => 6,
2657	cb => \&IO::AIO::poll_cb,	2923	cb => \&IO::AIO::poll_cb,
2658	);	2924	);
2659	}	2925	}
2660		2926
		2927	# load additional modules
		2928	use cf::pod;
		2929
2661	END { cf::emergency_save }	2930	END { cf::emergency_save }
2662		2931
2663	1	2932	1
2664		2933

Diff Legend

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

Comparing deliantra/server/lib/cf.pm (file contents): Revision 1.224 by root, Mon Mar 12 21:42:12 2007 UTC vs. Revision 1.253 by root, Wed Apr 18 17:32:07 2007 UTC

Diff Legend

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.224 by root, Mon Mar 12 21:42:12 2007 UTC vs.
Revision 1.253 by root, Wed Apr 18 17:32:07 2007 UTC