From: Rich Salz <rsalz@openssl.org>
Date: Mon, 8 Sep 2014 15:48:34 +0000 (-0400)
Subject: RT3462: Document actions when data==NULL
X-Git-Tag: OpenSSL_1_0_2-pre-reformat~167
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=20d1c8111f5678f8d6211ce013368852b38eb819;p=openssl

RT3462: Document actions when data==NULL

If data is NULL, return the size needed to hold the
derived key.  No other API to do this, so document
the behavior.

Reviewed-by: Richard Levitte <levitte@openssl.org>
(cherry picked from commit 5aed169305941fb1eba15fd4bacc0f998b0e43f7)
---

diff --git a/doc/crypto/EVP_BytesToKey.pod b/doc/crypto/EVP_BytesToKey.pod
index cd09b68ca8..5d6059528e 100644
--- a/doc/crypto/EVP_BytesToKey.pod
+++ b/doc/crypto/EVP_BytesToKey.pod
@@ -55,7 +55,10 @@ the IV.
 
 =head1 RETURN VALUES
 
-EVP_BytesToKey() returns the size of the derived key in bytes, or 0 on error.
+If B<data> is NULL, then EVP_BytesToKey() returns the number of bytes
+needed to store the derived key.
+Otherwise, EVP_BytesToKey() returns the size of the derived key in bytes,
+or 0 on error.
 
 =head1 SEE ALSO