This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add Perl debugging tutorial, regen toc.
[perl5.git] / dump.c
CommitLineData
a0d0e21e 1/* dump.c
a687059c 2 *
3818b22b 3 * Copyright (c) 1991-2000, Larry Wall
a687059c 4 *
6e21c824
LW
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.
8d063cd8 7 *
a0d0e21e
LW
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.'"
8d063cd8
LW
13 */
14
8d063cd8 15#include "EXTERN.h"
864dbfa3 16#define PERL_IN_DUMP_C
8d063cd8 17#include "perl.h"
f722798b 18#include "regcomp.h"
8d063cd8 19
3967c732 20void
864dbfa3 21Perl_dump_indent(pTHX_ I32 level, PerlIO *file, const char* pat, ...)
3967c732 22{
3967c732 23 va_list args;
3967c732 24 va_start(args, pat);
c5be433b 25 dump_vindent(level, file, pat, &args);
3967c732
JD
26 va_end(args);
27}
8adcabd8
LW
28
29void
c5be433b
GS
30Perl_dump_vindent(pTHX_ I32 level, PerlIO *file, const char* pat, va_list *args)
31{
32 dTHR;
c8db6e60 33 PerlIO_printf(file, "%*s", (int)(level*PL_dumpindent), "");
c5be433b
GS
34 PerlIO_vprintf(file, pat, *args);
35}
36
37void
864dbfa3 38Perl_dump_all(pTHX)
79072805 39{
11343788 40 dTHR;
760ac839 41 PerlIO_setlinebuf(Perl_debug_log);
3280af22 42 if (PL_main_root)
3967c732 43 op_dump(PL_main_root);
3280af22 44 dump_packsubs(PL_defstash);
463ee0b2
LW
45}
46
47void
864dbfa3 48Perl_dump_packsubs(pTHX_ HV *stash)
463ee0b2 49{
11343788 50 dTHR;
a0d0e21e 51 I32 i;
463ee0b2
LW
52 HE *entry;
53
8990e307
LW
54 if (!HvARRAY(stash))
55 return;
a0d0e21e 56 for (i = 0; i <= (I32) HvMAX(stash); i++) {
4db58590 57 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
58 GV *gv = (GV*)HeVAL(entry);
463ee0b2 59 HV *hv;
e29cdcb3
GS
60 if (SvTYPE(gv) != SVt_PVGV || !GvGP(gv))
61 continue;
8ebc5c01 62 if (GvCVu(gv))
463ee0b2 63 dump_sub(gv);
85e6fe83
LW
64 if (GvFORM(gv))
65 dump_form(gv);
4db58590 66 if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
3280af22 67 (hv = GvHV(gv)) && HvNAME(hv) && hv != PL_defstash)
463ee0b2
LW
68 dump_packsubs(hv); /* nested package */
69 }
79072805
LW
70 }
71}
72
73void
864dbfa3 74Perl_dump_sub(pTHX_ GV *gv)
a687059c 75{
8990e307 76 SV *sv = sv_newmortal();
85e6fe83 77
f6aff53a 78 gv_fullname3(sv, gv, Nullch);
cea2e8a9 79 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nSUB %s = ", SvPVX(sv));
a0d0e21e 80 if (CvXSUB(GvCV(gv)))
894356b3 81 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "(xsub 0x%lx %d)\n",
a0d0e21e 82 (long)CvXSUB(GvCV(gv)),
894356b3 83 (int)CvXSUBANY(GvCV(gv)).any_i32);
85e6fe83 84 else if (CvROOT(GvCV(gv)))
3967c732 85 op_dump(CvROOT(GvCV(gv)));
85e6fe83 86 else
cea2e8a9 87 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
85e6fe83
LW
88}
89
90void
864dbfa3 91Perl_dump_form(pTHX_ GV *gv)
85e6fe83
LW
92{
93 SV *sv = sv_newmortal();
94
f6aff53a 95 gv_fullname3(sv, gv, Nullch);
cea2e8a9 96 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "\nFORMAT %s = ", SvPVX(sv));
85e6fe83 97 if (CvROOT(GvFORM(gv)))
3967c732 98 op_dump(CvROOT(GvFORM(gv)));
85e6fe83 99 else
cea2e8a9 100 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "<undef>\n");
a687059c
LW
101}
102
8adcabd8 103void
864dbfa3 104Perl_dump_eval(pTHX)
8d063cd8 105{
3967c732
JD
106 op_dump(PL_eval_root);
107}
108
109char *
864dbfa3 110Perl_pv_display(pTHX_ SV *sv, char *pv, STRLEN cur, STRLEN len, STRLEN pvlim)
3967c732
JD
111{
112 int truncated = 0;
113 int nul_terminated = len > cur && pv[cur] == '\0';
114
115 sv_setpvn(sv, "\"", 1);
116 for (; cur--; pv++) {
117 if (pvlim && SvCUR(sv) >= pvlim) {
118 truncated++;
119 break;
120 }
121 if (isPRINT(*pv)) {
122 switch (*pv) {
123 case '\t': sv_catpvn(sv, "\\t", 2); break;
124 case '\n': sv_catpvn(sv, "\\n", 2); break;
125 case '\r': sv_catpvn(sv, "\\r", 2); break;
126 case '\f': sv_catpvn(sv, "\\f", 2); break;
127 case '"': sv_catpvn(sv, "\\\"", 2); break;
128 case '\\': sv_catpvn(sv, "\\\\", 2); break;
129 default: sv_catpvn(sv, pv, 1); break;
130 }
131 }
132 else {
133 if (cur && isDIGIT(*(pv+1)))
3818b22b 134 Perl_sv_catpvf(aTHX_ sv, "\\%03o", (U8)*pv);
3967c732 135 else
3818b22b 136 Perl_sv_catpvf(aTHX_ sv, "\\%o", (U8)*pv);
3967c732
JD
137 }
138 }
139 sv_catpvn(sv, "\"", 1);
140 if (truncated)
141 sv_catpvn(sv, "...", 3);
142 if (nul_terminated)
143 sv_catpvn(sv, "\\0", 2);
144
145 return SvPVX(sv);
146}
147
148char *
864dbfa3 149Perl_sv_peek(pTHX_ SV *sv)
3967c732
JD
150{
151 SV *t = sv_newmortal();
2d8e6c8d 152 STRLEN n_a;
3967c732
JD
153 int unref = 0;
154
155 sv_setpvn(t, "", 0);
156 retry:
157 if (!sv) {
158 sv_catpv(t, "VOID");
159 goto finish;
160 }
161 else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
162 sv_catpv(t, "WILD");
163 goto finish;
164 }
165 else if (sv == &PL_sv_undef || sv == &PL_sv_no || sv == &PL_sv_yes) {
166 if (sv == &PL_sv_undef) {
167 sv_catpv(t, "SV_UNDEF");
168 if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
169 SVs_GMG|SVs_SMG|SVs_RMG)) &&
170 SvREADONLY(sv))
171 goto finish;
172 }
173 else if (sv == &PL_sv_no) {
174 sv_catpv(t, "SV_NO");
175 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
176 SVs_GMG|SVs_SMG|SVs_RMG)) &&
177 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
178 SVp_POK|SVp_NOK)) &&
179 SvCUR(sv) == 0 &&
180 SvNVX(sv) == 0.0)
181 goto finish;
182 }
183 else {
184 sv_catpv(t, "SV_YES");
185 if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
186 SVs_GMG|SVs_SMG|SVs_RMG)) &&
187 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
188 SVp_POK|SVp_NOK)) &&
189 SvCUR(sv) == 1 &&
190 SvPVX(sv) && *SvPVX(sv) == '1' &&
191 SvNVX(sv) == 1.0)
192 goto finish;
193 }
194 sv_catpv(t, ":");
195 }
196 else if (SvREFCNT(sv) == 0) {
197 sv_catpv(t, "(");
198 unref++;
199 }
200 if (SvROK(sv)) {
201 sv_catpv(t, "\\");
202 if (SvCUR(t) + unref > 10) {
203 SvCUR(t) = unref + 3;
204 *SvEND(t) = '\0';
205 sv_catpv(t, "...");
206 goto finish;
207 }
208 sv = (SV*)SvRV(sv);
209 goto retry;
210 }
211 switch (SvTYPE(sv)) {
212 default:
213 sv_catpv(t, "FREED");
214 goto finish;
215
216 case SVt_NULL:
217 sv_catpv(t, "UNDEF");
218 goto finish;
219 case SVt_IV:
220 sv_catpv(t, "IV");
221 break;
222 case SVt_NV:
223 sv_catpv(t, "NV");
224 break;
225 case SVt_RV:
226 sv_catpv(t, "RV");
227 break;
228 case SVt_PV:
229 sv_catpv(t, "PV");
230 break;
231 case SVt_PVIV:
232 sv_catpv(t, "PVIV");
233 break;
234 case SVt_PVNV:
235 sv_catpv(t, "PVNV");
236 break;
237 case SVt_PVMG:
238 sv_catpv(t, "PVMG");
239 break;
240 case SVt_PVLV:
241 sv_catpv(t, "PVLV");
242 break;
243 case SVt_PVAV:
244 sv_catpv(t, "AV");
245 break;
246 case SVt_PVHV:
247 sv_catpv(t, "HV");
248 break;
249 case SVt_PVCV:
250 if (CvGV(sv))
cea2e8a9 251 Perl_sv_catpvf(aTHX_ t, "CV(%s)", GvNAME(CvGV(sv)));
3967c732
JD
252 else
253 sv_catpv(t, "CV()");
254 goto finish;
255 case SVt_PVGV:
256 sv_catpv(t, "GV");
257 break;
258 case SVt_PVBM:
259 sv_catpv(t, "BM");
260 break;
261 case SVt_PVFM:
262 sv_catpv(t, "FM");
263 break;
264 case SVt_PVIO:
265 sv_catpv(t, "IO");
266 break;
267 }
268
269 if (SvPOKp(sv)) {
270 if (!SvPVX(sv))
271 sv_catpv(t, "(null)");
272 else {
79cb57f6 273 SV *tmp = newSVpvn("", 0);
3967c732
JD
274 sv_catpv(t, "(");
275 if (SvOOK(sv))
cea2e8a9
GS
276 Perl_sv_catpvf(aTHX_ t, "[%s]", pv_display(tmp, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, 127));
277 Perl_sv_catpvf(aTHX_ t, "%s)", pv_display(tmp, SvPVX(sv), SvCUR(sv), SvLEN(sv), 127));
3967c732
JD
278 SvREFCNT_dec(tmp);
279 }
280 }
281 else if (SvNOKp(sv)) {
097ee67d 282 RESTORE_NUMERIC_STANDARD();
cea2e8a9 283 Perl_sv_catpvf(aTHX_ t, "(%g)",SvNVX(sv));
097ee67d 284 RESTORE_NUMERIC_LOCAL();
3967c732 285 }
57def98f 286 else if (SvIOKp(sv)) {
cf2093f6 287 if (SvIsUV(sv))
57def98f 288 Perl_sv_catpvf(aTHX_ t, "(%"UVuf")", (UV)SvUVX(sv));
cf2093f6 289 else
57def98f 290 Perl_sv_catpvf(aTHX_ t, "(%"IVdf")", (IV)SvIVX(sv));
25da4f38 291 }
3967c732
JD
292 else
293 sv_catpv(t, "()");
294
295 finish:
296 if (unref) {
297 while (unref--)
298 sv_catpv(t, ")");
299 }
2d8e6c8d 300 return SvPV(t, n_a);
3967c732
JD
301}
302
303void
864dbfa3 304Perl_do_pmop_dump(pTHX_ I32 level, PerlIO *file, PMOP *pm)
3967c732
JD
305{
306 char ch;
307
308 if (!pm) {
cea2e8a9 309 Perl_dump_indent(aTHX_ level, file, "{}\n");
3967c732
JD
310 return;
311 }
cea2e8a9 312 Perl_dump_indent(aTHX_ level, file, "{\n");
3967c732
JD
313 level++;
314 if (pm->op_pmflags & PMf_ONCE)
315 ch = '?';
316 else
317 ch = '/';
318 if (pm->op_pmregexp)
cea2e8a9 319 Perl_dump_indent(aTHX_ level, file, "PMf_PRE %c%s%c%s\n",
3967c732
JD
320 ch, pm->op_pmregexp->precomp, ch,
321 (pm->op_private & OPpRUNTIME) ? " (RUNTIME)" : "");
322 else
cea2e8a9 323 Perl_dump_indent(aTHX_ level, file, "PMf_PRE (RUNTIME)\n");
3967c732 324 if (pm->op_type != OP_PUSHRE && pm->op_pmreplroot) {
cea2e8a9 325 Perl_dump_indent(aTHX_ level, file, "PMf_REPL = ");
3967c732
JD
326 op_dump(pm->op_pmreplroot);
327 }
328 if (pm->op_pmflags || (pm->op_pmregexp && pm->op_pmregexp->check_substr)) {
79cb57f6 329 SV *tmpsv = newSVpvn("", 0);
3967c732
JD
330 if (pm->op_pmdynflags & PMdf_USED)
331 sv_catpv(tmpsv, ",USED");
332 if (pm->op_pmdynflags & PMdf_TAINTED)
333 sv_catpv(tmpsv, ",TAINTED");
334 if (pm->op_pmflags & PMf_ONCE)
335 sv_catpv(tmpsv, ",ONCE");
336 if (pm->op_pmregexp && pm->op_pmregexp->check_substr
337 && !(pm->op_pmregexp->reganch & ROPT_NOSCAN))
338 sv_catpv(tmpsv, ",SCANFIRST");
339 if (pm->op_pmregexp && pm->op_pmregexp->check_substr
340 && pm->op_pmregexp->reganch & ROPT_CHECK_ALL)
341 sv_catpv(tmpsv, ",ALL");
342 if (pm->op_pmflags & PMf_SKIPWHITE)
343 sv_catpv(tmpsv, ",SKIPWHITE");
344 if (pm->op_pmflags & PMf_CONST)
345 sv_catpv(tmpsv, ",CONST");
346 if (pm->op_pmflags & PMf_KEEP)
347 sv_catpv(tmpsv, ",KEEP");
348 if (pm->op_pmflags & PMf_GLOBAL)
349 sv_catpv(tmpsv, ",GLOBAL");
350 if (pm->op_pmflags & PMf_CONTINUE)
351 sv_catpv(tmpsv, ",CONTINUE");
352 if (pm->op_pmflags & PMf_RETAINT)
353 sv_catpv(tmpsv, ",RETAINT");
354 if (pm->op_pmflags & PMf_EVAL)
355 sv_catpv(tmpsv, ",EVAL");
cea2e8a9 356 Perl_dump_indent(aTHX_ level, file, "PMFLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
3967c732
JD
357 SvREFCNT_dec(tmpsv);
358 }
359
cea2e8a9 360 Perl_dump_indent(aTHX_ level-1, file, "}\n");
3967c732
JD
361}
362
363void
864dbfa3 364Perl_pmop_dump(pTHX_ PMOP *pm)
3967c732
JD
365{
366 do_pmop_dump(0, Perl_debug_log, pm);
79072805
LW
367}
368
369void
864dbfa3 370Perl_do_op_dump(pTHX_ I32 level, PerlIO *file, OP *o)
79072805 371{
3967c732 372 dTHR;
cea2e8a9 373 Perl_dump_indent(aTHX_ level, file, "{\n");
3967c732 374 level++;
11343788 375 if (o->op_seq)
3967c732 376 PerlIO_printf(file, "%-4d", o->op_seq);
93a17b20 377 else
3967c732 378 PerlIO_printf(file, " ");
c8db6e60
JH
379 PerlIO_printf(file,
380 "%*sTYPE = %s ===> ",
381 (int)(PL_dumpindent*level-4), "", PL_op_name[o->op_type]);
11343788
MB
382 if (o->op_next) {
383 if (o->op_seq)
3967c732 384 PerlIO_printf(file, "%d\n", o->op_next->op_seq);
93a17b20 385 else
3967c732 386 PerlIO_printf(file, "(%d)\n", o->op_next->op_seq);
93a17b20 387 }
79072805 388 else
3967c732 389 PerlIO_printf(file, "DONE\n");
11343788 390 if (o->op_targ) {
acb36ea4 391 if (o->op_type == OP_NULL)
cea2e8a9 392 Perl_dump_indent(aTHX_ level, file, " (was %s)\n", PL_op_name[o->op_targ]);
8990e307 393 else
894356b3 394 Perl_dump_indent(aTHX_ level, file, "TARG = %ld\n", (long)o->op_targ);
8990e307 395 }
748a9306 396#ifdef DUMPADDR
57def98f 397 Perl_dump_indent(aTHX_ level, file, "ADDR = 0x%"UVxf" => 0x%"UVxf"\n", (UV)o, (UV)o->op_next);
79072805 398#endif
11343788 399 if (o->op_flags) {
79cb57f6 400 SV *tmpsv = newSVpvn("", 0);
5dc0d613 401 switch (o->op_flags & OPf_WANT) {
54310121 402 case OPf_WANT_VOID:
46fc3d4c 403 sv_catpv(tmpsv, ",VOID");
54310121 404 break;
405 case OPf_WANT_SCALAR:
46fc3d4c 406 sv_catpv(tmpsv, ",SCALAR");
54310121 407 break;
408 case OPf_WANT_LIST:
46fc3d4c 409 sv_catpv(tmpsv, ",LIST");
54310121 410 break;
411 default:
46fc3d4c 412 sv_catpv(tmpsv, ",UNKNOWN");
54310121 413 break;
414 }
11343788 415 if (o->op_flags & OPf_KIDS)
46fc3d4c 416 sv_catpv(tmpsv, ",KIDS");
11343788 417 if (o->op_flags & OPf_PARENS)
46fc3d4c 418 sv_catpv(tmpsv, ",PARENS");
11343788 419 if (o->op_flags & OPf_STACKED)
46fc3d4c 420 sv_catpv(tmpsv, ",STACKED");
11343788 421 if (o->op_flags & OPf_REF)
46fc3d4c 422 sv_catpv(tmpsv, ",REF");
11343788 423 if (o->op_flags & OPf_MOD)
46fc3d4c 424 sv_catpv(tmpsv, ",MOD");
11343788 425 if (o->op_flags & OPf_SPECIAL)
46fc3d4c 426 sv_catpv(tmpsv, ",SPECIAL");
cea2e8a9 427 Perl_dump_indent(aTHX_ level, file, "FLAGS = (%s)\n", SvCUR(tmpsv) ? SvPVX(tmpsv) + 1 : "");
46fc3d4c 428 SvREFCNT_dec(tmpsv);
79072805 429 }
11343788 430 if (o->op_private) {
79cb57f6 431 SV *tmpsv = newSVpvn("", 0);
07447971
GS
432 if (PL_opargs[o->op_type] & OA_TARGLEX) {
433 if (o->op_private & OPpTARGET_MY)
434 sv_catpv(tmpsv, ",TARGET_MY");
435 }
11343788
MB
436 if (o->op_type == OP_AASSIGN) {
437 if (o->op_private & OPpASSIGN_COMMON)
46fc3d4c 438 sv_catpv(tmpsv, ",COMMON");
10c8fecd
GS
439 if (o->op_private & OPpASSIGN_HASH)
440 sv_catpv(tmpsv, ",HASH");
8d063cd8 441 }
11343788
MB
442 else if (o->op_type == OP_SASSIGN) {
443 if (o->op_private & OPpASSIGN_BACKWARDS)
46fc3d4c 444 sv_catpv(tmpsv, ",BACKWARDS");
a0d0e21e 445 }
11343788
MB
446 else if (o->op_type == OP_TRANS) {
447 if (o->op_private & OPpTRANS_SQUASH)
46fc3d4c 448 sv_catpv(tmpsv, ",SQUASH");
11343788 449 if (o->op_private & OPpTRANS_DELETE)
46fc3d4c 450 sv_catpv(tmpsv, ",DELETE");
11343788 451 if (o->op_private & OPpTRANS_COMPLEMENT)
46fc3d4c 452 sv_catpv(tmpsv, ",COMPLEMENT");
8d063cd8 453 }
11343788
MB
454 else if (o->op_type == OP_REPEAT) {
455 if (o->op_private & OPpREPEAT_DOLIST)
46fc3d4c 456 sv_catpv(tmpsv, ",DOLIST");
8d063cd8 457 }
11343788
MB
458 else if (o->op_type == OP_ENTERSUB ||
459 o->op_type == OP_RV2SV ||
460 o->op_type == OP_RV2AV ||
461 o->op_type == OP_RV2HV ||
462 o->op_type == OP_RV2GV ||
463 o->op_type == OP_AELEM ||
464 o->op_type == OP_HELEM )
85e6fe83 465 {
5dc0d613
MB
466 if (o->op_type == OP_ENTERSUB) {
467 if (o->op_private & OPpENTERSUB_AMPER)
46fc3d4c 468 sv_catpv(tmpsv, ",AMPER");
5dc0d613 469 if (o->op_private & OPpENTERSUB_DB)
46fc3d4c 470 sv_catpv(tmpsv, ",DB");
d3011074
IZ
471 if (o->op_private & OPpENTERSUB_HASTARG)
472 sv_catpv(tmpsv, ",HASTARG");
68dc0745 473 }
d3011074
IZ
474 else
475 switch (o->op_private & OPpDEREF) {
5f05dabc 476 case OPpDEREF_SV:
46fc3d4c 477 sv_catpv(tmpsv, ",SV");
5f05dabc 478 break;
479 case OPpDEREF_AV:
46fc3d4c 480 sv_catpv(tmpsv, ",AV");
5f05dabc 481 break;
482 case OPpDEREF_HV:
46fc3d4c 483 sv_catpv(tmpsv, ",HV");
5f05dabc 484 break;
485 }
5dc0d613
MB
486 if (o->op_type == OP_AELEM || o->op_type == OP_HELEM) {
487 if (o->op_private & OPpLVAL_DEFER)
46fc3d4c 488 sv_catpv(tmpsv, ",LVAL_DEFER");
68dc0745 489 }
490 else {
5dc0d613 491 if (o->op_private & HINT_STRICT_REFS)
46fc3d4c 492 sv_catpv(tmpsv, ",STRICT_REFS");
192587c2
GS
493 if (o->op_private & OPpOUR_INTRO)
494 sv_catpv(tmpsv, ",OUR_INTRO");
68dc0745 495 }
8d063cd8 496 }
11343788
MB
497 else if (o->op_type == OP_CONST) {
498 if (o->op_private & OPpCONST_BARE)
46fc3d4c 499 sv_catpv(tmpsv, ",BARE");
7a52d87a
GS
500 if (o->op_private & OPpCONST_STRICT)
501 sv_catpv(tmpsv, ",STRICT");
79072805 502 }
11343788
MB
503 else if (o->op_type == OP_FLIP) {
504 if (o->op_private & OPpFLIP_LINENUM)
46fc3d4c 505 sv_catpv(tmpsv, ",LINENUM");
79072805 506 }
11343788
MB
507 else if (o->op_type == OP_FLOP) {
508 if (o->op_private & OPpFLIP_LINENUM)
46fc3d4c 509 sv_catpv(tmpsv, ",LINENUM");
cd06dffe
GS
510 } else if (o->op_type == OP_RV2CV) {
511 if (o->op_private & OPpLVAL_INTRO)
512 sv_catpv(tmpsv, ",INTRO");
79072805 513 }
11343788 514 if (o->op_flags & OPf_MOD && o->op_private & OPpLVAL_INTRO)
46fc3d4c 515 sv_catpv(tmpsv, ",INTRO");
516 if (SvCUR(tmpsv))
cea2e8a9 517 Perl_dump_indent(aTHX_ level, file, "PRIVATE = (%s)\n", SvPVX(tmpsv) + 1);
46fc3d4c 518 SvREFCNT_dec(tmpsv);
8d063cd8 519 }
8d063cd8 520
11343788 521 switch (o->op_type) {
971a9dd3 522 case OP_AELEMFAST:
93a17b20 523 case OP_GVSV:
79072805 524 case OP_GV:
971a9dd3
GS
525#ifdef USE_ITHREADS
526 Perl_dump_indent(aTHX_ level, file, "PADIX = %d\n", cPADOPo->op_padix);
527#else
528 if (cSVOPo->op_sv) {
46fc3d4c 529 SV *tmpsv = NEWSV(0,0);
155aba94 530 STRLEN n_a;
8990e307 531 ENTER;
8990e307 532 SAVEFREESV(tmpsv);
971a9dd3 533 gv_fullname3(tmpsv, (GV*)cSVOPo->op_sv, Nullch);
cea2e8a9 534 Perl_dump_indent(aTHX_ level, file, "GV = %s\n", SvPV(tmpsv, n_a));
8990e307 535 LEAVE;
378cc40b 536 }
79072805 537 else
cea2e8a9 538 Perl_dump_indent(aTHX_ level, file, "GV = NULL\n");
971a9dd3 539#endif
79072805
LW
540 break;
541 case OP_CONST:
f5d5a27c 542 case OP_METHOD_NAMED:
cea2e8a9 543 Perl_dump_indent(aTHX_ level, file, "SV = %s\n", SvPEEK(cSVOPo->op_sv));
79072805 544 break;
7399586d 545 case OP_SETSTATE:
93a17b20
LW
546 case OP_NEXTSTATE:
547 case OP_DBSTATE:
57843af0
GS
548 if (CopLINE(cCOPo))
549 Perl_dump_indent(aTHX_ level, file, "LINE = %d\n",CopLINE(cCOPo));
ed094faf
GS
550 if (CopSTASHPV(cCOPo))
551 Perl_dump_indent(aTHX_ level, file, "PACKAGE = \"%s\"\n",
552 CopSTASHPV(cCOPo));
11343788 553 if (cCOPo->cop_label)
ed094faf
GS
554 Perl_dump_indent(aTHX_ level, file, "LABEL = \"%s\"\n",
555 cCOPo->cop_label);
79072805
LW
556 break;
557 case OP_ENTERLOOP:
cea2e8a9 558 Perl_dump_indent(aTHX_ level, file, "REDO ===> ");
11343788 559 if (cLOOPo->op_redoop)
3967c732 560 PerlIO_printf(file, "%d\n", cLOOPo->op_redoop->op_seq);
79072805 561 else
3967c732 562 PerlIO_printf(file, "DONE\n");
cea2e8a9 563 Perl_dump_indent(aTHX_ level, file, "NEXT ===> ");
11343788 564 if (cLOOPo->op_nextop)
3967c732 565 PerlIO_printf(file, "%d\n", cLOOPo->op_nextop->op_seq);
79072805 566 else
3967c732 567 PerlIO_printf(file, "DONE\n");
cea2e8a9 568 Perl_dump_indent(aTHX_ level, file, "LAST ===> ");
11343788 569 if (cLOOPo->op_lastop)
3967c732 570 PerlIO_printf(file, "%d\n", cLOOPo->op_lastop->op_seq);
79072805 571 else
3967c732 572 PerlIO_printf(file, "DONE\n");
79072805
LW
573 break;
574 case OP_COND_EXPR:
1a67a97c 575 case OP_RANGE:
a0d0e21e 576 case OP_MAPWHILE:
79072805
LW
577 case OP_GREPWHILE:
578 case OP_OR:
579 case OP_AND:
cea2e8a9 580 Perl_dump_indent(aTHX_ level, file, "OTHER ===> ");
11343788 581 if (cLOGOPo->op_other)
3967c732 582 PerlIO_printf(file, "%d\n", cLOGOPo->op_other->op_seq);
79072805 583 else
3967c732 584 PerlIO_printf(file, "DONE\n");
79072805
LW
585 break;
586 case OP_PUSHRE:
587 case OP_MATCH:
8782bef2 588 case OP_QR:
79072805 589 case OP_SUBST:
3967c732 590 do_pmop_dump(level, file, cPMOPo);
79072805 591 break;
7934575e
GS
592 case OP_LEAVE:
593 case OP_LEAVEEVAL:
594 case OP_LEAVESUB:
595 case OP_LEAVESUBLV:
596 case OP_LEAVEWRITE:
597 case OP_SCOPE:
598 if (o->op_private & OPpREFCOUNTED)
599 Perl_dump_indent(aTHX_ level, file, "REFCNT = %"UVuf"\n", (UV)o->op_targ);
600 break;
a0d0e21e
LW
601 default:
602 break;
79072805 603 }
11343788 604 if (o->op_flags & OPf_KIDS) {
79072805 605 OP *kid;
11343788 606 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
3967c732 607 do_op_dump(level, file, kid);
8d063cd8 608 }
cea2e8a9 609 Perl_dump_indent(aTHX_ level-1, file, "}\n");
3967c732
JD
610}
611
612void
864dbfa3 613Perl_op_dump(pTHX_ OP *o)
3967c732
JD
614{
615 do_op_dump(0, Perl_debug_log, o);
8d063cd8
LW
616}
617
8adcabd8 618void
864dbfa3 619Perl_gv_dump(pTHX_ GV *gv)
378cc40b 620{
79072805 621 SV *sv;
378cc40b 622
79072805 623 if (!gv) {
760ac839 624 PerlIO_printf(Perl_debug_log, "{}\n");
378cc40b
LW
625 return;
626 }
8990e307 627 sv = sv_newmortal();
760ac839 628 PerlIO_printf(Perl_debug_log, "{\n");
f6aff53a 629 gv_fullname3(sv, gv, Nullch);
cea2e8a9 630 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "GV_NAME = %s", SvPVX(sv));
79072805 631 if (gv != GvEGV(gv)) {
f6aff53a 632 gv_efullname3(sv, GvEGV(gv), Nullch);
cea2e8a9 633 Perl_dump_indent(aTHX_ 1, Perl_debug_log, "-> %s", SvPVX(sv));
8adcabd8 634 }
3967c732 635 PerlIO_putc(Perl_debug_log, '\n');
cea2e8a9 636 Perl_dump_indent(aTHX_ 0, Perl_debug_log, "}\n");
8d063cd8
LW
637}
638
8adcabd8 639void
864dbfa3 640Perl_do_magic_dump(pTHX_ I32 level, PerlIO *file, MAGIC *mg, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
8d063cd8 641{
3967c732 642 for (; mg; mg = mg->mg_moremagic) {
b900a521
JH
643 Perl_dump_indent(aTHX_ level, file,
644 " MAGIC = 0x%"UVxf"\n", PTR2UV(mg));
3967c732
JD
645 if (mg->mg_virtual) {
646 MGVTBL *v = mg->mg_virtual;
647 char *s = 0;
648 if (v == &PL_vtbl_sv) s = "sv";
649 else if (v == &PL_vtbl_env) s = "env";
650 else if (v == &PL_vtbl_envelem) s = "envelem";
651 else if (v == &PL_vtbl_sig) s = "sig";
652 else if (v == &PL_vtbl_sigelem) s = "sigelem";
653 else if (v == &PL_vtbl_pack) s = "pack";
654 else if (v == &PL_vtbl_packelem) s = "packelem";
655 else if (v == &PL_vtbl_dbline) s = "dbline";
656 else if (v == &PL_vtbl_isa) s = "isa";
657 else if (v == &PL_vtbl_arylen) s = "arylen";
658 else if (v == &PL_vtbl_glob) s = "glob";
659 else if (v == &PL_vtbl_mglob) s = "mglob";
660 else if (v == &PL_vtbl_nkeys) s = "nkeys";
661 else if (v == &PL_vtbl_taint) s = "taint";
662 else if (v == &PL_vtbl_substr) s = "substr";
663 else if (v == &PL_vtbl_vec) s = "vec";
664 else if (v == &PL_vtbl_pos) s = "pos";
665 else if (v == &PL_vtbl_bm) s = "bm";
666 else if (v == &PL_vtbl_fm) s = "fm";
667 else if (v == &PL_vtbl_uvar) s = "uvar";
668 else if (v == &PL_vtbl_defelem) s = "defelem";
669#ifdef USE_LOCALE_COLLATE
670 else if (v == &PL_vtbl_collxfrm) s = "collxfrm";
671#endif
3967c732
JD
672 else if (v == &PL_vtbl_amagic) s = "amagic";
673 else if (v == &PL_vtbl_amagicelem) s = "amagicelem";
810b8aa5 674 else if (v == &PL_vtbl_backref) s = "backref";
3967c732 675 if (s)
cea2e8a9 676 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = &PL_vtbl_%s\n", s);
3967c732 677 else
b900a521 678 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0x%"UVxf"\n", PTR2UV(v));
3967c732
JD
679 }
680 else
cea2e8a9 681 Perl_dump_indent(aTHX_ level, file, " MG_VIRTUAL = 0\n");
8d063cd8 682
3967c732 683 if (mg->mg_private)
cea2e8a9 684 Perl_dump_indent(aTHX_ level, file, " MG_PRIVATE = %d\n", mg->mg_private);
3967c732
JD
685
686 if (isPRINT(mg->mg_type))
cea2e8a9 687 Perl_dump_indent(aTHX_ level, file, " MG_TYPE = '%c'\n", mg->mg_type);
3967c732 688 else
cea2e8a9 689 Perl_dump_indent(aTHX_ level, file, " MG_TYPE = '\\%o'\n", mg->mg_type);
3967c732
JD
690
691 if (mg->mg_flags) {
cea2e8a9 692 Perl_dump_indent(aTHX_ level, file, " MG_FLAGS = 0x%02X\n", mg->mg_flags);
3967c732 693 if (mg->mg_flags & MGf_TAINTEDDIR)
cea2e8a9 694 Perl_dump_indent(aTHX_ level, file, " TAINTEDDIR\n");
3967c732 695 if (mg->mg_flags & MGf_REFCOUNTED)
cea2e8a9 696 Perl_dump_indent(aTHX_ level, file, " REFCOUNTED\n");
3967c732 697 if (mg->mg_flags & MGf_GSKIP)
cea2e8a9 698 Perl_dump_indent(aTHX_ level, file, " GSKIP\n");
3967c732 699 if (mg->mg_flags & MGf_MINMATCH)
cea2e8a9 700 Perl_dump_indent(aTHX_ level, file, " MINMATCH\n");
3967c732
JD
701 }
702 if (mg->mg_obj) {
b900a521 703 Perl_dump_indent(aTHX_ level, file, " MG_OBJ = 0x%"UVxf"\n", PTR2UV(mg->mg_obj));
3967c732
JD
704 if (mg->mg_flags & MGf_REFCOUNTED)
705 do_sv_dump(level+2, file, mg->mg_obj, nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
706 }
707 if (mg->mg_len)
894356b3 708 Perl_dump_indent(aTHX_ level, file, " MG_LEN = %ld\n", (long)mg->mg_len);
3967c732 709 if (mg->mg_ptr) {
b900a521 710 Perl_dump_indent(aTHX_ level, file, " MG_PTR = 0x%"UVxf, PTR2UV(mg->mg_ptr));
3967c732 711 if (mg->mg_len >= 0) {
79cb57f6 712 SV *sv = newSVpvn("", 0);
3967c732
JD
713 PerlIO_printf(file, " %s", pv_display(sv, mg->mg_ptr, mg->mg_len, 0, pvlim));
714 SvREFCNT_dec(sv);
715 }
716 else if (mg->mg_len == HEf_SVKEY) {
717 PerlIO_puts(file, " => HEf_SVKEY\n");
718 do_sv_dump(level+2, file, (SV*)((mg)->mg_ptr), nest+1, maxnest, dumpops, pvlim); /* MG is already +1 */
719 continue;
720 }
721 else
722 PerlIO_puts(file, " ???? - please notify IZ");
723 PerlIO_putc(file, '\n');
724 }
378cc40b 725 }
3967c732
JD
726}
727
728void
864dbfa3 729Perl_magic_dump(pTHX_ MAGIC *mg)
3967c732
JD
730{
731 do_magic_dump(0, Perl_debug_log, mg, 0, 0, 0, 0);
732}
733
734void
864dbfa3 735Perl_do_hv_dump(pTHX_ I32 level, PerlIO *file, char *name, HV *sv)
3967c732 736{
b900a521 737 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
3967c732
JD
738 if (sv && HvNAME(sv))
739 PerlIO_printf(file, "\t\"%s\"\n", HvNAME(sv));
79072805 740 else
3967c732
JD
741 PerlIO_putc(file, '\n');
742}
743
744void
864dbfa3 745Perl_do_gv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
3967c732 746{
b900a521 747 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
3967c732
JD
748 if (sv && GvNAME(sv))
749 PerlIO_printf(file, "\t\"%s\"\n", GvNAME(sv));
c90c0ff4 750 else
3967c732
JD
751 PerlIO_putc(file, '\n');
752}
753
754void
864dbfa3 755Perl_do_gvgv_dump(pTHX_ I32 level, PerlIO *file, char *name, GV *sv)
3967c732 756{
b900a521 757 Perl_dump_indent(aTHX_ level, file, "%s = 0x%"UVxf, name, PTR2UV(sv));
3967c732
JD
758 if (sv && GvNAME(sv)) {
759 PerlIO_printf(file, "\t\"");
760 if (GvSTASH(sv) && HvNAME(GvSTASH(sv)))
761 PerlIO_printf(file, "%s\" :: \"", HvNAME(GvSTASH(sv)));
762 PerlIO_printf(file, "%s\"\n", GvNAME(sv));
8d063cd8 763 }
3967c732
JD
764 else
765 PerlIO_putc(file, '\n');
766}
767
768void
864dbfa3 769Perl_do_sv_dump(pTHX_ I32 level, PerlIO *file, SV *sv, I32 nest, I32 maxnest, bool dumpops, STRLEN pvlim)
3967c732
JD
770{
771 dTHR;
cea89e20 772 SV *d;
3967c732
JD
773 char *s;
774 U32 flags;
775 U32 type;
2d8e6c8d 776 STRLEN n_a;
3967c732
JD
777
778 if (!sv) {
cea2e8a9 779 Perl_dump_indent(aTHX_ level, file, "SV = 0\n");
3967c732 780 return;
378cc40b 781 }
3967c732
JD
782
783 flags = SvFLAGS(sv);
784 type = SvTYPE(sv);
79072805 785
cea89e20 786 d = Perl_newSVpvf(aTHX_
57def98f 787 "(0x%"UVxf") at 0x%"UVxf"\n%*s REFCNT = %"IVdf"\n%*s FLAGS = (",
56431972 788 PTR2UV(SvANY(sv)), PTR2UV(sv),
894356b3
GS
789 (int)(PL_dumpindent*level), "", (IV)SvREFCNT(sv),
790 (int)(PL_dumpindent*level), "");
8d063cd8 791
3967c732
JD
792 if (flags & SVs_PADBUSY) sv_catpv(d, "PADBUSY,");
793 if (flags & SVs_PADTMP) sv_catpv(d, "PADTMP,");
794 if (flags & SVs_PADMY) sv_catpv(d, "PADMY,");
795 if (flags & SVs_TEMP) sv_catpv(d, "TEMP,");
796 if (flags & SVs_OBJECT) sv_catpv(d, "OBJECT,");
797 if (flags & SVs_GMG) sv_catpv(d, "GMG,");
798 if (flags & SVs_SMG) sv_catpv(d, "SMG,");
799 if (flags & SVs_RMG) sv_catpv(d, "RMG,");
4db58590 800
3967c732
JD
801 if (flags & SVf_IOK) sv_catpv(d, "IOK,");
802 if (flags & SVf_NOK) sv_catpv(d, "NOK,");
803 if (flags & SVf_POK) sv_catpv(d, "POK,");
810b8aa5
GS
804 if (flags & SVf_ROK) {
805 sv_catpv(d, "ROK,");
806 if (SvWEAKREF(sv)) sv_catpv(d, "WEAKREF,");
807 }
3967c732
JD
808 if (flags & SVf_OOK) sv_catpv(d, "OOK,");
809 if (flags & SVf_FAKE) sv_catpv(d, "FAKE,");
810 if (flags & SVf_READONLY) sv_catpv(d, "READONLY,");
4db58590 811
3967c732 812 if (flags & SVf_AMAGIC) sv_catpv(d, "OVERLOAD,");
3967c732
JD
813 if (flags & SVp_IOK) sv_catpv(d, "pIOK,");
814 if (flags & SVp_NOK) sv_catpv(d, "pNOK,");
815 if (flags & SVp_POK) sv_catpv(d, "pPOK,");
816 if (flags & SVp_SCREAM) sv_catpv(d, "SCREAM,");
817
818 switch (type) {
819 case SVt_PVCV:
820 case SVt_PVFM:
821 if (CvANON(sv)) sv_catpv(d, "ANON,");
822 if (CvUNIQUE(sv)) sv_catpv(d, "UNIQUE,");
823 if (CvCLONE(sv)) sv_catpv(d, "CLONE,");
824 if (CvCLONED(sv)) sv_catpv(d, "CLONED,");
825 if (CvNODEBUG(sv)) sv_catpv(d, "NODEBUG,");
25da4f38 826 if (SvCOMPILED(sv)) sv_catpv(d, "COMPILED,");
3967c732
JD
827 break;
828 case SVt_PVHV:
829 if (HvSHAREKEYS(sv)) sv_catpv(d, "SHAREKEYS,");
830 if (HvLAZYDEL(sv)) sv_catpv(d, "LAZYDEL,");
831 break;
832 case SVt_PVGV:
833 if (GvINTRO(sv)) sv_catpv(d, "INTRO,");
834 if (GvMULTI(sv)) sv_catpv(d, "MULTI,");
835 if (GvASSUMECV(sv)) sv_catpv(d, "ASSUMECV,");
836 if (GvIMPORTED(sv)) {
837 sv_catpv(d, "IMPORT");
838 if (GvIMPORTED(sv) == GVf_IMPORTED)
839 sv_catpv(d, "ALL,");
840 else {
841 sv_catpv(d, "(");
842 if (GvIMPORTED_SV(sv)) sv_catpv(d, " SV");
843 if (GvIMPORTED_AV(sv)) sv_catpv(d, " AV");
844 if (GvIMPORTED_HV(sv)) sv_catpv(d, " HV");
845 if (GvIMPORTED_CV(sv)) sv_catpv(d, " CV");
846 sv_catpv(d, " ),");
847 }
848 }
25da4f38
IZ
849 /* FALL THROGH */
850 default:
851 if (SvEVALED(sv)) sv_catpv(d, "EVALED,");
852 if (SvIsUV(sv)) sv_catpv(d, "IsUV,");
3818b22b 853 if (SvUTF8(sv)) sv_catpv(d, "UTF8");
25da4f38 854 break;
3967c732
JD
855 case SVt_PVBM:
856 if (SvTAIL(sv)) sv_catpv(d, "TAIL,");
25da4f38 857 if (SvVALID(sv)) sv_catpv(d, "VALID,");
3967c732
JD
858 break;
859 }
860
861 if (*(SvEND(d) - 1) == ',')
862 SvPVX(d)[--SvCUR(d)] = '\0';
863 sv_catpv(d, ")");
864 s = SvPVX(d);
865
cea2e8a9 866 Perl_dump_indent(aTHX_ level, file, "SV = ");
3967c732
JD
867 switch (type) {
868 case SVt_NULL:
869 PerlIO_printf(file, "NULL%s\n", s);
cea89e20 870 SvREFCNT_dec(d);
3967c732
JD
871 return;
872 case SVt_IV:
873 PerlIO_printf(file, "IV%s\n", s);
874 break;
875 case SVt_NV:
876 PerlIO_printf(file, "NV%s\n", s);
877 break;
878 case SVt_RV:
879 PerlIO_printf(file, "RV%s\n", s);
880 break;
881 case SVt_PV:
882 PerlIO_printf(file, "PV%s\n", s);
883 break;
884 case SVt_PVIV:
885 PerlIO_printf(file, "PVIV%s\n", s);
886 break;
887 case SVt_PVNV:
888 PerlIO_printf(file, "PVNV%s\n", s);
889 break;
890 case SVt_PVBM:
891 PerlIO_printf(file, "PVBM%s\n", s);
892 break;
893 case SVt_PVMG:
894 PerlIO_printf(file, "PVMG%s\n", s);
895 break;
896 case SVt_PVLV:
897 PerlIO_printf(file, "PVLV%s\n", s);
898 break;
899 case SVt_PVAV:
900 PerlIO_printf(file, "PVAV%s\n", s);
901 break;
902 case SVt_PVHV:
903 PerlIO_printf(file, "PVHV%s\n", s);
904 break;
905 case SVt_PVCV:
906 PerlIO_printf(file, "PVCV%s\n", s);
907 break;
908 case SVt_PVGV:
909 PerlIO_printf(file, "PVGV%s\n", s);
910 break;
911 case SVt_PVFM:
912 PerlIO_printf(file, "PVFM%s\n", s);
913 break;
914 case SVt_PVIO:
915 PerlIO_printf(file, "PVIO%s\n", s);
916 break;
917 default:
faccc32b 918 PerlIO_printf(file, "UNKNOWN(0x%"UVxf") %s\n", (UV)type, s);
cea89e20 919 SvREFCNT_dec(d);
3967c732
JD
920 return;
921 }
922 if (type >= SVt_PVIV || type == SVt_IV) {
cf2093f6 923 if (SvIsUV(sv))
57def98f 924 Perl_dump_indent(aTHX_ level, file, " UV = %"UVuf, (UV)SvUVX(sv));
cf2093f6 925 else
57def98f 926 Perl_dump_indent(aTHX_ level, file, " IV = %"IVdf, (IV)SvIVX(sv));
3967c732
JD
927 if (SvOOK(sv))
928 PerlIO_printf(file, " (OFFSET)");
929 PerlIO_putc(file, '\n');
930 }
931 if (type >= SVt_PVNV || type == SVt_NV) {
097ee67d 932 RESTORE_NUMERIC_STANDARD();
57def98f 933 /* %Vg doesn't work? --jhi */
cf2093f6 934#ifdef USE_LONG_DOUBLE
2d4389e4 935 Perl_dump_indent(aTHX_ level, file, " NV = %.*" PERL_PRIgldbl "\n", LDBL_DIG, SvNVX(sv));
cf2093f6 936#else
cea2e8a9 937 Perl_dump_indent(aTHX_ level, file, " NV = %.*g\n", DBL_DIG, SvNVX(sv));
cf2093f6 938#endif
097ee67d 939 RESTORE_NUMERIC_LOCAL();
3967c732
JD
940 }
941 if (SvROK(sv)) {
57def98f 942 Perl_dump_indent(aTHX_ level, file, " RV = 0x%"UVxf"\n", PTR2UV(SvRV(sv)));
3967c732
JD
943 if (nest < maxnest)
944 do_sv_dump(level+1, file, SvRV(sv), nest+1, maxnest, dumpops, pvlim);
cea89e20 945 SvREFCNT_dec(d);
3967c732
JD
946 return;
947 }
cea89e20
JH
948 if (type < SVt_PV) {
949 SvREFCNT_dec(d);
3967c732 950 return;
cea89e20 951 }
3967c732
JD
952 if (type <= SVt_PVLV) {
953 if (SvPVX(sv)) {
57def98f 954 Perl_dump_indent(aTHX_ level, file," PV = 0x%"UVxf" ", PTR2UV(SvPVX(sv)));
3967c732
JD
955 if (SvOOK(sv))
956 PerlIO_printf(file, "( %s . ) ", pv_display(d, SvPVX(sv)-SvIVX(sv), SvIVX(sv), 0, pvlim));
957 PerlIO_printf(file, "%s\n", pv_display(d, SvPVX(sv), SvCUR(sv), SvLEN(sv), pvlim));
57def98f
JH
958 Perl_dump_indent(aTHX_ level, file, " CUR = %"IVdf"\n", (IV)SvCUR(sv));
959 Perl_dump_indent(aTHX_ level, file, " LEN = %"IVdf"\n", (IV)SvLEN(sv));
3967c732
JD
960 }
961 else
cea2e8a9 962 Perl_dump_indent(aTHX_ level, file, " PV = 0\n");
3967c732
JD
963 }
964 if (type >= SVt_PVMG) {
965 if (SvMAGIC(sv))
966 do_magic_dump(level, file, SvMAGIC(sv), nest, maxnest, dumpops, pvlim);
967 if (SvSTASH(sv))
968 do_hv_dump(level, file, " STASH", SvSTASH(sv));
969 }
970 switch (type) {
971 case SVt_PVLV:
cea2e8a9 972 Perl_dump_indent(aTHX_ level, file, " TYPE = %c\n", LvTYPE(sv));
57def98f
JH
973 Perl_dump_indent(aTHX_ level, file, " TARGOFF = %"IVdf"\n", (IV)LvTARGOFF(sv));
974 Perl_dump_indent(aTHX_ level, file, " TARGLEN = %"IVdf"\n", (IV)LvTARGLEN(sv));
975 Perl_dump_indent(aTHX_ level, file, " TARG = 0x%"UVxf"\n", PTR2UV(LvTARG(sv)));
3967c732
JD
976 /* XXX level+1 ??? */
977 do_sv_dump(level, file, LvTARG(sv), nest+1, maxnest, dumpops, pvlim);
978 break;
979 case SVt_PVAV:
57def98f 980 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(AvARRAY(sv)));
3967c732 981 if (AvARRAY(sv) != AvALLOC(sv)) {
57def98f
JH
982 PerlIO_printf(file, " (offset=%"IVdf")\n", (IV)(AvARRAY(sv) - AvALLOC(sv)));
983 Perl_dump_indent(aTHX_ level, file, " ALLOC = 0x%"UVxf"\n", PTR2UV(AvALLOC(sv)));
3967c732
JD
984 }
985 else
986 PerlIO_putc(file, '\n');
57def98f
JH
987 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)AvFILLp(sv));
988 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)AvMAX(sv));
989 Perl_dump_indent(aTHX_ level, file, " ARYLEN = 0x%"UVxf"\n", PTR2UV(AvARYLEN(sv)));
3967c732
JD
990 flags = AvFLAGS(sv);
991 sv_setpv(d, "");
992 if (flags & AVf_REAL) sv_catpv(d, ",REAL");
993 if (flags & AVf_REIFY) sv_catpv(d, ",REIFY");
994 if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
cea2e8a9 995 Perl_dump_indent(aTHX_ level, file, " FLAGS = (%s)\n", SvCUR(d) ? SvPVX(d) + 1 : "");
3967c732
JD
996 if (nest < maxnest && av_len((AV*)sv) >= 0) {
997 int count;
998 for (count = 0; count <= av_len((AV*)sv) && count < maxnest; count++) {
999 SV** elt = av_fetch((AV*)sv,count,0);
1000
57def98f 1001 Perl_dump_indent(aTHX_ level + 1, file, "Elt No. %"IVdf"\n", (IV)count);
3967c732
JD
1002 if (elt)
1003 do_sv_dump(level+1, file, *elt, nest+1, maxnest, dumpops, pvlim);
1004 }
1005 }
1006 break;
1007 case SVt_PVHV:
57def98f 1008 Perl_dump_indent(aTHX_ level, file, " ARRAY = 0x%"UVxf, PTR2UV(HvARRAY(sv)));
3967c732
JD
1009 if (HvARRAY(sv) && HvKEYS(sv)) {
1010 /* Show distribution of HEs in the ARRAY */
1011 int freq[200];
1012#define FREQ_MAX (sizeof freq / sizeof freq[0] - 1)
1013 int i;
1014 int max = 0;
1015 U32 pow2 = 2, keys = HvKEYS(sv);
65202027 1016 NV theoret, sum = 0;
3967c732
JD
1017
1018 PerlIO_printf(file, " (");
1019 Zero(freq, FREQ_MAX + 1, int);
1020 for (i = 0; i <= HvMAX(sv); i++) {
1021 HE* h; int count = 0;
1022 for (h = HvARRAY(sv)[i]; h; h = HeNEXT(h))
1023 count++;
1024 if (count > FREQ_MAX)
1025 count = FREQ_MAX;
1026 freq[count]++;
1027 if (max < count)
1028 max = count;
1029 }
1030 for (i = 0; i <= max; i++) {
1031 if (freq[i]) {
1032 PerlIO_printf(file, "%d%s:%d", i,
1033 (i == FREQ_MAX) ? "+" : "",
1034 freq[i]);
1035 if (i != max)
1036 PerlIO_printf(file, ", ");
1037 }
1038 }
1039 PerlIO_putc(file, ')');
1040 /* Now calculate quality wrt theoretical value */
1041 for (i = max; i > 0; i--) { /* Precision: count down. */
1042 sum += freq[i] * i * i;
1043 }
155aba94 1044 while ((keys = keys >> 1))
3967c732
JD
1045 pow2 = pow2 << 1;
1046 /* Approximate by Poisson distribution */
1047 theoret = HvKEYS(sv);
1048 theoret += theoret * theoret/pow2;
1049 PerlIO_putc(file, '\n');
cea2e8a9 1050 Perl_dump_indent(aTHX_ level, file, " hash quality = %.1f%%", theoret/sum*100);
3967c732
JD
1051 }
1052 PerlIO_putc(file, '\n');
57def98f
JH
1053 Perl_dump_indent(aTHX_ level, file, " KEYS = %"IVdf"\n", (IV)HvKEYS(sv));
1054 Perl_dump_indent(aTHX_ level, file, " FILL = %"IVdf"\n", (IV)HvFILL(sv));
1055 Perl_dump_indent(aTHX_ level, file, " MAX = %"IVdf"\n", (IV)HvMAX(sv));
1056 Perl_dump_indent(aTHX_ level, file, " RITER = %"IVdf"\n", (IV)HvRITER(sv));
1057 Perl_dump_indent(aTHX_ level, file, " EITER = 0x%"UVxf"\n", PTR2UV(HvEITER(sv)));
3967c732 1058 if (HvPMROOT(sv))
57def98f 1059 Perl_dump_indent(aTHX_ level, file, " PMROOT = 0x%"UVxf"\n", PTR2UV(HvPMROOT(sv)));
3967c732 1060 if (HvNAME(sv))
cea2e8a9 1061 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", HvNAME(sv));
3967c732
JD
1062 if (nest < maxnest && !HvEITER(sv)) { /* Try to preserve iterator */
1063 HE *he;
1064 HV *hv = (HV*)sv;
1065 int count = maxnest - nest;
1066
1067 hv_iterinit(hv);
1068 while ((he = hv_iternext(hv)) && count--) {
1069 SV *elt;
1070 char *key;
1071 I32 len;
1072 U32 hash = HeHASH(he);
1073
1074 key = hv_iterkey(he, &len);
1075 elt = hv_iterval(hv, he);
57def98f 1076 Perl_dump_indent(aTHX_ level+1, file, "Elt %s HASH = 0x%"UVxf"\n", pv_display(d, key, len, 0, pvlim), (UV)hash);
3967c732
JD
1077 do_sv_dump(level+1, file, elt, nest+1, maxnest, dumpops, pvlim);
1078 }
1079 hv_iterinit(hv); /* Return to status quo */
1080 }
1081 break;
1082 case SVt_PVCV:
1083 if (SvPOK(sv))
cea2e8a9 1084 Perl_dump_indent(aTHX_ level, file, " PROTOTYPE = \"%s\"\n", SvPV(sv,n_a));
3967c732
JD
1085 /* FALL THROUGH */
1086 case SVt_PVFM:
1087 do_hv_dump(level, file, " COMP_STASH", CvSTASH(sv));
1088 if (CvSTART(sv))
57def98f
JH
1089 Perl_dump_indent(aTHX_ level, file, " START = 0x%"UVxf" ===> %"IVdf"\n", PTR2UV(CvSTART(sv)), (IV)CvSTART(sv)->op_seq);
1090 Perl_dump_indent(aTHX_ level, file, " ROOT = 0x%"UVxf"\n", PTR2UV(CvROOT(sv)));
3967c732
JD
1091 if (CvROOT(sv) && dumpops)
1092 do_op_dump(level+1, file, CvROOT(sv));
57def98f
JH
1093 Perl_dump_indent(aTHX_ level, file, " XSUB = 0x%"UVxf"\n", PTR2UV(CvXSUB(sv)));
1094 Perl_dump_indent(aTHX_ level, file, " XSUBANY = %"IVdf"\n", (IV)CvXSUBANY(sv).any_i32);
3967c732 1095 do_gvgv_dump(level, file, " GVGV::GV", CvGV(sv));
57843af0 1096 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", CvFILE(sv));
57def98f 1097 Perl_dump_indent(aTHX_ level, file, " DEPTH = %"IVdf"\n", (IV)CvDEPTH(sv));
3967c732 1098#ifdef USE_THREADS
07270b1a
GS
1099 Perl_dump_indent(aTHX_ level, file, " MUTEXP = 0x%"UVxf"\n", PTR2UV(CvMUTEXP(sv)));
1100 Perl_dump_indent(aTHX_ level, file, " OWNER = 0x%"UVxf"\n", PTR2UV(CvOWNER(sv)));
3967c732 1101#endif /* USE_THREADS */
894356b3 1102 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)CvFLAGS(sv));
3967c732 1103 if (type == SVt_PVFM)
57def98f
JH
1104 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)FmLINES(sv));
1105 Perl_dump_indent(aTHX_ level, file, " PADLIST = 0x%"UVxf"\n", PTR2UV(CvPADLIST(sv)));
3967c732
JD
1106 if (nest < maxnest && CvPADLIST(sv)) {
1107 AV* padlist = CvPADLIST(sv);
1108 AV* pad_name = (AV*)*av_fetch(padlist, 0, FALSE);
1109 AV* pad = (AV*)*av_fetch(padlist, 1, FALSE);
1110 SV** pname = AvARRAY(pad_name);
1111 SV** ppad = AvARRAY(pad);
1112 I32 ix;
1113
1114 for (ix = 1; ix <= AvFILL(pad_name); ix++) {
b9c39e73 1115 if (SvPOK(pname[ix]))
57def98f
JH
1116 Perl_dump_indent(aTHX_ level,
1117 /* %5d below is enough whitespace. */
cf2093f6 1118 file,
57def98f 1119 "%5d. 0x%"UVxf" (%s\"%s\" %"IVdf"-%"IVdf")\n",
894356b3 1120 (int)ix, PTR2UV(ppad[ix]),
cf2093f6
JH
1121 SvFAKE(pname[ix]) ? "FAKE " : "",
1122 SvPVX(pname[ix]),
1123 (IV)SvNVX(pname[ix]),
1124 (IV)SvIVX(pname[ix]));
3967c732
JD
1125 }
1126 }
1127 {
1128 CV *outside = CvOUTSIDE(sv);
57def98f
JH
1129 Perl_dump_indent(aTHX_ level, file, " OUTSIDE = 0x%"UVxf" (%s)\n",
1130 PTR2UV(outside),
cf2093f6
JH
1131 (!outside ? "null"
1132 : CvANON(outside) ? "ANON"
1133 : (outside == PL_main_cv) ? "MAIN"
1134 : CvUNIQUE(outside) ? "UNIQUE"
1135 : CvGV(outside) ? GvNAME(CvGV(outside)) : "UNDEFINED"));
3967c732
JD
1136 }
1137 if (nest < maxnest && (CvCLONE(sv) || CvCLONED(sv)))
1138 do_sv_dump(level+1, file, (SV*)CvOUTSIDE(sv), nest+1, maxnest, dumpops, pvlim);
1139 break;
1140 case SVt_PVGV:
cea2e8a9 1141 Perl_dump_indent(aTHX_ level, file, " NAME = \"%s\"\n", GvNAME(sv));
57def98f 1142 Perl_dump_indent(aTHX_ level, file, " NAMELEN = %"IVdf"\n", (IV)GvNAMELEN(sv));
3967c732 1143 do_hv_dump (level, file, " GvSTASH", GvSTASH(sv));
57def98f 1144 Perl_dump_indent(aTHX_ level, file, " GP = 0x%"UVxf"\n", PTR2UV(GvGP(sv)));
f472eb5c
GS
1145 if (!GvGP(sv))
1146 break;
57def98f
JH
1147 Perl_dump_indent(aTHX_ level, file, " SV = 0x%"UVxf"\n", PTR2UV(GvSV(sv)));
1148 Perl_dump_indent(aTHX_ level, file, " REFCNT = %"IVdf"\n", (IV)GvREFCNT(sv));
1149 Perl_dump_indent(aTHX_ level, file, " IO = 0x%"UVxf"\n", PTR2UV(GvIOp(sv)));
1150 Perl_dump_indent(aTHX_ level, file, " FORM = 0x%"UVxf" \n", PTR2UV(GvFORM(sv)));
1151 Perl_dump_indent(aTHX_ level, file, " AV = 0x%"UVxf"\n", PTR2UV(GvAV(sv)));
1152 Perl_dump_indent(aTHX_ level, file, " HV = 0x%"UVxf"\n", PTR2UV(GvHV(sv)));
1153 Perl_dump_indent(aTHX_ level, file, " CV = 0x%"UVxf"\n", PTR2UV(GvCV(sv)));
1154 Perl_dump_indent(aTHX_ level, file, " CVGEN = 0x%"UVxf"\n", (UV)GvCVGEN(sv));
f4c556ac 1155 Perl_dump_indent(aTHX_ level, file, " GPFLAGS = 0x%"UVxf"\n", (UV)GvGPFLAGS(sv));
57def98f 1156 Perl_dump_indent(aTHX_ level, file, " LINE = %"IVdf"\n", (IV)GvLINE(sv));
b195d487 1157 Perl_dump_indent(aTHX_ level, file, " FILE = \"%s\"\n", GvFILE(sv));
57def98f 1158 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)GvFLAGS(sv));
3967c732
JD
1159 do_gv_dump (level, file, " EGV", GvEGV(sv));
1160 break;
1161 case SVt_PVIO:
57def98f
JH
1162 Perl_dump_indent(aTHX_ level, file, " IFP = 0x%"UVxf"\n", PTR2UV(IoIFP(sv)));
1163 Perl_dump_indent(aTHX_ level, file, " OFP = 0x%"UVxf"\n", PTR2UV(IoOFP(sv)));
1164 Perl_dump_indent(aTHX_ level, file, " DIRP = 0x%"UVxf"\n", PTR2UV(IoDIRP(sv)));
1165 Perl_dump_indent(aTHX_ level, file, " LINES = %"IVdf"\n", (IV)IoLINES(sv));
1166 Perl_dump_indent(aTHX_ level, file, " PAGE = %"IVdf"\n", (IV)IoPAGE(sv));
1167 Perl_dump_indent(aTHX_ level, file, " PAGE_LEN = %"IVdf"\n", (IV)IoPAGE_LEN(sv));
1168 Perl_dump_indent(aTHX_ level, file, " LINES_LEFT = %"IVdf"\n", (IV)IoLINES_LEFT(sv));
27533608 1169 if (IoTOP_NAME(sv))
cea2e8a9 1170 Perl_dump_indent(aTHX_ level, file, " TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
3967c732 1171 do_gv_dump (level, file, " TOP_GV", IoTOP_GV(sv));
27533608 1172 if (IoFMT_NAME(sv))
cea2e8a9 1173 Perl_dump_indent(aTHX_ level, file, " FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
3967c732 1174 do_gv_dump (level, file, " FMT_GV", IoFMT_GV(sv));
27533608 1175 if (IoBOTTOM_NAME(sv))
cea2e8a9 1176 Perl_dump_indent(aTHX_ level, file, " BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
3967c732 1177 do_gv_dump (level, file, " BOTTOM_GV", IoBOTTOM_GV(sv));
57def98f 1178 Perl_dump_indent(aTHX_ level, file, " SUBPROCESS = %"IVdf"\n", (IV)IoSUBPROCESS(sv));
27533608 1179 if (isPRINT(IoTYPE(sv)))
cea2e8a9 1180 Perl_dump_indent(aTHX_ level, file, " TYPE = '%c'\n", IoTYPE(sv));
27533608 1181 else
cea2e8a9 1182 Perl_dump_indent(aTHX_ level, file, " TYPE = '\\%o'\n", IoTYPE(sv));
57def98f 1183 Perl_dump_indent(aTHX_ level, file, " FLAGS = 0x%"UVxf"\n", (UV)IoFLAGS(sv));
3967c732
JD
1184 break;
1185 }
cea89e20 1186 SvREFCNT_dec(d);
3967c732
JD
1187}
1188
1189void
864dbfa3 1190Perl_sv_dump(pTHX_ SV *sv)
3967c732
JD
1191{
1192 do_sv_dump(0, Perl_debug_log, sv, 0, 0, 0, 0);
8d063cd8 1193}