gnurl_mime_headers(3)

💅 gnurl_mime_headers(3) — bestie's guide to custom mime part headers

okay so we're in the libgnurl Manual (libgnurl, yes, the gnurl-flavoured curl docs) and today's main character is gnurl_mime_headers(3). buckle up, this one's short but she matters 🎀

---

✨ NAME ✨

curl_mime_headers — set a mime part's custom headers

(yes bestie, the function inside is called curl_mime_headers, the page is called gnurl_mime_headers. it's giving rebrand. don't overthink it 💅)

---

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLcode curl_mime_headers(curl_mimepart * part, struct curl_slist *
headers, int take_ownership);

like all good things, she returns a CURLcode and takes three things. let's meet them 🫶

---

💖 DESCRIPTION 💖

curl_mime_headers(3) sets a mime part's custom headers. that's the whole vibe. no cap.

• part — the part's handle you're assigning the custom headers list to. your little mime part bestie 🧚
• headers — the head of a list of custom headers. and listen, it may be set to NULL to remove a previously attached custom header list. so NULL is not a bug, it's a personality reset ✨
• take_ownership — when non-zero, it causes the list to be freed upon replacement or mime structure deletion. in that case the list must not be freed explicitly. read that again. like, do not double-free her, she's taken 🙈

lowkey important: setting a part's custom headers list twice is valid: only the value set by the last call is retained. so no drama, the newest one wins 👑

---

🦋 AVAILABILITY 🦋

as long as at least one of HTTP, SMTP or IMAP is enabled. added in 7.56.0. so if you're on something ancient, sorry bestie, no headers for you 😭

---

⭐ RETURN VALUE ⭐

CURLE_OK or a CURL error code upon failure. that's it, that's the whole return value. check it, periodt 💀

---

🔥 EXAMPLE 🔥

here's the glow-up demo, copied exactly so you can paste it and slay:

 struct curl_slist *headers = NULL;

 headers = curl_slist_append("Custom-Header: mooo", headers);

 /* use these headers, please take ownership */
 curl_mime_headers(part, headers, TRUE);

 /* pass on this data */
 curl_mime_data(part, "12345679", CURL_ZERO_TERMINATED);

 /* set name */
 curl_mime_name(part, "numbers");

the way she says "please take ownership" 😭 iconic. and yes, that string is literally "Custom-Header: mooo". we love a cow moment 🐄

---

🌈 SEE ALSO 🌈

• curl_mime_addpart(3) — go read it, iykyk 🫶

---

and that's the page! 🎀 no notes, she ate. this gem came from libcurl 7.56.0, dated 22 August 2017, and the page itself is gnurl_mime_headers(3) — love her, read her, use her responsibly 💜💅