gnurl_multi_setopt(3)

💅 gnurl_multi_setopt(3) — libgnurl Manual 💅

okay bestie, welcome to the libgnurl Manual, page gnurl_multi_setopt(3). grab your iced coffee 🧊 because we're talking about setting options on a curl multi handle, and it's lowkey iconic.

🎀 NAME 🎀

curl_multi_setopt — set options for a curl multi handle. that's the whole vibe. no cap. 💖

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLMcode curl_multi_setopt(CURLM * multi_handle, CURLMoption option,
param);

🦋 DESCRIPTION 🦋

so curl_multi_setopt(3) is literally how you tell a libcurl multi handle how to behave. by using the appropriate options to curl_multi_setopt(3), you can change libcurl's behaviour when using that multi handle. slay.

all options are set with the option followed by the parameter param. that param can be a long, a function pointer, an object pointer, or a curl_off_t type, depending on what the specific option expects. iykyk 🫶

read this manual carefully, bestie, because bad input values may cause libcurl to behave badly! 😭 and the rule is: you can only set one option in each function call. one. option. per. call. periodt. 💅

---

🌸 OPTIONS 🌸

each of these has its own main-character manpage, so tap the reference:

• CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE — See CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3)
• CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE — See CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE(3)
• CURLMOPT_MAX_HOST_CONNECTIONS — See CURLMOPT_MAX_HOST_CONNECTIONS(3)
• CURLMOPT_MAX_PIPELINE_LENGTH — See CURLMOPT_MAX_PIPELINE_LENGTH(3)
• CURLMOPT_MAX_TOTAL_CONNECTIONS — See CURLMOPT_MAX_TOTAL_CONNECTIONS(3)
• CURLMOPT_MAXCONNECTS — See CURLMOPT_MAXCONNECTS(3)
• CURLMOPT_PIPELINING — See CURLMOPT_PIPELINING(3)
• CURLMOPT_PIPELINING_SITE_BL — See CURLMOPT_PIPELINING_SITE_BL(3)
• CURLMOPT_PIPELINING_SERVER_BL — See CURLMOPT_PIPELINING_SERVER_BL(3)
• CURLMOPT_PUSHFUNCTION — See CURLMOPT_PUSHFUNCTION(3)
• CURLMOPT_PUSHDATA — See CURLMOPT_PUSHDATA(3)
• CURLMOPT_SOCKETFUNCTION — See CURLMOPT_SOCKETFUNCTION(3)
• CURLMOPT_SOCKETDATA — See CURLMOPT_SOCKETDATA(3)
• CURLMOPT_TIMERFUNCTION — See CURLMOPT_TIMERFUNCTION(3)
• CURLMOPT_TIMERDATA — See CURLMOPT_TIMERDATA(3)
• CURLMOPT_MAX_CONCURRENT_STREAMS — See CURLMOPT_MAX_CONCURRENT_STREAMS(3)

🔥 RETURNS 🔥

she returns the standard CURLMcode for multi interface error codes. heads up though: it returns a CURLM_UNKNOWN_OPTION if you try setting an option that this version of libcurl doesn't know of. so don't try to make unknown-option fetch happen 💀.

⭐ AVAILABILITY ⭐

this function was added in libcurl 7.15.4. yes bestie, she's been around. 🫶

💜 SEE ALSO 💜

• curl_multi_cleanup(3)
• curl_multi_init(3)
• curl_multi_socket(3)
• curl_multi_info_read(3)

---

made with libcurl 7.39.0 · dated 4 Nov 2014 · this page is gnurl_multi_setopt(3) — mwah 💋