diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2022-05-23 19:43:56 +0200 |
---|---|---|
committer | Dr. David von Oheimb <dev@ddvo.net> | 2022-05-30 22:43:44 +0200 |
commit | e8fdb0603572bf051dad6abc56291cdf1313a905 (patch) | |
tree | 323b75ebbf5a6b6013b473911956f8407d4d7565 /doc/man3 | |
parent | 3c58d447497b37f7b4f458aaa2956a7e226c6d65 (diff) |
http_client.c: Dump response on error when tracing is enabled
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com>
Reviewed-by: David von Oheimb <david.von.oheimb@siemens.com>
(Merged from https://github.com/openssl/openssl/pull/18386)
Diffstat (limited to 'doc/man3')
-rw-r--r-- | doc/man3/OSSL_HTTP_REQ_CTX.pod | 10 | ||||
-rw-r--r-- | doc/man3/OSSL_HTTP_transfer.pod | 7 |
2 files changed, 15 insertions, 2 deletions
diff --git a/doc/man3/OSSL_HTTP_REQ_CTX.pod b/doc/man3/OSSL_HTTP_REQ_CTX.pod index ecfa442827..36b460dbcc 100644 --- a/doc/man3/OSSL_HTTP_REQ_CTX.pod +++ b/doc/man3/OSSL_HTTP_REQ_CTX.pod @@ -213,6 +213,13 @@ This may be omitted if the GET method is used and "keep-alive" is not requested. When the request context is fully prepared, the HTTP exchange may be performed with OSSL_HTTP_REQ_CTX_nbio() or OSSL_HTTP_REQ_CTX_exchange(). +=head1 NOTES + +When built with tracing enabled, OSSL_HTTP_REQ_CTX_nbio() and all functions +using it, such as OSSL_HTTP_REQ_CTX_exchange() and L<OSSL_HTTP_transfer(3)>, +may be traced using B<OSSL_TRACE_CATEGORY_HTTP>. +See also L<OSSL_trace_enabled(3)> and L<openssl(1)/ENVIRONMENT>. + =head1 RETURN VALUES OSSL_HTTP_REQ_CTX_new() returns a pointer to a B<OSSL_HTTP_REQ_CTX>, or NULL @@ -248,7 +255,8 @@ L<ASN1_item_i2d_mem_bio(3)>, L<OSSL_HTTP_open(3)>, L<OSSL_HTTP_get(3)>, L<OSSL_HTTP_transfer(3)>, -L<OSSL_HTTP_close(3)> +L<OSSL_HTTP_close(3)>, +L<OSSL_trace_enabled(3)> =head1 HISTORY diff --git a/doc/man3/OSSL_HTTP_transfer.pod b/doc/man3/OSSL_HTTP_transfer.pod index 7e823db3ea..bb29a5d3e6 100644 --- a/doc/man3/OSSL_HTTP_transfer.pod +++ b/doc/man3/OSSL_HTTP_transfer.pod @@ -245,6 +245,10 @@ C<http_proxy>, C<HTTP_PROXY>, C<https_proxy>, C<HTTPS_PROXY>, C<no_proxy>, and C<NO_PROXY>, have been chosen for maximal compatibility with other HTTP client implementations such as wget, curl, and git. +When built with tracing enabled, OSSL_HTTP_transfer() and all functions using it +may be traced using B<OSSL_TRACE_CATEGORY_HTTP>. +See also L<OSSL_trace_enabled(3)> and L<openssl(1)/ENVIRONMENT>. + =head1 RETURN VALUES OSSL_HTTP_open() returns on success a B<OSSL_HTTP_REQ_CTX>, else NULL. @@ -266,7 +270,8 @@ OSSL_HTTP_close() returns 0 if anything went wrong while disconnecting, else 1. L<OSSL_HTTP_parse_url(3)>, L<BIO_new_connect(3)>, L<ASN1_item_i2d_mem_bio(3)>, L<ASN1_item_d2i_bio(3)>, -L<OSSL_HTTP_is_alive(3)> +L<OSSL_HTTP_is_alive(3)>, +L<OSSL_trace_enabled(3)> =head1 HISTORY |