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_COPYPOSTFIELDS(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_COPYPOST-
       FIELDS(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)