From: Nick Mathewson <nickm@torproject.org>
Date: Tue, 26 May 2015 13:46:57 +0000 (-0400)
Subject: Add a documentation clarification suggested by Matt Caswell
X-Git-Tag: OpenSSL_1_1_0-pre1~1067
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=9ef175148b7da12cb09f5e78f32bc6ab58d78b83;p=oweals%2Fopenssl.git

Add a documentation clarification suggested by Matt Caswell

Signed-off-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Tim Hudson <tjh@openssl.org>
---

diff --git a/doc/ssl/SSL_get_ciphers.pod b/doc/ssl/SSL_get_ciphers.pod
index f2a81037c0..341745436d 100644
--- a/doc/ssl/SSL_get_ciphers.pod
+++ b/doc/ssl/SSL_get_ciphers.pod
@@ -35,6 +35,11 @@ the L<SSL_CIPHER_get_name(3)|SSL_CIPHER_get_name(3)> family of functions.
 Call SSL_get_cipher_list() with B<priority> starting from 0 to obtain the
 sorted list of available ciphers, until NULL is returned.
 
+Note: SSL_get_ciphers() and SSL_get_client_ciphers() return a pointer
+to an internal cipher stack, which will be freed later on when the SSL
+or SSL_SESSION object is freed.  Therefore, the calling code B<MUST
+NOT> free the return value itself.
+
 =head1 RETURN VALUES
 
 See DESCRIPTION