Debian Codegraph @

Changes

raw
1 Revision history for Devel-MAT
2
3 0.54 2025-12-26
4 [BUGFIXES]
5 * Fix to `show` command on GLOBs with name_heks
6 * Slight C-level fixes to avoid some clang warnings (thanks ilmari)
7 * Fix `counts` tool to account for the SV rebless operations that
8 Devel::MAT::Tool::Object::Pad performs on internals
9
10 0.53 2024-03-07
11 [CHANGES]
12 * Read PMAT file format 0.6 with its shared HEK pointer additions
13 * Added `strtab` command for analysing the PL_strtab shared strings
14 table
15 * Added count/skip/no-sort options and a filtering argument to
16 `values` command
17 * Added a `stop` command to cancel an ongoing pagination
18 * Only print "class it experimental" warnings when reading an actual
19 class or object instance from a PMAT file, rather than any version
20 0.5 (or later).
21 * Swap unit tests from `Test::More` to `Test2::V0`
22
23 0.52 2024-01-13
24 [CHANGES]
25 * Ensure that `packages -V` can cope with version objects as well as
26 plain numerical SVs
27 * Make sure to load `Devel::MAT` only after processing the `--blib`
28 commandline option
29
30 [BUGFIXES]
31 * Print a warning and skip attempts to apply SVx annotations to
32 unrecognised SV addresses (alleviates but does not fix RT134117)
33
34 0.51 2023-03-23
35 [BUGFIXES]
36 * Don't crash when loading files that claim non-existent SVs are
37 mortalized
38
39 0.50 2023-03-03
40 [CHANGES]
41 * Improved tree-forming algorithm in `pmat-diff` that produces better
42 output shapes
43 * Annotate SVs as being mortalized if the dumpfile contains that
44 information
45
46 [BUGFIXES]
47 * Ensure pmat-diff doesn't get stuck in a loop trying to break cycles
48 when forming tree shapes
49 * Ensure Reachability tool understands that CLASS is a kind of stash
50 (RT146630)
51
52 0.49 2022-10-03
53 [CHANGES]
54 * Much improved output from pmat-diff:
55 + Attempt to group up unique SVs into small trees by reference
56 + Annotate SVs that are MRO caches and hence dumper noise
57 * Added `$sv->outref_named`, `$sv->maybe_outref_named`,
58 `$struct->maybe_field_named` and similar methods
59 * Migrate `pmat-list-dangling-ptrs` script into a real tool command
60 * Have `list-dangling-ptrs` test fields of C_STRUCTs as well
61
62 [BUGFIXES]
63 * Ensure that `packages` command doesn't get upset about non-globs in
64 the toplevel stash
65
66 0.48 2022-08-30
67 [CHANGES]
68 * Recognise 'quit' as an exit command from the pmat shell
69 * Added 'find cv' filter
70 * Have ->format_sv_with_value pick out a single array element or hash
71 value to show as an example
72 * Have ->format_sv_with_value show GLOB names
73 * Allow extension tools to insert extra output into 'show SV' command
74 * Added 'tools' and 'tool' commands
75 * Expermental, work-in-progress handling of PMAT 0.5 file format,
76 which adds support for core 'feature-class' classes and instances
77
78 0.47 2022-04-02
79 [CHANGES]
80 * Improved handling of root SVs including custom ones annotated by
81 the dumpfile itself
82 * Handle the magic VTBL pointer field in latest dumpfile format
83 * Added `find magic` filter
84
85 [BUGFIXES]
86 * 'show' tool should inspect `$sv->type` instead of relying on actual
87 blessed type of SV wrapper
88 * Fix default provided `Devel::MAT::Cmd->format_heading` method
89
90 0.46 2022-03-29
91 [CHANGES]
92 * Support the new STRUCT types in .pmat files
93 + Added `show` STRUCT support
94 + Added `find struct` filter
95 + Added a nice shiney new icon for STRUCT SV type
96 * Added `pmat --blib` option for convenient testing of thirdparty
97 helper modules
98 * Stop stealing GVs or constant SVs out of the first pad on ithreads
99
100 0.45 2022-02-26
101 [CHANGES]
102 * Add support for perl 5.35's boolean types
103 * Added a nice shiney new icon for BOOL SV type
104
105 0.44 2021-03-27
106 [CHANGES]
107 * Rename `find lexical --all` to `--inactive`
108 * Have `find lexical` indicate if it was found in an inactive pad
109 * Paginate output of `outrefs` and `inrefs` commands
110 * Use Feature::Compat::Try
111 * Style modernisations for perl v5.14+
112
113 0.43 2020-04-24
114 [CHANGES]
115 * Have `callers` print the actual CV identity of subs
116 * Many improvements to `show` command:
117 + Added `show --full-pv` for SCALAR
118 + Added `show --pad` for CODE
119 + Have `show CODE` print the protosub if applicable
120 + Have `show PAD|CODE` indicate `our`/`state` and outer-capture
121 lexicals
122 * Added `find lexical` filter
123 * Support Devel::MAT::Dumper 0.44's CODEx_PADNAME_FLAGS annotations
124 * Display CODE() using more friendly "proto" or "closure" flags
125 instead of "P" and "C"
126
127 [BUGFIXES]
128 * Fix `find blessed` command (RT131079)
129
130 0.42 2019-03-21 22:36:09
131 [CHANGES]
132 * Rename `callstack` to `callers`
133 * Optionally show pad in `callers` output
134 * Check symbol table before using ->symname in `identify`
135 * Added `find num` filter
136 * Load the -DDEBUG_LEAKING_SCALARS dumper extension
137
138 0.41 2019-01-14 18:19:44
139 [CHANGES]
140 * Nicer table output in command tools
141 * Added `pmat-counts` for giving a quick summary of a series of
142 heapdump files
143 * Load the SV->SV annotations written by DMD_helper code in
144 thirdparty XS modules
145 * Added a `stack` command
146
147 0.40 2018-09-07 14:57:06
148 [CHANGES]
149 * Read dumpfile format v0.4 - SV extension size table
150 * Elide glob symbol names if possible in 'identify' output
151 * If `identify` doesn't find any SVs, try harder by ignoring
152 filtering options
153 * Track `local` modified variables
154 * Optionally print $VERSION in `packages` command
155 * Have `find` tool respect pagination
156
157 [BUGFIXES]
158 * Don't collide .pmat files during parallel build testing (RT126041)
159
160 0.39 2018-08-09 13:37:24
161 [BUGFIXES]
162 * Fix unit test script for now-removed tool file (RT125994)
163
164 0.38 2018-08-02 17:47:44
165 [CHANGES]
166 * Improvements to 'pmat-diff'
167 + Added --one mode
168 * Improvements to 'find' command
169 + Added 'blessed' filter
170 + Allow filters to be combined
171 + Added --count option
172 * Added --quiet option to main 'pmat' script
173 * Report progress to STDERR, not STDOUT
174
175 0.37 2018-07-24 16:56:49
176 [CHANGES]
177 * Optional splitting of SCALAR by subtype in 'count' command
178 * Small improvements to 'pmat-diff'
179 * Added $sv->basetype method
180 * Added 'pmat-leakreport'
181 * Handle upcoming PMAT v0.3 format with compressed undefs
182
183 0.36 2018-07-17 10:42:41
184 [CHANGES]
185 * Migrated Devel::MAT::Dumper into its own distribution
186
187 0.35 2018-07-03 14:58:53
188 [CHANGES]
189 * Various improvements to 'count' command
190 * Remove 'sizes' command because 'count' does the same thing now
191 * Added new 'size' command for individual SVs
192 * Added new 'packages' command for walking the symbol table
193 * Support pagination of long-output commands via 'more'
194
195 0.34 2018-04-02 18:39:36
196 [CHANGES]
197 * Have 'show' on a PAD use ->format_sv_with_value and ->format_note
198 * Better external API for $sv->magic_svs
199 * Print details of magic in 'show' command
200
201 [BUGFIXES]
202 * Fix for Sizes tool to use $cv->padnames_av (RT124834)
203
204 0.33 2018-01-23 01:22:25
205 [CHANGES]
206 * Added `inrefs` and `outrefs` commands
207 * Improvements to output of `show` command
208 * Indicate circular vs. non-circular self-references in `identify`
209 command output
210 * Accept names of symbols as valid SV addresses
211 * Renamed $cv->padnames to ->padnames_av`
212 * Added $cv->max_padix
213
214 0.32 2017-12-17 00:31:53
215 [CHANGES]
216 * Only elide single-referrant RVs in `identify` output
217 * "Loading file ..." message should mention that its count is in
218 bytes (thanks DAKKAR)
219 * Extract the `callstack` command's stringify behaviour into a new
220 shared ->format_sv_with_value method
221
222 0.31 2017-11-23 22:25:08
223 [CHANGES]
224 * Annotate each root SV with its rootname in formatted output
225 * Expanded userguide docs
226
227 [BUGFIXES]
228 * Use File::Spec->rel2abs() instead of Cwd::abs_path() to hopefully
229 keep MSWin32 happier (RT123235)
230 * chmod +x all the bin/ scripts
231
232 0.30 2017-10-14 20:00:58
233 [CHANGES]
234 * Migrate `pmat-sizes` and `pmat-find-pv` stand-alone scripts into
235 Tool commands
236 * Move the 'io find' tool to 'find io'
237
238 [BUGFIXES]
239 * Correct handling of strong vs weak root references in inref_graph
240 method and 'identify' command (fixes RT123233)
241
242 0.29 2017-10-11 21:16:12
243 [CHANGES]
244 * Slightly more efficient file loading by combining some steps
245 * Further optimisation of Inrefs tool CPU performance
246 * Much improved 'help' command and command system metadata
247 * Neater table formatting of tabular command output
248 * Default --depth 10 to 'identify' command
249
250 [BUGFIXES]
251 * Capture the string values from the shared string table
252
253 0.28 2017-10-10 00:55:37
254 [CHANGES]
255 * Further reworking of the way command-providing Tools can format
256 their output
257 * Richer display of detail in many commands, including 'identify'
258 * Have 'show' tool give overall byte-size of the SV
259 * Elide PADs and PADLISTs when identifying lexicals
260 * Make Inrefs tool more efficient in CPU and memory requirements
261
262 0.27 2017-09-29 19:09:11
263 [CHANGES]
264 * Major reworking of the way command-providing Tools work, and supply
265 output to their containing user interface.
266 * Elide symbol table entries in 'identify' output
267 * Don't accept __ANON__ symbol names as valid roots for inrefs graph
268 * Added command tools for listing the root SVs and the symbol table
269 * General improvements to output format and commandline structure of
270 other tools
271
272 0.26 2017/05/09 19:14:57
273 [BUGFIXES]
274 * Handle perl 5.25.6's moving of OP_PUSHRE to OP_SPLIT
275 * Don't bother #include'ing <unistd.h> as we don't need it
276
277 0.25 2017/03/27 14:09:55
278 [CHANGES]
279 * Attempt to elide RVs in `identify` output
280 * Add a 'help' command to pmat shell
281 * Added the start of Devel::MAT::UserGuide
282 * Moved `pmat-callstack` to `pmat> callstack`
283 * Removed used of given/when syntax
284
285 [BUGFIXES]
286 * Fix for perl 5.25.x's removal of ->op_sibling (RT114581)
287 * Avoid creating files called -e.pmat (RT119164)
288 * abs_path() the dumpfile path at startup time in case of chdir()
289 (RT117842)
290
291 0.24 2016/06/03 19:07:47
292 [CHANGES]
293 * Capture the input/output fileno values of IO handles
294 * Moved more standalone commands into 'pmat' command Tools
295 + pmat-identify-sv becomes pmat> identify
296 + pmat-show-sv becomes pmat> show
297 * Added pmat> io commands
298 * Make main 'pmat' into an interactive repl-like program if run with
299 no additional arguments
300
301 0.23 2016/04/05 16:32:43
302 [CHANGES]
303 * Allow -dump_at_SIGNAME for any named signal
304 * Added simple 'pmat-diff' script
305 * Distinguish undefined scalars from defined ones, using a new icon
306 * Initial experiment at generic 'command' ability
307 * Moved GTK explorer to its own distribution;
308 App-Devel-MAT-Explorer-GTK
309
310 0.22 2016/03/16 16:22:19
311 [CHANGES]
312 * Added a simple script to find PVs by content
313 * Updated documentation to =head2 barename style
314
315 [BUGFIXES]
316 * Fix back-compat loading of v0.1 files with EVAL contexts in
317 * Fix perl5.22/ithreads that lacks padnames
318 * Fix perl5.23.8 that removes blk_sub.argarray
319
320 0.21 2015/10/29 20:58:29
321 [CHANGES]
322 * Compatibility with perl 5.22 (RT100458):
323 + Added/removed roots
324 + Correctly handle GV-less CVs
325 * Updated dumpfile format
326 + Store the CvDEPTH of CVs and the olddepth of SUB contexts
327 (RT108094)
328 + Capture CvLEXICAL flag and the name of CvNAMED CVs
329 * Allow lookup of PAD index from padname for lexicals (RT100967)
330 * Improved output format of pmat-callstack, showing the value of a
331 $self lexical if one exists
332 * Increased dump format minor version to 2
333
334 [BUGFIXES]
335 * No need to emit two copies of the default stash if perl has heap-
336 allocated it (RT103499)
337
338 0.20 2014/12/04 18:35:09
339 [CHANGES]
340 * Allow serial-numbering of .pmat files in the Dumper
341 * Totally refactored $pmat->identify to return an abstract Graph
342 structure
343 * Much improved pmat-identify-sv output; sort strong-refs first,
344 use Unicode linedrawing, identify "already seen" SVs clearer
345 * GTK Explorer improvements:
346 + Allow search by symbol
347 + Show longer PV strings in tooltip
348 + Selectable SV detail labels
349
350 0.19 2014/11/18 13:17:28
351 [CHANGES]
352 * No need to annotate 'directly' or 'indirectly' on outref names
353 * Added -dump_at_DIE option to Devel::MAT::Dumper
354 * Added icon for INVLIST from perl 5.20
355
356 0.18 2014/07/14 22:45:08
357 [CHANGES]
358 * Improved for Tools to create custom UIs
359 + Widget trees
360 + Label text + icon
361 + Tool-localised icon load paths
362 * Support loading Tools automatically
363 * Neater API for inrefs/outrefs that also indicates link strength
364
365 0.17 2014/01/22 21:33:45
366 [CHANGES]
367 * Also dump SvUTF8() flag of PVs
368 * Added pmat-cat-svpv
369
370 [BUGFIXES]
371 * Don't crash on NULL PADLIST elements (RT92290)
372
373 0.16 2014/01/15 18:18:53
374 [CHANGES]
375 * More accurate format for dumping SV MAGIC annotations
376 - note that older files will contain incorrect information
377 * More accurate backref information
378 * Improvements to analysis of PAD lexicals
379
380 [BUGFIXES]
381 * Fix many cases of optree dumping to get correct PAD indexes
382 * Further minor fixes that improve SvREFCNT / inrefs accuracy
383
384 0.15 2014/01/14 11:12:37
385 [CHANGES]
386 * Remember to basename() $0 for default dumpfile name
387 * Added -eager_option import option
388 * Added $df->roots_strong
389 * Added options to $pmat->identify and pmat-identify-sv command
390
391 [BUGFIXES]
392 * Avoid infinite loop in $pmat->identify in cyclic cases
393 * Fix docs on ->rv method (RT92122)
394
395 0.14 2014/01/04 20:25:16
396 [CHANGES]
397 * Move much core data storage into XS structs, for reduced memory
398 consumption of analyser and some CPU performance gains
399 * Display human-readable size information in GTK explorer
400 * Added a size totals summary commandline tool
401 * Improved recursion logic in Inrefs tool; avoids multiple recursions
402 into shared structures
403
404 [BUGFIXES]
405 * Fix for 5.10.0
406
407 0.13 2013/12/06 21:37:35
408 [CHANGES]
409 * Performance improvement to inrefs counting
410 * Added Sizes tool - calculates structure and owned set and sizes
411 * Allow Tools to declare UI radiobutton sets
412 * Improved Tools ability to interact with the SV list
413 * Disable Tools menu items for loaded tools to avoid loading them
414 twice
415
416 [BUGFIXES]
417 * Add List::UtilsBy to requirements
418 * Our version of dopoptosub_at() doesn't need aTHX_
419
420 0.12 2013/12/03 15:18:43
421 [CHANGES]
422 * Classify outrefs and inrefs into various kinds
423 * Subclass ARRAY into PADLIST, PADNAMES, PAD for CODE
424 * Allow selection of what kinds of refs to count/display on the GTK
425 explorer
426 * Store more flags (CvWEAKOUTSIDE, CvCVGV_RC, AvREAL) so as to get
427 strong/weak references correct
428 * Store the SvOUTSTASH of SCALARs and REFs
429 * Added a commandline wrapper for $pmat->identify
430
431 [BUGFIXES]
432 * require() tool .pm files automatically when calling ->load_tool
433
434 0.11 2013/11/28 14:30:32
435 [CHANGES]
436 * Complete redesign of dumpfile format so it is more extensible in future
437 * Represent RVs by their own type, REF, rather than being a kind of SCALAR
438 * Store caller()-like context in dumpfiles as well
439 * Store CLONE/CLONED/ISXSUB CV flags and oproot
440 * Attempt to match CLONE protosubs with CLONED closures
441 * Added SCALAR->iv method
442 * Neaten the names of STASHes whose names begin with a control character
443 * Pretty-print PVs and limit length to 32 characters in GTK explorer
444 * Added icons for REF and LVALUE types
445
446 [BUGFIXES]
447 * Guard against PL_main_root being NULL, as it can be early in compilation
448 * Improved Reachability tool logic for CODE PAD slots
449
450 0.10 2013/11/26 00:42:14
451 [CHANGES]
452 * Display dumped perl version, SV and byte counts in GTK explorer
453 status bar
454 * Dump all GVs, even those without GPs
455 * Store size information about all SVs
456 + TODO: CODE size does not take account of optree
457 * Have dump_at_{END,SIGABRT,SIGQUIT} print to STDERR
458 * Limit the capture size of PVs, but still note the full length
459 * Dump FILE and LINE of CVs and GVs
460 * Redrawn type icons
461
462 [BUGFIXES]
463 * Fix for NVLEN=16 architectures
464
465 0.09 2013/11/22 00:25:17
466 [CHANGES]
467 * Remove orphan count unit test as it is too unreliable
468
469 [BUGFIXES]
470 * Sometimes a PAD(0) slot is NULL
471 * ->identify is now a $pmat method
472 * ->identify should load Inrefs tool
473 * Try harder to clear PL_tmpsv when making an unreachable cycle
474
475 0.08 2013/11/10 19:27:30
476 [CHANGES]
477 * Chase more fields of an HV's mro_meta
478 * Document how Tools may interact with the UI
479 * Allow Tools to register and use icons on the UI
480 * Rework Reachability tool to analyse kinds of reachability
481 * Move inrefs logic into its own new Inrefs Tool
482 * Slight performance improvement to dumpfile loading
483 * Display icons also for general SV type
484
485 [BUGFIXES]
486 * Ensure ->find_symbol actually works for deeply-nested symbols
487
488 0.07 2013/11/08 01:33:01
489 [CHANGES]
490 * Added new concept of Devel::MAT::Tool::* and Devel::MAT::UI
491 * Implement SV type counting and reachability analysis Tools
492 * Allow dumping on SIGABRT
493
494 [BUGFIXES]
495 * Support perl 5.10
496 * Support NVSIZE==16 architectures
497
498 0.06 2013/10/28 00:14:24
499 [CHANGES]
500 * Don't yield constants from both anonymous subs -and- constix/constsv
501 lists
502 * Don't bother including all the PL_sv_undef lexnames
503
504 [BUGFIXES]
505 * Remember to store padlist in pre-5.18 perls
506 * PL_main_cv does not have a CvROOT(); need to use PL_main_root
507 (fixes unit test failures on non-threaded perls)
508
509 0.05 2013/10/22 01:34:44
510 [CHANGES]
511 * Added ->find_symbol and ->find_glob
512 * Identify weakrefs in descriptions and in GTK explorer
513 * All hashes have the backrefs AV field, not just stashes
514 * Recognise import() options on D:M:Dumper
515 * Grab padnames and pad AVs on 5.18
516 * Added a toolbar with back/forward buttons in GTK explorer
517
518 [BUGFIXES]
519 * Don't crash when ->identify'ing SVs that are stack temporaries
520
521 0.04 2013/10/09 23:23:27
522 [CHANGES]
523 * Renamed dumpfile() to just dump()
524 * Don't delete elided RVs; include both direct and via-RV outrefs
525
526 [BUGFIXES]
527 * Start 'identify' with the initial SV already seen so it doesn't
528 infinitely recurse
529 * Remember to still fix up consts_at from constix on ithreaded 5.18
530 * Need to check if SVs are actually magical (SvMAGICAL), not just
531 potentially magical (>= SVt_PVMG)
532
533 0.03 CHANGES:
534 * Altered handling of PADLISTs for perl 5.18.0
535 * Ensure that UINTs and PTRs are written in correct platform sizes
536
537 0.02 CHANGES:
538 * Bugfixes for non-threaded perls
539 * Trace constants/GVs/etc... through optrees
540 * Handle SVt_PVLV
541
542 0.01 First version, released on an unsuspecting world.
543