PATH:
usr
/
share
/
doc
/
perl-Digest-SHA-5.85
Revision history for Perl extension Digest::SHA. 5.85 Wed Jun 26 04:05:26 MST 2013 - workaround for repeated calls to shaclose (ref. Bug #86295) -- need to explicitly reset internal pointer to NULL ref. shaclose() in SHA.xs - corrected typos in shasum script -- ref. Bug #85430 5.84 Sat Mar 9 17:36:08 MST 2013 - untweaked Makefile.PL to remove dependencies of SHA.c -- dependencies were breaking builds on VMS -- retaining dependencies provides too little benefit for cost of portable workaround 5.83 Mon Mar 4 08:12:00 MST 2013 - removed code for standalone C operation (no longer used) -- eliminates need for external symbols -- consolidates SHA and HMAC code -- reduces size of object files -- thanks to Marc Lehmann for suggestions - tweaked Makefile.PL to show dependencies of SHA.c 5.82 Thu Jan 24 04:54:12 MST 2013 - introduced workaround to SvPVbyte bug in Perl 5.6 -- module behavior now consistent under all Perls 5.6+ -- ref: new test script t/unicode.t -- SHA routines now always croak on wide chars (5.6+) - removed "static" message schedules from C code -- default "auto" is now just as fast -- thread-safe option (-t) no longer necessary -- still allowed, but ignored -- simplifies source and header files -- eliminates SHA_STO_CLASS and SHA_THREAD_SAFE -- ref. Bug #82784 -- thanks to Steve Hay for initial patch - provided documentation to describe Unicode handling -- ref: Bug #82378 - updated documentation of NIST statement on SHA-1 5.81 Mon Jan 14 05:17:08 MST 2013 - corrected load subroutine (SHA.pm) to prevent double-free -- Bug #82655: Security issue - segfault -- thanks to Victor Efimov and Nicholas Clark for technical expertise and suggestions 5.80 Mon Dec 10 14:15:26 MST 2012 - obtained noticeable speedup on Intel/gcc -- by setting -O1 and -fomit-frame-pointer -- SHA-1 about 63% faster, SHA-2 improves 11-20% 5.74 Sat Nov 24 03:10:18 MST 2012 - handle wide-string input by converting to bytes first -- viz. use SvPVbyte instead of SvPV in SHA.xs -- thanks to Eric Brine for summary and code 5.73 Wed Oct 31 04:32:44 MST 2012 - provided workaround for DEC compiler bug (ref. Makefile.PL) 5.72 Mon Sep 24 15:22:08 MST 2012 - adjusted module installation directory for later Perls -- As of 5.11 Perl searches 'site' first, so use that -- ref. INSTALLDIRS in Makefile.PL -- thanks to Robert Sedlacek for patch 5.71 Wed Feb 29 04:06:10 MST 2012 - prevented $! from getting clobbered in _bail() routine -- thanks to Zefram for patch - added example of BITS mode usage to shasum documentation 5.70 Wed Dec 14 02:32:10 MST 2011 - added BITS mode to addfile method and shasum -- partial-byte inputs now possible via files/STDIN -- allows shasum to check all 8074 NIST Msg vectors -- previously required special programming 5.63 Tue Nov 8 02:36:42 MST 2011 - added code to allow very large data inputs all at once -- previously limited to several hundred MB at a time -- many thanks to Thomas Drugeon for his elegant patch - removed outdated reference URLs from several test scripts -- these URLs aren't essential, and often go stale -- thanks to Leon Brocard for spotting this -- ref. rt.cpan.org #68740 5.62 Sat May 14 04:00:34 MST 2011 - removed unnecessary loading of MIME::Base64 module -- thanks to dolmen for pointing this out 5.61 Wed Mar 9 05:26:36 MST 2011 - corrected bug in 'algorithm' method - fixed -x option in Makefile.PL -- not often used since it deliberately excludes all 64-bit SHA transforms - addressed minor documentation oversights 5.60 Thu Mar 3 05:26:42 MST 2011 - added new SHA-512/224 and SHA-512/256 transforms -- ref. NIST Draft FIPS 180-4 (February 2011) - simplified shasum by removing duplicative text - improved efficiency of Addfile -- expensive -T test now occurs only in portable mode 5.50 Tue Dec 14 06:20:08 MST 2010 - adopted convention that '-' always means STDIN -- actual filename '-' accessed as './-' -- accords with behavior of sha1sum/md5sum - corrected undefined subroutine oversight in shasum -- inadvertent migration of _bail() from SHA.pm 5.49 Sun Dec 12 07:22:04 MST 2010 - modified Addfile to accept all POSIX filenames -- standard allows all characters except NUL and '/' - updated shasum to more closely mimic sha1sum/md5sum -- added "backslash processing" to handle newlines and backslashes in filenames -- now accepts all POSIX filenames via Addfile -- thanks to Sean Burke for identifying edge cases 5.48 Mon Jan 4 16:32:52 MST 2010 - fixed "shasum -a0" option (ref. rt.cpan.org #53319) -- incorrectly accepted 0 as a valid algorithm -- thanks to Zefram for patch - updated URL for NIST test vectors -- ref. files t/nistbit.t, t/nistbyte.t -- thanks to Leon Brocard for patch 5.47 Wed Apr 30 04:00:54 MST 2008 - modified Makefile.PL to install in core for Perls >= 5.10 -- thanks to Jerry Hedden for patch - changed from #include <> to #include "" in SHA.xs -- some platforms not able to find SHA source files -- thanks to Alexandr Ciornii for testing - moved .pm file to appropriate lib directory - minor addition to META.yml 5.46 Wed Apr 9 05:04:00 MST 2008 - modified Addfile to recognize leading and trailing whitespace in filenames (ref. rt.cpan.org #34690) - minor C source code modification (ref. hmac.c) - use const in sha.c for clean builds with -Wwrite-strings -- thanks to Robin Barker for patch 5.45 Tue Jun 26 02:36:00 MST 2007 - extended portability to earlier Perls -- works on Perl 5.003 and later -- thanks to Jim Doble for testing on legacy platforms - updated META.yml to conform to current META spec (1.3) - minor documentation fixes 5.44 Sat Oct 14 00:42:44 MST 2006 - removed SIGNATURE file from distribution -- spurious errors from CPANPLUS can break build - eliminated ppport.h header file -- significantly reduces size of distribution - modified C functions in src/hmac.c to use ANSI prototypes -- thanks to Jarkko Hietaniemi for patch 5.43 Sat Aug 5 02:36:18 MST 2006 - undid Perl Best Practice of favoring 3-argument "open" -- 3-arg version uses different semantics for "-" causing bugs in addfile and shasum - modified underlying C functions to use ANSI prototypes -- requested by Steve Hay (ref. Smoke [5.9.4] 28630) -- K&R style was causing numerous warnings from Borland compiler 5.42 Mon Jul 24 04:04:40 MST 2006 - minor code changes suggested by Perl::Critic -- e.g. no bareword filehandles, no 2-argument open's - updated public key (ref. B538C51C) -- previous one (0AF563FE) expired July 2, 2006 - added documentation to warn that Base64 digests are NOT padded -- padding must be done by user if interoperability with other software is required 5.41 Sat Jun 3 01:50:46 MST 2006 - corrected addfile -- process $file argument as a filehandle unless passed as a SCALAR (which indicates a file name) 5.40 Fri Jun 2 04:00:30 MST 2006 - modified addfile to accept indirect filehandles -- ref. rt.cpan.org #19627 and #19641 5.39 Sun May 28 03:22:24 MST 2006 - modified shasum to warn rather than die for file errors -- to follow conventions of GNU sha1sum/md5sum 5.38 Thu May 25 02:02:02 MST 2006 - added new capabilities to the "addfile" method -- now able to accept file names as well as handles -- includes mode for portable digest calculation -- thanks to Adam Kennedy for emails and ideas ref. File::LocalizeNewlines - used expanded addfile interface to simplify shasum (sumfile) -- regex a tad less general than 5.37, but handles all known newline variants in UNIX/Windows/MacOS - enhanced WARNING messages from shasum checkfile processing -- to mimic behavior of md5sum 5.37 Mon May 8 04:30:09 MST 2006 - modified shasum to avoid file slurping (ref. sub sumfile) - improved error handling of checksum files in shasum -- to better mimic the behavior of md5sum - refined line-break regex in shasum (ref. sub sumfile) -- catches multiple CR's preceding LF thanks to Gisle Aas for suggested patch - changed loop vars to signed int's in shadump (ref. src/sha.c) -- to prevent type mismatch warnings 5.36 Mon May 8 01:38:36 MST 2006 - fixed the "portable" option in shasum -- normalize line-breaks in text files only 5.35 Thu May 4 16:54:42 MST 2006 - added "portable" option to shasum -- to make digests match across Windows/Unix/MacOS - enabled bundling of shasum command line options -- to mimic behavior of md5sum - removed \r's from text files in t/nist directory -- resolves SIGNATURE clashes (rt.cpan.org #18983) - changed suffix on SHA64_MAX (src/sha.h) to ULL -- eliminates gcc warnings (rt.cpan.org #18988) - specified minimum Perl version for module and Makefile.PL -- closes rt.cpan.org #18984 5.34 Thu Feb 2 18:55:40 MST 2006 - removed Unix-style pathnames in test scripts -- causing problems on OpenVMS -- thanks to Steve Peters for patch - included latest version of Perl Portability header (ppport.h) - added PERL_CORE check to test scripts -- allows module to be built into Perl distribution 5.32 Fri Dec 2 02:32:20 MST 2005 - added POD section to shasum script -- thanks to Gunnar Wolf for patch - made minor code changes to silence compiler warnings -- resulting from signed/unsigned integer mixing - inserted code in test scripts for POD checking -- to recover gracefully if Test::More isn't installed 5.31 Mon Sep 5 00:52:42 MST 2005 - added standard tests for pod and pod-coverage checking - inserted subtest to check for failure when using unrecognized SHA algorithm 5.30 Sat Aug 20 16:46:08 MST 2005 - updated docs with recent NIST statement on SHA-1 -- advises use of larger and stronger hash functions (i.e. SHA-224/256/384/512) for new developments 5.29 Sun Aug 14 04:48:34 MST 2005 - added explicit casts in "shaload" routine (ref. "ldvals") -- thanks to E. Allen Smith for pointing out SGI compiler warnings on IPxx-irix platforms - updated docs with cautionary note about SHA-1 5.28 Wed Nov 10 15:33:20 MST 2004 - provided more flexible formatting of SHA state files -- entries may now contain embedded whitespace for improved readability - minor code cleanups 5.27 Sun Oct 24 02:54:00 MST 2004 - minor code cleanups -- reduces size of dump files for SHA-1/224/256 5.26 Thu Oct 7 14:52:00 MST 2004 - streamlined distribution -- reduced NIST vector tests from 200 to 20 -- former number was overkill -- distro now downloads and builds more quickly - rewrote SYNOPSIS sections in pod file - made additional tweaks to t/8-shasum.t for portability - cleaned up test scripts 5.25 Sun Sep 12 18:48:00 MST 2004 - removed non-essential test script -- t/8-shasum.t causes problems on sparc64-linux - reverted to using eval "require $module" in shasum 5.24 Sun Sep 12 02:50:18 MST 2004 - modified shasum to use barewords in "require" statements -- ref. perl.cpan.testers (157305) 5.23 Thu Sep 9 23:06:18 MST 2004 - corrected bug in test script -- use blib when invoking perl as an external command in t/8-shasum.t 5.22 Tue Sep 7 19:12:40 MST 2004 - broadened SHA-384/512 support -- to compilers with no ULLONG_MAX in limits.h -- e.g IBM C (xlC 6.0.0) on AIX 4.3.3 -- thanks to Chris Carey for suggestions and technical expertise - improved use of static storage class in transforms -- detection of Intel arch. now done in Makefile.PL -- NB: static not used if compiling for thread safety - minor changes to documentation 5.21 Mon Aug 23 04:02:00 MST 2004 - removed 64-bit constant expressions from #if statements -- ref. src/sha.h (lines 55, 58, and 61) -- even if compiler supports long long's, preprocessor may use long's when evaluating expressions - improved test script for "shasum" (t/8-shasum.t) -- exercises check file option (-c) 5.20 Sun Aug 15 04:24:48 MST 2004 - introduced "shasum" script -- mimics the usage and behavior of "md5sum" -- adds "-a" option to select SHA algorithm -- for help, just type "shasum -h" 5.10 Fri Aug 6 02:04:38 MST 2004 - simplified module documentation -- made it consistent with Digest::SHA::PurePerl docs 5.03 Sat Jul 31 00:00:48 MST 2004 - corrected HMAC-SHA-384/512 bug (cpan #7181, Adam Woodbury) -- code was using hardwired blocksize for SHA-1/256 -- ref. src/hmac.c, src/hmac.h 5.02 Thu Jul 29 02:48:00 MST 2004 - updated documentation and "dump-load.t" test script -- to be consistent with Digest::SHA::PurePerl - included a SIGNATURE file -- for stronger authentication of module contents -- ref. Module::Signature on CPAN - corrected embarrassing misspelling in docs -- apologies to Gisle Aas 5.01 Fri May 21 13:08:12 MST 2004 - check for undefined SHA handle when calling "shaclose()" -- prevents intermittent cleanup errors during global object destruction 5.00 Fri May 14 04:45:00 MST 2004 - minor documentation fixes - restored classical style of version numbering (X.YZ) -- previous X.Y.Z style caused installation difficulties when using CPANPLUS 4.3.3 Wed May 5 00:30:40 MST 2004 - fixed bug in "strto64()" function -- caused problems in state files with CR/LF pairs -- thanks to Martin Thurn for testing support 4.3.2 Wed Apr 28 03:56:00 MST 2004 - added Makefile.PL options -- thread-safety: -t -- exclude 384/512 support: -x -- e.g. perl Makefile.PL -t - temporarily suppress dump/load tests for SHA-384/512 -- pending clarification of problem on sun4u sparc 4.3.1 Thu Mar 4 02:54:00 MST 2004 - removed unused functions from XS file -- reduces size of compiled objects - simplified implementation of Digest::SHA object -- now a blessed SHAPtr ref instead of blessed array ref -- results in slight speed-up of OO operations - streamlined underlying C source -- used macros to consolidate repetitive code - rewrote test scripts to depend on Test rather than Test::More -- allows module to be checked in minimal Perl environments - added compilation option for thread-safety -- overrides use of static arrays 4.3.0 Sat Feb 7 02:58:00 MST 2004 - included SHA-384/512 support if using Microsoft C/C++ -- uses MSVC's __int64 in place of "long long" - enhanced portability and efficiency on diverse platforms -- automatically sets up optimal types for 32/64-bit ops - improved test scripts for better reporting -- many thanks to Alex Muntada for helpful suggestions 4.2.2 Sat Jan 31 17:10:20 MST 2004 - repaired 32-bit SHA operations for 8-byte longs 4.2.1 Sat Jan 24 00:56:54 MST 2004 - modified I/O and memory management in underlying C code -- uses Perl libraries when compiled as CPAN module -- otherwise defaults to ANSI C libraries -- bypasses problems in MSWin multi-threaded Perls -- avoids "Free to wrong pool" error -- special thanks to Robert Gilmour and Brian Gladman for technical guidance and testing 4.2.0 Sat Dec 27 16:08:00 MST 2003 - added support for recently-announced SHA-224 algorithm -- ref. FIPS 180-2 Change Notice 1 -- also includes HMAC-SHA-224 4.1.0 Thu Dec 25 00:58:00 MST 2003 - repaired "nist-vectors" test scripts for MSWin32 portability -- use binmode for data files 4.0.9 Wed Dec 24 02:58:22 MST 2003 - use canonical file specs in test scripts -- enhances portability across different OSes - modify type declarations of objects in XS file -- re-declare as (SV *) and cast to (AV *) SvRV(self) -- in response to AVPtr problem on MSWin32 4.0.8 Thu Dec 18 23:32:00 MST 2003 - inherits from Digest::base if installed -- also checks for MIME::Base64 -- still fully-functional if neither are installed - added buffer overflow protection in underlying C code -- ref. shahex() and shabase64() routines -- prior code appeared impossible to exploit, but ... -- better safe than sorry -- does not impact runtime efficiency - minor code cleanup 4.0.7 Sat Dec 13 00:48:24 MST 2003 - check for undefined SHA handle when calling "shaclose()" -- was causing cleanup err during global destruction 4.0.6 Thu Dec 11 02:18:00 MST 2003 - more optimization and streamlining -- a bit faster on non-big-endians (e.g. Intel) - rewrote time-critical functions and methods in XS - removed unused C functions from source files 4.0.5 Sat Dec 6 00:02:24 MST 2003 - performance optimizations -- rewrote "add" method in XS -- unrolled loops in sha256 transform 4.0.4 Thu Dec 4 00:07:00 MST 2003 - made Digest::SHA into a self-contained module -- no longer depends on Digest::base -- more convenient for users -- no need to install Digest:: module 4.0.3 Wed Dec 3 00:01:20 MST 2003 - Digest::SHA now a subclass of Digest::base -- inherits hexdigest/b64digest/addfile methods - added "hashsize" method - removed old "shaopen()/shawrite()/..." legacy code -- in favor of standard, streamlined OO interface - renamed test vector files from NIST -- prevents problems on 8+3 filesystems - added test for Dave Ireland's SHA-256 vector 4.0.0 Sat Nov 29 21:14:09 MST 2003 - major streamlining of interface (hence, major version change) -- coordinated with Gisle Aas and J. Duque -- goal is to produce a single SHA module -- adheres to OO and functional styles of Digest:: -- greatly reduces the number of interface functions -- old functions still supported -- use Digest::SHA ':legacy' -- will be deprecated in near future - rewrote all test scripts to match new interface -- very easy to modify all 281 tests -- old interface maps cleanly to new one 3.0 Wed Nov 26 05:02:34 MST 2003 - added functions that conform to Digest:: interface -- both functional and OO styles -- byte-oriented data only -- continue to support original interface as well -- necessary for bit-oriented data - supplied formal test vectors for HMAC-SHA-256 -- from draft-ietf-ipsec-ciph-sha-256-01.txt - included tests for all OO methods 2.4 Sat Nov 22 17:10:22 MST 2003 - code cleanup -- "sha.c" now completely free of #ifdef's - modularized all 64-bit (long long) code - improved readability of header files - simplified logic of "fixdump" utility 2.3 Wed Nov 19 03:54:31 MST 2003 - minor optimizations and code cleanup -- improved maintainability by reducing #ifdef's -- sha1 transform code now easier to follow - streamlined shadump/shaload file format -- eliminated special "HQ" entry -- state now held in "H" for all transforms -- supplied "fixdump" utility to convert old format - SHA-384/512 functions now return NULL for no 64-bit operations -- previously they were undefined -- no longer necessary to use eval's to test for presence 2.2 Sun Nov 16 01:54:00 MST 2003 - optimized the performance of the SHA-1 transform -- around 20-30% faster than previous version -- achieved by loop unrolling and assignment consolidation - enhanced shaload/shadump to allow interaction with stdin/stdout -- "$filename" argument now optional 2.1 Sun Nov 9 03:28:04 MST 2003 - simplified data input routines -- length argument now optional for byte data (special thanks to Jeffrey Friedl for this idea) -- interface still compatible with earlier versions -- changes will not affect existing client code - streamlined underlying C code for easier maintenance - provided additional tests for persistent data 2.0 Sat Nov 1 03:55:36 MST 2003 - added functions for HMAC-SHA-1/256/384/512 (FIPS PUB 198) - shadump/shaload files now compatible between 32/64-bit machines 1.01 Sat Oct 25 02:44:55 MST 2003 - package now downloads and installs much faster - reduced distribution size by 80% -- pruned extensive NIST vectors to a useful subset -- still possible to test all vectors if desired --- see "t/nist/COPYRIGHT" file for details - added routines to provide persistent storage of SHA states -- shadump() and shaload() - reduced runtime of large bitstring tests (gillogly-hard) -- illustrates usefulness of shadump()/shaload() 1.0 Sat Oct 18 17:35:07 MST 2003 - documentation fixes - code cleanup: no more compiler warnings from gcc -Wall - added code to allow reading of intermediate digest state -- shahex() prior to shafinish() returns current state 0.9 Thu Oct 9 20:43:54 MST 2003 - version updated to reflect portability check and passing of all tests (1401) 0.01 Wed Oct 8 22:28:05 2003 - original version; created by h2xs 1.22 with options -x -A -n Digest::SHA sha.h
[-] Changes
[edit]
[+]
..
[-] README
[edit]
[+]
examples