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