OSSL_PARAM.pod: document the mechanism to figure out buffer sizes
authorRichard Levitte <levitte@openssl.org>
Thu, 26 Sep 2019 05:42:06 +0000 (07:42 +0200)
committerRichard Levitte <levitte@openssl.org>
Fri, 27 Sep 2019 17:03:33 +0000 (19:03 +0200)
commitd4d28783473e5b4417068258f2553896ff618600
tree88c749fe06ff5e82c780e25868f907f20b82d534
parent7960dbec6801c1c98c848b81ca00e73625e8970b
OSSL_PARAM.pod: document the mechanism to figure out buffer sizes

When requesting parameters, it's acceptable to make a first pass with
the |data| field of some parameters being NULL.  That can be used to
help the requestor to figure out dynamically what buffer size is
needed.  For variable size parameters, there's no other way to find
out.

Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/10025)
doc/man3/OSSL_PARAM.pod