This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
In change 24266 I failed to actually change anything. Sigh.
[perl5.git] / dump.c
CommitLineData
a0d0e21e 1/* dump.c
a687059c 2 *
4bb101f2 3 * Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
1d325971 4 * 2000, 2001, 2002, 2003, 2004, 2005, by Larry Wall and others
a687059c 5 *
6e21c824
LW
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.
8d063cd8 8 *
a0d0e21e
LW
9 */
10
11/*
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.'"
8d063cd8
LW
14 */
15
166f8a29 16/* This file contains utility routines to dump the contents of SV and OP
61296642 17 * structures, as used by command-line options like -Dt and -Dx, and
166f8a29
DM
18 * by Devel::Peek.
19 *
20 * It also holds the debugging version of the runops function.
21 */
22
8d063cd8 23#include "EXTERN.h"
864dbfa3 24#define PERL_IN_DUMP_C
8d063cd8 25#include "perl.h"
f722798b 26#include "regcomp.h"
8d063cd8 27
2814eb74
PJ
28static HV *Sequence;
29
3967c732 30void
864dbfa3 31Perl_dump_indent(pTHX_ I32 level, PerlIO *file, const char* pat, ...)
3967c732 32{
3967c732 33 va_list args;
3967c732 34 va_start(args, pat);
c5be433b 35 dump_vindent(level, file, pat, &args);
3967c732
JD
36 va_end(args);
37}
8adcabd8
LW
38
39void
c5be433b
GS
40Perl_dump_vindent(pTHX_ I32 level, PerlIO *file, const char* pat, va_list *args)
41{
c8db6e60 42 PerlIO_printf(file, "%*s", (int)(level*PL_dumpindent), "");
c5be433b
GS
43 PerlIO_vprintf(file, pat, *args);
44}
45
46void
864dbfa3 47Perl_dump_all(pTHX)
79072805 48{
760ac839 49 PerlIO_setlinebuf(Perl_debug_log);
3280af22 50 if (PL_main_root)
3967c732 51 op_dump(PL_main_root);
3280af22 52 dump_packsubs(PL_defstash);
463ee0b2
LW
53}
54
55void
e1ec3a88 56Perl_dump_packsubs(pTHX_ const HV *stash)
463ee0b2 57{
a0d0e21e 58 I32 i;
463ee0b2 59
8990e307
LW
60 if (!HvARRAY(stash))
61 return;
a0d0e21e 62 for (i = 0; i <= (I32) HvMAX(stash); i++) {
e1ec3a88 63 const HE *entry;
4db58590 64 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
e1ec3a88
AL
65 const GV *gv = (GV*)HeVAL(entry);
66 const HV *hv;
e29cdcb3
GS
67 if (SvTYPE(gv) != SVt_PVGV || !GvGP(gv))
68 continue;
8ebc5c01 69 if (GvCVu(gv))
463ee0b2 70 dump_sub(gv);
85e6fe83
LW
71 if (GvFORM(gv))
72 dump_form(gv);
6676db26
AMS
73 if (HeKEY(entry)[HeKLEN(entry)-1] == ':'
74 && (hv = GvHV(gv)) && hv != PL_defstash)
463ee0b2
LW
75 dump_packsubs(hv); /* nested package */
76 }
79072805
LW
77 }
78}
79
80void
e1ec3a88 81Perl_dump_sub(pTHX_ const GV *gv)
a687059c 82{
8990e307 83 SV *sv = sv_newmortal();
85e6fe83 84
f6aff53a 85 gv_fullname3(sv, gv, Nullch);
05671074 86 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nSUB %s = ", SvPVX(sv));
a0d0e21e 87 if (CvXSUB(GvCV(gv)))
91f3b821
GS
88 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "(xsub 0x%"UVxf" %d)\n",
89 PTR2UV(CvXSUB(GvCV(gv))),
894356b3 90 (int)CvXSUBANY(GvCV(gv)).any_i32);
85e6fe83 91 else if (CvROOT(GvCV(gv)))
3967c732 92 op_dump(CvROOT(GvCV(gv)));
85e6fe83 93 else
cea2e8a9 94 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
85e6fe83
LW
95}
96
97void
e1ec3a88 98Perl_dump_form(pTHX_ const GV *gv)
85e6fe83
LW
99{
100 SV *sv = sv_newmortal();
101
f6aff53a 102 gv_fullname3(sv, gv, Nullch);
05671074 103 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nFORMAT %s = ", SvPVX(sv));
85e6fe83 104 if (CvROOT(GvFORM(gv)))
3967c732 105 op_dump(CvROOT(GvFORM(gv)));
85e6fe83 106 else
cea2e8a9 107 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
a687059c
LW
108}
109
8adcabd8 110void
864dbfa3 111Perl_dump_eval(pTHX)
8d063cd8 112{
3967c732
JD
113 op_dump(PL_eval_root);
114}
115
116char *
e1ec3a88 117Perl_pv_display(pTHX_ SV *dsv, const char *pv, STRLEN cur, STRLEN len, STRLEN pvlim)
3967c732 118{
e1ec3a88
AL
119 const bool nul_terminated = len > cur && pv[cur] == '\0';
120 bool truncated = 0;
3967c732 121
e6abe6d8 122 sv_setpvn(dsv, "\"", 1);
3967c732 123 for (; cur--; pv++) {
e6abe6d8 124 if (pvlim && SvCUR(dsv) >= pvlim) {
e1ec3a88 125 truncated = 1;
3967c732
JD
126 break;
127 }
46316b0a
DM
128 switch (*pv) {
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;
135 default:
136 if (isPRINT(*pv))
137 sv_catpvn(dsv, pv, 1);
138 else if (cur && isDIGIT(*(pv+1)))
e6abe6d8 139 Perl_sv_catpvf(aTHX_ dsv, "\\%03o", (U8)*pv);
3967c732 140 else
e6abe6d8 141 Perl_sv_catpvf(aTHX_ dsv, "\\%o", (U8)*pv);
3967c732
JD
142 }
143 }
e6abe6d8 144 sv_catpvn(dsv, "\"", 1);
3967c732 145 if (truncated)
e6abe6d8 146 sv_catpvn(dsv, "...", 3);
3967c732 147 if (nul_terminated)
e6abe6d8 148 sv_catpvn(dsv, "\\0", 2);
3967c732 149
e6abe6d8
JH
150 return SvPVX(dsv);
151}
152
153char *
864dbfa3 154Perl_sv_peek(pTHX_ SV *sv)
3967c732
JD
155{
156 SV *t = sv_newmortal();
2d8e6c8d 157 STRLEN n_a;
3967c732
JD
158 int unref = 0;
159
160 sv_setpvn(t, "", 0);
161 retry:
162 if (!sv) {
163 sv_catpv(t, "VOID");
164 goto finish;
165 }
166 else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
167 sv_catpv(t, "WILD");
168 goto finish;
169 }
7996736c 170 else if (sv == &PL_sv_undef || sv == &PL_sv_no || sv == &PL_sv_yes || sv == &PL_sv_placeholder) {
3967c732
JD
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)) &&
175 SvREADONLY(sv))
176 goto finish;
177 }
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|
183 SVp_POK|SVp_NOK)) &&
184 SvCUR(sv) == 0 &&
185 SvNVX(sv) == 0.0)
186 goto finish;
187 }
7996736c 188 else if (sv == &PL_sv_yes) {
3967c732
JD
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|
193 SVp_POK|SVp_NOK)) &&
194 SvCUR(sv) == 1 &&
195 SvPVX(sv) && *SvPVX(sv) == '1' &&
196 SvNVX(sv) == 1.0)
197 goto finish;
7996736c
MHM
198 }
199 else {
200 sv_catpv(t, "SV_PLACEHOLDER");
201 if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
202 SVs_GMG|SVs_SMG|SVs_RMG)) &&
203 SvREADONLY(sv))
204 goto finish;
3967c732
JD
205 }
206 sv_catpv(t, ":");
207 }
208 else if (SvREFCNT(sv) == 0) {
209 sv_catpv(t, "(");
210 unref++;
211 }
a3b4c9c6
DM
212 else if (DEBUG_R_TEST_) {
213 int is_tmp = 0;
214 I32 ix;
215 /* is this SV on the tmps stack? */
216 for (ix=PL_tmps_ix; ix>=0; ix--) {
217 if (PL_tmps_stack[ix] == sv) {
218 is_tmp = 1;
219 break;
220 }
221 }
222 if (SvREFCNT(sv) > 1)
223 Perl_sv_catpvf(aTHX_ t, "<%"UVuf"%s>", (UV)SvREFCNT(sv),
224 is_tmp ? "T" : "");
225 else if (is_tmp)
226 sv_catpv(t, "<T>");
04932ac8
DM
227 }
228
3967c732
JD
229 if (SvROK(sv)) {
230 sv_catpv(t, "\\");
231 if (SvCUR(t) + unref > 10) {
b162af07 232 SvCUR_set(t, unref + 3);
3967c732
JD
233 *SvEND(t) = '\0';
234 sv_catpv(t, "...");
235 goto finish;
236 }
237 sv = (SV*)SvRV(sv);
238 goto retry;
239 }
240 switch (SvTYPE(sv)) {
241 default:
242 sv_catpv(t, "FREED");
243 goto finish;
244
245 case SVt_NULL:
246 sv_catpv(t, "UNDEF");
247 goto finish;
248 case SVt_IV:
249 sv_catpv(t, "IV");
250 break;
251 case SVt_NV:
252 sv_catpv(t, "NV");
253 break;
254 case SVt_RV:
255 sv_catpv(t, "RV");
256 break;
257 case SVt_PV:
258 sv_catpv(t, "PV");
259 break;
260 case SVt_PVIV:
261 sv_catpv(t, "PVIV");
262 break;
263 case SVt_PVNV:
264 sv_catpv(t, "PVNV");
265 break;
266 case SVt_PVMG:
267 sv_catpv(t, "PVMG");
268 break;
269 case SVt_PVLV:
270 sv_catpv(t, "PVLV");
271 break;
272 case SVt_PVAV:
273 sv_catpv(t, "AV");
274 break;
275 case SVt_PVHV:
276 sv_catpv(t, "HV");
277 break;
278 case SVt_PVCV:
279 if (CvGV(sv))
cea2e8a9 280 Perl_sv_catpvf(aTHX_ t, "CV(%s)", GvNAME(CvGV(sv)));
3967c732
JD
281 else
282 sv_catpv(t, "CV()");
283 goto finish;
284 case SVt_PVGV:
285 sv_catpv(t, "GV");
286 break;
287 case SVt_PVBM:
288 sv_catpv(t, "BM");
289 break;
290 case SVt_PVFM:
291 sv_catpv(t, "FM");
292 break;
293 case SVt_PVIO:
294 sv_catpv(t, "IO");
295 break;
296 }
297
298 if (SvPOKp(sv)) {
299 if (!SvPVX(sv))
300 sv_catpv(t, "(null)");
301 else {
79cb57f6 302 SV *tmp = newSVpvn("", 0);
3967c732
JD
303 sv_catpv(t, "(");
304 if (SvOOK(sv))
cea2e8a9
GS
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));
32639b87 307 if (SvUTF8(sv))
b2ff9928 308 Perl_sv_catpvf(aTHX_ t, " [UTF8 \"%s\"]",
c728cb41
JH
309 sv_uni_display(tmp, sv, 8 * sv_len_utf8(sv),
310 UNI_DISPLAY_QQ));
3967c732
JD
311 SvREFCNT_dec(tmp);
312 }
313 }
314 else if (SvNOKp(sv)) {
e54dc35b 315 STORE_NUMERIC_LOCAL_SET_STANDARD();
1779d84d 316 Perl_sv_catpvf(aTHX_ t, "(%"NVgf")",SvNVX(sv));
e54dc35b 317 RESTORE_NUMERIC_LOCAL();
3967c732 318 }
57def98f 319 else if (SvIOKp(sv)) {
cf2093f6 320 if (SvIsUV(sv))
57def98f 321 Perl_sv_catpvf(aTHX_ t, "(%"UVuf")", (UV)SvUVX(sv));
cf2093f6 322 else
57def98f 323 Perl_sv_catpvf(aTHX_ t, "(%"IVdf")", (IV)SvIVX(sv));
25da4f38 324 }
3967c732
JD
325 else
326 sv_catpv(t, "()");
2ef28da1 327
3967c732
JD
328 finish:
329 if (unref) {
330 while (unref--)
331 sv_catpv(t, ")");
332 }
2d8e6c8d 333 return SvPV(t, n_a);
3967c732
JD
334}
335
336void
6867be6d 337Perl_do_pmop_dump(pTHX_ I32 level, PerlIO *file, const PMOP *pm)
3967c732
JD
338{
339 char ch;
340
341 if (!pm) {
cea2e8a9 342 Perl_dump_indent(aTHX_ level, file, "{}\n");
3967c732
JD
343 return;
344 }
cea2e8a9 345 Perl_dump_indent(aTHX_ level, file, "{\n");
3967c732
JD
346 level++;
347 if (pm->op_pmflags & PMf_ONCE)
348 ch = '?';
349 else
350 ch = '/';
aaa362c4 351 if (PM_GETRE(pm))
cea2e8a9 352 Perl_dump_indent(aTHX_ level, file, "PMf_PRE %c%s%c%s\n",
aaa362c4 353 ch, PM_GETRE(pm)->precomp, ch,
3967c732
JD
354 (pm->op_private & OPpRUNTIME) ? " (RUNTIME)" : "");
355 else
cea2e8a9 356 Perl_dump_indent(aTHX_ level, file, "PMf_PRE (RUNTIME)\n");
3967c732 357 if (pm->op_type != OP_PUSHRE && pm->op_pmreplroot) {
cea2e8a9 358 Perl_dump_indent(aTHX_ level, file, "PMf_REPL = ");
3967c732
JD
359 op_dump(pm->op_pmreplroot);
360 }
aaa362c4 361 if (pm->op_pmflags || (PM_GETRE(pm) && PM_GETRE(pm)->check_substr)) {
79cb57f6 362 SV *tmpsv = newSVpvn("", 0);
3967c732
JD
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");
aaa362c4
RS
369 if (PM_GETRE(pm) && PM_GETRE(pm)->check_substr
370 && !(PM_GETRE(pm)->reganch & ROPT_NOSCAN))
3967c732 371 sv_catpv(tmpsv, ",SCANFIRST");
aaa362c4
RS
372 if (PM_GETRE(pm) && PM_GETRE(pm)->check_substr
373 && PM_GETRE(pm)->reganch & ROPT_CHECK_ALL)
3967c732
JD
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");
cea2e8a9 389 Perl_dump_indent(aTHX_ level, file, "PMFLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
3967c732
JD
390 SvREFCNT_dec(tmpsv);
391 }
392
cea2e8a9 393 Perl_dump_indent(aTHX_ level-1, file, "}\n");
3967c732
JD
394}
395
396void
864dbfa3 397Perl_pmop_dump(pTHX_ PMOP *pm)
3967c732
JD
398{
399 do_pmop_dump(0, Perl_debug_log, pm);
79072805
LW
400}
401
2814eb74
PJ
402/* An op sequencer. We visit the ops in the order they're to execute. */
403
404STATIC void
6867be6d 405sequence(pTHX_ register const OP *o)
2814eb74
PJ
406{
407 SV *op;
408 char *key;
409 STRLEN len;
410 static UV seq;
6867be6d
AL
411 const OP *oldop = 0;
412 OP *l;
2814eb74
PJ
413
414 if (!Sequence)
415 Sequence = newHV();
416
417 if (!o)
418 return;
419
c0fd1b42 420 op = newSVuv(PTR2UV(o));
2814eb74
PJ
421 key = SvPV(op, len);
422 if (hv_exists(Sequence, key, len))
423 return;
424
425 for (; o; o = o->op_next) {
c0fd1b42 426 op = newSVuv(PTR2UV(o));
2814eb74
PJ
427 key = SvPV(op, len);
428 if (hv_exists(Sequence, key, len))
429 break;
430
431 switch (o->op_type) {
432 case OP_STUB:
433 if ((o->op_flags & OPf_WANT) != OPf_WANT_LIST) {
434 hv_store(Sequence, key, len, newSVuv(++seq), 0);
435 break;
436 }
437 goto nothin;
438 case OP_NULL:
439 if (oldop && o->op_next)
440 continue;
441 break;
442 case OP_SCALAR:
443 case OP_LINESEQ:
444 case OP_SCOPE:
445 nothin:
446 if (oldop && o->op_next)
447 continue;
448 hv_store(Sequence, key, len, newSVuv(++seq), 0);
449 break;
450
451 case OP_MAPWHILE:
452 case OP_GREPWHILE:
453 case OP_AND:
454 case OP_OR:
455 case OP_DOR:
456 case OP_ANDASSIGN:
457 case OP_ORASSIGN:
458 case OP_DORASSIGN:
459 case OP_COND_EXPR:
460 case OP_RANGE:
461 hv_store(Sequence, key, len, newSVuv(++seq), 0);
5411ce9f 462 for (l = cLOGOPo->op_other; l && l->op_type == OP_NULL; l = l->op_next)
2814eb74
PJ
463 ;
464 sequence(aTHX_ l);
465 break;
466
467 case OP_ENTERLOOP:
468 case OP_ENTERITER:
469 hv_store(Sequence, key, len, newSVuv(++seq), 0);
5411ce9f 470 for (l = cLOOPo->op_redoop; l && l->op_type == OP_NULL; l = l->op_next)
2814eb74
PJ
471 ;
472 sequence(aTHX_ l);
5411ce9f 473 for (l = cLOOPo->op_nextop; l && l->op_type == OP_NULL; l = l->op_next)
2814eb74
PJ
474 ;
475 sequence(aTHX_ l);
5411ce9f 476 for (l = cLOOPo->op_lastop; l && l->op_type == OP_NULL; l = l->op_next)
2814eb74
PJ
477 ;
478 sequence(aTHX_ l);
479 break;
480
481 case OP_QR:
482 case OP_MATCH:
483 case OP_SUBST:
484 hv_store(Sequence, key, len, newSVuv(++seq), 0);
5411ce9f 485 for (l = cPMOPo->op_pmreplstart; l && l->op_type == OP_NULL; l = l->op_next)
2814eb74
PJ
486 ;
487 sequence(aTHX_ l);
488 break;
489
490 case OP_HELEM:
491 break;
492
493 default:
494 hv_store(Sequence, key, len, newSVuv(++seq), 0);
495 break;
496 }
497 oldop = o;
498 }
499}
500
501STATIC UV
6867be6d 502sequence_num(pTHX_ const OP *o)
2814eb74
PJ
503{
504 SV *op,
505 **seq;
506 char *key;
507 STRLEN len;
508 if (!o) return 0;
c0fd1b42 509 op = newSVuv(PTR2UV(o));
2814eb74
PJ
510 key = SvPV(op, len);
511 seq = hv_fetch(Sequence, key, len, 0);
512 return seq ? SvUV(*seq): 0;
513}
514
79072805 515void
6867be6d 516Perl_do_op_dump(pTHX_ I32 level, PerlIO *file, const OP *o)
79072805 517{
2814eb74
PJ
518 UV seq;
519 sequence(aTHX_ o);
cea2e8a9 520 Perl_dump_indent(aTHX_ level, file, "{\n");
3967c732 521 level++;
2814eb74
PJ
522 seq = sequence_num(aTHX_ o);
523 if (seq)
c0fd1b42 524 PerlIO_printf(file, "%-4"UVf, seq);
93a17b20 525 else
3967c732 526 PerlIO_printf(file, " ");
c8db6e60
JH
527 PerlIO_printf(file,
528 "%*sTYPE = %s ===> ",
53e06cf0 529 (int)(PL_dumpindent*level-4), "", OP_NAME(o));
2814eb74 530 if (o->op_next)
c0fd1b42
RB
531 PerlIO_printf(file, seq ? "%"UVf"\n" : "(%"UVf")\n",
532 sequence_num(aTHX_ o->op_next));
79072805 533 else
3967c732 534 PerlIO_printf(file, "DONE\n");
11343788 535 if (o->op_targ) {
acb36ea4 536 if (o->op_type == OP_NULL)
ae7d165c 537 {
cea2e8a9 538 Perl_dump_indent(aTHX_ level, file, " (was %s)\n", PL_op_name[o->op_targ]);
ae7d165c
PJ
539 if (o->op_targ == OP_NEXTSTATE)
540 {
541 if (CopLINE(cCOPo))
9d98dee5
RB
542 Perl_dump_indent(aTHX_ level, file, "LINE = %"UVf"\n",
543 (UV)CopLINE(cCOPo));
ae7d165c
PJ
544 if (CopSTASHPV(cCOPo))
545 Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
546 CopSTASHPV(cCOPo));
547 if (cCOPo->cop_label)
548 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
549 cCOPo->cop_label);
550 }
551 }
8990e307 552 else
894356b3 553 Perl_dump_indent(aTHX_ level, file, "TARG = %ld\n", (long)o->op_targ);
8990e307 554 }
748a9306 555#ifdef DUMPADDR
57def98f 556 Perl_dump_indent(aTHX_ level, file, "ADDR = 0x%"UVxf" => 0x%"UVxf"\n", (UV)o, (UV)o->op_next);
79072805 557#endif
11343788 558 if (o->op_flags) {
79cb57f6 559 SV *tmpsv = newSVpvn("", 0);
5dc0d613 560 switch (o->op_flags & OPf_WANT) {
54310121 561 case OPf_WANT_VOID:
46fc3d4c 562 sv_catpv(tmpsv, ",VOID");
54310121 563 break;
564 case OPf_WANT_SCALAR:
46fc3d4c 565 sv_catpv(tmpsv, ",SCALAR");
54310121 566 break;
567 case OPf_WANT_LIST:
46fc3d4c 568 sv_catpv(tmpsv, ",LIST");
54310121 569 break;
570 default:
46fc3d4c 571 sv_catpv(tmpsv, ",UNKNOWN");
54310121 572 break;
573 }
11343788 574 if (o->op_flags & OPf_KIDS)
46fc3d4c 575 sv_catpv(tmpsv, ",KIDS");
11343788 576 if (o->op_flags & OPf_PARENS)
46fc3d4c 577 sv_catpv(tmpsv, ",PARENS");
11343788 578 if (o->op_flags & OPf_STACKED)
46fc3d4c 579 sv_catpv(tmpsv, ",STACKED");
11343788 580 if (o->op_flags & OPf_REF)
46fc3d4c 581 sv_catpv(tmpsv, ",REF");
11343788 582 if (o->op_flags & OPf_MOD)
46fc3d4c 583 sv_catpv(tmpsv, ",MOD");
11343788 584 if (o->op_flags & OPf_SPECIAL)
46fc3d4c 585 sv_catpv(tmpsv, ",SPECIAL");
cea2e8a9 586 Perl_dump_indent(aTHX_ level, file, "FLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
46fc3d4c 587 SvREFCNT_dec(tmpsv);
79072805 588 }
11343788 589 if (o->op_private) {
79cb57f6 590 SV *tmpsv = newSVpvn("", 0);
07447971
GS
591 if (PL_opargs[o->op_type] & OA_TARGLEX) {
592 if (o->op_private & OPpTARGET_MY)
593 sv_catpv(tmpsv, ",TARGET_MY");
594 }
bf91b999
SC
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");
601 }
602 else if (o->op_type == OP_AASSIGN) {
11343788 603 if (o->op_private & OPpASSIGN_COMMON)
46fc3d4c 604 sv_catpv(tmpsv, ",COMMON");
8d063cd8 605 }
11343788
MB
606 else if (o->op_type == OP_SASSIGN) {
607 if (o->op_private & OPpASSIGN_BACKWARDS)
46fc3d4c 608 sv_catpv(tmpsv, ",BACKWARDS");
a0d0e21e 609 }
11343788
MB
610 else if (o->op_type == OP_TRANS) {
611 if (o->op_private & OPpTRANS_SQUASH)
46fc3d4c 612 sv_catpv(tmpsv, ",SQUASH");
11343788 613 if (o->op_private & OPpTRANS_DELETE)
46fc3d4c 614 sv_catpv(tmpsv, ",DELETE");
11343788 615 if (o->op_private & OPpTRANS_COMPLEMENT)
46fc3d4c 616 sv_catpv(tmpsv, ",COMPLEMENT");
bf91b999
SC
617 if (o->op_private & OPpTRANS_IDENTICAL)
618 sv_catpv(tmpsv, ",IDENTICAL");
619 if (o->op_private & OPpTRANS_GROWS)
620 sv_catpv(tmpsv, ",GROWS");
8d063cd8 621 }
11343788
MB
622 else if (o->op_type == OP_REPEAT) {
623 if (o->op_private & OPpREPEAT_DOLIST)
46fc3d4c 624 sv_catpv(tmpsv, ",DOLIST");
8d063cd8 625 }
11343788
MB
626 else if (o->op_type == OP_ENTERSUB ||
627 o->op_type == OP_RV2SV ||
23f1ca44 628 o->op_type == OP_GVSV ||
11343788
MB
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 )
85e6fe83 634 {
5dc0d613
MB
635 if (o->op_type == OP_ENTERSUB) {
636 if (o->op_private & OPpENTERSUB_AMPER)
46fc3d4c 637 sv_catpv(tmpsv, ",AMPER");
5dc0d613 638 if (o->op_private & OPpENTERSUB_DB)
46fc3d4c 639 sv_catpv(tmpsv, ",DB");
d3011074
IZ
640 if (o->op_private & OPpENTERSUB_HASTARG)
641 sv_catpv(tmpsv, ",HASTARG");
bf91b999
SC
642 if (o->op_private & OPpENTERSUB_NOPAREN)
643 sv_catpv(tmpsv, ",NOPAREN");
644 if (o->op_private & OPpENTERSUB_INARGS)
645 sv_catpv(tmpsv, ",INARGS");
95f0a2f1
SB
646 if (o->op_private & OPpENTERSUB_NOMOD)
647 sv_catpv(tmpsv, ",NOMOD");
68dc0745 648 }
bf91b999 649 else {
d3011074 650 switch (o->op_private & OPpDEREF) {
5f05dabc 651 case OPpDEREF_SV:
46fc3d4c 652 sv_catpv(tmpsv, ",SV");
5f05dabc 653 break;
654 case OPpDEREF_AV:
46fc3d4c 655 sv_catpv(tmpsv, ",AV");
5f05dabc 656 break;
657 case OPpDEREF_HV:
46fc3d4c 658 sv_catpv(tmpsv, ",HV");
5f05dabc 659 break;
660 }
bf91b999
SC
661 if (o->op_private & OPpMAYBE_LVSUB)
662 sv_catpv(tmpsv, ",MAYBE_LVSUB");
663 }
5dc0d613
MB
664 if (o->op_type == OP_AELEM || o->op_type == OP_HELEM) {
665 if (o->op_private & OPpLVAL_DEFER)
46fc3d4c 666 sv_catpv(tmpsv, ",LVAL_DEFER");
68dc0745 667 }
668 else {
5dc0d613 669 if (o->op_private & HINT_STRICT_REFS)
46fc3d4c 670 sv_catpv(tmpsv, ",STRICT_REFS");
192587c2
GS
671 if (o->op_private & OPpOUR_INTRO)
672 sv_catpv(tmpsv, ",OUR_INTRO");
68dc0745 673 }
8d063cd8 674 }
11343788
MB
675 else if (o->op_type == OP_CONST) {
676 if (o->op_private & OPpCONST_BARE)
46fc3d4c 677 sv_catpv(tmpsv, ",BARE");
7a52d87a
GS
678 if (o->op_private & OPpCONST_STRICT)
679 sv_catpv(tmpsv, ",STRICT");
bf91b999
SC
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");
79072805 686 }
11343788
MB
687 else if (o->op_type == OP_FLIP) {
688 if (o->op_private & OPpFLIP_LINENUM)
46fc3d4c 689 sv_catpv(tmpsv, ",LINENUM");
79072805 690 }
11343788
MB
691 else if (o->op_type == OP_FLOP) {
692 if (o->op_private & OPpFLIP_LINENUM)
46fc3d4c 693 sv_catpv(tmpsv, ",LINENUM");
95f0a2f1
SB
694 }
695 else if (o->op_type == OP_RV2CV) {
cd06dffe
GS
696 if (o->op_private & OPpLVAL_INTRO)
697 sv_catpv(tmpsv, ",INTRO");
79072805 698 }
bf91b999
SC
699 else if (o->op_type == OP_GV) {
700 if (o->op_private & OPpEARLY_CV)
701 sv_catpv(tmpsv, ",EARLY_CV");
702 }
703 else if (o->op_type == OP_LIST) {
704 if (o->op_private & OPpLIST_GUESSED)
705 sv_catpv(tmpsv, ",GUESSED");
706 }
707 else if (o->op_type == OP_DELETE) {
708 if (o->op_private & OPpSLICE)
709 sv_catpv(tmpsv, ",SLICE");
710 }
711 else if (o->op_type == OP_EXISTS) {
712 if (o->op_private & OPpEXISTS_SUB)
713 sv_catpv(tmpsv, ",EXISTS_SUB");
714 }
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");
722 }
723 else if (o->op_type == OP_THREADSV) {
724 if (o->op_private & OPpDONE_SVREF)
725 sv_catpv(tmpsv, ",SVREF");
726 }
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");
736 }
737 else if (o->op_type == OP_EXIT) {
738 if (o->op_private & OPpEXIT_VMSISH)
96e176bf
CL
739 sv_catpv(tmpsv, ",EXIT_VMSISH");
740 if (o->op_private & OPpHUSH_VMSISH)
741 sv_catpv(tmpsv, ",HUSH_VMSISH");
742 }
743 else if (o->op_type == OP_DIE) {
744 if (o->op_private & OPpHUSH_VMSISH)
745 sv_catpv(tmpsv, ",HUSH_VMSISH");
bf91b999 746 }
fbb0b3b3
RGS
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");
1af34c76 752 }
11343788 753 if (o->op_flags & OPf_MOD && o->op_private & OPpLVAL_INTRO)
46fc3d4c 754 sv_catpv(tmpsv, ",INTRO");
755 if (SvCUR(tmpsv))
cea2e8a9 756 Perl_dump_indent(aTHX_ level, file, "PRIVATE = (%s)\n", SvPVX(tmpsv) + 1);
46fc3d4c 757 SvREFCNT_dec(tmpsv);
8d063cd8 758 }
8d063cd8 759
11343788 760 switch (o->op_type) {
971a9dd3 761 case OP_AELEMFAST:
93a17b20 762 case OP_GVSV:
79072805 763 case OP_GV:
971a9dd3 764#ifdef USE_ITHREADS
c803eecc 765 Perl_dump_indent(aTHX_ level, file, "PADIX = %" IVdf "\n", (IV)cPADOPo->op_padix);
971a9dd3 766#else
38c076c7
DM
767 if ( ! PL_op->op_flags & OPf_SPECIAL) { /* not lexical */
768 if (cSVOPo->op_sv) {
769 SV *tmpsv = NEWSV(0,0);
770 STRLEN n_a;
771 ENTER;
772 SAVEFREESV(tmpsv);
773 gv_fullname3(tmpsv, (GV*)cSVOPo->op_sv, Nullch);
774 Perl_dump_indent(aTHX_ level, file, "GV = %s\n", SvPV(tmpsv, n_a));
775 LEAVE;
776 }
777 else
778 Perl_dump_indent(aTHX_ level, file, "GV = NULL\n");
378cc40b 779 }
971a9dd3 780#endif
79072805
LW
781 break;
782 case OP_CONST:
f5d5a27c 783 case OP_METHOD_NAMED:
b6a15bc5
DM
784#ifndef USE_ITHREADS
785 /* with ITHREADS, consts are stored in the pad, and the right pad
786 * may not be active here, so skip */
3848b962 787 Perl_dump_indent(aTHX_ level, file, "SV = %s\n", SvPEEK(cSVOPo_sv));
b6a15bc5 788#endif
79072805 789 break;
7399586d 790 case OP_SETSTATE:
93a17b20
LW
791 case OP_NEXTSTATE:
792 case OP_DBSTATE:
57843af0 793 if (CopLINE(cCOPo))
9d98dee5
RB
794 Perl_dump_indent(aTHX_ level, file, "LINE = %"UVf"\n",
795 (UV)CopLINE(cCOPo));
ed094faf
GS
796 if (CopSTASHPV(cCOPo))
797 Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
798 CopSTASHPV(cCOPo));
11343788 799 if (cCOPo->cop_label)
ed094faf
GS
800 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
801 cCOPo->cop_label);
79072805
LW
802 break;
803 case OP_ENTERLOOP:
cea2e8a9 804 Perl_dump_indent(aTHX_ level, file, "REDO ===> ");
11343788 805 if (cLOOPo->op_redoop)
c0fd1b42 806 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOOPo->op_redoop));
79072805 807 else
3967c732 808 PerlIO_printf(file, "DONE\n");
cea2e8a9 809 Perl_dump_indent(aTHX_ level, file, "NEXT ===> ");
11343788 810 if (cLOOPo->op_nextop)
c0fd1b42 811 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOOPo->op_nextop));
79072805 812 else
3967c732 813 PerlIO_printf(file, "DONE\n");
cea2e8a9 814 Perl_dump_indent(aTHX_ level, file, "LAST ===> ");
11343788 815 if (cLOOPo->op_lastop)
c0fd1b42 816 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOOPo->op_lastop));
79072805 817 else
3967c732 818 PerlIO_printf(file, "DONE\n");
79072805
LW
819 break;
820 case OP_COND_EXPR:
1a67a97c 821 case OP_RANGE:
a0d0e21e 822 case OP_MAPWHILE:
79072805
LW
823 case OP_GREPWHILE:
824 case OP_OR:
825 case OP_AND:
cea2e8a9 826 Perl_dump_indent(aTHX_ level, file, "OTHER ===> ");
11343788 827 if (cLOGOPo->op_other)
c0fd1b42 828 PerlIO_printf(file, "%"UVf"\n", sequence_num(aTHX_ cLOGOPo->op_other));
79072805 829 else
3967c732 830 PerlIO_printf(file, "DONE\n");
79072805
LW
831 break;
832 case OP_PUSHRE:
833 case OP_MATCH:
8782bef2 834 case OP_QR:
79072805 835 case OP_SUBST:
3967c732 836 do_pmop_dump(level, file, cPMOPo);
79072805 837 break;
7934575e
GS
838 case OP_LEAVE:
839 case OP_LEAVEEVAL:
840 case OP_LEAVESUB:
841 case OP_LEAVESUBLV:
842 case OP_LEAVEWRITE:
843 case OP_SCOPE:
844 if (o->op_private & OPpREFCOUNTED)
845 Perl_dump_indent(aTHX_ level, file, "REFCNT = %"UVuf"\n", (UV)o->op_targ);
846 break;
a0d0e21e
LW
847 default:
848 break;
79072805 849 }
11343788 850 if (o->op_flags & OPf_KIDS) {
79072805 851 OP *kid;
11343788 852 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
3967c732 853 do_op_dump(level, file, kid);
8d063cd8 854 }
cea2e8a9 855 Perl_dump_indent(aTHX_ level-1, file, "}\n");
3967c732
JD
856}
857
858void
6867be6d 859Perl_op_dump(pTHX_ const OP *o)
3967c732
JD
860{
861 do_op_dump(0, Perl_debug_log, o);
8d063cd8
LW
862}
863
8adcabd8 864void
864dbfa3 865Perl_gv_dump(pTHX_ GV *gv)
378cc40b 866{
79072805 867 SV *sv;
378cc40b 868
79072805 869 if (!gv) {
760ac839 870 PerlIO_printf(Perl_debug_log, "{}\n");
378cc40b
LW
871 return;
872 }
8990e307 873 sv = sv_newmortal();
760ac839 874 PerlIO_printf(Perl_debug_log, "{\n");
f6aff53a 875 gv_fullname3(sv, gv, Nullch);
05671074 876 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "GV_NAME = %s", SvPVX(sv));
79072805 877 if (gv != GvEGV(gv)) {
f6aff53a 878 gv_efullname3(sv, GvEGV(gv), Nullch);
05671074 879 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "-> %s", SvPVX(sv));
8adcabd8 880 }
3967c732 881 PerlIO_putc(Perl_debug_log, '\n');
cea2e8a9 882 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "}\n");
8d063cd8
LW
883}
884
14befaf4 885
afe38520 886/* map magic types to the symbolic names
14befaf4
DM
887 * (with the PERL_MAGIC_ prefixed stripped)
888 */
889
bfed75c6 890static struct { const char type; const char *name; } magic_names[] = {
516a5887
JH
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)" },
afe38520 902 { PERL_MAGIC_shared, "shared(N)" },
516a5887
JH
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)" },
afe38520 916 { PERL_MAGIC_shared_scalar, "shared_scalar(n)" },
516a5887
JH
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)" },
afe38520 923 { PERL_MAGIC_uvar_elem, "uvar_elem(v)" },
516a5887 924 { PERL_MAGIC_vec, "vec(v)" },
cb50f42d 925 { PERL_MAGIC_vstring, "vstring(V)" },
7e8c5dac 926 { PERL_MAGIC_utf8, "utf8(w)" },
516a5887
JH
927 { PERL_MAGIC_substr, "substr(x)" },
928 { PERL_MAGIC_defelem, "defelem(y)" },
929 { PERL_MAGIC_ext, "ext(~)" },
930 /* this null string terminates the list */
931 { 0, 0 },
14befaf4
DM
932};
933
8adcabd8 934void
6867be6d 935Perl_do_magic_dump(pTHX_ I32 level, PerlIO *file, const MAGIC *mg, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
8d063cd8 936{
3967c732 937 for (; mg; mg = mg->mg_moremagic) {
b900a521
JH
938 Perl_dump_indent(aTHX_ level, file,
939 " MAGIC = 0x%"UVxf"\n", PTR2UV(mg));
3967c732 940 if (mg->mg_virtual) {
bfed75c6
AL
941 const MGVTBL * const v = mg->mg_virtual;
942 const char *s = 0;
3967c732
JD
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";
966#endif
3967c732
JD
967 else if (v == &PL_vtbl_amagic) s = "amagic";
968 else if (v == &PL_vtbl_amagicelem) s = "amagicelem";
810b8aa5 969 else if (v == &PL_vtbl_backref) s = "backref";
7e8c5dac 970 else if (v == &PL_vtbl_utf8) s = "utf8";
3967c732 971 if (s)
cea2e8a9 972 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = &PL_vtbl_%s\n", s);
3967c732 973 else
b900a521 974 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0x%"UVxf"\n", PTR2UV(v));
3967c732
JD
975 }
976 else
cea2e8a9 977 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0\n");
8d063cd8 978
3967c732 979 if (mg->mg_private)
cea2e8a9 980 Perl_dump_indent(aTHX_ level, file, " MG_PRIVATE = %d\n", mg->mg_private);
3967c732 981
14befaf4
DM
982 {
983 int n;
e1ec3a88 984 const char *name = 0;
14befaf4
DM
985 for (n=0; magic_names[n].name; n++) {
986 if (mg->mg_type == magic_names[n].type) {
987 name = magic_names[n].name;
988 break;
989 }
990 }
991 if (name)
992 Perl_dump_indent(aTHX_ level, file,
993 " MG_TYPE = PERL_MAGIC_%s\n", name);
994 else
995 Perl_dump_indent(aTHX_ level, file,
996 " MG_TYPE = UNKNOWN(\\%o)\n", mg->mg_type);
997 }
3967c732
JD
998
999 if (mg->mg_flags) {
cea2e8a9 1000 Perl_dump_indent(aTHX_ level, file, " MG_FLAGS = 0x%02X\n", mg->mg_flags);
cb50f42d
YST
1001 if (mg->mg_type == PERL_MAGIC_envelem &&
1002 mg->mg_flags & MGf_TAINTEDDIR)
cea2e8a9 1003 Perl_dump_indent(aTHX_ level, file, " TAINTEDDIR\n");
3967c732 1004 if (mg->mg_flags & MGf_REFCOUNTED)
cea2e8a9 1005 Perl_dump_indent(aTHX_ level, file, " REFCOUNTED\n");
3967c732 1006 if (mg->mg_flags & MGf_GSKIP)
cea2e8a9 1007 Perl_dump_indent(aTHX_ level, file, " GSKIP\n");
cb50f42d
YST
1008 if (mg->mg_type == PERL_MAGIC_regex_global &&
1009 mg->mg_flags & MGf_MINMATCH)
cea2e8a9 1010 Perl_dump_indent(aTHX_ level, file, " MINMATCH\n");
3967c732
JD
1011 }
1012 if (mg->mg_obj) {
b900a521 1013 Perl_dump_indent(aTHX_ level, file, " MG_OBJ = 0x%"UVxf"\n", PTR2UV(mg->mg_obj));
3967c732
JD
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 */
1016 }
1017 if (mg->mg_len)
894356b3 1018 Perl_dump_indent(aTHX_ level, file, " MG_LEN = %ld\n", (long)mg->mg_len);
3967c732 1019 if (mg->mg_ptr) {
b900a521 1020 Perl_dump_indent(aTHX_ level, file, " MG_PTR = 0x%"UVxf, PTR2UV(mg->mg_ptr));
3967c732 1021 if (mg->mg_len >= 0) {
7e8c5dac
HS
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));
1025 SvREFCNT_dec(sv);
1026 }
3967c732
JD
1027 }
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 */
1031 continue;
1032 }
1033 else
1034 PerlIO_puts(file, " ???? - please notify IZ");
1035 PerlIO_putc(file, '\n');
1036 }
7e8c5dac
HS
1037 if (mg->mg_type == PERL_MAGIC_utf8) {
1038 STRLEN *cache = (STRLEN *) mg->mg_ptr;
1039 if (cache) {
1040 IV i;
1041 for (i = 0; i < PERL_MAGIC_UTF8_CACHESIZE; i++)
1042 Perl_dump_indent(aTHX_ level, file,
1043 " %2"IVdf": %"UVuf" -> %"UVuf"\n",
1044 i,
1045 (UV)cache[i * 2],
1046 (UV)cache[i * 2 + 1]);
1047 }
1048 }
378cc40b 1049 }
3967c732
JD
1050}
1051
1052void
6867be6d 1053Perl_magic_dump(pTHX_ const MAGIC *mg)
3967c732
JD
1054{
1055 do_magic_dump(0, Perl_debug_log, mg, 0, 0, 0, 0);
1056}
1057
1058void
e1ec3a88 1059Perl_do_hv_dump(pTHX_ I32 level, PerlIO *file, const char *name, HV *sv)
3967c732 1060{
b900a521 1061 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
3967c732
JD
1062 if (sv && HvNAME(sv))
1063 PerlIO_printf(file, "\t\"%s\"\n", HvNAME(sv));
79072805 1064 else
3967c732
JD
1065 PerlIO_putc(file, '\n');
1066}
1067
1068void
e1ec3a88 1069Perl_do_gv_dump(pTHX_ I32 level, PerlIO *file, const char *name, GV *sv)
3967c732 1070{
b900a521 1071 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
3967c732
JD
1072 if (sv && GvNAME(sv))
1073 PerlIO_printf(file, "\t\"%s\"\n", GvNAME(sv));
c90c0ff4 1074 else
3967c732
JD
1075 PerlIO_putc(file, '\n');
1076}
1077
1078void
e1ec3a88 1079Perl_do_gvgv_dump(pTHX_ I32 level, PerlIO *file, const char *name, GV *sv)
3967c732 1080{
b900a521 1081 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
3967c732
JD
1082 if (sv && GvNAME(sv)) {
1083 PerlIO_printf(file, "\t\"");
e27ad1f2 1084 if (GvSTASH(sv) && HvNAME(GvSTASH(sv)))
3967c732
JD
1085 PerlIO_printf(file, "%s\" :: \"", HvNAME(GvSTASH(sv)));
1086 PerlIO_printf(file, "%s\"\n", GvNAME(sv));
8d063cd8 1087 }
3967c732
JD
1088 else
1089 PerlIO_putc(file, '\n');
1090}
1091
1092void
864dbfa3 1093Perl_do_sv_dump(pTHX_ I32 level, PerlIO *file, SV *sv, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
3967c732 1094{
cea89e20 1095 SV *d;
e1ec3a88 1096 const char *s;
3967c732
JD
1097 U32 flags;
1098 U32 type;
1099
1100 if (!sv) {
cea2e8a9 1101 Perl_dump_indent(aTHX_ level, file, "SV = 0\n");
3967c732 1102 return;
378cc40b 1103 }
2ef28da1 1104
3967c732
JD
1105 flags = SvFLAGS(sv);
1106 type = SvTYPE(sv);
79072805 1107
cea89e20 1108 d = Perl_newSVpvf(aTHX_
57def98f 1109 "(0x%"UVxf") at 0x%"UVxf"\n%*s REFCNT = %"IVdf"\n%*s FLAGS = (",
56431972 1110 PTR2UV(SvANY(sv)), PTR2UV(sv),
894356b3
GS
1111 (int)(PL_dumpindent*level), "", (IV)SvREFCNT(sv),
1112 (int)(PL_dumpindent*level), "");
8d063cd8 1113
d9d18af6 1114 if (flags & SVs_PADSTALE) sv_catpv(d, "PADSTALE,");
3967c732
JD
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,");
4db58590 1122
3967c732
JD
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,");
810b8aa5
GS
1126 if (flags & SVf_ROK) {
1127 sv_catpv(d, "ROK,");
1128 if (SvWEAKREF(sv)) sv_catpv(d, "WEAKREF,");
1129 }
3967c732
JD
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,");
4db58590 1133
afce8e55
NC
1134 if (flags & SVf_AMAGIC && type != SVt_PVHV)
1135 sv_catpv(d, "OVERLOAD,");
3967c732
JD
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,");
9660f481
DM
1139 if (flags & SVp_SCREAM && type != SVt_PVHV)
1140 sv_catpv(d, "SCREAM,");
3967c732
JD
1141
1142 switch (type) {
1143 case SVt_PVCV:
1144 case SVt_PVFM:
1145 if (CvANON(sv)) sv_catpv(d, "ANON,");
1146 if (CvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
1147 if (CvCLONE(sv)) sv_catpv(d, "CLONE,");
1148 if (CvCLONED(sv)) sv_catpv(d, "CLONED,");
de3f1649 1149 if (CvCONST(sv)) sv_catpv(d, "CONST,");
3967c732 1150 if (CvNODEBUG(sv)) sv_catpv(d, "NODEBUG,");
25da4f38 1151 if (SvCOMPILED(sv)) sv_catpv(d, "COMPILED,");
18f7acf9
TJ
1152 if (CvLVALUE(sv)) sv_catpv(d, "LVALUE,");
1153 if (CvMETHOD(sv)) sv_catpv(d, "METHOD,");
662a8415 1154 if (CvLOCKED(sv)) sv_catpv(d, "LOCKED,");
7dafbf52 1155 if (CvWEAKOUTSIDE(sv)) sv_catpv(d, "WEAKOUTSIDE,");
06492da6 1156 if (CvASSERTION(sv)) sv_catpv(d, "ASSERTION,");
3967c732
JD
1157 break;
1158 case SVt_PVHV:
1159 if (HvSHAREKEYS(sv)) sv_catpv(d, "SHAREKEYS,");
1160 if (HvLAZYDEL(sv)) sv_catpv(d, "LAZYDEL,");
19692e8d 1161 if (HvHASKFLAGS(sv)) sv_catpv(d, "HASKFLAGS,");
afce8e55 1162 if (HvREHASH(sv)) sv_catpv(d, "REHASH,");
9660f481 1163 if (flags & SVphv_CLONEABLE) sv_catpv(d, "CLONEABLE,");
3967c732 1164 break;
4ce457a6 1165 case SVt_PVGV: case SVt_PVLV:
3967c732
JD
1166 if (GvINTRO(sv)) sv_catpv(d, "INTRO,");
1167 if (GvMULTI(sv)) sv_catpv(d, "MULTI,");
7fb37951 1168 if (GvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
3967c732 1169 if (GvASSUMECV(sv)) sv_catpv(d, "ASSUMECV,");
12c18039 1170 if (GvIN_PAD(sv)) sv_catpv(d, "IN_PAD,");
addd1794 1171 if (flags & SVpad_OUR) sv_catpv(d, "OUR,");
3967c732
JD
1172 if (GvIMPORTED(sv)) {
1173 sv_catpv(d, "IMPORT");
1174 if (GvIMPORTED(sv) == GVf_IMPORTED)
1175 sv_catpv(d, "ALL,");
1176 else {
1177 sv_catpv(d, "(");
1178 if (GvIMPORTED_SV(sv)) sv_catpv(d, " SV");
1179 if (GvIMPORTED_AV(sv)) sv_catpv(d, " AV");
1180 if (GvIMPORTED_HV(sv)) sv_catpv(d, " HV");
1181 if (GvIMPORTED_CV(sv)) sv_catpv(d, " CV");
1182 sv_catpv(d, " ),");
1183 }
1184 }
addd1794 1185 /* FALL THROUGH */
25da4f38
IZ
1186 default:
1187 if (SvEVALED(sv)) sv_catpv(d, "EVALED,");
1188 if (SvIsUV(sv)) sv_catpv(d, "IsUV,");
1189 break;
3967c732
JD
1190 case SVt_PVBM:
1191 if (SvTAIL(sv)) sv_catpv(d, "TAIL,");
25da4f38 1192 if (SvVALID(sv)) sv_catpv(d, "VALID,");
3967c732 1193 break;
addd1794
AMS
1194 case SVt_PVMG:
1195 if (flags & SVpad_TYPED)
1196 sv_catpv(d, "TYPED,");
1197 break;
3967c732 1198 }
86f0d186
NC
1199 /* SVphv_SHAREKEYS is also 0x20000000 */
1200 if ((type != SVt_PVHV) && SvUTF8(sv))
9fe74ede 1201 sv_catpv(d, "UTF8");
3967c732 1202
b162af07
SP
1203 if (*(SvEND(d) - 1) == ',') {
1204 SvCUR_set(d, SvCUR(d) - 1);
1205 SvPVX(d)[SvCUR(d)] = '\0';
1206 }
3967c732
JD
1207 sv_catpv(d, ")");
1208 s = SvPVX(d);
1209
fd0854ff
DM
1210#ifdef DEBUG_LEAKING_SCALARS
1211 Perl_dump_indent(aTHX_ level, file, "ALLOCATED at %s:%d %s %s%s\n",
1212 sv->sv_debug_file ? sv->sv_debug_file : "(unknown)",
1213 sv->sv_debug_line,
1214 sv->sv_debug_inpad ? "for" : "by",
1215 sv->sv_debug_optype ? PL_op_name[sv->sv_debug_optype]: "(none)",
1216 sv->sv_debug_cloned ? " (cloned)" : "");
1217#endif
cea2e8a9 1218 Perl_dump_indent(aTHX_ level, file, "SV = ");
3967c732
JD
1219 switch (type) {
1220 case SVt_NULL:
1221 PerlIO_printf(file, "NULL%s\n", s);
cea89e20 1222 SvREFCNT_dec(d);
3967c732
JD
1223 return;
1224 case SVt_IV:
1225 PerlIO_printf(file, "IV%s\n", s);
1226 break;
1227 case SVt_NV:
1228 PerlIO_printf(file, "NV%s\n", s);
1229 break;
1230 case SVt_RV:
1231 PerlIO_printf(file, "RV%s\n", s);
1232 break;
1233 case SVt_PV:
1234 PerlIO_printf(file, "PV%s\n", s);
1235 break;
1236 case SVt_PVIV:
1237 PerlIO_printf(file, "PVIV%s\n", s);
1238 break;
1239 case SVt_PVNV:
1240 PerlIO_printf(file, "PVNV%s\n", s);
1241 break;
1242 case SVt_PVBM:
1243 PerlIO_printf(file, "PVBM%s\n", s);
1244 break;
1245 case SVt_PVMG:
1246 PerlIO_printf(file, "PVMG%s\n", s);
1247 break;
1248 case SVt_PVLV:
1249 PerlIO_printf(file, "PVLV%s\n", s);
1250 break;
1251 case SVt_PVAV:
1252 PerlIO_printf(file, "PVAV%s\n", s);
1253 break;
1254 case SVt_PVHV:
1255 PerlIO_printf(file, "PVHV%s\n", s);
1256 break;
1257 case SVt_PVCV:
1258 PerlIO_printf(file, "PVCV%s\n", s);
1259 break;
1260 case SVt_PVGV:
1261 PerlIO_printf(file, "PVGV%s\n", s);
1262 break;
1263 case SVt_PVFM:
1264 PerlIO_printf(file, "PVFM%s\n", s);
1265 break;
1266 case SVt_PVIO:
1267 PerlIO_printf(file, "PVIO%s\n", s);
1268 break;
1269 default:
faccc32b 1270 PerlIO_printf(file, "UNKNOWN(0x%"UVxf") %s\n", (UV)type, s);
cea89e20 1271 SvREFCNT_dec(d);
3967c732
JD
1272 return;
1273 }
1274 if (type >= SVt_PVIV || type == SVt_IV) {
765f542d
NC
1275 if (SvIsUV(sv)
1276#ifdef PERL_COPY_ON_WRITE
1277 || SvIsCOW(sv)
1278#endif
1279 )
57def98f 1280 Perl_dump_indent(aTHX_ level, file, " UV = %"UVuf, (UV)SvUVX(sv));
cf2093f6 1281 else
57def98f 1282 Perl_dump_indent(aTHX_ level, file, " IV = %"IVdf, (IV)SvIVX(sv));
3967c732
JD
1283 if (SvOOK(sv))
1284 PerlIO_printf(file, " (OFFSET)");
765f542d
NC
1285#ifdef PERL_COPY_ON_WRITE
1286 if (SvIsCOW_shared_hash(sv))
1287 PerlIO_printf(file, " (HASH)");
1288 else if (SvIsCOW_normal(sv))
1289 PerlIO_printf(file, " (COW from 0x%"UVxf")", (UV)SvUVX(sv));
1290#endif
3967c732
JD
1291 PerlIO_putc(file, '\n');
1292 }
1293 if (type >= SVt_PVNV || type == SVt_NV) {
e54dc35b 1294 STORE_NUMERIC_LOCAL_SET_STANDARD();
57def98f 1295 /* %Vg doesn't work? --jhi */
cf2093f6 1296#ifdef USE_LONG_DOUBLE
2d4389e4 1297 Perl_dump_indent(aTHX_ level, file, " NV = %.*" PERL_PRIgldbl "\n", LDBL_DIG, SvNVX(sv));
cf2093f6 1298#else
cea2e8a9 1299 Perl_dump_indent(aTHX_ level, file, " NV = %.*g\n", DBL_DIG, SvNVX(sv));
cf2093f6 1300#endif
e54dc35b 1301 RESTORE_NUMERIC_LOCAL();
3967c732
JD
1302 }
1303 if (SvROK(sv)) {
57def98f 1304 Perl_dump_indent(aTHX_ level, file, " RV = 0x%"UVxf"\n", PTR2UV(SvRV(sv)));
3967c732
JD
1305 if (nest < maxnest)
1306 do_sv_dump(level+1, file, SvRV(sv), nest+1, maxnest, dumpops, pvlim);
3967c732 1307 }
cea89e20
JH
1308 if (type < SVt_PV) {
1309 SvREFCNT_dec(d);
3967c732 1310 return;
cea89e20 1311 }
4ce457a6 1312 if (type <= SVt_PVLV && type != SVt_PVGV) {
3967c732 1313 if (SvPVX(sv)) {
57def98f 1314 Perl_dump_indent(aTHX_ level, file," PV = 0x%"UVxf" ", PTR2UV(SvPVX(sv)));
3967c732
JD
1315 if (SvOOK(sv))
1316 PerlIO_printf(file, "( %s . ) ", pv_display(d, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, pvlim));
e6abe6d8
JH
1317 PerlIO_printf(file, "%s", pv_display(d, SvPVX(sv), SvCUR(sv), SvLEN(sv), pvlim));
1318 if (SvUTF8(sv)) /* the 8? \x{....} */
c728cb41 1319 PerlIO_printf(file, " [UTF8 \"%s\"]", sv_uni_display(d, sv, 8 * sv_len_utf8(sv), UNI_DISPLAY_QQ));
e6abe6d8 1320 PerlIO_printf(file, "\n");
57def98f
JH
1321 Perl_dump_indent(aTHX_ level, file, " CUR = %"IVdf"\n", (IV)SvCUR(sv));
1322 Perl_dump_indent(aTHX_ level, file, " LEN = %"IVdf"\n", (IV)SvLEN(sv));
3967c732
JD
1323 }
1324 else
cea2e8a9 1325 Perl_dump_indent(aTHX_ level, file, " PV = 0\n");
3967c732
JD
1326 }
1327 if (type >= SVt_PVMG) {
1328 if (SvMAGIC(sv))
1329 do_magic_dump(level, file, SvMAGIC(sv), nest, maxnest, dumpops, pvlim);
1330 if (SvSTASH(sv))
1331 do_hv_dump(level, file, " STASH", SvSTASH(sv));
1332 }
1333 switch (type) {
3967c732 1334 case SVt_PVAV:
57def98f 1335 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(AvARRAY(sv)));
3967c732 1336 if (AvARRAY(sv) != AvALLOC(sv)) {
57def98f
JH
1337 PerlIO_printf(file, " (offset=%"IVdf")\n", (IV)(AvARRAY(sv) - AvALLOC(sv)));
1338 Perl_dump_indent(aTHX_ level, file, " ALLOC = 0x%"UVxf"\n", PTR2UV(AvALLOC(sv)));
3967c732
JD
1339 }
1340 else
1341 PerlIO_putc(file, '\n');
57def98f
JH
1342 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)AvFILLp(sv));
1343 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)AvMAX(sv));
1344 Perl_dump_indent(aTHX_ level, file, " ARYLEN = 0x%"UVxf"\n", PTR2UV(AvARYLEN(sv)));
3967c732
JD
1345 flags = AvFLAGS(sv);
1346 sv_setpv(d, "");
1347 if (flags & AVf_REAL) sv_catpv(d, ",REAL");
1348 if (flags & AVf_REIFY) sv_catpv(d, ",REIFY");
1349 if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
cea2e8a9 1350 Perl_dump_indent(aTHX_ level, file, " FLAGS = (%s)\n", SvCUR(d) ? SvPVX(d) + 1 : "");
3967c732
JD
1351 if (nest < maxnest && av_len((AV*)sv) >= 0) {
1352 int count;
1353 for (count = 0; count <= av_len((AV*)sv) && count < maxnest; count++) {
1354 SV** elt = av_fetch((AV*)sv,count,0);
1355
57def98f 1356 Perl_dump_indent(aTHX_ level + 1, file, "Elt No. %"IVdf"\n", (IV)count);
2ef28da1 1357 if (elt)
3967c732
JD
1358 do_sv_dump(level+1, file, *elt, nest+1, maxnest, dumpops, pvlim);
1359 }
1360 }
1361 break;
1362 case SVt_PVHV:
57def98f 1363 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(HvARRAY(sv)));
3967c732
JD
1364 if (HvARRAY(sv) && HvKEYS(sv)) {
1365 /* Show distribution of HEs in the ARRAY */
1366 int freq[200];
1367#define FREQ_MAX (sizeof freq / sizeof freq[0] - 1)
1368 int i;
1369 int max = 0;
1370 U32 pow2 = 2, keys = HvKEYS(sv);
65202027 1371 NV theoret, sum = 0;
3967c732
JD
1372
1373 PerlIO_printf(file, " (");
1374 Zero(freq, FREQ_MAX + 1, int);
eb160463 1375 for (i = 0; (STRLEN)i <= HvMAX(sv); i++) {
3967c732
JD
1376 HE* h; int count = 0;
1377 for (h = HvARRAY(sv)[i]; h; h = HeNEXT(h))
1378 count++;
1379 if (count > FREQ_MAX)
1380 count = FREQ_MAX;
1381 freq[count]++;
1382 if (max < count)
1383 max = count;
1384 }
1385 for (i = 0; i <= max; i++) {
1386 if (freq[i]) {
1387 PerlIO_printf(file, "%d%s:%d", i,
1388 (i == FREQ_MAX) ? "+" : "",
1389 freq[i]);
1390 if (i != max)
1391 PerlIO_printf(file, ", ");
1392 }
1393 }
1394 PerlIO_putc(file, ')');
b8fa94d8
MG
1395 /* The "quality" of a hash is defined as the total number of
1396 comparisons needed to access every element once, relative
1397 to the expected number needed for a random hash.
1398
1399 The total number of comparisons is equal to the sum of
e76cd0fa
AMS
1400 the squares of the number of entries in each bucket.
1401 For a random hash of n keys into k buckets, the expected
b8fa94d8
MG
1402 value is
1403 n + n(n-1)/2k
1404 */
1405
3967c732
JD
1406 for (i = max; i > 0; i--) { /* Precision: count down. */
1407 sum += freq[i] * i * i;
1408 }
155aba94 1409 while ((keys = keys >> 1))
3967c732 1410 pow2 = pow2 << 1;
3967c732 1411 theoret = HvKEYS(sv);
b8fa94d8 1412 theoret += theoret * (theoret-1)/pow2;
3967c732 1413 PerlIO_putc(file, '\n');
6b4667fc 1414 Perl_dump_indent(aTHX_ level, file, " hash quality = %.1"NVff"%%", theoret/sum*100);
3967c732
JD
1415 }
1416 PerlIO_putc(file, '\n');
57def98f
JH
1417 Perl_dump_indent(aTHX_ level, file, " KEYS = %"IVdf"\n", (IV)HvKEYS(sv));
1418 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)HvFILL(sv));
1419 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)HvMAX(sv));
1420 Perl_dump_indent(aTHX_ level, file, " RITER = %"IVdf"\n", (IV)HvRITER(sv));
1421 Perl_dump_indent(aTHX_ level, file, " EITER = 0x%"UVxf"\n", PTR2UV(HvEITER(sv)));
3967c732 1422 if (HvPMROOT(sv))
57def98f 1423 Perl_dump_indent(aTHX_ level, file, " PMROOT = 0x%"UVxf"\n", PTR2UV(HvPMROOT(sv)));
3967c732 1424 if (HvNAME(sv))
cea2e8a9 1425 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", HvNAME(sv));
3967c732
JD
1426 if (nest < maxnest && !HvEITER(sv)) { /* Try to preserve iterator */
1427 HE *he;
1428 HV *hv = (HV*)sv;
1429 int count = maxnest - nest;
1430
1431 hv_iterinit(hv);
e16e2ff8
NC
1432 while ((he = hv_iternext_flags(hv, HV_ITERNEXT_WANTPLACEHOLDERS))
1433 && count--) {
98c991d1 1434 SV *elt, *keysv;
e1ec3a88 1435 const char *keypv;
98c991d1 1436 STRLEN len;
3967c732
JD
1437 U32 hash = HeHASH(he);
1438
98c991d1
JH
1439 keysv = hv_iterkeysv(he);
1440 keypv = SvPV(keysv, len);
3967c732 1441 elt = hv_iterval(hv, he);
98c991d1
JH
1442 Perl_dump_indent(aTHX_ level+1, file, "Elt %s ", pv_display(d, keypv, len, 0, pvlim));
1443 if (SvUTF8(keysv))
c728cb41 1444 PerlIO_printf(file, "[UTF8 \"%s\"] ", sv_uni_display(d, keysv, 8 * sv_len_utf8(keysv), UNI_DISPLAY_QQ));
afce8e55
NC
1445 if (HeKREHASH(he))
1446 PerlIO_printf(file, "[REHASH] ");
98c991d1 1447 PerlIO_printf(file, "HASH = 0x%"UVxf"\n", (UV)hash);
3967c732
JD
1448 do_sv_dump(level+1, file, elt, nest+1, maxnest, dumpops, pvlim);
1449 }
1450 hv_iterinit(hv); /* Return to status quo */
1451 }
1452 break;
1453 case SVt_PVCV:
1454 if (SvPOK(sv))
7f848b6b 1455 Perl_dump_indent(aTHX_ level, file, " PROTOTYPE = \"%s\"\n", SvPV_nolen(sv));
3967c732
JD
1456 /* FALL THROUGH */
1457 case SVt_PVFM:
1458 do_hv_dump(level, file, " COMP_STASH", CvSTASH(sv));
1459 if (CvSTART(sv))
2814eb74 1460 Perl_dump_indent(aTHX_ level, file, " START = 0x%"UVxf" ===> %"IVdf"\n", PTR2UV(CvSTART(sv)), (IV)sequence_num(aTHX_ CvSTART(sv)));
57def98f 1461 Perl_dump_indent(aTHX_ level, file, " ROOT = 0x%"UVxf"\n", PTR2UV(CvROOT(sv)));
3967c732
JD
1462 if (CvROOT(sv) && dumpops)
1463 do_op_dump(level+1, file, CvROOT(sv));
57def98f
JH
1464 Perl_dump_indent(aTHX_ level, file, " XSUB = 0x%"UVxf"\n", PTR2UV(CvXSUB(sv)));
1465 Perl_dump_indent(aTHX_ level, file, " XSUBANY = %"IVdf"\n", (IV)CvXSUBANY(sv).any_i32);
3967c732 1466 do_gvgv_dump(level, file, " GVGV::GV", CvGV(sv));
57843af0 1467 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", CvFILE(sv));
57def98f 1468 Perl_dump_indent(aTHX_ level, file, " DEPTH = %"IVdf"\n", (IV)CvDEPTH(sv));
894356b3 1469 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)CvFLAGS(sv));
a3985cdc 1470 Perl_dump_indent(aTHX_ level, file, " OUTSIDE_SEQ = %"UVuf"\n", (UV)CvOUTSIDE_SEQ(sv));
3967c732 1471 if (type == SVt_PVFM)
57def98f
JH
1472 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)FmLINES(sv));
1473 Perl_dump_indent(aTHX_ level, file, " PADLIST = 0x%"UVxf"\n", PTR2UV(CvPADLIST(sv)));
dd2155a4
DM
1474 if (nest < maxnest) {
1475 do_dump_pad(level+1, file, CvPADLIST(sv), 0);
3967c732
JD
1476 }
1477 {
e1ec3a88 1478 const CV *outside = CvOUTSIDE(sv);
2ef28da1 1479 Perl_dump_indent(aTHX_ level, file, " OUTSIDE = 0x%"UVxf" (%s)\n",
57def98f 1480 PTR2UV(outside),
cf2093f6
JH
1481 (!outside ? "null"
1482 : CvANON(outside) ? "ANON"
1483 : (outside == PL_main_cv) ? "MAIN"
1484 : CvUNIQUE(outside) ? "UNIQUE"
1485 : CvGV(outside) ? GvNAME(CvGV(outside)) : "UNDEFINED"));
3967c732
JD
1486 }
1487 if (nest < maxnest && (CvCLONE(sv) || CvCLONED(sv)))
1488 do_sv_dump(level+1, file, (SV*)CvOUTSIDE(sv), nest+1, maxnest, dumpops, pvlim);
1489 break;
4ce457a6
TP
1490 case SVt_PVGV: case SVt_PVLV:
1491 if (type == SVt_PVLV) {
1492 Perl_dump_indent(aTHX_ level, file, " TYPE = %c\n", LvTYPE(sv));
1493 Perl_dump_indent(aTHX_ level, file, " TARGOFF = %"IVdf"\n", (IV)LvTARGOFF(sv));
1494 Perl_dump_indent(aTHX_ level, file, " TARGLEN = %"IVdf"\n", (IV)LvTARGLEN(sv));
1495 Perl_dump_indent(aTHX_ level, file, " TARG = 0x%"UVxf"\n", PTR2UV(LvTARG(sv)));
1496 if (LvTYPE(sv) != 't' && LvTYPE(sv) != 'T')
1497 do_sv_dump(level+1, file, LvTARG(sv), nest+1, maxnest,
1498 dumpops, pvlim);
1499 }
cea2e8a9 1500 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", GvNAME(sv));
57def98f 1501 Perl_dump_indent(aTHX_ level, file, " NAMELEN = %"IVdf"\n", (IV)GvNAMELEN(sv));
3967c732 1502 do_hv_dump (level, file, " GvSTASH", GvSTASH(sv));
57def98f 1503 Perl_dump_indent(aTHX_ level, file, " GP = 0x%"UVxf"\n", PTR2UV(GvGP(sv)));
f472eb5c
GS
1504 if (!GvGP(sv))
1505 break;
57def98f
JH
1506 Perl_dump_indent(aTHX_ level, file, " SV = 0x%"UVxf"\n", PTR2UV(GvSV(sv)));
1507 Perl_dump_indent(aTHX_ level, file, " REFCNT = %"IVdf"\n", (IV)GvREFCNT(sv));
1508 Perl_dump_indent(aTHX_ level, file, " IO = 0x%"UVxf"\n", PTR2UV(GvIOp(sv)));
1509 Perl_dump_indent(aTHX_ level, file, " FORM = 0x%"UVxf" \n", PTR2UV(GvFORM(sv)));
1510 Perl_dump_indent(aTHX_ level, file, " AV = 0x%"UVxf"\n", PTR2UV(GvAV(sv)));
1511 Perl_dump_indent(aTHX_ level, file, " HV = 0x%"UVxf"\n", PTR2UV(GvHV(sv)));
1512 Perl_dump_indent(aTHX_ level, file, " CV = 0x%"UVxf"\n", PTR2UV(GvCV(sv)));
1513 Perl_dump_indent(aTHX_ level, file, " CVGEN = 0x%"UVxf"\n", (UV)GvCVGEN(sv));
f4c556ac 1514 Perl_dump_indent(aTHX_ level, file, " GPFLAGS = 0x%"UVxf"\n", (UV)GvGPFLAGS(sv));
57def98f 1515 Perl_dump_indent(aTHX_ level, file, " LINE = %"IVdf"\n", (IV)GvLINE(sv));
b195d487 1516 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", GvFILE(sv));
e39917cc 1517 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)GvFLAGS(sv));
3967c732
JD
1518 do_gv_dump (level, file, " EGV", GvEGV(sv));
1519 break;
1520 case SVt_PVIO:
57def98f
JH
1521 Perl_dump_indent(aTHX_ level, file, " IFP = 0x%"UVxf"\n", PTR2UV(IoIFP(sv)));
1522 Perl_dump_indent(aTHX_ level, file, " OFP = 0x%"UVxf"\n", PTR2UV(IoOFP(sv)));
1523 Perl_dump_indent(aTHX_ level, file, " DIRP = 0x%"UVxf"\n", PTR2UV(IoDIRP(sv)));
1524 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)IoLINES(sv));
1525 Perl_dump_indent(aTHX_ level, file, " PAGE = %"IVdf"\n", (IV)IoPAGE(sv));
1526 Perl_dump_indent(aTHX_ level, file, " PAGE_LEN = %"IVdf"\n", (IV)IoPAGE_LEN(sv));
1527 Perl_dump_indent(aTHX_ level, file, " LINES_LEFT = %"IVdf"\n", (IV)IoLINES_LEFT(sv));
27533608 1528 if (IoTOP_NAME(sv))
cea2e8a9 1529 Perl_dump_indent(aTHX_ level, file, " TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
3967c732 1530 do_gv_dump (level, file, " TOP_GV", IoTOP_GV(sv));
27533608 1531 if (IoFMT_NAME(sv))
cea2e8a9 1532 Perl_dump_indent(aTHX_ level, file, " FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
3967c732 1533 do_gv_dump (level, file, " FMT_GV", IoFMT_GV(sv));
27533608 1534 if (IoBOTTOM_NAME(sv))
cea2e8a9 1535 Perl_dump_indent(aTHX_ level, file, " BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
3967c732 1536 do_gv_dump (level, file, " BOTTOM_GV", IoBOTTOM_GV(sv));
57def98f 1537 Perl_dump_indent(aTHX_ level, file, " SUBPROCESS = %"IVdf"\n", (IV)IoSUBPROCESS(sv));
27533608 1538 if (isPRINT(IoTYPE(sv)))
cea2e8a9 1539 Perl_dump_indent(aTHX_ level, file, " TYPE = '%c'\n", IoTYPE(sv));
27533608 1540 else
cea2e8a9 1541 Perl_dump_indent(aTHX_ level, file, " TYPE = '\\%o'\n", IoTYPE(sv));
57def98f 1542 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)IoFLAGS(sv));
3967c732
JD
1543 break;
1544 }
cea89e20 1545 SvREFCNT_dec(d);
3967c732
JD
1546}
1547
1548void
864dbfa3 1549Perl_sv_dump(pTHX_ SV *sv)
3967c732
JD
1550{
1551 do_sv_dump(0, Perl_debug_log, sv, 0, 0, 0, 0);
8d063cd8 1552}
bd16a5f0
IZ
1553
1554int
1555Perl_runops_debug(pTHX)
1556{
1557 if (!PL_op) {
1558 if (ckWARN_d(WARN_DEBUGGING))
9014280d 1559 Perl_warner(aTHX_ packWARN(WARN_DEBUGGING), "NULL OP IN RUN");
bd16a5f0
IZ
1560 return 0;
1561 }
1562
9f3673fb 1563 DEBUG_l(Perl_deb(aTHX_ "Entering new RUNOPS level\n"));
bd16a5f0
IZ
1564 do {
1565 PERL_ASYNC_CHECK();
1566 if (PL_debug) {
1567 if (PL_watchaddr != 0 && *PL_watchaddr != PL_watchok)
1568 PerlIO_printf(Perl_debug_log,
1569 "WARNING: %"UVxf" changed from %"UVxf" to %"UVxf"\n",
1570 PTR2UV(PL_watchaddr), PTR2UV(PL_watchok),
1571 PTR2UV(*PL_watchaddr));
d6721266
DM
1572 if (DEBUG_s_TEST_) {
1573 if (DEBUG_v_TEST_) {
1574 PerlIO_printf(Perl_debug_log, "\n");
1575 deb_stack_all();
1576 }
1577 else
1578 debstack();
1579 }
1580
1581
bd16a5f0
IZ
1582 if (DEBUG_t_TEST_) debop(PL_op);
1583 if (DEBUG_P_TEST_) debprof(PL_op);
1584 }
1585 } while ((PL_op = CALL_FPTR(PL_op->op_ppaddr)(aTHX)));
9f3673fb 1586 DEBUG_l(Perl_deb(aTHX_ "leaving RUNOPS level\n"));
bd16a5f0
IZ
1587
1588 TAINT_NOT;
1589 return 0;
1590}
1591
1592I32
6867be6d 1593Perl_debop(pTHX_ const OP *o)
bd16a5f0 1594{
bd16a5f0
IZ
1595 CV *cv;
1596 SV *sv;
1045810a
IZ
1597
1598 if (CopSTASH_eq(PL_curcop, PL_debstash) && !DEBUG_J_TEST_)
1599 return 0;
1600
bd16a5f0
IZ
1601 Perl_deb(aTHX_ "%s", OP_NAME(o));
1602 switch (o->op_type) {
1603 case OP_CONST:
1604 PerlIO_printf(Perl_debug_log, "(%s)", SvPEEK(cSVOPo_sv));
1605 break;
1606 case OP_GVSV:
1607 case OP_GV:
1608 if (cGVOPo_gv) {
1609 sv = NEWSV(0,0);
1610 gv_fullname3(sv, cGVOPo_gv, Nullch);
35c1215d 1611 PerlIO_printf(Perl_debug_log, "(%s)", SvPV_nolen(sv));
bd16a5f0
IZ
1612 SvREFCNT_dec(sv);
1613 }
1614 else
1615 PerlIO_printf(Perl_debug_log, "(NULL)");
1616 break;
1617 case OP_PADSV:
1618 case OP_PADAV:
1619 case OP_PADHV:
1620 /* print the lexical's name */
1621 cv = deb_curcv(cxstack_ix);
1622 if (cv) {
6867be6d
AL
1623 AV *padlist = CvPADLIST(cv);
1624 AV *comppad = (AV*)(*av_fetch(padlist, 0, FALSE));
bd16a5f0
IZ
1625 sv = *av_fetch(comppad, o->op_targ, FALSE);
1626 } else
1627 sv = Nullsv;
1628 if (sv)
1629 PerlIO_printf(Perl_debug_log, "(%s)", SvPV_nolen(sv));
1630 else
1631 PerlIO_printf(Perl_debug_log, "[%"UVuf"]", (UV)o->op_targ);
1632 break;
1633 default:
091ab601 1634 break;
bd16a5f0
IZ
1635 }
1636 PerlIO_printf(Perl_debug_log, "\n");
1637 return 0;
1638}
1639
1640STATIC CV*
1641S_deb_curcv(pTHX_ I32 ix)
1642{
e1ec3a88 1643 const PERL_CONTEXT *cx = &cxstack[ix];
bd16a5f0
IZ
1644 if (CxTYPE(cx) == CXt_SUB || CxTYPE(cx) == CXt_FORMAT)
1645 return cx->blk_sub.cv;
1646 else if (CxTYPE(cx) == CXt_EVAL && !CxTRYBLOCK(cx))
1647 return PL_compcv;
1648 else if (ix == 0 && PL_curstackinfo->si_type == PERLSI_MAIN)
1649 return PL_main_cv;
1650 else if (ix <= 0)
1651 return Nullcv;
1652 else
1653 return deb_curcv(ix - 1);
1654}
1655
1656void
1657Perl_watch(pTHX_ char **addr)
1658{
1659 PL_watchaddr = addr;
1660 PL_watchok = *addr;
1661 PerlIO_printf(Perl_debug_log, "WATCHING, %"UVxf" is currently %"UVxf"\n",
1662 PTR2UV(PL_watchaddr), PTR2UV(PL_watchok));
1663}
1664
1665STATIC void
e1ec3a88 1666S_debprof(pTHX_ const OP *o)
bd16a5f0 1667{
1045810a
IZ
1668 if (CopSTASH_eq(PL_curcop, PL_debstash) && !DEBUG_J_TEST_)
1669 return;
bd16a5f0
IZ
1670 if (!PL_profiledata)
1671 Newz(000, PL_profiledata, MAXO, U32);
1672 ++PL_profiledata[o->op_type];
1673}
1674
1675void
1676Perl_debprofdump(pTHX)
1677{
1678 unsigned i;
1679 if (!PL_profiledata)
1680 return;
1681 for (i = 0; i < MAXO; i++) {
1682 if (PL_profiledata[i])
1683 PerlIO_printf(Perl_debug_log,
1684 "%5lu %s\n", (unsigned long)PL_profiledata[i],
1685 PL_op_name[i]);
1686 }
1687}