moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2025-02-28 09:21:50 -05:00
Code Issues Releases Wiki Activity

curl_easy_setopt: documented CURLSOCKTYPE_ACCEPT for SOCKOPTFUNCTION

Browse Source
This commit is contained in:
Daniel Stenberg 2012-08-16 23:32:55 +02:00
parent 82b0aebef3
commit 41a3bff3da
3 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
TODO-RELEASE
View File

@ -6,8 +6,6 @@ To be addressed in 7.28
312 - custom Content-Length appears in CONNECT, solve it by offering a separate 312 - custom Content-Length appears in CONNECT, solve it by offering a separate
option to provide headers for the CONNECT request option to provide headers for the CONNECT request
314 - CURL_SOCKOPTFUNCTION for accept()ed connection, see Gokhan Sengun's patch
315 - multiple receivers with SMTP and one fails 315 - multiple receivers with SMTP and one fails
317 - CURLINFO_SSL_TRUST to return SSL-specific data for a darwinssl build 317 - CURLINFO_SSL_TRUST to return SSL-specific data for a darwinssl build

20
docs/libcurl/curl_easy_setopt.3
View File

@ -274,14 +274,18 @@ Pass a pointer to a function that matches the following prototype: \fBint
function(void *clientp, curl_socket_t curlfd, curlsocktype purpose);\fP. This function(void *clientp, curl_socket_t curlfd, curlsocktype purpose);\fP. This
function gets called by libcurl after the socket() call but before the function gets called by libcurl after the socket() call but before the
connect() call. The callback's \fIpurpose\fP argument identifies the exact connect() call. The callback's \fIpurpose\fP argument identifies the exact
purpose for this particular socket, and currently only one value is supported: purpose for this particular socket:
\fICURLSOCKTYPE_IPCXN\fP for the primary connection (meaning the control
connection in the FTP case). Future versions of libcurl may support more \fICURLSOCKTYPE_IPCXN\fP for actively created connections or since 7.28.0
purposes. It passes the newly created socket descriptor so additional \fICURLSOCKTYPE_ACCEPT\fP for FTP when the connection was setup with PORT/EPSV
setsockopt() calls can be done at the user's discretion. Return 0 (zero) from (in earlier versions these sockets weren't passed to this callback).
the callback on success. Return 1 from the callback function to signal an
unrecoverable error to the library and it will close the socket and return Future versions of libcurl may support more purposes. It passes the newly
\fICURLE_COULDNT_CONNECT\fP. (Option added in 7.16.0) created socket descriptor so additional setsockopt() calls can be done at the
user's discretion. Return 0 (zero) from the callback on success. Return 1
from the callback function to signal an unrecoverable error to the library and
it will close the socket and return \fICURLE_COULDNT_CONNECT\fP. (Option
added in 7.16.0)
Added in 7.21.5, the callback function may return Added in 7.21.5, the callback function may return
\fICURL_SOCKOPT_ALREADY_CONNECTED\fP, which tells libcurl that the socket is \fICURL_SOCKOPT_ALREADY_CONNECTED\fP, which tells libcurl that the socket is

1
docs/libcurl/symbols-in-versions
View File

@ -567,6 +567,7 @@ CURLSHOPT_SHARE 7.10.3
CURLSHOPT_UNLOCKFUNC 7.10.3 CURLSHOPT_UNLOCKFUNC 7.10.3
CURLSHOPT_UNSHARE 7.10.3 CURLSHOPT_UNSHARE 7.10.3
CURLSHOPT_USERDATA 7.10.3 CURLSHOPT_USERDATA 7.10.3
CURLSOCKTYPE_ACCEPT 7.28.0
CURLSOCKTYPE_IPCXN 7.16.0 CURLSOCKTYPE_IPCXN 7.16.0
CURLSSH_AUTH_AGENT 7.28.0 CURLSSH_AUTH_AGENT 7.28.0
CURLSSH_AUTH_ANY 7.16.1 CURLSSH_AUTH_ANY 7.16.1