CURLMOPT_PIPELINING_SITE_BL(3)

📦
version 8.18.0 · 23 versions
, in fedora 44

💅 CURLMOPT_PIPELINING_SITE_BL(3) 💅

okay so this little cutie comes from the Library Functions Manual, and it is titled CURLMOPT_PIPELINING_SITE_BL(3). It is giving old-school pipelining block-list energy, and yes, we are gonna keep every detail.

✨ NAME ✨

  • CURLMOPT_PIPELINING_SITE_BL — pipelining host block list

🌸 SYNOPSIS 🌸

#include <curl/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.

Bestie, here is the whole deal: pass a hosts array of char *, ending with a NULL entry. This is a list of sites that are blocked from pipelining, i.e sites that are known to not support HTTP pipelining. The array is copied by libcurl. slay, libcurl handles the copy for you.

Pass a NULL pointer to clear the block list. periodt.

🎀 DEFAULT 🎀

NULL, which means that there is no block list. Literally no block list at all.

🌈 PROTOCOLS 🌈

This functionality affects http only.

🍓 EXAMPLE 🍓

Here is the whole look, bestie:

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

int main(void)
{
  CURLM *m = curl_multi_init();
  curl_multi_setopt(m, CURLMOPT_PIPELINING_SITE_BL, site_block_list);
}

⭐ AVAILABILITY ⭐

Added in curl 7.30.0.

👑 RETURN VALUE 👑

curl_multi_setopt(3) returns a CURLMcode indicating success or error.

CURLM_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

🔥 SEE ALSO 🔥

xoxo 💖 — this cutie is from libcurl, dated 2026-10-12. 💅

📦 where this page comes from