Slight comment tweakage.
[p5sagit/p5-mst-13.2.git] / dump.c
1 /*    dump.c
2  *
3  *    Copyright (c) 1991-2001, Larry Wall
4  *
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.
7  *
8  */
9
10 /*
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.'"
13  */
14
15 #include "EXTERN.h"
16 #define PERL_IN_DUMP_C
17 #include "perl.h"
18 #include "regcomp.h"
19
20 void
21 Perl_dump_indent(pTHX_ I32 level, PerlIO *file, const char* pat, ...)
22 {
23     va_list args;
24     va_start(args, pat);
25     dump_vindent(level, file, pat, &args);
26     va_end(args);
27 }
28
29 void
30 Perl_dump_vindent(pTHX_ I32 level, PerlIO *file, const char* pat, va_list *args)
31 {
32     PerlIO_printf(file, "%*s", (int)(level*PL_dumpindent), "");
33     PerlIO_vprintf(file, pat, *args);
34 }
35
36 void
37 Perl_dump_all(pTHX)
38 {
39     PerlIO_setlinebuf(Perl_debug_log);
40     if (PL_main_root)
41         op_dump(PL_main_root);
42     dump_packsubs(PL_defstash);
43 }
44
45 void
46 Perl_dump_packsubs(pTHX_ HV *stash)
47 {
48     I32 i;
49     HE  *entry;
50
51     if (!HvARRAY(stash))
52         return;
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);
56             HV *hv;
57             if (SvTYPE(gv) != SVt_PVGV || !GvGP(gv))
58                 continue;
59             if (GvCVu(gv))
60                 dump_sub(gv);
61             if (GvFORM(gv))
62                 dump_form(gv);
63             if (HeKEY(entry)[HeKLEN(entry)-1] == ':'
64                 && (hv = GvHV(gv)) && hv != PL_defstash)
65                 dump_packsubs(hv);              /* nested package */
66         }
67     }
68 }
69
70 void
71 Perl_dump_sub(pTHX_ GV *gv)
72 {
73     SV *sv = sv_newmortal();
74
75     gv_fullname3(sv, gv, Nullch);
76     Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nSUB %s = ", SvPVX(sv));
77     if (CvXSUB(GvCV(gv)))
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)));
83     else
84         Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
85 }
86
87 void
88 Perl_dump_form(pTHX_ GV *gv)
89 {
90     SV *sv = sv_newmortal();
91
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)));
96     else
97         Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
98 }
99
100 void
101 Perl_dump_eval(pTHX)
102 {
103     op_dump(PL_eval_root);
104 }
105
106 char *
107 Perl_pv_display(pTHX_ SV *dsv, char *pv, STRLEN cur, STRLEN len, STRLEN pvlim)
108 {
109     int truncated = 0;
110     int nul_terminated = len > cur && pv[cur] == '\0';
111
112     sv_setpvn(dsv, "\"", 1);
113     for (; cur--; pv++) {
114         if (pvlim && SvCUR(dsv) >= pvlim) {
115             truncated++;
116             break;
117         }
118         if (isPRINT(*pv)) {
119             switch (*pv) {
120             case '\t': sv_catpvn(dsv, "\\t", 2);  break;
121             case '\n': sv_catpvn(dsv, "\\n", 2);  break;
122             case '\r': sv_catpvn(dsv, "\\r", 2);  break;
123             case '\f': sv_catpvn(dsv, "\\f", 2);  break;
124             case '"':  sv_catpvn(dsv, "\\\"", 2); break;
125             case '\\': sv_catpvn(dsv, "\\\\", 2); break;
126             default:   sv_catpvn(dsv, pv, 1);     break;
127             }
128         }
129         else {
130             if (cur && isDIGIT(*(pv+1)))
131                 Perl_sv_catpvf(aTHX_ dsv, "\\%03o", (U8)*pv);
132             else
133                 Perl_sv_catpvf(aTHX_ dsv, "\\%o", (U8)*pv);
134         }
135     }
136     sv_catpvn(dsv, "\"", 1);
137     if (truncated)
138         sv_catpvn(dsv, "...", 3);
139     if (nul_terminated)
140         sv_catpvn(dsv, "\\0", 2);
141
142     return SvPVX(dsv);
143 }
144
145 char *
146 Perl_sv_peek(pTHX_ SV *sv)
147 {
148     SV *t = sv_newmortal();
149     STRLEN n_a;
150     int unref = 0;
151
152     sv_setpvn(t, "", 0);
153   retry:
154     if (!sv) {
155         sv_catpv(t, "VOID");
156         goto finish;
157     }
158     else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
159         sv_catpv(t, "WILD");
160         goto finish;
161     }
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)) &&
167                 SvREADONLY(sv))
168                 goto finish;
169         }
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|
175                                   SVp_POK|SVp_NOK)) &&
176                 SvCUR(sv) == 0 &&
177                 SvNVX(sv) == 0.0)
178                 goto finish;
179         }
180         else {
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|
185                                   SVp_POK|SVp_NOK)) &&
186                 SvCUR(sv) == 1 &&
187                 SvPVX(sv) && *SvPVX(sv) == '1' &&
188                 SvNVX(sv) == 1.0)
189                 goto finish;
190         }
191         sv_catpv(t, ":");
192     }
193     else if (SvREFCNT(sv) == 0) {
194         sv_catpv(t, "(");
195         unref++;
196     }
197     else if (DEBUG_R_TEST_ && SvREFCNT(sv) > 1) {
198         Perl_sv_catpvf(aTHX_ t, "<%"UVuf">", (UV)SvREFCNT(sv));
199     }
200
201
202     if (SvROK(sv)) {
203         sv_catpv(t, "\\");
204         if (SvCUR(t) + unref > 10) {
205             SvCUR(t) = unref + 3;
206             *SvEND(t) = '\0';
207             sv_catpv(t, "...");
208             goto finish;
209         }
210         sv = (SV*)SvRV(sv);
211         goto retry;
212     }
213     switch (SvTYPE(sv)) {
214     default:
215         sv_catpv(t, "FREED");
216         goto finish;
217
218     case SVt_NULL:
219         sv_catpv(t, "UNDEF");
220         goto finish;
221     case SVt_IV:
222         sv_catpv(t, "IV");
223         break;
224     case SVt_NV:
225         sv_catpv(t, "NV");
226         break;
227     case SVt_RV:
228         sv_catpv(t, "RV");
229         break;
230     case SVt_PV:
231         sv_catpv(t, "PV");
232         break;
233     case SVt_PVIV:
234         sv_catpv(t, "PVIV");
235         break;
236     case SVt_PVNV:
237         sv_catpv(t, "PVNV");
238         break;
239     case SVt_PVMG:
240         sv_catpv(t, "PVMG");
241         break;
242     case SVt_PVLV:
243         sv_catpv(t, "PVLV");
244         break;
245     case SVt_PVAV:
246         sv_catpv(t, "AV");
247         break;
248     case SVt_PVHV:
249         sv_catpv(t, "HV");
250         break;
251     case SVt_PVCV:
252         if (CvGV(sv))
253             Perl_sv_catpvf(aTHX_ t, "CV(%s)", GvNAME(CvGV(sv)));
254         else
255             sv_catpv(t, "CV()");
256         goto finish;
257     case SVt_PVGV:
258         sv_catpv(t, "GV");
259         break;
260     case SVt_PVBM:
261         sv_catpv(t, "BM");
262         break;
263     case SVt_PVFM:
264         sv_catpv(t, "FM");
265         break;
266     case SVt_PVIO:
267         sv_catpv(t, "IO");
268         break;
269     }
270
271     if (SvPOKp(sv)) {
272         if (!SvPVX(sv))
273             sv_catpv(t, "(null)");
274         else {
275             SV *tmp = newSVpvn("", 0);
276             sv_catpv(t, "(");
277             if (SvOOK(sv))
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));
280             if (SvUTF8(sv))
281                 Perl_sv_catpvf(aTHX_ t, " [UTF8 \"%s\"]",
282                                sv_uni_display(tmp, sv, 8 * sv_len_utf8(sv), 0));
283             SvREFCNT_dec(tmp);
284         }
285     }
286     else if (SvNOKp(sv)) {
287         STORE_NUMERIC_LOCAL_SET_STANDARD();
288         Perl_sv_catpvf(aTHX_ t, "(%"NVgf")",SvNVX(sv));
289         RESTORE_NUMERIC_LOCAL();
290     }
291     else if (SvIOKp(sv)) {
292         if (SvIsUV(sv))
293             Perl_sv_catpvf(aTHX_ t, "(%"UVuf")", (UV)SvUVX(sv));
294         else
295             Perl_sv_catpvf(aTHX_ t, "(%"IVdf")", (IV)SvIVX(sv));
296     }
297     else
298         sv_catpv(t, "()");
299
300   finish:
301     if (unref) {
302         while (unref--)
303             sv_catpv(t, ")");
304     }
305     return SvPV(t, n_a);
306 }
307
308 void
309 Perl_do_pmop_dump(pTHX_ I32 level, PerlIO *file, PMOP *pm)
310 {
311     char ch;
312
313     if (!pm) {
314         Perl_dump_indent(aTHX_ level, file, "{}\n");
315         return;
316     }
317     Perl_dump_indent(aTHX_ level, file, "{\n");
318     level++;
319     if (pm->op_pmflags & PMf_ONCE)
320         ch = '?';
321     else
322         ch = '/';
323     if (PM_GETRE(pm))
324         Perl_dump_indent(aTHX_ level, file, "PMf_PRE %c%s%c%s\n",
325              ch, PM_GETRE(pm)->precomp, ch,
326              (pm->op_private & OPpRUNTIME) ? " (RUNTIME)" : "");
327     else
328         Perl_dump_indent(aTHX_ level, file, "PMf_PRE (RUNTIME)\n");
329     if (pm->op_type != OP_PUSHRE && pm->op_pmreplroot) {
330         Perl_dump_indent(aTHX_ level, file, "PMf_REPL = ");
331         op_dump(pm->op_pmreplroot);
332     }
333     if (pm->op_pmflags || (PM_GETRE(pm) && PM_GETRE(pm)->check_substr)) {
334         SV *tmpsv = newSVpvn("", 0);
335         if (pm->op_pmdynflags & PMdf_USED)
336             sv_catpv(tmpsv, ",USED");
337         if (pm->op_pmdynflags & PMdf_TAINTED)
338             sv_catpv(tmpsv, ",TAINTED");
339         if (pm->op_pmflags & PMf_ONCE)
340             sv_catpv(tmpsv, ",ONCE");
341         if (PM_GETRE(pm) && PM_GETRE(pm)->check_substr
342             && !(PM_GETRE(pm)->reganch & ROPT_NOSCAN))
343             sv_catpv(tmpsv, ",SCANFIRST");
344         if (PM_GETRE(pm) && PM_GETRE(pm)->check_substr
345             && PM_GETRE(pm)->reganch & ROPT_CHECK_ALL)
346             sv_catpv(tmpsv, ",ALL");
347         if (pm->op_pmflags & PMf_SKIPWHITE)
348             sv_catpv(tmpsv, ",SKIPWHITE");
349         if (pm->op_pmflags & PMf_CONST)
350             sv_catpv(tmpsv, ",CONST");
351         if (pm->op_pmflags & PMf_KEEP)
352             sv_catpv(tmpsv, ",KEEP");
353         if (pm->op_pmflags & PMf_GLOBAL)
354             sv_catpv(tmpsv, ",GLOBAL");
355         if (pm->op_pmflags & PMf_CONTINUE)
356             sv_catpv(tmpsv, ",CONTINUE");
357         if (pm->op_pmflags & PMf_RETAINT)
358             sv_catpv(tmpsv, ",RETAINT");
359         if (pm->op_pmflags & PMf_EVAL)
360             sv_catpv(tmpsv, ",EVAL");
361         Perl_dump_indent(aTHX_ level, file, "PMFLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
362         SvREFCNT_dec(tmpsv);
363     }
364
365     Perl_dump_indent(aTHX_ level-1, file, "}\n");
366 }
367
368 void
369 Perl_pmop_dump(pTHX_ PMOP *pm)
370 {
371     do_pmop_dump(0, Perl_debug_log, pm);
372 }
373
374 void
375 Perl_do_op_dump(pTHX_ I32 level, PerlIO *file, OP *o)
376 {
377     Perl_dump_indent(aTHX_ level, file, "{\n");
378     level++;
379     if (o->op_seq)
380         PerlIO_printf(file, "%-4d", o->op_seq);
381     else
382         PerlIO_printf(file, "    ");
383     PerlIO_printf(file,
384                   "%*sTYPE = %s  ===> ",
385                   (int)(PL_dumpindent*level-4), "", OP_NAME(o));
386     if (o->op_next) {
387         if (o->op_seq)
388             PerlIO_printf(file, "%d\n", o->op_next->op_seq);
389         else
390             PerlIO_printf(file, "(%d)\n", o->op_next->op_seq);
391     }
392     else
393         PerlIO_printf(file, "DONE\n");
394     if (o->op_targ) {
395         if (o->op_type == OP_NULL)
396         {
397             Perl_dump_indent(aTHX_ level, file, "  (was %s)\n", PL_op_name[o->op_targ]);
398             if (o->op_targ == OP_NEXTSTATE)
399             {
400                 if (CopLINE(cCOPo))
401                     Perl_dump_indent(aTHX_ level, file, "LINE = %d\n",CopLINE(cCOPo));
402                 if (CopSTASHPV(cCOPo))
403                     Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
404                                      CopSTASHPV(cCOPo));
405                 if (cCOPo->cop_label)
406                     Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
407                                      cCOPo->cop_label);
408             }
409         }
410         else
411             Perl_dump_indent(aTHX_ level, file, "TARG = %ld\n", (long)o->op_targ);
412     }
413 #ifdef DUMPADDR
414     Perl_dump_indent(aTHX_ level, file, "ADDR = 0x%"UVxf" => 0x%"UVxf"\n", (UV)o, (UV)o->op_next);
415 #endif
416     if (o->op_flags) {
417         SV *tmpsv = newSVpvn("", 0);
418         switch (o->op_flags & OPf_WANT) {
419         case OPf_WANT_VOID:
420             sv_catpv(tmpsv, ",VOID");
421             break;
422         case OPf_WANT_SCALAR:
423             sv_catpv(tmpsv, ",SCALAR");
424             break;
425         case OPf_WANT_LIST:
426             sv_catpv(tmpsv, ",LIST");
427             break;
428         default:
429             sv_catpv(tmpsv, ",UNKNOWN");
430             break;
431         }
432         if (o->op_flags & OPf_KIDS)
433             sv_catpv(tmpsv, ",KIDS");
434         if (o->op_flags & OPf_PARENS)
435             sv_catpv(tmpsv, ",PARENS");
436         if (o->op_flags & OPf_STACKED)
437             sv_catpv(tmpsv, ",STACKED");
438         if (o->op_flags & OPf_REF)
439             sv_catpv(tmpsv, ",REF");
440         if (o->op_flags & OPf_MOD)
441             sv_catpv(tmpsv, ",MOD");
442         if (o->op_flags & OPf_SPECIAL)
443             sv_catpv(tmpsv, ",SPECIAL");
444         Perl_dump_indent(aTHX_ level, file, "FLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
445         SvREFCNT_dec(tmpsv);
446     }
447     if (o->op_private) {
448         SV *tmpsv = newSVpvn("", 0);
449         if (PL_opargs[o->op_type] & OA_TARGLEX) {
450             if (o->op_private & OPpTARGET_MY)
451                 sv_catpv(tmpsv, ",TARGET_MY");
452         }
453         else if (o->op_type == OP_LEAVESUB ||
454                  o->op_type == OP_LEAVE ||
455                  o->op_type == OP_LEAVESUBLV ||
456                  o->op_type == OP_LEAVEWRITE) {
457             if (o->op_private & OPpREFCOUNTED)
458                 sv_catpv(tmpsv, ",REFCOUNTED");
459         }
460         else if (o->op_type == OP_AASSIGN) {
461             if (o->op_private & OPpASSIGN_COMMON)
462                 sv_catpv(tmpsv, ",COMMON");
463             if (o->op_private & OPpASSIGN_HASH)
464                 sv_catpv(tmpsv, ",HASH");
465         }
466         else if (o->op_type == OP_SASSIGN) {
467             if (o->op_private & OPpASSIGN_BACKWARDS)
468                 sv_catpv(tmpsv, ",BACKWARDS");
469         }
470         else if (o->op_type == OP_TRANS) {
471             if (o->op_private & OPpTRANS_SQUASH)
472                 sv_catpv(tmpsv, ",SQUASH");
473             if (o->op_private & OPpTRANS_DELETE)
474                 sv_catpv(tmpsv, ",DELETE");
475             if (o->op_private & OPpTRANS_COMPLEMENT)
476                 sv_catpv(tmpsv, ",COMPLEMENT");
477             if (o->op_private & OPpTRANS_IDENTICAL)
478                 sv_catpv(tmpsv, ",IDENTICAL");
479             if (o->op_private & OPpTRANS_GROWS)
480                 sv_catpv(tmpsv, ",GROWS");
481         }
482         else if (o->op_type == OP_REPEAT) {
483             if (o->op_private & OPpREPEAT_DOLIST)
484                 sv_catpv(tmpsv, ",DOLIST");
485         }
486         else if (o->op_type == OP_ENTERSUB ||
487                  o->op_type == OP_RV2SV ||
488                  o->op_type == OP_GVSV ||
489                  o->op_type == OP_RV2AV ||
490                  o->op_type == OP_RV2HV ||
491                  o->op_type == OP_RV2GV ||
492                  o->op_type == OP_AELEM ||
493                  o->op_type == OP_HELEM )
494         {
495             if (o->op_type == OP_ENTERSUB) {
496                 if (o->op_private & OPpENTERSUB_AMPER)
497                     sv_catpv(tmpsv, ",AMPER");
498                 if (o->op_private & OPpENTERSUB_DB)
499                     sv_catpv(tmpsv, ",DB");
500                 if (o->op_private & OPpENTERSUB_HASTARG)
501                     sv_catpv(tmpsv, ",HASTARG");
502                 if (o->op_private & OPpENTERSUB_NOPAREN)
503                     sv_catpv(tmpsv, ",NOPAREN");
504                 if (o->op_private & OPpENTERSUB_INARGS)
505                     sv_catpv(tmpsv, ",INARGS");
506                 if (o->op_private & OPpENTERSUB_NOMOD)
507                     sv_catpv(tmpsv, ",NOMOD");
508             }
509             else {
510                 switch (o->op_private & OPpDEREF) {
511             case OPpDEREF_SV:
512                 sv_catpv(tmpsv, ",SV");
513                 break;
514             case OPpDEREF_AV:
515                 sv_catpv(tmpsv, ",AV");
516                 break;
517             case OPpDEREF_HV:
518                 sv_catpv(tmpsv, ",HV");
519                 break;
520             }
521                 if (o->op_private & OPpMAYBE_LVSUB)
522                     sv_catpv(tmpsv, ",MAYBE_LVSUB");
523             }
524             if (o->op_type == OP_AELEM || o->op_type == OP_HELEM) {
525                 if (o->op_private & OPpLVAL_DEFER)
526                     sv_catpv(tmpsv, ",LVAL_DEFER");
527             }
528             else {
529                 if (o->op_private & HINT_STRICT_REFS)
530                     sv_catpv(tmpsv, ",STRICT_REFS");
531                 if (o->op_private & OPpOUR_INTRO)
532                     sv_catpv(tmpsv, ",OUR_INTRO");
533             }
534         }
535         else if (o->op_type == OP_CONST) {
536             if (o->op_private & OPpCONST_BARE)
537                 sv_catpv(tmpsv, ",BARE");
538             if (o->op_private & OPpCONST_STRICT)
539                 sv_catpv(tmpsv, ",STRICT");
540             if (o->op_private & OPpCONST_ARYBASE)
541                 sv_catpv(tmpsv, ",ARYBASE");
542             if (o->op_private & OPpCONST_WARNING)
543                 sv_catpv(tmpsv, ",WARNING");
544             if (o->op_private & OPpCONST_ENTERED)
545                 sv_catpv(tmpsv, ",ENTERED");
546         }
547         else if (o->op_type == OP_FLIP) {
548             if (o->op_private & OPpFLIP_LINENUM)
549                 sv_catpv(tmpsv, ",LINENUM");
550         }
551         else if (o->op_type == OP_FLOP) {
552             if (o->op_private & OPpFLIP_LINENUM)
553                 sv_catpv(tmpsv, ",LINENUM");
554         }
555         else if (o->op_type == OP_RV2CV) {
556             if (o->op_private & OPpLVAL_INTRO)
557                 sv_catpv(tmpsv, ",INTRO");
558         }
559         else if (o->op_type == OP_GV) {
560             if (o->op_private & OPpEARLY_CV)
561                 sv_catpv(tmpsv, ",EARLY_CV");
562         }
563         else if (o->op_type == OP_LIST) {
564             if (o->op_private & OPpLIST_GUESSED)
565                 sv_catpv(tmpsv, ",GUESSED");
566         }
567         else if (o->op_type == OP_DELETE) {
568             if (o->op_private & OPpSLICE)
569                 sv_catpv(tmpsv, ",SLICE");
570         }
571         else if (o->op_type == OP_EXISTS) {
572             if (o->op_private & OPpEXISTS_SUB)
573                 sv_catpv(tmpsv, ",EXISTS_SUB");
574         }
575         else if (o->op_type == OP_SORT) {
576             if (o->op_private & OPpSORT_NUMERIC)
577                 sv_catpv(tmpsv, ",NUMERIC");
578             if (o->op_private & OPpSORT_INTEGER)
579                 sv_catpv(tmpsv, ",INTEGER");
580             if (o->op_private & OPpSORT_REVERSE)
581                 sv_catpv(tmpsv, ",REVERSE");
582         }
583         else if (o->op_type == OP_THREADSV) {
584             if (o->op_private & OPpDONE_SVREF)
585                 sv_catpv(tmpsv, ",SVREF");
586         }
587         else if (o->op_type == OP_OPEN || o->op_type == OP_BACKTICK) {
588             if (o->op_private & OPpOPEN_IN_RAW)
589                 sv_catpv(tmpsv, ",IN_RAW");
590             if (o->op_private & OPpOPEN_IN_CRLF)
591                 sv_catpv(tmpsv, ",IN_CRLF");
592             if (o->op_private & OPpOPEN_OUT_RAW)
593                 sv_catpv(tmpsv, ",OUT_RAW");
594             if (o->op_private & OPpOPEN_OUT_CRLF)
595                 sv_catpv(tmpsv, ",OUT_CRLF");
596         }
597         else if (o->op_type == OP_EXIT) {
598             if (o->op_private & OPpEXIT_VMSISH)
599                 sv_catpv(tmpsv, ",EXIT_VMSISH");
600             if (o->op_private & OPpHUSH_VMSISH)
601                 sv_catpv(tmpsv, ",HUSH_VMSISH");
602         }
603         else if (o->op_type == OP_DIE) {
604             if (o->op_private & OPpHUSH_VMSISH)
605                 sv_catpv(tmpsv, ",HUSH_VMSISH");
606         }
607         if (o->op_flags & OPf_MOD && o->op_private & OPpLVAL_INTRO)
608             sv_catpv(tmpsv, ",INTRO");
609         if (SvCUR(tmpsv))
610             Perl_dump_indent(aTHX_ level, file, "PRIVATE = (%s)\n", SvPVX(tmpsv) + 1);
611         SvREFCNT_dec(tmpsv);
612     }
613
614     switch (o->op_type) {
615     case OP_AELEMFAST:
616     case OP_GVSV:
617     case OP_GV:
618 #ifdef USE_ITHREADS
619         Perl_dump_indent(aTHX_ level, file, "PADIX = %d\n", cPADOPo->op_padix);
620 #else
621         if (cSVOPo->op_sv) {
622             SV *tmpsv = NEWSV(0,0);
623             STRLEN n_a;
624             ENTER;
625             SAVEFREESV(tmpsv);
626             gv_fullname3(tmpsv, (GV*)cSVOPo->op_sv, Nullch);
627             Perl_dump_indent(aTHX_ level, file, "GV = %s\n", SvPV(tmpsv, n_a));
628             LEAVE;
629         }
630         else
631             Perl_dump_indent(aTHX_ level, file, "GV = NULL\n");
632 #endif
633         break;
634     case OP_CONST:
635     case OP_METHOD_NAMED:
636         Perl_dump_indent(aTHX_ level, file, "SV = %s\n", SvPEEK(cSVOPo->op_sv));
637         break;
638     case OP_SETSTATE:
639     case OP_NEXTSTATE:
640     case OP_DBSTATE:
641         if (CopLINE(cCOPo))
642             Perl_dump_indent(aTHX_ level, file, "LINE = %d\n",CopLINE(cCOPo));
643         if (CopSTASHPV(cCOPo))
644             Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
645                              CopSTASHPV(cCOPo));
646         if (cCOPo->cop_label)
647             Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
648                              cCOPo->cop_label);
649         break;
650     case OP_ENTERLOOP:
651         Perl_dump_indent(aTHX_ level, file, "REDO ===> ");
652         if (cLOOPo->op_redoop)
653             PerlIO_printf(file, "%d\n", cLOOPo->op_redoop->op_seq);
654         else
655             PerlIO_printf(file, "DONE\n");
656         Perl_dump_indent(aTHX_ level, file, "NEXT ===> ");
657         if (cLOOPo->op_nextop)
658             PerlIO_printf(file, "%d\n", cLOOPo->op_nextop->op_seq);
659         else
660             PerlIO_printf(file, "DONE\n");
661         Perl_dump_indent(aTHX_ level, file, "LAST ===> ");
662         if (cLOOPo->op_lastop)
663             PerlIO_printf(file, "%d\n", cLOOPo->op_lastop->op_seq);
664         else
665             PerlIO_printf(file, "DONE\n");
666         break;
667     case OP_COND_EXPR:
668     case OP_RANGE:
669     case OP_MAPWHILE:
670     case OP_GREPWHILE:
671     case OP_OR:
672     case OP_AND:
673         Perl_dump_indent(aTHX_ level, file, "OTHER ===> ");
674         if (cLOGOPo->op_other)
675             PerlIO_printf(file, "%d\n", cLOGOPo->op_other->op_seq);
676         else
677             PerlIO_printf(file, "DONE\n");
678         break;
679     case OP_PUSHRE:
680     case OP_MATCH:
681     case OP_QR:
682     case OP_SUBST:
683         do_pmop_dump(level, file, cPMOPo);
684         break;
685     case OP_LEAVE:
686     case OP_LEAVEEVAL:
687     case OP_LEAVESUB:
688     case OP_LEAVESUBLV:
689     case OP_LEAVEWRITE:
690     case OP_SCOPE:
691         if (o->op_private & OPpREFCOUNTED)
692             Perl_dump_indent(aTHX_ level, file, "REFCNT = %"UVuf"\n", (UV)o->op_targ);
693         break;
694     default:
695         break;
696     }
697     if (o->op_flags & OPf_KIDS) {
698         OP *kid;
699         for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
700             do_op_dump(level, file, kid);
701     }
702     Perl_dump_indent(aTHX_ level-1, file, "}\n");
703 }
704
705 void
706 Perl_op_dump(pTHX_ OP *o)
707 {
708     do_op_dump(0, Perl_debug_log, o);
709 }
710
711 void
712 Perl_gv_dump(pTHX_ GV *gv)
713 {
714     SV *sv;
715
716     if (!gv) {
717         PerlIO_printf(Perl_debug_log, "{}\n");
718         return;
719     }
720     sv = sv_newmortal();
721     PerlIO_printf(Perl_debug_log, "{\n");
722     gv_fullname3(sv, gv, Nullch);
723     Perl_dump_indent(aTHX_ 1, Perl_debug_log, "GV_NAME = %s", SvPVX(sv));
724     if (gv != GvEGV(gv)) {
725         gv_efullname3(sv, GvEGV(gv), Nullch);
726         Perl_dump_indent(aTHX_ 1, Perl_debug_log, "-> %s", SvPVX(sv));
727     }
728     PerlIO_putc(Perl_debug_log, '\n');
729     Perl_dump_indent(aTHX_ 0, Perl_debug_log, "}\n");
730 }
731
732
733 /* map magic types to the symbolic name
734  * (with the PERL_MAGIC_ prefixed stripped)
735  */
736
737 static struct { char type; char *name; } magic_names[] = {
738         { PERL_MAGIC_sv,             "sv(\\0)" },
739         { PERL_MAGIC_arylen,         "arylen(#)" },
740         { PERL_MAGIC_glob,           "glob(*)" },
741         { PERL_MAGIC_pos,            "pos(.)" },
742         { PERL_MAGIC_backref,        "backref(<)" },
743         { PERL_MAGIC_overload,       "overload(A)" },
744         { PERL_MAGIC_bm,             "bm(B)" },
745         { PERL_MAGIC_regdata,        "regdata(D)" },
746         { PERL_MAGIC_env,            "env(E)" },
747         { PERL_MAGIC_isa,            "isa(I)" },
748         { PERL_MAGIC_dbfile,         "dbfile(L)" },
749         { PERL_MAGIC_tied,           "tied(P)" },
750         { PERL_MAGIC_sig,            "sig(S)" },
751         { PERL_MAGIC_uvar,           "uvar(U)" },
752         { PERL_MAGIC_overload_elem,  "overload_elem(a)" },
753         { PERL_MAGIC_overload_table, "overload_table(c)" },
754         { PERL_MAGIC_regdatum,       "regdatum(d)" },
755         { PERL_MAGIC_envelem,        "envelem(e)" },
756         { PERL_MAGIC_fm,             "fm(f)" },
757         { PERL_MAGIC_regex_global,   "regex_global(g)" },
758         { PERL_MAGIC_isaelem,        "isaelem(i)" },
759         { PERL_MAGIC_nkeys,          "nkeys(k)" },
760         { PERL_MAGIC_dbline,         "dbline(l)" },
761         { PERL_MAGIC_mutex,          "mutex(m)" },
762         { PERL_MAGIC_collxfrm,       "collxfrm(o)" },
763         { PERL_MAGIC_tiedelem,       "tiedelem(p)" },
764         { PERL_MAGIC_tiedscalar,     "tiedscalar(q)" },
765         { PERL_MAGIC_qr,             "qr(r)" },
766         { PERL_MAGIC_sigelem,        "sigelem(s)" },
767         { PERL_MAGIC_taint,          "taint(t)" },
768         { PERL_MAGIC_vec,            "vec(v)" },
769         { PERL_MAGIC_substr,         "substr(x)" },
770         { PERL_MAGIC_defelem,        "defelem(y)" },
771         { PERL_MAGIC_ext,            "ext(~)" },
772         /* this null string terminates the list */
773         { 0,                         0 },
774 };
775
776 void
777 Perl_do_magic_dump(pTHX_ I32 level, PerlIO *file, MAGIC *mg, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
778 {
779     for (; mg; mg = mg->mg_moremagic) {
780         Perl_dump_indent(aTHX_ level, file,
781                          "  MAGIC = 0x%"UVxf"\n", PTR2UV(mg));
782         if (mg->mg_virtual) {
783             MGVTBL *v = mg->mg_virtual;
784             char *s = 0;
785             if      (v == &PL_vtbl_sv)         s = "sv";
786             else if (v == &PL_vtbl_env)        s = "env";
787             else if (v == &PL_vtbl_envelem)    s = "envelem";
788             else if (v == &PL_vtbl_sig)        s = "sig";
789             else if (v == &PL_vtbl_sigelem)    s = "sigelem";
790             else if (v == &PL_vtbl_pack)       s = "pack";
791             else if (v == &PL_vtbl_packelem)   s = "packelem";
792             else if (v == &PL_vtbl_dbline)     s = "dbline";
793             else if (v == &PL_vtbl_isa)        s = "isa";
794             else if (v == &PL_vtbl_arylen)     s = "arylen";
795             else if (v == &PL_vtbl_glob)       s = "glob";
796             else if (v == &PL_vtbl_mglob)      s = "mglob";
797             else if (v == &PL_vtbl_nkeys)      s = "nkeys";
798             else if (v == &PL_vtbl_taint)      s = "taint";
799             else if (v == &PL_vtbl_substr)     s = "substr";
800             else if (v == &PL_vtbl_vec)        s = "vec";
801             else if (v == &PL_vtbl_pos)        s = "pos";
802             else if (v == &PL_vtbl_bm)         s = "bm";
803             else if (v == &PL_vtbl_fm)         s = "fm";
804             else if (v == &PL_vtbl_uvar)       s = "uvar";
805             else if (v == &PL_vtbl_defelem)    s = "defelem";
806 #ifdef USE_LOCALE_COLLATE
807             else if (v == &PL_vtbl_collxfrm)   s = "collxfrm";
808 #endif
809             else if (v == &PL_vtbl_amagic)     s = "amagic";
810             else if (v == &PL_vtbl_amagicelem) s = "amagicelem";
811             else if (v == &PL_vtbl_backref)    s = "backref";
812             if (s)
813                 Perl_dump_indent(aTHX_ level, file, "    MG_VIRTUAL = &PL_vtbl_%s\n", s);
814             else
815                 Perl_dump_indent(aTHX_ level, file, "    MG_VIRTUAL = 0x%"UVxf"\n", PTR2UV(v));
816         }
817         else
818             Perl_dump_indent(aTHX_ level, file, "    MG_VIRTUAL = 0\n");
819
820         if (mg->mg_private)
821             Perl_dump_indent(aTHX_ level, file, "    MG_PRIVATE = %d\n", mg->mg_private);
822
823         {
824             int n;
825             char *name = 0;
826             for (n=0; magic_names[n].name; n++) {
827                 if (mg->mg_type == magic_names[n].type) {
828                     name = magic_names[n].name;
829                     break;
830                 }
831             }
832             if (name)
833                 Perl_dump_indent(aTHX_ level, file,
834                                 "    MG_TYPE = PERL_MAGIC_%s\n", name);
835             else
836                 Perl_dump_indent(aTHX_ level, file,
837                                 "    MG_TYPE = UNKNOWN(\\%o)\n", mg->mg_type);
838         }
839
840         if (mg->mg_flags) {
841             Perl_dump_indent(aTHX_ level, file, "    MG_FLAGS = 0x%02X\n", mg->mg_flags);
842             if (mg->mg_flags & MGf_TAINTEDDIR)
843                 Perl_dump_indent(aTHX_ level, file, "      TAINTEDDIR\n");
844             if (mg->mg_flags & MGf_REFCOUNTED)
845                 Perl_dump_indent(aTHX_ level, file, "      REFCOUNTED\n");
846             if (mg->mg_flags & MGf_GSKIP)
847                 Perl_dump_indent(aTHX_ level, file, "      GSKIP\n");
848             if (mg->mg_flags & MGf_MINMATCH)
849                 Perl_dump_indent(aTHX_ level, file, "      MINMATCH\n");
850         }
851         if (mg->mg_obj) {
852             Perl_dump_indent(aTHX_ level, file, "    MG_OBJ = 0x%"UVxf"\n", PTR2UV(mg->mg_obj));
853             if (mg->mg_flags & MGf_REFCOUNTED)
854                 do_sv_dump(level+2, file, mg->mg_obj, nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
855         }
856         if (mg->mg_len)
857             Perl_dump_indent(aTHX_ level, file, "    MG_LEN = %ld\n", (long)mg->mg_len);
858         if (mg->mg_ptr) {
859             Perl_dump_indent(aTHX_ level, file, "    MG_PTR = 0x%"UVxf, PTR2UV(mg->mg_ptr));
860             if (mg->mg_len >= 0) {
861                 SV *sv = newSVpvn("", 0);
862                 PerlIO_printf(file, " %s", pv_display(sv, mg->mg_ptr, mg->mg_len, 0, pvlim));
863                 SvREFCNT_dec(sv);
864             }
865             else if (mg->mg_len == HEf_SVKEY) {
866                 PerlIO_puts(file, " => HEf_SVKEY\n");
867                 do_sv_dump(level+2, file, (SV*)((mg)->mg_ptr), nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
868                 continue;
869             }
870             else
871                 PerlIO_puts(file, " ???? - please notify IZ");
872             PerlIO_putc(file, '\n');
873         }
874     }
875 }
876
877 void
878 Perl_magic_dump(pTHX_ MAGIC *mg)
879 {
880     do_magic_dump(0, Perl_debug_log, mg, 0, 0, 0, 0);
881 }
882
883 void
884 Perl_do_hv_dump(pTHX_ I32 level, PerlIO *file, char *name, HV *sv)
885 {
886     Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
887     if (sv && HvNAME(sv))
888         PerlIO_printf(file, "\t\"%s\"\n", HvNAME(sv));
889     else
890         PerlIO_putc(file, '\n');
891 }
892
893 void
894 Perl_do_gv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
895 {
896     Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
897     if (sv && GvNAME(sv))
898         PerlIO_printf(file, "\t\"%s\"\n", GvNAME(sv));
899     else
900         PerlIO_putc(file, '\n');
901 }
902
903 void
904 Perl_do_gvgv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
905 {
906     Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
907     if (sv && GvNAME(sv)) {
908         PerlIO_printf(file, "\t\"");
909         if (GvSTASH(sv))
910             PerlIO_printf(file, "%s\" :: \"", HvNAME(GvSTASH(sv)));
911         PerlIO_printf(file, "%s\"\n", GvNAME(sv));
912     }
913     else
914         PerlIO_putc(file, '\n');
915 }
916
917 void
918 Perl_do_sv_dump(pTHX_ I32 level, PerlIO *file, SV *sv, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
919 {
920     SV *d;
921     char *s;
922     U32 flags;
923     U32 type;
924     STRLEN n_a;
925
926     if (!sv) {
927         Perl_dump_indent(aTHX_ level, file, "SV = 0\n");
928         return;
929     }
930
931     flags = SvFLAGS(sv);
932     type = SvTYPE(sv);
933
934     d = Perl_newSVpvf(aTHX_
935                    "(0x%"UVxf") at 0x%"UVxf"\n%*s  REFCNT = %"IVdf"\n%*s  FLAGS = (",
936                    PTR2UV(SvANY(sv)), PTR2UV(sv),
937                    (int)(PL_dumpindent*level), "", (IV)SvREFCNT(sv),
938                    (int)(PL_dumpindent*level), "");
939
940     if (flags & SVs_PADBUSY)    sv_catpv(d, "PADBUSY,");
941     if (flags & SVs_PADTMP)     sv_catpv(d, "PADTMP,");
942     if (flags & SVs_PADMY)      sv_catpv(d, "PADMY,");
943     if (flags & SVs_TEMP)       sv_catpv(d, "TEMP,");
944     if (flags & SVs_OBJECT)     sv_catpv(d, "OBJECT,");
945     if (flags & SVs_GMG)        sv_catpv(d, "GMG,");
946     if (flags & SVs_SMG)        sv_catpv(d, "SMG,");
947     if (flags & SVs_RMG)        sv_catpv(d, "RMG,");
948
949     if (flags & SVf_IOK)        sv_catpv(d, "IOK,");
950     if (flags & SVf_NOK)        sv_catpv(d, "NOK,");
951     if (flags & SVf_POK)        sv_catpv(d, "POK,");
952     if (flags & SVf_ROK)  {     
953                                 sv_catpv(d, "ROK,");
954         if (SvWEAKREF(sv))      sv_catpv(d, "WEAKREF,");
955     }
956     if (flags & SVf_OOK)        sv_catpv(d, "OOK,");
957     if (flags & SVf_FAKE)       sv_catpv(d, "FAKE,");
958     if (flags & SVf_READONLY)   sv_catpv(d, "READONLY,");
959
960     if (flags & SVf_AMAGIC)     sv_catpv(d, "OVERLOAD,");
961     if (flags & SVp_IOK)        sv_catpv(d, "pIOK,");
962     if (flags & SVp_NOK)        sv_catpv(d, "pNOK,");
963     if (flags & SVp_POK)        sv_catpv(d, "pPOK,");
964     if (flags & SVp_SCREAM)     sv_catpv(d, "SCREAM,");
965
966     switch (type) {
967     case SVt_PVCV:
968     case SVt_PVFM:
969         if (CvANON(sv))         sv_catpv(d, "ANON,");
970         if (CvUNIQUE(sv))       sv_catpv(d, "UNIQUE,");
971         if (CvCLONE(sv))        sv_catpv(d, "CLONE,");
972         if (CvCLONED(sv))       sv_catpv(d, "CLONED,");
973         if (CvCONST(sv))        sv_catpv(d, "CONST,");
974         if (CvNODEBUG(sv))      sv_catpv(d, "NODEBUG,");
975         if (SvCOMPILED(sv))     sv_catpv(d, "COMPILED,");
976         if (CvLVALUE(sv))       sv_catpv(d, "LVALUE,");
977         if (CvMETHOD(sv))       sv_catpv(d, "METHOD,");
978         break;
979     case SVt_PVHV:
980         if (HvSHAREKEYS(sv))    sv_catpv(d, "SHAREKEYS,");
981         if (HvLAZYDEL(sv))      sv_catpv(d, "LAZYDEL,");
982         break;
983     case SVt_PVGV:
984         if (GvINTRO(sv))        sv_catpv(d, "INTRO,");
985         if (GvMULTI(sv))        sv_catpv(d, "MULTI,");
986         if (GvUNIQUE(sv))       sv_catpv(d, "UNIQUE,");
987         if (GvASSUMECV(sv))     sv_catpv(d, "ASSUMECV,");
988         if (GvIN_PAD(sv))       sv_catpv(d, "IN_PAD,");
989         if (flags & SVpad_OUR)  sv_catpv(d, "OUR,");
990         if (GvIMPORTED(sv)) {
991             sv_catpv(d, "IMPORT");
992             if (GvIMPORTED(sv) == GVf_IMPORTED)
993                 sv_catpv(d, "ALL,");
994             else {
995                 sv_catpv(d, "(");
996                 if (GvIMPORTED_SV(sv))  sv_catpv(d, " SV");
997                 if (GvIMPORTED_AV(sv))  sv_catpv(d, " AV");
998                 if (GvIMPORTED_HV(sv))  sv_catpv(d, " HV");
999                 if (GvIMPORTED_CV(sv))  sv_catpv(d, " CV");
1000                 sv_catpv(d, " ),");
1001             }
1002         }
1003         /* FALL THROUGH */
1004     default:
1005         if (SvEVALED(sv))       sv_catpv(d, "EVALED,");
1006         if (SvIsUV(sv))         sv_catpv(d, "IsUV,");
1007         break;
1008     case SVt_PVBM:
1009         if (SvTAIL(sv))         sv_catpv(d, "TAIL,");
1010         if (SvVALID(sv))        sv_catpv(d, "VALID,");
1011         break;
1012     case SVt_PVMG:
1013         if (flags & SVpad_TYPED)
1014                                 sv_catpv(d, "TYPED,");
1015         break;
1016     }
1017     if (SvPOK(sv) && SvUTF8(sv))
1018         sv_catpv(d, "UTF8");
1019
1020     if (*(SvEND(d) - 1) == ',')
1021         SvPVX(d)[--SvCUR(d)] = '\0';
1022     sv_catpv(d, ")");
1023     s = SvPVX(d);
1024
1025     Perl_dump_indent(aTHX_ level, file, "SV = ");
1026     switch (type) {
1027     case SVt_NULL:
1028         PerlIO_printf(file, "NULL%s\n", s);
1029         SvREFCNT_dec(d);
1030         return;
1031     case SVt_IV:
1032         PerlIO_printf(file, "IV%s\n", s);
1033         break;
1034     case SVt_NV:
1035         PerlIO_printf(file, "NV%s\n", s);
1036         break;
1037     case SVt_RV:
1038         PerlIO_printf(file, "RV%s\n", s);
1039         break;
1040     case SVt_PV:
1041         PerlIO_printf(file, "PV%s\n", s);
1042         break;
1043     case SVt_PVIV:
1044         PerlIO_printf(file, "PVIV%s\n", s);
1045         break;
1046     case SVt_PVNV:
1047         PerlIO_printf(file, "PVNV%s\n", s);
1048         break;
1049     case SVt_PVBM:
1050         PerlIO_printf(file, "PVBM%s\n", s);
1051         break;
1052     case SVt_PVMG:
1053         PerlIO_printf(file, "PVMG%s\n", s);
1054         break;
1055     case SVt_PVLV:
1056         PerlIO_printf(file, "PVLV%s\n", s);
1057         break;
1058     case SVt_PVAV:
1059         PerlIO_printf(file, "PVAV%s\n", s);
1060         break;
1061     case SVt_PVHV:
1062         PerlIO_printf(file, "PVHV%s\n", s);
1063         break;
1064     case SVt_PVCV:
1065         PerlIO_printf(file, "PVCV%s\n", s);
1066         break;
1067     case SVt_PVGV:
1068         PerlIO_printf(file, "PVGV%s\n", s);
1069         break;
1070     case SVt_PVFM:
1071         PerlIO_printf(file, "PVFM%s\n", s);
1072         break;
1073     case SVt_PVIO:
1074         PerlIO_printf(file, "PVIO%s\n", s);
1075         break;
1076     default:
1077         PerlIO_printf(file, "UNKNOWN(0x%"UVxf") %s\n", (UV)type, s);
1078         SvREFCNT_dec(d);
1079         return;
1080     }
1081     if (type >= SVt_PVIV || type == SVt_IV) {
1082         if (SvIsUV(sv))
1083             Perl_dump_indent(aTHX_ level, file, "  UV = %"UVuf, (UV)SvUVX(sv));
1084         else
1085             Perl_dump_indent(aTHX_ level, file, "  IV = %"IVdf, (IV)SvIVX(sv));
1086         if (SvOOK(sv))
1087             PerlIO_printf(file, "  (OFFSET)");
1088         PerlIO_putc(file, '\n');
1089     }
1090     if (type >= SVt_PVNV || type == SVt_NV) {
1091         STORE_NUMERIC_LOCAL_SET_STANDARD();
1092         /* %Vg doesn't work? --jhi */
1093 #ifdef USE_LONG_DOUBLE
1094         Perl_dump_indent(aTHX_ level, file, "  NV = %.*" PERL_PRIgldbl "\n", LDBL_DIG, SvNVX(sv));
1095 #else
1096         Perl_dump_indent(aTHX_ level, file, "  NV = %.*g\n", DBL_DIG, SvNVX(sv));
1097 #endif
1098         RESTORE_NUMERIC_LOCAL();
1099     }
1100     if (SvROK(sv)) {
1101         Perl_dump_indent(aTHX_ level, file, "  RV = 0x%"UVxf"\n", PTR2UV(SvRV(sv)));
1102         if (nest < maxnest)
1103             do_sv_dump(level+1, file, SvRV(sv), nest+1, maxnest, dumpops, pvlim);
1104         SvREFCNT_dec(d);
1105         return;
1106     }
1107     if (type < SVt_PV) {
1108         SvREFCNT_dec(d);
1109         return;
1110     }
1111     if (type <= SVt_PVLV) {
1112         if (SvPVX(sv)) {
1113             Perl_dump_indent(aTHX_ level, file,"  PV = 0x%"UVxf" ", PTR2UV(SvPVX(sv)));
1114             if (SvOOK(sv))
1115                 PerlIO_printf(file, "( %s . ) ", pv_display(d, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, pvlim));
1116             PerlIO_printf(file, "%s", pv_display(d, SvPVX(sv), SvCUR(sv), SvLEN(sv), pvlim));
1117             if (SvUTF8(sv)) /* the 8?  \x{....} */
1118                 PerlIO_printf(file, " [UTF8 \"%s\"]", sv_uni_display(d, sv, 8 * sv_len_utf8(sv), 0));
1119             PerlIO_printf(file, "\n");
1120             Perl_dump_indent(aTHX_ level, file, "  CUR = %"IVdf"\n", (IV)SvCUR(sv));
1121             Perl_dump_indent(aTHX_ level, file, "  LEN = %"IVdf"\n", (IV)SvLEN(sv));
1122         }
1123         else
1124             Perl_dump_indent(aTHX_ level, file, "  PV = 0\n");
1125     }
1126     if (type >= SVt_PVMG) {
1127         if (SvMAGIC(sv))
1128             do_magic_dump(level, file, SvMAGIC(sv), nest, maxnest, dumpops, pvlim);
1129         if (SvSTASH(sv))
1130             do_hv_dump(level, file, "  STASH", SvSTASH(sv));
1131     }
1132     switch (type) {
1133     case SVt_PVLV:
1134         Perl_dump_indent(aTHX_ level, file, "  TYPE = %c\n", LvTYPE(sv));
1135         Perl_dump_indent(aTHX_ level, file, "  TARGOFF = %"IVdf"\n", (IV)LvTARGOFF(sv));
1136         Perl_dump_indent(aTHX_ level, file, "  TARGLEN = %"IVdf"\n", (IV)LvTARGLEN(sv));
1137         Perl_dump_indent(aTHX_ level, file, "  TARG = 0x%"UVxf"\n", PTR2UV(LvTARG(sv)));
1138         /* XXX level+1 ??? */
1139         do_sv_dump(level, file, LvTARG(sv), nest+1, maxnest, dumpops, pvlim);
1140         break;
1141     case SVt_PVAV:
1142         Perl_dump_indent(aTHX_ level, file, "  ARRAY = 0x%"UVxf, PTR2UV(AvARRAY(sv)));
1143         if (AvARRAY(sv) != AvALLOC(sv)) {
1144             PerlIO_printf(file, " (offset=%"IVdf")\n", (IV)(AvARRAY(sv) - AvALLOC(sv)));
1145             Perl_dump_indent(aTHX_ level, file, "  ALLOC = 0x%"UVxf"\n", PTR2UV(AvALLOC(sv)));
1146         }
1147         else
1148             PerlIO_putc(file, '\n');
1149         Perl_dump_indent(aTHX_ level, file, "  FILL = %"IVdf"\n", (IV)AvFILLp(sv));
1150         Perl_dump_indent(aTHX_ level, file, "  MAX = %"IVdf"\n", (IV)AvMAX(sv));
1151         Perl_dump_indent(aTHX_ level, file, "  ARYLEN = 0x%"UVxf"\n", PTR2UV(AvARYLEN(sv)));
1152         flags = AvFLAGS(sv);
1153         sv_setpv(d, "");
1154         if (flags & AVf_REAL)   sv_catpv(d, ",REAL");
1155         if (flags & AVf_REIFY)  sv_catpv(d, ",REIFY");
1156         if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
1157         Perl_dump_indent(aTHX_ level, file, "  FLAGS = (%s)\n", SvCUR(d) ? SvPVX(d) + 1 : "");
1158         if (nest < maxnest && av_len((AV*)sv) >= 0) {
1159             int count;
1160             for (count = 0; count <=  av_len((AV*)sv) && count < maxnest; count++) {
1161                 SV** elt = av_fetch((AV*)sv,count,0);
1162
1163                 Perl_dump_indent(aTHX_ level + 1, file, "Elt No. %"IVdf"\n", (IV)count);
1164                 if (elt)
1165                     do_sv_dump(level+1, file, *elt, nest+1, maxnest, dumpops, pvlim);
1166             }
1167         }
1168         break;
1169     case SVt_PVHV:
1170         Perl_dump_indent(aTHX_ level, file, "  ARRAY = 0x%"UVxf, PTR2UV(HvARRAY(sv)));
1171         if (HvARRAY(sv) && HvKEYS(sv)) {
1172             /* Show distribution of HEs in the ARRAY */
1173             int freq[200];
1174 #define FREQ_MAX (sizeof freq / sizeof freq[0] - 1)
1175             int i;
1176             int max = 0;
1177             U32 pow2 = 2, keys = HvKEYS(sv);
1178             NV theoret, sum = 0;
1179
1180             PerlIO_printf(file, "  (");
1181             Zero(freq, FREQ_MAX + 1, int);
1182             for (i = 0; i <= HvMAX(sv); i++) {
1183                 HE* h; int count = 0;
1184                 for (h = HvARRAY(sv)[i]; h; h = HeNEXT(h))
1185                     count++;
1186                 if (count > FREQ_MAX)
1187                     count = FREQ_MAX;
1188                 freq[count]++;
1189                 if (max < count)
1190                     max = count;
1191             }
1192             for (i = 0; i <= max; i++) {
1193                 if (freq[i]) {
1194                     PerlIO_printf(file, "%d%s:%d", i,
1195                                   (i == FREQ_MAX) ? "+" : "",
1196                                   freq[i]);
1197                     if (i != max)
1198                         PerlIO_printf(file, ", ");
1199                 }
1200             }
1201             PerlIO_putc(file, ')');
1202             /* The "quality" of a hash is defined as the total number of
1203                comparisons needed to access every element once, relative
1204                to the expected number needed for a random hash.
1205
1206                The total number of comparisons is equal to the sum of
1207                the squares of the number of entries in each bucket.
1208                For a random hash of n keys into k buckets, the expected
1209                value is
1210                                 n + n(n-1)/2k
1211             */
1212
1213             for (i = max; i > 0; i--) { /* Precision: count down. */
1214                 sum += freq[i] * i * i;
1215             }
1216             while ((keys = keys >> 1))
1217                 pow2 = pow2 << 1;
1218             theoret = HvKEYS(sv);
1219             theoret += theoret * (theoret-1)/pow2;
1220             PerlIO_putc(file, '\n');
1221             Perl_dump_indent(aTHX_ level, file, "  hash quality = %.1"NVff"%%", theoret/sum*100);
1222         }
1223         PerlIO_putc(file, '\n');
1224         Perl_dump_indent(aTHX_ level, file, "  KEYS = %"IVdf"\n", (IV)HvKEYS(sv));
1225         Perl_dump_indent(aTHX_ level, file, "  FILL = %"IVdf"\n", (IV)HvFILL(sv));
1226         Perl_dump_indent(aTHX_ level, file, "  MAX = %"IVdf"\n", (IV)HvMAX(sv));
1227         Perl_dump_indent(aTHX_ level, file, "  RITER = %"IVdf"\n", (IV)HvRITER(sv));
1228         Perl_dump_indent(aTHX_ level, file, "  EITER = 0x%"UVxf"\n", PTR2UV(HvEITER(sv)));
1229         if (HvPMROOT(sv))
1230             Perl_dump_indent(aTHX_ level, file, "  PMROOT = 0x%"UVxf"\n", PTR2UV(HvPMROOT(sv)));
1231         if (HvNAME(sv))
1232             Perl_dump_indent(aTHX_ level, file, "  NAME = \"%s\"\n", HvNAME(sv));
1233         if (nest < maxnest && !HvEITER(sv)) { /* Try to preserve iterator */
1234             HE *he;
1235             HV *hv = (HV*)sv;
1236             int count = maxnest - nest;
1237
1238             hv_iterinit(hv);
1239             while ((he = hv_iternext(hv)) && count--) {
1240                 SV *elt, *keysv;
1241                 char *keypv;
1242                 STRLEN len;
1243                 U32 hash = HeHASH(he);
1244
1245                 keysv = hv_iterkeysv(he);
1246                 keypv = SvPV(keysv, len);
1247                 elt = hv_iterval(hv, he);
1248                 Perl_dump_indent(aTHX_ level+1, file, "Elt %s ", pv_display(d, keypv, len, 0, pvlim));
1249                 if (SvUTF8(keysv))
1250                     PerlIO_printf(file, "[UTF8 \"%s\"] ", sv_uni_display(d, keysv, 8 * sv_len_utf8(keysv), 0));
1251                 PerlIO_printf(file, "HASH = 0x%"UVxf"\n", (UV)hash);
1252                 do_sv_dump(level+1, file, elt, nest+1, maxnest, dumpops, pvlim);
1253             }
1254             hv_iterinit(hv);            /* Return to status quo */
1255         }
1256         break;
1257     case SVt_PVCV:
1258         if (SvPOK(sv))
1259             Perl_dump_indent(aTHX_ level, file, "  PROTOTYPE = \"%s\"\n", SvPV(sv,n_a));
1260         /* FALL THROUGH */
1261     case SVt_PVFM:
1262         do_hv_dump(level, file, "  COMP_STASH", CvSTASH(sv));
1263         if (CvSTART(sv))
1264             Perl_dump_indent(aTHX_ level, file, "  START = 0x%"UVxf" ===> %"IVdf"\n", PTR2UV(CvSTART(sv)), (IV)CvSTART(sv)->op_seq);
1265         Perl_dump_indent(aTHX_ level, file, "  ROOT = 0x%"UVxf"\n", PTR2UV(CvROOT(sv)));
1266         if (CvROOT(sv) && dumpops)
1267             do_op_dump(level+1, file, CvROOT(sv));
1268         Perl_dump_indent(aTHX_ level, file, "  XSUB = 0x%"UVxf"\n", PTR2UV(CvXSUB(sv)));
1269         Perl_dump_indent(aTHX_ level, file, "  XSUBANY = %"IVdf"\n", (IV)CvXSUBANY(sv).any_i32);
1270         do_gvgv_dump(level, file, "  GVGV::GV", CvGV(sv));
1271         Perl_dump_indent(aTHX_ level, file, "  FILE = \"%s\"\n", CvFILE(sv));
1272         Perl_dump_indent(aTHX_ level, file, "  DEPTH = %"IVdf"\n", (IV)CvDEPTH(sv));
1273 #ifdef USE_5005THREADS
1274         Perl_dump_indent(aTHX_ level, file, "  MUTEXP = 0x%"UVxf"\n", PTR2UV(CvMUTEXP(sv)));
1275         Perl_dump_indent(aTHX_ level, file, "  OWNER = 0x%"UVxf"\n",  PTR2UV(CvOWNER(sv)));
1276 #endif /* USE_5005THREADS */
1277         Perl_dump_indent(aTHX_ level, file, "  FLAGS = 0x%"UVxf"\n", (UV)CvFLAGS(sv));
1278         if (type == SVt_PVFM)
1279             Perl_dump_indent(aTHX_ level, file, "  LINES = %"IVdf"\n", (IV)FmLINES(sv));
1280         Perl_dump_indent(aTHX_ level, file, "  PADLIST = 0x%"UVxf"\n", PTR2UV(CvPADLIST(sv)));
1281         if (nest < maxnest && CvPADLIST(sv)) {
1282             AV* padlist = CvPADLIST(sv);
1283             AV* pad_name = (AV*)*av_fetch(padlist, 0, FALSE);
1284             AV* pad = (AV*)*av_fetch(padlist, 1, FALSE);
1285             SV** pname = AvARRAY(pad_name);
1286             SV** ppad = AvARRAY(pad);
1287             I32 ix;
1288
1289             for (ix = 1; ix <= AvFILL(pad_name); ix++) {
1290                 if (SvPOK(pname[ix]))
1291                     Perl_dump_indent(aTHX_ level,
1292                                 /* %5d below is enough whitespace. */
1293                                 file,
1294                                 "%5d. 0x%"UVxf" (%s\"%s\" %"IVdf"-%"IVdf")\n",
1295                                 (int)ix, PTR2UV(ppad[ix]),
1296                                 SvFAKE(pname[ix]) ? "FAKE " : "",
1297                                 SvPVX(pname[ix]),
1298                                 (IV)SvNVX(pname[ix]),
1299                                 (IV)SvIVX(pname[ix]));
1300             }
1301         }
1302         {
1303             CV *outside = CvOUTSIDE(sv);
1304             Perl_dump_indent(aTHX_ level, file, "  OUTSIDE = 0x%"UVxf" (%s)\n",
1305                         PTR2UV(outside),
1306                         (!outside ? "null"
1307                          : CvANON(outside) ? "ANON"
1308                          : (outside == PL_main_cv) ? "MAIN"
1309                          : CvUNIQUE(outside) ? "UNIQUE"
1310                          : CvGV(outside) ? GvNAME(CvGV(outside)) : "UNDEFINED"));
1311         }
1312         if (nest < maxnest && (CvCLONE(sv) || CvCLONED(sv)))
1313             do_sv_dump(level+1, file, (SV*)CvOUTSIDE(sv), nest+1, maxnest, dumpops, pvlim);
1314         break;
1315     case SVt_PVGV:
1316         Perl_dump_indent(aTHX_ level, file, "  NAME = \"%s\"\n", GvNAME(sv));
1317         Perl_dump_indent(aTHX_ level, file, "  NAMELEN = %"IVdf"\n", (IV)GvNAMELEN(sv));
1318         do_hv_dump (level, file, "  GvSTASH", GvSTASH(sv));
1319         Perl_dump_indent(aTHX_ level, file, "  GP = 0x%"UVxf"\n", PTR2UV(GvGP(sv)));
1320         if (!GvGP(sv))
1321             break;
1322         Perl_dump_indent(aTHX_ level, file, "    SV = 0x%"UVxf"\n", PTR2UV(GvSV(sv)));
1323         Perl_dump_indent(aTHX_ level, file, "    REFCNT = %"IVdf"\n", (IV)GvREFCNT(sv));
1324         Perl_dump_indent(aTHX_ level, file, "    IO = 0x%"UVxf"\n", PTR2UV(GvIOp(sv)));
1325         Perl_dump_indent(aTHX_ level, file, "    FORM = 0x%"UVxf"  \n", PTR2UV(GvFORM(sv)));
1326         Perl_dump_indent(aTHX_ level, file, "    AV = 0x%"UVxf"\n", PTR2UV(GvAV(sv)));
1327         Perl_dump_indent(aTHX_ level, file, "    HV = 0x%"UVxf"\n", PTR2UV(GvHV(sv)));
1328         Perl_dump_indent(aTHX_ level, file, "    CV = 0x%"UVxf"\n", PTR2UV(GvCV(sv)));
1329         Perl_dump_indent(aTHX_ level, file, "    CVGEN = 0x%"UVxf"\n", (UV)GvCVGEN(sv));
1330         Perl_dump_indent(aTHX_ level, file, "    GPFLAGS = 0x%"UVxf"\n", (UV)GvGPFLAGS(sv));
1331         Perl_dump_indent(aTHX_ level, file, "    LINE = %"IVdf"\n", (IV)GvLINE(sv));
1332         Perl_dump_indent(aTHX_ level, file, "    FILE = \"%s\"\n", GvFILE(sv));
1333         Perl_dump_indent(aTHX_ level, file, "    FLAGS = 0x%"UVxf"\n", (UV)GvFLAGS(sv));
1334         do_gv_dump (level, file, "    EGV", GvEGV(sv));
1335         break;
1336     case SVt_PVIO:
1337         Perl_dump_indent(aTHX_ level, file, "  IFP = 0x%"UVxf"\n", PTR2UV(IoIFP(sv)));
1338         Perl_dump_indent(aTHX_ level, file, "  OFP = 0x%"UVxf"\n", PTR2UV(IoOFP(sv)));
1339         Perl_dump_indent(aTHX_ level, file, "  DIRP = 0x%"UVxf"\n", PTR2UV(IoDIRP(sv)));
1340         Perl_dump_indent(aTHX_ level, file, "  LINES = %"IVdf"\n", (IV)IoLINES(sv));
1341         Perl_dump_indent(aTHX_ level, file, "  PAGE = %"IVdf"\n", (IV)IoPAGE(sv));
1342         Perl_dump_indent(aTHX_ level, file, "  PAGE_LEN = %"IVdf"\n", (IV)IoPAGE_LEN(sv));
1343         Perl_dump_indent(aTHX_ level, file, "  LINES_LEFT = %"IVdf"\n", (IV)IoLINES_LEFT(sv));
1344         if (IoTOP_NAME(sv))
1345             Perl_dump_indent(aTHX_ level, file, "  TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
1346         do_gv_dump (level, file, "  TOP_GV", IoTOP_GV(sv));
1347         if (IoFMT_NAME(sv))
1348             Perl_dump_indent(aTHX_ level, file, "  FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
1349         do_gv_dump (level, file, "  FMT_GV", IoFMT_GV(sv));
1350         if (IoBOTTOM_NAME(sv))
1351             Perl_dump_indent(aTHX_ level, file, "  BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
1352         do_gv_dump (level, file, "  BOTTOM_GV", IoBOTTOM_GV(sv));
1353         Perl_dump_indent(aTHX_ level, file, "  SUBPROCESS = %"IVdf"\n", (IV)IoSUBPROCESS(sv));
1354         if (isPRINT(IoTYPE(sv)))
1355             Perl_dump_indent(aTHX_ level, file, "  TYPE = '%c'\n", IoTYPE(sv));
1356         else
1357             Perl_dump_indent(aTHX_ level, file, "  TYPE = '\\%o'\n", IoTYPE(sv));
1358         Perl_dump_indent(aTHX_ level, file, "  FLAGS = 0x%"UVxf"\n", (UV)IoFLAGS(sv));
1359         break;
1360     }
1361     SvREFCNT_dec(d);
1362 }
1363
1364 void
1365 Perl_sv_dump(pTHX_ SV *sv)
1366 {
1367     do_sv_dump(0, Perl_debug_log, sv, 0, 0, 0, 0);
1368 }
1369
1370 int
1371 Perl_runops_debug(pTHX)
1372 {
1373     if (!PL_op) {
1374         if (ckWARN_d(WARN_DEBUGGING))
1375             Perl_warner(aTHX_ WARN_DEBUGGING, "NULL OP IN RUN");
1376         return 0;
1377     }
1378
1379     do {
1380         PERL_ASYNC_CHECK();
1381         if (PL_debug) {
1382             if (PL_watchaddr != 0 && *PL_watchaddr != PL_watchok)
1383                 PerlIO_printf(Perl_debug_log,
1384                               "WARNING: %"UVxf" changed from %"UVxf" to %"UVxf"\n",
1385                               PTR2UV(PL_watchaddr), PTR2UV(PL_watchok),
1386                               PTR2UV(*PL_watchaddr));
1387             if (DEBUG_s_TEST_) debstack();
1388             if (DEBUG_t_TEST_) debop(PL_op);
1389             if (DEBUG_P_TEST_) debprof(PL_op);
1390         }
1391     } while ((PL_op = CALL_FPTR(PL_op->op_ppaddr)(aTHX)));
1392
1393     TAINT_NOT;
1394     return 0;
1395 }
1396
1397 I32
1398 Perl_debop(pTHX_ OP *o)
1399 {
1400     AV *padlist, *comppad;
1401     CV *cv;
1402     SV *sv;
1403     STRLEN n_a;
1404     Perl_deb(aTHX_ "%s", OP_NAME(o));
1405     switch (o->op_type) {
1406     case OP_CONST:
1407         PerlIO_printf(Perl_debug_log, "(%s)", SvPEEK(cSVOPo_sv));
1408         break;
1409     case OP_GVSV:
1410     case OP_GV:
1411         if (cGVOPo_gv) {
1412             sv = NEWSV(0,0);
1413             gv_fullname3(sv, cGVOPo_gv, Nullch);
1414             PerlIO_printf(Perl_debug_log, "(%s)", SvPV(sv, n_a));
1415             SvREFCNT_dec(sv);
1416         }
1417         else
1418             PerlIO_printf(Perl_debug_log, "(NULL)");
1419         break;
1420     case OP_PADSV:
1421     case OP_PADAV:
1422     case OP_PADHV:
1423         /* print the lexical's name */
1424         cv = deb_curcv(cxstack_ix);
1425         if (cv) {
1426             padlist = CvPADLIST(cv);
1427             comppad = (AV*)(*av_fetch(padlist, 0, FALSE));
1428             sv = *av_fetch(comppad, o->op_targ, FALSE);
1429         } else
1430             sv = Nullsv;
1431         if (sv)
1432            PerlIO_printf(Perl_debug_log, "(%s)", SvPV_nolen(sv));
1433         else
1434            PerlIO_printf(Perl_debug_log, "[%"UVuf"]", (UV)o->op_targ);
1435         break;
1436     default:
1437         break;
1438     }
1439     PerlIO_printf(Perl_debug_log, "\n");
1440     return 0;
1441 }
1442
1443 STATIC CV*
1444 S_deb_curcv(pTHX_ I32 ix)
1445 {
1446     PERL_CONTEXT *cx = &cxstack[ix];
1447     if (CxTYPE(cx) == CXt_SUB || CxTYPE(cx) == CXt_FORMAT)
1448         return cx->blk_sub.cv;
1449     else if (CxTYPE(cx) == CXt_EVAL && !CxTRYBLOCK(cx))
1450         return PL_compcv;
1451     else if (ix == 0 && PL_curstackinfo->si_type == PERLSI_MAIN)
1452         return PL_main_cv;
1453     else if (ix <= 0)
1454         return Nullcv;
1455     else
1456         return deb_curcv(ix - 1);
1457 }
1458
1459 void
1460 Perl_watch(pTHX_ char **addr)
1461 {
1462     PL_watchaddr = addr;
1463     PL_watchok = *addr;
1464     PerlIO_printf(Perl_debug_log, "WATCHING, %"UVxf" is currently %"UVxf"\n",
1465         PTR2UV(PL_watchaddr), PTR2UV(PL_watchok));
1466 }
1467
1468 STATIC void
1469 S_debprof(pTHX_ OP *o)
1470 {
1471     if (!PL_profiledata)
1472         Newz(000, PL_profiledata, MAXO, U32);
1473     ++PL_profiledata[o->op_type];
1474 }
1475
1476 void
1477 Perl_debprofdump(pTHX)
1478 {
1479     unsigned i;
1480     if (!PL_profiledata)
1481         return;
1482     for (i = 0; i < MAXO; i++) {
1483         if (PL_profiledata[i])
1484             PerlIO_printf(Perl_debug_log,
1485                           "%5lu %s\n", (unsigned long)PL_profiledata[i],
1486                                        PL_op_name[i]);
1487     }
1488 }