Unix/Linux Go Back    


CentOS 7.0 - man page for curl_easy_send (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


curl_easy_send(3)			  libcurl Manual			curl_easy_send(3)

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  func-
       tionality  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_per-
       form(3). Note that curl_easy_send(3) will not work on connections that were created  with-
       out 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
       See sendrecv.c in docs/examples directory for usage example.

SEE ALSO
       curl_easy_setopt(3), curl_easy_perform(3), curl_easy_getinfo(3), curl_easy_recv(3)

libcurl 7.18.2				  29 April 2008 			curl_easy_send(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:36 PM.