Update NSS to NSS_3_15_BETA2.

nss/lib/freebl/blapi.h

 /*
  * crypto.h - public data structures and prototypes for the crypto library
  *
  * This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
 /* $Id$ */
 
 #ifndef _BLAPI_H_
 #define _BLAPI_H_
@@ skipping 857 matching lines @@
 **      "cx" the context
 **      "digest" where the 16 bytes of digest data are stored
 **      "digestLen" where the digest length (16) is stored
 **      "maxDigestLen" the maximum amount of data that can ever be
 **         stored in "digest"
 */
 extern void MD5_End(MD5Context *cx, unsigned char *digest,
                     unsigned int *digestLen, unsigned int maxDigestLen);
 
 /*
-** Export the raw state of the MD5 hash without appending the standard padding
-** and length bytes. Produce the digested results in "digest"
+** Export the current state of the MD5 hash without appending the standard
+** padding and length bytes. Produce the digested results in "digest"
 **      "cx" the context
 **      "digest" where the 16 bytes of digest data are stored
 **      "digestLen" where the digest length (16) is stored (optional)
 **      "maxDigestLen" the maximum amount of data that can ever be
 **         stored in "digest"
 */
 extern void MD5_EndRaw(MD5Context *cx, unsigned char *digest,
                        unsigned int *digestLen, unsigned int maxDigestLen);
 
 /*
@@ skipping 147 matching lines @@
 **      "digest" where the 16 bytes of digest data are stored
 **      "digestLen" where the digest length (20) is stored
 **      "maxDigestLen" the maximum amount of data that can ever be
 **         stored in "digest"
 */
 extern void SHA1_End(SHA1Context *cx, unsigned char *digest,
                      unsigned int *digestLen, unsigned int maxDigestLen);
 
 /*
 ** Export the current state of the SHA-1 hash without appending the standard
-** padding and length. Produce the digested results in "digest"
+** padding and length bytes. Produce the digested results in "digest"
 **      "cx" the context
-**      "digest" where the 16 bytes of digest data are stored
+**      "digest" where the 20 bytes of digest data are stored
 **      "digestLen" where the digest length (20) is stored (optional)
 **      "maxDigestLen" the maximum amount of data that can ever be
 **         stored in "digest"
 */
 extern void SHA1_EndRaw(SHA1Context *cx, unsigned char *digest,
                         unsigned int *digestLen, unsigned int maxDigestLen);
 
 /*
 ** trace the intermediate state info of the SHA1 hash.
 */
@@ skipping 25 matching lines @@
 
 /******************************************/
 
 extern SHA224Context *SHA224_NewContext(void);
 extern void SHA224_DestroyContext(SHA224Context *cx, PRBool freeit);
 extern void SHA224_Begin(SHA224Context *cx);
 extern void SHA224_Update(SHA224Context *cx, const unsigned char *input,
                         unsigned int inputLen);
 extern void SHA224_End(SHA224Context *cx, unsigned char *digest,
                      unsigned int *digestLen, unsigned int maxDigestLen);
+/*
+** Export the current state of the SHA-224 hash without appending the standard
+** padding and length bytes. Produce the digested results in "digest"
+**      "cx" the context
+**      "digest" where the 28 bytes of digest data are stored
+**      "digestLen" where the digest length (28) is stored (optional)
+**      "maxDigestLen" the maximum amount of data that can ever be
+**         stored in "digest"
+*/
 extern void SHA224_EndRaw(SHA224Context *cx, unsigned char *digest,
                           unsigned int *digestLen, unsigned int maxDigestLen);
 extern SECStatus SHA224_HashBuf(unsigned char *dest, const unsigned char *src,
                               uint32 src_length);
 extern SECStatus SHA224_Hash(unsigned char *dest, const char *src);
 extern void SHA224_TraceState(SHA224Context *cx);
 extern unsigned int SHA224_FlattenSize(SHA224Context *cx);
 extern SECStatus SHA224_Flatten(SHA224Context *cx,unsigned char *space);
 extern SHA224Context * SHA224_Resurrect(unsigned char *space, void *arg);
 extern void SHA224_Clone(SHA224Context *dest, SHA224Context *src);
 
 /******************************************/
 
 extern SHA256Context *SHA256_NewContext(void);
 extern void SHA256_DestroyContext(SHA256Context *cx, PRBool freeit);
 extern void SHA256_Begin(SHA256Context *cx);
 extern void SHA256_Update(SHA256Context *cx, const unsigned char *input,
                         unsigned int inputLen);
 extern void SHA256_End(SHA256Context *cx, unsigned char *digest,
                      unsigned int *digestLen, unsigned int maxDigestLen);
