3 * Copyright (c) 1991-2001, Larry Wall
5 * You may distribute under the terms of either the GNU General Public
6 * License or the Artistic License, as specified in the README file.
11 * "'You have talked long in your sleep, Frodo,' said Gandalf gently, 'and
12 * it has not been hard for me to read your mind and memory.'"
16 #define PERL_IN_DUMP_C
21 Perl_dump_indent(pTHX_ I32 level, PerlIO *file, const char* pat, ...)
25 dump_vindent(level, file, pat, &args);
30 Perl_dump_vindent(pTHX_ I32 level, PerlIO *file, const char* pat, va_list *args)
32 PerlIO_printf(file, "%*s", (int)(level*PL_dumpindent), "");
33 PerlIO_vprintf(file, pat, *args);
39 PerlIO_setlinebuf(Perl_debug_log);
41 op_dump(PL_main_root);
42 dump_packsubs(PL_defstash);
46 Perl_dump_packsubs(pTHX_ HV *stash)
53 for (i = 0; i <= (I32) HvMAX(stash); i++) {
54 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
55 GV *gv = (GV*)HeVAL(entry);
57 if (SvTYPE(gv) != SVt_PVGV || !GvGP(gv))
63 if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
64 (hv = GvHV(gv)) && HvNAME(hv) && hv != PL_defstash)
65 dump_packsubs(hv); /* nested package */
71 Perl_dump_sub(pTHX_ GV *gv)
73 SV *sv = sv_newmortal();
75 gv_fullname3(sv, gv, Nullch);
76 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nSUB %s = ", SvPVX(sv));
78 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "(xsub 0x%lx %d)\n",
79 (long)CvXSUB(GvCV(gv)),
80 (int)CvXSUBANY(GvCV(gv)).any_i32);
81 else if (CvROOT(GvCV(gv)))
82 op_dump(CvROOT(GvCV(gv)));
84 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
88 Perl_dump_form(pTHX_ GV *gv)
90 SV *sv = sv_newmortal();
92 gv_fullname3(sv, gv, Nullch);
93 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nFORMAT %s = ", SvPVX(sv));
94 if (CvROOT(GvFORM(gv)))
95 op_dump(CvROOT(GvFORM(gv)));
97 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
103 op_dump(PL_eval_root);
107 Perl_pv_display(pTHX_ SV *sv, char *pv, STRLEN cur, STRLEN len, STRLEN pvlim)
110 int nul_terminated = len > cur && pv[cur] == '\0';
112 sv_setpvn(sv, "\"", 1);
113 for (; cur--; pv++) {
114 if (pvlim && SvCUR(sv) >= pvlim) {
120 case '\t': sv_catpvn(sv, "\\t", 2); break;
121 case '\n': sv_catpvn(sv, "\\n", 2); break;
122 case '\r': sv_catpvn(sv, "\\r", 2); break;
123 case '\f': sv_catpvn(sv, "\\f", 2); break;
124 case '"': sv_catpvn(sv, "\\\"", 2); break;
125 case '\\': sv_catpvn(sv, "\\\\", 2); break;
126 default: sv_catpvn(sv, pv, 1); break;
130 if (cur && isDIGIT(*(pv+1)))
131 Perl_sv_catpvf(aTHX_ sv, "\\%03o", (U8)*pv);
133 Perl_sv_catpvf(aTHX_ sv, "\\%o", (U8)*pv);
136 sv_catpvn(sv, "\"", 1);
138 sv_catpvn(sv, "...", 3);
140 sv_catpvn(sv, "\\0", 2);
146 Perl_sv_peek(pTHX_ SV *sv)
148 SV *t = sv_newmortal();
158 else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
162 else if (sv == &PL_sv_undef || sv == &PL_sv_no || sv == &PL_sv_yes) {
163 if (sv == &PL_sv_undef) {
164 sv_catpv(t, "SV_UNDEF");
165 if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
166 SVs_GMG|SVs_SMG|SVs_RMG)) &&
170 else if (sv == &PL_sv_no) {
171 sv_catpv(t, "SV_NO");
172 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
173 SVs_GMG|SVs_SMG|SVs_RMG)) &&
174 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
181 sv_catpv(t, "SV_YES");
182 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
183 SVs_GMG|SVs_SMG|SVs_RMG)) &&
184 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
187 SvPVX(sv) && *SvPVX(sv) == '1' &&
193 else if (SvREFCNT(sv) == 0) {
197 else if (DEBUG_R_TEST && SvREFCNT(sv) > 1) {
198 Perl_sv_catpvf(aTHX_ t, "<%"UVuf">", (UV)SvREFCNT(sv));
204 if (SvCUR(t) + unref > 10) {
205 SvCUR(t) = unref + 3;
213 switch (SvTYPE(sv)) {
215 sv_catpv(t, "FREED");
219 sv_catpv(t, "UNDEF");
253 Perl_sv_catpvf(aTHX_ t, "CV(%s)", GvNAME(CvGV(sv)));
273 sv_catpv(t, "(null)");
275 SV *tmp = newSVpvn("", 0);
278 Perl_sv_catpvf(aTHX_ t, "[%s]", pv_display(tmp, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, 127));
279 Perl_sv_catpvf(aTHX_ t, "%s)", pv_display(tmp, SvPVX(sv), SvCUR(sv), SvLEN(sv), 127));
281 Perl_sv_catpvf(aTHX_ t, " [UTF8]");
285 else if (SvNOKp(sv)) {
286 STORE_NUMERIC_LOCAL_SET_STANDARD();
287 Perl_sv_catpvf(aTHX_ t, "(%g)",SvNVX(sv));
288 RESTORE_NUMERIC_LOCAL();
290 else if (SvIOKp(sv)) {
292 Perl_sv_catpvf(aTHX_ t, "(%"UVuf")", (UV)SvUVX(sv));
294 Perl_sv_catpvf(aTHX_ t, "(%"IVdf")", (IV)SvIVX(sv));
308 Perl_do_pmop_dump(pTHX_ I32 level, PerlIO *file, PMOP *pm)
313 Perl_dump_indent(aTHX_ level, file, "{}\n");
316 Perl_dump_indent(aTHX_ level, file, "{\n");
318 if (pm->op_pmflags & PMf_ONCE)
323 Perl_dump_indent(aTHX_ level, file, "PMf_PRE %c%s%c%s\n",
324 ch, pm->op_pmregexp->precomp, ch,
325 (pm->op_private & OPpRUNTIME) ? " (RUNTIME)" : "");
327 Perl_dump_indent(aTHX_ level, file, "PMf_PRE (RUNTIME)\n");
328 if (pm->op_type != OP_PUSHRE && pm->op_pmreplroot) {
329 Perl_dump_indent(aTHX_ level, file, "PMf_REPL = ");
330 op_dump(pm->op_pmreplroot);
332 if (pm->op_pmflags || (pm->op_pmregexp && pm->op_pmregexp->check_substr)) {
333 SV *tmpsv = newSVpvn("", 0);
334 if (pm->op_pmdynflags & PMdf_USED)
335 sv_catpv(tmpsv, ",USED");
336 if (pm->op_pmdynflags & PMdf_TAINTED)
337 sv_catpv(tmpsv, ",TAINTED");
338 if (pm->op_pmflags & PMf_ONCE)
339 sv_catpv(tmpsv, ",ONCE");
340 if (pm->op_pmregexp && pm->op_pmregexp->check_substr
341 && !(pm->op_pmregexp->reganch & ROPT_NOSCAN))
342 sv_catpv(tmpsv, ",SCANFIRST");
343 if (pm->op_pmregexp && pm->op_pmregexp->check_substr
344 && pm->op_pmregexp->reganch & ROPT_CHECK_ALL)
345 sv_catpv(tmpsv, ",ALL");
346 if (pm->op_pmflags & PMf_SKIPWHITE)
347 sv_catpv(tmpsv, ",SKIPWHITE");
348 if (pm->op_pmflags & PMf_CONST)
349 sv_catpv(tmpsv, ",CONST");
350 if (pm->op_pmflags & PMf_KEEP)
351 sv_catpv(tmpsv, ",KEEP");
352 if (pm->op_pmflags & PMf_GLOBAL)
353 sv_catpv(tmpsv, ",GLOBAL");
354 if (pm->op_pmflags & PMf_CONTINUE)
355 sv_catpv(tmpsv, ",CONTINUE");
356 if (pm->op_pmflags & PMf_RETAINT)
357 sv_catpv(tmpsv, ",RETAINT");
358 if (pm->op_pmflags & PMf_EVAL)
359 sv_catpv(tmpsv, ",EVAL");
360 Perl_dump_indent(aTHX_ level, file, "PMFLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
364 Perl_dump_indent(aTHX_ level-1, file, "}\n");
368 Perl_pmop_dump(pTHX_ PMOP *pm)
370 do_pmop_dump(0, Perl_debug_log, pm);
374 Perl_do_op_dump(pTHX_ I32 level, PerlIO *file, OP *o)
376 Perl_dump_indent(aTHX_ level, file, "{\n");
379 PerlIO_printf(file, "%-4d", o->op_seq);
381 PerlIO_printf(file, " ");
383 "%*sTYPE = %s ===> ",
384 (int)(PL_dumpindent*level-4), "", PL_op_name[o->op_type]);
387 PerlIO_printf(file, "%d\n", o->op_next->op_seq);
389 PerlIO_printf(file, "(%d)\n", o->op_next->op_seq);
392 PerlIO_printf(file, "DONE\n");
394 if (o->op_type == OP_NULL)
395 Perl_dump_indent(aTHX_ level, file, " (was %s)\n", PL_op_name[o->op_targ]);
397 Perl_dump_indent(aTHX_ level, file, "TARG = %ld\n", (long)o->op_targ);
400 Perl_dump_indent(aTHX_ level, file, "ADDR = 0x%"UVxf" => 0x%"UVxf"\n", (UV)o, (UV)o->op_next);
403 SV *tmpsv = newSVpvn("", 0);
404 switch (o->op_flags & OPf_WANT) {
406 sv_catpv(tmpsv, ",VOID");
408 case OPf_WANT_SCALAR:
409 sv_catpv(tmpsv, ",SCALAR");
412 sv_catpv(tmpsv, ",LIST");
415 sv_catpv(tmpsv, ",UNKNOWN");
418 if (o->op_flags & OPf_KIDS)
419 sv_catpv(tmpsv, ",KIDS");
420 if (o->op_flags & OPf_PARENS)
421 sv_catpv(tmpsv, ",PARENS");
422 if (o->op_flags & OPf_STACKED)
423 sv_catpv(tmpsv, ",STACKED");
424 if (o->op_flags & OPf_REF)
425 sv_catpv(tmpsv, ",REF");
426 if (o->op_flags & OPf_MOD)
427 sv_catpv(tmpsv, ",MOD");
428 if (o->op_flags & OPf_SPECIAL)
429 sv_catpv(tmpsv, ",SPECIAL");
430 Perl_dump_indent(aTHX_ level, file, "FLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
434 SV *tmpsv = newSVpvn("", 0);
435 if (PL_opargs[o->op_type] & OA_TARGLEX) {
436 if (o->op_private & OPpTARGET_MY)
437 sv_catpv(tmpsv, ",TARGET_MY");
439 if (o->op_type == OP_AASSIGN) {
440 if (o->op_private & OPpASSIGN_COMMON)
441 sv_catpv(tmpsv, ",COMMON");
442 if (o->op_private & OPpASSIGN_HASH)
443 sv_catpv(tmpsv, ",HASH");
445 else if (o->op_type == OP_SASSIGN) {
446 if (o->op_private & OPpASSIGN_BACKWARDS)
447 sv_catpv(tmpsv, ",BACKWARDS");
449 else if (o->op_type == OP_TRANS) {
450 if (o->op_private & OPpTRANS_SQUASH)
451 sv_catpv(tmpsv, ",SQUASH");
452 if (o->op_private & OPpTRANS_DELETE)
453 sv_catpv(tmpsv, ",DELETE");
454 if (o->op_private & OPpTRANS_COMPLEMENT)
455 sv_catpv(tmpsv, ",COMPLEMENT");
457 else if (o->op_type == OP_REPEAT) {
458 if (o->op_private & OPpREPEAT_DOLIST)
459 sv_catpv(tmpsv, ",DOLIST");
461 else if (o->op_type == OP_ENTERSUB ||
462 o->op_type == OP_RV2SV ||
463 o->op_type == OP_GVSV ||
464 o->op_type == OP_RV2AV ||
465 o->op_type == OP_RV2HV ||
466 o->op_type == OP_RV2GV ||
467 o->op_type == OP_AELEM ||
468 o->op_type == OP_HELEM )
470 if (o->op_type == OP_ENTERSUB) {
471 if (o->op_private & OPpENTERSUB_AMPER)
472 sv_catpv(tmpsv, ",AMPER");
473 if (o->op_private & OPpENTERSUB_DB)
474 sv_catpv(tmpsv, ",DB");
475 if (o->op_private & OPpENTERSUB_HASTARG)
476 sv_catpv(tmpsv, ",HASTARG");
479 switch (o->op_private & OPpDEREF) {
481 sv_catpv(tmpsv, ",SV");
484 sv_catpv(tmpsv, ",AV");
487 sv_catpv(tmpsv, ",HV");
490 if (o->op_type == OP_AELEM || o->op_type == OP_HELEM) {
491 if (o->op_private & OPpLVAL_DEFER)
492 sv_catpv(tmpsv, ",LVAL_DEFER");
495 if (o->op_private & HINT_STRICT_REFS)
496 sv_catpv(tmpsv, ",STRICT_REFS");
497 if (o->op_private & OPpOUR_INTRO)
498 sv_catpv(tmpsv, ",OUR_INTRO");
501 else if (o->op_type == OP_CONST) {
502 if (o->op_private & OPpCONST_BARE)
503 sv_catpv(tmpsv, ",BARE");
504 if (o->op_private & OPpCONST_STRICT)
505 sv_catpv(tmpsv, ",STRICT");
507 else if (o->op_type == OP_FLIP) {
508 if (o->op_private & OPpFLIP_LINENUM)
509 sv_catpv(tmpsv, ",LINENUM");
511 else if (o->op_type == OP_FLOP) {
512 if (o->op_private & OPpFLIP_LINENUM)
513 sv_catpv(tmpsv, ",LINENUM");
514 } else if (o->op_type == OP_RV2CV) {
515 if (o->op_private & OPpLVAL_INTRO)
516 sv_catpv(tmpsv, ",INTRO");
518 if (o->op_flags & OPf_MOD && o->op_private & OPpLVAL_INTRO)
519 sv_catpv(tmpsv, ",INTRO");
521 Perl_dump_indent(aTHX_ level, file, "PRIVATE = (%s)\n", SvPVX(tmpsv) + 1);
525 switch (o->op_type) {
530 Perl_dump_indent(aTHX_ level, file, "PADIX = %d\n", cPADOPo->op_padix);
533 SV *tmpsv = NEWSV(0,0);
537 gv_fullname3(tmpsv, (GV*)cSVOPo->op_sv, Nullch);
538 Perl_dump_indent(aTHX_ level, file, "GV = %s\n", SvPV(tmpsv, n_a));
542 Perl_dump_indent(aTHX_ level, file, "GV = NULL\n");
546 case OP_METHOD_NAMED:
547 Perl_dump_indent(aTHX_ level, file, "SV = %s\n", SvPEEK(cSVOPo->op_sv));
553 Perl_dump_indent(aTHX_ level, file, "LINE = %d\n",CopLINE(cCOPo));
554 if (CopSTASHPV(cCOPo))
555 Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
557 if (cCOPo->cop_label)
558 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
562 Perl_dump_indent(aTHX_ level, file, "REDO ===> ");
563 if (cLOOPo->op_redoop)
564 PerlIO_printf(file, "%d\n", cLOOPo->op_redoop->op_seq);
566 PerlIO_printf(file, "DONE\n");
567 Perl_dump_indent(aTHX_ level, file, "NEXT ===> ");
568 if (cLOOPo->op_nextop)
569 PerlIO_printf(file, "%d\n", cLOOPo->op_nextop->op_seq);
571 PerlIO_printf(file, "DONE\n");
572 Perl_dump_indent(aTHX_ level, file, "LAST ===> ");
573 if (cLOOPo->op_lastop)
574 PerlIO_printf(file, "%d\n", cLOOPo->op_lastop->op_seq);
576 PerlIO_printf(file, "DONE\n");
584 Perl_dump_indent(aTHX_ level, file, "OTHER ===> ");
585 if (cLOGOPo->op_other)
586 PerlIO_printf(file, "%d\n", cLOGOPo->op_other->op_seq);
588 PerlIO_printf(file, "DONE\n");
594 do_pmop_dump(level, file, cPMOPo);
602 if (o->op_private & OPpREFCOUNTED)
603 Perl_dump_indent(aTHX_ level, file, "REFCNT = %"UVuf"\n", (UV)o->op_targ);
608 if (o->op_flags & OPf_KIDS) {
610 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
611 do_op_dump(level, file, kid);
613 Perl_dump_indent(aTHX_ level-1, file, "}\n");
617 Perl_op_dump(pTHX_ OP *o)
619 do_op_dump(0, Perl_debug_log, o);
623 Perl_gv_dump(pTHX_ GV *gv)
628 PerlIO_printf(Perl_debug_log, "{}\n");
632 PerlIO_printf(Perl_debug_log, "{\n");
633 gv_fullname3(sv, gv, Nullch);
634 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "GV_NAME = %s", SvPVX(sv));
635 if (gv != GvEGV(gv)) {
636 gv_efullname3(sv, GvEGV(gv), Nullch);
637 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "-> %s", SvPVX(sv));
639 PerlIO_putc(Perl_debug_log, '\n');
640 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "}\n");
644 Perl_do_magic_dump(pTHX_ I32 level, PerlIO *file, MAGIC *mg, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
646 for (; mg; mg = mg->mg_moremagic) {
647 Perl_dump_indent(aTHX_ level, file,
648 " MAGIC = 0x%"UVxf"\n", PTR2UV(mg));
649 if (mg->mg_virtual) {
650 MGVTBL *v = mg->mg_virtual;
652 if (v == &PL_vtbl_sv) s = "sv";
653 else if (v == &PL_vtbl_env) s = "env";
654 else if (v == &PL_vtbl_envelem) s = "envelem";
655 else if (v == &PL_vtbl_sig) s = "sig";
656 else if (v == &PL_vtbl_sigelem) s = "sigelem";
657 else if (v == &PL_vtbl_pack) s = "pack";
658 else if (v == &PL_vtbl_packelem) s = "packelem";
659 else if (v == &PL_vtbl_dbline) s = "dbline";
660 else if (v == &PL_vtbl_isa) s = "isa";
661 else if (v == &PL_vtbl_arylen) s = "arylen";
662 else if (v == &PL_vtbl_glob) s = "glob";
663 else if (v == &PL_vtbl_mglob) s = "mglob";
664 else if (v == &PL_vtbl_nkeys) s = "nkeys";
665 else if (v == &PL_vtbl_taint) s = "taint";
666 else if (v == &PL_vtbl_substr) s = "substr";
667 else if (v == &PL_vtbl_vec) s = "vec";
668 else if (v == &PL_vtbl_pos) s = "pos";
669 else if (v == &PL_vtbl_bm) s = "bm";
670 else if (v == &PL_vtbl_fm) s = "fm";
671 else if (v == &PL_vtbl_uvar) s = "uvar";
672 else if (v == &PL_vtbl_defelem) s = "defelem";
673 #ifdef USE_LOCALE_COLLATE
674 else if (v == &PL_vtbl_collxfrm) s = "collxfrm";
676 else if (v == &PL_vtbl_amagic) s = "amagic";
677 else if (v == &PL_vtbl_amagicelem) s = "amagicelem";
678 else if (v == &PL_vtbl_backref) s = "backref";
680 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = &PL_vtbl_%s\n", s);
682 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0x%"UVxf"\n", PTR2UV(v));
685 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0\n");
688 Perl_dump_indent(aTHX_ level, file, " MG_PRIVATE = %d\n", mg->mg_private);
690 if (isPRINT(mg->mg_type))
691 Perl_dump_indent(aTHX_ level, file, " MG_TYPE = '%c'\n", mg->mg_type);
693 Perl_dump_indent(aTHX_ level, file, " MG_TYPE = '\\%o'\n", mg->mg_type);
696 Perl_dump_indent(aTHX_ level, file, " MG_FLAGS = 0x%02X\n", mg->mg_flags);
697 if (mg->mg_flags & MGf_TAINTEDDIR)
698 Perl_dump_indent(aTHX_ level, file, " TAINTEDDIR\n");
699 if (mg->mg_flags & MGf_REFCOUNTED)
700 Perl_dump_indent(aTHX_ level, file, " REFCOUNTED\n");
701 if (mg->mg_flags & MGf_GSKIP)
702 Perl_dump_indent(aTHX_ level, file, " GSKIP\n");
703 if (mg->mg_flags & MGf_MINMATCH)
704 Perl_dump_indent(aTHX_ level, file, " MINMATCH\n");
707 Perl_dump_indent(aTHX_ level, file, " MG_OBJ = 0x%"UVxf"\n", PTR2UV(mg->mg_obj));
708 if (mg->mg_flags & MGf_REFCOUNTED)
709 do_sv_dump(level+2, file, mg->mg_obj, nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
712 Perl_dump_indent(aTHX_ level, file, " MG_LEN = %ld\n", (long)mg->mg_len);
714 Perl_dump_indent(aTHX_ level, file, " MG_PTR = 0x%"UVxf, PTR2UV(mg->mg_ptr));
715 if (mg->mg_len >= 0) {
716 SV *sv = newSVpvn("", 0);
717 PerlIO_printf(file, " %s", pv_display(sv, mg->mg_ptr, mg->mg_len, 0, pvlim));
720 else if (mg->mg_len == HEf_SVKEY) {
721 PerlIO_puts(file, " => HEf_SVKEY\n");
722 do_sv_dump(level+2, file, (SV*)((mg)->mg_ptr), nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
726 PerlIO_puts(file, " ???? - please notify IZ");
727 PerlIO_putc(file, '\n');
733 Perl_magic_dump(pTHX_ MAGIC *mg)
735 do_magic_dump(0, Perl_debug_log, mg, 0, 0, 0, 0);
739 Perl_do_hv_dump(pTHX_ I32 level, PerlIO *file, char *name, HV *sv)
741 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
742 if (sv && HvNAME(sv))
743 PerlIO_printf(file, "\t\"%s\"\n", HvNAME(sv));
745 PerlIO_putc(file, '\n');
749 Perl_do_gv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
751 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
752 if (sv && GvNAME(sv))
753 PerlIO_printf(file, "\t\"%s\"\n", GvNAME(sv));
755 PerlIO_putc(file, '\n');
759 Perl_do_gvgv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
761 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
762 if (sv && GvNAME(sv)) {
763 PerlIO_printf(file, "\t\"");
764 if (GvSTASH(sv) && HvNAME(GvSTASH(sv)))
765 PerlIO_printf(file, "%s\" :: \"", HvNAME(GvSTASH(sv)));
766 PerlIO_printf(file, "%s\"\n", GvNAME(sv));
769 PerlIO_putc(file, '\n');
773 Perl_do_sv_dump(pTHX_ I32 level, PerlIO *file, SV *sv, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
782 Perl_dump_indent(aTHX_ level, file, "SV = 0\n");
789 d = Perl_newSVpvf(aTHX_
790 "(0x%"UVxf") at 0x%"UVxf"\n%*s REFCNT = %"IVdf"\n%*s FLAGS = (",
791 PTR2UV(SvANY(sv)), PTR2UV(sv),
792 (int)(PL_dumpindent*level), "", (IV)SvREFCNT(sv),
793 (int)(PL_dumpindent*level), "");
795 if (flags & SVs_PADBUSY) sv_catpv(d, "PADBUSY,");
796 if (flags & SVs_PADTMP) sv_catpv(d, "PADTMP,");
797 if (flags & SVs_PADMY) sv_catpv(d, "PADMY,");
798 if (flags & SVs_TEMP) sv_catpv(d, "TEMP,");
799 if (flags & SVs_OBJECT) sv_catpv(d, "OBJECT,");
800 if (flags & SVs_GMG) sv_catpv(d, "GMG,");
801 if (flags & SVs_SMG) sv_catpv(d, "SMG,");
802 if (flags & SVs_RMG) sv_catpv(d, "RMG,");
804 if (flags & SVf_IOK) sv_catpv(d, "IOK,");
805 if (flags & SVf_NOK) sv_catpv(d, "NOK,");
806 if (flags & SVf_POK) sv_catpv(d, "POK,");
807 if (flags & SVf_ROK) {
809 if (SvWEAKREF(sv)) sv_catpv(d, "WEAKREF,");
811 if (flags & SVf_OOK) sv_catpv(d, "OOK,");
812 if (flags & SVf_FAKE) sv_catpv(d, "FAKE,");
813 if (flags & SVf_READONLY) sv_catpv(d, "READONLY,");
815 if (flags & SVf_AMAGIC) sv_catpv(d, "OVERLOAD,");
816 if (flags & SVp_IOK) sv_catpv(d, "pIOK,");
817 if (flags & SVp_NOK) sv_catpv(d, "pNOK,");
818 if (flags & SVp_POK) sv_catpv(d, "pPOK,");
819 if (flags & SVp_SCREAM) sv_catpv(d, "SCREAM,");
824 if (CvANON(sv)) sv_catpv(d, "ANON,");
825 if (CvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
826 if (CvCLONE(sv)) sv_catpv(d, "CLONE,");
827 if (CvCLONED(sv)) sv_catpv(d, "CLONED,");
828 if (CvCONST(sv)) sv_catpv(d, "CONST,");
829 if (CvNODEBUG(sv)) sv_catpv(d, "NODEBUG,");
830 if (SvCOMPILED(sv)) sv_catpv(d, "COMPILED,");
831 if (CvLVALUE(sv)) sv_catpv(d, "LVALUE,");
832 if (CvMETHOD(sv)) sv_catpv(d, "METHOD,");
835 if (HvSHAREKEYS(sv)) sv_catpv(d, "SHAREKEYS,");
836 if (HvLAZYDEL(sv)) sv_catpv(d, "LAZYDEL,");
839 if (GvINTRO(sv)) sv_catpv(d, "INTRO,");
840 if (GvMULTI(sv)) sv_catpv(d, "MULTI,");
841 if (GvASSUMECV(sv)) sv_catpv(d, "ASSUMECV,");
842 if (GvIN_PAD(sv)) sv_catpv(d, "IN_PAD,");
843 if (GvIMPORTED(sv)) {
844 sv_catpv(d, "IMPORT");
845 if (GvIMPORTED(sv) == GVf_IMPORTED)
849 if (GvIMPORTED_SV(sv)) sv_catpv(d, " SV");
850 if (GvIMPORTED_AV(sv)) sv_catpv(d, " AV");
851 if (GvIMPORTED_HV(sv)) sv_catpv(d, " HV");
852 if (GvIMPORTED_CV(sv)) sv_catpv(d, " CV");
858 if (SvEVALED(sv)) sv_catpv(d, "EVALED,");
859 if (SvIsUV(sv)) sv_catpv(d, "IsUV,");
860 if (SvUTF8(sv)) sv_catpv(d, "UTF8");
863 if (SvTAIL(sv)) sv_catpv(d, "TAIL,");
864 if (SvVALID(sv)) sv_catpv(d, "VALID,");
868 if (*(SvEND(d) - 1) == ',')
869 SvPVX(d)[--SvCUR(d)] = '\0';
873 Perl_dump_indent(aTHX_ level, file, "SV = ");
876 PerlIO_printf(file, "NULL%s\n", s);
880 PerlIO_printf(file, "IV%s\n", s);
883 PerlIO_printf(file, "NV%s\n", s);
886 PerlIO_printf(file, "RV%s\n", s);
889 PerlIO_printf(file, "PV%s\n", s);
892 PerlIO_printf(file, "PVIV%s\n", s);
895 PerlIO_printf(file, "PVNV%s\n", s);
898 PerlIO_printf(file, "PVBM%s\n", s);
901 PerlIO_printf(file, "PVMG%s\n", s);
904 PerlIO_printf(file, "PVLV%s\n", s);
907 PerlIO_printf(file, "PVAV%s\n", s);
910 PerlIO_printf(file, "PVHV%s\n", s);
913 PerlIO_printf(file, "PVCV%s\n", s);
916 PerlIO_printf(file, "PVGV%s\n", s);
919 PerlIO_printf(file, "PVFM%s\n", s);
922 PerlIO_printf(file, "PVIO%s\n", s);
925 PerlIO_printf(file, "UNKNOWN(0x%"UVxf") %s\n", (UV)type, s);
929 if (type >= SVt_PVIV || type == SVt_IV) {
931 Perl_dump_indent(aTHX_ level, file, " UV = %"UVuf, (UV)SvUVX(sv));
933 Perl_dump_indent(aTHX_ level, file, " IV = %"IVdf, (IV)SvIVX(sv));
935 PerlIO_printf(file, " (OFFSET)");
936 PerlIO_putc(file, '\n');
938 if (type >= SVt_PVNV || type == SVt_NV) {
939 STORE_NUMERIC_LOCAL_SET_STANDARD();
940 /* %Vg doesn't work? --jhi */
941 #ifdef USE_LONG_DOUBLE
942 Perl_dump_indent(aTHX_ level, file, " NV = %.*" PERL_PRIgldbl "\n", LDBL_DIG, SvNVX(sv));
944 Perl_dump_indent(aTHX_ level, file, " NV = %.*g\n", DBL_DIG, SvNVX(sv));
946 RESTORE_NUMERIC_LOCAL();
949 Perl_dump_indent(aTHX_ level, file, " RV = 0x%"UVxf"\n", PTR2UV(SvRV(sv)));
951 do_sv_dump(level+1, file, SvRV(sv), nest+1, maxnest, dumpops, pvlim);
959 if (type <= SVt_PVLV) {
961 Perl_dump_indent(aTHX_ level, file," PV = 0x%"UVxf" ", PTR2UV(SvPVX(sv)));
963 PerlIO_printf(file, "( %s . ) ", pv_display(d, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, pvlim));
964 PerlIO_printf(file, "%s\n", pv_display(d, SvPVX(sv), SvCUR(sv), SvLEN(sv), pvlim));
965 Perl_dump_indent(aTHX_ level, file, " CUR = %"IVdf"\n", (IV)SvCUR(sv));
966 Perl_dump_indent(aTHX_ level, file, " LEN = %"IVdf"\n", (IV)SvLEN(sv));
969 Perl_dump_indent(aTHX_ level, file, " PV = 0\n");
971 if (type >= SVt_PVMG) {
973 do_magic_dump(level, file, SvMAGIC(sv), nest, maxnest, dumpops, pvlim);
975 do_hv_dump(level, file, " STASH", SvSTASH(sv));
979 Perl_dump_indent(aTHX_ level, file, " TYPE = %c\n", LvTYPE(sv));
980 Perl_dump_indent(aTHX_ level, file, " TARGOFF = %"IVdf"\n", (IV)LvTARGOFF(sv));
981 Perl_dump_indent(aTHX_ level, file, " TARGLEN = %"IVdf"\n", (IV)LvTARGLEN(sv));
982 Perl_dump_indent(aTHX_ level, file, " TARG = 0x%"UVxf"\n", PTR2UV(LvTARG(sv)));
983 /* XXX level+1 ??? */
984 do_sv_dump(level, file, LvTARG(sv), nest+1, maxnest, dumpops, pvlim);
987 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(AvARRAY(sv)));
988 if (AvARRAY(sv) != AvALLOC(sv)) {
989 PerlIO_printf(file, " (offset=%"IVdf")\n", (IV)(AvARRAY(sv) - AvALLOC(sv)));
990 Perl_dump_indent(aTHX_ level, file, " ALLOC = 0x%"UVxf"\n", PTR2UV(AvALLOC(sv)));
993 PerlIO_putc(file, '\n');
994 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)AvFILLp(sv));
995 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)AvMAX(sv));
996 Perl_dump_indent(aTHX_ level, file, " ARYLEN = 0x%"UVxf"\n", PTR2UV(AvARYLEN(sv)));
999 if (flags & AVf_REAL) sv_catpv(d, ",REAL");
1000 if (flags & AVf_REIFY) sv_catpv(d, ",REIFY");
1001 if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
1002 Perl_dump_indent(aTHX_ level, file, " FLAGS = (%s)\n", SvCUR(d) ? SvPVX(d) + 1 : "");
1003 if (nest < maxnest && av_len((AV*)sv) >= 0) {
1005 for (count = 0; count <= av_len((AV*)sv) && count < maxnest; count++) {
1006 SV** elt = av_fetch((AV*)sv,count,0);
1008 Perl_dump_indent(aTHX_ level + 1, file, "Elt No. %"IVdf"\n", (IV)count);
1010 do_sv_dump(level+1, file, *elt, nest+1, maxnest, dumpops, pvlim);
1015 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(HvARRAY(sv)));
1016 if (HvARRAY(sv) && HvKEYS(sv)) {
1017 /* Show distribution of HEs in the ARRAY */
1019 #define FREQ_MAX (sizeof freq / sizeof freq[0] - 1)
1022 U32 pow2 = 2, keys = HvKEYS(sv);
1023 NV theoret, sum = 0;
1025 PerlIO_printf(file, " (");
1026 Zero(freq, FREQ_MAX + 1, int);
1027 for (i = 0; i <= HvMAX(sv); i++) {
1028 HE* h; int count = 0;
1029 for (h = HvARRAY(sv)[i]; h; h = HeNEXT(h))
1031 if (count > FREQ_MAX)
1037 for (i = 0; i <= max; i++) {
1039 PerlIO_printf(file, "%d%s:%d", i,
1040 (i == FREQ_MAX) ? "+" : "",
1043 PerlIO_printf(file, ", ");
1046 PerlIO_putc(file, ')');
1047 /* Now calculate quality wrt theoretical value */
1048 for (i = max; i > 0; i--) { /* Precision: count down. */
1049 sum += freq[i] * i * i;
1051 while ((keys = keys >> 1))
1053 /* Approximate by Poisson distribution */
1054 theoret = HvKEYS(sv);
1055 theoret += theoret * theoret/pow2;
1056 PerlIO_putc(file, '\n');
1057 Perl_dump_indent(aTHX_ level, file, " hash quality = %.1"NVff"%%", theoret/sum*100);
1059 PerlIO_putc(file, '\n');
1060 Perl_dump_indent(aTHX_ level, file, " KEYS = %"IVdf"\n", (IV)HvKEYS(sv));
1061 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)HvFILL(sv));
1062 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)HvMAX(sv));
1063 Perl_dump_indent(aTHX_ level, file, " RITER = %"IVdf"\n", (IV)HvRITER(sv));
1064 Perl_dump_indent(aTHX_ level, file, " EITER = 0x%"UVxf"\n", PTR2UV(HvEITER(sv)));
1066 Perl_dump_indent(aTHX_ level, file, " PMROOT = 0x%"UVxf"\n", PTR2UV(HvPMROOT(sv)));
1068 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", HvNAME(sv));
1069 if (nest < maxnest && !HvEITER(sv)) { /* Try to preserve iterator */
1072 int count = maxnest - nest;
1075 while ((he = hv_iternext(hv)) && count--) {
1079 U32 hash = HeHASH(he);
1081 key = hv_iterkey(he, &len);
1082 elt = hv_iterval(hv, he);
1083 Perl_dump_indent(aTHX_ level+1, file, "Elt %s HASH = 0x%"UVxf"\n", pv_display(d, key, len, 0, pvlim), (UV)hash);
1084 do_sv_dump(level+1, file, elt, nest+1, maxnest, dumpops, pvlim);
1086 hv_iterinit(hv); /* Return to status quo */
1091 Perl_dump_indent(aTHX_ level, file, " PROTOTYPE = \"%s\"\n", SvPV(sv,n_a));
1094 do_hv_dump(level, file, " COMP_STASH", CvSTASH(sv));
1096 Perl_dump_indent(aTHX_ level, file, " START = 0x%"UVxf" ===> %"IVdf"\n", PTR2UV(CvSTART(sv)), (IV)CvSTART(sv)->op_seq);
1097 Perl_dump_indent(aTHX_ level, file, " ROOT = 0x%"UVxf"\n", PTR2UV(CvROOT(sv)));
1098 if (CvROOT(sv) && dumpops)
1099 do_op_dump(level+1, file, CvROOT(sv));
1100 Perl_dump_indent(aTHX_ level, file, " XSUB = 0x%"UVxf"\n", PTR2UV(CvXSUB(sv)));
1101 Perl_dump_indent(aTHX_ level, file, " XSUBANY = %"IVdf"\n", (IV)CvXSUBANY(sv).any_i32);
1102 do_gvgv_dump(level, file, " GVGV::GV", CvGV(sv));
1103 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", CvFILE(sv));
1104 Perl_dump_indent(aTHX_ level, file, " DEPTH = %"IVdf"\n", (IV)CvDEPTH(sv));
1106 Perl_dump_indent(aTHX_ level, file, " MUTEXP = 0x%"UVxf"\n", PTR2UV(CvMUTEXP(sv)));
1107 Perl_dump_indent(aTHX_ level, file, " OWNER = 0x%"UVxf"\n", PTR2UV(CvOWNER(sv)));
1108 #endif /* USE_THREADS */
1109 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)CvFLAGS(sv));
1110 if (type == SVt_PVFM)
1111 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)FmLINES(sv));
1112 Perl_dump_indent(aTHX_ level, file, " PADLIST = 0x%"UVxf"\n", PTR2UV(CvPADLIST(sv)));
1113 if (nest < maxnest && CvPADLIST(sv)) {
1114 AV* padlist = CvPADLIST(sv);
1115 AV* pad_name = (AV*)*av_fetch(padlist, 0, FALSE);
1116 AV* pad = (AV*)*av_fetch(padlist, 1, FALSE);
1117 SV** pname = AvARRAY(pad_name);
1118 SV** ppad = AvARRAY(pad);
1121 for (ix = 1; ix <= AvFILL(pad_name); ix++) {
1122 if (SvPOK(pname[ix]))
1123 Perl_dump_indent(aTHX_ level,
1124 /* %5d below is enough whitespace. */
1126 "%5d. 0x%"UVxf" (%s\"%s\" %"IVdf"-%"IVdf")\n",
1127 (int)ix, PTR2UV(ppad[ix]),
1128 SvFAKE(pname[ix]) ? "FAKE " : "",
1130 (IV)SvNVX(pname[ix]),
1131 (IV)SvIVX(pname[ix]));
1135 CV *outside = CvOUTSIDE(sv);
1136 Perl_dump_indent(aTHX_ level, file, " OUTSIDE = 0x%"UVxf" (%s)\n",
1139 : CvANON(outside) ? "ANON"
1140 : (outside == PL_main_cv) ? "MAIN"
1141 : CvUNIQUE(outside) ? "UNIQUE"
1142 : CvGV(outside) ? GvNAME(CvGV(outside)) : "UNDEFINED"));
1144 if (nest < maxnest && (CvCLONE(sv) || CvCLONED(sv)))
1145 do_sv_dump(level+1, file, (SV*)CvOUTSIDE(sv), nest+1, maxnest, dumpops, pvlim);
1148 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", GvNAME(sv));
1149 Perl_dump_indent(aTHX_ level, file, " NAMELEN = %"IVdf"\n", (IV)GvNAMELEN(sv));
1150 do_hv_dump (level, file, " GvSTASH", GvSTASH(sv));
1151 Perl_dump_indent(aTHX_ level, file, " GP = 0x%"UVxf"\n", PTR2UV(GvGP(sv)));
1154 Perl_dump_indent(aTHX_ level, file, " SV = 0x%"UVxf"\n", PTR2UV(GvSV(sv)));
1155 Perl_dump_indent(aTHX_ level, file, " REFCNT = %"IVdf"\n", (IV)GvREFCNT(sv));
1156 Perl_dump_indent(aTHX_ level, file, " IO = 0x%"UVxf"\n", PTR2UV(GvIOp(sv)));
1157 Perl_dump_indent(aTHX_ level, file, " FORM = 0x%"UVxf" \n", PTR2UV(GvFORM(sv)));
1158 Perl_dump_indent(aTHX_ level, file, " AV = 0x%"UVxf"\n", PTR2UV(GvAV(sv)));
1159 Perl_dump_indent(aTHX_ level, file, " HV = 0x%"UVxf"\n", PTR2UV(GvHV(sv)));
1160 Perl_dump_indent(aTHX_ level, file, " CV = 0x%"UVxf"\n", PTR2UV(GvCV(sv)));
1161 Perl_dump_indent(aTHX_ level, file, " CVGEN = 0x%"UVxf"\n", (UV)GvCVGEN(sv));
1162 Perl_dump_indent(aTHX_ level, file, " GPFLAGS = 0x%"UVxf"\n", (UV)GvGPFLAGS(sv));
1163 Perl_dump_indent(aTHX_ level, file, " LINE = %"IVdf"\n", (IV)GvLINE(sv));
1164 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", GvFILE(sv));
1165 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)GvFLAGS(sv));
1166 do_gv_dump (level, file, " EGV", GvEGV(sv));
1169 Perl_dump_indent(aTHX_ level, file, " IFP = 0x%"UVxf"\n", PTR2UV(IoIFP(sv)));
1170 Perl_dump_indent(aTHX_ level, file, " OFP = 0x%"UVxf"\n", PTR2UV(IoOFP(sv)));
1171 Perl_dump_indent(aTHX_ level, file, " DIRP = 0x%"UVxf"\n", PTR2UV(IoDIRP(sv)));
1172 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)IoLINES(sv));
1173 Perl_dump_indent(aTHX_ level, file, " PAGE = %"IVdf"\n", (IV)IoPAGE(sv));
1174 Perl_dump_indent(aTHX_ level, file, " PAGE_LEN = %"IVdf"\n", (IV)IoPAGE_LEN(sv));
1175 Perl_dump_indent(aTHX_ level, file, " LINES_LEFT = %"IVdf"\n", (IV)IoLINES_LEFT(sv));
1177 Perl_dump_indent(aTHX_ level, file, " TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
1178 do_gv_dump (level, file, " TOP_GV", IoTOP_GV(sv));
1180 Perl_dump_indent(aTHX_ level, file, " FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
1181 do_gv_dump (level, file, " FMT_GV", IoFMT_GV(sv));
1182 if (IoBOTTOM_NAME(sv))
1183 Perl_dump_indent(aTHX_ level, file, " BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
1184 do_gv_dump (level, file, " BOTTOM_GV", IoBOTTOM_GV(sv));
1185 Perl_dump_indent(aTHX_ level, file, " SUBPROCESS = %"IVdf"\n", (IV)IoSUBPROCESS(sv));
1186 if (isPRINT(IoTYPE(sv)))
1187 Perl_dump_indent(aTHX_ level, file, " TYPE = '%c'\n", IoTYPE(sv));
1189 Perl_dump_indent(aTHX_ level, file, " TYPE = '\\%o'\n", IoTYPE(sv));
1190 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)IoFLAGS(sv));
1197 Perl_sv_dump(pTHX_ SV *sv)
1199 do_sv_dump(0, Perl_debug_log, sv, 0, 0, 0, 0);