| 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. |