diff options
author | Nikos Mavrogiannopoulos <nmav@redhat.com> | 2017-05-24 11:48:24 +0200 |
---|---|---|
committer | Nikos Mavrogiannopoulos <nmav@redhat.com> | 2017-05-24 14:17:40 +0200 |
commit | 3ade67eb6859a5a074f981480e5663ea92a59380 (patch) | |
tree | 6e69844ea88cdb8f2c57396b0460f5fa25a3c197 | |
parent | 023a20d21b762918d3e1ab25a207ecf874ba21a9 (diff) | |
download | gnutls-3ade67eb6859a5a074f981480e5663ea92a59380.tar.gz |
gnutls_ocsp_status_request_enable_client: documented requirements for parameters
That is, the fact that extensions and responder_id parameters must be
allocated, and are assigned to the session.
Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
-rw-r--r-- | lib/ext/status_request.c | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/lib/ext/status_request.c b/lib/ext/status_request.c index c7c065e5e4..a1f3521c8b 100644 --- a/lib/ext/status_request.c +++ b/lib/ext/status_request.c @@ -266,9 +266,15 @@ _gnutls_status_request_recv_params(gnutls_session_t session, * * This function is to be used by clients to request OCSP response * from the server, using the "status_request" TLS extension. Only - * OCSP status type is supported. A typical server has a single - * OCSP response cached, so @responder_id and @extensions - * should be null. + * OCSP status type is supported. + * + * The @responder_id array, its containing elements as well as + * the data of @extensions, must be allocated using gnutls_malloc(). They + * will be deinitialized on session cleanup. + * + * Due to the difficult semantics of the @responder_id and @extensions + * parameters, it is recommended to only call this function with these + * parameters set to %NULL. * * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, * otherwise a negative error code is returned. |