pj_http_req_param Struct Reference

Data Structures
struct	pj_http_reqdata

Data Fields
int	addr_family
pj_str_t	method
pj_str_t	version
pj_time_val	timeout
void *	user_data
pj_http_headers	headers
struct pj_http_req_param::pj_http_reqdata	reqdata
pj_http_auth_cred	auth_cred
pj_uint16_t	source_port_range_start
pj_uint16_t	source_port_range_size
pj_uint16_t	max_retries

---

Detailed Description

Parameters that can be given during http request creation. Application must initialize this structure with pj_http_req_param_default().

---

Field Documentation

int pj_http_req_param::addr_family

The address family of the URL. Default is pj_AF_INET().

pj_http_auth_cred pj_http_req_param::auth_cred

Authentication credential needed to respond to 401/407 response.

pj_http_headers pj_http_req_param::headers

HTTP request headers. Default is empty.

pj_uint16_t pj_http_req_param::max_retries

Max number of retries if binding to a port fails. Note that this does not adress the scenario where a request times out or errors. This needs to be taken care of by the on_complete callback.

Default is 3

pj_str_t pj_http_req_param::method

The HTTP request method. Default is GET.

pj_uint16_t pj_http_req_param::source_port_range_size

Optional source port range to use when binding. The size of the port restriction range

Default is 0 (The OS will select the source port automatically))

pj_uint16_t pj_http_req_param::source_port_range_start

Optional source port range to use when binding the socket. This can be used if the source port needs to be within a certain range for instance due to strict firewall settings. The port used will be randomized within the range.

Note that if authentication is configured, the authentication response will be a new transaction

Default is 0 (The OS will select the source port automatically)

pj_time_val pj_http_req_param::timeout

HTTP request operation timeout. Default is PJ_HTTP_DEFAULT_TIMEOUT.

void* pj_http_req_param::user_data

User-defined data. Default is NULL.

pj_str_t pj_http_req_param::version

The HTTP protocol version ("1.0" or "1.1"). Default is "1.0".

---

The documentation for this struct was generated from the following file:

• http_client.h