CURLMOPT_PIPELINING_SERVER_BL(3)

1CURLMOPT_PIPELINING_SERVER_BcLu(r3l)_multi_setopt opCtUiRoLnMsOPT_PIPELINING_SERVER_BL(3)
2
3
4

NAME

6       CURLMOPT_PIPELINING_SERVER_BL - pipelining server blacklist
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLMcode     curl_multi_setopt(CURLM     *handle,    CURLMOPT_PIPELIN‐
12       ING_SERVER_BL, char **servers);
13

DESCRIPTION

15       No function since pipelining was removed in 7.62.0.
16
17       Pass a servers array of char *, ending with a NULL  entry.  This  is  a
18       list  of  server  types  prefixes (in the Server: HTTP header) that are
19       blacklisted from pipelining, i.e server types that  are  known  to  not
20       support HTTP pipelining. The array is copied by libcurl.
21
22       Note  that the comparison matches if the Server: header begins with the
23       string in the blacklist, i.e "Server: Ninja 1.2.3" and  "Server:  Ninja
24       1.4.0" can both be blacklisted by having "Ninja" in the backlist.
25
26       Pass a NULL pointer to clear the blacklist.
27

DEFAULT

29       The default value is NULL, which means that there is no blacklist.
30

PROTOCOLS

EXAMPLE

33         server_blacklist[] =
34         {
35           "Microsoft-IIS/6.0",
36           "nginx/0.8.54",
37           NULL
38         };
39
40         curl_multi_setopt(m, CURLMOPT_PIPELINING_SERVER_BL, server_blacklist);
41

AVAILABILITY

43       Added in 7.30.0
44

RETURN VALUE

46       Returns  CURLM_OK  if the option is supported, and CURLM_UNKNOWN_OPTION
47       if not.
48