Coverage Report

Created: 2023-09-15 06:13

/src/testdir/build/lua-master/source/ldebug.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
** $Id: ldebug.c $
3
** Debug Interface
4
** See Copyright Notice in lua.h
5
*/
6
7
#define ldebug_c
8
#define LUA_CORE
9
10
#include "lprefix.h"
11
12
13
#include <stdarg.h>
14
#include <stddef.h>
15
#include <string.h>
16
17
#include "lua.h"
18
19
#include "lapi.h"
20
#include "lcode.h"
21
#include "ldebug.h"
22
#include "ldo.h"
23
#include "lfunc.h"
24
#include "lobject.h"
25
#include "lopcodes.h"
26
#include "lstate.h"
27
#include "lstring.h"
28
#include "ltable.h"
29
#include "ltm.h"
30
#include "lvm.h"
31
32
33
34
0
#define noLuaClosure(f)   ((f) == NULL || (f)->c.tt == LUA_VCCL)
35
36
37
static const char *funcnamefromcall (lua_State *L, CallInfo *ci,
38
                                                   const char **name);
39
40
41
0
static int currentpc (CallInfo *ci) {
42
0
  lua_assert(isLua(ci));
43
0
  return pcRel(ci->u.l.savedpc, ci_func(ci)->p);
44
0
}
45
46
47
/*
48
** Get a "base line" to find the line corresponding to an instruction.
49
** Base lines are regularly placed at MAXIWTHABS intervals, so usually
50
** an integer division gets the right place. When the source file has
51
** large sequences of empty/comment lines, it may need extra entries,
52
** so the original estimate needs a correction.
53
** If the original estimate is -1, the initial 'if' ensures that the
54
** 'while' will run at least once.
55
** The assertion that the estimate is a lower bound for the correct base
56
** is valid as long as the debug info has been generated with the same
57
** value for MAXIWTHABS or smaller. (Previous releases use a little
58
** smaller value.)
59
*/
60
0
static int getbaseline (const Proto *f, int pc, int *basepc) {
61
0
  if (f->sizeabslineinfo == 0 || pc < f->abslineinfo[0].pc) {
62
0
    *basepc = -1;  /* start from the beginning */
63
0
    return f->linedefined;
64
0
  }
65
0
  else {
66
0
    int i = cast_uint(pc) / MAXIWTHABS - 1;  /* get an estimate */
67
    /* estimate must be a lower bound of the correct base */
68
0
    lua_assert(i < 0 ||
69
0
              (i < f->sizeabslineinfo && f->abslineinfo[i].pc <= pc));
70
0
    while (i + 1 < f->sizeabslineinfo && pc >= f->abslineinfo[i + 1].pc)
71
0
      i++;  /* low estimate; adjust it */
72
0
    *basepc = f->abslineinfo[i].pc;
73
0
    return f->abslineinfo[i].line;
74
0
  }
75
0
}
76
77
78
/*
79
** Get the line corresponding to instruction 'pc' in function 'f';
80
** first gets a base line and from there does the increments until
81
** the desired instruction.
82
*/
83
0
int luaG_getfuncline (const Proto *f, int pc) {
84
0
  if (f->lineinfo == NULL)  /* no debug information? */
85
0
    return -1;
86
0
  else {
87
0
    int basepc;
88
0
    int baseline = getbaseline(f, pc, &basepc);
89
0
    while (basepc++ < pc) {  /* walk until given instruction */
90
0
      lua_assert(f->lineinfo[basepc] != ABSLINEINFO);
91
0
      baseline += f->lineinfo[basepc];  /* correct line */
92
0
    }
93
0
    return baseline;
94
0
  }
95
0
}
96
97
98
0
static int getcurrentline (CallInfo *ci) {
99
0
  return luaG_getfuncline(ci_func(ci)->p, currentpc(ci));
100
0
}
101
102
103
/*
104
** Set 'trap' for all active Lua frames.
105
** This function can be called during a signal, under "reasonable"
106
** assumptions. A new 'ci' is completely linked in the list before it
107
** becomes part of the "active" list, and we assume that pointers are
108
** atomic; see comment in next function.
109
** (A compiler doing interprocedural optimizations could, theoretically,
110
** reorder memory writes in such a way that the list could be
111
** temporarily broken while inserting a new element. We simply assume it
112
** has no good reasons to do that.)
113
*/
114
0
static void settraps (CallInfo *ci) {
115
0
  for (; ci != NULL; ci = ci->previous)
116
0
    if (isLua(ci))
117
0
      ci->u.l.trap = 1;
118
0
}
119
120
121
/*
122
** This function can be called during a signal, under "reasonable"
123
** assumptions.
124
** Fields 'basehookcount' and 'hookcount' (set by 'resethookcount')
125
** are for debug only, and it is no problem if they get arbitrary
126
** values (causes at most one wrong hook call). 'hookmask' is an atomic
127
** value. We assume that pointers are atomic too (e.g., gcc ensures that
128
** for all platforms where it runs). Moreover, 'hook' is always checked
129
** before being called (see 'luaD_hook').
130
*/
131
0
LUA_API void lua_sethook (lua_State *L, lua_Hook func, int mask, int count) {
132
0
  if (func == NULL || mask == 0) {  /* turn off hooks? */
133
0
    mask = 0;
134
0
    func = NULL;
135
0
  }
136
0
  L->hook = func;
137
0
  L->basehookcount = count;
138
0
  resethookcount(L);
139
0
  L->hookmask = cast_byte(mask);
140
0
  if (mask)
141
0
    settraps(L->ci);  /* to trace inside 'luaV_execute' */
142
0
}
143
144
145
0
LUA_API lua_Hook lua_gethook (lua_State *L) {
146
0
  return L->hook;
147
0
}
148
149
150
0
LUA_API int lua_gethookmask (lua_State *L) {
151
0
  return L->hookmask;
152
0
}
153
154
155
0
LUA_API int lua_gethookcount (lua_State *L) {
156
0
  return L->basehookcount;
157
0
}
158
159
160
0
LUA_API int lua_getstack (lua_State *L, int level, lua_Debug *ar) {
161
0
  int status;
162
0
  CallInfo *ci;
163
0
  if (level < 0) return 0;  /* invalid (negative) level */
164
0
  lua_lock(L);
165
0
  for (ci = L->ci; level > 0 && ci != &L->base_ci; ci = ci->previous)
166
0
    level--;
167
0
  if (level == 0 && ci != &L->base_ci) {  /* level found? */
168
0
    status = 1;
169
0
    ar->i_ci = ci;
170
0
  }
171
0
  else status = 0;  /* no such level */
172
0
  lua_unlock(L);
173
0
  return status;
174
0
}
175
176
177
0
static const char *upvalname (const Proto *p, int uv) {
178
0
  TString *s = check_exp(uv < p->sizeupvalues, p->upvalues[uv].name);
179
0
  if (s == NULL) return "?";
180
0
  else return getstr(s);
181
0
}
182
183
184
0
static const char *findvararg (CallInfo *ci, int n, StkId *pos) {
185
0
  if (clLvalue(s2v(ci->func.p))->p->is_vararg) {
186
0
    int nextra = ci->u.l.nextraargs;
187
0
    if (n >= -nextra) {  /* 'n' is negative */
188
0
      *pos = ci->func.p - nextra - (n + 1);
189
0
      return "(vararg)";  /* generic name for any vararg */
190
0
    }
191
0
  }
192
0
  return NULL;  /* no such vararg */
193
0
}
194
195
196
0
const char *luaG_findlocal (lua_State *L, CallInfo *ci, int n, StkId *pos) {
197
0
  StkId base = ci->func.p + 1;
198
0
  const char *name = NULL;
199
0
  if (isLua(ci)) {
200
0
    if (n < 0)  /* access to vararg values? */
201
0
      return findvararg(ci, n, pos);
202
0
    else
203
0
      name = luaF_getlocalname(ci_func(ci)->p, n, currentpc(ci));
204
0
  }
205
0
  if (name == NULL) {  /* no 'standard' name? */
206
0
    StkId limit = (ci == L->ci) ? L->top.p : ci->next->func.p;
207
0
    if (limit - base >= n && n > 0) {  /* is 'n' inside 'ci' stack? */
208
      /* generic name for any valid slot */
209
0
      name = isLua(ci) ? "(temporary)" : "(C temporary)";
210
0
    }
211
0
    else
212
0
      return NULL;  /* no name */
213
0
  }
214
0
  if (pos)
215
0
    *pos = base + (n - 1);
216
0
  return name;
217
0
}
218
219
220
0
LUA_API const char *lua_getlocal (lua_State *L, const lua_Debug *ar, int n) {
221
0
  const char *name;
222
0
  lua_lock(L);
223
0
  if (ar == NULL) {  /* information about non-active function? */
224
0
    if (!isLfunction(s2v(L->top.p - 1)))  /* not a Lua function? */
225
0
      name = NULL;
226
0
    else  /* consider live variables at function start (parameters) */
227
0
      name = luaF_getlocalname(clLvalue(s2v(L->top.p - 1))->p, n, 0);
228
0
  }
229
0
  else {  /* active function; get information through 'ar' */
230
0
    StkId pos = NULL;  /* to avoid warnings */
231
0
    name = luaG_findlocal(L, ar->i_ci, n, &pos);
232
0
    if (name) {
233
0
      setobjs2s(L, L->top.p, pos);
234
0
      api_incr_top(L);
235
0
    }
236
0
  }
237
0
  lua_unlock(L);
238
0
  return name;
239
0
}
240
241
242
0
LUA_API const char *lua_setlocal (lua_State *L, const lua_Debug *ar, int n) {
243
0
  StkId pos = NULL;  /* to avoid warnings */
244
0
  const char *name;
245
0
  lua_lock(L);
246
0
  name = luaG_findlocal(L, ar->i_ci, n, &pos);
247
0
  if (name) {
248
0
    setobjs2s(L, pos, L->top.p - 1);
249
0
    L->top.p--;  /* pop value */
250
0
  }
251
0
  lua_unlock(L);
252
0
  return name;
253
0
}
254
255
256
0
static void funcinfo (lua_Debug *ar, Closure *cl) {
257
0
  if (noLuaClosure(cl)) {
258
0
    ar->source = "=[C]";
259
0
    ar->srclen = LL("=[C]");
260
0
    ar->linedefined = -1;
261
0
    ar->lastlinedefined = -1;
262
0
    ar->what = "C";
263
0
  }
264
0
  else {
265
0
    const Proto *p = cl->l.p;
266
0
    if (p->source) {
267
0
      ar->source = getstr(p->source);
268
0
      ar->srclen = tsslen(p->source);
269
0
    }
270
0
    else {
271
0
      ar->source = "=?";
272
0
      ar->srclen = LL("=?");
273
0
    }
274
0
    ar->linedefined = p->linedefined;
275
0
    ar->lastlinedefined = p->lastlinedefined;
276
0
    ar->what = (ar->linedefined == 0) ? "main" : "Lua";
277
0
  }
278
0
  luaO_chunkid(ar->short_src, ar->source, ar->srclen);
279
0
}
280
281
282
0
static int nextline (const Proto *p, int currentline, int pc) {
283
0
  if (p->lineinfo[pc] != ABSLINEINFO)
284
0
    return currentline + p->lineinfo[pc];
285
0
  else
286
0
    return luaG_getfuncline(p, pc);
287
0
}
288
289
290
0
static void collectvalidlines (lua_State *L, Closure *f) {
291
0
  if (noLuaClosure(f)) {
292
0
    setnilvalue(s2v(L->top.p));
293
0
    api_incr_top(L);
294
0
  }
295
0
  else {
296
0
    int i;
297
0
    TValue v;
298
0
    const Proto *p = f->l.p;
299
0
    int currentline = p->linedefined;
300
0
    Table *t = luaH_new(L);  /* new table to store active lines */
301
0
    sethvalue2s(L, L->top.p, t);  /* push it on stack */
302
0
    api_incr_top(L);
303
0
    setbtvalue(&v);  /* boolean 'true' to be the value of all indices */
304
0
    if (!p->is_vararg)  /* regular function? */
305
0
      i = 0;  /* consider all instructions */
306
0
    else {  /* vararg function */
307
0
      lua_assert(GET_OPCODE(p->code[0]) == OP_VARARGPREP);
308
0
      currentline = nextline(p, currentline, 0);
309
0
      i = 1;  /* skip first instruction (OP_VARARGPREP) */
310
0
    }
311
0
    for (; i < p->sizelineinfo; i++) {  /* for each instruction */
312
0
      currentline = nextline(p, currentline, i);  /* get its line */
313
0
      luaH_setint(L, t, currentline, &v);  /* table[line] = true */
314
0
    }
315
0
  }
316
0
}
317
318
319
0
static const char *getfuncname (lua_State *L, CallInfo *ci, const char **name) {
320
  /* calling function is a known function? */
321
0
  if (ci != NULL && !(ci->callstatus & CIST_TAIL))
322
0
    return funcnamefromcall(L, ci->previous, name);
323
0
  else return NULL;  /* no way to find a name */
324
0
}
325
326
327
static int auxgetinfo (lua_State *L, const char *what, lua_Debug *ar,
328
0
                       Closure *f, CallInfo *ci) {
329
0
  int status = 1;
330
0
  for (; *what; what++) {
331
0
    switch (*what) {
332
0
      case 'S': {
333
0
        funcinfo(ar, f);
334
0
        break;
335
0
      }
336
0
      case 'l': {
337
0
        ar->currentline = (ci && isLua(ci)) ? getcurrentline(ci) : -1;
338
0
        break;
339
0
      }
340
0
      case 'u': {
341
0
        ar->nups = (f == NULL) ? 0 : f->c.nupvalues;
342
0
        if (noLuaClosure(f)) {
343
0
          ar->isvararg = 1;
344
0
          ar->nparams = 0;
345
0
        }
346
0
        else {
347
0
          ar->isvararg = f->l.p->is_vararg;
348
0
          ar->nparams = f->l.p->numparams;
349
0
        }
350
0
        break;
351
0
      }
352
0
      case 't': {
353
0
        ar->istailcall = (ci) ? ci->callstatus & CIST_TAIL : 0;
354
0
        break;
355
0
      }
356
0
      case 'n': {
357
0
        ar->namewhat = getfuncname(L, ci, &ar->name);
358
0
        if (ar->namewhat == NULL) {
359
0
          ar->namewhat = "";  /* not found */
360
0
          ar->name = NULL;
361
0
        }
362
0
        break;
363
0
      }
364
0
      case 'r': {
365
0
        if (ci == NULL || !(ci->callstatus & CIST_TRAN))
366
0
          ar->ftransfer = ar->ntransfer = 0;
367
0
        else {
368
0
          ar->ftransfer = ci->u2.transferinfo.ftransfer;
369
0
          ar->ntransfer = ci->u2.transferinfo.ntransfer;
370
0
        }
371
0
        break;
372
0
      }
373
0
      case 'L':
374
0
      case 'f':  /* handled by lua_getinfo */
375
0
        break;
376
0
      default: status = 0;  /* invalid option */
377
0
    }
378
0
  }
379
0
  return status;
380
0
}
381
382
383
0
LUA_API int lua_getinfo (lua_State *L, const char *what, lua_Debug *ar) {
384
0
  int status;
385
0
  Closure *cl;
386
0
  CallInfo *ci;
387
0
  TValue *func;
388
0
  lua_lock(L);
389
0
  if (*what == '>') {
390
0
    ci = NULL;
391
0
    func = s2v(L->top.p - 1);
392
0
    api_check(L, ttisfunction(func), "function expected");
393
0
    what++;  /* skip the '>' */
394
0
    L->top.p--;  /* pop function */
395
0
  }
396
0
  else {
397
0
    ci = ar->i_ci;
398
0
    func = s2v(ci->func.p);
399
0
    lua_assert(ttisfunction(func));
400
0
  }
401
0
  cl = ttisclosure(func) ? clvalue(func) : NULL;
402
0
  status = auxgetinfo(L, what, ar, cl, ci);
403
0
  if (strchr(what, 'f')) {
404
0
    setobj2s(L, L->top.p, func);
405
0
    api_incr_top(L);
406
0
  }
407
0
  if (strchr(what, 'L'))
408
0
    collectvalidlines(L, cl);
409
0
  lua_unlock(L);
410
0
  return status;
411
0
}
412
413
414
/*
415
** {======================================================
416
** Symbolic Execution
417
** =======================================================
418
*/
419
420
static const char *getobjname (const Proto *p, int lastpc, int reg,
421
                               const char **name);
