moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-12-21 23:58:49 -05:00
Code Issues Releases Wiki Activity

Dominick Meglio's added share interface documentation

Browse Source
This commit is contained in:
Daniel Stenberg 2004-02-09 09:07:26 +00:00
parent 6eb0b5b917
commit 220caed248
4 changed files with 51 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/libcurl/curl_share_cleanup.3
View File

@ -13,7 +13,9 @@ This function deletes a shared object. The share handle cannot be used anymore
when this function has been called. when this function has been called.
.SH RETURN VALUE .SH RETURN VALUE
If this function returns non-zero, the object was not properly deleted and it CURLSHE_OK (zero) means that the option was set properly, non-zero means an
still remains! error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors.3\fP
man page for the full list with descriptions. If an error occurs, then the
share object will not be deleted.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_share_init "(3), " curl_share_setopt "(3)" .BR curl_share_init "(3), " curl_share_setopt "(3)"

4
docs/libcurl/curl_share_init.3
View File

@ -14,8 +14,8 @@ share-functions, sometimes refered to as a share handle on some places in the
documentation. This init call MUST have a corresponding call to documentation. This init call MUST have a corresponding call to
\fIcurl_share_cleanup\fP when all operations using the share are complete. \fIcurl_share_cleanup\fP when all operations using the share are complete.
.SH RETURN VALUE .SH RETURN VALUE
If this function returns NULL, something went wrong and you got no share If this function returns NULL, something went wrong (out of memory, etc.)
object to use. and therefore the share object was not created.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_share_cleanup "(3), " curl_share_setopt "(3)" .BR curl_share_cleanup "(3), " curl_share_setopt "(3)"

47
docs/libcurl/curl_share_setopt.3
View File

@ -11,8 +11,7 @@ CURLSHcode curl_share_setopt(CURLSH *share, CURLSHoption option, parameter);
.SH DESCRIPTION .SH DESCRIPTION
Set the \fIoption\fP to \fIparameter\fP for the given \fIshare\fP. Set the \fIoption\fP to \fIparameter\fP for the given \fIshare\fP.
.SH OPTIONS .SH OPTIONS
.TP 0.4i .IP CURLSHOPT_LOCKFUNC
.B CURLSHOPT_LOCKFUNC
The \fIparameter\fP must be a pointer to a function matching the following The \fIparameter\fP must be a pointer to a function matching the following
prototype: prototype:
@ -24,23 +23,35 @@ only one lock is given at any time for each kind of data.
\fIaccess\fP defines what access type libcurl wants, shared or single. \fIaccess\fP defines what access type libcurl wants, shared or single.
\fIuserptr\fP is the pointer you set with \fICURLSHOPT_USERDAT\fP. \fIuserptr\fP is the pointer you set with \fICURLSHOPT_USERDATA\fP.
.IP CURLSHOPT_UNLOCKFUNC
The \fIparameter\fP must be a pointer to a function matching the following
prototype:
.TP void unlock_function(CURL *handle, curl_lock_data data, void *userptr);
.B CURLSHOPT_UNLOCKFUNC
hej \fIdata\fP defines what data libcurl wants to unlock, and you must make sure
.TP that only one lick is given at any time for each kind of data.
.B CURLSHOPT_SHARE
hej \fIuserptr\fP is the pointer you set with \fICURLSHOPT_USERDATA\fP.
.TP .IP CURLSHOPT_SHARE
.B CURLSHOPT_UNSHARE The \fIparameter\fP specifies a type of data that should be shared. This may
hej be set to one of the values described below.
.TP .IP CURL_LOCK_DATA_COOKIE
.B CURLSHOPT_USERDATA COOKIE data will be shared across the easy handles using this shared object.
hej .IP CURL_LOCK_DATA_DNS
.PP Cached DNS hosts will be shared across the easy handles using this shared
object.
.IP CURLSHOPT_UNSHARE
This option does the opposite of \fICURLSHOPT_SHARE\fP. It specifies that
the specified \fIparameter\fP will no longer be shared. Valid values are
the same as those for \fICURLSHOPT_SHARE\fP.
.IP CURLSHOPT_USERDATA
The \fIparameter\fP allows you to specify a pointer to data that will passed
to the lock_function and unlock_function each time it is called.
.SH RETURN VALUE .SH RETURN VALUE
If this function returns non-zero, something was wrong! CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors.3\fP
man page for the full list with descriptions.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_share_cleanup "(3), " curl_share_init "(3)" .BR curl_share_cleanup "(3), " curl_share_init "(3)"

19
docs/libcurl/libcurl-errors.3
View File

@ -15,7 +15,6 @@ human readable error string that may offer more details about the error cause
than just the error code does. than just the error code does.
CURLcode is one of the following: CURLcode is one of the following:
.RS 0
.IP "CURLE_OK (0)" .IP "CURLE_OK (0)"
All fine. Proceed as usual. All fine. Proceed as usual.
.IP "CURLE_UNSUPPORTED_PROTOCOL (1)" .IP "CURLE_UNSUPPORTED_PROTOCOL (1)"
@ -183,8 +182,22 @@ Unrecognized transfer encoding
Invalid LDAP URL Invalid LDAP URL
.IP "CURLE_FILESIZE_EXCEEDED (63)" .IP "CURLE_FILESIZE_EXCEEDED (63)"
Maximum file size exceeded Maximum file size exceeded
.RE
.SH "CURLMcode" .SH "CURLMcode"
This is the generic return code used by functions in the libcurl multi This is the generic return code used by functions in the libcurl multi
interface. interface.
This is left to be documented.
.SH "CURLSHcode"
The "share" interface will return a CURLSHcode to indicate when an
error has occurred.
CURLSHcode is one of the following:
.IP "CURLSHE_OK (0)"
All fine. Proceed as usual.
.IP "CURLSHE_BAD_OPTION (1)"
An invalid option was passed to the function.
.IP "CURLSHE_IN_USE (2)"
The share object is currently in use.
.IP "CURLSHE_INVALID (3)"
An invalid share object was passed to the function.