CURLMOPT_PIPELINING_SERVER_BL.3 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. .\" generated by cd2nroff 0.1 from CURLMOPT_PIPELINING_SERVER_BL.md
  2. .TH CURLMOPT_PIPELINING_SERVER_BL 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLMOPT_PIPELINING_SERVER_BL \- pipelining server block list
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SERVER_BL,
  9. char **servers);
  10. .fi
  11. .SH DESCRIPTION
  12. No function since pipelining was removed in 7.62.0.
  13. Pass a \fBservers\fP array of char *, ending with a NULL entry. This is a list
  14. of server types prefixes (in the Server: HTTP header) that are blocked from
  15. pipelining, i.e server types that are known to not support HTTP
  16. pipelining. The array is copied by libcurl.
  17. Note that the comparison matches if the Server: header begins with the string
  18. in the block list, i.e "Server: Ninja 1.2.3" and "Server: Ninja 1.4.0" can
  19. both be blocked by having "Ninja" in the list.
  20. Pass a NULL pointer to clear the block list.
  21. .SH DEFAULT
  22. NULL, which means that there is no block list.
  23. .SH PROTOCOLS
  24. This functionality affects http only
  25. .SH EXAMPLE
  26. .nf
  27. static char *server_block_list[] =
  28. {
  29. "Microsoft-IIS/6.0",
  30. "nginx/0.8.54",
  31. NULL
  32. };
  33. int main(void)
  34. {
  35. CURLM *m = curl_multi_init();
  36. curl_multi_setopt(m, CURLMOPT_PIPELINING_SERVER_BL, server_block_list);
  37. }
  38. .fi
  39. .SH AVAILABILITY
  40. Added in curl 7.30.0
  41. .SH RETURN VALUE
  42. Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
  43. .SH SEE ALSO
  44. .BR CURLMOPT_PIPELINING (3),
  45. .BR CURLMOPT_PIPELINING_SITE_BL (3)