3 * Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4 * 2000, 2001, 2002, 2003, 2004, 2005, by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 * "'You have talked long in your sleep, Frodo,' said Gandalf gently, 'and
13 * it has not been hard for me to read your mind and memory.'"
16 /* This file contains utility routines to dump the contents of SV and OP
17 * structures, as used by command-line options like -Dt and -Dx, and
20 * It also holds the debugging version of the runops function.
24 #define PERL_IN_DUMP_C
31 Perl_dump_indent(pTHX_ I32 level, PerlIO *file, const char* pat, ...)
35 dump_vindent(level, file, pat, &args);
40 Perl_dump_vindent(pTHX_ I32 level, PerlIO *file, const char* pat, va_list *args)
42 PerlIO_printf(file, "%*s", (int)(level*PL_dumpindent), "");
43 PerlIO_vprintf(file, pat, *args);
49 PerlIO_setlinebuf(Perl_debug_log);
51 op_dump(PL_main_root);
52 dump_packsubs(PL_defstash);
56 Perl_dump_packsubs(pTHX_ const HV *stash)
62 for (i = 0; i <= (I32) HvMAX(stash); i++) {
64 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
65 const GV *gv = (GV*)HeVAL(entry);
67 if (SvTYPE(gv) != SVt_PVGV || !GvGP(gv))
73 if (HeKEY(entry)[HeKLEN(entry)-1] == ':'
74 && (hv = GvHV(gv)) && hv != PL_defstash)
75 dump_packsubs(hv); /* nested package */
81 Perl_dump_sub(pTHX_ const GV *gv)
83 SV *sv = sv_newmortal();
85 gv_fullname3(sv, gv, Nullch);
86 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nSUB %s = ", SvPVX(sv));
88 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "(xsub 0x%"UVxf" %d)\n",
89 PTR2UV(CvXSUB(GvCV(gv))),
90 (int)CvXSUBANY(GvCV(gv)).any_i32);
91 else if (CvROOT(GvCV(gv)))
92 op_dump(CvROOT(GvCV(gv)));
94 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
98 Perl_dump_form(pTHX_ const GV *gv)
100 SV *sv = sv_newmortal();
102 gv_fullname3(sv, gv, Nullch);
103 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nFORMAT %s = ", SvPVX(sv));
104 if (CvROOT(GvFORM(gv)))
105 op_dump(CvROOT(GvFORM(gv)));
107 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
113 op_dump(PL_eval_root);
117 Perl_pv_display(pTHX_ SV *dsv, const char *pv, STRLEN cur, STRLEN len, STRLEN pvlim)
119 const bool nul_terminated = len > cur && pv[cur] == '\0';
122 sv_setpvn(dsv, "\"", 1);
123 for (; cur--; pv++) {
124 if (pvlim && SvCUR(dsv) >= pvlim) {
129 case '\t': sv_catpvn(dsv, "\\t", 2); break;
130 case '\n': sv_catpvn(dsv, "\\n", 2); break;
131 case '\r': sv_catpvn(dsv, "\\r", 2); break;
132 case '\f': sv_catpvn(dsv, "\\f", 2); break;
133 case '"': sv_catpvn(dsv, "\\\"", 2); break;
134 case '\\': sv_catpvn(dsv, "\\\\", 2); break;
137 sv_catpvn(dsv, pv, 1);
138 else if (cur && isDIGIT(*(pv+1)))
139 Perl_sv_catpvf(aTHX_ dsv, "\\%03o", (U8)*pv);
141 Perl_sv_catpvf(aTHX_ dsv, "\\%o", (U8)*pv);
144 sv_catpvn(dsv, "\"", 1);
146 sv_catpvn(dsv, "...", 3);
148 sv_catpvn(dsv, "\\0", 2);
154 Perl_sv_peek(pTHX_ SV *sv)
156 SV *t = sv_newmortal();
166 else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
170 else if (sv == &PL_sv_undef || sv == &PL_sv_no || sv == &PL_sv_yes || sv == &PL_sv_placeholder) {
171 if (sv == &PL_sv_undef) {
172 sv_catpv(t, "SV_UNDEF");
173 if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
174 SVs_GMG|SVs_SMG|SVs_RMG)) &&
178 else if (sv == &PL_sv_no) {
179 sv_catpv(t, "SV_NO");
180 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
181 SVs_GMG|SVs_SMG|SVs_RMG)) &&
182 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
188 else if (sv == &PL_sv_yes) {
189 sv_catpv(t, "SV_YES");
190 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
191 SVs_GMG|SVs_SMG|SVs_RMG)) &&
192 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
195 SvPVX(sv) && *SvPVX(sv) == '1' &&
200 sv_catpv(t, "SV_PLACEHOLDER");
201 if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
202 SVs_GMG|SVs_SMG|SVs_RMG)) &&
208 else if (SvREFCNT(sv) == 0) {
212 else if (DEBUG_R_TEST_) {
215 /* is this SV on the tmps stack? */
216 for (ix=PL_tmps_ix; ix>=0; ix--) {
217 if (PL_tmps_stack[ix] == sv) {
222 if (SvREFCNT(sv) > 1)
223 Perl_sv_catpvf(aTHX_ t, "<%"UVuf"%s>", (UV)SvREFCNT(sv),
231 if (SvCUR(t) + unref > 10) {
232 SvCUR(t) = unref + 3;
240 switch (SvTYPE(sv)) {
242 sv_catpv(t, "FREED");
246 sv_catpv(t, "UNDEF");
280 Perl_sv_catpvf(aTHX_ t, "CV(%s)", GvNAME(CvGV(sv)));
300 sv_catpv(t, "(null)");
302 SV *tmp = newSVpvn("", 0);
305 Perl_sv_catpvf(aTHX_ t, "[%s]", pv_display(tmp, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, 127));
306 Perl_sv_catpvf(aTHX_ t, "%s)", pv_display(tmp, SvPVX(sv), SvCUR(sv), SvLEN(sv), 127));
308 Perl_sv_catpvf(aTHX_ t, " [UTF8 \"%s\"]",
309 sv_uni_display(tmp, sv, 8 * sv_len_utf8(sv),
314 else if (SvNOKp(sv)) {
315 STORE_NUMERIC_LOCAL_SET_STANDARD();
316 Perl_sv_catpvf(aTHX_ t, "(%"NVgf")",SvNVX(sv));
317 RESTORE_NUMERIC_LOCAL();
319 else if (SvIOKp(sv)) {
321 Perl_sv_catpvf(aTHX_ t, "(%"UVuf")", (UV)SvUVX(sv));
323 Perl_sv_catpvf(aTHX_ t, "(%"IVdf")", (IV)SvIVX(sv));
337 Perl_do_pmop_dump(pTHX_ I32 level, PerlIO *file, const PMOP *pm)
342 Perl_dump_indent(aTHX_ level, file, "{}\n");
345 Perl_dump_indent(aTHX_ level, file, "{\n");
347 if (pm->op_pmflags & PMf_ONCE)
352 Perl_dump_indent(aTHX_ level, file, "PMf_PRE %c%s%c%s\n",
353 ch, PM_GETRE(pm)->precomp, ch,
354 (pm->op_private & OPpRUNTIME) ? " (RUNTIME)" : "");
356 Perl_dump_indent(aTHX_ level, file, "PMf_PRE (RUNTIME)\n");
357 if (pm->op_type != OP_PUSHRE && pm->op_pmreplroot) {
358 Perl_dump_indent(aTHX_ level, file, "PMf_REPL = ");
359 op_dump(pm->op_pmreplroot);
361 if (pm->op_pmflags || (PM_GETRE(pm) && PM_GETRE(pm)->check_substr)) {
362 SV *tmpsv = newSVpvn("", 0);
363 if (pm->op_pmdynflags & PMdf_USED)
364 sv_catpv(tmpsv, ",USED");
365 if (pm->op_pmdynflags & PMdf_TAINTED)
366 sv_catpv(tmpsv, ",TAINTED");
367 if (pm->op_pmflags & PMf_ONCE)
368 sv_catpv(tmpsv, ",ONCE");
369 if (PM_GETRE(pm) && PM_GETRE(pm)->check_substr
370 && !(PM_GETRE(pm)->reganch & ROPT_NOSCAN))
371 sv_catpv(tmpsv, ",SCANFIRST");
372 if (PM_GETRE(pm) && PM_GETRE(pm)->check_substr
373 && PM_GETRE(pm)->reganch & ROPT_CHECK_ALL)
374 sv_catpv(tmpsv, ",ALL");
375 if (pm->op_pmflags & PMf_SKIPWHITE)
376 sv_catpv(tmpsv, ",SKIPWHITE");
377 if (pm->op_pmflags & PMf_CONST)
378 sv_catpv(tmpsv, ",CONST");
379 if (pm->op_pmflags & PMf_KEEP)
380 sv_catpv(tmpsv, ",KEEP");
381 if (pm->op_pmflags & PMf_GLOBAL)
382 sv_catpv(tmpsv, ",GLOBAL");
383 if (pm->op_pmflags & PMf_CONTINUE)
384 sv_catpv(tmpsv, ",CONTINUE");
385 if (pm->op_pmflags & PMf_RETAINT)
386 sv_catpv(tmpsv, ",RETAINT");
387 if (pm->op_pmflags & PMf_EVAL)
388 sv_catpv(tmpsv, ",EVAL");
389 Perl_dump_indent(aTHX_ level, file, "PMFLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
393 Perl_dump_indent(aTHX_ level-1, file, "}\n");
397 Perl_pmop_dump(pTHX_ PMOP *pm)
399 do_pmop_dump(0, Perl_debug_log, pm);
402 /* An op sequencer. We visit the ops in the order they're to execute. */
405 sequence(pTHX_ register const OP *o)
420 op = newSVuv(PTR2UV(o));
422 if (hv_exists(Sequence, key, len))
425 for (; o; o = o->op_next) {
426 op = newSVuv(PTR2UV(o));
428 if (hv_exists(Sequence, key, len))
431 switch (o->op_type) {
433 if ((o->op_flags & OPf_WANT) != OPf_WANT_LIST) {
434 hv_store(Sequence, key, len, newSVuv(++seq), 0);
439 if (oldop && o->op_next)
446 if (oldop && o->op_next)
448 hv_store(Sequence, key, len, newSVuv(++seq), 0);
461 hv_store(Sequence, key, len, newSVuv(++seq), 0);
462 for (l = cLOGOPo->op_other; l && l->op_type == OP_NULL; l = l->op_next)
469 hv_store(Sequence, key, len, newSVuv(++seq), 0);
470 for (l = cLOOPo->op_redoop; l && l->op_type == OP_NULL; l = l->op_next)
473 for (l = cLOOPo->op_nextop; l && l->op_type == OP_NULL; l = l->op_next)
476 for (l = cLOOPo->op_lastop; l && l->op_type == OP_NULL; l = l->op_next)
484 hv_store(Sequence, key, len, newSVuv(++seq), 0);
485 for (l = cPMOPo->op_pmreplstart; l && l->op_type == OP_NULL; l = l->op_next)
494 hv_store(Sequence, key, len, newSVuv(++seq), 0);
502 sequence_num(pTHX_ const OP *o)
509 op = newSVuv(PTR2UV(o));
511 seq = hv_fetch(Sequence, key, len, 0);
512 return seq ? SvUV(*seq): 0;
516 Perl_do_op_dump(pTHX_ I32 level, PerlIO *file, const OP *o)
520 Perl_dump_indent(aTHX_ level, file, "{\n");
522 seq = sequence_num(aTHX_ o);
524 PerlIO_printf(file, "%-4"UVf, seq);
526 PerlIO_printf(file, " ");
528 "%*sTYPE = %s ===> ",
529 (int)(PL_dumpindent*level-4), "", OP_NAME(o));
531 PerlIO_printf(file, seq ? "%"UVf"\n" : "(%"UVf")\n",
532 sequence_num(aTHX_ o->op_next));
534 PerlIO_printf(file, "DONE\n");
536 if (o->op_type == OP_NULL)
538 Perl_dump_indent(aTHX_ level, file, " (was %s)\n", PL_op_name[o->op_targ]);
539 if (o->op_targ == OP_NEXTSTATE)
542 Perl_dump_indent(aTHX_ level, file, "LINE = %"UVf"\n",
544 if (CopSTASHPV(cCOPo))
545 Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
547 if (cCOPo->cop_label)
548 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
553 Perl_dump_indent(aTHX_ level, file, "TARG = %ld\n", (long)o->op_targ);
556 Perl_dump_indent(aTHX_ level, file, "ADDR = 0x%"UVxf" => 0x%"UVxf"\n", (UV)o, (UV)o->op_next);
559 SV *tmpsv = newSVpvn("", 0);
560 switch (o->op_flags & OPf_WANT) {
562 sv_catpv(tmpsv, ",VOID");
564 case OPf_WANT_SCALAR:
565 sv_catpv(tmpsv, ",SCALAR");
568 sv_catpv(tmpsv, ",LIST");
571 sv_catpv(tmpsv, ",UNKNOWN");
574 if (o->op_flags & OPf_KIDS)
575 sv_catpv(tmpsv, ",KIDS");
576 if (o->op_flags & OPf_PARENS)
577 sv_catpv(tmpsv, ",PARENS");
578 if (o->op_flags & OPf_STACKED)
579 sv_catpv(tmpsv, ",STACKED");
580 if (o->op_flags & OPf_REF)
581 sv_catpv(tmpsv, ",REF");
582 if (o->op_flags & OPf_MOD)
583 sv_catpv(tmpsv, ",MOD");
584 if (o->op_flags & OPf_SPECIAL)
585 sv_catpv(tmpsv, ",SPECIAL");
586 Perl_dump_indent(aTHX_ level, file, "FLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
590 SV *tmpsv = newSVpvn("", 0);
591 if (PL_opargs[o->op_type] & OA_TARGLEX) {
592 if (o->op_private & OPpTARGET_MY)
593 sv_catpv(tmpsv, ",TARGET_MY");
595 else if (o->op_type == OP_LEAVESUB ||
596 o->op_type == OP_LEAVE ||
597 o->op_type == OP_LEAVESUBLV ||
598 o->op_type == OP_LEAVEWRITE) {
599 if (o->op_private & OPpREFCOUNTED)
600 sv_catpv(tmpsv, ",REFCOUNTED");
602 else if (o->op_type == OP_AASSIGN) {
603 if (o->op_private & OPpASSIGN_COMMON)
604 sv_catpv(tmpsv, ",COMMON");
606 else if (o->op_type == OP_SASSIGN) {
607 if (o->op_private & OPpASSIGN_BACKWARDS)
608 sv_catpv(tmpsv, ",BACKWARDS");
610 else if (o->op_type == OP_TRANS) {
611 if (o->op_private & OPpTRANS_SQUASH)
612 sv_catpv(tmpsv, ",SQUASH");
613 if (o->op_private & OPpTRANS_DELETE)
614 sv_catpv(tmpsv, ",DELETE");
615 if (o->op_private & OPpTRANS_COMPLEMENT)
616 sv_catpv(tmpsv, ",COMPLEMENT");
617 if (o->op_private & OPpTRANS_IDENTICAL)
618 sv_catpv(tmpsv, ",IDENTICAL");
619 if (o->op_private & OPpTRANS_GROWS)
620 sv_catpv(tmpsv, ",GROWS");
622 else if (o->op_type == OP_REPEAT) {
623 if (o->op_private & OPpREPEAT_DOLIST)
624 sv_catpv(tmpsv, ",DOLIST");
626 else if (o->op_type == OP_ENTERSUB ||
627 o->op_type == OP_RV2SV ||
628 o->op_type == OP_GVSV ||
629 o->op_type == OP_RV2AV ||
630 o->op_type == OP_RV2HV ||
631 o->op_type == OP_RV2GV ||
632 o->op_type == OP_AELEM ||
633 o->op_type == OP_HELEM )
635 if (o->op_type == OP_ENTERSUB) {
636 if (o->op_private & OPpENTERSUB_AMPER)
637 sv_catpv(tmpsv, ",AMPER");
638 if (o->op_private & OPpENTERSUB_DB)
639 sv_catpv(tmpsv, ",DB");
640 if (o->op_private & OPpENTERSUB_HASTARG)
641 sv_catpv(tmpsv, ",HASTARG");
642 if (o->op_private & OPpENTERSUB_NOPAREN)
643 sv_catpv(tmpsv, ",NOPAREN");
644 if (o->op_private & OPpENTERSUB_INARGS)
645 sv_catpv(tmpsv, ",INARGS");
646 if (o->op_private & OPpENTERSUB_NOMOD)
647 sv_catpv(tmpsv, ",NOMOD");
650 switch (o->op_private & OPpDEREF) {
652 sv_catpv(tmpsv, ",SV");
655 sv_catpv(tmpsv, ",AV");
658 sv_catpv(tmpsv, ",HV");
661 if (o->op_private & OPpMAYBE_LVSUB)
662 sv_catpv(tmpsv, ",MAYBE_LVSUB");
664 if (o->op_type == OP_AELEM || o->op_type == OP_HELEM) {
665 if (o->op_private & OPpLVAL_DEFER)
666 sv_catpv(tmpsv, ",LVAL_DEFER");
669 if (o->op_private & HINT_STRICT_REFS)
670 sv_catpv(tmpsv, ",STRICT_REFS");
671 if (o->op_private & OPpOUR_INTRO)
672 sv_catpv(tmpsv, ",OUR_INTRO");
675 else if (o->op_type == OP_CONST) {
676 if (o->op_private & OPpCONST_BARE)
677 sv_catpv(tmpsv, ",BARE");
678 if (o->op_private & OPpCONST_STRICT)
679 sv_catpv(tmpsv, ",STRICT");
680 if (o->op_private & OPpCONST_ARYBASE)
681 sv_catpv(tmpsv, ",ARYBASE");
682 if (o->op_private & OPpCONST_WARNING)
683 sv_catpv(tmpsv, ",WARNING");
684 if (o->op_private & OPpCONST_ENTERED)
685 sv_catpv(tmpsv, ",ENTERED");
687 else if (o->op_type == OP_FLIP) {
688 if (o->op_private & OPpFLIP_LINENUM)
689 sv_catpv(tmpsv, ",LINENUM");
691 else if (o->op_type == OP_FLOP) {
692 if (o->op_private & OPpFLIP_LINENUM)
693 sv_catpv(tmpsv, ",LINENUM");
695 else if (o->op_type == OP_RV2CV) {
696 if (o->op_private & OPpLVAL_INTRO)
697 sv_catpv(tmpsv, ",INTRO");
699 else if (o->op_type == OP_GV) {
700 if (o->op_private & OPpEARLY_CV)
701 sv_catpv(tmpsv, ",EARLY_CV");
703 else if (o->op_type == OP_LIST) {
704 if (o->op_private & OPpLIST_GUESSED)
705 sv_catpv(tmpsv, ",GUESSED");
707 else if (o->op_type == OP_DELETE) {
708 if (o->op_private & OPpSLICE)
709 sv_catpv(tmpsv, ",SLICE");
711 else if (o->op_type == OP_EXISTS) {
712 if (o->op_private & OPpEXISTS_SUB)
713 sv_catpv(tmpsv, ",EXISTS_SUB");
715 else if (o->op_type == OP_SORT) {
716 if (o->op_private & OPpSORT_NUMERIC)
717 sv_catpv(tmpsv, ",NUMERIC");
718 if (o->op_private & OPpSORT_INTEGER)
719 sv_catpv(tmpsv, ",INTEGER");
720 if (o->op_private & OPpSORT_REVERSE)
721 sv_catpv(tmpsv, ",REVERSE");
723 else if (o->op_type == OP_THREADSV) {
724 if (o->op_private & OPpDONE_SVREF)
725 sv_catpv(tmpsv, ",SVREF");
727 else if (o->op_type == OP_OPEN || o->op_type == OP_BACKTICK) {
728 if (o->op_private & OPpOPEN_IN_RAW)
729 sv_catpv(tmpsv, ",IN_RAW");
730 if (o->op_private & OPpOPEN_IN_CRLF)
731 sv_catpv(tmpsv, ",IN_CRLF");
732 if (o->op_private & OPpOPEN_OUT_RAW)
733 sv_catpv(tmpsv, ",OUT_RAW");
734 if (o->op_private & OPpOPEN_OUT_CRLF)
735 sv_catpv(tmpsv, ",OUT_CRLF");
737 else if (o->op_type == OP_EXIT) {
738 if (o->op_private & OPpEXIT_VMSISH)
739 sv_catpv(tmpsv, ",EXIT_VMSISH");
740 if (o->op_private & OPpHUSH_VMSISH)
741 sv_catpv(tmpsv, ",HUSH_VMSISH");
743 else if (o->op_type == OP_DIE) {
744 if (o->op_private & OPpHUSH_VMSISH)
745 sv_catpv(tmpsv, ",HUSH_VMSISH");
747 else if (PL_check[o->op_type] != MEMBER_TO_FPTR(Perl_ck_ftst)) {
748 if (OP_IS_FILETEST_ACCESS(o) && o->op_private & OPpFT_ACCESS)
749 sv_catpv(tmpsv, ",FT_ACCESS");
750 if (o->op_private & OPpFT_STACKED)
751 sv_catpv(tmpsv, ",FT_STACKED");
753 if (o->op_flags & OPf_MOD && o->op_private & OPpLVAL_INTRO)
754 sv_catpv(tmpsv, ",INTRO");
756 Perl_dump_indent(aTHX_ level, file, "PRIVATE = (%s)\n", SvPVX(tmpsv) + 1);
760 switch (o->op_type) {
765 Perl_dump_indent(aTHX_ level, file, "PADIX = %" IVdf "\n", (IV)cPADOPo->op_padix);
767 if ( ! PL_op->op_flags & OPf_SPECIAL) { /* not lexical */
769 SV *tmpsv = NEWSV(0,0);
773 gv_fullname3(tmpsv, (GV*)cSVOPo->op_sv, Nullch);
774 Perl_dump_indent(aTHX_ level, file, "GV = %s\n", SvPV(tmpsv, n_a));
778 Perl_dump_indent(aTHX_ level, file, "GV = NULL\n");
783 case OP_METHOD_NAMED:
785 /* with ITHREADS, consts are stored in the pad, and the right pad
786 * may not be active here, so skip */
787 Perl_dump_indent(aTHX_ level, file, "SV = %s\n", SvPEEK(cSVOPo_sv));
794 Perl_dump_indent(aTHX_ level, file, "LINE = %"UVf"\n",
796 if (CopSTASHPV(cCOPo))
797 Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
799 if (cCOPo->cop_label)
800 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
804 Perl_dump_indent(aTHX_ level, file, "REDO ===> ");
805 if (cLOOPo->op_redoop)
806 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOOPo->op_redoop));
808 PerlIO_printf(file, "DONE\n");
809 Perl_dump_indent(aTHX_ level, file, "NEXT ===> ");
810 if (cLOOPo->op_nextop)
811 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOOPo->op_nextop));
813 PerlIO_printf(file, "DONE\n");
814 Perl_dump_indent(aTHX_ level, file, "LAST ===> ");
815 if (cLOOPo->op_lastop)
816 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOOPo->op_lastop));
818 PerlIO_printf(file, "DONE\n");
826 Perl_dump_indent(aTHX_ level, file, "OTHER ===> ");
827 if (cLOGOPo->op_other)
828 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOGOPo->op_other));
830 PerlIO_printf(file, "DONE\n");
836 do_pmop_dump(level, file, cPMOPo);
844 if (o->op_private & OPpREFCOUNTED)
845 Perl_dump_indent(aTHX_ level, file, "REFCNT = %"UVuf"\n", (UV)o->op_targ);
850 if (o->op_flags & OPf_KIDS) {
852 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
853 do_op_dump(level, file, kid);
855 Perl_dump_indent(aTHX_ level-1, file, "}\n");
859 Perl_op_dump(pTHX_ const OP *o)
861 do_op_dump(0, Perl_debug_log, o);
865 Perl_gv_dump(pTHX_ GV *gv)
870 PerlIO_printf(Perl_debug_log, "{}\n");
874 PerlIO_printf(Perl_debug_log, "{\n");
875 gv_fullname3(sv, gv, Nullch);
876 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "GV_NAME = %s", SvPVX(sv));
877 if (gv != GvEGV(gv)) {
878 gv_efullname3(sv, GvEGV(gv), Nullch);
879 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "-> %s", SvPVX(sv));
881 PerlIO_putc(Perl_debug_log, '\n');
882 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "}\n");
886 /* map magic types to the symbolic names
887 * (with the PERL_MAGIC_ prefixed stripped)
890 static struct { const char type; const char *name; } magic_names[] = {
891 { PERL_MAGIC_sv, "sv(\\0)" },
892 { PERL_MAGIC_arylen, "arylen(#)" },
893 { PERL_MAGIC_glob, "glob(*)" },
894 { PERL_MAGIC_pos, "pos(.)" },
895 { PERL_MAGIC_backref, "backref(<)" },
896 { PERL_MAGIC_overload, "overload(A)" },
897 { PERL_MAGIC_bm, "bm(B)" },
898 { PERL_MAGIC_regdata, "regdata(D)" },
899 { PERL_MAGIC_env, "env(E)" },
900 { PERL_MAGIC_isa, "isa(I)" },
901 { PERL_MAGIC_dbfile, "dbfile(L)" },
902 { PERL_MAGIC_shared, "shared(N)" },
903 { PERL_MAGIC_tied, "tied(P)" },
904 { PERL_MAGIC_sig, "sig(S)" },
905 { PERL_MAGIC_uvar, "uvar(U)" },
906 { PERL_MAGIC_overload_elem, "overload_elem(a)" },
907 { PERL_MAGIC_overload_table, "overload_table(c)" },
908 { PERL_MAGIC_regdatum, "regdatum(d)" },
909 { PERL_MAGIC_envelem, "envelem(e)" },
910 { PERL_MAGIC_fm, "fm(f)" },
911 { PERL_MAGIC_regex_global, "regex_global(g)" },
912 { PERL_MAGIC_isaelem, "isaelem(i)" },
913 { PERL_MAGIC_nkeys, "nkeys(k)" },
914 { PERL_MAGIC_dbline, "dbline(l)" },
915 { PERL_MAGIC_mutex, "mutex(m)" },
916 { PERL_MAGIC_shared_scalar, "shared_scalar(n)" },
917 { PERL_MAGIC_collxfrm, "collxfrm(o)" },
918 { PERL_MAGIC_tiedelem, "tiedelem(p)" },
919 { PERL_MAGIC_tiedscalar, "tiedscalar(q)" },
920 { PERL_MAGIC_qr, "qr(r)" },
921 { PERL_MAGIC_sigelem, "sigelem(s)" },
922 { PERL_MAGIC_taint, "taint(t)" },
923 { PERL_MAGIC_uvar_elem, "uvar_elem(v)" },
924 { PERL_MAGIC_vec, "vec(v)" },
925 { PERL_MAGIC_vstring, "vstring(V)" },
926 { PERL_MAGIC_utf8, "utf8(w)" },
927 { PERL_MAGIC_substr, "substr(x)" },
928 { PERL_MAGIC_defelem, "defelem(y)" },
929 { PERL_MAGIC_ext, "ext(~)" },
930 /* this null string terminates the list */
935 Perl_do_magic_dump(pTHX_ I32 level, PerlIO *file, const MAGIC *mg, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
937 for (; mg; mg = mg->mg_moremagic) {
938 Perl_dump_indent(aTHX_ level, file,
939 " MAGIC = 0x%"UVxf"\n", PTR2UV(mg));
940 if (mg->mg_virtual) {
941 const MGVTBL * const v = mg->mg_virtual;
943 if (v == &PL_vtbl_sv) s = "sv";
944 else if (v == &PL_vtbl_env) s = "env";
945 else if (v == &PL_vtbl_envelem) s = "envelem";
946 else if (v == &PL_vtbl_sig) s = "sig";
947 else if (v == &PL_vtbl_sigelem) s = "sigelem";
948 else if (v == &PL_vtbl_pack) s = "pack";
949 else if (v == &PL_vtbl_packelem) s = "packelem";
950 else if (v == &PL_vtbl_dbline) s = "dbline";
951 else if (v == &PL_vtbl_isa) s = "isa";
952 else if (v == &PL_vtbl_arylen) s = "arylen";
953 else if (v == &PL_vtbl_glob) s = "glob";
954 else if (v == &PL_vtbl_mglob) s = "mglob";
955 else if (v == &PL_vtbl_nkeys) s = "nkeys";
956 else if (v == &PL_vtbl_taint) s = "taint";
957 else if (v == &PL_vtbl_substr) s = "substr";
958 else if (v == &PL_vtbl_vec) s = "vec";
959 else if (v == &PL_vtbl_pos) s = "pos";
960 else if (v == &PL_vtbl_bm) s = "bm";
961 else if (v == &PL_vtbl_fm) s = "fm";
962 else if (v == &PL_vtbl_uvar) s = "uvar";
963 else if (v == &PL_vtbl_defelem) s = "defelem";
964 #ifdef USE_LOCALE_COLLATE
965 else if (v == &PL_vtbl_collxfrm) s = "collxfrm";
967 else if (v == &PL_vtbl_amagic) s = "amagic";
968 else if (v == &PL_vtbl_amagicelem) s = "amagicelem";
969 else if (v == &PL_vtbl_backref) s = "backref";
970 else if (v == &PL_vtbl_utf8) s = "utf8";
972 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = &PL_vtbl_%s\n", s);
974 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0x%"UVxf"\n", PTR2UV(v));
977 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0\n");
980 Perl_dump_indent(aTHX_ level, file, " MG_PRIVATE = %d\n", mg->mg_private);
984 const char *name = 0;
985 for (n=0; magic_names[n].name; n++) {
986 if (mg->mg_type == magic_names[n].type) {
987 name = magic_names[n].name;
992 Perl_dump_indent(aTHX_ level, file,
993 " MG_TYPE = PERL_MAGIC_%s\n", name);
995 Perl_dump_indent(aTHX_ level, file,
996 " MG_TYPE = UNKNOWN(\\%o)\n", mg->mg_type);
1000 Perl_dump_indent(aTHX_ level, file, " MG_FLAGS = 0x%02X\n", mg->mg_flags);
1001 if (mg->mg_type == PERL_MAGIC_envelem &&
1002 mg->mg_flags & MGf_TAINTEDDIR)
1003 Perl_dump_indent(aTHX_ level, file, " TAINTEDDIR\n");
1004 if (mg->mg_flags & MGf_REFCOUNTED)
1005 Perl_dump_indent(aTHX_ level, file, " REFCOUNTED\n");
1006 if (mg->mg_flags & MGf_GSKIP)
1007 Perl_dump_indent(aTHX_ level, file, " GSKIP\n");
1008 if (mg->mg_type == PERL_MAGIC_regex_global &&
1009 mg->mg_flags & MGf_MINMATCH)
1010 Perl_dump_indent(aTHX_ level, file, " MINMATCH\n");
1013 Perl_dump_indent(aTHX_ level, file, " MG_OBJ = 0x%"UVxf"\n", PTR2UV(mg->mg_obj));
1014 if (mg->mg_flags & MGf_REFCOUNTED)
1015 do_sv_dump(level+2, file, mg->mg_obj, nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
1018 Perl_dump_indent(aTHX_ level, file, " MG_LEN = %ld\n", (long)mg->mg_len);
1020 Perl_dump_indent(aTHX_ level, file, " MG_PTR = 0x%"UVxf, PTR2UV(mg->mg_ptr));
1021 if (mg->mg_len >= 0) {
1022 if (mg->mg_type != PERL_MAGIC_utf8) {
1023 SV *sv = newSVpvn("", 0);
1024 PerlIO_printf(file, " %s", pv_display(sv, mg->mg_ptr, mg->mg_len, 0, pvlim));
1028 else if (mg->mg_len == HEf_SVKEY) {
1029 PerlIO_puts(file, " => HEf_SVKEY\n");
1030 do_sv_dump(level+2, file, (SV*)((mg)->mg_ptr), nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
1034 PerlIO_puts(file, " ???? - please notify IZ");
1035 PerlIO_putc(file, '\n');
1037 if (mg->mg_type == PERL_MAGIC_utf8) {
1038 STRLEN *cache = (STRLEN *) mg->mg_ptr;
1041 for (i = 0; i < PERL_MAGIC_UTF8_CACHESIZE; i++)
1042 Perl_dump_indent(aTHX_ level, file,
1043 " %2"IVdf": %"UVuf" -> %"UVuf"\n",
1046 (UV)cache[i * 2 + 1]);
1053 Perl_magic_dump(pTHX_ const MAGIC *mg)
1055 do_magic_dump(0, Perl_debug_log, mg, 0, 0, 0, 0);
1059 Perl_do_hv_dump(pTHX_ I32 level, PerlIO *file, const char *name, HV *sv)
1061 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
1062 if (sv && HvNAME(sv))
1063 PerlIO_printf(file, "\t\"%s\"\n", HvNAME(sv));
1065 PerlIO_putc(file, '\n');
1069 Perl_do_gv_dump(pTHX_ I32 level, PerlIO *file, const char *name, GV *sv)
1071 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
1072 if (sv && GvNAME(sv))
1073 PerlIO_printf(file, "\t\"%s\"\n", GvNAME(sv));
1075 PerlIO_putc(file, '\n');
1079 Perl_do_gvgv_dump(pTHX_ I32 level, PerlIO *file, const char *name, GV *sv)
1081 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
1082 if (sv && GvNAME(sv)) {
1083 PerlIO_printf(file, "\t\"");
1084 if (GvSTASH(sv) && HvNAME(GvSTASH(sv)))
1085 PerlIO_printf(file, "%s\" :: \"", HvNAME(GvSTASH(sv)));
1086 PerlIO_printf(file, "%s\"\n", GvNAME(sv));
1089 PerlIO_putc(file, '\n');
1093 Perl_do_sv_dump(pTHX_ I32 level, PerlIO *file, SV *sv, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
1101 Perl_dump_indent(aTHX_ level, file, "SV = 0\n");
1105 flags = SvFLAGS(sv);
1108 d = Perl_newSVpvf(aTHX_
1109 "(0x%"UVxf") at 0x%"UVxf"\n%*s REFCNT = %"IVdf"\n%*s FLAGS = (",
1110 PTR2UV(SvANY(sv)), PTR2UV(sv),
1111 (int)(PL_dumpindent*level), "", (IV)SvREFCNT(sv),
1112 (int)(PL_dumpindent*level), "");
1114 if (flags & SVs_PADSTALE) sv_catpv(d, "PADSTALE,");
1115 if (flags & SVs_PADTMP) sv_catpv(d, "PADTMP,");
1116 if (flags & SVs_PADMY) sv_catpv(d, "PADMY,");
1117 if (flags & SVs_TEMP) sv_catpv(d, "TEMP,");
1118 if (flags & SVs_OBJECT) sv_catpv(d, "OBJECT,");
1119 if (flags & SVs_GMG) sv_catpv(d, "GMG,");
1120 if (flags & SVs_SMG) sv_catpv(d, "SMG,");
1121 if (flags & SVs_RMG) sv_catpv(d, "RMG,");
1123 if (flags & SVf_IOK) sv_catpv(d, "IOK,");
1124 if (flags & SVf_NOK) sv_catpv(d, "NOK,");
1125 if (flags & SVf_POK) sv_catpv(d, "POK,");
1126 if (flags & SVf_ROK) {
1127 sv_catpv(d, "ROK,");
1128 if (SvWEAKREF(sv)) sv_catpv(d, "WEAKREF,");
1130 if (flags & SVf_OOK) sv_catpv(d, "OOK,");
1131 if (flags & SVf_FAKE) sv_catpv(d, "FAKE,");
1132 if (flags & SVf_READONLY) sv_catpv(d, "READONLY,");
1134 if (flags & SVf_AMAGIC && type != SVt_PVHV)
1135 sv_catpv(d, "OVERLOAD,");
1136 if (flags & SVp_IOK) sv_catpv(d, "pIOK,");
1137 if (flags & SVp_NOK) sv_catpv(d, "pNOK,");
1138 if (flags & SVp_POK) sv_catpv(d, "pPOK,");
1139 if (flags & SVp_SCREAM) sv_catpv(d, "SCREAM,");
1144 if (CvANON(sv)) sv_catpv(d, "ANON,");
1145 if (CvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
1146 if (CvCLONE(sv)) sv_catpv(d, "CLONE,");
1147 if (CvCLONED(sv)) sv_catpv(d, "CLONED,");
1148 if (CvCONST(sv)) sv_catpv(d, "CONST,");
1149 if (CvNODEBUG(sv)) sv_catpv(d, "NODEBUG,");
1150 if (SvCOMPILED(sv)) sv_catpv(d, "COMPILED,");
1151 if (CvLVALUE(sv)) sv_catpv(d, "LVALUE,");
1152 if (CvMETHOD(sv)) sv_catpv(d, "METHOD,");
1153 if (CvLOCKED(sv)) sv_catpv(d, "LOCKED,");
1154 if (CvWEAKOUTSIDE(sv)) sv_catpv(d, "WEAKOUTSIDE,");
1155 if (CvASSERTION(sv)) sv_catpv(d, "ASSERTION,");
1158 if (HvSHAREKEYS(sv)) sv_catpv(d, "SHAREKEYS,");
1159 if (HvLAZYDEL(sv)) sv_catpv(d, "LAZYDEL,");
1160 if (HvHASKFLAGS(sv)) sv_catpv(d, "HASKFLAGS,");
1161 if (HvREHASH(sv)) sv_catpv(d, "REHASH,");
1163 case SVt_PVGV: case SVt_PVLV:
1164 if (GvINTRO(sv)) sv_catpv(d, "INTRO,");
1165 if (GvMULTI(sv)) sv_catpv(d, "MULTI,");
1166 if (GvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
1167 if (GvASSUMECV(sv)) sv_catpv(d, "ASSUMECV,");
1168 if (GvIN_PAD(sv)) sv_catpv(d, "IN_PAD,");
1169 if (flags & SVpad_OUR) sv_catpv(d, "OUR,");
1170 if (GvIMPORTED(sv)) {
1171 sv_catpv(d, "IMPORT");
1172 if (GvIMPORTED(sv) == GVf_IMPORTED)
1173 sv_catpv(d, "ALL,");
1176 if (GvIMPORTED_SV(sv)) sv_catpv(d, " SV");
1177 if (GvIMPORTED_AV(sv)) sv_catpv(d, " AV");
1178 if (GvIMPORTED_HV(sv)) sv_catpv(d, " HV");
1179 if (GvIMPORTED_CV(sv)) sv_catpv(d, " CV");
1185 if (SvEVALED(sv)) sv_catpv(d, "EVALED,");
1186 if (SvIsUV(sv)) sv_catpv(d, "IsUV,");
1189 if (SvTAIL(sv)) sv_catpv(d, "TAIL,");
1190 if (SvVALID(sv)) sv_catpv(d, "VALID,");
1193 if (flags & SVpad_TYPED)
1194 sv_catpv(d, "TYPED,");
1197 /* SVphv_SHAREKEYS is also 0x20000000 */
1198 if ((type != SVt_PVHV) && SvUTF8(sv))
1199 sv_catpv(d, "UTF8");
1201 if (*(SvEND(d) - 1) == ',')
1202 SvPVX(d)[--SvCUR(d)] = '\0';
1206 #ifdef DEBUG_LEAKING_SCALARS
1207 Perl_dump_indent(aTHX_ level, file, "ALLOCATED at %s:%d %s %s%s\n",
1208 sv->sv_debug_file ? sv->sv_debug_file : "(unknown)",
1210 sv->sv_debug_inpad ? "for" : "by",
1211 sv->sv_debug_optype ? PL_op_name[sv->sv_debug_optype]: "(none)",
1212 sv->sv_debug_cloned ? " (cloned)" : "");
1214 Perl_dump_indent(aTHX_ level, file, "SV = ");
1217 PerlIO_printf(file, "NULL%s\n", s);
1221 PerlIO_printf(file, "IV%s\n", s);
1224 PerlIO_printf(file, "NV%s\n", s);
1227 PerlIO_printf(file, "RV%s\n", s);
1230 PerlIO_printf(file, "PV%s\n", s);
1233 PerlIO_printf(file, "PVIV%s\n", s);
1236 PerlIO_printf(file, "PVNV%s\n", s);
1239 PerlIO_printf(file, "PVBM%s\n", s);
1242 PerlIO_printf(file, "PVMG%s\n", s);
1245 PerlIO_printf(file, "PVLV%s\n", s);
1248 PerlIO_printf(file, "PVAV%s\n", s);
1251 PerlIO_printf(file, "PVHV%s\n", s);
1254 PerlIO_printf(file, "PVCV%s\n", s);
1257 PerlIO_printf(file, "PVGV%s\n", s);
1260 PerlIO_printf(file, "PVFM%s\n", s);
1263 PerlIO_printf(file, "PVIO%s\n", s);
1266 PerlIO_printf(file, "UNKNOWN(0x%"UVxf") %s\n", (UV)type, s);
1270 if (type >= SVt_PVIV || type == SVt_IV) {
1272 #ifdef PERL_COPY_ON_WRITE
1276 Perl_dump_indent(aTHX_ level, file, " UV = %"UVuf, (UV)SvUVX(sv));
1278 Perl_dump_indent(aTHX_ level, file, " IV = %"IVdf, (IV)SvIVX(sv));
1280 PerlIO_printf(file, " (OFFSET)");
1281 #ifdef PERL_COPY_ON_WRITE
1282 if (SvIsCOW_shared_hash(sv))
1283 PerlIO_printf(file, " (HASH)");
1284 else if (SvIsCOW_normal(sv))
1285 PerlIO_printf(file, " (COW from 0x%"UVxf")", (UV)SvUVX(sv));
1287 PerlIO_putc(file, '\n');
1289 if (type >= SVt_PVNV || type == SVt_NV) {
1290 STORE_NUMERIC_LOCAL_SET_STANDARD();
1291 /* %Vg doesn't work? --jhi */
1292 #ifdef USE_LONG_DOUBLE
1293 Perl_dump_indent(aTHX_ level, file, " NV = %.*" PERL_PRIgldbl "\n", LDBL_DIG, SvNVX(sv));
1295 Perl_dump_indent(aTHX_ level, file, " NV = %.*g\n", DBL_DIG, SvNVX(sv));
1297 RESTORE_NUMERIC_LOCAL();
1300 Perl_dump_indent(aTHX_ level, file, " RV = 0x%"UVxf"\n", PTR2UV(SvRV(sv)));
1302 do_sv_dump(level+1, file, SvRV(sv), nest+1, maxnest, dumpops, pvlim);
1304 if (type < SVt_PV) {
1308 if (type <= SVt_PVLV && type != SVt_PVGV) {
1310 Perl_dump_indent(aTHX_ level, file," PV = 0x%"UVxf" ", PTR2UV(SvPVX(sv)));
1312 PerlIO_printf(file, "( %s . ) ", pv_display(d, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, pvlim));
1313 PerlIO_printf(file, "%s", pv_display(d, SvPVX(sv), SvCUR(sv), SvLEN(sv), pvlim));
1314 if (SvUTF8(sv)) /* the 8? \x{....} */
1315 PerlIO_printf(file, " [UTF8 \"%s\"]", sv_uni_display(d, sv, 8 * sv_len_utf8(sv), UNI_DISPLAY_QQ));
1316 PerlIO_printf(file, "\n");
1317 Perl_dump_indent(aTHX_ level, file, " CUR = %"IVdf"\n", (IV)SvCUR(sv));
1318 Perl_dump_indent(aTHX_ level, file, " LEN = %"IVdf"\n", (IV)SvLEN(sv));
1321 Perl_dump_indent(aTHX_ level, file, " PV = 0\n");
1323 if (type >= SVt_PVMG) {
1325 do_magic_dump(level, file, SvMAGIC(sv), nest, maxnest, dumpops, pvlim);
1327 do_hv_dump(level, file, " STASH", SvSTASH(sv));
1331 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(AvARRAY(sv)));
1332 if (AvARRAY(sv) != AvALLOC(sv)) {
1333 PerlIO_printf(file, " (offset=%"IVdf")\n", (IV)(AvARRAY(sv) - AvALLOC(sv)));
1334 Perl_dump_indent(aTHX_ level, file, " ALLOC = 0x%"UVxf"\n", PTR2UV(AvALLOC(sv)));
1337 PerlIO_putc(file, '\n');
1338 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)AvFILLp(sv));
1339 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)AvMAX(sv));
1340 Perl_dump_indent(aTHX_ level, file, " ARYLEN = 0x%"UVxf"\n", PTR2UV(AvARYLEN(sv)));
1341 flags = AvFLAGS(sv);
1343 if (flags & AVf_REAL) sv_catpv(d, ",REAL");
1344 if (flags & AVf_REIFY) sv_catpv(d, ",REIFY");
1345 if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
1346 Perl_dump_indent(aTHX_ level, file, " FLAGS = (%s)\n", SvCUR(d) ? SvPVX(d) + 1 : "");
1347 if (nest < maxnest && av_len((AV*)sv) >= 0) {
1349 for (count = 0; count <= av_len((AV*)sv) && count < maxnest; count++) {
1350 SV** elt = av_fetch((AV*)sv,count,0);
1352 Perl_dump_indent(aTHX_ level + 1, file, "Elt No. %"IVdf"\n", (IV)count);
1354 do_sv_dump(level+1, file, *elt, nest+1, maxnest, dumpops, pvlim);
1359 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(HvARRAY(sv)));
1360 if (HvARRAY(sv) && HvKEYS(sv)) {
1361 /* Show distribution of HEs in the ARRAY */
1363 #define FREQ_MAX (sizeof freq / sizeof freq[0] - 1)
1366 U32 pow2 = 2, keys = HvKEYS(sv);
1367 NV theoret, sum = 0;
1369 PerlIO_printf(file, " (");
1370 Zero(freq, FREQ_MAX + 1, int);
1371 for (i = 0; (STRLEN)i <= HvMAX(sv); i++) {
1372 HE* h; int count = 0;
1373 for (h = HvARRAY(sv)[i]; h; h = HeNEXT(h))
1375 if (count > FREQ_MAX)
1381 for (i = 0; i <= max; i++) {
1383 PerlIO_printf(file, "%d%s:%d", i,
1384 (i == FREQ_MAX) ? "+" : "",
1387 PerlIO_printf(file, ", ");
1390 PerlIO_putc(file, ')');
1391 /* The "quality" of a hash is defined as the total number of
1392 comparisons needed to access every element once, relative
1393 to the expected number needed for a random hash.
1395 The total number of comparisons is equal to the sum of
1396 the squares of the number of entries in each bucket.
1397 For a random hash of n keys into k buckets, the expected
1402 for (i = max; i > 0; i--) { /* Precision: count down. */
1403 sum += freq[i] * i * i;
1405 while ((keys = keys >> 1))
1407 theoret = HvKEYS(sv);
1408 theoret += theoret * (theoret-1)/pow2;
1409 PerlIO_putc(file, '\n');
1410 Perl_dump_indent(aTHX_ level, file, " hash quality = %.1"NVff"%%", theoret/sum*100);
1412 PerlIO_putc(file, '\n');
1413 Perl_dump_indent(aTHX_ level, file, " KEYS = %"IVdf"\n", (IV)HvKEYS(sv));
1414 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)HvFILL(sv));
1415 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)HvMAX(sv));
1416 Perl_dump_indent(aTHX_ level, file, " RITER = %"IVdf"\n", (IV)HvRITER(sv));
1417 Perl_dump_indent(aTHX_ level, file, " EITER = 0x%"UVxf"\n", PTR2UV(HvEITER(sv)));
1419 Perl_dump_indent(aTHX_ level, file, " PMROOT = 0x%"UVxf"\n", PTR2UV(HvPMROOT(sv)));
1421 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", HvNAME(sv));
1422 if (nest < maxnest && !HvEITER(sv)) { /* Try to preserve iterator */
1425 int count = maxnest - nest;
1428 while ((he = hv_iternext_flags(hv, HV_ITERNEXT_WANTPLACEHOLDERS))
1433 U32 hash = HeHASH(he);
1435 keysv = hv_iterkeysv(he);
1436 keypv = SvPV(keysv, len);
1437 elt = hv_iterval(hv, he);
1438 Perl_dump_indent(aTHX_ level+1, file, "Elt %s ", pv_display(d, keypv, len, 0, pvlim));
1440 PerlIO_printf(file, "[UTF8 \"%s\"] ", sv_uni_display(d, keysv, 8 * sv_len_utf8(keysv), UNI_DISPLAY_QQ));
1442 PerlIO_printf(file, "[REHASH] ");
1443 PerlIO_printf(file, "HASH = 0x%"UVxf"\n", (UV)hash);
1444 do_sv_dump(level+1, file, elt, nest+1, maxnest, dumpops, pvlim);
1446 hv_iterinit(hv); /* Return to status quo */
1451 Perl_dump_indent(aTHX_ level, file, " PROTOTYPE = \"%s\"\n", SvPV_nolen(sv));
1454 do_hv_dump(level, file, " COMP_STASH", CvSTASH(sv));
1456 Perl_dump_indent(aTHX_ level, file, " START = 0x%"UVxf" ===> %"IVdf"\n", PTR2UV(CvSTART(sv)), (IV)sequence_num(aTHX_ CvSTART(sv)));
1457 Perl_dump_indent(aTHX_ level, file, " ROOT = 0x%"UVxf"\n", PTR2UV(CvROOT(sv)));
1458 if (CvROOT(sv) && dumpops)
1459 do_op_dump(level+1, file, CvROOT(sv));
1460 Perl_dump_indent(aTHX_ level, file, " XSUB = 0x%"UVxf"\n", PTR2UV(CvXSUB(sv)));
1461 Perl_dump_indent(aTHX_ level, file, " XSUBANY = %"IVdf"\n", (IV)CvXSUBANY(sv).any_i32);
1462 do_gvgv_dump(level, file, " GVGV::GV", CvGV(sv));
1463 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", CvFILE(sv));
1464 Perl_dump_indent(aTHX_ level, file, " DEPTH = %"IVdf"\n", (IV)CvDEPTH(sv));
1465 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)CvFLAGS(sv));
1466 Perl_dump_indent(aTHX_ level, file, " OUTSIDE_SEQ = %"UVuf"\n", (UV)CvOUTSIDE_SEQ(sv));
1467 if (type == SVt_PVFM)
1468 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)FmLINES(sv));
1469 Perl_dump_indent(aTHX_ level, file, " PADLIST = 0x%"UVxf"\n", PTR2UV(CvPADLIST(sv)));
1470 if (nest < maxnest) {
1471 do_dump_pad(level+1, file, CvPADLIST(sv), 0);
1474 const CV *outside = CvOUTSIDE(sv);
1475 Perl_dump_indent(aTHX_ level, file, " OUTSIDE = 0x%"UVxf" (%s)\n",
1478 : CvANON(outside) ? "ANON"
1479 : (outside == PL_main_cv) ? "MAIN"
1480 : CvUNIQUE(outside) ? "UNIQUE"
1481 : CvGV(outside) ? GvNAME(CvGV(outside)) : "UNDEFINED"));
1483 if (nest < maxnest && (CvCLONE(sv) || CvCLONED(sv)))
1484 do_sv_dump(level+1, file, (SV*)CvOUTSIDE(sv), nest+1, maxnest, dumpops, pvlim);
1486 case SVt_PVGV: case SVt_PVLV:
1487 if (type == SVt_PVLV) {
1488 Perl_dump_indent(aTHX_ level, file, " TYPE = %c\n", LvTYPE(sv));
1489 Perl_dump_indent(aTHX_ level, file, " TARGOFF = %"IVdf"\n", (IV)LvTARGOFF(sv));
1490 Perl_dump_indent(aTHX_ level, file, " TARGLEN = %"IVdf"\n", (IV)LvTARGLEN(sv));
1491 Perl_dump_indent(aTHX_ level, file, " TARG = 0x%"UVxf"\n", PTR2UV(LvTARG(sv)));
1492 if (LvTYPE(sv) != 't' && LvTYPE(sv) != 'T')
1493 do_sv_dump(level+1, file, LvTARG(sv), nest+1, maxnest,
1496 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", GvNAME(sv));
1497 Perl_dump_indent(aTHX_ level, file, " NAMELEN = %"IVdf"\n", (IV)GvNAMELEN(sv));
1498 do_hv_dump (level, file, " GvSTASH", GvSTASH(sv));
1499 Perl_dump_indent(aTHX_ level, file, " GP = 0x%"UVxf"\n", PTR2UV(GvGP(sv)));
1502 Perl_dump_indent(aTHX_ level, file, " SV = 0x%"UVxf"\n", PTR2UV(GvSV(sv)));
1503 Perl_dump_indent(aTHX_ level, file, " REFCNT = %"IVdf"\n", (IV)GvREFCNT(sv));
1504 Perl_dump_indent(aTHX_ level, file, " IO = 0x%"UVxf"\n", PTR2UV(GvIOp(sv)));
1505 Perl_dump_indent(aTHX_ level, file, " FORM = 0x%"UVxf" \n", PTR2UV(GvFORM(sv)));
1506 Perl_dump_indent(aTHX_ level, file, " AV = 0x%"UVxf"\n", PTR2UV(GvAV(sv)));
1507 Perl_dump_indent(aTHX_ level, file, " HV = 0x%"UVxf"\n", PTR2UV(GvHV(sv)));
1508 Perl_dump_indent(aTHX_ level, file, " CV = 0x%"UVxf"\n", PTR2UV(GvCV(sv)));
1509 Perl_dump_indent(aTHX_ level, file, " CVGEN = 0x%"UVxf"\n", (UV)GvCVGEN(sv));
1510 Perl_dump_indent(aTHX_ level, file, " GPFLAGS = 0x%"UVxf"\n", (UV)GvGPFLAGS(sv));
1511 Perl_dump_indent(aTHX_ level, file, " LINE = %"IVdf"\n", (IV)GvLINE(sv));
1512 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", GvFILE(sv));
1513 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)GvFLAGS(sv));
1514 do_gv_dump (level, file, " EGV", GvEGV(sv));
1517 Perl_dump_indent(aTHX_ level, file, " IFP = 0x%"UVxf"\n", PTR2UV(IoIFP(sv)));
1518 Perl_dump_indent(aTHX_ level, file, " OFP = 0x%"UVxf"\n", PTR2UV(IoOFP(sv)));
1519 Perl_dump_indent(aTHX_ level, file, " DIRP = 0x%"UVxf"\n", PTR2UV(IoDIRP(sv)));
1520 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)IoLINES(sv));
1521 Perl_dump_indent(aTHX_ level, file, " PAGE = %"IVdf"\n", (IV)IoPAGE(sv));
1522 Perl_dump_indent(aTHX_ level, file, " PAGE_LEN = %"IVdf"\n", (IV)IoPAGE_LEN(sv));
1523 Perl_dump_indent(aTHX_ level, file, " LINES_LEFT = %"IVdf"\n", (IV)IoLINES_LEFT(sv));
1525 Perl_dump_indent(aTHX_ level, file, " TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
1526 do_gv_dump (level, file, " TOP_GV", IoTOP_GV(sv));
1528 Perl_dump_indent(aTHX_ level, file, " FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
1529 do_gv_dump (level, file, " FMT_GV", IoFMT_GV(sv));
1530 if (IoBOTTOM_NAME(sv))
1531 Perl_dump_indent(aTHX_ level, file, " BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
1532 do_gv_dump (level, file, " BOTTOM_GV", IoBOTTOM_GV(sv));
1533 Perl_dump_indent(aTHX_ level, file, " SUBPROCESS = %"IVdf"\n", (IV)IoSUBPROCESS(sv));
1534 if (isPRINT(IoTYPE(sv)))
1535 Perl_dump_indent(aTHX_ level, file, " TYPE = '%c'\n", IoTYPE(sv));
1537 Perl_dump_indent(aTHX_ level, file, " TYPE = '\\%o'\n", IoTYPE(sv));
1538 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)IoFLAGS(sv));
1545 Perl_sv_dump(pTHX_ SV *sv)
1547 do_sv_dump(0, Perl_debug_log, sv, 0, 0, 0, 0);
1551 Perl_runops_debug(pTHX)
1554 if (ckWARN_d(WARN_DEBUGGING))
1555 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING), "NULL OP IN RUN");
1559 DEBUG_l(Perl_deb(aTHX_ "Entering new RUNOPS level\n"));
1563 if (PL_watchaddr != 0 && *PL_watchaddr != PL_watchok)
1564 PerlIO_printf(Perl_debug_log,
1565 "WARNING: %"UVxf" changed from %"UVxf" to %"UVxf"\n",
1566 PTR2UV(PL_watchaddr), PTR2UV(PL_watchok),
1567 PTR2UV(*PL_watchaddr));
1568 if (DEBUG_s_TEST_) {
1569 if (DEBUG_v_TEST_) {
1570 PerlIO_printf(Perl_debug_log, "\n");
1578 if (DEBUG_t_TEST_) debop(PL_op);
1579 if (DEBUG_P_TEST_) debprof(PL_op);
1581 } while ((PL_op = CALL_FPTR(PL_op->op_ppaddr)(aTHX)));
1582 DEBUG_l(Perl_deb(aTHX_ "leaving RUNOPS level\n"));
1589 Perl_debop(pTHX_ const OP *o)
1594 if (CopSTASH_eq(PL_curcop, PL_debstash) && !DEBUG_J_TEST_)
1597 Perl_deb(aTHX_ "%s", OP_NAME(o));
1598 switch (o->op_type) {
1600 PerlIO_printf(Perl_debug_log, "(%s)", SvPEEK(cSVOPo_sv));
1606 gv_fullname3(sv, cGVOPo_gv, Nullch);
1607 PerlIO_printf(Perl_debug_log, "(%s)", SvPV_nolen(sv));
1611 PerlIO_printf(Perl_debug_log, "(NULL)");
1616 /* print the lexical's name */
1617 cv = deb_curcv(cxstack_ix);
1619 AV *padlist = CvPADLIST(cv);
1620 AV *comppad = (AV*)(*av_fetch(padlist, 0, FALSE));
1621 sv = *av_fetch(comppad, o->op_targ, FALSE);
1625 PerlIO_printf(Perl_debug_log, "(%s)", SvPV_nolen(sv));
1627 PerlIO_printf(Perl_debug_log, "[%"UVuf"]", (UV)o->op_targ);
1632 PerlIO_printf(Perl_debug_log, "\n");
1637 S_deb_curcv(pTHX_ I32 ix)
1639 const PERL_CONTEXT *cx = &cxstack[ix];
1640 if (CxTYPE(cx) == CXt_SUB || CxTYPE(cx) == CXt_FORMAT)
1641 return cx->blk_sub.cv;
1642 else if (CxTYPE(cx) == CXt_EVAL && !CxTRYBLOCK(cx))
1644 else if (ix == 0 && PL_curstackinfo->si_type == PERLSI_MAIN)
1649 return deb_curcv(ix - 1);
1653 Perl_watch(pTHX_ char **addr)
1655 PL_watchaddr = addr;
1657 PerlIO_printf(Perl_debug_log, "WATCHING, %"UVxf" is currently %"UVxf"\n",
1658 PTR2UV(PL_watchaddr), PTR2UV(PL_watchok));
1662 S_debprof(pTHX_ const OP *o)
1664 if (CopSTASH_eq(PL_curcop, PL_debstash) && !DEBUG_J_TEST_)
1666 if (!PL_profiledata)
1667 Newz(000, PL_profiledata, MAXO, U32);
1668 ++PL_profiledata[o->op_type];
1672 Perl_debprofdump(pTHX)
1675 if (!PL_profiledata)
1677 for (i = 0; i < MAXO; i++) {
1678 if (PL_profiledata[i])
1679 PerlIO_printf(Perl_debug_log,
1680 "%5lu %s\n", (unsigned long)PL_profiledata[i],