curl_easy_send man page

From dcce39da3e6f7485dca39950dfc835563de3c3ea Mon Sep 17 00:00:00 2001 From: Kirill Volinsky Date: Mon, 25 Feb 2013 10:15:31 +0000 Subject: 1 step: libcurl static link git-svn-id: http://svn.miranda-ng.org/main/trunk@3763 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c --- .../curl-7.29.0/docs/libcurl/curl_easy_send.html | 64 ++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_easy_send.html (limited to 'plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_easy_send.html') diff --git a/plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_easy_send.html b/plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_easy_send.html new file mode 100644 index 0000000000..4a85a27440 --- /dev/null +++ b/plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_easy_send.html @@ -0,0 +1,64 @@ + + +curl_easy_send man page + + + + +

NAME

curl_easy_send - sends raw data over an "easy" connection

SYNOPSIS

#include <curl/easy.h> +

CURLcode curl_easy_send( CURL * curl , const void * buffer , size_t buflen , size_t * n ); +

DESCRIPTION

This function sends arbitrary data over the established connection. You may use it together with curl_easy_recv(3) to implement custom protocols using libcurl. This functionality can be particularly useful if you use proxies and/or SSL encryption: libcurl will take care of proxy negotiation and connection set-up. +

buffer is a pointer to the data of length buflen that you want sent. The variable n points to will receive the number of sent bytes. +

To establish the connection, set CURLOPT_CONNECT_ONLY option before calling curl_easy_perform(3). Note that curl_easy_send(3) will not work on connections that were created without this option. +

You must ensure that the socket is writable before calling curl_easy_send(3), otherwise the call will return CURLE_AGAIN - the socket is used in non-blocking mode internally. Use curl_easy_getinfo(3) with CURLINFO_LASTSOCKET to obtain the socket; use your operating system facilities like select(2) to check if it can be written to.

AVAILABILITY

Added in 7.18.2.

RETURN VALUE

On success, returns CURLE_OK and stores the number of bytes actually sent into *n. Note that this may very well be less than the amount you wanted to send. +

On failure, returns the appropriate error code. +

If there's no socket available to use from the previous transfer, this function returns CURLE_UNSUPPORTED_PROTOCOL.

EXAMPLE