ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/lib/cf.pm
(Generate patch)

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.69 by root, Mon Sep 18 01:10:35 2006 UTC vs.
Revision 1.80 by root, Tue Nov 7 16:30:55 2006 UTC

5use Storable; 5use Storable;
6use Opcode; 6use Opcode;
7use Safe; 7use Safe;
8use Safe::Hole; 8use Safe::Hole;
9 9
10use IO::AIO ();
11use YAML::Syck ();
10use Time::HiRes; 12use Time::HiRes;
11use Event; 13use Event;
12$Event::Eval = 1; # no idea why this is required, but it is 14$Event::Eval = 1; # no idea why this is required, but it is
13 15
16# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
17$YAML::Syck::ImplicitUnicode = 1;
18
14use strict; 19use strict;
15 20
16_init_vars; 21_init_vars;
17 22
18our %COMMAND = (); 23our %COMMAND = ();
20our $LIBDIR = maps_directory "perl"; 25our $LIBDIR = maps_directory "perl";
21 26
22our $TICK = MAX_TIME * 1e-6; 27our $TICK = MAX_TIME * 1e-6;
23our $TICK_WATCHER; 28our $TICK_WATCHER;
24our $NEXT_TICK; 29our $NEXT_TICK;
30
31our %CFG;
32
33our $uptime;
34
35$uptime ||= time;
36
37#############################################################################
38
39=head2 GLOBAL VARIABLES
40
41=over 4
42
43=item $cf::LIBDIR
44
45The perl library directory, where extensions and cf-specific modules can
46be found. It will be added to C<@INC> automatically.
47
48=item $cf::TICK
49
50The interval between server ticks, in seconds.
51
52=item %cf::CFG
53
54Configuration for the server, loaded from C</etc/crossfire/config>, or
55from wherever your confdir points to.
56
57=back
58
59=cut
25 60
26BEGIN { 61BEGIN {
27 *CORE::GLOBAL::warn = sub { 62 *CORE::GLOBAL::warn = sub {
28 my $msg = join "", @_; 63 my $msg = join "", @_;
29 $msg .= "\n" 64 $msg .= "\n"
51my @exts; 86my @exts;
52my @hook; 87my @hook;
53my %command; 88my %command;
54my %extcmd; 89my %extcmd;
55 90
56############################################################################# 91=head2 UTILITY FUNCTIONS
57# utility functions 92
93=over 4
94
95=cut
58 96
59use JSON::Syck (); # TODO# replace by JSON::PC once working 97use JSON::Syck (); # TODO# replace by JSON::PC once working
98
99=item $ref = cf::from_json $json
100
101Converts a JSON string into the corresponding perl data structure.
102
103=cut
60 104
61sub from_json($) { 105sub from_json($) {
62 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs 106 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
63 JSON::Syck::Load $_[0] 107 JSON::Syck::Load $_[0]
64} 108}
65 109
110=item $json = cf::to_json $ref
111
112Converts a perl data structure into its JSON representation.
113
114=cut
115
66sub to_json($) { 116sub to_json($) {
67 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs 117 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
68 JSON::Syck::Dump $_[0] 118 JSON::Syck::Dump $_[0]
69} 119}
70 120
71############################################################################# 121=back
72# "new" plug-in system
73 122
123=cut
124
125#############################################################################
126
74=head3 EVENTS AND OBJECT ATTACHMENTS 127=head2 EVENTS AND OBJECT ATTACHMENTS
75 128
76=over 4 129=over 4
77 130
78=item $object->attach ($attachment, key => $value...) 131=item $object->attach ($attachment, key => $value...)
79 132
379removed in future versions), and there is no public API to access override 432removed in future versions), and there is no public API to access override
380results (if you must, access C<@cf::invoke_results> directly). 433results (if you must, access C<@cf::invoke_results> directly).
381 434
382=back 435=back
383 436
384=head2 methods valid for all pointers 437=cut
438
439#############################################################################
440
441=head2 METHODS VALID FOR ALL CORE OBJECTS
385 442
386=over 4 443=over 4
387 444
388=item $object->valid 445=item $object->valid, $player->valid, $map->valid
389
390=item $player->valid
391
392=item $map->valid
393 446
394Just because you have a perl object does not mean that the corresponding 447Just because you have a perl object does not mean that the corresponding
395C-level object still exists. If you try to access an object that has no 448C-level object still exists. If you try to access an object that has no
396valid C counterpart anymore you get an exception at runtime. This method 449valid C counterpart anymore you get an exception at runtime. This method
397can be used to test for existence of the C object part without causing an 450can be used to test for existence of the C object part without causing an
470 unlink $filename; 523 unlink $filename;
471 unlink "$filename.pst"; 524 unlink "$filename.pst";
472 } 525 }
473} 526}
474 527
528sub object_freezer_as_string {
529 my ($rdata, $objs) = @_;
530
531 use Data::Dumper;
532
533 "$$rdata\n" . Dumper $objs
534}
535
475sub object_thawer_load { 536sub object_thawer_load {
476 my ($filename) = @_; 537 my ($filename) = @_;
477 538
478 local $/; 539 local $/;
479 540
704 } 765 }
705 }, 766 },
706; 767;
707 768
708############################################################################# 769#############################################################################
709# core extensions - in perl 770
771=head2 CORE EXTENSIONS
772
773Functions and methods that extend core crossfire objects.
774
775=over 4
710 776
711=item cf::player::exists $login 777=item cf::player::exists $login
712 778
713Returns true when the given account exists. 779Returns true when the given account exists.
714 780
717sub cf::player::exists($) { 783sub cf::player::exists($) {
718 cf::player::find $_[0] 784 cf::player::find $_[0]
719 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2; 785 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
720} 786}
721 787
722=item $player->reply ($npc, $msg[, $flags]) 788=item $player_object->reply ($npc, $msg[, $flags])
723 789
724Sends a message to the player, as if the npc C<$npc> replied. C<$npc> 790Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
725can be C<undef>. Does the right thing when the player is currently in a 791can be C<undef>. Does the right thing when the player is currently in a
726dialogue with the given NPC character. 792dialogue with the given NPC character.
727 793
754 $msg{msgid} = $id; 820 $msg{msgid} = $id;
755 821
756 $self->send ("ext " . to_json \%msg); 822 $self->send ("ext " . to_json \%msg);
757} 823}
758 824
825=item $player_object->may ("access")
826
827Returns wether the given player is authorized to access resource "access"
828(e.g. "command_wizcast").
829
830=cut
831
832sub cf::object::player::may {
833 my ($self, $access) = @_;
834
835 $self->flag (cf::FLAG_WIZ) ||
836 (ref $cf::CFG{"may_$access"}
837 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
838 : $cf::CFG{"may_$access"})
839}
840
841=cut
842
759############################################################################# 843#############################################################################
760# map scripting support 844
845=head2 SAFE SCRIPTING
846
847Functions that provide a safe environment to compile and execute
848snippets of perl code without them endangering the safety of the server
849itself. Looping constructs, I/O operators and other built-in functionality
850is not available in the safe scripting environment, and the number of
851functions and methods that can be called is greatly reduced.
852
853=cut
761 854
762our $safe = new Safe "safe"; 855our $safe = new Safe "safe";
763our $safe_hole = new Safe::Hole; 856our $safe_hole = new Safe::Hole;
764 857
765$SIG{FPE} = 'IGNORE'; 858$SIG{FPE} = 'IGNORE';
766 859
767$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time)); 860$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));
768 861
769# here we export the classes and methods available to script code 862# here we export the classes and methods available to script code
863
864=pod
865
866The following fucntions and emthods are available within a safe environment:
867
868 cf::object contr pay_amount pay_player
869 cf::object::player player
870 cf::player peaceful
871
872=cut
770 873
771for ( 874for (
772 ["cf::object" => qw(contr pay_amount pay_player)], 875 ["cf::object" => qw(contr pay_amount pay_player)],
773 ["cf::object::player" => qw(player)], 876 ["cf::object::player" => qw(player)],
774 ["cf::player" => qw(peaceful)], 877 ["cf::player" => qw(peaceful)],
777 my ($pkg, @funs) = @$_; 880 my ($pkg, @funs) = @$_;
778 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"}) 881 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
779 for @funs; 882 for @funs;
780} 883}
781 884
885=over 4
886
887=item @retval = safe_eval $code, [var => value, ...]
888
889Compiled and executes the given perl code snippet. additional var/value
890pairs result in temporary local (my) scalar variables of the given name
891that are available in the code snippet. Example:
892
893 my $five = safe_eval '$first + $second', first => 1, second => 4;
894
895=cut
896
782sub safe_eval($;@) { 897sub safe_eval($;@) {
783 my ($code, %vars) = @_; 898 my ($code, %vars) = @_;
784 899
785 my $qcode = $code; 900 my $qcode = $code;
786 $qcode =~ s/"/‟/g; # not allowed in #line filenames 901 $qcode =~ s/"/‟/g; # not allowed in #line filenames
830 945
831 no strict 'refs'; 946 no strict 'refs';
832 *{"safe::$fun"} = $safe_hole->wrap ($cb); 947 *{"safe::$fun"} = $safe_hole->wrap ($cb);
833} 948}
834 949
950=back
951
952=cut
953
835############################################################################# 954#############################################################################
836 955
837=head2 EXTENSION DATABASE SUPPORT 956=head2 EXTENSION DATABASE SUPPORT
838 957
839Crossfire maintains a very simple database for extension use. It can 958Crossfire maintains a very simple database for extension use. It can
873 992
874Immediately write the database to disk I<if it is dirty>. 993Immediately write the database to disk I<if it is dirty>.
875 994
876=cut 995=cut
877 996
997our $DB;
998
878{ 999{
879 my $db;
880 my $path = cf::localdir . "/database.pst"; 1000 my $path = cf::localdir . "/database.pst";
881 1001
882 sub db_load() { 1002 sub db_load() {
883 warn "loading database $path\n";#d# remove later 1003 warn "loading database $path\n";#d# remove later
884 $db = stat $path ? Storable::retrieve $path : { }; 1004 $DB = stat $path ? Storable::retrieve $path : { };
885 } 1005 }
886 1006
887 my $pid; 1007 my $pid;
888 1008
889 sub db_save() { 1009 sub db_save() {
890 warn "saving database $path\n";#d# remove later 1010 warn "saving database $path\n";#d# remove later
891 waitpid $pid, 0 if $pid; 1011 waitpid $pid, 0 if $pid;
892 if (0 == ($pid = fork)) { 1012 if (0 == ($pid = fork)) {
893 $db->{_meta}{version} = 1; 1013 $DB->{_meta}{version} = 1;
894 Storable::nstore $db, "$path~"; 1014 Storable::nstore $DB, "$path~";
895 rename "$path~", $path; 1015 rename "$path~", $path;
896 cf::_exit 0 if defined $pid; 1016 cf::_exit 0 if defined $pid;
897 } 1017 }
898 } 1018 }
899 1019
913 $idle->start; 1033 $idle->start;
914 } 1034 }
915 1035
916 sub db_get($;$) { 1036 sub db_get($;$) {
917 @_ >= 2 1037 @_ >= 2
918 ? $db->{$_[0]}{$_[1]} 1038 ? $DB->{$_[0]}{$_[1]}
919 : ($db->{$_[0]} ||= { }) 1039 : ($DB->{$_[0]} ||= { })
920 } 1040 }
921 1041
922 sub db_put($$;$) { 1042 sub db_put($$;$) {
923 if (@_ >= 3) { 1043 if (@_ >= 3) {
924 $db->{$_[0]}{$_[1]} = $_[2]; 1044 $DB->{$_[0]}{$_[1]} = $_[2];
925 } else { 1045 } else {
926 $db->{$_[0]} = $_[1]; 1046 $DB->{$_[0]} = $_[1];
927 } 1047 }
928 db_dirty; 1048 db_dirty;
929 } 1049 }
930 1050
931 attach_global 1051 attach_global
937} 1057}
938 1058
939############################################################################# 1059#############################################################################
940# the server's main() 1060# the server's main()
941 1061
1062sub cfg_load {
1063 open my $fh, "<:utf8", cf::confdir . "/config"
1064 or return;
1065
1066 local $/;
1067 *CFG = YAML::Syck::Load <$fh>;
1068}
1069
942sub main { 1070sub main {
1071 cfg_load;
943 db_load; 1072 db_load;
944 load_extensions; 1073 load_extensions;
945 Event::loop; 1074 Event::loop;
946} 1075}
947 1076
999 1128
1000 # reload cf.pm 1129 # reload cf.pm
1001 $msg->("reloading cf.pm"); 1130 $msg->("reloading cf.pm");
1002 require cf; 1131 require cf;
1003 1132
1004 # load database again 1133 # load config and database again
1134 cf::cfg_load;
1005 cf::db_load; 1135 cf::db_load;
1006 1136
1007 # load extensions 1137 # load extensions
1008 $msg->("load extensions"); 1138 $msg->("load extensions");
1009 cf::load_extensions; 1139 cf::load_extensions;
1038register "<global>", __PACKAGE__; 1168register "<global>", __PACKAGE__;
1039 1169
1040unshift @INC, $LIBDIR; 1170unshift @INC, $LIBDIR;
1041 1171
1042$TICK_WATCHER = Event->timer ( 1172$TICK_WATCHER = Event->timer (
1043 prio => 1, 1173 prio => 1,
1174 async => 1,
1044 at => $NEXT_TICK || 1, 1175 at => $NEXT_TICK || 1,
1045 cb => sub { 1176 cb => sub {
1046 cf::server_tick; # one server iteration 1177 cf::server_tick; # one server iteration
1047 1178
1048 my $NOW = Event::time; 1179 my $NOW = Event::time;
1049 $NEXT_TICK += $TICK; 1180 $NEXT_TICK += $TICK;
1050 1181
1051 # if we are delayed by four ticks, skip them all 1182 # if we are delayed by four ticks or more, skip them all
1052 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4; 1183 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
1053 1184
1054 $TICK_WATCHER->at ($NEXT_TICK); 1185 $TICK_WATCHER->at ($NEXT_TICK);
1055 $TICK_WATCHER->start; 1186 $TICK_WATCHER->start;
1056 }, 1187 },
1057); 1188);
1058 1189
1190IO::AIO::max_poll_time $TICK * 0.2;
1191
1192Event->io (fd => IO::AIO::poll_fileno,
1193 poll => 'r',
1194 prio => 5,
1195 cb => \&IO::AIO::poll_cb);
1196
10591 11971
1060 1198

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines