diff options
author | Nikos Mavrogiannopoulos <nmav@redhat.com> | 2017-05-24 11:48:24 +0200 |
---|---|---|
committer | Nikos Mavrogiannopoulos <nmav@redhat.com> | 2017-05-24 15:02:07 +0200 |
commit | 8566f8935954d3e370f257a6e3c18e9af262f8c2 (patch) | |
tree | 37ec3c6659eaa61bb723c50e329b3632c3700faf | |
parent | 6ce67c9eaa29634e6be02ed6b76ac712c3d212c7 (diff) | |
download | gnutls-8566f8935954d3e370f257a6e3c18e9af262f8c2.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 e16b15c379..54592706e5 100644 --- a/lib/ext/status_request.c +++ b/lib/ext/status_request.c @@ -294,9 +294,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. |