TclCurl(3)

💖 TclCurl — the manual, but make it bestie-coded 💖

okay so this is TclCurl, section 3 of the manual, and it's about grabbing a URL with FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE, LDAP, LDAPS, IMAP, IMAPS, POP, POP3, SMTP, SMTPS and gopher syntax. yes that's the whole alphabet of protocols, she contains multitudes. 🦋

---

✨ NAME ✨

TclCurl — get a URL with FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE, LDAP, LDAPS, IMAP, IMAPS, POP, POP3, SMTP, SMTPS and gopher syntax. 💅

---

🌸 SYNOPSIS 🌸

curl::shareinit

shareHandle share ?data?

shareHandle unshare ?data?

shareHandle cleanup

curl::sharestrerror errorCode

---

🫶 DESCRIPTION 🫶

So with the share API, you can have two or more 'easy' handles sharing data among them. and like… right now they can only share cookies and DNS data. that's it. that's the tea. no cap. ✨

---

🎀 curl::shareinit 🎀

This procedure must be the first one to call, bestie. it returns a shareHandle that you need to use to share data among handles using the -share option to the configure command. and the init MUST have a corresponding call to cleanup when the operation is completed — like, they're a package deal, you can't just leave it hanging. 😭

RETURN VALUE

shareHandle to use. 💖

---

🍓 shareHandle share ?data? 🍓

The parameter specifies a type of data that should be shared. This may be set to one of the values described below:

• cookies — Cookie data will be shared across the easy handles using this shared object. 🍪
• dns — Cached DNS hosts will be shared across the easy handles using this shared object. Note that when you use the multi interface, all easy handles added to the same multi handle will share DNS cache by default without this having to be used! (yes, for free, no extra work, we love that for you 👑)

---

🦋 shareHandle unshare ?data? 🦋

This command does the opposite of share. The specified parameter will no longer be shared. Valid values are the same as those for share. it's giving ✨un-sharing✨, iconic behaviour honestly.

---

💜 sharehandle cleanup 💜

Deletes a shared object. The share handle cannot be used anymore after this function has been called. gone. done. periodt. 💀

---

🌈 curl::sharestrerror errorCode 🌈

Returns a string describing the error code passed in the argument. so you hand her an errorCode and she hands you back the explanation, like a bestie translating your ex's texts. 😌

---

👑 SEE ALSO 👑

curl, TclCurl

---

TclCurl 7.22.0 · 3 October 2011

okay that's the whole page, you ate it up fr fr 🫶 go share your cookies (the DNS kind. or the real kind. live your life). mwah 💖🎀🦋✨