Warn about the use of BUF_strdup.

1 files changed, 4 insertions, 2 deletions

diff --git a/src/lib/libssl/src/doc/crypto/BUF_MEM_new.pod b/src/lib/libssl/src/doc/crypto/BUF_MEM_new.pod
index a83f46f896..2805755869 100644
--- a/src/lib/libssl/src/doc/crypto/BUF_MEM_new.pod
+++ b/src/lib/libssl/src/doc/crypto/BUF_MEM_new.pod
@@ -45,10 +45,12 @@ B<len>. Any data already in the buffer is preserved if it increases in
 size.
 
 BUF_strdup() copies a null terminated string into a block of allocated memory
-and returns a pointer to the allocated block.
+and returns a pointer to the allocated block. Unlike the system strdup()
+function, BUF_strdup() will accept a NULL argument and will return NULL in
+that case. Its use in new programes is discouraged.
 
 The memory allocated from BUF_strdup() should be freed up using the
-OPENSSL_free() function.
+free() function.
 
 =head1 RETURN VALUES