GNURLMOPT_...NG_SITE_BL(3)

πŸ“¦ version 7.72.0, in nixos 26.05, nixpkgs unstable

πŸ’… GNURLMOPT_...NG_SITE_BL β€” the pipelining host block list one πŸŽ€

okay so real talk bestie, this page lives in the curl_multi_setopt options section of the manual and it is so short because, well... you'll see. buckle up πŸ¦‹


✨ NAME ✨

CURLMOPT_PIPELINING_SITE_BL β€” the pipelining host block list, aka the list of sites that fumbled pipelining so hard they got benched 😭


🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SITE_BL,
char **hosts);

πŸ’– DESCRIPTION πŸ’–

no function since pipelining was removed in 7.62.0. πŸ’€

like... she's a ghost now. but the lore matters, so here's what she did:

you pass a hosts array of char *, ending with a NULL entry. it's a list of sites that are blocked from pipelining β€” literally sites that are known to not support HTTP pipelining 🚫. libcurl copies the array (yes, copies, she's not borrowing yours, she has her own 🫢).

and if you wanna clear the block list? pass a NULL pointer. clean slate, fresh start, therapy era ✨


πŸŽ€ DEFAULT πŸŽ€

the default value is NULL, which means there is no block list β€” everybody's invited to the pipelining party (well, they were, until 7.62.0 broke up the party πŸ™ˆ).


🌈 PROTOCOLS 🌈

HTTP(S) β€” that's it, that's the whole vibe check.


πŸ”₯ EXAMPLE πŸ”₯

char *site_block_list[] =
{
  "www.haxx.se",
  "www.example.com:1234",
  NULL
};

curl_multi_setopt(m, CURLMOPT_PIPELINING_SITE_BL, site_block_list);

see that NULL at the end? do NOT forget it, bestie, the array needs its little periodt to know it's done ⭐


⭐ AVAILABILITY ⭐

added in 7.30.0 β€” so she's been around a minute, she's got main character history πŸ‘‘


πŸ‘‘ RETURN VALUE πŸ‘‘

  • returns CURLM_OK if the option is supported πŸ˜ŒπŸ’…
  • returns CURLM_UNKNOWN_OPTION if it's not πŸ™ƒ

πŸ¦‹ SEE ALSO πŸ¦‹


that's the whole page fr fr β€” short, sweet, and slightly haunted by a deprecated feature πŸ§šπŸ’œ

sign-off: this little icon was brought to you by libcurl 7.39.0, dated 4 Nov 2014, and honestly she ate πŸŒΈπŸ’–

πŸ“¦ where this page comes from