GNURLMOPT_..._SERVER_BL(3)

okay bestie, welcome to GNURLMOPT_..._SERVER_BL(3) from the curl_multi_setopt options manual — this is the CURLMOPT_PIPELINING_SERVER_BL page, aka the pipelining server block list, and we're gonna get into it 💅✨

🌸 NAME 🌸

CURLMOPT_PIPELINING_SERVER_BL — pipelining server block list. No cap, that's the whole name.

🦋 SYNOPSIS 🦋

#include <gnurl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle,
CURLMOPT_PIPELINING_SERVER_BL, char **servers);

💖 DESCRIPTION 💖

okay so real talk: no function since pipelining was removed in 7.62.0 😭. That's the tea. But here's what the option is about anyway:

You pass a servers array of char *, ending with a NULL entry. This is a list of server types prefixes (in the Server: HTTP header) that are blocked from pipelining — i.e. server types that are known to not support HTTP pipelining. The array is copied by libcurl. 🫶

Note that the comparison matches if the Server: header begins with the string in the block list, i.e. "Server: Ninja 1.2.3" and "Server: Ninja 1.4.0" can both be blocked by having "Ninja" in the list. iykyk 👑

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

🎀 DEFAULT 🎀

The default value is NULL, which means that there is no block list. literally no list, no drama 🌈.

🧚 PROTOCOLS 🧚

This section is blank on the original page — no protocols listed, no extra lore. 🫶

✨ EXAMPLE ✨

char *server_block_list[] =
{
  "Microsoft-IIS/6.0",
  "nginx/0.8.54",
  NULL
};

curl_multi_setopt(m, CURLMOPT_PIPELINING_SERVER_BL, server_block_list);

💜 AVAILABILITY 💜

Added in 7.30.0 — vintage but still iconic ⭐.

👑 RETURN VALUE 👑

Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. That's it, that's the vibe check 💅.

🔥 SEE ALSO 🔥

• CURLMOPT_PIPELINING(3)
• CURLMOPT_PIPELINING_SITE_BL(3),

mwah 💋 — this page is sourced from libcurl 7.39.0 and dated 4 Nov 2014. byeee 🫶🎀