422
423
424
/*
425
** Find a "name" for the constant 'c'.
426
*/
427
0
static void kname (const Proto *p, int c, const char **name) {
428
0
  TValue *kvalue = &p->k[c];
429
0
  *name = (ttisstring(kvalue)) ? getstr(tsvalue(kvalue)) : "?";
430
0
}
431
432
433
/*
434
** Find a "name" for the register 'c'.
435
*/
436
0
static void rname (const Proto *p, int pc, int c, const char **name) {
437
0
  const char *what = getobjname(p, pc, c, name); /* search for 'c' */
438
0
  if (!(what && *what == 'c'))  /* did not find a constant name? */
439
0
    *name = "?";
440
0
}
441
442
443
/*
444
** Find a "name" for a 'C' value in an RK instruction.
445
*/
446
0
static void rkname (const Proto *p, int pc, Instruction i, const char **name) {
447
0
  int c = GETARG_C(i);  /* key index */
448
0
  if (GETARG_k(i))  /* is 'c' a constant? */
449
0
    kname(p, c, name);
450
0
  else  /* 'c' is a register */
451
0
    rname(p, pc, c, name);
452
0
}
453
454
455
0
static int filterpc (int pc, int jmptarget) {
456
0
  if (pc < jmptarget)  /* is code conditional (inside a jump)? */
457
0
    return -1;  /* cannot know who sets that register */
458
0
  else return pc;  /* current position sets that register */
459
0
}
460
461
462
/*
463
** Try to find last instruction before 'lastpc' that modified register 'reg'.
464
*/
465
0
static int findsetreg (const Proto *p, int lastpc, int reg) {
466
0
  int pc;
467
0
  int setreg = -1;  /* keep last instruction that changed 'reg' */
468
0
  int jmptarget = 0;  /* any code before this address is conditional */
469
0
  if (testMMMode(GET_OPCODE(p->code[lastpc])))
470
0
    lastpc--;  /* previous instruction was not actually executed */
471
0
  for (pc = 0; pc < lastpc; pc++) {
472
0
    Instruction i = p->code[pc];
473
0
    OpCode op = GET_OPCODE(i);
474
0
    int a = GETARG_A(i);
475
0
    int change;  /* true if current instruction changed 'reg' */
476
0
    switch (op) {
477
0
      case OP_LOADNIL: {  /* set registers from 'a' to 'a+b' */
478
0
        int b = GETARG_B(i);
479
0
        change = (a <= reg && reg <= a + b);
480
0
        break;
481
0
      }
482
0
      case OP_TFORCALL: {  /* affect all regs above its base */
483
0
        change = (reg >= a + 2);
484
0
        break;
485
0
      }
486
0
      case OP_CALL:
487
0
      case OP_TAILCALL: {  /* affect all registers above base */
488
0
        change = (reg >= a);
489
0
        break;
490
0
      }
491
0
      case OP_JMP: {  /* doesn't change registers, but changes 'jmptarget' */
492
0
        int b = GETARG_sJ(i);
493
0
        int dest = pc + 1 + b;
494
        /* jump does not skip 'lastpc' and is larger than current one? */
495
0
        if (dest <= lastpc && dest > jmptarget)
496
0
          jmptarget = dest;  /* update 'jmptarget' */
497
0
        change = 0;
498
0
        break;
499
0
      }
500
0
      default:  /* any instruction that sets A */
501
0
        change = (testAMode(op) && reg == a);
502
0
        break;
503
0
    }
504
0
    if (change)
505
0
      setreg = filterpc(pc, jmptarget);
506
0
  }
507
0
  return setreg;
508
0
}
509
510
511
/*
512
** Check whether table being indexed by instruction 'i' is the
513
** environment '_ENV'
514
*/
515
0
static const char *gxf (const Proto *p, int pc, Instruction i, int isup) {
516
0
  int t = GETARG_B(i);  /* table index */
517
0
  const char *name;  /* name of indexed variable */
518
0
  if (isup)  /* is an upvalue? */
519
0
    name = upvalname(p, t);
520
0
  else
521
0
    getobjname(p, pc, t, &name);
522
0
  return (name && strcmp(name, LUA_ENV) == 0) ? "global" : "field";
523
0
}
524
525
526
static const char *getobjname (const Proto *p, int lastpc, int reg,
527
0
                               const char **name) {
528
0
  int pc;
529
0
  *name = luaF_getlocalname(p, reg + 1, lastpc);
530
0
  if (*name)  /* is a local? */
531
0
    return "local";
532
  /* else try symbolic execution */
533
0
  pc = findsetreg(p, lastpc, reg);
534
0
  if (pc != -1) {  /* could find instruction? */
535
0
    Instruction i = p->code[pc];
536
0
    OpCode op = GET_OPCODE(i);
537
0
    switch (op) {
538
0
      case OP_MOVE: {
539
0
        int b = GETARG_B(i);  /* move from 'b' to 'a' */
540
0
        if (b < GETARG_A(i))
541
0
          return getobjname(p, pc, b, name);  /* get name for 'b' */
542
0
        break;
543
0
      }
544
0
      case OP_GETTABUP: {
545
0
        int k = GETARG_C(i);  /* key index */
546
0
        kname(p, k, name);
547
0
        return gxf(p, pc, i, 1);
548
0
      }
549
0
      case OP_GETTABLE: {
550
0
        int k = GETARG_C(i);  /* key index */
551
0
        rname(p, pc, k, name);
552
0
        return gxf(p, pc, i, 0);
553
0
      }
554
0
      case OP_GETI: {
555
0
        *name = "integer index";
556
0
        return "field";
557
0
      }
558
0
      case OP_GETFIELD: {
559
0
        int k = GETARG_C(i);  /* key index */
560
0
        kname(p, k, name);
561
0
        return gxf(p, pc, i, 0);
562
0
      }
563
0
      case OP_GETUPVAL: {
564
0
        *name = upvalname(p, GETARG_B(i));
565
0
        return "upvalue";
566
0
      }
567
0
      case OP_LOADK:
568
0
      case OP_LOADKX: {
569
0
        int b = (op == OP_LOADK) ? GETARG_Bx(i)
570
0
                                 : GETARG_Ax(p->code[pc + 1]);
571
0
        if (ttisstring(&p->k[b])) {
572
0
          *name = getstr(tsvalue(&p->k[b]));
573
0
          return "constant";
574
0
        }
575
0
        break;
576
0
      }
577
0
      case OP_SELF: {
578
0
        rkname(p, pc, i, name);
579
0
        return "method";
580
0
      }
581
0
      default: break;  /* go through to return NULL */
582
0
    }
583
0
  }
584
0
  return NULL;  /* could not find reasonable name */
585
0
}
586
587
588
/*
589
** Try to find a name for a function based on the code that called it.
590
** (Only works when function was called by a Lua function.)
591
** Returns what the name is (e.g., "for iterator", "method",
592
** "metamethod") and sets '*name' to point to the name.
593
*/
594
static const char *funcnamefromcode (lua_State *L, const Proto *p,
595
0
                                     int pc, const char **name) {
596
0
  TMS tm = (TMS)0;  /* (initial value avoids warnings) */
597
0
  Instruction i = p->code[pc];  /* calling instruction */
598
0
  switch (GET_OPCODE(i)) {
599
0
    case OP_CALL:
600
0
    case OP_TAILCALL:
601
0
      return getobjname(p, pc, GETARG_A(i), name);  /* get function name */
602
0
    case OP_TFORCALL: {  /* for iterator */
603
0
      *name = "for iterator";
604
0
       return "for iterator";
605
0
    }
606
    /* other instructions can do calls through metamethods */
607
0
    case OP_SELF: case OP_GETTABUP: case OP_GETTABLE:
608
0
    case OP_GETI: case OP_GETFIELD:
609
0
      tm = TM_INDEX;
610
0
      break;
611
0
    case OP_SETTABUP: case OP_SETTABLE: case OP_SETI: case OP_SETFIELD:
612
0
      tm = TM_NEWINDEX;
613
0
      break;
614
0
    case OP_MMBIN: case OP_MMBINI: case OP_MMBINK: {
615
0
      tm = cast(TMS, GETARG_C(i));
616
0
      break;
617
0
    }
618
0
    case OP_UNM: tm = TM_UNM; break;
619
0
    case OP_BNOT: tm = TM_BNOT; break;
620
0
    case OP_LEN: tm = TM_LEN; break;
621
0
    case OP_CONCAT: tm = TM_CONCAT; break;
622
0
    case OP_EQ: tm = TM_EQ; break;
623
    /* no cases for OP_EQI and OP_EQK, as they don't call metamethods */
624
0
    case OP_LT: case OP_LTI: case OP_GTI: tm = TM_LT; break;
625
0
    case OP_LE: case OP_LEI: case OP_GEI: tm = TM_LE; break;
626
0
    case OP_CLOSE: case OP_RETURN: tm = TM_CLOSE; break;
627
0
    default:
628
0
      return NULL;  /* cannot find a reasonable name */
629
0
  }
630
0
  *name = getshrstr(G(L)->tmname[tm]) + 2;
631
0
  return "metamethod";
632
0
}
633
634
635
/*
636
** Try to find a name for a function based on how it was called.
637
*/
638
static const char *funcnamefromcall (lua_State *L, CallInfo *ci,
639
0
                                                   const char **name) {
640
0
  if (ci->callstatus & CIST_HOOKED) {  /* was it called inside a hook? */
641
0
    *name = "?";
642
0
    return "hook";
643
0
  }
644
0
  else if (ci->callstatus & CIST_FIN) {  /* was it called as a finalizer? */
645
0
    *name = "__gc";
646
0
    return "metamethod";  /* report it as such */
647
0
  }
648
0
  else if (isLua(ci))
649
0
    return funcnamefromcode(L, ci_func(ci)->p, currentpc(ci), name);
650
0
  else
651
0
    return NULL;
652
0
}
653
654
/* }====================================================== */
655
656
657
658
/*
659
** Check whether pointer 'o' points to some value in the stack frame of
660
** the current function and, if so, returns its index.  Because 'o' may
661
** not point to a value in this stack, we cannot compare it with the
662
** region boundaries (undefined behavior in ISO C).
663
*/
664
0
static int instack (CallInfo *ci, const TValue *o) {
665
0
  int pos;
666
0
  StkId base = ci->func.p + 1;
667
0
  for (pos = 0; base + pos < ci->top.p; pos++) {
668
0
    if (o == s2v(base + pos))
669
0
      return pos;
670
0
  }
671
0
  return -1;  /* not found */
672
0
}
673
674
675
/*
676
** Checks whether value 'o' came from an upvalue. (That can only happen
677
** with instructions OP_GETTABUP/OP_SETTABUP, which operate directly on
678
** upvalues.)
679
*/
680
static const char *getupvalname (CallInfo *ci, const TValue *o,
681
0
                                 const char **name) {
682
0
  LClosure *c = ci_func(ci);
683
0
  int i;
684
0
  for (i = 0; i < c->nupvalues; i++) {
685
0
    if (c->upvals[i]->v.p == o) {
686
0
      *name = upvalname(c->p, i);
687
0
      return "upvalue";
688
0
    }
689
0
  }
690
0
  return NULL;
691
0
}
692
693
694
static const char *formatvarinfo (lua_State *L, const char *kind,
695
0
                                                const char *name) {
696
0
  if (kind == NULL)
697
0
    return "";  /* no information */
698
0
  else
699
0
    return luaO_pushfstring(L, " (%s '%s')", kind, name);
700
0
}
701
702
/*
703
** Build a string with a "description" for the value 'o', such as
704
** "variable 'x'" or "upvalue 'y'".
705
*/
706
0
static const char *varinfo (lua_State *L, const TValue *o) {
707
0
  CallInfo *ci = L->ci;
708
0
  const char *name = NULL;  /* to avoid warnings */
709
0
  const char *kind = NULL;
710
0
  if (isLua(ci)) {
711
0
    kind = getupvalname(ci, o, &name);  /* check whether 'o' is an upvalue */
712
0
    if (!kind) {  /* not an upvalue? */
713
0
      int reg = instack(ci, o);  /* try a register */
714
0
      if (reg >= 0)  /* is 'o' a register? */
715
0
        kind = getobjname(ci_func(ci)->p, currentpc(ci), reg, &name);
716
0
    }
717
0
  }
718
0
  return formatvarinfo(L, kind, name);
719
0
}
720
721
722
/*
723
** Raise a type error
724
*/
725
static l_noret typeerror (lua_State *L, const TValue *o, const char *op,
726
0
                          const char *extra) {
727
0
  const char *t = luaT_objtypename(L, o);
728
0
  luaG_runerror(L, "attempt to %s a %s value%s", op, t, extra);
729
0
}
730
731
732
/*
733
** Raise a type error with "standard" information about the faulty
734
** object 'o' (using 'varinfo').
735
*/
736
0
l_noret luaG_typeerror (lua_State *L, const TValue *o, const char *op) {
737
0
  typeerror(L, o, op, varinfo(L, o));
738
0
}
739
740
741
/*
742
** Raise an error for calling a non-callable object. Try to find a name
743
** for the object based on how it was called ('funcnamefromcall'); if it
744
** cannot get a name there, try 'varinfo'.
745
*/
746
0
l_noret luaG_callerror (lua_State *L, const TValue *o) {
747
0
  CallInfo *ci = L->ci;
748
0
  const char *name = NULL;  /* to avoid warnings */
749
0
  const char *kind = funcnamefromcall(L, ci, &name);
750
0
  const char *extra = kind ? formatvarinfo(L, kind, name) : varinfo(L, o);
751
0
  typeerror(L, o, "call", extra);
752
0
}
753
754
755
0
l_noret luaG_forerror (lua_State *L, const TValue *o, const char *what) {
756
0
  luaG_runerror(L, "bad 'for' %s (number expected, got %s)",
757
0
                   what, luaT_objtypename(L, o));
758
0
}
759
760
761
0
l_noret luaG_concaterror (lua_State *L, const TValue *p1, const TValue *p2) {
762
0
  if (ttisstring(p1) || cvt2str(p1)) p1 = p2;
763
0
  luaG_typeerror(L, p1, "concatenate");
764
0
}
765
766
767
l_noret luaG_opinterror (lua_State *L, const TValue *p1,
768
0
                         const TValue *p2, const char *msg) {
769
0
  if (!ttisnumber(p1))  /* first operand is wrong? */
770
0
    p2 = p1;  /* now second is wrong */
771
0
  luaG_typeerror(L, p2, msg);
772
0
}
773
774
775
/*
776
** Error when both values are convertible to numbers, but not to integers
777
*/
778
0
l_noret luaG_tointerror (lua_State *L, const TValue *p1, const TValue *p2) {
779
0
  lua_Integer temp;
780
0
  if (!luaV_tointegerns(p1, &temp, LUA_FLOORN2I))
781
0
    p2 = p1;
782
0
  luaG_runerror(L, "number%s has no integer representation", varinfo(L, p2));
783
0
}
784
785
786
0
l_noret luaG_ordererror (lua_State *L, const TValue *p1, const TValue *p2) {
787
0
  const char *t1 = luaT_objtypename(L, p1);
788
0
  const char *t2 = luaT_objtypename(L, p2);
789
0
  if (strcmp(t1, t2) == 0)
790
0
    luaG_runerror(L, "attempt to compare two %s values", t1);
791
0
  else
792
0
    luaG_runerror(L, "attempt to compare %s with %s", t1, t2);
793
0
}
794
795
796
/* add src:line information to 'msg' */
797
const char *luaG_addinfo (lua_State *L, const char *msg, TString *src,
798
0
                                        int line) {
799
0
  char buff[LUA_IDSIZE];
800
0
  if (src)
801
0
    luaO_chunkid(buff, getstr(src), tsslen(src));
802
0
  else {  /* no source available; use "?" instead */
803
0
    buff[0] = '?'; buff[1] = '\0';
804
0
  }
805
0
  return luaO_pushfstring(L, "%s:%d: %s", buff, line, msg);
806
0
}
807
808
809
0
l_noret luaG_errormsg (lua_State *L) {
810
0
  if (L->errfunc != 0) {  /* is there an error handling function? */
811
0
    StkId errfunc = restorestack(L, L->errfunc);
812
0
    lua_assert(ttisfunction(s2v(errfunc)));
813
0
    setobjs2s(L, L->top.p, L->top.p - 1);  /* move argument */
814
0
    setobjs2s(L, L->top.p - 1, errfunc);  /* push function */
815
0
    L->top.p++;  /* assume EXTRA_STACK */
816
0
    luaD_callnoyield(L, L->top.p - 2, 1);  /* call it */
817
0
  }
818
0
  luaD_throw(L, LUA_ERRRUN);
819
0
}
820
821
822
0
l_noret luaG_runerror (lua_State *L, const char *fmt, ...) {
823
0
  CallInfo *ci = L->ci;
824
0
  const char *msg;
825
0
  va_list argp;
826
0
  luaC_checkGC(L);  /* error message uses memory */
827
0
  va_start(argp, fmt);
828
0
  msg = luaO_pushvfstring(L, fmt, argp);  /* format message */
829
0
  va_end(argp);
830
0
  if (isLua(ci)) {  /* if Lua function, add source:line information */
831
0
    luaG_addinfo(L, msg, ci_func(ci)->p->source, getcurrentline(ci));
832
0
    setobjs2s(L, L->top.p - 2, L->top.p - 1);  /* remove 'msg' */
833
0
    L->top.p--;
834
0
  }
835
0
  luaG_errormsg(L);
836
0
}
837
838
839
/*
840
** Check whether new instruction 'newpc' is in a different line from
841
** previous instruction 'oldpc'. More often than not, 'newpc' is only
842
** one or a few instructions after 'oldpc' (it must be after, see
843
** caller), so try to avoid calling 'luaG_getfuncline'. If they are
844
** too far apart, there is a good chance of a ABSLINEINFO in the way,
845
** so it goes directly to 'luaG_getfuncline'.
846
*/
847
0
static int changedline (const Proto *p, int oldpc, int newpc) {
848
0
  if (p->lineinfo == NULL)  /* no debug information? */
849
0
    return 0;
850
0
  if (newpc - oldpc < MAXIWTHABS / 2) {  /* not too far apart? */
851
0
    int delta = 0;  /* line difference */
852
0
    int pc = oldpc;
853
0
    for (;;) {
854
0
      int lineinfo = p->lineinfo[++pc];
855
0
      if (lineinfo == ABSLINEINFO)
856
0
        break;  /* cannot compute delta; fall through */
857
0
      delta += lineinfo;
858
0
      if (pc == newpc)
859
0
        return (delta != 0);  /* delta computed successfully */
860
0
    }
861
0
  }
862
  /* either instructions are too far apart or there is an absolute line
863
     info in the way; compute line difference explicitly */
864
0
  return (luaG_getfuncline(p, oldpc) != luaG_getfuncline(p, newpc));
865
0
}
866
867
868
/*
869
** Traces Lua calls. If code is running the first instruction of a function,
870
** and function is not vararg, and it is not coming from an yield,
871
** calls 'luaD_hookcall'. (Vararg functions will call 'luaD_hookcall'
872
** after adjusting its variable arguments; otherwise, they could call
873
** a line/count hook before the call hook. Functions coming from
874
** an yield already called 'luaD_hookcall' before yielding.)
875
*/
876
0
int luaG_tracecall (lua_State *L) {
877
0
  CallInfo *ci = L->ci;
878
0
  Proto *p = ci_func(ci)->p;
879
0
  ci->u.l.trap = 1;  /* ensure hooks will be checked */
880
0
  if (ci->u.l.savedpc == p->code) {  /* first instruction (not resuming)? */
881
0
    if (p->is_vararg)
882
0
      return 0;  /* hooks will start at VARARGPREP instruction */
883
0
    else if (!(ci->callstatus & CIST_HOOKYIELD))  /* not yieded? */
884
0
      luaD_hookcall(L, ci);  /* check 'call' hook */
885
0
  }
886
0
  return 1;  /* keep 'trap' on */
887
0
}
888
889
890
/*
891
** Traces the execution of a Lua function. Called before the execution
892
** of each opcode, when debug is on. 'L->oldpc' stores the last
893
** instruction traced, to detect line changes. When entering a new
894
** function, 'npci' will be zero and will test as a new line whatever
895
** the value of 'oldpc'.  Some exceptional conditions may return to
896
** a function without setting 'oldpc'. In that case, 'oldpc' may be
897
** invalid; if so, use zero as a valid value. (A wrong but valid 'oldpc'
898
** at most causes an extra call to a line hook.)
899
** This function is not "Protected" when called, so it should correct
900
** 'L->top.p' before calling anything that can run the GC.
901
*/
902
0
int luaG_traceexec (lua_State *L, const Instruction *pc) {
903
0
  CallInfo *ci = L->ci;
904
0
  lu_byte mask = L->hookmask;
905
0
  const Proto *p = ci_func(ci)->p;
906
0
  int counthook;
907
0
  if (!(mask & (LUA_MASKLINE | LUA_MASKCOUNT))) {  /* no hooks? */
908
0
    ci->u.l.trap = 0;  /* don't need to stop again */
909
0
    return 0;  /* turn off 'trap' */
910
0
  }
911
0
  pc++;  /* reference is always next instruction */
912
0
  ci->u.l.savedpc = pc;  /* save 'pc' */
913
0
  counthook = (--L->hookcount == 0 && (mask & LUA_MASKCOUNT));
914
0
  if (counthook)
915
0
    resethookcount(L);  /* reset count */
916
0
  else if (!(mask & LUA_MASKLINE))
917
0
    return 1;  /* no line hook and count != 0; nothing to be done now */
918
0
  if (ci->callstatus & CIST_HOOKYIELD) {  /* called hook last time? */
919
0
    ci->callstatus &= ~CIST_HOOKYIELD;  /* erase mark */
920
0
    return 1;  /* do not call hook again (VM yielded, so it did not move) */
921
0
  }
922
0
  if (!isIT(*(ci->u.l.savedpc - 1)))  /* top not being used? */
923
0
    L->top.p = ci->top.p;  /* correct top */
924
0
  if (counthook)
925
0
    luaD_hook(L, LUA_HOOKCOUNT, -1, 0, 0);  /* call count hook */
926
0
  if (mask & LUA_MASKLINE) {
927
    /* 'L->oldpc' may be invalid; use zero in this case */
928
0
    int oldpc = (L->oldpc < p->sizecode) ? L->oldpc : 0;
929
0
    int npci = pcRel(pc, p);
930
0
    if (npci <= oldpc ||  /* call hook when jump back (loop), */
931
0
        changedline(p, oldpc, npci)) {  /* or when enter new line */
932
0
      int newline = luaG_getfuncline(p, npci);
933
0
      luaD_hook(L, LUA_HOOKLINE, newline, 0, 0);  /* call line hook */
934
0
    }
935
0
    L->oldpc = npci;  /* 'pc' of last call to line hook */
936
0
  }
937
0
  if (L->status == LUA_YIELD) {  /* did hook yield? */
938
0
    if (counthook)
939
0
      L->hookcount = 1;  /* undo decrement to zero */
940
0
    ci->u.l.savedpc--;  /* undo increment (resume will increment it again) */
941
0
    ci->callstatus |= CIST_HOOKYIELD;  /* mark that it yielded */
942
0
    luaD_throw(L, LUA_YIELD);
943
0
  }
944
0
  return 1;  /* keep 'trap' on */
945
0
}
946