Update CRYPTO_set_mem_debug() doc
authorRich Salz <rsalz@openssl.org>
Thu, 3 Nov 2016 17:16:26 +0000 (13:16 -0400)
committerRich Salz <rsalz@openssl.org>
Thu, 3 Nov 2016 19:25:22 +0000 (15:25 -0400)
Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/1842)
(cherry picked from commit 00bb5504cc62693e05ff4e699f379011c55ecc84)

doc/crypto/OPENSSL_malloc.pod

index 50f09751cf916e93aae792e1f57fd875d2fda6c0..2104f43108f1506e62a59e6fc56470fa40717589 100644 (file)
@@ -135,8 +135,10 @@ at build-time).
 This adds some overhead by keeping a list of all memory allocations, and
 removes items from the list when they are free'd.
 This is most useful for identifying memory leaks.
-CRYPTO_set_mem_debug() turns this tracking on and off.  It is normally
-called at startup, but can be called at any time.
+CRYPTO_set_mem_debug() turns this tracking on and off.  In order to have
+any effect, is must be called before any of the allocation functions
+(e.g., CRYPTO_malloc()) are called, and is therefore normally one of the
+first lines of main() in an application.
 
 CRYPTO_mem_ctrl() provides fine-grained control of memory leak tracking.
 To enable tracking call CRYPTO_mem_ctrl() with a B<mode> argument of