CURLMOPT_PIPELINING_SITE_BL.md (1326B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLMOPT_PIPELINING_SITE_BL 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLMOPT_PIPELINING (3) 9 - CURLMOPT_PIPELINING_SERVER_BL (3) 10 Protocol: 11 - HTTP 12 Added-in: 7.30.0 13 --- 14 15 # NAME 16 17 CURLMOPT_PIPELINING_SITE_BL - pipelining host block list 18 19 # SYNOPSIS 20 21 ~~~c 22 #include <curl/curl.h> 23 24 CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SITE_BL, 25 char **hosts); 26 ~~~ 27 28 # DESCRIPTION 29 30 No function since pipelining was removed in 7.62.0. 31 32 Pass a **hosts** array of char *, ending with a NULL entry. This is a list 33 of sites that are blocked from pipelining, i.e sites that are known to not 34 support HTTP pipelining. The array is copied by libcurl. 35 36 Pass a NULL pointer to clear the block list. 37 38 # DEFAULT 39 40 NULL, which means that there is no block list. 41 42 # %PROTOCOLS% 43 44 # EXAMPLE 45 46 ~~~c 47 static char *site_block_list[] = 48 { 49 "www.haxx.se", 50 "www.example.com:1234", 51 NULL 52 }; 53 54 int 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 65 curl_multi_setopt(3) returns a CURLMcode indicating success or error. 66 67 CURLM_OK (0) means everything was OK, non-zero means an error occurred, see 68 libcurl-errors(3).