removed NET_MAXRATE (as it served no useful purpose), changed description of rate...
[divverent/darkplaces.git] / prvm_exec.c
1 /*
2 Copyright (C) 1996-1997 Id Software, Inc.
3
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
8
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
12
13 See the GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
18
19 */
20
21 #include "quakedef.h"
22 #include "progsvm.h"
23
24 char *prvm_opnames[] =
25 {
26 "^5DONE",
27
28 "MUL_F",
29 "MUL_V",
30 "MUL_FV",
31 "MUL_VF",
32
33 "DIV",
34
35 "ADD_F",
36 "ADD_V",
37
38 "SUB_F",
39 "SUB_V",
40
41 "^2EQ_F",
42 "^2EQ_V",
43 "^2EQ_S",
44 "^2EQ_E",
45 "^2EQ_FNC",
46
47 "^2NE_F",
48 "^2NE_V",
49 "^2NE_S",
50 "^2NE_E",
51 "^2NE_FNC",
52
53 "^2LE",
54 "^2GE",
55 "^2LT",
56 "^2GT",
57
58 "^6FIELD_F",
59 "^6FIELD_V",
60 "^6FIELD_S",
61 "^6FIELD_ENT",
62 "^6FIELD_FLD",
63 "^6FIELD_FNC",
64
65 "^1ADDRESS",
66
67 "STORE_F",
68 "STORE_V",
69 "STORE_S",
70 "STORE_ENT",
71 "STORE_FLD",
72 "STORE_FNC",
73
74 "^1STOREP_F",
75 "^1STOREP_V",
76 "^1STOREP_S",
77 "^1STOREP_ENT",
78 "^1STOREP_FLD",
79 "^1STOREP_FNC",
80
81 "^5RETURN",
82
83 "^2NOT_F",
84 "^2NOT_V",
85 "^2NOT_S",
86 "^2NOT_ENT",
87 "^2NOT_FNC",
88
89 "^5IF",
90 "^5IFNOT",
91
92 "^3CALL0",
93 "^3CALL1",
94 "^3CALL2",
95 "^3CALL3",
96 "^3CALL4",
97 "^3CALL5",
98 "^3CALL6",
99 "^3CALL7",
100 "^3CALL8",
101
102 "^1STATE",
103
104 "^5GOTO",
105
106 "^2AND",
107 "^2OR",
108
109 "BITAND",
110 "BITOR"
111 };
112
113 char *PRVM_GlobalString (int ofs);
114 char *PRVM_GlobalStringNoContents (int ofs);
115
116
117 //=============================================================================
118
119 /*
120 =================
121 PRVM_PrintStatement
122 =================
123 */
124 extern cvar_t prvm_statementprofiling;
125 void PRVM_PrintStatement (dstatement_t *s)
126 {
127         size_t i;
128         int opnum = (int)(s - prog->statements);
129
130         Con_Printf("s%i: ", opnum);
131         if( prog->statement_linenums )
132                 Con_Printf( "%s:%i: ", PRVM_GetString( prog->xfunction->s_file ), prog->statement_linenums[ opnum ] );
133
134         if (prvm_statementprofiling.integer)
135                 Con_Printf("%7.0f ", prog->statement_profile[s - prog->statements]);
136
137         if ( (unsigned)s->op < sizeof(prvm_opnames)/sizeof(prvm_opnames[0]))
138         {
139                 Con_Printf("%s ",  prvm_opnames[s->op]);
140                 i = strlen(prvm_opnames[s->op]);
141                 // don't count a preceding color tag when padding the name
142                 if (prvm_opnames[s->op][0] == STRING_COLOR_TAG)
143                         i -= 2;
144                 for ( ; i<10 ; i++)
145                         Con_Print(" ");
146         }
147         if (s->op == OP_IF || s->op == OP_IFNOT)
148                 Con_Printf("%s, s%i",PRVM_GlobalString((unsigned short) s->a),(signed short)s->b + opnum);
149         else if (s->op == OP_GOTO)
150                 Con_Printf("s%i",(signed short)s->a + opnum);
151         else if ( (unsigned)(s->op - OP_STORE_F) < 6)
152         {
153                 Con_Print(PRVM_GlobalString((unsigned short) s->a));
154                 Con_Print(", ");
155                 Con_Print(PRVM_GlobalStringNoContents((unsigned short) s->b));
156         }
157         else if (s->op == OP_ADDRESS || (unsigned)(s->op - OP_LOAD_F) < 6)
158         {
159                 if (s->a)
160                         Con_Print(PRVM_GlobalString((unsigned short) s->a));
161                 if (s->b)
162                 {
163                         Con_Print(", ");
164                         Con_Print(PRVM_GlobalStringNoContents((unsigned short) s->b));
165                 }
166                 if (s->c)
167                 {
168                         Con_Print(", ");
169                         Con_Print(PRVM_GlobalStringNoContents((unsigned short) s->c));
170                 }
171         }
172         else
173         {
174                 if (s->a)
175                         Con_Print(PRVM_GlobalString((unsigned short) s->a));
176                 if (s->b)
177                 {
178                         Con_Print(", ");
179                         Con_Print(PRVM_GlobalString((unsigned short) s->b));
180                 }
181                 if (s->c)
182                 {
183                         Con_Print(", ");
184                         Con_Print(PRVM_GlobalStringNoContents((unsigned short) s->c));
185                 }
186         }
187         Con_Print("\n");
188 }
189
190 void PRVM_PrintFunctionStatements (const char *name)
191 {
192         int i, firststatement, endstatement;
193         mfunction_t *func;
194         func = PRVM_ED_FindFunction (name);
195         if (!func)
196         {
197                 Con_Printf("%s progs: no function named %s\n", PRVM_NAME, name);
198                 return;
199         }
200         firststatement = func->first_statement;
201         if (firststatement < 0)
202         {
203                 Con_Printf("%s progs: function %s is builtin #%i\n", PRVM_NAME, name, -firststatement);
204                 return;
205         }
206
207         // find the end statement
208         endstatement = prog->progs->numstatements;
209         for (i = 0;i < prog->progs->numfunctions;i++)
210                 if (endstatement > prog->functions[i].first_statement && firststatement < prog->functions[i].first_statement)
211                         endstatement = prog->functions[i].first_statement;
212
213         // now print the range of statements
214         Con_Printf("%s progs: disassembly of function %s (statements %i-%i):\n", PRVM_NAME, name, firststatement, endstatement);
215         for (i = firststatement;i < endstatement;i++)
216         {
217                 PRVM_PrintStatement(prog->statements + i);
218                 prog->statement_profile[i] = 0;
219         }
220 }
221
222 /*
223 ============
224 PRVM_PrintFunction_f
225
226 ============
227 */
228 void PRVM_PrintFunction_f (void)
229 {
230         if (Cmd_Argc() != 3)
231         {
232                 Con_Printf("usage: prvm_printfunction <program name> <function name>\n");
233                 return;
234         }
235
236         PRVM_Begin;
237         if(!PRVM_SetProgFromString(Cmd_Argv(1)))
238                 return;
239
240         PRVM_PrintFunctionStatements(Cmd_Argv(2));
241
242         PRVM_End;
243 }
244
245 /*
246 ============
247 PRVM_StackTrace
248 ============
249 */
250 void PRVM_StackTrace (void)
251 {
252         mfunction_t     *f;
253         int                     i;
254
255         prog->stack[prog->depth].s = prog->xstatement;
256         prog->stack[prog->depth].f = prog->xfunction;
257         for (i = prog->depth;i > 0;i--)
258         {
259                 f = prog->stack[i].f;
260
261                 if (!f)
262                         Con_Print("<NULL FUNCTION>\n");
263                 else
264                         Con_Printf("%12s : %s : statement %i\n", PRVM_GetString(f->s_file), PRVM_GetString(f->s_name), prog->stack[i].s - f->first_statement);
265         }
266 }
267
268
269 void PRVM_Profile (int maxfunctions, int mininstructions)
270 {
271         mfunction_t *f, *best;
272         int i, num;
273         double max;
274
275         Con_Printf( "%s Profile:\n[CallCount] [Statements] [BuiltinCost]\n", PRVM_NAME );
276
277         num = 0;
278         do
279         {
280                 max = 0;
281                 best = NULL;
282                 for (i=0 ; i<prog->progs->numfunctions ; i++)
283                 {
284                         f = &prog->functions[i];
285                         if (max < f->profile + f->builtinsprofile + f->callcount)
286                         {
287                                 max = f->profile + f->builtinsprofile + f->callcount;
288                                 best = f;
289                         }
290                 }
291                 if (best)
292                 {
293                         if (num < maxfunctions && max >= mininstructions)
294                         {
295                                 if (best->first_statement < 0)
296                                         Con_Printf("%9.0f ----- builtin ----- %s\n", best->callcount, PRVM_GetString(best->s_name));
297                                 else
298                                         Con_Printf("%9.0f %9.0f %9.0f %s\n", best->callcount, best->profile, best->builtinsprofile, PRVM_GetString(best->s_name));
299                         }
300                         num++;
301                         best->profile = 0;
302                         best->builtinsprofile = 0;
303                         best->callcount = 0;
304                 }
305         } while (best);
306 }
307
308 /*
309 ============
310 PRVM_Profile_f
311
312 ============
313 */
314 void PRVM_Profile_f (void)
315 {
316         int howmany;
317
318         howmany = 1<<30;
319         if (Cmd_Argc() == 3)
320                 howmany = atoi(Cmd_Argv(2));
321         else if (Cmd_Argc() != 2)
322         {
323                 Con_Print("prvm_profile <program name>\n");
324                 return;
325         }
326
327         PRVM_Begin;
328         if(!PRVM_SetProgFromString(Cmd_Argv(1)))
329                 return;
330
331         PRVM_Profile(howmany, 1);
332
333         PRVM_End;
334 }
335
336 void PRVM_CrashAll()
337 {
338         int i;
339         prvm_prog_t *oldprog = prog;
340
341         for(i = 0; i < PRVM_MAXPROGS; i++)
342         {
343                 if(!PRVM_ProgLoaded(i))
344                         continue;
345                 PRVM_SetProg(i);
346                 PRVM_Crash();
347         }
348
349         prog = oldprog;
350 }
351
352 void PRVM_PrintState(void)
353 {
354         int i;
355         if (prog->xfunction)
356         {
357                 for (i = -7; i <= 0;i++)
358                         if (prog->xstatement + i >= prog->xfunction->first_statement)
359                                 PRVM_PrintStatement (prog->statements + prog->xstatement + i);
360         }
361         else
362                 Con_Print("null function executing??\n");
363         PRVM_StackTrace ();
364 }
365
366 void PRVM_Crash()
367 {
368         if (prog == NULL)
369                 return;
370
371         if( prog->depth > 0 )
372         {
373                 Con_Printf("QuakeC crash report for %s:\n", PRVM_NAME);
374                 PRVM_PrintState();
375         }
376
377         // dump the stack so host_error can shutdown functions
378         prog->depth = 0;
379         prog->localstack_used = 0;
380
381         // reset the prog pointer
382         prog = NULL;
383 }
384
385 /*
386 ============================================================================
387 PRVM_ExecuteProgram
388
389 The interpretation main loop
390 ============================================================================
391 */
392
393 /*
394 ====================
395 PRVM_EnterFunction
396
397 Returns the new program statement counter
398 ====================
399 */
400 int PRVM_EnterFunction (mfunction_t *f)
401 {
402         int             i, j, c, o;
403
404         if (!f)
405                 PRVM_ERROR ("PRVM_EnterFunction: NULL function in %s", PRVM_NAME);
406
407         prog->stack[prog->depth].s = prog->xstatement;
408         prog->stack[prog->depth].f = prog->xfunction;
409         prog->depth++;
410         if (prog->depth >=PRVM_MAX_STACK_DEPTH)
411                 PRVM_ERROR ("stack overflow");
412
413 // save off any locals that the new function steps on
414         c = f->locals;
415         if (prog->localstack_used + c > PRVM_LOCALSTACK_SIZE)
416                 PRVM_ERROR ("PRVM_ExecuteProgram: locals stack overflow in %s", PRVM_NAME);
417
418         for (i=0 ; i < c ; i++)
419                 prog->localstack[prog->localstack_used+i] = ((int *)prog->globals.generic)[f->parm_start + i];
420         prog->localstack_used += c;
421
422 // copy parameters
423         o = f->parm_start;
424         for (i=0 ; i<f->numparms ; i++)
425         {
426                 for (j=0 ; j<f->parm_size[i] ; j++)
427                 {
428                         ((int *)prog->globals.generic)[o] = ((int *)prog->globals.generic)[OFS_PARM0+i*3+j];
429                         o++;
430                 }
431         }
432
433         prog->xfunction = f;
434         return f->first_statement - 1;  // offset the s++
435 }
436
437 /*
438 ====================
439 PRVM_LeaveFunction
440 ====================
441 */
442 int PRVM_LeaveFunction (void)
443 {
444         int             i, c;
445
446         if (prog->depth <= 0)
447                 PRVM_ERROR ("prog stack underflow in %s", PRVM_NAME);
448
449         if (!prog->xfunction)
450                 PRVM_ERROR ("PR_LeaveFunction: NULL function in %s", PRVM_NAME);
451 // restore locals from the stack
452         c = prog->xfunction->locals;
453         prog->localstack_used -= c;
454         if (prog->localstack_used < 0)
455                 PRVM_ERROR ("PRVM_ExecuteProgram: locals stack underflow in %s", PRVM_NAME);
456
457         for (i=0 ; i < c ; i++)
458                 ((int *)prog->globals.generic)[prog->xfunction->parm_start + i] = prog->localstack[prog->localstack_used+i];
459
460 // up stack
461         prog->depth--;
462         prog->xfunction = prog->stack[prog->depth].f;
463         return prog->stack[prog->depth].s;
464 }
465
466 void PRVM_Init_Exec(void)
467 {
468         // dump the stack
469         prog->depth = 0;
470         prog->localstack_used = 0;
471         // reset the string table
472         // nothing here yet
473 }
474
475 /*
476 ====================
477 PRVM_ExecuteProgram
478 ====================
479 */
480 // LordHavoc: optimized
481 #define OPA ((prvm_eval_t *)&prog->globals.generic[(unsigned short) st->a])
482 #define OPB ((prvm_eval_t *)&prog->globals.generic[(unsigned short) st->b])
483 #define OPC ((prvm_eval_t *)&prog->globals.generic[(unsigned short) st->c])
484 extern cvar_t prvm_boundscheck;
485 extern cvar_t prvm_traceqc;
486 extern cvar_t prvm_statementprofiling;
487 extern int              PRVM_ED_FindFieldOffset (const char *field);
488 extern ddef_t*  PRVM_ED_FindGlobal(const char *name);
489 void PRVM_ExecuteProgram (func_t fnum, const char *errormessage)
490 {
491         dstatement_t    *st, *startst;
492         mfunction_t     *f, *newf;
493         prvm_edict_t    *ed;
494         prvm_eval_t     *ptr;
495         int             jumpcount, cachedpr_trace, exitdepth;
496
497         if (!fnum || fnum >= (unsigned int)prog->progs->numfunctions)
498         {
499                 if (prog->self && PRVM_G_INT(prog->self->ofs))
500                         PRVM_ED_Print(PRVM_PROG_TO_EDICT(PRVM_G_INT(prog->self->ofs)));
501                 PRVM_ERROR ("PRVM_ExecuteProgram: %s", errormessage);
502         }
503
504         f = &prog->functions[fnum];
505
506         prog->trace = prvm_traceqc.integer;
507
508         // we know we're done when pr_depth drops to this
509         exitdepth = prog->depth;
510
511 // make a stack frame
512         st = &prog->statements[PRVM_EnterFunction (f)];
513         // save the starting statement pointer for profiling
514         // (when the function exits or jumps, the (st - startst) integer value is
515         // added to the function's profile counter)
516         startst = st;
517         // instead of counting instructions, we count jumps
518         jumpcount = 0;
519         // add one to the callcount of this function because otherwise engine-called functions aren't counted
520         prog->xfunction->callcount++;
521
522 chooseexecprogram:
523         cachedpr_trace = prog->trace;
524         if (prvm_statementprofiling.integer)
525         {
526 #define PRVMSTATEMENTPROFILING 1
527                 if (prvm_boundscheck.integer)
528                 {
529 #define PRVMBOUNDSCHECK 1
530                         if (prog->trace)
531                         {
532 #define PRVMTRACE 1
533 #include "prvm_execprogram.h"
534 #undef PRVMTRACE
535                         }
536                         else
537                         {
538 #include "prvm_execprogram.h"
539                         }
540 #undef PRVMBOUNDSCHECK
541                 }
542                 else
543                 {
544                         if (prog->trace)
545                         {
546 #define PRVMTRACE 1
547 #include "prvm_execprogram.h"
548 #undef PRVMTRACE
549                         }
550                         else
551                         {
552 #include "prvm_execprogram.h"
553                         }
554                 }
555 #undef PRVMSTATEMENTPROFILING
556         }
557         else
558         {
559                 if (prvm_boundscheck.integer)
560                 {
561 #define PRVMBOUNDSCHECK 1
562                         if (prog->trace)
563                         {
564 #define PRVMTRACE 1
565 #include "prvm_execprogram.h"
566 #undef PRVMTRACE
567                         }
568                         else
569                         {
570 #include "prvm_execprogram.h"
571                         }
572 #undef PRVMBOUNDSCHECK
573                 }
574                 else
575                 {
576                         if (prog->trace)
577                         {
578 #define PRVMTRACE 1
579 #include "prvm_execprogram.h"
580 #undef PRVMTRACE
581                         }
582                         else
583                         {
584 #include "prvm_execprogram.h"
585                         }
586                 }
587         }
588 }