curlopt_postfieldsize(3) [mojave man page]

CURLOPT_POSTFIELDSIZE(3)				     curl_easy_setopt options					  CURLOPT_POSTFIELDSIZE(3)

NAME

       CURLOPT_POSTFIELDSIZE - size of POST data pointed to

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDSIZE, long size);

DESCRIPTION

       If  you	want to post data to the server without having libcurl do a strlen() to measure the data size, this option must be used. When this
       option is used you can post fully binary data, which otherwise is likely to fail. If this size is set to -1, the library will use  strlen()
       to get the size.

       If you post more than 2GB, use CURLOPT_POSTFIELDSIZE_LARGE(3).

DEFAULT

       -1

PROTOCOLS

       HTTP

EXAMPLE

       CURL *curl = curl_easy_init();
       if(curl) {
	 const char *data = "data to send";

	 curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

	 /* size of the POST data */
	 curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, (long) strlen(data));

	 curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);

	 curl_easy_perform(curl);
       }

AVAILABILITY

       Along with HTTP

RETURN VALUE

       Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.

SEE ALSO

       CURLOPT_POSTFIELDS(3), CURLOPT_POSTFIELDSIZE_LARGE(3),

libcurl 7.54.0							 February 03, 2016					  CURLOPT_POSTFIELDSIZE(3)

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)