1 <HTML><HEAD><TITLE>Manpage of TclCurl</TITLE>
4 Section: TclCurl share data api (n)<BR>Updated: 8 September 2008<BR><HR>
6 <A NAME="lbAB"> </A>
8 TclCurl: - get a URL with FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE or LDAP syntax.
9 <A NAME="lbAC"> </A>
12 <B>curl::shareinit</B>
15 <I>shareHandle</I><B> share </B><I>?data?</I>
18 <I>shareHandle</I><B> unshare </B><I>?data?</I>
21 <I>shareHandle</I><B> cleanup</B>
24 <B>curl::sharestrerror </B><I>errorCode</I>
28 <A NAME="lbAD"> </A>
32 With the share API, you can have two or more 'easy' handles sharing data
33 among them, so far they can only share cookies and DNS data.
35 <A NAME="lbAE"> </A>
36 <H2>curl::shareinit</H2>
38 This procedure must be the first one to call, it returns a <B>shareHandle</B>
39 that you need to use to share data among handles using the <B>-share</B> option
40 to the <B>configure</B> command. The init MUST have a corresponding call to
41 <B>cleanup</B> when the operation is completed.
46 <B>shareHandle</B> to use.
48 <A NAME="lbAF"> </A>
49 <H2>shareHandle share ?data?</H2>
52 The parameter specifies a type of data that should be shared. This may be set
53 to one of the values described below:
60 Cookie data will be shared across the easy handles using this shared object.
65 Cached DNS hosts will be shared across the easy handles using this shared object.
70 <A NAME="lbAG"> </A>
71 <H2>shareHandle unshare ?data?</H2>
73 This command does the opposite of <B>share</B>. The specified parameter will no
74 longer be shared. Valid values are the same as those for <B>share</B>.
76 <A NAME="lbAH"> </A>
77 <H2>sharehandle cleanup</H2>
80 Deletes a shared object. The share handle cannot be used anymore after this
81 function has been called.
83 <A NAME="lbAI"> </A>
84 <H2>curl::sharestrerror errorCode</H2>
86 Returns a string describing the error code passed in the argument.
88 <A NAME="lbAJ"> </A>
96 <A NAME="index"> </A><H2>Index</H2>
98 <DT><A HREF="#lbAB">NAME</A><DD>
99 <DT><A HREF="#lbAC">SYNOPSIS</A><DD>
100 <DT><A HREF="#lbAD">DESCRIPTION</A><DD>
101 <DT><A HREF="#lbAE">curl::shareinit</A><DD>
102 <DT><A HREF="#lbAF">shareHandle share ?data?</A><DD>
103 <DT><A HREF="#lbAG">shareHandle unshare ?data?</A><DD>
104 <DT><A HREF="#lbAH">sharehandle cleanup</A><DD>
105 <DT><A HREF="#lbAI">curl::sharestrerror errorCode</A><DD>
106 <DT><A HREF="#lbAJ">SEE ALSO</A><DD>
109 This document was created by man2html, using the manual pages.<BR>