1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLMOPT_PIPELINING_SITE_BL
5Section: 3
6Source: libcurl
7See-also:
8  - CURLMOPT_PIPELINING (3)
9  - CURLMOPT_PIPELINING_SERVER_BL (3)
10Protocol:
11  - HTTP
12---
13
14# NAME
15
16CURLMOPT_PIPELINING_SITE_BL - pipelining host block list
17
18# SYNOPSIS
19
20~~~c
21#include <curl/curl.h>
22
23CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SITE_BL,
24                            char **hosts);
25~~~
26
27# DESCRIPTION
28
29No function since pipelining was removed in 7.62.0.
30
31Pass a **hosts** array of char *, ending with a NULL entry. This is a list
32of sites that are blocked from pipelining, i.e sites that are known to not
33support HTTP pipelining. The array is copied by libcurl.
34
35Pass a NULL pointer to clear the block list.
36
37# DEFAULT
38
39The default value is NULL, which means that there is no block list.
40
41# EXAMPLE
42
43~~~c
44static char *site_block_list[] =
45{
46  "www.haxx.se",
47  "www.example.com:1234",
48  NULL
49};
50
51int main(void)
52{
53  CURLM *m = curl_multi_init();
54  curl_multi_setopt(m, CURLMOPT_PIPELINING_SITE_BL, site_block_list);
55}
56~~~
57
58# AVAILABILITY
59
60Added in 7.30.0
61
62# RETURN VALUE
63
64Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
65