3 * Copyright (c) 1991-1999, 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
20 #define DBL_DIG 15 /* A guess that works lots of places */
24 Perl_dump_indent(pTHX_ I32 level, PerlIO *file, const char* pat, ...)
30 PerlIO_printf(file, "%*s", level*PL_dumpindent, "");
31 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)
54 for (i = 0; i <= (I32) HvMAX(stash); i++) {
55 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
56 GV *gv = (GV*)HeVAL(entry);
58 if (SvTYPE(gv) != SVt_PVGV || !GvGP(gv))
64 if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
65 (hv = GvHV(gv)) && HvNAME(hv) && hv != PL_defstash)
66 dump_packsubs(hv); /* nested package */
72 Perl_dump_sub(pTHX_ GV *gv)
74 SV *sv = sv_newmortal();
76 gv_fullname3(sv, gv, Nullch);
77 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nSUB %s = ", SvPVX(sv));
79 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "(xsub 0x%x %d)\n",
80 (long)CvXSUB(GvCV(gv)),
81 CvXSUBANY(GvCV(gv)).any_i32);
82 else if (CvROOT(GvCV(gv)))
83 op_dump(CvROOT(GvCV(gv)));
85 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
89 Perl_dump_form(pTHX_ GV *gv)
91 SV *sv = sv_newmortal();
93 gv_fullname3(sv, gv, Nullch);
94 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nFORMAT %s = ", SvPVX(sv));
95 if (CvROOT(GvFORM(gv)))
96 op_dump(CvROOT(GvFORM(gv)));
98 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
104 op_dump(PL_eval_root);
108 Perl_pv_display(pTHX_ SV *sv, char *pv, STRLEN cur, STRLEN len, STRLEN pvlim)
111 int nul_terminated = len > cur && pv[cur] == '\0';
113 sv_setpvn(sv, "\"", 1);
114 for (; cur--; pv++) {
115 if (pvlim && SvCUR(sv) >= pvlim) {
121 case '\t': sv_catpvn(sv, "\\t", 2); break;
122 case '\n': sv_catpvn(sv, "\\n", 2); break;
123 case '\r': sv_catpvn(sv, "\\r", 2); break;
124 case '\f': sv_catpvn(sv, "\\f", 2); break;
125 case '"': sv_catpvn(sv, "\\\"", 2); break;
126 case '\\': sv_catpvn(sv, "\\\\", 2); break;
127 default: sv_catpvn(sv, pv, 1); break;
131 if (cur && isDIGIT(*(pv+1)))
132 Perl_sv_catpvf(aTHX_ sv, "\\%03o", *pv);
134 Perl_sv_catpvf(aTHX_ sv, "\\%o", *pv);
137 sv_catpvn(sv, "\"", 1);
139 sv_catpvn(sv, "...", 3);
141 sv_catpvn(sv, "\\0", 2);
147 Perl_sv_peek(pTHX_ SV *sv)
149 SV *t = sv_newmortal();
159 else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
163 else if (sv == &PL_sv_undef || sv == &PL_sv_no || sv == &PL_sv_yes) {
164 if (sv == &PL_sv_undef) {
165 sv_catpv(t, "SV_UNDEF");
166 if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
167 SVs_GMG|SVs_SMG|SVs_RMG)) &&
171 else if (sv == &PL_sv_no) {
172 sv_catpv(t, "SV_NO");
173 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
174 SVs_GMG|SVs_SMG|SVs_RMG)) &&
175 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
182 sv_catpv(t, "SV_YES");
183 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
184 SVs_GMG|SVs_SMG|SVs_RMG)) &&
185 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
188 SvPVX(sv) && *SvPVX(sv) == '1' &&
194 else if (SvREFCNT(sv) == 0) {
200 if (SvCUR(t) + unref > 10) {
201 SvCUR(t) = unref + 3;
209 switch (SvTYPE(sv)) {
211 sv_catpv(t, "FREED");
215 sv_catpv(t, "UNDEF");
249 Perl_sv_catpvf(aTHX_ t, "CV(%s)", GvNAME(CvGV(sv)));
269 sv_catpv(t, "(null)");
271 SV *tmp = newSVpvn("", 0);
274 Perl_sv_catpvf(aTHX_ t, "[%s]", pv_display(tmp, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, 127));
275 Perl_sv_catpvf(aTHX_ t, "%s)", pv_display(tmp, SvPVX(sv), SvCUR(sv), SvLEN(sv), 127));
279 else if (SvNOKp(sv)) {
280 RESTORE_NUMERIC_STANDARD();
281 Perl_sv_catpvf(aTHX_ t, "(%g)",SvNVX(sv));
282 RESTORE_NUMERIC_LOCAL();
284 else if (SvIOKp(sv)) { /* XXXX: IV, UV? */
286 Perl_sv_catpvf(aTHX_ t, "(%lu)",(unsigned long)SvUVX(sv));
288 Perl_sv_catpvf(aTHX_ t, "(%ld)",(long)SvIVX(sv));
302 Perl_do_pmop_dump(pTHX_ I32 level, PerlIO *file, PMOP *pm)
307 Perl_dump_indent(aTHX_ level, file, "{}\n");
310 Perl_dump_indent(aTHX_ level, file, "{\n");
312 if (pm->op_pmflags & PMf_ONCE)
317 Perl_dump_indent(aTHX_ level, file, "PMf_PRE %c%s%c%s\n",
318 ch, pm->op_pmregexp->precomp, ch,
319 (pm->op_private & OPpRUNTIME) ? " (RUNTIME)" : "");
321 Perl_dump_indent(aTHX_ level, file, "PMf_PRE (RUNTIME)\n");
322 if (pm->op_type != OP_PUSHRE && pm->op_pmreplroot) {
323 Perl_dump_indent(aTHX_ level, file, "PMf_REPL = ");
324 op_dump(pm->op_pmreplroot);
326 if (pm->op_pmflags || (pm->op_pmregexp && pm->op_pmregexp->check_substr)) {
327 SV *tmpsv = newSVpvn("", 0);
328 if (pm->op_pmdynflags & PMdf_USED)
329 sv_catpv(tmpsv, ",USED");
330 if (pm->op_pmdynflags & PMdf_TAINTED)
331 sv_catpv(tmpsv, ",TAINTED");
332 if (pm->op_pmflags & PMf_ONCE)
333 sv_catpv(tmpsv, ",ONCE");
334 if (pm->op_pmregexp && pm->op_pmregexp->check_substr
335 && !(pm->op_pmregexp->reganch & ROPT_NOSCAN))
336 sv_catpv(tmpsv, ",SCANFIRST");
337 if (pm->op_pmregexp && pm->op_pmregexp->check_substr
338 && pm->op_pmregexp->reganch & ROPT_CHECK_ALL)
339 sv_catpv(tmpsv, ",ALL");
340 if (pm->op_pmflags & PMf_SKIPWHITE)
341 sv_catpv(tmpsv, ",SKIPWHITE");
342 if (pm->op_pmflags & PMf_CONST)
343 sv_catpv(tmpsv, ",CONST");
344 if (pm->op_pmflags & PMf_KEEP)
345 sv_catpv(tmpsv, ",KEEP");
346 if (pm->op_pmflags & PMf_GLOBAL)
347 sv_catpv(tmpsv, ",GLOBAL");
348 if (pm->op_pmflags & PMf_CONTINUE)
349 sv_catpv(tmpsv, ",CONTINUE");
350 if (pm->op_pmflags & PMf_RETAINT)
351 sv_catpv(tmpsv, ",RETAINT");
352 if (pm->op_pmflags & PMf_EVAL)
353 sv_catpv(tmpsv, ",EVAL");
354 Perl_dump_indent(aTHX_ level, file, "PMFLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
358 Perl_dump_indent(aTHX_ level-1, file, "}\n");
362 Perl_pmop_dump(pTHX_ PMOP *pm)
364 do_pmop_dump(0, Perl_debug_log, pm);
368 Perl_do_op_dump(pTHX_ I32 level, PerlIO *file, OP *o)
372 Perl_dump_indent(aTHX_ level, file, "{\n");
375 PerlIO_printf(file, "%-4d", o->op_seq);
377 PerlIO_printf(file, " ");
378 PerlIO_printf(file, "%*sTYPE = %s ===> ", PL_dumpindent*level-4, "", PL_op_name[o->op_type]);
381 PerlIO_printf(file, "%d\n", o->op_next->op_seq);
383 PerlIO_printf(file, "(%d)\n", o->op_next->op_seq);
386 PerlIO_printf(file, "DONE\n");
388 if (o->op_type == OP_NULL)
389 Perl_dump_indent(aTHX_ level, file, " (was %s)\n", PL_op_name[o->op_targ]);
391 Perl_dump_indent(aTHX_ level, file, "TARG = %d\n", o->op_targ);
394 Perl_dump_indent(aTHX_ level, file, "ADDR = 0x%lx => 0x%lx\n",o, o->op_next);
397 SV *tmpsv = newSVpvn("", 0);
398 switch (o->op_flags & OPf_WANT) {
400 sv_catpv(tmpsv, ",VOID");
402 case OPf_WANT_SCALAR:
403 sv_catpv(tmpsv, ",SCALAR");
406 sv_catpv(tmpsv, ",LIST");
409 sv_catpv(tmpsv, ",UNKNOWN");
412 if (o->op_flags & OPf_KIDS)
413 sv_catpv(tmpsv, ",KIDS");
414 if (o->op_flags & OPf_PARENS)
415 sv_catpv(tmpsv, ",PARENS");
416 if (o->op_flags & OPf_STACKED)
417 sv_catpv(tmpsv, ",STACKED");
418 if (o->op_flags & OPf_REF)
419 sv_catpv(tmpsv, ",REF");
420 if (o->op_flags & OPf_MOD)
421 sv_catpv(tmpsv, ",MOD");
422 if (o->op_flags & OPf_SPECIAL)
423 sv_catpv(tmpsv, ",SPECIAL");
424 Perl_dump_indent(aTHX_ level, file, "FLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
428 SV *tmpsv = newSVpvn("", 0);
429 if (o->op_type == OP_AASSIGN) {
430 if (o->op_private & OPpASSIGN_COMMON)
431 sv_catpv(tmpsv, ",COMMON");
433 else if (o->op_type == OP_SASSIGN) {
434 if (o->op_private & OPpASSIGN_BACKWARDS)
435 sv_catpv(tmpsv, ",BACKWARDS");
437 else if (o->op_type == OP_TRANS) {
438 if (o->op_private & OPpTRANS_SQUASH)
439 sv_catpv(tmpsv, ",SQUASH");
440 if (o->op_private & OPpTRANS_DELETE)
441 sv_catpv(tmpsv, ",DELETE");
442 if (o->op_private & OPpTRANS_COMPLEMENT)
443 sv_catpv(tmpsv, ",COMPLEMENT");
445 else if (o->op_type == OP_REPEAT) {
446 if (o->op_private & OPpREPEAT_DOLIST)
447 sv_catpv(tmpsv, ",DOLIST");
449 else if (o->op_type == OP_ENTERSUB ||
450 o->op_type == OP_RV2SV ||
451 o->op_type == OP_RV2AV ||
452 o->op_type == OP_RV2HV ||
453 o->op_type == OP_RV2GV ||
454 o->op_type == OP_AELEM ||
455 o->op_type == OP_HELEM )
457 if (o->op_type == OP_ENTERSUB) {
458 if (o->op_private & OPpENTERSUB_AMPER)
459 sv_catpv(tmpsv, ",AMPER");
460 if (o->op_private & OPpENTERSUB_DB)
461 sv_catpv(tmpsv, ",DB");
463 switch (o->op_private & OPpDEREF) {
465 sv_catpv(tmpsv, ",SV");
468 sv_catpv(tmpsv, ",AV");
471 sv_catpv(tmpsv, ",HV");
474 if (o->op_type == OP_AELEM || o->op_type == OP_HELEM) {
475 if (o->op_private & OPpLVAL_DEFER)
476 sv_catpv(tmpsv, ",LVAL_DEFER");
479 if (o->op_private & HINT_STRICT_REFS)
480 sv_catpv(tmpsv, ",STRICT_REFS");
483 else if (o->op_type == OP_CONST) {
484 if (o->op_private & OPpCONST_BARE)
485 sv_catpv(tmpsv, ",BARE");
486 if (o->op_private & OPpCONST_STRICT)
487 sv_catpv(tmpsv, ",STRICT");
489 else if (o->op_type == OP_FLIP) {
490 if (o->op_private & OPpFLIP_LINENUM)
491 sv_catpv(tmpsv, ",LINENUM");
493 else if (o->op_type == OP_FLOP) {
494 if (o->op_private & OPpFLIP_LINENUM)
495 sv_catpv(tmpsv, ",LINENUM");
497 if (o->op_flags & OPf_MOD && o->op_private & OPpLVAL_INTRO)
498 sv_catpv(tmpsv, ",INTRO");
500 Perl_dump_indent(aTHX_ level, file, "PRIVATE = (%s)\n", SvPVX(tmpsv) + 1);
504 switch (o->op_type) {
508 SV *tmpsv = NEWSV(0,0);
511 gv_fullname3(tmpsv, cGVOPo->op_gv, Nullch);
512 Perl_dump_indent(aTHX_ level, file, "GV = %s\n", SvPV(tmpsv, n_a));
516 Perl_dump_indent(aTHX_ level, file, "GV = NULL\n");
519 Perl_dump_indent(aTHX_ level, file, "SV = %s\n", SvPEEK(cSVOPo->op_sv));
524 Perl_dump_indent(aTHX_ level, file, "LINE = %d\n",cCOPo->cop_line);
525 if (cCOPo->cop_label)
526 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",cCOPo->cop_label);
529 Perl_dump_indent(aTHX_ level, file, "REDO ===> ");
530 if (cLOOPo->op_redoop)
531 PerlIO_printf(file, "%d\n", cLOOPo->op_redoop->op_seq);
533 PerlIO_printf(file, "DONE\n");
534 Perl_dump_indent(aTHX_ level, file, "NEXT ===> ");
535 if (cLOOPo->op_nextop)
536 PerlIO_printf(file, "%d\n", cLOOPo->op_nextop->op_seq);
538 PerlIO_printf(file, "DONE\n");
539 Perl_dump_indent(aTHX_ level, file, "LAST ===> ");
540 if (cLOOPo->op_lastop)
541 PerlIO_printf(file, "%d\n", cLOOPo->op_lastop->op_seq);
543 PerlIO_printf(file, "DONE\n");
546 Perl_dump_indent(aTHX_ level, file, "TRUE ===> ");
547 if (cCONDOPo->op_true)
548 PerlIO_printf(file, "%d\n", cCONDOPo->op_true->op_seq);
550 PerlIO_printf(file, "DONE\n");
551 Perl_dump_indent(aTHX_ level, file, "FALSE ===> ");
552 if (cCONDOPo->op_false)
553 PerlIO_printf(file, "%d\n", cCONDOPo->op_false->op_seq);
555 PerlIO_printf(file, "DONE\n");
561 Perl_dump_indent(aTHX_ level, file, "OTHER ===> ");
562 if (cLOGOPo->op_other)
563 PerlIO_printf(file, "%d\n", cLOGOPo->op_other->op_seq);
565 PerlIO_printf(file, "DONE\n");
571 do_pmop_dump(level, file, cPMOPo);
576 if (o->op_flags & OPf_KIDS) {
578 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
579 do_op_dump(level, file, kid);
581 Perl_dump_indent(aTHX_ level-1, file, "}\n");
585 Perl_op_dump(pTHX_ OP *o)
587 do_op_dump(0, Perl_debug_log, o);
591 Perl_gv_dump(pTHX_ GV *gv)
596 PerlIO_printf(Perl_debug_log, "{}\n");
600 PerlIO_printf(Perl_debug_log, "{\n");
601 gv_fullname3(sv, gv, Nullch);
602 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "GV_NAME = %s", SvPVX(sv));
603 if (gv != GvEGV(gv)) {
604 gv_efullname3(sv, GvEGV(gv), Nullch);
605 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "-> %s", SvPVX(sv));
607 PerlIO_putc(Perl_debug_log, '\n');
608 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "}\n");
612 Perl_do_magic_dump(pTHX_ I32 level, PerlIO *file, MAGIC *mg, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
614 for (; mg; mg = mg->mg_moremagic) {
615 Perl_dump_indent(aTHX_ level, file, " MAGIC = 0x%lx\n", (long)mg);
616 if (mg->mg_virtual) {
617 MGVTBL *v = mg->mg_virtual;
619 if (v == &PL_vtbl_sv) s = "sv";
620 else if (v == &PL_vtbl_env) s = "env";
621 else if (v == &PL_vtbl_envelem) s = "envelem";
622 else if (v == &PL_vtbl_sig) s = "sig";
623 else if (v == &PL_vtbl_sigelem) s = "sigelem";
624 else if (v == &PL_vtbl_pack) s = "pack";
625 else if (v == &PL_vtbl_packelem) s = "packelem";
626 else if (v == &PL_vtbl_dbline) s = "dbline";
627 else if (v == &PL_vtbl_isa) s = "isa";
628 else if (v == &PL_vtbl_arylen) s = "arylen";
629 else if (v == &PL_vtbl_glob) s = "glob";
630 else if (v == &PL_vtbl_mglob) s = "mglob";
631 else if (v == &PL_vtbl_nkeys) s = "nkeys";
632 else if (v == &PL_vtbl_taint) s = "taint";
633 else if (v == &PL_vtbl_substr) s = "substr";
634 else if (v == &PL_vtbl_vec) s = "vec";
635 else if (v == &PL_vtbl_pos) s = "pos";
636 else if (v == &PL_vtbl_bm) s = "bm";
637 else if (v == &PL_vtbl_fm) s = "fm";
638 else if (v == &PL_vtbl_uvar) s = "uvar";
639 else if (v == &PL_vtbl_defelem) s = "defelem";
640 #ifdef USE_LOCALE_COLLATE
641 else if (v == &PL_vtbl_collxfrm) s = "collxfrm";
643 else if (v == &PL_vtbl_amagic) s = "amagic";
644 else if (v == &PL_vtbl_amagicelem) s = "amagicelem";
645 else if (v == &PL_vtbl_backref) s = "backref";
647 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = &PL_vtbl_%s\n", s);
649 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0x%lx\n", (long)v);
652 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0\n");
655 Perl_dump_indent(aTHX_ level, file, " MG_PRIVATE = %d\n", mg->mg_private);
657 if (isPRINT(mg->mg_type))
658 Perl_dump_indent(aTHX_ level, file, " MG_TYPE = '%c'\n", mg->mg_type);
660 Perl_dump_indent(aTHX_ level, file, " MG_TYPE = '\\%o'\n", mg->mg_type);
663 Perl_dump_indent(aTHX_ level, file, " MG_FLAGS = 0x%02X\n", mg->mg_flags);
664 if (mg->mg_flags & MGf_TAINTEDDIR)
665 Perl_dump_indent(aTHX_ level, file, " TAINTEDDIR\n");
666 if (mg->mg_flags & MGf_REFCOUNTED)
667 Perl_dump_indent(aTHX_ level, file, " REFCOUNTED\n");
668 if (mg->mg_flags & MGf_GSKIP)
669 Perl_dump_indent(aTHX_ level, file, " GSKIP\n");
670 if (mg->mg_flags & MGf_MINMATCH)
671 Perl_dump_indent(aTHX_ level, file, " MINMATCH\n");
674 Perl_dump_indent(aTHX_ level, file, " MG_OBJ = 0x%lx\n", (long)mg->mg_obj);
675 if (mg->mg_flags & MGf_REFCOUNTED)
676 do_sv_dump(level+2, file, mg->mg_obj, nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
679 Perl_dump_indent(aTHX_ level, file, " MG_LEN = %d\n", mg->mg_len);
681 Perl_dump_indent(aTHX_ level, file, " MG_PTR = 0x%lx", (long)mg->mg_ptr);
682 if (mg->mg_len >= 0) {
683 SV *sv = newSVpvn("", 0);
684 PerlIO_printf(file, " %s", pv_display(sv, mg->mg_ptr, mg->mg_len, 0, pvlim));
687 else if (mg->mg_len == HEf_SVKEY) {
688 PerlIO_puts(file, " => HEf_SVKEY\n");
689 do_sv_dump(level+2, file, (SV*)((mg)->mg_ptr), nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
693 PerlIO_puts(file, " ???? - please notify IZ");
694 PerlIO_putc(file, '\n');
700 Perl_magic_dump(pTHX_ MAGIC *mg)
702 do_magic_dump(0, Perl_debug_log, mg, 0, 0, 0, 0);
706 Perl_do_hv_dump(pTHX_ I32 level, PerlIO *file, char *name, HV *sv)
708 Perl_dump_indent(aTHX_ level, file, "%s = 0x%lx", name, (long)sv);
709 if (sv && HvNAME(sv))
710 PerlIO_printf(file, "\t\"%s\"\n", HvNAME(sv));
712 PerlIO_putc(file, '\n');
716 Perl_do_gv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
718 Perl_dump_indent(aTHX_ level, file, "%s = 0x%lx", name, (long)sv);
719 if (sv && GvNAME(sv))
720 PerlIO_printf(file, "\t\"%s\"\n", GvNAME(sv));
722 PerlIO_putc(file, '\n');
726 Perl_do_gvgv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
728 Perl_dump_indent(aTHX_ level, file, "%s = 0x%lx", name, (long)sv);
729 if (sv && GvNAME(sv)) {
730 PerlIO_printf(file, "\t\"");
731 if (GvSTASH(sv) && HvNAME(GvSTASH(sv)))
732 PerlIO_printf(file, "%s\" :: \"", HvNAME(GvSTASH(sv)));
733 PerlIO_printf(file, "%s\"\n", GvNAME(sv));
736 PerlIO_putc(file, '\n');
740 Perl_do_sv_dump(pTHX_ I32 level, PerlIO *file, SV *sv, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
743 SV *d = sv_newmortal();
750 Perl_dump_indent(aTHX_ level, file, "SV = 0\n");
757 Perl_sv_setpvf(aTHX_ d, "(0x%lx) at 0x%lx\n%*s REFCNT = %ld\n%*s FLAGS = (",
758 (unsigned long)SvANY(sv), (unsigned long)sv,
759 PL_dumpindent*level, "", (long)SvREFCNT(sv),
760 PL_dumpindent*level, "");
762 if (flags & SVs_PADBUSY) sv_catpv(d, "PADBUSY,");
763 if (flags & SVs_PADTMP) sv_catpv(d, "PADTMP,");
764 if (flags & SVs_PADMY) sv_catpv(d, "PADMY,");
765 if (flags & SVs_TEMP) sv_catpv(d, "TEMP,");
766 if (flags & SVs_OBJECT) sv_catpv(d, "OBJECT,");
767 if (flags & SVs_GMG) sv_catpv(d, "GMG,");
768 if (flags & SVs_SMG) sv_catpv(d, "SMG,");
769 if (flags & SVs_RMG) sv_catpv(d, "RMG,");
771 if (flags & SVf_IOK) sv_catpv(d, "IOK,");
772 if (flags & SVf_NOK) sv_catpv(d, "NOK,");
773 if (flags & SVf_POK) sv_catpv(d, "POK,");
774 if (flags & SVf_ROK) {
776 if (SvWEAKREF(sv)) sv_catpv(d, "WEAKREF,");
778 if (flags & SVf_OOK) sv_catpv(d, "OOK,");
779 if (flags & SVf_FAKE) sv_catpv(d, "FAKE,");
780 if (flags & SVf_READONLY) sv_catpv(d, "READONLY,");
782 if (flags & SVf_AMAGIC) sv_catpv(d, "OVERLOAD,");
783 if (flags & SVp_IOK) sv_catpv(d, "pIOK,");
784 if (flags & SVp_NOK) sv_catpv(d, "pNOK,");
785 if (flags & SVp_POK) sv_catpv(d, "pPOK,");
786 if (flags & SVp_SCREAM) sv_catpv(d, "SCREAM,");
791 if (CvANON(sv)) sv_catpv(d, "ANON,");
792 if (CvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
793 if (CvCLONE(sv)) sv_catpv(d, "CLONE,");
794 if (CvCLONED(sv)) sv_catpv(d, "CLONED,");
795 if (CvNODEBUG(sv)) sv_catpv(d, "NODEBUG,");
796 if (SvCOMPILED(sv)) sv_catpv(d, "COMPILED,");
799 if (HvSHAREKEYS(sv)) sv_catpv(d, "SHAREKEYS,");
800 if (HvLAZYDEL(sv)) sv_catpv(d, "LAZYDEL,");
803 if (GvINTRO(sv)) sv_catpv(d, "INTRO,");
804 if (GvMULTI(sv)) sv_catpv(d, "MULTI,");
805 if (GvASSUMECV(sv)) sv_catpv(d, "ASSUMECV,");
806 if (GvIMPORTED(sv)) {
807 sv_catpv(d, "IMPORT");
808 if (GvIMPORTED(sv) == GVf_IMPORTED)
812 if (GvIMPORTED_SV(sv)) sv_catpv(d, " SV");
813 if (GvIMPORTED_AV(sv)) sv_catpv(d, " AV");
814 if (GvIMPORTED_HV(sv)) sv_catpv(d, " HV");
815 if (GvIMPORTED_CV(sv)) sv_catpv(d, " CV");
821 if (SvEVALED(sv)) sv_catpv(d, "EVALED,");
822 if (SvIsUV(sv)) sv_catpv(d, "IsUV,");
825 if (SvTAIL(sv)) sv_catpv(d, "TAIL,");
826 if (SvVALID(sv)) sv_catpv(d, "VALID,");
830 if (*(SvEND(d) - 1) == ',')
831 SvPVX(d)[--SvCUR(d)] = '\0';
835 Perl_dump_indent(aTHX_ level, file, "SV = ");
838 PerlIO_printf(file, "NULL%s\n", s);
841 PerlIO_printf(file, "IV%s\n", s);
844 PerlIO_printf(file, "NV%s\n", s);
847 PerlIO_printf(file, "RV%s\n", s);
850 PerlIO_printf(file, "PV%s\n", s);
853 PerlIO_printf(file, "PVIV%s\n", s);
856 PerlIO_printf(file, "PVNV%s\n", s);
859 PerlIO_printf(file, "PVBM%s\n", s);
862 PerlIO_printf(file, "PVMG%s\n", s);
865 PerlIO_printf(file, "PVLV%s\n", s);
868 PerlIO_printf(file, "PVAV%s\n", s);
871 PerlIO_printf(file, "PVHV%s\n", s);
874 PerlIO_printf(file, "PVCV%s\n", s);
877 PerlIO_printf(file, "PVGV%s\n", s);
880 PerlIO_printf(file, "PVFM%s\n", s);
883 PerlIO_printf(file, "PVIO%s\n", s);
886 PerlIO_printf(file, "UNKNOWN(0x%x) %s\n", type, s);
889 if (type >= SVt_PVIV || type == SVt_IV) {
891 Perl_dump_indent(aTHX_ level, file, " UV = %lu", (unsigned long)SvUVX(sv));
893 Perl_dump_indent(aTHX_ level, file, " IV = %ld", (long)SvIVX(sv));
895 PerlIO_printf(file, " (OFFSET)");
896 PerlIO_putc(file, '\n');
898 if (type >= SVt_PVNV || type == SVt_NV) {
899 RESTORE_NUMERIC_STANDARD();
900 Perl_dump_indent(aTHX_ level, file, " NV = %.*g\n", DBL_DIG, SvNVX(sv));
901 RESTORE_NUMERIC_LOCAL();
904 Perl_dump_indent(aTHX_ level, file, " RV = 0x%lx\n", (long)SvRV(sv));
906 do_sv_dump(level+1, file, SvRV(sv), nest+1, maxnest, dumpops, pvlim);
911 if (type <= SVt_PVLV) {
913 Perl_dump_indent(aTHX_ level, file," PV = 0x%lx ", (long)SvPVX(sv));
915 PerlIO_printf(file, "( %s . ) ", pv_display(d, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, pvlim));
916 PerlIO_printf(file, "%s\n", pv_display(d, SvPVX(sv), SvCUR(sv), SvLEN(sv), pvlim));
917 Perl_dump_indent(aTHX_ level, file, " CUR = %ld\n", (long)SvCUR(sv));
918 Perl_dump_indent(aTHX_ level, file, " LEN = %ld\n", (long)SvLEN(sv));
921 Perl_dump_indent(aTHX_ level, file, " PV = 0\n");
923 if (type >= SVt_PVMG) {
925 do_magic_dump(level, file, SvMAGIC(sv), nest, maxnest, dumpops, pvlim);
927 do_hv_dump(level, file, " STASH", SvSTASH(sv));
931 Perl_dump_indent(aTHX_ level, file, " TYPE = %c\n", LvTYPE(sv));
932 Perl_dump_indent(aTHX_ level, file, " TARGOFF = %ld\n", (long)LvTARGOFF(sv));
933 Perl_dump_indent(aTHX_ level, file, " TARGLEN = %ld\n", (long)LvTARGLEN(sv));
934 Perl_dump_indent(aTHX_ level, file, " TARG = 0x%lx\n", (long)LvTARG(sv));
935 /* XXX level+1 ??? */
936 do_sv_dump(level, file, LvTARG(sv), nest+1, maxnest, dumpops, pvlim);
939 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%lx", (long)AvARRAY(sv));
940 if (AvARRAY(sv) != AvALLOC(sv)) {
941 PerlIO_printf(file, " (offset=%d)\n", (AvARRAY(sv) - AvALLOC(sv)));
942 Perl_dump_indent(aTHX_ level, file, " ALLOC = 0x%lx\n", (long)AvALLOC(sv));
945 PerlIO_putc(file, '\n');
946 Perl_dump_indent(aTHX_ level, file, " FILL = %ld\n", (long)AvFILLp(sv));
947 Perl_dump_indent(aTHX_ level, file, " MAX = %ld\n", (long)AvMAX(sv));
948 Perl_dump_indent(aTHX_ level, file, " ARYLEN = 0x%lx\n", (long)AvARYLEN(sv));
951 if (flags & AVf_REAL) sv_catpv(d, ",REAL");
952 if (flags & AVf_REIFY) sv_catpv(d, ",REIFY");
953 if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
954 Perl_dump_indent(aTHX_ level, file, " FLAGS = (%s)\n", SvCUR(d) ? SvPVX(d) + 1 : "");
955 if (nest < maxnest && av_len((AV*)sv) >= 0) {
957 for (count = 0; count <= av_len((AV*)sv) && count < maxnest; count++) {
958 SV** elt = av_fetch((AV*)sv,count,0);
960 Perl_dump_indent(aTHX_ level + 1, file, "Elt No. %ld\n", (long)count);
962 do_sv_dump(level+1, file, *elt, nest+1, maxnest, dumpops, pvlim);
967 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%lx",(long)HvARRAY(sv));
968 if (HvARRAY(sv) && HvKEYS(sv)) {
969 /* Show distribution of HEs in the ARRAY */
971 #define FREQ_MAX (sizeof freq / sizeof freq[0] - 1)
974 U32 pow2 = 2, keys = HvKEYS(sv);
975 double theoret, sum = 0;
977 PerlIO_printf(file, " (");
978 Zero(freq, FREQ_MAX + 1, int);
979 for (i = 0; i <= HvMAX(sv); i++) {
980 HE* h; int count = 0;
981 for (h = HvARRAY(sv)[i]; h; h = HeNEXT(h))
983 if (count > FREQ_MAX)
989 for (i = 0; i <= max; i++) {
991 PerlIO_printf(file, "%d%s:%d", i,
992 (i == FREQ_MAX) ? "+" : "",
995 PerlIO_printf(file, ", ");
998 PerlIO_putc(file, ')');
999 /* Now calculate quality wrt theoretical value */
1000 for (i = max; i > 0; i--) { /* Precision: count down. */
1001 sum += freq[i] * i * i;
1003 while (keys = keys >> 1)
1005 /* Approximate by Poisson distribution */
1006 theoret = HvKEYS(sv);
1007 theoret += theoret * theoret/pow2;
1008 PerlIO_putc(file, '\n');
1009 Perl_dump_indent(aTHX_ level, file, " hash quality = %.1f%%", theoret/sum*100);
1011 PerlIO_putc(file, '\n');
1012 Perl_dump_indent(aTHX_ level, file, " KEYS = %ld\n", (long)HvKEYS(sv));
1013 Perl_dump_indent(aTHX_ level, file, " FILL = %ld\n", (long)HvFILL(sv));
1014 Perl_dump_indent(aTHX_ level, file, " MAX = %ld\n", (long)HvMAX(sv));
1015 Perl_dump_indent(aTHX_ level, file, " RITER = %ld\n", (long)HvRITER(sv));
1016 Perl_dump_indent(aTHX_ level, file, " EITER = 0x%lx\n",(long) HvEITER(sv));
1018 Perl_dump_indent(aTHX_ level, file, " PMROOT = 0x%lx\n",(long)HvPMROOT(sv));
1020 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", HvNAME(sv));
1021 if (nest < maxnest && !HvEITER(sv)) { /* Try to preserve iterator */
1024 int count = maxnest - nest;
1027 while ((he = hv_iternext(hv)) && count--) {
1031 U32 hash = HeHASH(he);
1033 key = hv_iterkey(he, &len);
1034 elt = hv_iterval(hv, he);
1035 Perl_dump_indent(aTHX_ level+1, file, "Elt %s HASH = 0x%lx\n", pv_display(d, key, len, 0, pvlim), hash);
1036 do_sv_dump(level+1, file, elt, nest+1, maxnest, dumpops, pvlim);
1038 hv_iterinit(hv); /* Return to status quo */
1043 Perl_dump_indent(aTHX_ level, file, " PROTOTYPE = \"%s\"\n", SvPV(sv,n_a));
1046 do_hv_dump(level, file, " COMP_STASH", CvSTASH(sv));
1048 Perl_dump_indent(aTHX_ level, file, " START = 0x%lx ===> %d\n", (long)CvSTART(sv), CvSTART(sv)->op_seq);
1049 Perl_dump_indent(aTHX_ level, file, " ROOT = 0x%lx\n", (long)CvROOT(sv));
1050 if (CvROOT(sv) && dumpops)
1051 do_op_dump(level+1, file, CvROOT(sv));
1052 Perl_dump_indent(aTHX_ level, file, " XSUB = 0x%lx\n", (long)CvXSUB(sv));
1053 Perl_dump_indent(aTHX_ level, file, " XSUBANY = %ld\n", (long)CvXSUBANY(sv).any_i32);
1054 do_gvgv_dump(level, file, " GVGV::GV", CvGV(sv));
1055 do_gv_dump(level, file, " FILEGV", CvFILEGV(sv));
1056 Perl_dump_indent(aTHX_ level, file, " DEPTH = %ld\n", (long)CvDEPTH(sv));
1058 Perl_dump_indent(aTHX_ level, file, " MUTEXP = 0x%lx\n", (long)CvMUTEXP(sv));
1059 Perl_dump_indent(aTHX_ level, file, " OWNER = 0x%lx\n", (long)CvOWNER(sv));
1060 #endif /* USE_THREADS */
1061 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%lx\n", (unsigned long)CvFLAGS(sv));
1062 if (type == SVt_PVFM)
1063 Perl_dump_indent(aTHX_ level, file, " LINES = %ld\n", (long)FmLINES(sv));
1064 Perl_dump_indent(aTHX_ level, file, " PADLIST = 0x%lx\n", (long)CvPADLIST(sv));
1065 if (nest < maxnest && CvPADLIST(sv)) {
1066 AV* padlist = CvPADLIST(sv);
1067 AV* pad_name = (AV*)*av_fetch(padlist, 0, FALSE);
1068 AV* pad = (AV*)*av_fetch(padlist, 1, FALSE);
1069 SV** pname = AvARRAY(pad_name);
1070 SV** ppad = AvARRAY(pad);
1073 for (ix = 1; ix <= AvFILL(pad_name); ix++) {
1074 if (SvPOK(pname[ix]))
1075 Perl_dump_indent(aTHX_ level, /* %5d below is enough whitespace. */
1077 "%5d. 0x%lx (%s\"%s\" %ld-%ld)\n",
1079 SvFAKE(pname[ix]) ? "FAKE " : "",
1081 (long)I_32(SvNVX(pname[ix])),
1082 (long)SvIVX(pname[ix]));
1086 CV *outside = CvOUTSIDE(sv);
1087 Perl_dump_indent(aTHX_ level, file, " OUTSIDE = 0x%lx (%s)\n",
1090 : CvANON(outside) ? "ANON"
1091 : (outside == PL_main_cv) ? "MAIN"
1092 : CvUNIQUE(outside) ? "UNIQUE"
1093 : CvGV(outside) ? GvNAME(CvGV(outside)) : "UNDEFINED"));
1095 if (nest < maxnest && (CvCLONE(sv) || CvCLONED(sv)))
1096 do_sv_dump(level+1, file, (SV*)CvOUTSIDE(sv), nest+1, maxnest, dumpops, pvlim);
1099 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", GvNAME(sv));
1100 Perl_dump_indent(aTHX_ level, file, " NAMELEN = %ld\n", (long)GvNAMELEN(sv));
1101 do_hv_dump (level, file, " GvSTASH", GvSTASH(sv));
1102 Perl_dump_indent(aTHX_ level, file, " GP = 0x%lx\n", (long)GvGP(sv));
1103 Perl_dump_indent(aTHX_ level, file, " SV = 0x%lx\n", (long)GvSV(sv));
1104 Perl_dump_indent(aTHX_ level, file, " REFCNT = %ld\n", (long)GvREFCNT(sv));
1105 Perl_dump_indent(aTHX_ level, file, " IO = 0x%lx\n", (long)GvIOp(sv));
1106 Perl_dump_indent(aTHX_ level, file, " FORM = 0x%lx\n", (long)GvFORM(sv));
1107 Perl_dump_indent(aTHX_ level, file, " AV = 0x%lx\n", (long)GvAV(sv));
1108 Perl_dump_indent(aTHX_ level, file, " HV = 0x%lx\n", (long)GvHV(sv));
1109 Perl_dump_indent(aTHX_ level, file, " CV = 0x%lx\n", (long)GvCV(sv));
1110 Perl_dump_indent(aTHX_ level, file, " CVGEN = 0x%lx\n", (long)GvCVGEN(sv));
1111 Perl_dump_indent(aTHX_ level, file, " LASTEXPR = %ld\n", (long)GvLASTEXPR(sv));
1112 Perl_dump_indent(aTHX_ level, file, " LINE = %ld\n", (long)GvLINE(sv));
1113 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%x\n", (int)GvFLAGS(sv));
1114 do_gv_dump (level, file, " FILEGV", GvFILEGV(sv));
1115 do_gv_dump (level, file, " EGV", GvEGV(sv));
1118 Perl_dump_indent(aTHX_ level, file, " IFP = 0x%lx\n", (long)IoIFP(sv));
1119 Perl_dump_indent(aTHX_ level, file, " OFP = 0x%lx\n", (long)IoOFP(sv));
1120 Perl_dump_indent(aTHX_ level, file, " DIRP = 0x%lx\n", (long)IoDIRP(sv));
1121 Perl_dump_indent(aTHX_ level, file, " LINES = %ld\n", (long)IoLINES(sv));
1122 Perl_dump_indent(aTHX_ level, file, " PAGE = %ld\n", (long)IoPAGE(sv));
1123 Perl_dump_indent(aTHX_ level, file, " PAGE_LEN = %ld\n", (long)IoPAGE_LEN(sv));
1124 Perl_dump_indent(aTHX_ level, file, " LINES_LEFT = %ld\n", (long)IoLINES_LEFT(sv));
1126 Perl_dump_indent(aTHX_ level, file, " TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
1127 do_gv_dump (level, file, " TOP_GV", IoTOP_GV(sv));
1129 Perl_dump_indent(aTHX_ level, file, " FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
1130 do_gv_dump (level, file, " FMT_GV", IoFMT_GV(sv));
1131 if (IoBOTTOM_NAME(sv))
1132 Perl_dump_indent(aTHX_ level, file, " BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
1133 do_gv_dump (level, file, " BOTTOM_GV", IoBOTTOM_GV(sv));
1134 Perl_dump_indent(aTHX_ level, file, " SUBPROCESS = %ld\n", (long)IoSUBPROCESS(sv));
1135 if (isPRINT(IoTYPE(sv)))
1136 Perl_dump_indent(aTHX_ level, file, " TYPE = '%c'\n", IoTYPE(sv));
1138 Perl_dump_indent(aTHX_ level, file, " TYPE = '\\%o'\n", IoTYPE(sv));
1139 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%lx\n", (long)IoFLAGS(sv));
1145 Perl_sv_dump(pTHX_ SV *sv)
1147 do_sv_dump(0, Perl_debug_log, sv, 0, 0, 0, 0);