This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
new perldelta
[perl5.git] / ext / Devel-Peek / Peek.xs
CommitLineData
c5be433b 1#define PERL_NO_GET_CONTEXT
3967c732
JD
2#include "EXTERN.h"
3#include "perl.h"
4#include "XSUB.h"
5
f681a178 6static bool
bd16a5f0
IZ
7_runops_debug(int flag)
8{
9 dTHX;
ef69c8fc 10 const bool d = PL_runops == Perl_runops_debug;
bd16a5f0
IZ
11
12 if (flag >= 0)
ef69c8fc 13 PL_runops = flag ? Perl_runops_debug : Perl_runops_standard;
bd16a5f0
IZ
14 return d;
15}
16
f681a178 17static SV *
cea2e8a9 18DeadCode(pTHX)
3967c732 19{
8ecf7187
GS
20#ifdef PURIFY
21 return Nullsv;
22#else
3967c732 23 SV* sva;
9c5ffd7c 24 SV* sv;
3967c732 25 SV* ret = newRV_noinc((SV*)newAV());
5aaab254 26 SV* svend;
3967c732
JD
27 int tm = 0, tref = 0, ts = 0, ta = 0, tas = 0;
28
29 for (sva = PL_sv_arenaroot; sva; sva = (SV*)SvANY(sva)) {
30 svend = &sva[SvREFCNT(sva)];
31 for (sv = sva + 1; sv < svend; ++sv) {
32 if (SvTYPE(sv) == SVt_PVCV) {
33 CV *cv = (CV*)sv;
eacbb379 34 PADLIST* padlist;
c9795579 35 AV *argav;
3967c732
JD
36 SV** svp;
37 SV** pad;
38 int i = 0, j, levelm, totm = 0, levelref, totref = 0;
39 int levels, tots = 0, levela, tota = 0, levelas, totas = 0;
40 int dumpit = 0;
41
aed2304a 42 if (CvISXSUB(sv)) {
3967c732
JD
43 continue; /* XSUB */
44 }
45 if (!CvGV(sv)) {
46 continue; /* file-level scope. */
47 }
48 if (!CvROOT(cv)) {
bf49b057 49 /* PerlIO_printf(Perl_debug_log, " no root?!\n"); */
3967c732
JD
50 continue; /* autoloading stub. */
51 }
bf49b057 52 do_gvgv_dump(0, Perl_debug_log, "GVGV::GV", CvGV(sv));
3967c732 53 if (CvDEPTH(cv)) {
bf49b057 54 PerlIO_printf(Perl_debug_log, " busy\n");
3967c732
JD
55 continue;
56 }
eacbb379 57 padlist = CvPADLIST(cv);
86d2498c
FC
58 svp = (SV**) PadlistARRAY(padlist);
59 while (++i <= PadlistMAX(padlist)) { /* Depth. */
3967c732
JD
60 SV **args;
61
c9795579 62 if (!svp[i]) continue;
3967c732
JD
63 pad = AvARRAY((AV*)svp[i]);
64 argav = (AV*)pad[0];
65 if (!argav || (SV*)argav == &PL_sv_undef) {
bf49b057 66 PerlIO_printf(Perl_debug_log, " closure-template\n");
3967c732
JD
67 continue;
68 }
69 args = AvARRAY(argav);
70 levelm = levels = levelref = levelas = 0;
71 levela = sizeof(SV*) * (AvMAX(argav) + 1);
72 if (AvREAL(argav)) {
73 for (j = 0; j < AvFILL(argav); j++) {
74 if (SvROK(args[j])) {
bf49b057 75 PerlIO_printf(Perl_debug_log, " ref in args!\n");
3967c732
JD
76 levelref++;
77 }
78 /* else if (SvPOK(args[j]) && SvPVX(args[j])) { */
79 else if (SvTYPE(args[j]) >= SVt_PV && SvLEN(args[j])) {
80 levelas += SvLEN(args[j])/SvREFCNT(args[j]);
81 }
82 }
83 }
84 for (j = 1; j < AvFILL((AV*)svp[1]); j++) { /* Vars. */
ce0d59fd 85 if (!pad[j]) continue;
3967c732
JD
86 if (SvROK(pad[j])) {
87 levelref++;
bf49b057 88 do_sv_dump(0, Perl_debug_log, pad[j], 0, 4, 0, 0);
3967c732
JD
89 dumpit = 1;
90 }
91 /* else if (SvPOK(pad[j]) && SvPVX(pad[j])) { */
92 else if (SvTYPE(pad[j]) >= SVt_PVAV) {
93 if (!SvPADMY(pad[j])) {
94 levelref++;
bf49b057 95 do_sv_dump(0, Perl_debug_log, pad[j], 0, 4, 0, 0);
3967c732
JD
96 dumpit = 1;
97 }
98 }
99 else if (SvTYPE(pad[j]) >= SVt_PV && SvLEN(pad[j])) {
3967c732
JD
100 levels++;
101 levelm += SvLEN(pad[j])/SvREFCNT(pad[j]);
102 /* Dump(pad[j],4); */
103 }
104 }
bf49b057 105 PerlIO_printf(Perl_debug_log, " level %i: refs: %i, strings: %i in %i,\targsarray: %i, argsstrings: %i\n",
3967c732
JD
106 i, levelref, levelm, levels, levela, levelas);
107 totm += levelm;
108 tota += levela;
109 totas += levelas;
110 tots += levels;
111 totref += levelref;
112 if (dumpit)
bf49b057 113 do_sv_dump(0, Perl_debug_log, (SV*)cv, 0, 2, 0, 0);
3967c732 114 }
86d2498c 115 if (PadlistMAX(padlist) > 1) {
bf49b057 116 PerlIO_printf(Perl_debug_log, " total: refs: %i, strings: %i in %i,\targsarrays: %i, argsstrings: %i\n",
3967c732
JD
117 totref, totm, tots, tota, totas);
118 }
119 tref += totref;
120 tm += totm;
121 ts += tots;
122 ta += tota;
123 tas += totas;
124 }
125 }
126 }
bf49b057 127 PerlIO_printf(Perl_debug_log, "total: refs: %i, strings: %i in %i\targsarray: %i, argsstrings: %i\n", tref, tm, ts, ta, tas);
3967c732
JD
128
129 return ret;
3967c732 130#endif /* !PURIFY */
8ecf7187 131}
3967c732 132
3128eefe 133#if defined(MYMALLOC)
3967c732
JD
134# define mstat(str) dump_mstats(str)
135#else
136# define mstat(str) \
3128eefe 137 PerlIO_printf(Perl_debug_log, "%s: perl not compiled with MYMALLOC\n",str);
3967c732
JD
138#endif
139
3128eefe 140#if defined(MYMALLOC)
d1424c31
IZ
141
142/* Very coarse overestimate, 2-per-power-of-2, one more to determine NBUCKETS. */
143# define _NBUCKETS (2*8*IVSIZE+1)
144
145struct mstats_buffer
146{
147 perl_mstats_t buffer;
148 UV buf[_NBUCKETS*4];
149};
150
f681a178 151static void
d1424c31
IZ
152_fill_mstats(struct mstats_buffer *b, int level)
153{
c024d977 154 dTHX;
d1424c31
IZ
155 b->buffer.nfree = b->buf;
156 b->buffer.ntotal = b->buf + _NBUCKETS;
157 b->buffer.bucket_mem_size = b->buf + 2*_NBUCKETS;
158 b->buffer.bucket_available_size = b->buf + 3*_NBUCKETS;
159 Zero(b->buf, (level ? 4*_NBUCKETS: 2*_NBUCKETS), unsigned long);
160 get_mstats(&(b->buffer), _NBUCKETS, level);
161}
162
f681a178 163static void
d1424c31
IZ
164fill_mstats(SV *sv, int level)
165{
c024d977 166 dTHX;
d1424c31
IZ
167
168 if (SvREADONLY(sv))
169 croak("Cannot modify a readonly value");
b59747ac 170 sv_grow(sv, sizeof(struct mstats_buffer)+1);
d1424c31
IZ
171 _fill_mstats((struct mstats_buffer*)SvPVX(sv),level);
172 SvCUR_set(sv, sizeof(struct mstats_buffer));
173 *SvEND(sv) = '\0';
174 SvPOK_only(sv);
175}
176
f681a178 177static void
7698c435 178_mstats_to_hv(HV *hv, const struct mstats_buffer *b, int level)
d1424c31 179{
c024d977 180 dTHX;
d1424c31
IZ
181 SV **svp;
182 int type;
183
9dd7321f 184 svp = hv_fetchs(hv, "topbucket", 1);
d1424c31
IZ
185 sv_setiv(*svp, b->buffer.topbucket);
186
9dd7321f 187 svp = hv_fetchs(hv, "topbucket_ev", 1);
d1424c31
IZ
188 sv_setiv(*svp, b->buffer.topbucket_ev);
189
9dd7321f 190 svp = hv_fetchs(hv, "topbucket_odd", 1);
d1424c31
IZ
191 sv_setiv(*svp, b->buffer.topbucket_odd);
192
9dd7321f 193 svp = hv_fetchs(hv, "totfree", 1);
d1424c31
IZ
194 sv_setiv(*svp, b->buffer.totfree);
195
9dd7321f 196 svp = hv_fetchs(hv, "total", 1);
d1424c31
IZ
197 sv_setiv(*svp, b->buffer.total);
198
9dd7321f 199 svp = hv_fetchs(hv, "total_chain", 1);
d1424c31
IZ
200 sv_setiv(*svp, b->buffer.total_chain);
201
9dd7321f 202 svp = hv_fetchs(hv, "total_sbrk", 1);
d1424c31
IZ
203 sv_setiv(*svp, b->buffer.total_sbrk);
204
9dd7321f 205 svp = hv_fetchs(hv, "sbrks", 1);
d1424c31
IZ
206 sv_setiv(*svp, b->buffer.sbrks);
207
9dd7321f 208 svp = hv_fetchs(hv, "sbrk_good", 1);
d1424c31
IZ
209 sv_setiv(*svp, b->buffer.sbrk_good);
210
9dd7321f 211 svp = hv_fetchs(hv, "sbrk_slack", 1);
d1424c31
IZ
212 sv_setiv(*svp, b->buffer.sbrk_slack);
213
9dd7321f 214 svp = hv_fetchs(hv, "start_slack", 1);
d1424c31
IZ
215 sv_setiv(*svp, b->buffer.start_slack);
216
9dd7321f 217 svp = hv_fetchs(hv, "sbrked_remains", 1);
d1424c31
IZ
218 sv_setiv(*svp, b->buffer.sbrked_remains);
219
9dd7321f 220 svp = hv_fetchs(hv, "minbucket", 1);
d1424c31
IZ
221 sv_setiv(*svp, b->buffer.minbucket);
222
9dd7321f 223 svp = hv_fetchs(hv, "nbuckets", 1);
d1424c31
IZ
224 sv_setiv(*svp, b->buffer.nbuckets);
225
226 if (_NBUCKETS < b->buffer.nbuckets)
227 warn("FIXME: internal mstats buffer too short");
228
229 for (type = 0; type < (level ? 4 : 2); type++) {
f0f74ded 230 UV *p = 0, *p1 = 0, i;
d1424c31 231 AV *av;
d1424c31
IZ
232 static const char *types[4] = {
233 "free", "used", "mem_size", "available_size"
234 };
235
236 svp = hv_fetch(hv, types[type], strlen(types[type]), 1);
237
238 if (SvOK(*svp) && !(SvROK(*svp) && SvTYPE(SvRV(*svp)) == SVt_PVAV))
239 croak("Unexpected value for the key '%s' in the mstats hash", types[type]);
240 if (!SvOK(*svp)) {
241 av = newAV();
790188cd 242 sv_setrv_noinc(*svp, (SV*)av);
d1424c31
IZ
243 } else
244 av = (AV*)SvRV(*svp);
245
246 av_extend(av, b->buffer.nbuckets - 1);
247 /* XXXX What is the official way to reduce the size of the array? */
248 switch (type) {
249 case 0:
250 p = b->buffer.nfree;
251 break;
252 case 1:
253 p = b->buffer.ntotal;
254 p1 = b->buffer.nfree;
255 break;
256 case 2:
257 p = b->buffer.bucket_mem_size;
258 break;
259 case 3:
260 p = b->buffer.bucket_available_size;
261 break;
262 }
263 for (i = 0; i < b->buffer.nbuckets; i++) {
264 svp = av_fetch(av, i, 1);
265 if (type == 1)
266 sv_setiv(*svp, p[i]-p1[i]);
267 else
268 sv_setuv(*svp, p[i]);
269 }
270 }
271}
f681a178
AT
272
273static void
d1424c31
IZ
274mstats_fillhash(SV *sv, int level)
275{
276 struct mstats_buffer buf;
277
278 if (!(SvROK(sv) && SvTYPE(SvRV(sv)) == SVt_PVHV))
279 croak("Not a hash reference");
280 _fill_mstats(&buf, level);
281 _mstats_to_hv((HV *)SvRV(sv), &buf, level);
282}
f681a178
AT
283
284static void
d1424c31
IZ
285mstats2hash(SV *sv, SV *rv, int level)
286{
287 if (!(SvROK(rv) && SvTYPE(SvRV(rv)) == SVt_PVHV))
288 croak("Not a hash reference");
289 if (!SvPOK(sv))
290 croak("Undefined value when expecting mstats buffer");
291 if (SvCUR(sv) != sizeof(struct mstats_buffer))
292 croak("Wrong size for a value with a mstats buffer");
293 _mstats_to_hv((HV *)SvRV(rv), (struct mstats_buffer*)SvPVX(sv), level);
294}
3128eefe 295#else /* defined(MYMALLOC) */
f681a178 296static void
d1424c31
IZ
297fill_mstats(SV *sv, int level)
298{
c33e8be1
Z
299 PERL_UNUSED_ARG(sv);
300 PERL_UNUSED_ARG(level);
d1424c31
IZ
301 croak("Cannot report mstats without Perl malloc");
302}
f681a178
AT
303
304static void
d1424c31
IZ
305mstats_fillhash(SV *sv, int level)
306{
c33e8be1
Z
307 PERL_UNUSED_ARG(sv);
308 PERL_UNUSED_ARG(level);
d1424c31
IZ
309 croak("Cannot report mstats without Perl malloc");
310}
f681a178
AT
311
312static void
d1424c31
IZ
313mstats2hash(SV *sv, SV *rv, int level)
314{
c33e8be1
Z
315 PERL_UNUSED_ARG(sv);
316 PERL_UNUSED_ARG(rv);
317 PERL_UNUSED_ARG(level);
d1424c31
IZ
318 croak("Cannot report mstats without Perl malloc");
319}
3128eefe 320#endif /* defined(MYMALLOC) */
d1424c31 321
83ee9e09
GS
322#define _CvGV(cv) \
323 (SvROK(cv) && (SvTYPE(SvRV(cv))==SVt_PVCV) \
15bcf759 324 ? SvREFCNT_inc(CvGV((CV*)SvRV(cv))) : &PL_sv_undef)
83ee9e09 325
34b94bc4
FC
326static void
327S_do_dump(pTHX_ SV *const sv, I32 lim)
328{
34b94bc4
FC
329 SV *pv_lim_sv = perl_get_sv("Devel::Peek::pv_limit", 0);
330 const STRLEN pv_lim = pv_lim_sv ? SvIV(pv_lim_sv) : 0;
331 SV *dumpop = perl_get_sv("Devel::Peek::dump_ops", 0);
332 const U16 save_dumpindent = PL_dumpindent;
333 PL_dumpindent = 2;
334 do_sv_dump(0, Perl_debug_log, sv, 0, lim,
335 (bool)(dumpop && SvTRUE(dumpop)), pv_lim);
336 PL_dumpindent = save_dumpindent;
337}
338
339static OP *
340S_pp_dump(pTHX)
341{
f62a23a6
DM
342 I32 lim = 4;
343 if (PL_op->op_private == 2) {
344 lim = (I32)SvIVx(*PL_stack_sp);
345 rpp_popfree_1();
346 }
347 S_do_dump(aTHX_ *PL_stack_sp, lim);
348 rpp_replace_1_1(&PL_sv_undef);
349 return NORMAL;
34b94bc4
FC
350}
351
352static OP *
353S_ck_dump(pTHX_ OP *entersubop, GV *namegv, SV *cv)
354{
3253bf85 355 OP *parent, *pm, *first, *second;
34b94bc4 356 BINOP *newop;
98f21952
DM
357
358 PERL_UNUSED_ARG(cv);
34b94bc4
FC
359
360 ck_entersub_args_proto(entersubop, namegv,
361 newSVpvn_flags("$;$", 3, SVs_TEMP));
362
3253bf85
DM
363 parent = entersubop;
364 pm = cUNOPx(entersubop)->op_first;
e6dae479 365 if (!OpHAS_SIBLING(pm)) {
3253bf85
DM
366 parent = pm;
367 pm = cUNOPx(pm)->op_first;
368 }
e6dae479
FC
369 first = OpSIBLING(pm);
370 second = OpSIBLING(first);
3253bf85
DM
371 if (!second) {
372 /* It doesn’t really matter what we return here, as this only
373 occurs after yyerror. */
374 return entersubop;
375 }
376 /* we either have Dump($x): [pushmark]->[first]->[ex-cvop]
377 * or Dump($x,1); [pushmark]->[first]->[second]->[ex-cvop]
378 */
e6dae479 379 if (!OpHAS_SIBLING(second))
3253bf85 380 second = NULL;
1ed44841 381
34b94bc4
FC
382 if (first->op_type == OP_RV2AV ||
383 first->op_type == OP_PADAV ||
384 first->op_type == OP_RV2HV ||
385 first->op_type == OP_PADHV
386 )
387 first->op_flags |= OPf_REF;
388 else
389 first->op_flags &= ~OPf_MOD;
313efa90 390
3253bf85
DM
391 /* splice out first (and optionally second) ops, then discard the rest
392 * of the op tree */
34b94bc4 393
3253bf85 394 op_sibling_splice(parent, pm, second ? 2 : 1, NULL);
34b94bc4
FC
395 op_free(entersubop);
396
3253bf85
DM
397 /* then attach first (and second) to a new binop */
398
34b94bc4
FC
399 NewOp(1234, newop, 1, BINOP);
400 newop->op_type = OP_CUSTOM;
401 newop->op_ppaddr = S_pp_dump;
34b94bc4
FC
402 newop->op_private= second ? 2 : 1;
403 newop->op_flags = OPf_KIDS|OPf_WANT_SCALAR;
29e61fd9 404 op_sibling_splice((OP*)newop, NULL, 0, first);
34b94bc4
FC
405
406 return (OP *)newop;
407}
408
76e83594 409static const XOP my_xop = {
a84d3d5a
DD
410 XOPf_xop_name|XOPf_xop_desc|XOPf_xop_class, /* xop_flags */
411 "Devel_Peek_Dump", /* xop_name */
412 "Dump", /* xop_desc */
413 OA_BINOP, /* xop_class */
414 NULL /* xop_peep */
415};
34b94bc4 416
3967c732
JD
417MODULE = Devel::Peek PACKAGE = Devel::Peek
418
419void
420mstat(str="Devel::Peek::mstat: ")
d3f5e399 421const char *str
3967c732
JD
422
423void
d1424c31
IZ
424fill_mstats(SV *sv, int level = 0)
425
426void
427mstats_fillhash(SV *sv, int level = 0)
428 PROTOTYPE: \%;$
429
430void
431mstats2hash(SV *sv, SV *rv, int level = 0)
432 PROTOTYPE: $\%;$
433
434void
3967c732
JD
435Dump(sv,lim=4)
436SV * sv
437I32 lim
438PPCODE:
439{
34b94bc4
FC
440 S_do_dump(aTHX_ sv, lim);
441}
442
443BOOT:
444{
445 CV * const cv = get_cvn_flags("Devel::Peek::Dump", 17, 0);
316ebaf2 446 assert(cv);
a83b92fa 447 cv_set_call_checker_flags(cv, S_ck_dump, (SV *)cv, 0);
34b94bc4 448 Perl_custom_op_register(aTHX_ S_pp_dump, &my_xop);
3967c732
JD
449}
450
451void
452DumpArray(lim,...)
453I32 lim
454PPCODE:
455{
456 long i;
64ace3f8 457 SV *pv_lim_sv = perl_get_sv("Devel::Peek::pv_limit", 0);
7698c435 458 const STRLEN pv_lim = pv_lim_sv ? SvIV(pv_lim_sv) : 0;
64ace3f8 459 SV *dumpop = perl_get_sv("Devel::Peek::dump_ops", 0);
16d8f38a 460 const U16 save_dumpindent = PL_dumpindent;
3967c732
JD
461 PL_dumpindent = 2;
462
463 for (i=1; i<items; i++) {
147e3846 464 PerlIO_printf(Perl_debug_log, "Elt No. %ld 0x%" UVxf "\n", i - 1, PTR2UV(ST(i)));
eb160463
GS
465 do_sv_dump(0, Perl_debug_log, ST(i), 0, lim,
466 (bool)(dumpop && SvTRUE(dumpop)), pv_lim);
3967c732 467 }
16d8f38a 468 PL_dumpindent = save_dumpindent;
3967c732
JD
469}
470
471void
472DumpProg()
473PPCODE:
474{
d2560b70 475 warn("dumpindent is %d", (int)PL_dumpindent);
3967c732
JD
476 if (PL_main_root)
477 op_dump(PL_main_root);
478}
479
da1929e7 480U32
3967c732
JD
481SvREFCNT(sv)
482SV * sv
da1929e7
TC
483PROTOTYPE: \[$@%&*]
484CODE:
e4c0574e
TC
485 SvGETMAGIC(sv);
486 if (!SvROK(sv))
487 croak_xs_usage(cv, "SCALAR");
da1929e7
TC
488 RETVAL = SvREFCNT(SvRV(sv)) - 1; /* -1 because our ref doesn't count */
489OUTPUT:
490 RETVAL
3967c732
JD
491
492SV *
493DeadCode()
cea2e8a9
GS
494CODE:
495 RETVAL = DeadCode(aTHX);
496OUTPUT:
497 RETVAL
83ee9e09
GS
498
499MODULE = Devel::Peek PACKAGE = Devel::Peek PREFIX = _
500
501SV *
502_CvGV(cv)
503 SV *cv
bd16a5f0
IZ
504
505bool
506_runops_debug(int flag = -1)