TCLCURL_SHARE(3tcl)

📦
version 8.0.3 · 2 versions
, in ubuntu stonking

💖 TclCurl Share(n) 💖

okay bestie, so this is the TclCurl Share page — it's part of the TclCurl Easy Interface, and it's all about making your easy handles share stuff with each other. yes, sharing is caring, even for handles. 🫶

✨ NAME ✨

TclCurl — share selected data between multiple easy handles. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

curl::shareinit
curl::sharestrerror errorCode

shareHandle share ?data?
shareHandle unshare ?data?
shareHandle cleanup

💅 DESCRIPTION 💅

so the share API is literally the group-chat of your easy handles — it lets two or more easy handles share selected kinds of data. two or more, periodt. no cap.

at present, TclCurl is obsessed with sharing these two things: cookie data and DNS cache data. that's it, that's the list. 🍓

🦋 curl::shareinit

this procedure MUST be called first. like, before anything else. it hands you back a shareHandle, and that handle is what you use to share data between easy handles through the -share option of the configure command.

okay serious moment: every single call to shareinit MUST have a matching call to cleanup once you're done with the operation. no ghost handles, bestie. clean up your room. 💀

RETURN VALUE

the shareHandle you're gonna use. iconic, honestly. 👑

🌈 shareHandle share ?data?

this parameter tells us what kind of data we're sharing. it can be set to one of the values below — pick your fighter:

  • cookies — cookie data gets shared between the easy handles that are associated with this shared object. 🍪
  • dns — cached DNS entries get shared between the easy handles associated with this shared object. 🌐
ngl, a lil note: when you're using the multi interface, all easy handles added to the same multi handle share the DNS cache by default, without needing this setting at all. so like, it's already slaying on its own. ✨

🧚 shareHandle unshare ?data?

this command does the total opposite of share. the specified data type will no longer be shared. the valid values are exactly the same as for share. it's giving "we're not sharing anymore, this is my data." 🙈

💜 shareHandle cleanup

deletes a shared object. after this command has been called, the share handle can no longer be used — fr fr, it's done, it's over, don't come back to it. main character exits the chat. 👋

⭐ curl::sharestrerror errorCode

this procedure returns a string describing the error code that you passed in as the argument. it's basically the translator for when something goes wrong and you're like "what does this number MEAN" 😭

👀 SEE ALSO 👀

  • curl
  • TclCurl

and that's the whole page, bestie!! go share your data, be responsible, clean up your handles 💖

TclCurl 8.0.3 · 19-05-2026 — mwah, slay, bye! 💅✨

📦 where this page comes from