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

DEFAULT

27       The default value is NULL, which means that there is no blacklist.
28

PROTOCOLS

EXAMPLE

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

AVAILABILITY

41       Added in 7.30.0
42

RETURN VALUE

44       Returns  CURLM_OK  if the option is supported, and CURLM_UNKNOWN_OPTION
45       if not.
46