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