ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/include/cfperl.h
(Generate patch)

Comparing deliantra/server/include/cfperl.h (file contents):
Revision 1.16 by root, Wed Aug 30 16:30:37 2006 UTC vs.
Revision 1.74 by root, Mon May 28 21:15:56 2007 UTC

1/*
2 * This file is part of Crossfire TRT, the Multiplayer Online Role Playing Game.
3 *
4 * Copyright (©) 2005,2006,2007 Marc Alexander Lehmann / Robin Redeker / the Crossfire TRT team
5 * Copyright (©) 2002,2007 Mark Wedel & Crossfire Development Team
6 * Copyright (©) 1992,2007 Frank Tore Johansen
7 *
8 * Crossfire TRT is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the Free
10 * Software Foundation; either version 2 of the License, or (at your option)
11 * any later version.
12 *
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
15 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 * for more details.
17 *
18 * You should have received a copy of the GNU General Public License along
19 * with Crossfire TRT; if not, write to the Free Software Foundation, Inc. 51
20 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 *
22 * The authors can be reached via e-mail to <crossfire@schmorp.de>
23 */
24
1// 25//
2// cfperl.h perl interface 26// cfperl.h perl interface
3// 27//
4#ifndef CFPERL_H__ 28#ifndef CFPERL_H__
5#define CFPERL_H__ 29#define CFPERL_H__
6 30
31#include <cstdarg>
7#include <cstdio> 32#include <cstdio>
33#include <bitset>
8 34
9using namespace std; 35using namespace std;
10 36
11#include <EXTERN.h> 37#include <EXTERN.h>
12#include <perl.h> 38#include <perl.h>
39#include <XSUB.h>
40
41#include <EventAPI.h>
42#include <CoroAPI.h>
43
44#include "util.h"
45#include "keyword.h"
46#include "dynbuf.h"
47#include "callback.h"
48
49//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
13 50
14// optimisations/workaround for functions requiring my_perl in scope (anti-bloat) 51// optimisations/workaround for functions requiring my_perl in scope (anti-bloat)
15#undef localtime 52#undef localtime
16#undef srand48 53#undef srand48
17#undef drand48 54#undef drand48
20#undef getprotobyname 57#undef getprotobyname
21#undef gethostbyname 58#undef gethostbyname
22#undef ctime 59#undef ctime
23#undef strerror 60#undef strerror
24 61
62// same here, massive symbol spamming
63#undef do_open
64#undef do_close
65#undef ref
66#undef seed
67
25// perl bug #40256: perl does overwrite those with reentrant versions 68// perl bug #40256: perl does overwrite those with reentrant versions
26// but does not initialise their state structures. 69// but does not initialise their state structures.
27#undef random 70#undef random
28#undef crypt 71#undef crypt
29 72
30struct pl; 73//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
31struct object; 74
32struct mapstruct; 75// some macros to simplify perl in-calls
76
77#define CHECK_ERROR \
78 if (SvTRUE (ERRSV)) \
79 LOG (llevError, "runtime error in %s: %s\n", __func__, SvPVutf8_nolen (ERRSV));
80
81#define CALL_BEGIN(args) dSP; ENTER; SAVETMPS; PUSHMARK (SP); EXTEND (SP, args)
82#define CALL_ARG_SV(sv) PUSHs (sv_2mortal (sv)) // separate because no refcount inc
83#define CALL_ARG(expr) PUSHs (sv_2mortal (to_sv (expr)))
84#define CALL_CALL(name, flags) PUTBACK; int count = call_pv (name, (flags) | G_EVAL); SPAGAIN;
85#define CALL_END CHECK_ERROR; FREETMPS; LEAVE
86
87//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
33 88
34void cfperl_init (); 89void cfperl_init ();
35void cfperl_boot ();
36void cfperl_main (); 90void cfperl_main ();
91void cfperl_emergency_save ();
92void cfperl_cleanup (int make_core);
93void cfperl_make_book (object *book, int level);
37 94
38// could have used templates, but a more traditional C api 95//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
39// uses more explicit typing which is ok for this purpose.
40enum data_type
41{
42 DT_END, // no further arguments
43 DT_AV, // perl-only av that needs to be flattened out
44 DT_INT,
45 DT_INT64,
46 DT_DOUBLE,
47 DT_STRING, // 0-terminated string
48 DT_DATA, // string + length
49 DT_OBJECT,
50 DT_MAP,
51 DT_PLAYER,
52 DT_ARCH,
53 DT_PARTY,
54 DT_REGION,
55 96
56 NUM_DATA_TYPES 97// virtual server time, excluding time jumps and lag
57}; 98extern double runtime;
58 99
59enum event_klass 100enum event_klass
60{ 101{
61 KLASS_NONE, 102 KLASS_NONE,
62 KLASS_GLOBAL, 103 KLASS_GLOBAL,
104 KLASS_ATTACHABLE,
105 KLASS_CLIENT,
63 KLASS_PLAYER, 106 KLASS_PLAYER,
64 KLASS_OBJECT, 107 KLASS_OBJECT,
65 KLASS_MAP, 108 KLASS_MAP,
109 KLASS_COMMAND,
66}; 110};
67 111
68enum event_type 112enum event_type
69{ 113{
70# define def(klass,name) EVENT_ ## klass ## _ ## name, 114# define def(klass,name) EVENT_ ## klass ## _ ## name,
71# include "eventinc.h" 115# include "eventinc.h"
72# undef def 116# undef def
73 NUM_EVENT_TYPES 117 NUM_EVENT_TYPES
74}; 118};
75 119
120// in which global events or per-type events are we interested
121extern bitset<NUM_EVENT_TYPES> ev_want_event;
122extern bitset<NUM_TYPES> ev_want_type;
123
76#define ARG_AV(o) DT_AV , static_cast<AV *> (o) 124#define ARG_AV(o) DT_AV , static_cast<AV *> (o)
77#define ARG_INT(v) DT_INT , static_cast<int> (v) 125#define ARG_INT(v) DT_INT , static_cast<int> (v)
78#define ARG_INT64(v) DT_INT64 , static_cast<sint64> (v) 126#define ARG_INT64(v) DT_INT64 , static_cast<sint64> (v)
79#define ARG_DOUBLE(v) DT_DOUBLE, static_cast<double> (v) 127#define ARG_DOUBLE(v) DT_DOUBLE, static_cast<double> (v)
80#define ARG_STRING(v) DT_STRING, static_cast<const char *> (v) 128#define ARG_STRING(v) DT_STRING, static_cast<const char *> (v)
81#define ARG_DATA(s,l) DT_DATA , static_cast<const void *> (s), (l) 129#define ARG_DATA(s,l) DT_DATA , static_cast<const void *> (s), int (l)
82#define ARG_OBJECT(o) DT_OBJECT, (void *)static_cast<struct object *> (o) 130#define ARG_OBJECT(o) DT_OBJECT, (void *)(static_cast<object *> (o))
83#define ARG_MAP(o) DT_MAP , (void *)static_cast<struct mapstruct *> (o) 131#define ARG_MAP(o) DT_MAP , (void *)(static_cast<maptile *> (o))
84#define ARG_PLAYER(o) DT_PLAYER, (void *)static_cast<struct pl *> (o) 132#define ARG_PLAYER(o) DT_PLAYER, (void *)(static_cast<player *> (o))
85#define ARG_ARCH(o) DT_ARCH , (void *)static_cast<struct archetype *> (o) 133#define ARG_ARCH(o) DT_ARCH , (void *)(static_cast<archetype *> (o))
134#define ARG_CLIENT(o) DT_CLIENT, (void *)(static_cast<client *> (o))
86#define ARG_PARTY(o) DT_PARTY , (void *)static_cast<struct party *> (o) 135#define ARG_PARTY(o) DT_PARTY , (void *)(static_cast<party *> (o))
87#define ARG_REGION(o) DT_REGION, (void *)static_cast<struct region *> (o) 136#define ARG_REGION(o) DT_REGION, (void *)(static_cast<region *> (o))
88 137
89// the ", ## __VA_ARGS" is, unfortunately, a gnu-cpp extension 138// the ", ## __VA_ARGS" is, unfortunately, a gnu-cpp extension
90 139#define INVOKE(obj,event, ...) (expect_false ((obj)->should_invoke (event)) ? (obj)->invoke (event, ## __VA_ARGS__, DT_END) : 0)
91// all these return true when the normal event processing should be skipped (if any)
92#define INVOKE_(event, ...) cfperl_invoke (event, ## __VA_ARGS__, DT_END)
93
94#define INVOKE(klass, event, ...) INVOKE_(EVENT_ ## klass ## _ ## event, ## __VA_ARGS__)
95#define INVOKE_GLOBAL(event, ...) INVOKE_(EVENT_ ## GLOBAL ## _ ## event, ## __VA_ARGS__) 140#define INVOKE_GLOBAL(event, ...) INVOKE (&gbl_ev, EVENT_ ## GLOBAL ## _ ## event, ## __VA_ARGS__)
141#define INVOKE_ATTACHABLE(event, obj, ...) INVOKE (obj , EVENT_ ## ATTACHABLE ## _ ## event, ## __VA_ARGS__)
96#define INVOKE_OBJECT(event, op, ...) INVOKE_(EVENT_ ## OBJECT ## _ ## event, ARG_OBJECT (op), ## __VA_ARGS__) 142#define INVOKE_OBJECT(event, obj, ...) INVOKE (obj , EVENT_ ## OBJECT ## _ ## event, ## __VA_ARGS__)
143#define INVOKE_CLIENT(event, obj, ...) INVOKE (obj , EVENT_ ## CLIENT ## _ ## event, ## __VA_ARGS__)
97#define INVOKE_PLAYER(event, pl, ...) INVOKE_(EVENT_ ## PLAYER ## _ ## event, ARG_PLAYER (pl), ## __VA_ARGS__) 144#define INVOKE_PLAYER(event, obj, ...) INVOKE (obj , EVENT_ ## PLAYER ## _ ## event, ## __VA_ARGS__)
98#define INVOKE_MAP(event, map, ...) INVOKE_(EVENT_ ## MAP ## _ ## event, ARG_MAP (map) , ## __VA_ARGS__) 145#define INVOKE_MAP(event, obj, ...) INVOKE (obj , EVENT_ ## MAP ## _ ## event, ## __VA_ARGS__)
99 146
100//TODO should index into @result 147//TODO should index into @result
101#define RESULT(idx,type) cfperl_result_ ## type (idx) 148#define RESULT(idx,type) cfperl_result_ ## type (idx)
149#define RESULT_DOUBLE(idx) RESULT(idx, DOUBLE)
102#define RESULT_INT(idx) RESULT(idx, INT) 150#define RESULT_INT(idx) RESULT(idx, INT)
103 151
104bool cfperl_invoke (event_type event, ...); 152double cfperl_result_DOUBLE (int idx);
105int cfperl_result_INT (int idx); 153int cfperl_result_INT (int idx);
106 154
155//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
156
157INTERFACE_CLASS (attachable)
107struct attachable_base 158struct attachable
108{ 159{
109 struct sv *self; 160 static MGVTBL vtbl;
110 struct av *cb; // CF+ perl self and callback 161
162 static unordered_vector<attachable *> mortals;
163 MTH static void check_mortals ();
164
165 enum {
166 F_DESTROYED = 0x01,
167 F_DEBUG_TRACE = 0x02,
168 };
169
170 // object is delete'd after the refcount reaches 0
171 int ACC (RW, flags);
172 mutable int ACC (RW, refcnt);
173
174 MTH void refcnt_inc () const { ++refcnt; }
175 MTH void refcnt_dec () const { --refcnt; }
176
177 MTH int refcnt_cnt () const;
178 // check wether the object has died and destroy
179 MTH void refcnt_chk () { if (refcnt <= 0) do_check (); }
180
181 // destroy the object unless it was already destroyed
182 // this politely asks everybody interested the reduce
183 // the refcount to 0 as soon as possible.
184 MTH void destroy ();
185
186 // return wether an object was destroyed already
187 MTH bool destroyed () const { return flags & F_DESTROYED; }
188
189 virtual void gather_callbacks (AV *&callbacks, event_type event) const;
190
191#if 0
192private:
193 static refcounted *rc_first;
194 refcounted *rc_next;
195#endif
196
197 HV *self; // CF+ perl self
198 AV *cb; // CF+ callbacks
111 const char *attach; // generic extension attachment information 199 shstr attach; // generic extension attachment information
112 200
113 void clear (); // called when free'ing objects 201 void sever_self (); // sever this object from its self, if it has one.
114 void optimise (); // possibly save some memory by destroying unneeded data 202 void optimise (); // possibly save some memory by destroying unneeded data
115 void instantiate (data_type type, void *obj);
116 203
117 void attachable_init () 204 attachable ()
205 : flags (0), refcnt (0), self (0), cb (0), attach (0)
118 { 206 {
119 self = 0;
120 cb = 0;
121 attach = 0;
122 } 207 }
123};
124 208
125// objects attachable from perl (or any other extension) should include or 209 attachable (const attachable &src)
126// derive using the curiously recurring template pattern, to avoid 210 : flags (0), refcnt (0), self (0), cb (0), attach (src.attach)
127// virtual method calls etc.
128template<class subclass>
129struct attachable : attachable_base
130{
131 static data_type get_dt ()
132 { 211 {
133 return subclass::get_dt ();
134 } 212 }
135 213
214 virtual ~attachable ();
215
216 attachable &operator =(const attachable &src);
217
218 // used to _quickly_ device wether to shortcut the evaluation
219 bool should_invoke (event_type event)
220 {
221 return ev_want_event [event] || cb;
222 }
223
224 bool invoke (event_type event, ...);
225
136 void instantiate () 226 MTH void instantiate ();
137 { 227 void reattach ();
138 if (attach)
139 attachable_base::instantiate (get_dt (), static_cast<subclass *>(this));
140 }
141};
142 228
143struct object_freezethaw 229protected:
144{ 230 // do the real refcount checking work
145 struct av *av; 231 void do_check ();
146};
147 232
148struct object_freezer : object_freezethaw 233 // the method that does the real destroy work
149{ 234 virtual void do_destroy ();
150 struct sv *text; 235};
151 void *filename;
152 236
153 object_freezer (const char *filename); 237// the global object is a pseudo object that cares for the global events
238struct global : attachable
239{
240 void gather_callbacks (AV *&callbacks, event_type event) const;
241};
242
243extern struct global gbl_ev;
244
245//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
246
247struct object_freezer : dynbuf_text
248{
249 AV *av;
250
251 object_freezer ();
154 ~object_freezer (); 252 ~object_freezer ();
155 253
156 void put (attachable_base *ext); 254 void put (attachable *ext);
157 255
158 template<class subclass> 256 // used only for user-defined key-value pairs
159 void put (attachable<subclass> *obj) 257 void put (const shstr &k, const shstr &v)
160 { 258 {
161 put ((attachable_base *)obj); 259 add (k);
260
261 if (expect_true (v))
262 add (' '), add (v);
263
264 add ('\n');
162 } 265 }
266
267 template<typename T>
268 void put_string (keyword k, const T &v)
269 {
270 int klen = keyword_len [k];
271 int vlen = v ? strlen (v) + 1 : 0;
272
273 char *p = (char *)alloc (klen + vlen + 1);
274
275 memcpy (p, keyword_str [k], klen); p += klen;
276
277 if (expect_true (v))
278 {
279 *p++ = ' '; vlen--;
280 memcpy (p, v, vlen); p += vlen;
281 }
282
283 *p = '\n';
284 }
285
286 void put (keyword k, const char *v = 0)
287 {
288 put_string (k, v);
289 }
290
291 void put (keyword k, const shstr &v)
292 {
293 put_string (k, v);
294 }
295
296 void put (keyword k, double v)
297 {
298 force (MAX_KEYWORD_LEN + 2 + 32);
299 fadd (keyword_str [k], keyword_len [k]);
300 fadd (' ');
301 falloc (sprintf (ptr, "%.7g", v));
302 fadd ('\n');
303 }
304
305 void put_(keyword k, sint64 v)
306 {
307 force (MAX_KEYWORD_LEN + 2 + sint64_digits);
308 fadd (keyword_str [k], keyword_len [k]);
309 fadd (' ');
310 add (v);
311 fadd ('\n');
312 }
313
314 void put_(keyword k, sint32 v)
315 {
316 force (MAX_KEYWORD_LEN + 2 + sint32_digits);
317 fadd (keyword_str [k], keyword_len [k]);
318 fadd (' ');
319 add (v);
320 fadd ('\n');
321 }
322
323 void put (keyword k, float v) { put (k, (double)v); }
324 void put (keyword k, signed char v) { put_(k, (sint32)v); }
325 void put (keyword k, unsigned char v) { put_(k, (sint32)v); }
326 void put (keyword k, signed short v) { put_(k, (sint32)v); }
327 void put (keyword k, unsigned short v) { put_(k, (sint32)v); }
328 void put (keyword k, signed int v) { put_(k, (sint32)v); }
329 void put (keyword k, unsigned int v) { put_(k, (sint64)v); }
330 void put (keyword k, signed long v) { put_(k, (sint64)v); }
331 void put (keyword k, unsigned long v) { put_(k, (sint64)v); }
332 void put (keyword k, signed long long v) { put_(k, (sint64)v); }
333 void put (keyword k, unsigned long long v) { put_(k, (sint64)v); }
334
335 void put (keyword kbeg, keyword kend, const shstr &v)
336 {
337 force (MAX_KEYWORD_LEN + 1);
338 fadd (keyword_str [kbeg], keyword_len [kbeg]); fadd ('\n');
339
340 if (expect_true (v))
341 {
342 add (v);
343 add ('\n');
344 }
345
346 force (MAX_KEYWORD_LEN + 1);
347 fadd (keyword_str [kend], keyword_len [kend]); fadd ('\n');
348 }
349
350 template<typename T>
351 void put (keyword k, const T *v)
352 {
353 if (v)
354 put (k, v->name);
355 else
356 put (k, (const char *)0);
357 }
358
359 template<typename T>
360 void put (keyword k, const refptr<T> &v)
361 {
362 put (k, (T *)v);
363 }
364
365 bool save (const char *path);
366 char *as_string (); // like strdup
163 367
164 operator bool () { return !!av; } 368 operator bool () { return !!av; }
165}; 369};
166 370
167struct object_thawer : object_freezethaw 371struct object_thawer
168{ 372{
169 FILE *fp; 373 char *line; // current beginning of line
374 SV *text; // text part
375 AV *av; // perl part
376 int linenum;
377 keyword kw;
378 char *kw_str; // the keyword parsed, as string
379 char *value; // the value, or 0 if no value
380 char *value_nn; // the value, or the empty string if no value
381 const char *name;
170 382
383 operator bool () { return !!text; }
384
171 object_thawer (const char *filename = 0); 385 object_thawer (const char *path = 0);
386 object_thawer (const char *data, AV *perlav);
172 ~object_thawer (); 387 ~object_thawer ();
173 388
174 void get (data_type type, void *obj, attachable_base *ext, int oid);
175
176 template<class subclass>
177 void get (attachable<subclass> *obj, int oid) 389 void get (attachable *obj, int oid);
178 {
179 if (av)
180 get (subclass::get_dt (), (subclass *)obj, obj, oid);
181 }
182 390
183 operator FILE *() { return fp; } 391 // parse next line
184}; 392 void next ();
393 // skip the current key-value (usually fetch next line, for
394 // multiline-fields, skips till the corresponding end-kw
395 void skip ();
185 396
186// compatibility support, should be removed when no longer needed 397 char *get_str () { return value; } // may be 0
187int fprintf (object_freezer &freezer, const char *format, ...); 398 void get_ml (keyword kend, shstr &sh);
188int fputs (const char *s, object_freezer &freezer); 399
400 void get_ornull (shstr &sh) const { sh = value; }
401 void get (shstr &sh) const { sh = value; } // might want to check for non-null here
402
403 bool get_bool () const { return *value_nn == '1'; }
404 sint32 get_sint32 () const;
405 sint64 get_sint64 () const { return strtoll (value_nn, 0, 10); }
406 double get_double () const { return strtod (value_nn, 0); }
407
408 void get (float &v) { v = get_double (); }
409 void get (double &v) { v = get_double (); }
410
411 void get (bool &i) { i = get_bool (); }
412 void get (sint8 &i) { i = get_sint32 (); }
413 void get (uint8 &i) { i = get_sint32 (); }
414 void get (sint16 &i) { i = get_sint32 (); }
415 void get (uint16 &i) { i = get_sint32 (); }
416 void get (sint32 &i) { i = get_sint32 (); }
417
418 void get (uint32 &i) { i = get_sint64 (); }
419 void get (sint64 &i) { i = get_sint64 (); }
420
421 bool parse_error (const char *type = 0, const char *name = 0, bool skip = true);
422};
423
424//TODO: remove
425char *fgets (char *s, int n, object_thawer &thawer);
426
427//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
428
429struct coroapi {
430 static struct CoroAPI *GCoroAPI;
431
432 static int nready () { return CORO_NREADY; }
433 static int cede () { return CORO_CEDE ; }
434
435 static double (*time)();
436 static double next_cede;
437 static int cede_counter;
438
439 static void do_cede_every ();
440 static void do_cede_to_tick ();
441 static void do_cede_to_tick_every ();
442
443 static void cede_every (int count)
444 {
445 if (expect_false (++cede_counter >= count))
446 do_cede_every ();
447 }
448
449 static void cede_to_tick ()
450 {
451 if (expect_false (time () >= next_cede))
452 do_cede_to_tick ();
453 }
454
455 static void cede_to_tick_every (int count)
456 {
457 if (expect_false (++cede_counter >= count))
458 cede_to_tick ();
459 }
460
461 static void wait_for_tick ();
462 static void wait_for_tick_begin ();
463};
464
465struct watcher_base
466{
467 static struct EventAPI *GEventAPI;
468};
469
470template<class base>
471struct watcher : watcher_base
472{
473 base *pe;
474
475 void start (bool repeat = false) { GEventAPI->start ((pe_watcher *)pe, repeat); }
476 void stop (bool cancel_events = false) { GEventAPI->stop ((pe_watcher *)pe, cancel_events); }
477 void now () { GEventAPI->now ((pe_watcher *)pe); }
478 void suspend () { GEventAPI->suspend ((pe_watcher *)pe); }
479 void resume () { GEventAPI->resume ((pe_watcher *)pe); }
480
481 void prio (int new_prio) { ((pe_watcher *)pe)->prio = new_prio; }
482
483 ~watcher ()
484 {
485 cancel ();
486 }
487
488private:
489 void cancel () { GEventAPI->cancel ((pe_watcher *)pe); } // private
490};
491
492struct iw : watcher<pe_idle>, callback<void (iw &)>
493{
494 template<class O, class M>
495 iw (O object, M method)
496 : callback<void (iw &)> (object, method)
497 {
498 alloc ();
499 }
500
501private:
502 void alloc ();
503};
504
505struct iow : watcher<pe_io>, callback<void (iow &, int)>
506{
507 template<class O, class M>
508 iow (O object, M method)
509 : callback<void (iow &, int)> (object, method)
510 {
511 alloc ();
512 }
513
514 void fd (int fd);
515 int poll ();
516 void poll (int events);
517
518private:
519 void alloc ();
520};
189 521
190#endif 522#endif
191 523

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines