ext/Digest/SHA/Changes

   1 Revision history for Perl extension Digest::SHA.
   2
   3 5.43  Sat Aug  5 02:36:18 MST 2006
   4         - undid Perl Best Practice of favoring 3-argument "open"
   5                 -- 3-arg version uses different semantics for "-"
   6                         causing bugs in addfile and shasum
   7         - modified underlying C functions to use ANSI prototypes
   8                 -- requested by Steve Hay (ref. Smoke [5.9.4] 28630)
   9                 -- K&R style was causing numerous warnings from
  10                         Borland compiler
  11
  12 5.42  Mon Jul 24 04:04:40 MST 2006
  13         - minor code changes suggested by Perl::Critic
  14                 -- e.g. no bareword filehandles, no 2-argument open's
  15         - updated public key (ref. B538C51C)
  16                 -- previous one (0AF563FE) expired July 2, 2006
  17         - added documentation to warn that Base64 digests are NOT padded
  18                 -- padding must be done by user if interoperability
  19                         with other software is required
  20
  21 5.41  Sat Jun  3 01:50:46 MST 2006
  22         - corrected addfile
  23                 -- process $file argument as a filehandle unless passed
  24                         as a SCALAR (which indicates a file name)
  25
  26 5.40  Fri Jun  2 04:00:30 MST 2006
  27         - modified addfile to accept indirect filehandles
  28                 -- ref. rt.cpan.org #19627 and #19641
  29
  30 5.39  Sun May 28 03:22:24 MST 2006
  31         - modified shasum to warn rather than die for file errors
  32                 -- to follow conventions of GNU sha1sum/md5sum
  33
  34 5.38  Thu May 25 02:02:02 MST 2006
  35         - added new capabilities to the "addfile" method
  36                 -- now able to accept file names as well as handles
  37                 -- includes mode for portable digest calculation
  38                         -- thanks to Adam Kennedy for emails and ideas
  39                                 ref. File::LocalizeNewlines
  40         - used expanded addfile interface to simplify shasum (sumfile)
  41                 -- regex a tad less general than 5.37, but handles all
  42                         known newline variants in UNIX/Windows/MacOS
  43         - enhanced WARNING messages from shasum checkfile processing
  44                 -- to mimic behavior of md5sum
  45
  46 5.37  Mon May  8 04:30:09 MST 2006
  47         - modified shasum to avoid file slurping (ref. sub sumfile)
  48         - improved error handling of checksum files in shasum
  49                 -- to better mimic the behavior of md5sum
  50         - refined line-break regex in shasum (ref. sub sumfile)
  51                 -- catches multiple CR's preceding LF
  52                         thanks to Gisle Aas for suggested patch
  53         - changed loop vars to signed int's in shadump (ref. src/sha.c)
  54                 -- to prevent type mismatch warnings
  55
  56 5.36  Mon May  8 01:38:36 MST 2006
  57         - fixed the "portable" option in shasum
  58                 -- normalize line-breaks in text files only
  59
  60 5.35  Thu May  4 16:54:42 MST 2006
  61         - added "portable" option to shasum
  62                 -- to make digests match across Windows/Unix/MacOS
  63         - enabled bundling of shasum command line options
  64                 -- to mimic behavior of md5sum
  65         - removed \r's from text files in t/nist directory
  66                 -- resolves SIGNATURE clashes (rt.cpan.org #18983)
  67         - changed suffix on SHA64_MAX (src/sha.h) to ULL
  68                 -- eliminates gcc warnings (rt.cpan.org #18988)
  69         - specified minimum Perl version for module and Makefile.PL
  70                 -- closes rt.cpan.org #18984
  71
  72 5.34  Thu Feb  2 18:55:40 MST 2006
  73         - removed Unix-style pathnames in test scripts
  74                 -- causing problems on OpenVMS
  75                 -- thanks to Steve Peters for patch
  76         - included latest version of Perl Portability header (ppport.h)
  77         - added PERL_CORE check to test scripts
  78                 -- allows module to be built into Perl distribution
  79
  80 5.32  Fri Dec  2 02:32:20 MST 2005
  81         - added POD section to shasum script
  82                 -- thanks to Gunnar Wolf for patch
  83         - made minor code changes to silence compiler warnings
  84                 -- resulting from signed/unsigned integer mixing
  85         - inserted code in test scripts for POD checking
  86                 -- to recover gracefully if Test::More isn't installed
  87
  88 5.31  Mon Sep  5 00:52:42 MST 2005
  89         - added standard tests for pod and pod-coverage checking
  90         - inserted subtest to check for failure when using
  91                 unrecognized SHA algorithm
  92
  93 5.30  Sat Aug 20 16:46:08 MST 2005
  94         - updated docs with recent NIST statement on SHA-1
  95                 -- advises use of larger and stronger hash functions
  96                         (i.e. SHA-224/256/384/512) for new developments
  97
  98 5.29  Sun Aug 14 04:48:34 MST 2005
  99         - added explicit casts in "shaload" routine (ref. "ldvals")
 100                 -- thanks to E. Allen Smith for pointing out SGI compiler
 101                         warnings on IPxx-irix platforms
 102         - updated docs with cautionary note about SHA-1
 103
 104 5.28  Wed Nov 10 15:33:20 MST 2004
 105         - provided more flexible formatting of SHA state files
 106                 -- entries may now contain embedded whitespace
 107                         for improved readability
 108         - minor code cleanups
 109
 110 5.27  Sun Oct 24 02:54:00 MST 2004
 111         - minor code cleanups
 112                 -- reduces size of dump files for SHA-1/224/256
 113
 114 5.26  Thu Oct  7 14:52:00 MST 2004
 115         - streamlined distribution
 116                 -- reduced NIST vector tests from 200 to 20
 117                         -- former number was overkill
 118                         -- distro now downloads and builds more quickly
 119         - rewrote SYNOPSIS sections in pod file
 120         - made additional tweaks to t/8-shasum.t for portability
 121         - cleaned up test scripts
 122
 123 5.25  Sun Sep 12 18:48:00 MST 2004
 124         - removed non-essential test script
 125                 -- t/8-shasum.t causes problems on sparc64-linux
 126         - reverted to using eval "require $module" in shasum
 127
 128 5.24  Sun Sep 12 02:50:18 MST 2004
 129         - modified shasum to use barewords in "require" statements
 130                 -- ref. perl.cpan.testers (157305)
 131
 132 5.23  Thu Sep  9 23:06:18 MST 2004
 133         - corrected bug in test script
 134                 -- use blib when invoking perl as an external
 135                         command in t/8-shasum.t
 136
 137 5.22  Tue Sep  7 19:12:40 MST 2004
 138         - broadened SHA-384/512 support
 139                 -- to compilers with no ULLONG_MAX in limits.h
 140                         -- e.g IBM C (xlC 6.0.0) on AIX 4.3.3
 141                         -- thanks to Chris Carey for suggestions
 142                                 and technical expertise
 143         - improved use of static storage class in transforms
 144                 -- detection of Intel arch. now done in Makefile.PL
 145                 -- NB: static not used if compiling for thread safety
 146         - minor changes to documentation
 147
 148 5.21  Mon Aug 23 04:02:00 MST 2004
 149         - removed 64-bit constant expressions from #if statements
 150                 -- ref. src/sha.h (lines 55, 58, and 61)
 151                 -- even if compiler supports long long's, preprocessor
 152                         may use long's when evaluating expressions
 153         - improved test script for "shasum" (t/8-shasum.t)
 154                 -- exercises check file option (-c)
 155
 156 5.20  Sun Aug 15 04:24:48 MST 2004
 157         - introduced "shasum" script
 158                 -- mimics the usage and behavior of "md5sum"
 159                 -- adds "-a" option to select SHA algorithm
 160                 -- for help, just type "shasum -h"
 161
 162 5.10  Fri Aug  6 02:04:38 MST 2004
 163         - simplified module documentation
 164                 -- made it consistent with Digest::SHA::PurePerl docs
 165
 166 5.03  Sat Jul 31 00:00:48 MST 2004
 167         - corrected HMAC-SHA-384/512 bug (cpan #7181, Adam Woodbury)
 168                 -- code was using hardwired blocksize for SHA-1/256
 169                         -- ref. src/hmac.c, src/hmac.h
 170
 171 5.02  Thu Jul 29 02:48:00 MST 2004
 172         - updated documentation and "dump-load.t" test script
 173                 -- to be consistent with Digest::SHA::PurePerl
 174         - included a SIGNATURE file
 175                 -- for stronger authentication of module contents
 176                         -- ref. Module::Signature on CPAN
 177         - corrected embarrassing misspelling in docs
 178                 -- apologies to Gisle Aas
 179
 180 5.01  Fri May 21 13:08:12 MST 2004
 181         - check for undefined SHA handle when calling "shaclose()"
 182                 -- prevents intermittent cleanup errors during
 183                         global object destruction
 184
 185 5.00  Fri May 14 04:45:00 MST 2004
 186         - minor documentation fixes
 187         - restored classical style of version numbering (X.YZ)
 188                 -- previous X.Y.Z style caused installation difficulties
 189                         when using CPANPLUS
 190
 191 4.3.3 Wed May  5 00:30:40 MST 2004
 192         - fixed bug in "strto64()" function
 193                 -- caused problems in state files with CR/LF pairs
 194                 -- thanks to Martin Thurn for testing support
 195
 196 4.3.2 Wed Apr 28 03:56:00 MST 2004
 197         - added Makefile.PL options
 198                 -- thread-safety: -t
 199                 -- exclude 384/512 support: -x
 200                 -- e.g. perl Makefile.PL -t
 201         - temporarily suppress dump/load tests for SHA-384/512
 202                 -- pending clarification of problem on sun4u sparc
 203
 204 4.3.1 Thu Mar  4 02:54:00 MST 2004
 205         - removed unused functions from XS file
 206                 -- reduces size of compiled objects
 207         - simplified implementation of Digest::SHA object
 208                 -- now a blessed SHAPtr ref instead of blessed array ref
 209                 -- results in slight speed-up of OO operations
 210         - streamlined underlying C source
 211                 -- used macros to consolidate repetitive code
 212         - rewrote test scripts to depend on Test rather than Test::More
 213                 -- allows module to be checked in minimal Perl environments
 214         - added compilation option for thread-safety
 215                 -- overrides use of static arrays
 216
 217 4.3.0 Sat Feb  7 02:58:00 MST 2004
 218         - included SHA-384/512 support if using Microsoft C/C++
 219                 -- uses MSVC's __int64 in place of "long long"
 220         - enhanced portability and efficiency on diverse platforms
 221                 -- automatically sets up optimal types for 32/64-bit ops
 222         - improved test scripts for better reporting
 223                 -- many thanks to Alex Muntada for helpful suggestions
 224
 225 4.2.2 Sat Jan 31 17:10:20 MST 2004
 226         - repaired 32-bit SHA operations for 8-byte longs
 227
 228 4.2.1 Sat Jan 24 00:56:54 MST 2004
 229         - modified I/O and memory management in underlying C code
 230                 -- uses Perl libraries when compiled as CPAN module
 231                         -- otherwise defaults to ANSI C libraries
 232                 -- bypasses problems in MSWin multi-threaded Perls
 233                         -- avoids "Free to wrong pool" error
 234                 -- special thanks to Robert Gilmour and Brian Gladman
 235                         for technical guidance and testing
 236
 237 4.2.0 Sat Dec 27 16:08:00 MST 2003
 238         - added support for recently-announced SHA-224 algorithm
 239                 -- ref. FIPS 180-2 Change Notice 1
 240                 -- also includes HMAC-SHA-224
 241
 242 4.1.0 Thu Dec 25 00:58:00 MST 2003
 243         - repaired "nist-vectors" test scripts for MSWin32 portability
 244                 -- use binmode for data files
 245
 246 4.0.9 Wed Dec 24 02:58:22 MST 2003
 247         - use canonical file specs in test scripts
 248                 -- enhances portability across different OSes
 249         - modify type declarations of objects in XS file
 250                 -- re-declare as (SV *) and cast to (AV *) SvRV(self)
 251                         -- in response to AVPtr problem on MSWin32
 252
 253 4.0.8 Thu Dec 18 23:32:00 MST 2003
 254         - inherits from Digest::base if installed
 255                 -- also checks for MIME::Base64
 256                 -- still fully-functional if neither are installed
 257         - added buffer overflow protection in underlying C code
 258                 -- ref. shahex() and shabase64() routines
 259                 -- prior code appeared impossible to exploit, but ...
 260                         -- better safe than sorry
 261                 -- does not impact runtime efficiency
 262         - minor code cleanup
 263
 264 4.0.7 Sat Dec 13 00:48:24 MST 2003
 265         - check for undefined SHA handle when calling "shaclose()"
 266                 -- was causing cleanup err during global destruction
 267
 268 4.0.6 Thu Dec 11 02:18:00 MST 2003
 269         - more optimization and streamlining
 270                 -- a bit faster on non-big-endians (e.g. Intel)
 271         - rewrote time-critical functions and methods in XS
 272         - removed unused C functions from source files
 273
 274 4.0.5 Sat Dec  6 00:02:24 MST 2003
 275         - performance optimizations
 276                 -- rewrote "add" method in XS
 277                 -- unrolled loops in sha256 transform
 278
 279 4.0.4 Thu Dec  4 00:07:00 MST 2003
 280         - made Digest::SHA into a self-contained module
 281                 -- no longer depends on Digest::base
 282                 -- more convenient for users
 283                         -- no need to install Digest:: module
 284
 285 4.0.3 Wed Dec  3 00:01:20 MST 2003
 286         - Digest::SHA now a subclass of Digest::base
 287                 -- inherits hexdigest/b64digest/addfile methods
 288         - added "hashsize" method
 289         - removed old "shaopen()/shawrite()/..." legacy code
 290                 -- in favor of standard, streamlined OO interface
 291         - renamed test vector files from NIST
 292                 -- prevents problems on 8+3 filesystems
 293         - added test for Dave Ireland's SHA-256 vector
 294
 295 4.0.0 Sat Nov 29 21:14:09 MST 2003
 296         - major streamlining of interface (hence, major version change)
 297                 -- coordinated with Gisle Aas and J. Duque
 298                         -- goal is to produce a single SHA module
 299                 -- adheres to OO and functional styles of Digest::
 300                 -- greatly reduces the number of interface functions
 301                 -- old functions still supported
 302                         -- use Digest::SHA ':legacy'
 303                         -- will be deprecated in near future
 304         - rewrote all test scripts to match new interface
 305                 -- very easy to modify all 281 tests
 306                 -- old interface maps cleanly to new one
 307
 308 3.0   Wed Nov 26 05:02:34 MST 2003
 309         - added functions that conform to Digest:: interface
 310                 -- both functional and OO styles
 311                         -- byte-oriented data only
 312                 -- continue to support original interface as well
 313                         -- necessary for bit-oriented data
 314         - supplied formal test vectors for HMAC-SHA-256
 315                 -- from draft-ietf-ipsec-ciph-sha-256-01.txt
 316         - included tests for all OO methods
 317
 318 2.4   Sat Nov 22 17:10:22 MST 2003
 319         - code cleanup
 320                 -- "sha.c" now completely free of #ifdef's
 321         - modularized all 64-bit (long long) code
 322         - improved readability of header files
 323         - simplified logic of "fixdump" utility
 324
 325 2.3   Wed Nov 19 03:54:31 MST 2003
 326         - minor optimizations and code cleanup
 327                 -- improved maintainability by reducing #ifdef's
 328                 -- sha1 transform code now easier to follow
 329         - streamlined shadump/shaload file format
 330                 -- eliminated special "HQ" entry
 331                 -- state now held in "H" for all transforms
 332                 -- supplied "fixdump" utility to convert old format
 333         - SHA-384/512 functions now return NULL for no 64-bit operations
 334                 -- previously they were undefined
 335                 -- no longer necessary to use eval's to test for presence
 336
 337 2.2   Sun Nov 16 01:54:00 MST 2003
 338         - optimized the performance of the SHA-1 transform
 339                 -- around 20-30% faster than previous version
 340                 -- achieved by loop unrolling and assignment consolidation
 341         - enhanced shaload/shadump to allow interaction with stdin/stdout
 342                 -- "$filename" argument now optional
 343
 344 2.1   Sun Nov  9 03:28:04 MST 2003
 345         - simplified data input routines
 346                 -- length argument now optional for byte data
 347                         (special thanks to Jeffrey Friedl for this idea)
 348                 -- interface still compatible with earlier versions
 349                         -- changes will not affect existing client code
 350         - streamlined underlying C code for easier maintenance
 351         - provided additional tests for persistent data
 352
 353 2.0   Sat Nov  1 03:55:36 MST 2003
 354         - added functions for HMAC-SHA-1/256/384/512 (FIPS PUB 198)
 355         - shadump/shaload files now compatible between 32/64-bit machines
 356
 357 1.01  Sat Oct 25 02:44:55 MST 2003
 358         - package now downloads and installs much faster
 359         - reduced distribution size by 80%
 360                 -- pruned extensive NIST vectors to a useful subset
 361                 -- still possible to test all vectors if desired
 362                         --- see "t/nist/COPYRIGHT" file for details
 363         - added routines to provide persistent storage of SHA states
 364                 -- shadump() and shaload()
 365         - reduced runtime of large bitstring tests (gillogly-hard)
 366                 -- illustrates usefulness of shadump()/shaload()
 367
 368 1.0   Sat Oct 18 17:35:07 MST 2003
 369         - documentation fixes
 370         - code cleanup: no more compiler warnings from gcc -Wall
 371         - added code to allow reading of intermediate digest state
 372                 -- shahex() prior to shafinish() returns current state
 373
 374 0.9   Thu Oct  9 20:43:54 MST 2003
 375         - version updated to reflect portability check and passing
 376                 of all tests (1401)
 377
 378 0.01  Wed Oct  8 22:28:05 2003
 379         - original version; created by h2xs 1.22 with options
 380                 -x -A -n Digest::SHA sha.h