From: Richard Levitte <levitte@openssl.org>
Date: Fri, 27 Nov 2015 13:19:27 +0000 (+0100)
Subject: Document the changed HMAC API.
X-Git-Tag: OpenSSL_1_1_0-pre1~117
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=9b6c00707eae2cbce79479f4b1a5dc11019abca0;p=oweals%2Fopenssl.git

Document the changed HMAC API.

Reviewed-by: Rich Salz <rsalz@openssl.org>
---

diff --git a/doc/crypto/hmac.pod b/doc/crypto/hmac.pod
index 753617a4f1..203540f524 100644
--- a/doc/crypto/hmac.pod
+++ b/doc/crypto/hmac.pod
@@ -12,7 +12,7 @@ HMAC, HMAC_CTX_init, HMAC_Init, HMAC_Init_ex, HMAC_Update, HMAC_Final, HMAC_CTX_
                int key_len, const unsigned char *d, int n,
                unsigned char *md, unsigned int *md_len);
 
- void HMAC_CTX_init(HMAC_CTX *ctx);
+ int HMAC_CTX_init(HMAC_CTX *ctx);
 
  int HMAC_Init(HMAC_CTX *ctx, const void *key, int key_len,
                const EVP_MD *md);
@@ -74,10 +74,10 @@ must have space for the hash function output.
 HMAC() returns a pointer to the message authentication code or NULL if
 an error occurred.
 
-HMAC_Init_ex(), HMAC_Update() and HMAC_Final() return 1 for success or 0 if
-an error occurred.
+HMAC_CTX_init(), HMAC_Init_ex(), HMAC_Update() and HMAC_Final() return 1
+for success or 0 if an error occurred.
 
-HMAC_CTX_init() and HMAC_CTX_cleanup() do not return values.
+HMAC_CTX_cleanup() do not return values.
 
 =head1 CONFORMING TO
 
@@ -89,6 +89,8 @@ L<sha(3)>, L<evp(3)>
 
 =head1 HISTORY
 
+HMAC_CTX_init() did not return a value in OpenSSL versions before 1.1.
+
 HMAC_Init_ex(), HMAC_Update() and HMAC_Final() did not return values in
 versions of OpenSSL before 1.0.0.