Lines Matching refs:I
55 OSSL_HTTP_open() initiates an HTTP session using the I<bio> argument if not
56 NULL, else by connecting to a given I<server> optionally via a I<proxy>.
58 Typically the OpenSSL build supports sockets and the I<bio> parameter is NULL.
59 In this case I<rbio> must be NULL as well and the I<server> must be non-NULL.
61 for connecting to the given server and the optionally given I<port>,
65 If I<bio> is given and I<rbio> is NULL then this I<bio> is used instead.
66 If both I<bio> and I<rbio> are given (which may be memory BIOs for instance)
68 I<bio> is used for writing requests and I<rbio> for reading responses.
69 As soon as the client has flushed I<bio> the server must be ready to provide
70 a response or indicate a waiting condition via I<rbio>.
72 If I<bio> is given, it is an error to provide I<proxy> or I<no_proxy> arguments,
73 while I<server> and I<port> arguments may be given to support diagnostic output.
74 If I<bio> is NULL the optional I<proxy> parameter can be used to set an
78 If I<use_ssl> != 0 it defaults to C<https_proxy> if set, else C<HTTPS_PROXY>.
85 The HTTP client functions connect via the given proxy unless the I<server>
86 is found in the optional list I<no_proxy> of proxy hostnames or IP addresses
93 If I<use_ssl> is nonzero a TLS connection is requested
94 and the I<bio_update_fn> parameter must be provided.
96 The parameter I<bio_update_fn>, which is optional if I<use_ssl> is 0,
98 but cannot be used when both I<bio> and I<rbio> are given.
99 I<bio_update_fn> is a BIO connect/disconnect callback function with prototype
103 The callback function may modify the BIO provided in the I<bio> argument,
104 whereby it may use an optional custom defined argument I<arg>,
107 callback function is invoked with the I<connect> argument being 1 and
108 I<detail> being 1 if I<use_ssl> is nonzero (i.e., HTTPS is requested), else 0.
109 On disconnect I<connect> is 0 and I<detail> is 1 if no error occurred, else 0.
113 The callback function must return either the potentially modified BIO I<bio>
140 The optional callback function argument I<arg> is not consumed,
143 The I<buf_size> parameter specifies the response header maximum line length.
145 I<buf_size> is also used as the number of content bytes that are read at a time.
147 If the I<overall_timeout> parameter is > 0 this indicates the maximum number of
154 It promotes the given BIO I<bio> representing a connection
156 optionally using proxy client credentials I<proxyuser> and I<proxypass>,
157 to connect with TLS protection ultimately to I<server> and I<port>.
158 If the I<port> argument is NULL or the empty string it defaults to "443".
159 If the I<timeout> parameter is > 0 this indicates the maximum number of
163 L<openssl-s_client(1)> it uses the I<bio_err> and I<prog> parameters (unless
166 OSSL_HTTP_set1_request() sets up in I<rctx> the request header and content data
170 in I<rctx>.
172 the I<path> argument beginning with C<http://> (thus giving an absoluteURI).
173 If I<path> is NULL it defaults to "/".
174 If I<req> is NULL the HTTP GET method will be used to send the request
175 else HTTP POST with the contents of I<req> and optional I<content_type>, where
176 the length of the data in I<req> does not need to be determined in advance: the
178 The optional list I<headers> may contain additional custom HTTP header lines.
180 If the I<expected_content_type> argument is not NULL,
187 For instance, if I<expected_content_type> specifies C<text/html>,
190 If the I<expect_asn1> parameter is nonzero,
192 The I<max_resp_len> parameter specifies the maximum allowed
194 If the I<timeout> parameter is > 0 this indicates the maximum number of seconds
198 A value < 0 indicates that the I<overall_timeout> parameter value given
200 If I<keep_alive> is 0 the connection is not kept open
207 as specified by I<rctx>, which must include both connection and request data,
210 If the HTTP method is GET and I<redirection_url>
225 OSSL_HTTP_get() uses HTTP GET to obtain data from I<bio> if non-NULL,
226 else from the server contained in the I<url>, and returns it as a BIO.
229 If I<bio> is non-NULL, any host and port components in the I<url> are not used
231 Any userinfo and fragment components in the I<url> are ignored.
233 If the scheme component of the I<url> is C<https> a TLS connection is requested
234 and the I<bio_update_fn>, as described for OSSL_HTTP_open(), must be provided.
240 over a connection managed via I<prctx> without supporting redirection.
243 If I<prctx> is not NULL it reuses any open connection represented by a non-NULL
244 I<*prctx>. It keeps the connection open if a persistent connection is requested
246 and assigns NULL to I<*prctx>.
251 OSSL_HTTP_close() closes the connection and releases I<rctx>.
252 The I<ok> parameter is passed to any BIO update function
