[thirdparty/openssl.git] / include / openssl / http.h

/*
 * Copyright 2000-2020 The OpenSSL Project Authors. All Rights Reserved.
 * Copyright Siemens AG 2018-2020
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#ifndef OPENSSL_HTTP_H
# define OPENSSL_HTTP_H
# pragma once

# include <openssl/opensslconf.h>

# include <openssl/bio.h>
# include <openssl/asn1.h>
# include <openssl/conf.h>


# ifdef __cplusplus
extern "C" {
# endif

typedef BIO *(*OSSL_HTTP_bio_cb_t)(BIO *bio, void *arg, int connect, int detail);

# define OSSL_HTTP_NAME "http"
# define OSSL_HTTPS_NAME "https"
# define OSSL_HTTP_PREFIX OSSL_HTTP_NAME"://"
# define OSSL_HTTPS_PREFIX OSSL_HTTPS_NAME"://"
# define OSSL_HTTP_PORT "80"
# define OSSL_HTTPS_PORT "443"
# define OPENSSL_NO_PROXY "NO_PROXY"
# define OPENSSL_HTTP_PROXY "HTTP_PROXY"
# define OPENSSL_HTTPS_PROXY "HTTPS_PROXY"

OSSL_HTTP_REQ_CTX *OSSL_HTTP_REQ_CTX_new(BIO *wbio, BIO *rbio,
                                         int method_GET, int maxline,
                                         unsigned long max_resp_len,
                                         int timeout,
                                         const char *expected_content_type,
                                         int expect_asn1);
void OSSL_HTTP_REQ_CTX_free(OSSL_HTTP_REQ_CTX *rctx);
int OSSL_HTTP_REQ_CTX_set_request_line(OSSL_HTTP_REQ_CTX *rctx,
                                       const char *server, const char *port,
                                       const char *path);
int OSSL_HTTP_REQ_CTX_add1_header(OSSL_HTTP_REQ_CTX *rctx,
                                  const char *name, const char *value);
int OSSL_HTTP_REQ_CTX_i2d(OSSL_HTTP_REQ_CTX *rctx, const char *content_type,
                          const ASN1_ITEM *it, ASN1_VALUE *req);
int OSSL_HTTP_REQ_CTX_nbio(OSSL_HTTP_REQ_CTX *rctx);
ASN1_VALUE *OSSL_HTTP_REQ_CTX_sendreq_d2i(OSSL_HTTP_REQ_CTX *rctx,
                                          const ASN1_ITEM *it);
BIO *OSSL_HTTP_REQ_CTX_get0_mem_bio(OSSL_HTTP_REQ_CTX *rctx);
void OSSL_HTTP_REQ_CTX_set_max_response_length(OSSL_HTTP_REQ_CTX *rctx,
                                               unsigned long len);

BIO *OSSL_HTTP_get(const char *url, const char *proxy, const char *no_proxy,
                   BIO *bio, BIO *rbio,
                   OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
                   const STACK_OF(CONF_VALUE) *headers,
                   int maxline, unsigned long max_resp_len, int timeout,
                   const char *expected_content_type, int expect_asn1);
ASN1_VALUE *OSSL_HTTP_get_asn1(const char *url,
                               const char *proxy, const char *no_proxy,
                               BIO *bio, BIO *rbio,
                               OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
                               const STACK_OF(CONF_VALUE) *headers,
                               int maxline, unsigned long max_resp_len,
                               int timeout, const char *expected_content_type,
                               const ASN1_ITEM *it);
ASN1_VALUE *OSSL_HTTP_post_asn1(const char *server, const char *port,
                                const char *path, int use_ssl,
                                const char *proxy, const char *no_proxy,
                                BIO *bio, BIO *rbio,
                                OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
                                const STACK_OF(CONF_VALUE) *headers,
                                const char *content_type,
                                const ASN1_VALUE *req, const ASN1_ITEM *req_it,
                                int maxline, unsigned long max_resp_len,
                                int timeout, const char *expected_ct,
                                const ASN1_ITEM *rsp_it);
BIO *OSSL_HTTP_transfer(const char *server, const char *port, const char *path,
                        int use_ssl, const char *proxy, const char *no_proxy,
                        BIO *bio, BIO *rbio,
                        OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
                        const STACK_OF(CONF_VALUE) *headers,
                        const char *content_type, BIO *req_mem,
                        int maxline, unsigned long max_resp_len, int timeout,
                        const char *expected_ct, int expect_asn1,
                        char **redirection_url);
int OSSL_HTTP_proxy_connect(BIO *bio, const char *server, const char *port,
                            const char *proxyuser, const char *proxypass,
                            int timeout, BIO *bio_err, const char *prog);

int OSSL_HTTP_parse_url(const char *url, char **phost, char **pport,
                        int *pport_num, char **ppath, int *pssl);

# ifdef  __cplusplus
}
# endif
#endif /* !defined(OPENSSL_HTTP_H) */
Commit	Line	Data
29f178bd DDO	1	/*
	2	* Copyright 2000-2020 The OpenSSL Project Authors. All Rights Reserved.
	3	* Copyright Siemens AG 2018-2020
	4	*
	5	* Licensed under the Apache License 2.0 (the "License"). You may not use
	6	* this file except in compliance with the License. You can obtain a copy
	7	* in the file LICENSE in the source distribution or at
	8	* https://www.openssl.org/source/license.html
	9	*/
	10
	11	#ifndef OPENSSL_HTTP_H
	12	# define OPENSSL_HTTP_H
	13	# pragma once
	14
	15	# include <openssl/opensslconf.h>
	16
	17	# include <openssl/bio.h>
	18	# include <openssl/asn1.h>
	19	# include <openssl/conf.h>
	20
	21
	22	# ifdef __cplusplus
	23	extern "C" {
	24	# endif
	25
	26	typedef BIO (OSSL_HTTP_bio_cb_t)(BIO bio, void arg, int connect, int detail);
e8d0819d	27
4b1fe471 DDO	28	# define OSSL_HTTP_NAME "http"
	29	# define OSSL_HTTPS_NAME "https"
	30	# define OSSL_HTTP_PREFIX OSSL_HTTP_NAME"://"
	31	# define OSSL_HTTPS_PREFIX OSSL_HTTPS_NAME"://"
	32	# define OSSL_HTTP_PORT "80"
	33	# define OSSL_HTTPS_PORT "443"
	34	# define OPENSSL_NO_PROXY "NO_PROXY"
	35	# define OPENSSL_HTTP_PROXY "HTTP_PROXY"
	36	# define OPENSSL_HTTPS_PROXY "HTTPS_PROXY"
	37
83b6dc8d RS	38	OSSL_HTTP_REQ_CTX OSSL_HTTP_REQ_CTX_new(BIO wbio, BIO *rbio,
	39	int method_GET, int maxline,
	40	unsigned long max_resp_len,
	41	int timeout,
	42	const char *expected_content_type,
	43	int expect_asn1);
	44	void OSSL_HTTP_REQ_CTX_free(OSSL_HTTP_REQ_CTX *rctx);
cddbcf02 DDO	45	int OSSL_HTTP_REQ_CTX_set_request_line(OSSL_HTTP_REQ_CTX *rctx,
	46	const char server, const char port,
	47	const char *path);
83b6dc8d RS	48	int OSSL_HTTP_REQ_CTX_add1_header(OSSL_HTTP_REQ_CTX *rctx,
	49	const char name, const char value);
	50	int OSSL_HTTP_REQ_CTX_i2d(OSSL_HTTP_REQ_CTX rctx, const char content_type,
	51	const ASN1_ITEM it, ASN1_VALUE req);
	52	int OSSL_HTTP_REQ_CTX_nbio(OSSL_HTTP_REQ_CTX *rctx);
	53	ASN1_VALUE OSSL_HTTP_REQ_CTX_sendreq_d2i(OSSL_HTTP_REQ_CTX rctx,
	54	const ASN1_ITEM *it);
	55	BIO OSSL_HTTP_REQ_CTX_get0_mem_bio(OSSL_HTTP_REQ_CTX rctx);
	56	void OSSL_HTTP_REQ_CTX_set_max_response_length(OSSL_HTTP_REQ_CTX *rctx,
	57	unsigned long len);
	58
afe554c2	59	BIO OSSL_HTTP_get(const char url, const char proxy, const char no_proxy,
29f178bd DDO	60	BIO bio, BIO rbio,
	61	OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
	62	const STACK_OF(CONF_VALUE) *headers,
	63	int maxline, unsigned long max_resp_len, int timeout,
	64	const char *expected_content_type, int expect_asn1);
	65	ASN1_VALUE OSSL_HTTP_get_asn1(const char url,
afe554c2	66	const char proxy, const char no_proxy,
29f178bd DDO	67	BIO bio, BIO rbio,
	68	OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
	69	const STACK_OF(CONF_VALUE) *headers,
	70	int maxline, unsigned long max_resp_len,
	71	int timeout, const char *expected_content_type,
	72	const ASN1_ITEM *it);
	73	ASN1_VALUE OSSL_HTTP_post_asn1(const char server, const char *port,
	74	const char *path, int use_ssl,
afe554c2	75	const char proxy, const char no_proxy,
29f178bd DDO	76	BIO bio, BIO rbio,
	77	OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
	78	const STACK_OF(CONF_VALUE) *headers,
	79	const char *content_type,
9253f834	80	const ASN1_VALUE req, const ASN1_ITEM req_it,
29f178bd DDO	81	int maxline, unsigned long max_resp_len,
	82	int timeout, const char *expected_ct,
	83	const ASN1_ITEM *rsp_it);
	84	BIO OSSL_HTTP_transfer(const char server, const char port, const char path,
afe554c2	85	int use_ssl, const char proxy, const char no_proxy,
29f178bd DDO	86	BIO bio, BIO rbio,
	87	OSSL_HTTP_bio_cb_t bio_update_fn, void *arg,
	88	const STACK_OF(CONF_VALUE) *headers,
	89	const char content_type, BIO req_mem,
	90	int maxline, unsigned long max_resp_len, int timeout,
	91	const char *expected_ct, int expect_asn1,
	92	char **redirection_url);
	93	int OSSL_HTTP_proxy_connect(BIO bio, const char server, const char *port,
	94	const char proxyuser, const char proxypass,
	95	int timeout, BIO bio_err, const char prog);
e8d0819d	96
29f178bd	97	int OSSL_HTTP_parse_url(const char url, char phost, char *pport,
d7fcee3b	98	int pport_num, char ppath, int pssl);
29f178bd DDO	99
	100	# ifdef __cplusplus
	101	}
	102	# endif
b5adba20	103	#endif /* !defined(OPENSSL_HTTP_H) */