CURLMOPT_PIPELINING_SITE_BL.3 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. .\" generated by cd2nroff 0.1 from CURLMOPT_PIPELINING_SITE_BL.md
  2. .TH CURLMOPT_PIPELINING_SITE_BL 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLMOPT_PIPELINING_SITE_BL \- pipelining host block list
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SITE_BL,
  9. char **hosts);
  10. .fi
  11. .SH DESCRIPTION
  12. No function since pipelining was removed in 7.62.0.
  13. Pass a \fBhosts\fP array of char *, ending with a NULL entry. This is a list
  14. of sites that are blocked from pipelining, i.e sites that are known to not
  15. support HTTP pipelining. The array is copied by libcurl.
  16. Pass a NULL pointer to clear the block list.
  17. .SH DEFAULT
  18. NULL, which means that there is no block list.
  19. .SH PROTOCOLS
  20. This functionality affects http only
  21. .SH EXAMPLE
  22. .nf
  23. static char *site_block_list[] =
  24. {
  25. "www.haxx.se",
  26. "www.example.com:1234",
  27. NULL
  28. };
  29. int main(void)
  30. {
  31. CURLM *m = curl_multi_init();
  32. curl_multi_setopt(m, CURLMOPT_PIPELINING_SITE_BL, site_block_list);
  33. }
  34. .fi
  35. .SH AVAILABILITY
  36. Added in curl 7.30.0
  37. .SH RETURN VALUE
  38. Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
  39. .SH SEE ALSO
  40. .BR CURLMOPT_PIPELINING (3),
  41. .BR CURLMOPT_PIPELINING_SERVER_BL (3)