[#OSSL_HTTP_open]
= OSSL_HTTP_open
:mrdocs:

Open an HTTP (or HTTPS) connection and allocate a request context.

== Synopsis

Declared in `<openssl/http.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:OSSL_HTTP_REQ_CTX.adoc[OSSL_HTTP_REQ_CTX]*
OSSL_HTTP_open(
    char const* server,
    char const* port,
    char const* proxy,
    char const* no_proxy,
    int use_ssl,
    xref:BIO.adoc[BIO]* bio,
    xref:BIO.adoc[BIO]* rbio,
    xref:OSSL_HTTP_bio_cb_t.adoc[OSSL_HTTP_bio_cb_t] bio_update_fn,
    void* arg,
    int buf_size,
    int overall_timeout);
----

== Return Value

New OSSL_HTTP_REQ_CTX, or NULL on failure; free with OSSL_HTTP_REQ_CTX_free().

== Parameters

[cols="1,4"]
|===
| Name| Description
| *server*
| Hostname or address of the HTTP server.
| *port*
| Port string, or NULL for the default (80/443).
| *proxy*
| Optional HTTP proxy host, or NULL.
| *no_proxy*
| Optional comma‐separated bypass list, or NULL.
| *use_ssl*
| Non‐zero to use TLS (HTTPS).
| *bio*
| Optional pre‐existing write BIO, or NULL to create one.
| *rbio*
| Optional separate read BIO, or NULL to use `bio` for both.
| *bio_update_fn*
| Optional connect/disconnect BIO callback, or NULL.
| *arg*
| User pointer passed to `bio_update_fn.`
| *buf_size*
| I/O buffer size hint (0 for default).
| *overall_timeout*
| Overall transfer timeout in seconds (0 for default/none).
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#