simgear/nasal/code.c

   1 #include "nasal.h"
   2 #include "code.h"
   3
   4 ////////////////////////////////////////////////////////////////////////
   5 // Debugging stuff. ////////////////////////////////////////////////////
   6 ////////////////////////////////////////////////////////////////////////
   7 //#define DEBUG_NASAL
   8 #if !defined(DEBUG_NASAL)
   9 # define DBG(expr) /* noop */
  10 #else
  11 # define DBG(expr) expr
  12 # include <stdio.h>
  13 # include <stdlib.h>
  14 #endif
  15 char* opStringDEBUG(int op);
  16 void printOpDEBUG(int ip, int op);
  17 void printStackDEBUG(struct Context* ctx);
  18 ////////////////////////////////////////////////////////////////////////
  19
  20 struct Globals* globals = 0;
  21
  22 static naRef bindFunction(struct Context* ctx, struct Frame* f, naRef code);
  23
  24 #define ERR(c, msg) naRuntimeError((c),(msg))
  25 void naRuntimeError(struct Context* c, char* msg)
  26 {
  27     c->error = msg;
  28     longjmp(c->jumpHandle, 1);
  29 }
  30
  31 static int boolify(struct Context* ctx, naRef r)
  32 {
  33     if(IS_NUM(r)) return r.num != 0;
  34     if(IS_NIL(r)) return 0;
  35     if(IS_STR(r)) {
  36         double d;
  37         if(naStr_len(r) == 0) return 0;
  38         if(naStr_tonum(r, &d)) return d != 0;
  39         else return 1;
  40     }
  41     ERR(ctx, "non-scalar used in boolean context");
  42     return 0;
  43 }
  44
  45 static double numify(struct Context* ctx, naRef o)
  46 {
  47     double n;
  48     if(IS_NUM(o)) return o.num;
  49     else if(IS_NIL(o)) ERR(ctx, "nil used in numeric context");
  50     else if(!IS_STR(o)) ERR(ctx, "non-scalar in numeric context");
  51     else if(naStr_tonum(o, &n)) return n;
  52     else ERR(ctx, "non-numeric string in numeric context");
  53     return 0;
  54 }
  55
  56 static naRef stringify(struct Context* ctx, naRef r)
  57 {
  58     if(IS_STR(r)) return r;
  59     if(IS_NUM(r)) return naStr_fromnum(naNewString(ctx), r.num);
  60     ERR(ctx, "non-scalar in string context");
  61     return naNil();
  62 }
  63
  64 static int checkVec(struct Context* ctx, naRef vec, naRef idx)
  65 {
  66     int i = (int)numify(ctx, idx);
  67     if(i < 0) i += naVec_size(vec);
  68     if(i < 0 || i >= naVec_size(vec)) ERR(ctx, "vector index out of bounds");
  69     return i;
  70 }
  71
  72 static int checkStr(struct Context* ctx, naRef str, naRef idx)
  73 {
  74     int i = (int)numify(ctx, idx);
  75     if(i < 0) i += naStr_len(str);
  76     if(i < 0 || i >= naStr_len(str)) ERR(ctx, "string index out of bounds");
  77     return i;
  78 }
  79
  80 static naRef containerGet(struct Context* ctx, naRef box, naRef key)
  81 {
  82     naRef result = naNil();
  83     if(!IS_SCALAR(key)) ERR(ctx, "container index not scalar");
  84     if(IS_HASH(box)) {
  85         if(!naHash_get(box, key, &result))
  86             ERR(ctx, "undefined value in container");
  87     } else if(IS_VEC(box)) {
  88         result = naVec_get(box, checkVec(ctx, box, key));
  89     } else if(IS_STR(box)) {
  90         result = naNum((unsigned char)naStr_data(box)[checkStr(ctx, box, key)]);
  91     } else {
  92         ERR(ctx, "extract from non-container");
  93     }
  94     return result;
  95 }
  96
  97 static void containerSet(struct Context* ctx, naRef box, naRef key, naRef val)
  98 {
  99     if(!IS_SCALAR(key))   ERR(ctx, "container index not scalar");
 100     else if(IS_HASH(box)) naHash_set(box, key, val);
 101     else if(IS_VEC(box))  naVec_set(box, checkVec(ctx, box, key), val);
 102     else if(IS_STR(box)) {
 103         if(box.ref.ptr.str->hashcode)
 104             ERR(ctx, "cannot change immutable string");
 105         naStr_data(box)[checkStr(ctx, box, key)] = (char)numify(ctx, val);
 106     } else ERR(ctx, "insert into non-container");
 107 }
 108
 109 static void initTemps(struct Context* c)
 110 {
 111     c->tempsz = 4;
 112     c->temps = naAlloc(c->tempsz * sizeof(struct naObj*));
 113     c->ntemps = 0;
 114 }
 115
 116 static void initContext(struct Context* c)
 117 {
 118     int i;
 119     c->fTop = c->opTop = c->markTop = 0;
 120     for(i=0; i<NUM_NASAL_TYPES; i++)
 121         c->nfree[i] = 0;
 122
 123     if(c->tempsz > 32) {
 124         naFree(c->temps);
 125         initTemps(c);
 126     }
 127
 128     c->callParent = 0;
 129     c->callChild = 0;
 130     c->dieArg = naNil();
 131     c->error = 0;
 132 }
 133
 134 static void initGlobals()
 135 {
 136     int i;
 137     struct Context* c;
 138     globals = (struct Globals*)naAlloc(sizeof(struct Globals));
 139     naBZero(globals, sizeof(struct Globals));
 140
 141     globals->sem = naNewSem();
 142     globals->lock = naNewLock();
 143
 144     globals->allocCount = 256; // reasonable starting value
 145     for(i=0; i<NUM_NASAL_TYPES; i++)
 146         naGC_init(&(globals->pools[i]), i);
 147     globals->deadsz = 256;
 148     globals->ndead = 0;
 149     globals->deadBlocks = naAlloc(sizeof(void*) * globals->deadsz);
 150
 151     // Initialize a single context
 152     globals->freeContexts = 0;
 153     globals->allContexts = 0;
 154     c = naNewContext();
 155
 156     globals->symbols = naNewHash(c);
 157     globals->save = naNewVector(c);
 158
 159     // Cache pre-calculated "me", "arg" and "parents" scalars
 160     globals->meRef = naInternSymbol(naStr_fromdata(naNewString(c), "me", 2));
 161     globals->argRef = naInternSymbol(naStr_fromdata(naNewString(c), "arg", 3));
 162     globals->parentsRef = naInternSymbol(naStr_fromdata(naNewString(c), "parents", 7));
 163
 164     naFreeContext(c);
 165 }
 166
 167 struct Context* naNewContext()
 168 {
 169     struct Context* c;
 170     if(globals == 0)
 171         initGlobals();
 172
 173     LOCK();
 174     c = globals->freeContexts;
 175     if(c) {
 176         globals->freeContexts = c->nextFree;
 177         c->nextFree = 0;
 178         UNLOCK();
 179         initContext(c);
 180     } else {
 181         UNLOCK();
 182         c = (struct Context*)naAlloc(sizeof(struct Context));
 183         initTemps(c);
 184         initContext(c);
 185         LOCK();
 186         c->nextAll = globals->allContexts;
 187         c->nextFree = 0;
 188         globals->allContexts = c;
 189         UNLOCK();
 190     }
 191     return c;
 192 }
 193
 194 void naFreeContext(struct Context* c)
 195 {
 196     c->ntemps = 0;
 197     LOCK();
 198     c->nextFree = globals->freeContexts;
 199     globals->freeContexts = c;
 200     UNLOCK();
 201 }
 202
 203 // Note that opTop is incremented separately, to avoid situations
 204 // where the "r" expression also references opTop.  The SGI compiler
 205 // is known to have issues with such code.
 206 #define PUSH(r) do { \
 207     if(ctx->opTop >= MAX_STACK_DEPTH) ERR(ctx, "stack overflow"); \
 208     ctx->opStack[ctx->opTop] = r; \
 209     ctx->opTop++;                 \
 210     } while(0)
 211
 212 static void setupArgs(naContext ctx, struct Frame* f, naRef* args, int nargs)
 213 {
 214     int i;
 215     struct naCode* c = f->func.ref.ptr.func->code.ref.ptr.code;
 216
 217     // Set the argument symbols, and put any remaining args in a vector
 218     if(nargs < c->nArgs) ERR(ctx, "not enough arguments to function call");
 219     for(i=0; i<c->nArgs; i++)
 220         naHash_newsym(f->locals.ref.ptr.hash,
 221                       &c->constants[c->argSyms[i]], &args[i]);
 222     args += c->nArgs;
 223     nargs -= c->nArgs;
 224     for(i=0; i<c->nOptArgs; i++, nargs--) {
 225         naRef val = nargs > 0 ? args[i] : c->constants[c->optArgVals[i]];
 226         if(IS_CODE(val))
 227             val = bindFunction(ctx, &ctx->fStack[ctx->fTop-2], val);
 228         naHash_newsym(f->locals.ref.ptr.hash, &c->constants[c->optArgSyms[i]],
 229                       &val);
 230     }
 231     args += c->nOptArgs;
 232     if(c->needArgVector || nargs > 0) {
 233         naRef argsv = naNewVector(ctx);
 234         naVec_setsize(argsv, nargs > 0 ? nargs : 0);
 235         for(i=0; i<nargs; i++)
 236             argsv.ref.ptr.vec->rec->array[i] = *args++;
 237         naHash_newsym(f->locals.ref.ptr.hash, &c->restArgSym, &argsv);
 238     }
 239 }
 240
 241 struct Frame* setupFuncall(struct Context* ctx, int nargs, int mcall, int tail)
 242 {
 243     naRef *frame;
 244     struct Frame* f;
 245
 246     DBG(printf("setupFuncall(nargs:%d, mcall:%d)\n", nargs, mcall);)
 247
 248     frame = &ctx->opStack[ctx->opTop - nargs - 1];
 249     if(!IS_FUNC(frame[0]))
 250         ERR(ctx, "function/method call invoked on uncallable object");
 251
 252     // Just do native calls right here, and don't touch the stack
 253     // frames; return the current one (unless it's a tail call!).
 254     if(frame[0].ref.ptr.func->code.ref.ptr.obj->type == T_CCODE) {
 255         naRef obj = mcall ? frame[-1] : naNil();
 256         naCFunction fp = frame[0].ref.ptr.func->code.ref.ptr.ccode->fptr;
 257         naRef result = (*fp)(ctx, obj, nargs, frame + 1);
 258         ctx->opTop -= nargs + 1 + mcall;
 259         PUSH(result);
 260         return &(ctx->fStack[ctx->fTop-1]);
 261     }
 262
 263     if(tail) ctx->fTop--;
 264     else if(ctx->fTop >= MAX_RECURSION) ERR(ctx, "call stack overflow");
 265
 266     // Note: assign nil first, otherwise the naNew() can cause a GC,
 267     // which will now (after fTop++) see the *old* reference as a
 268     // markable value!
 269     f = &(ctx->fStack[ctx->fTop++]);
 270     f->locals = f->func = naNil();
 271     f->locals = naNewHash(ctx);
 272     f->func = frame[0];
 273     f->ip = 0;
 274     f->bp = ctx->opTop - (nargs + 1 + mcall);
 275
 276     if(mcall)
 277         naHash_set(f->locals, globals->meRef, frame[-1]);
 278
 279     setupArgs(ctx, f, frame+1, nargs);
 280
 281     ctx->opTop = f->bp; // Pop the stack last, to avoid GC lossage
 282     DBG(printf("Entering frame %d with %d args\n", ctx->fTop-1, nargs);)
 283     return f;
 284 }
 285
 286 static naRef evalAndOr(struct Context* ctx, int op, naRef ra, naRef rb)
 287 {
 288     int a = boolify(ctx, ra);
 289     int b = boolify(ctx, rb);
 290     int result;
 291     if(op == OP_AND) result = a && b ? 1 : 0;
 292     else             result = a || b ? 1 : 0;
 293     return naNum(result);
 294 }
 295
 296 static naRef evalEquality(int op, naRef ra, naRef rb)
 297 {
 298     int result = naEqual(ra, rb);
 299     return naNum((op==OP_EQ) ? result : !result);
 300 }
 301
 302 // When a code object comes out of the constant pool and shows up on
 303 // the stack, it needs to be bound with the lexical context.
 304 static naRef bindFunction(struct Context* ctx, struct Frame* f, naRef code)
 305 {
 306     naRef result = naNewFunc(ctx, code);
 307     result.ref.ptr.func->namespace = f->locals;
 308     result.ref.ptr.func->next = f->func;
 309     return result;
 310 }
 311
 312 static int getClosure(struct naFunc* c, naRef sym, naRef* result)
 313 {
 314     while(c) {
 315         if(naHash_get(c->namespace, sym, result)) return 1;
 316         c = c->next.ref.ptr.func;
 317     }
 318     return 0;
 319 }
 320
 321 static naRef getLocal2(struct Context* ctx, struct Frame* f, naRef sym)
 322 {
 323     naRef result;
 324     if(!naHash_get(f->locals, sym, &result))
 325         if(!getClosure(f->func.ref.ptr.func, sym, &result))
 326             ERR(ctx, "undefined symbol");
 327     return result;
 328 }
 329
 330 static void getLocal(struct Context* ctx, struct Frame* f,
 331                      naRef* sym, naRef* out)
 332 {
 333     struct naFunc* func;
 334     struct naStr* str = sym->ref.ptr.str;
 335     if(naHash_sym(f->locals.ref.ptr.hash, str, out))
 336         return;
 337     func = f->func.ref.ptr.func;
 338     while(func && func->namespace.ref.ptr.hash) {
 339         if(naHash_sym(func->namespace.ref.ptr.hash, str, out))
 340             return;
 341         func = func->next.ref.ptr.func;
 342     }
 343     // Now do it again using the more general naHash_get().  This will
 344     // only be necessary if something has created the value in the
 345     // namespace using the more generic hash syntax
 346     // (e.g. namespace["symbol"] and not namespace.symbol).
 347     *out = getLocal2(ctx, f, *sym);
 348 }
 349
 350 static int setClosure(naRef func, naRef sym, naRef val)
 351 {
 352     struct naFunc* c = func.ref.ptr.func;
 353     if(c == 0) { return 0; }
 354     else if(naHash_tryset(c->namespace, sym, val)) { return 1; }
 355     else { return setClosure(c->next, sym, val); }
 356 }
 357
 358 static naRef setSymbol(struct Frame* f, naRef sym, naRef val)
 359 {
 360     // Try the locals first, if not already there try the closures in
 361     // order.  Finally put it in the locals if nothing matched.
 362     if(!naHash_tryset(f->locals, sym, val))
 363         if(!setClosure(f->func, sym, val))
 364             naHash_set(f->locals, sym, val);
 365     return val;
 366 }
 367
 368 // Recursively descend into the parents lists
 369 static int getMember(struct Context* ctx, naRef obj, naRef fld,
 370                      naRef* result, int count)
 371 {
 372     naRef p;
 373     if(--count < 0) ERR(ctx, "too many parents");
 374     if(!IS_HASH(obj)) ERR(ctx, "non-objects have no members");
 375     if(naHash_get(obj, fld, result)) {
 376         return 1;
 377     } else if(naHash_get(obj, globals->parentsRef, &p)) {
 378         if(IS_VEC(p)) {
 379             int i;
 380             struct VecRec* v = p.ref.ptr.vec->rec;
 381             for(i=0; i<v->size; i++)
 382                 if(getMember(ctx, v->array[i], fld, result, count))
 383                     return 1;
 384         } else
 385             ERR(ctx, "parents field not vector");
 386     }
 387     return 0;
 388 }
 389
 390 // OP_EACH works like a vector get, except that it leaves the vector
 391 // and index on the stack, increments the index after use, and
 392 // pushes a nil if the index is beyond the end.
 393 static void evalEach(struct Context* ctx, int useIndex)
 394 {
 395     int idx = (int)(ctx->opStack[ctx->opTop-1].num);
 396     naRef vec = ctx->opStack[ctx->opTop-2];
 397     if(!IS_VEC(vec)) naRuntimeError(ctx, "foreach enumeration of non-vector");
 398     if(!vec.ref.ptr.vec->rec || idx >= vec.ref.ptr.vec->rec->size) {
 399         PUSH(naNil());
 400         return;
 401     }
 402     ctx->opStack[ctx->opTop-1].num = idx+1; // modify in place
 403     PUSH(useIndex ? naNum(idx) : naVec_get(vec, idx));
 404 }
 405
 406 #define ARG() cd->byteCode[f->ip++]
 407 #define CONSTARG() cd->constants[ARG()]
 408 #define POP() ctx->opStack[--ctx->opTop]
 409 #define STK(n) (ctx->opStack[ctx->opTop-(n)])
 410 #define FIXFRAME() f = &(ctx->fStack[ctx->fTop-1]); \
 411                    cd = f->func.ref.ptr.func->code.ref.ptr.code;
 412 static naRef run(struct Context* ctx)
 413 {
 414     struct Frame* f;
 415     struct naCode* cd;
 416     int op, arg;
 417     naRef a, b, c;
 418
 419     FIXFRAME();
 420
 421     while(1) {
 422         op = cd->byteCode[f->ip++];
 423         DBG(printf("Stack Depth: %d\n", ctx->opTop));
 424         DBG(printOpDEBUG(f->ip-1, op));
 425         switch(op) {
 426         case OP_POP:
 427             ctx->opTop--;
 428             break;
 429         case OP_DUP:
 430             PUSH(ctx->opStack[ctx->opTop-1]);
 431             break;
 432         case OP_DUP2:
 433             PUSH(ctx->opStack[ctx->opTop-2]);
 434             PUSH(ctx->opStack[ctx->opTop-2]);
 435             break;
 436         case OP_XCHG:
 437             a = STK(1); STK(1) = STK(2); STK(2) = a;
 438             break;
 439
 440 #define BINOP(expr) do { \
 441     double l = IS_NUM(STK(2)) ? STK(2).num : numify(ctx, STK(2)); \
 442     double r = IS_NUM(STK(1)) ? STK(1).num : numify(ctx, STK(1)); \
 443     STK(2).ref.reftag = ~NASAL_REFTAG; \
 444     STK(2).num = expr; \
 445     ctx->opTop--; } while(0)
 446
 447         case OP_PLUS:  BINOP(l + r);         break;
 448         case OP_MINUS: BINOP(l - r);         break;
 449         case OP_MUL:   BINOP(l * r);         break;
 450         case OP_DIV:   BINOP(l / r);         break;
 451         case OP_LT:    BINOP(l <  r ? 1 : 0); break;
 452         case OP_LTE:   BINOP(l <= r ? 1 : 0); break;
 453         case OP_GT:    BINOP(l >  r ? 1 : 0); break;
 454         case OP_GTE:   BINOP(l >= r ? 1 : 0); break;
 455
 456 #undef BINOP
 457
 458         case OP_EQ: case OP_NEQ:
 459             STK(2) = evalEquality(op, STK(2), STK(1));
 460             ctx->opTop--;
 461             break;
 462         case OP_AND: case OP_OR:
 463             STK(2) = evalAndOr(ctx, op, STK(2), STK(1));
 464             ctx->opTop--;
 465             break;
 466         case OP_CAT:
 467             // stringify can call the GC, so don't take stuff of the stack!
 468             a = stringify(ctx, ctx->opStack[ctx->opTop-1]);
 469             b = stringify(ctx, ctx->opStack[ctx->opTop-2]);
 470             c = naStr_concat(naNewString(ctx), b, a);
 471             ctx->opTop -= 2;
 472             PUSH(c);
 473             break;
 474         case OP_NEG:
 475             STK(1) = naNum(-numify(ctx, STK(1)));
 476             break;
 477         case OP_NOT:
 478             STK(1) = naNum(boolify(ctx, STK(1)) ? 0 : 1);
 479             break;
 480         case OP_PUSHCONST:
 481             a = CONSTARG();
 482             if(IS_CODE(a)) a = bindFunction(ctx, f, a);
 483             PUSH(a);
 484             break;
 485         case OP_PUSHONE:
 486             PUSH(naNum(1));
 487             break;
 488         case OP_PUSHZERO:
 489             PUSH(naNum(0));
 490             break;
 491         case OP_PUSHNIL:
 492             PUSH(naNil());
 493             break;
 494         case OP_NEWVEC:
 495             PUSH(naNewVector(ctx));
 496             break;
 497         case OP_VAPPEND:
 498             naVec_append(STK(2), STK(1));
 499             ctx->opTop--;
 500             break;
 501         case OP_NEWHASH:
 502             PUSH(naNewHash(ctx));
 503             break;
 504         case OP_HAPPEND:
 505             naHash_set(STK(3), STK(2), STK(1));
 506             ctx->opTop -= 2;
 507             break;
 508         case OP_LOCAL:
 509             a = CONSTARG();
 510             getLocal(ctx, f, &a, &b);
 511             PUSH(b);
 512             break;
 513         case OP_SETSYM:
 514             STK(2) = setSymbol(f, STK(2), STK(1));
 515             ctx->opTop--;
 516             break;
 517         case OP_SETLOCAL:
 518             naHash_set(f->locals, STK(2), STK(1));
 519             STK(2) = STK(1); // FIXME: reverse order of arguments instead!
 520             ctx->opTop--;
 521             break;
 522         case OP_MEMBER:
 523             if(!getMember(ctx, STK(1), CONSTARG(), &STK(1), 64))
 524                 ERR(ctx, "no such member");
 525             break;
 526         case OP_SETMEMBER:
 527             if(!IS_HASH(STK(3))) ERR(ctx, "non-objects have no members");
 528             naHash_set(STK(3), STK(2), STK(1));
 529             STK(3) = STK(1); // FIXME: fix arg order instead
 530             ctx->opTop -= 2;
 531             break;
 532         case OP_INSERT:
 533             containerSet(ctx, STK(3), STK(2), STK(1));
 534             STK(3) = STK(1); // FIXME: codegen order again...
 535             ctx->opTop -= 2;
 536             break;
 537         case OP_EXTRACT:
 538             STK(2) = containerGet(ctx, STK(2), STK(1));
 539             ctx->opTop--;
 540             break;
 541         case OP_JMPLOOP:
 542             // Identical to JMP, except for locking
 543             naCheckBottleneck();
 544             f->ip = cd->byteCode[f->ip];
 545             DBG(printf("   [Jump to: %d]\n", f->ip);)
 546             break;
 547         case OP_JMP:
 548             f->ip = cd->byteCode[f->ip];
 549             DBG(printf("   [Jump to: %d]\n", f->ip);)
 550             break;
 551         case OP_JIFNIL:
 552             arg = ARG();
 553             if(IS_NIL(STK(1))) {
 554                 ctx->opTop--; // Pops **ONLY** if it's nil!
 555                 f->ip = arg;
 556                 DBG(printf("   [Jump to: %d]\n", f->ip);)
 557             }
 558             break;
 559         case OP_JIFNOT:
 560             arg = ARG();
 561             if(!boolify(ctx, POP())) {
 562                 f->ip = arg;
 563                 DBG(printf("   [Jump to: %d]\n", f->ip);)
 564             }
 565             break;
 566         case OP_FCALL:
 567             f = setupFuncall(ctx, ARG(), 0, 0);
 568             cd = f->func.ref.ptr.func->code.ref.ptr.code;
 569             break;
 570         case OP_FTAIL:
 571             f = setupFuncall(ctx, ARG(), 0, 1);
 572             cd = f->func.ref.ptr.func->code.ref.ptr.code;
 573             break;
 574         case OP_MCALL:
 575             f = setupFuncall(ctx, ARG(), 1, 0);
 576             cd = f->func.ref.ptr.func->code.ref.ptr.code;
 577             break;
 578         case OP_MTAIL:
 579             f = setupFuncall(ctx, ARG(), 1, 1);
 580             cd = f->func.ref.ptr.func->code.ref.ptr.code;
 581             break;
 582         case OP_RETURN:
 583             a = STK(1);
 584             if(--ctx->fTop <= 0) return a;
 585             ctx->opTop = f->bp + 1; // restore the correct opstack frame!
 586             STK(1) = a;
 587             FIXFRAME();
 588             break;
 589         case OP_EACH:
 590             evalEach(ctx, 0);
 591             break;
 592         case OP_INDEX:
 593             evalEach(ctx, 1);
 594             break;
 595         case OP_MARK: // save stack state (e.g. "setjmp")
 596             if(ctx->markTop >= MAX_MARK_DEPTH)
 597                 naRuntimeError(ctx, "mark stack overflow");
 598             ctx->markStack[ctx->markTop++] = ctx->opTop;
 599             break;
 600         case OP_UNMARK: // pop stack state set by mark
 601             ctx->markTop--;
 602             break;
 603         case OP_BREAK: // restore stack state (FOLLOW WITH JMP!)
 604             ctx->opTop = ctx->markStack[ctx->markTop-1];
 605             break;
 606         case OP_BREAK2: // same, but also pop the mark stack
 607             ctx->opTop = ctx->markStack[--ctx->markTop];
 608             break;
 609         default:
 610             ERR(ctx, "BUG: bad opcode");
 611         }
 612         ctx->ntemps = 0; // reset GC temp vector
 613         DBG(printStackDEBUG(ctx);)
 614     }
 615     return naNil(); // unreachable
 616 }
 617 #undef POP
 618 #undef CONSTARG
 619 #undef STK
 620 #undef FIXFRAME
 621
 622 void naSave(struct Context* ctx, naRef obj)
 623 {
 624     naVec_append(globals->save, obj);
 625 }
 626
 627 // FIXME: handle ctx->callParent
 628 int naStackDepth(struct Context* ctx)
 629 {
 630     return ctx->fTop;
 631 }
 632
 633 // FIXME: handle ctx->callParent
 634 int naGetLine(struct Context* ctx, int frame)
 635 {
 636     struct Frame* f = &ctx->fStack[ctx->fTop-1-frame];
 637     naRef func = f->func;
 638     int ip = f->ip;
 639     if(IS_FUNC(func) && IS_CODE(func.ref.ptr.func->code)) {
 640         struct naCode* c = func.ref.ptr.func->code.ref.ptr.code;
 641         unsigned short* p = c->lineIps + c->nLines - 2;
 642         while(p >= c->lineIps && p[0] > ip)
 643             p -= 2;
 644         return p[1];
 645     }
 646     return -1;
 647 }
 648
 649 // FIXME: handle ctx->callParent
 650 naRef naGetSourceFile(struct Context* ctx, int frame)
 651 {
 652     naRef f = ctx->fStack[ctx->fTop-1-frame].func;
 653     f = f.ref.ptr.func->code;
 654     return f.ref.ptr.code->srcFile;
 655 }
 656
 657 char* naGetError(struct Context* ctx)
 658 {
 659     if(IS_STR(ctx->dieArg))
 660         return (char*)ctx->dieArg.ref.ptr.str->data;
 661     return ctx->error;
 662 }
 663
 664 naRef naBindFunction(naContext ctx, naRef code, naRef closure)
 665 {
 666     naRef func = naNewFunc(ctx, code);
 667     func.ref.ptr.func->namespace = closure;
 668     func.ref.ptr.func->next = naNil();
 669     return func;
 670 }
 671
 672 naRef naBindToContext(naContext ctx, naRef code)
 673 {
 674     naRef func = naNewFunc(ctx, code);
 675     struct Frame* f = &ctx->fStack[ctx->fTop-1];
 676     func.ref.ptr.func->namespace = f->locals;
 677     func.ref.ptr.func->next = f->func;
 678     return func;
 679 }
 680
 681 naRef naCall(naContext ctx, naRef func, int argc, naRef* args,
 682              naRef obj, naRef locals)
 683 {
 684     int i;
 685     naRef result;
 686     if(!ctx->callParent) naModLock(ctx);
 687
 688     // We might have to allocate objects, which can call the GC.  But
 689     // the call isn't on the Nasal stack yet, so the GC won't find our
 690     // C-space arguments.
 691     naTempSave(ctx, func);
 692     for(i=0; i<argc; i++)
 693         naTempSave(ctx, args[i]);
 694     naTempSave(ctx, obj);
 695     naTempSave(ctx, locals);
 696
 697     if(IS_CCODE(func.ref.ptr.func->code)) {
 698         naCFunction fp = func.ref.ptr.func->code.ref.ptr.ccode->fptr;
 699         result = (*fp)(ctx, obj, argc, args);
 700         if(!ctx->callParent) naModUnlock(ctx);
 701         return result;
 702     }
 703
 704     if(IS_NIL(locals))
 705         locals = naNewHash(ctx);
 706     if(!IS_FUNC(func))
 707         func = naNewFunc(ctx, func); // bind bare code objects
 708     if(!IS_NIL(obj))
 709         naHash_set(locals, globals->meRef, obj);
 710
 711     ctx->dieArg = naNil();
 712
 713     ctx->opTop = ctx->markTop = 0;
 714     ctx->fTop = 1;
 715     ctx->fStack[0].func = func;
 716     ctx->fStack[0].locals = locals;
 717     ctx->fStack[0].ip = 0;
 718     ctx->fStack[0].bp = ctx->opTop;
 719
 720     setupArgs(ctx, ctx->fStack, args, argc);
 721
 722     // Return early if an error occurred.  It will be visible to the
 723     // caller via naGetError().
 724     ctx->error = 0;
 725     if(setjmp(ctx->jumpHandle)) {
 726         if(!ctx->callParent) naModUnlock(ctx);
 727         return naNil();
 728     }
 729
 730     result = run(ctx);
 731     if(!ctx->callParent) naModUnlock(ctx);
 732     return result;
 733 }
 734