CURLOPT_COPYPOSTFIELDS(3)  curl_easy_setopt options  CURLOPT_COPYPOSTFIELDS(3)

NAME
       CURLOPT_COPYPOSTFIELDS - have libcurl copy data to POST

SYNOPSIS
       #include <curl/curl.h>

       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_COPYPOSTFIELDS, char
       *data);

DESCRIPTION
       Pass a char * as parameter, which should be the full data to post in  a
       HTTP  POST  operation.  It behaves as the CURLOPT_POSTFIELDS(3) option,
       but the original data is instead copied by the  library,  allowing  the
       application to overwrite the original data after setting this option.

       Because  data  are copied, care must be taken when using this option in
       conjunction   with   CURLOPT_POSTFIELDSIZE(3)   or   CURLOPT_POSTFIELD-
       SIZE_LARGE(3):  If the size has not been set prior to CURLOPT_COPYPOST-
       FIELDS(3), the data is assumed to be a zero terminated string; else the
       stored  size  informs  the library about the byte count to copy. In any
       case, the size must not  be  changed  after  CURLOPT_COPYPOSTFIELDS(3),
       unless   another   CURLOPT_POSTFIELDS(3)  or  CURLOPT_COPYPOSTFIELDS(3)
       option is issued.

DEFAULT
       NULL

PROTOCOLS
       HTTP(S)

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         char local_buffer[1024]="data to send";
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

         /* size of the data to copy from the buffer and send in the request */
         curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, 12L);

         /* send data from the local stack */
         curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, local_buffer);

         curl_easy_perform(curl);
       }

AVAILABILITY
       Added in 7.17.1

RETURN VALUE
       Returns CURLE_OK if the option is  supported,  CURLE_UNKNOWN_OPTION  if
       not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space.

SEE ALSO
       CURLOPT_POSTFIELDS(3), CURLOPT_POSTFIELDSIZE(3),

libcurl 7.54.0                 February 03, 2016     CURLOPT_COPYPOSTFIELDS(3)