1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/security/crypto/weakcryptospi/test/tcryptospi/testdata/hashhmac/readme.txt	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,87 @@
     1.4 +*********************************
     1.5 +"HashGen.pl" README DOCUMENTATION
     1.6 +
     1.7 +Paul Sinfield
     1.8 +v1.0
     1.9 +28/02/2007
    1.10 +*********************************
    1.11 +
    1.12 +The hashgen.pl script generates Hash and Hmac expected Hexadecimal string values for a given source file and the specified secret key.
    1.13 +
    1.14 +The following hash algorithms are supported:
    1.15 +
    1.16 +HASH: MD2/MD4/MD5/SHA-1
    1.17 +HMAC: MD2/MD4/MD5/SHA-1
    1.18 +
    1.19 +
    1.20 +1. Before running the script file, please ensure that the following files have been copied into the "c:\apps\perl\site\lib\digest" directory:
    1.21 +
    1.22 +HMAC-MD2.pm
    1.23 +HMAC-MD4.pm
    1.24 +
    1.25 +
    1.26 +2. The script takes 2 arguments as follows:
    1.27 +
    1.28 +hashgen.pl <Source File Path> <Key>
    1.29 +
    1.30 +e.g. hashgen.pl "C:\testdata\tcryptospi\data\LargeHash-SRC.dat" CryptoSpiValidKey
    1.31 +
    1.32 +NOTE: Please ensure that speech marks ("") are placed around arguments that have spaces in them, such as file paths.
    1.33 +
    1.34 +
    1.35 +3. Once the script has been run, the results will be output a text file with the same name as the source but with a suffix "*_HASHES.txt", within the same directory.
    1.36 +
    1.37 +e.g. LargeHash-SRC_HASHDATA.txt
    1.38 +
    1.39 +An example of the files contents are displayed below:
    1.40 +
    1.41 +****** HASH MD2/MD4/MD5/SHA1 ******
    1.42 +
    1.43 +MD2: 359df8d2cc91db9c8ec0f61718b65a60
    1.44 +MD4: 826598b8fa06b7deafd255280319e38b
    1.45 +MD5: 201f59b84894f378e1cce73abea86ca6
    1.46 +SHA1: 21ef662c79cb3e972a3bb71937381b26e0daa2fc
    1.47 +
    1.48 +****** HMAC MD2/MD4/MD5/SHA1 ******
    1.49 +
    1.50 +HMAC-MD2: 50635299e47531b4913abf986c063054
    1.51 +HMAC-MD4: 9e1734fe8dae94d48a9b8fbdd1b55d3a
    1.52 +HMAC-MD5: 0db3d1f04967261a9761140f44ef0c4a
    1.53 +HMAC-SHA1: 101607c5a079b69c439f307e0590af588c9bf7e2
    1.54 +
    1.55 +Key: CryptoSpiValidKey
    1.56 +
    1.57 +
    1.58 +*********************************
    1.59 +"HashGenSha2.pl" README DOCUMENTATION
    1.60 +
    1.61 +*********************************
    1.62 +
    1.63 +The hashgensha2.pl script generates Hash and Hmac expected Hexadecimal string values for a given source file and the specified secret key for Sha224, Sha256, Sha384 and Sha 512.
    1.64 +
    1.65 +Before Running the script file, ensure that openssl is installed onto the system.
    1.66 +
    1.67 +The script takes 2 arguments as follows:
    1.68 +hashgensha2.pl <Source File>  <Key>
    1.69 +
    1.70 +e.g. hashgen.pl "LargeHash-SRC.dat" CryptoSpiValidKey
    1.71 +
    1.72 +3. Once the script has been run, the results will be output a text file with the same name as the source but with a suffix "*_SHA2HASHDATA.txt", within the same directory.
    1.73 +
    1.74 +e.g. largehash-src_SHA2HASHDATA.txt
    1.75 +
    1.76 +An example of the files contents are displayed below:
    1.77 +****** HASH SHA224/SHA256/SHA384/SHA512 ******
    1.78 +
    1.79 +SHA224(largehash-src.dat)= c363a255fc7db36aeecfcfa6f9790ecb75043a0f5ebe8cc79a3c7a6a
    1.80 +SHA256(largehash-src.dat)= 83b7bc6895df985de5543e8cd2b150232a4b9b4ba093c92fec725a924e4279aa
    1.81 +SHA384(largehash-src.dat)= 7785397e9094c917e76c0ed1cfdb59c073f5ec4d29c503c6c8f28bfde1ee46bd43f21ca7f49b754f6cc94ff37e50798c
    1.82 +SHA512(largehash-src.dat)= e93c8160c1a9888d8a03a8ffa97a3682597789b9e5250a0cffa0ac984c85e557356201068ef5fa3e968a7623597ba65c50248dab70233f68e547bbc03e58e441
    1.83 +
    1.84 +
    1.85 +****** HMAC SHA224/SHA256/SHA384/SHA512 ******
    1.86 +
    1.87 +HMAC-SHA224(largehash-src.dat)= e811df3c4ef67a7ef57baffa7e796a5ec2bfec357eb8ef03dabc9c97
    1.88 +HMAC-SHA256(largehash-src.dat)= 7bdcc4bed110ccafd5b152de05af95441bce9a1e608abb7e46b10c2e7cee7dc9
    1.89 +HMAC-SHA384(largehash-src.dat)= 258d6725d583482bca882af8b8a18f9ec2c002047051beda50d447aedb7721ef0c4511c04a71f82641ce865a2e83dd21
    1.90 +HMAC-SHA512(largehash-src.dat)= 38e9456ce22cb3ba6a642bb9ca2d3c8722dad96397da1cfa6ff072eaf8cd661798be8f9b3af7f2b4e930fc4370351f891a2b938cb4d312faae13cccd06fc302c