openssl/doc
Daniel McCarney 361c6ee5f5 doc: clarify SSL_CIPHER_description allocation
Previously the documentation for `SSL_CIPHER_description` said:
> If buf is provided, it must be at least 128 bytes, otherwise a buffer
> will be allocated using OPENSSL_malloc().

In reality, `OPENSSL_malloc` is only invoked if the provided `buf`
argument is `NULL`. If the `buf` arg is not `NULL`, but smaller than
128 bytes, the function returns `NULL` without attempting to allocate
a new buffer for the description.

This commit adjusts the documentation to better describe the implemented
behaviour.

CLA: trivial

Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Tom Cosgrove <tom.cosgrove@arm.com>
Reviewed-by: Paul Dale <ppzgs1@gmail.com>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/23921)

(cherry picked from commit 6a4a714045)
2024-04-29 11:07:31 +02:00
..
HOWTO doc: add HOWTO document about Documenting public Functions and Macros 2023-03-29 12:18:07 +02:00
designs ddd-02-conn-nonblocking-threads.c: Fix the leak of conn 2023-12-29 11:40:10 +01:00
images Update OpenSSL logos 2023-11-22 10:38:41 +01:00
internal Fix typo found by codespell in openssl-3.2 2024-02-19 12:22:35 +01:00
life-cycles
man1 openssl-crl(1): The -verify option is implied by -CA* options 2024-04-04 17:45:51 +02:00
man3 doc: clarify SSL_CIPHER_description allocation 2024-04-29 11:07:31 +02:00
man5 Fix typos found by codespell 2023-09-13 08:13:08 +02:00
man7 Be more explicit about RSAES-PKCS#1v1.5 error handling 2024-04-22 15:57:45 +02:00
README.md
build.info OSSL_STORE: Add reference docs for the built-in Windows store implementation 2024-04-19 14:23:40 +02:00
build.info.in
dir-locals.example.el
fingerprints.txt doc/fingerprints.txt: Add the future OpenSSL release key 2024-04-16 16:22:17 +02:00
openssl-c-indent.el
perlvars.pm

README.md

OpenSSL Documentation

README.md This file

fingerprints.txt PGP fingerprints of authorised release signers

standards.txt standards.txt Moved to the web, https://www.openssl.org/docs/standards.html

HOWTO/ A few how-to documents; not necessarily up-to-date

man1/ The openssl command-line tools; start with openssl.pod

man3/ The SSL library and the crypto library

man5/ File formats

man7/ Overviews; start with crypto.pod and ssl.pod, for example Algorithm specific EVP_PKEY documentation.

Formatted versions of the manpages (apps,ssl,crypto) can be found at https://www.openssl.org/docs/manpages.html