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: master-post-reformat~348
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=5aed169305941fb1eba15fd4bacc0f998b0e43f7;p=oweals%2Fopenssl.git

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>
---

diff --git a/doc/crypto/EVP_BytesToKey.pod b/doc/crypto/EVP_BytesToKey.pod
index d07ae6c7b5..cd3aa027ee 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