1 <HTML><HEAD><TITLE>Manpage of TclCurl</TITLE>
4 Section: TclCurl share data api (3)<BR>Updated: 03 October 2011<BR><HR>
6 <A NAME="lbAB"> </A>
8 TclCurl: - get a URL with FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE, LDAP,
9 LDAPS, IMAP, IMAPS, POP, POP3, SMTP, SMTPS and gopher syntax.
10 <A NAME="lbAC"> </A>
13 <B>curl::shareinit</B>
16 <I>shareHandle</I><B> share </B><I>?data?</I>
19 <I>shareHandle</I><B> unshare </B><I>?data?</I>
22 <I>shareHandle</I><B> cleanup</B>
25 <B>curl::sharestrerror </B><I>errorCode</I>
29 <A NAME="lbAD"> </A>
33 With the share API, you can have two or more 'easy' handles sharing data
34 among them, so far they can only share cookies and DNS data.
36 <A NAME="lbAE"> </A>
37 <H2>curl::shareinit</H2>
39 This procedure must be the first one to call, it returns a <B>shareHandle</B>
40 that you need to use to share data among handles using the <B>-share</B> option
41 to the <B>configure</B> command. The init MUST have a corresponding call to
42 <B>cleanup</B> when the operation is completed.
47 <B>shareHandle</B> to use.
49 <A NAME="lbAF"> </A>
50 <H2>shareHandle share ?data?</H2>
53 The parameter specifies a type of data that should be shared. This may be set
54 to one of the values described below:
61 Cookie data will be shared across the easy handles using this shared object.
66 Cached DNS hosts will be shared across the easy handles using this shared object.
71 <A NAME="lbAG"> </A>
72 <H2>shareHandle unshare ?data?</H2>
74 This command does the opposite of <B>share</B>. The specified parameter will no
75 longer be shared. Valid values are the same as those for <B>share</B>.
77 <A NAME="lbAH"> </A>
78 <H2>sharehandle cleanup</H2>
81 Deletes a shared object. The share handle cannot be used anymore after this
82 function has been called.
84 <A NAME="lbAI"> </A>
85 <H2>curl::sharestrerror errorCode</H2>
87 Returns a string describing the error code passed in the argument.
89 <A NAME="lbAJ"> </A>
97 <A NAME="index"> </A><H2>Index</H2>
99 <DT><A HREF="#lbAB">NAME</A><DD>
100 <DT><A HREF="#lbAC">SYNOPSIS</A><DD>
101 <DT><A HREF="#lbAD">DESCRIPTION</A><DD>
102 <DT><A HREF="#lbAE">curl::shareinit</A><DD>
103 <DT><A HREF="#lbAF">shareHandle share ?data?</A><DD>
104 <DT><A HREF="#lbAG">shareHandle unshare ?data?</A><DD>
105 <DT><A HREF="#lbAH">sharehandle cleanup</A><DD>
106 <DT><A HREF="#lbAI">curl::sharestrerror errorCode</A><DD>
107 <DT><A HREF="#lbAJ">SEE ALSO</A><DD>
110 This document was created by man2html, using the manual pages.<BR>