diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2021-11-30 20:06:09 +0100 |
---|---|---|
committer | Tomas Mraz <tomas@openssl.org> | 2021-12-07 11:26:49 +0100 |
commit | 266383b44c4ebce5ddf551547e73ab6eec47805b (patch) | |
tree | 1537fb04978d381aca1d208d282fdda6c92be048 /doc/man3 | |
parent | 67890a738c0eb5e92c41189ba3c744fbc98a97ac (diff) |
OSSL_HTTP_set1_request(): Fix check for presence of port option and its documentation
For HTTP (not HTTPS) with proxy, server must be given, port is optional
Reviewed-by: Paul Dale <pauli@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/17186)
Diffstat (limited to 'doc/man3')
-rw-r--r-- | doc/man3/OSSL_HTTP_transfer.pod | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/doc/man3/OSSL_HTTP_transfer.pod b/doc/man3/OSSL_HTTP_transfer.pod index 2aef3a5347..6b784ea0b5 100644 --- a/doc/man3/OSSL_HTTP_transfer.pod +++ b/doc/man3/OSSL_HTTP_transfer.pod @@ -58,7 +58,7 @@ NULL, else by connecting to a given I<server> optionally via a I<proxy>. Typically the OpenSSL build supports sockets and the I<bio> parameter is NULL. In this case I<rbio> must be NULL as well, and the library creates a network BIO internally for connecting to the given I<server> -at the specified I<port> if any, defaulting to 80 for HTTP or 443 for HTTPS. +and the optionally given I<port>, defaulting to 80 for HTTP or 443 for HTTPS. Then this internal BIO is used for setting up a connection and for exchanging one or more request and response. If I<bio> is given and I<rbio> is NULL then this I<bio> is used instead. @@ -150,6 +150,8 @@ NULL) to print additional diagnostic information in a user-oriented way. OSSL_HTTP_set1_request() sets up in I<rctx> the request header and content data and expectations on the response using the following parameters. +If <rctx> indicates using a proxy for HTTP (but not HTTPS), the server hostname +(and optionally port) needs to be placed in the header and thus must be present. If I<path> is NULL it defaults to "/". If I<req> is NULL the HTTP GET method will be used to send the request else HTTP POST with the contents of I<req> and optional I<content_type>, where |