Debian Codegraph @

Changes

raw
1 Revision history for Perl extension Parse::Win32Registry.
2
3 ** 1.1 2020-09-19
4
5 Added fix for errors decoding registry timestamps. (This was due to the
6 interpretation of dates in timegm changing in recent versions of Perl.)
7 Thanks to B.M.W. and Slaven Rezic for their help with this.
8
9 Updated as_regedit_export to handle undefined REG_SZ values.
10
11 ** 1.0 2012-04-29
12
13 Added support for decoding System Mandatory Label ACEs (a feature
14 introduced with Windows Vista) and added the command line script
15 regml.pl for listing keys with explicit System Mandatory Label ACEs
16 set. Improved handling of security descriptors.
17
18 Tidied up various aspects of the wxWidgets and GTK applications, and
19 harmonised functionality between the various pairs of equivalent
20 programs, with a minor difference being the wxWidgets applications
21 following Windows keyboard shortcut conventions while the GTK
22 applications following Linux keyboard shortcut conventions.
23
24 The get_data method of Value objects now returns the unpacked integer
25 value for REG_DWORD_BIG_ENDIAN value types instead of the original
26 packed binary data.
27
28 Added support for values with 'big data'. Thanks to Harlan Carvey for
29 all his help with this.
30
31 ** 0.60 2010-08-15
32
33 Parse::Win32Registry now requires Perl 5.8.1.
34
35 Implemented new RGKN and RGDB Block objects for Windows 95 registry
36 files. Now both Windows 95 and Windows NT registry files have
37 a get_block_iterator method, which replaces the get_hbin_iterator
38 previously provided for Windows NT registry files. (For backwards
39 compatibility, calling the get_hbin_iterator method will call the
40 get_block_iterator method.)
41
42 Some performance improvements have been made to the processing of
43 REG_MULTI_SZ value data (in the get_data method of Value objects), to
44 the generation of hexdumps (in the hexdump function and the unparsed
45 method of Entry objects), and to the generation of REGEDIT-style octet
46 strings (in the as_regedit_export method of Value objects).
47
48 Uncompressed (Unicode) key and value names are now correctly read
49 from Windows NT registry files.
50
51 The following new scripts have been added: wxregcompare.pl,
52 wxregscope.pl, and wxregview.pl. The existing regcompare.pl,
53 regscope.pl, and regview.pl scripts have been renamed to
54 gtkregcompare.pl, gtkregscope.pl, and gtkregview.pl respectively.
55 The wx scripts require Mattia Barbon's wxPerl library and the gtk
56 scripts require Gtk-Perl. (Binary versions of wxPerl are currently
57 available in ActivePerl.)
58
59 gtkregscope.pl and wxregscope.pl use the new get_block_iterator
60 method, so can read both Windows 95 or Windows NT registry files.
61
62 gtkregcompare.pl and wxregcompare.pl allow the Select Files dialog
63 to be cancelled to make it possible to review the currently selected files.
64
65 regmultidiff.pl now displays changes in a summary mode.
66 The previous format is available by specifying the -l or --long option.
67
68 ** 0.51 2009-10-04
69
70 Added new regscope.pl script, a GTK+ registry entry viewer that uses color
71 to highlight different types of registry entries.
72
73 Documented the get_name method of SID objects and the get_value_data
74 method of Key objects. The as_string method of the ACE object and the
75 as_stanza method of the SecurityDescriptor object now include the well
76 known SID names (as returned by each SID object's get_name method).
77
78 Updated the regview.pl and regcompare.pl scripts: regview.pl and
79 regcompare.pl can now select keys and/or values when searching,
80 regview.pl can now sort columns (e.g. keys can be sorted by timestamp,
81 values by type, etc), regcompare.pl can now bookmark keys or values,
82 and regview.pl now has a basic report view.
83
84 Fixed the get_subtree_iter and make_multiple_subtree_iterator methods
85 to return the root key(s) of the subtree(s) as the documentation
86 indicates. regview.pl, regmultidiff.pl, and regcompare.pl amended to
87 accommodate these changes.
88
89 Fixed redisplay problem closing dialogs using Escape in regview.pl and
90 regcompare.pl.
91
92 Makefile.pl now includes all scripts as exe_files.
93
94 ** 0.50 2009-07-19
95
96 Security information is now extracted from Windows NT registry files.
97 Key objects now provide a get_security method which returns a new
98 Security object. The various methods of a Security object will return
99 Security Descriptor, ACL, ACE, and SID objects.
100
101 The support functions unpack_sid, unpack_ace, unpack_acl, and
102 unpack_security_descriptor have been added to allow the manual
103 extraction of security information from value data.
104
105 The support functions compare_multiple_keys and compare_multiple_values
106 have been added for comparing keys and values.
107
108 Updated scripts: regview.pl now provides searches and displays
109 security information for keys. regtree.pl now draws lines connecting
110 subkeys to their parent keys. regdump.pl can now display class names
111 and security information. regfind.pl and regtimeline.pl can now
112 display value data as a hexdump, and regfind.pl now searches raw data
113 for unicode matches.
114
115 New scripts: regmultidiff.pl is a command line program for comparing
116 multiple registry files, and replaces regdiff.pl. regcompare.pl is a
117 GTK+ Registry Compare program, and also provides searches.
118 regsecurity.pl displays registry security entries. regshell.pl is a
119 interactive console program for browsing registry files that offers
120 tab completion of key and value names if Term::Readline is available.
121
122 Iterators for processing keys and values have now been added,
123 mainly to support GUI programs (see regview.pl and regcompare.pl).
124 Key objects now offer the get_subkey_iterator, get_value_iterator,
125 and get_subtree_iterator methods.
126
127 The support functions make_multiple_subkey_iterator,
128 make_multiple_value_iterator, and make_multiple_subtree_iterator have
129 been added for processing multiple registry files simultaneously.
130
131 Similarly, iterators have been added for scanning registry files entry
132 by entry. The new Hbin object has been created to represent the
133 individual hbins that make up Windows NT registry files. Now you can
134 either iterate through all the entries in a registry file, or iterate
135 through all the hbins in a registry file and through each entry of
136 each hbin.
137
138 The as_hexdump method provided by Entry, Key, and Value objects
139 has been renamed to unparsed to more accurately reflect what it shows.
140
141 The Entry, Key, and Value objects now provide the following methods:
142 get_length, get_tag, is_allocated, get_raw_bytes, looks_like_key,
143 looks_like_value, and looks_like_security.
144
145 Warnings generated by parse errors are now disabled by default.
146
147 ** 0.41 2008-12-14
148
149 Added the new get_class_name function for Windows NT registry keys.
150 Added the regclassnames.pl script to demonstrate finding keys that
151 have class names, and updated regview.pl to display the timestamp
152 and class names of keys in additional columns.
153
154 ** 0.40 2008-09-28
155
156 Added new scripts: regexport.pl for exporting keys and values using
157 the Windows Registry Editor Version 5.00 format, regscan.pl for
158 dumping all the entries in a registry file, regstats.pl for providing
159 basic statistics, regtimeline.pl for listing keys and values in date
160 order, regtree.pl for dumping a registry file as an intended tree, and
161 regview.pl, a GTK+ Registry Viewer. Updated regdump.pl and regfind.pl
162 to provide new options.
163
164 Changed parse errors to generate warnings instead of croaking.
165 Documented this in the Handling Invalid Data section.
166
167 The get_data method of Value objects now handles REG_MULTI_SZ data by
168 returning a list of its elements in an array context, and a string in
169 a scalar context. The output of get_data_as_string is unaffected.
170
171 Added new Registry object methods: get_virtual_root_key,
172 get_timestamp, get_timestamp_as_string, and get_embedded_filename.
173
174 Added new Key object methods: as_regedit_export, get_parent, and
175 is_root.
176
177 Added new Value object methods: as_regedit_export, and get_raw_data.
178
179 Added the get_next_entry and move_to_first_entry methods to the
180 Registry object for iterating through all the entries in a registry
181 file. Added the Entry object class as a generic object to represent
182 these entries.
183
184 Added the methods parse_info and as_hexdump to
185 Entry, Key, and Value objects.
186
187 Support function convert_filetime_to_epoch_time renamed to
188 unpack_windows_time, added the function unpack_unicode_string, and
189 documented hexdump.
190
191 ** 0.30 2007-07-01
192
193 Added two new scripts: regfind.pl for searching keys, values, and data
194 for a search string, and regdiff.pl for comparing two registry files
195 and displaying the differences. dumpreg.pl renamed to regdump.pl and
196 command line options simplified.
197
198 Introduced the as_string method for Key and Value objects. This is
199 intended to be a more usable replacement for the print_summary
200 method.
201
202 The get_data_as_string method changed to return REG_DWORD values as a
203 hexadecimal number followed by its decimal equivalent. Clarified that
204 REG_DWORD values are returned as unsigned integers.
205
206 Support functions convert_filetime_to_epoch_time and iso8601
207 documented.
208
209 Fixed bugs handling unusual key names in the get_subkey method.
210
211 ** 0.25 2006-11-12
212
213 Fixed a bug with new WinNT key objects incorrectly setting the offsets
214 to subkey lists and value lists when the offset to the parent key had
215 a particular value.
216
217 ** 0.24 2006-10-29
218
219 Key objects now have a get_path method, which returns the path
220 to that key from the root key of a registry file. Documentation
221 updated to describe the new method.
222
223 dumpreg.pl updated to use get_path. Dropped the prefix_pattern and
224 long_prefix_pattern configuration options from Getopt::Long.
225 (which required an unnecessarily recent version of Getopt::Long)
226
227 ** 0.23 2006-08-13
228
229 Key objects now have the get_timestamp and get_timestamp_as_string
230 methods, although only Windows NT registry keys will return valid
231 values. print_summary nows also displays the timestamp for Windows NT
232 registry keys. Documentation updated to reflect this.
233
234 Makefile.PL now installs the dumpreg.pl script.
235
236 ** 0.22 2006-08-06
237
238 Included the script dumpreg.pl as both a tool for examining
239 registry files, and as an example.
240
241 Offsets that require adjustment by fixed amounts (this applies to
242 entries in the RGKN block of Windows 95 registry files and to all
243 entries in the hbin blocks of Windows NT registry files) are now
244 amended before being stored, rather than at seek time.
245
246 Troubleshooting section added to the documentation.
247
248 ** 0.21 2006-07-30
249
250 Checks added after every sysread, and improvements attempted for the
251 error messages presented. Internal error messages have been made
252 distinct from parse errors.
253
254 The code that looks up the RGDB entry for Win95 keys has been revised
255 to remove some duplicate code. It's still too long.
256
257 Reading REG_DWORD values which are not the expected four bytes in
258 length no longer results in an exception. get_data now
259 returns undef for these values instead of failing.
260
261 get_data_as_string updated to return (no data) when get_data returns
262 an empty string, and (invalid data) when get_data returns undef (which
263 should only occur for invalid REG_DWORD values).
264
265 ** 0.20 2006-07-23
266
267 Released to CPAN.