+/*
+** Export the current state of the SHA-256 hash without appending the standard
+** padding and length bytes. Produce the digested results in "digest"
+**      "cx" the context
+**      "digest" where the 32 bytes of digest data are stored
+**      "digestLen" where the digest length (32) is stored (optional)
+**      "maxDigestLen" the maximum amount of data that can ever be
+**         stored in "digest"
+*/
 extern void SHA256_EndRaw(SHA256Context *cx, unsigned char *digest,
                           unsigned int *digestLen, unsigned int maxDigestLen);
 extern SECStatus SHA256_HashBuf(unsigned char *dest, const unsigned char *src,
                               uint32 src_length);
 extern SECStatus SHA256_Hash(unsigned char *dest, const char *src);
 extern void SHA256_TraceState(SHA256Context *cx);
 extern unsigned int SHA256_FlattenSize(SHA256Context *cx);
 extern SECStatus SHA256_Flatten(SHA256Context *cx,unsigned char *space);
 extern SHA256Context * SHA256_Resurrect(unsigned char *space, void *arg);
 extern void SHA256_Clone(SHA256Context *dest, SHA256Context *src);
 
 /******************************************/
 
 extern SHA512Context *SHA512_NewContext(void);
 extern void SHA512_DestroyContext(SHA512Context *cx, PRBool freeit);
 extern void SHA512_Begin(SHA512Context *cx);
 extern void SHA512_Update(SHA512Context *cx, const unsigned char *input,
                         unsigned int inputLen);
+/*
+** Export the current state of the SHA-512 hash without appending the standard
+** padding and length bytes. Produce the digested results in "digest"
+**      "cx" the context
+**      "digest" where the 64 bytes of digest data are stored
+**      "digestLen" where the digest length (64) is stored (optional)
+**      "maxDigestLen" the maximum amount of data that can ever be
+**         stored in "digest"
+*/
 extern void SHA512_EndRaw(SHA512Context *cx, unsigned char *digest,
                           unsigned int *digestLen, unsigned int maxDigestLen);
 extern void SHA512_End(SHA512Context *cx, unsigned char *digest,
                      unsigned int *digestLen, unsigned int maxDigestLen);
 extern SECStatus SHA512_HashBuf(unsigned char *dest, const unsigned char *src,
                               uint32 src_length);
 extern SECStatus SHA512_Hash(unsigned char *dest, const char *src);
 extern void SHA512_TraceState(SHA512Context *cx);
 extern unsigned int SHA512_FlattenSize(SHA512Context *cx);
 extern SECStatus SHA512_Flatten(SHA512Context *cx,unsigned char *space);
 extern SHA512Context * SHA512_Resurrect(unsigned char *space, void *arg);
 extern void SHA512_Clone(SHA512Context *dest, SHA512Context *src);
 
 /******************************************/
 
 extern SHA384Context *SHA384_NewContext(void);
 extern void SHA384_DestroyContext(SHA384Context *cx, PRBool freeit);
 extern void SHA384_Begin(SHA384Context *cx);
 extern void SHA384_Update(SHA384Context *cx, const unsigned char *input,
                         unsigned int inputLen);
 extern void SHA384_End(SHA384Context *cx, unsigned char *digest,
                      unsigned int *digestLen, unsigned int maxDigestLen);
+/*
+** Export the current state of the SHA-384 hash without appending the standard
+** padding and length bytes. Produce the digested results in "digest"
+**      "cx" the context
+**      "digest" where the 48 bytes of digest data are stored
+**      "digestLen" where the digest length (48) is stored (optional)
+**      "maxDigestLen" the maximum amount of data that can ever be
+**         stored in "digest"
+*/
 extern void SHA384_EndRaw(SHA384Context *cx, unsigned char *digest,
                           unsigned int *digestLen, unsigned int maxDigestLen);
 extern SECStatus SHA384_HashBuf(unsigned char *dest, const unsigned char *src,
                               uint32 src_length);
 extern SECStatus SHA384_Hash(unsigned char *dest, const char *src);
 extern void SHA384_TraceState(SHA384Context *cx);
 extern unsigned int SHA384_FlattenSize(SHA384Context *cx);
 extern SECStatus SHA384_Flatten(SHA384Context *cx,unsigned char *space);
 extern SHA384Context * SHA384_Resurrect(unsigned char *space, void *arg);
 extern void SHA384_Clone(SHA384Context *dest, SHA384Context *src);
@@ skipping 204 matching lines @@
 PRBool BLAPI_VerifySelf(const char *name);
 
 /*********************************************************************/
 extern const SECHashObject * HASH_GetRawHashObject(HASH_HashType hashType);
 
 extern void BL_SetForkState(PRBool forked);
 
 SEC_END_PROTOS
 
 #endif /* _BLAPI_H_ */