CURL_MULTI_NOTIFY_DISABLE(3)

📦
version 8.23.0 · 11 versions
, in alpine 3.23, alpine 3.24

💅 curl_multi_notify_disable(3) — like, the manual page bestie 💅

okay so this is a page from the Library Functions Manual, and it's literally all about curl_multi_notify_disable — the function that turns a notification type OFF in your multi handle. yes queen, we're unsubscribing ✨

✨ NAME ✨

curl_multi_notify_disable — disable a notification type 🚫🔔

🌸 SYNOPSIS 🌸

#include <curl/curl.h>
CURLMcode curl_multi_notify_disable(CURLM *multi_handle,
                                    unsigned int notification);

🦋 DESCRIPTION 🦋

So basically 💁‍♀️ this disables collecting the given notification type in the multi handle. meaning: a callback function you installed via CURLMOPT_NOTIFYFUNCTION(3) is no longer called when this notification happens. she's muted, periodt. 🔇

And listen — notifications only get collected and dispatched to the callback when both things are true: a notification callback is installed and that notification is enabled. no callback or no enable = nothing to collect, iykyk 💅

The good news? Several notification types can be enabled at the same time. it's giving multitasking main character energy 👑 and disabling a notification that's already disabled is not an error — no drama, no cap. 🫶

Feeling regret? you can always enable a notification again via curl_multi_notify_enable(3). we love a comeback arc. 🎀

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols — every single one, bestie. 🔥

🍓 EXAMPLE 🍓

int main(void)
{
  int rc;
  CURLM *multi = curl_multi_init();

  rc = curl_multi_notify_disable(multi, CURLMNOTIFY_INFO_READ);
}

look at her go 😭 so simple, so iconic.

⭐ AVAILABILITY ⭐

Added in curl 8.17.0 — so if you're on something older, she's not there yet, check your version bestie 🙈

💀 RETURN VALUE 💀

This function returns a CURLMcode indicating success or error. classic. 💅

  • CURLM_OK (0) means everything was OK 🎉
  • non-zero means an error occurred — go check libcurl-errors(3) 👀
⚠️ heads up: the return code is for the whole multi stack. Problems still might have occurred on individual transfers even when one of these functions returns OK. so don't get too comfortable, ngl 😭

🧚 SEE ALSO 🧚

and that's the whole page, bestie 💖 this was libcurl, dated 2026-10-25 — go forth and disable your notifications responsibly, mwah 🫶✨🎀

📦 where this page comes from