diff options
author | Watson Ladd <watsonbladd@gmail.com> | 2023-05-19 13:55:08 -0700 |
---|---|---|
committer | Tomas Mraz <tomas@openssl.org> | 2023-05-25 15:48:24 +0200 |
commit | eab96453bb145cde8e447f420a4ba099a5fa7004 (patch) | |
tree | 6f9eda122977039ab3289bdc9b9e8189ad723abd /doc | |
parent | 31c94b5e1159b5435b2354e6525355ec33683ecc (diff) | |
download | openssl-eab96453bb145cde8e447f420a4ba099a5fa7004.tar.gz |
Clarify how to return string data
Reviewed-by: Paul Dale <pauli@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21004)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man3/OSSL_PARAM.pod | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/man3/OSSL_PARAM.pod b/doc/man3/OSSL_PARAM.pod index a1a275e092..18da5bf99a 100644 --- a/doc/man3/OSSL_PARAM.pod +++ b/doc/man3/OSSL_PARAM.pod @@ -267,6 +267,14 @@ B<OSSL_PARAM_OCTET_STRING>), but this is in no way mandatory. =item * +If I<data> for a B<OSSL_PARAM_OCTET_STRING> or a +B<OSSL_PARAM_UTF8_STRING> is NULL, the I<responder> should +set I<return_size> to the size of the item to be returned +and return success. Later the responder will be called again +with I<data> pointing at the place for the value to be put. + +=item * + If a I<responder> finds that some data sizes are too small for the requested data, it must set I<return_size> for each such B<OSSL_PARAM> item to the minimum required size, and eventually return |