Lines Matching full:s0
190 \&\fBOSSL_HTTP_open()\fR initiates an \s-1HTTP\s0 session using the \fIbio\fR argument if not
191 \&\s-1NULL,\s0 else by connecting to a given \fIserver\fR optionally via a \fIproxy\fR.
193 Typically the OpenSSL build supports sockets and the \fIbio\fR parameter is \s-1NULL.\s0
194 In this case \fIrbio\fR must be \s-1NULL\s0 as well and the \fIserver\fR must be non-NULL.
195 The function creates a network \s-1BIO\s0 internally using \fBBIO_new_connect\fR\|(3)
197 defaulting to 80 for \s-1HTTP\s0 or 443 for \s-1HTTPS.\s0
198 Then this internal \s-1BIO\s0 is used for setting up a connection
200 If \fIbio\fR is given and \fIrbio\fR is \s-1NULL\s0 then this \fIbio\fR is used instead.
209 If \fIbio\fR is \s-1NULL\s0 the optional \fIproxy\fR parameter can be used to set an
210 \&\s-1HTTP\s0(S) proxy to use (unless overridden by \*(L"no_proxy\*(R" settings).
211 If \s-1TLS\s0 is not used this defaults to the environment variable \f(CW\*(C`http_proxy\*(C'\fR
219 The \s-1HTTP\s0 client functions connect via the given proxy unless the \fIserver\fR
220 is found in the optional list \fIno_proxy\fR of proxy hostnames (if not \s-1NULL\s0;
222 Proxying plain \s-1HTTP\s0 is supported directly,
223 while using a proxy for \s-1HTTPS\s0 connections requires a suitable callback function
226 If \fIuse_ssl\fR is nonzero a \s-1TLS\s0 connection is requested
230 may be used to modify the connection \s-1BIO\s0 used by the \s-1HTTP\s0 client,
232 \&\fIbio_update_fn\fR is a \s-1BIO\s0 connect/disconnect callback function with prototype
238 The callback function may modify the \s-1BIO\s0 provided in the \fIbio\fR argument,
240 which may for instance point to an \fB\s-1SSL_CTX\s0\fR structure.
243 \&\fIdetail\fR being 1 if \fIuse_ssl\fR is nonzero (i.e., \s-1HTTPS\s0 is requested), else 0.
245 For instance, on connect the callback may push an \s-1SSL BIO\s0 to implement \s-1HTTPS\s0;
246 after disconnect it may do some diagnostic output and pop and free the \s-1SSL BIO.\s0
248 The callback function must return either the potentially modified \s-1BIO\s0 \fIbio\fR.
249 or \s-1NULL\s0 to indicate failure, in which case it should not modify the \s-1BIO.\s0
251 Here is a simple example that supports \s-1TLS\s0 connections (but not via a proxy):
276 After disconnect the modified \s-1BIO\s0 will be deallocated using \fBBIO_free_all()\fR.
279 A value <= 0 means that the \fB\s-1OSSL_HTTP_DEFAULT_MAX_LINE_LEN\s0\fR (4KiB) is used.
283 seconds the overall \s-1HTTP\s0 transfer (i.e., connection setup if needed,
287 \&\fBOSSL_HTTP_proxy_connect()\fR may be used by an above \s-1BIO\s0 connect callback function
288 to set up an \s-1SSL/TLS\s0 connection via an \s-1HTTPS\s0 proxy.
289 It promotes the given \s-1BIO\s0 \fIbio\fR representing a connection
290 pre-established with a \s-1TLS\s0 proxy using the \s-1HTTP CONNECT\s0 method,
292 to connect with \s-1TLS\s0 protection ultimately to \fIserver\fR and \fIport\fR.
293 If the \fIport\fR argument is \s-1NULL\s0 or the empty string it defaults to \*(L"443\*(R".
299 \&\s-1NULL\s0) to print additional diagnostic information in a user-oriented way.
303 If <rctx> indicates using a proxy for \s-1HTTP\s0 (but not \s-1HTTPS\s0), the server host
308 If \fIpath\fR is \s-1NULL\s0 it defaults to \*(L"/\*(R".
309 If \fIreq\fR is \s-1NULL\s0 the \s-1HTTP GET\s0 method will be used to send the request
310 else \s-1HTTP POST\s0 with the contents of \fIreq\fR and optional \fIcontent_type\fR, where
312 \&\s-1BIO\s0 will be read on-the-fly while sending the request, which supports streaming.
313 The optional list \fIheaders\fR may contain additional custom \s-1HTTP\s0 header lines.
315 is not \s-1NULL\s0 then the client will check that the given content type string
316 is included in the \s-1HTTP\s0 header of the response and return an error if not.
318 a structure in \s-1ASN.1\s0 encoding will be expected as response content.
322 the subsequent \s-1HTTP\s0 transfer (sending the request and receiving a response)
326 when opening the \s-1HTTP\s0 transfer will be used instead.
328 after receiving a response, which is the default behavior for \s-1HTTP 1.0.\s0
333 \&\fBOSSL_HTTP_exchange()\fR exchanges any form of \s-1HTTP\s0 request and response
337 If the \s-1HTTP\s0 method is \s-1GET\s0 and \fIredirection_url\fR
338 is not \s-1NULL\s0 the latter pointer is used to provide any new location that
339 the server may return with \s-1HTTP\s0 code 301 (\s-1MOVED_PERMANENTLY\s0) or 302 (\s-1FOUND\s0).
340 In this case the function returns \s-1NULL\s0 and the caller is
341 responsible for deallocating the \s-1URL\s0 with \fBOPENSSL_free\fR\|(3).
343 an \s-1ASN\s0.1\-encoded response is expected, which should include a total length,
346 If an \s-1ASN\s0.1\-encoded response is expected, the function returns on success
347 the contents buffered in a memory \s-1BIO,\s0 which does not support streaming.
348 Otherwise it returns directly the read \s-1BIO\s0 that holds the response contents,
350 The caller is responsible for freeing the \s-1BIO\s0 pointer obtained.
352 \&\fBOSSL_HTTP_get()\fR uses \s-1HTTP GET\s0 to obtain data from \fIbio\fR if non-NULL,
353 else from the server contained in the \fIurl\fR, and returns it as a \s-1BIO.\s0
354 It supports redirection via \s-1HTTP\s0 status code 301 or 302. It is meant for
360 If the scheme component of the \fIurl\fR is \f(CW\*(C`https\*(C'\fR a \s-1TLS\s0 connection is requ…
364 The caller is responsible for freeing the \s-1BIO\s0 pointer obtained.
366 \&\fBOSSL_HTTP_transfer()\fR exchanges an \s-1HTTP\s0 request and response
370 If \fIprctx\fR is not \s-1NULL\s0 it reuses any open connection represented by a non-NULL
373 and assigns \s-1NULL\s0 to \fI*prctx\fR.
376 The caller is responsible for freeing the \s-1BIO\s0 pointer obtained.
379 The \fIok\fR parameter is passed to any \s-1BIO\s0 update function
381 It must be 1 if no error occurred during the \s-1HTTP\s0 transfer and 0 otherwise.
387 other \s-1HTTP\s0 client implementations such as wget, curl, and git.
390 \&\fBOSSL_HTTP_open()\fR returns on success a \fB\s-1OSSL_HTTP_REQ_CTX\s0\fR, else \s-1NULL.\s0
396 return a memory \s-1BIO\s0 that buffers all the data received if an \s-1ASN\s0.1\-encoded
397 response is expected, otherwise a \s-1BIO\s0 that may support streaming.
398 The \s-1BIO\s0 must be freed by the caller.
399 On failure, they return \s-1NULL.\s0
401 The caller is responsible for freeing the \s-1BIO\s0 pointer obtained.
418 in the file \s-1LICENSE\s0 in the source distribution or at