Artifactspublic-v0

curl

master
ply4 git calls336 ms288 KiB2 cachedprotocol v2
88 lines2.2 KiBRaw

NAME

CURLOPT_COPYPOSTFIELDS - have libcurl copy data to POST

SYNOPSIS

c
#include <curl/curl.h>

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

DESCRIPTION

Pass a char pointer 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 is copied, care must be taken when using this option in conjunction with CURLOPT_POSTFIELDSIZE(3) or CURLOPT_POSTFIELDSIZE_LARGE(3). If the size has not been set prior to CURLOPT_COPYPOSTFIELDS(3), the data is assumed to be a null-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 set.

The application does not have to keep the string around after setting this option.

Using this option multiple times makes the last set string override the previous ones. Set it to NULL to disable its use again.

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    char local_buffer[1024] = "data to send";
    curl_easy_setopt(curl, CURLOPT_URL, "https://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);

    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_COPYPOSTFIELDS
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_MIMEPOST (3)
9 - CURLOPT_POSTFIELDS (3)
10 - CURLOPT_POSTFIELDSIZE (3)
11 - CURLOPT_UPLOAD (3)
12Protocol:
13 - HTTP
14 - MQTT
15 - RTSP
16Added-in: 7.17.1
17---
19# NAME
21CURLOPT_COPYPOSTFIELDS - have libcurl copy data to POST
23# SYNOPSIS
25~~~c
26#include <curl/curl.h>
28CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COPYPOSTFIELDS, char *data);
29~~~
31# DESCRIPTION
33Pass a char pointer as parameter, which should be the full *data* to post in a
34HTTP POST operation. It behaves as the CURLOPT_POSTFIELDS(3) option, but the
35original data is instead copied by the library, allowing the application to
36overwrite the original data after setting this option.
38Because data is copied, care must be taken when using this option in
39conjunction with CURLOPT_POSTFIELDSIZE(3) or CURLOPT_POSTFIELDSIZE_LARGE(3).
40If the size has not been set prior to CURLOPT_COPYPOSTFIELDS(3), the data is
41assumed to be a null-terminated string; else the stored size informs the
42library about the byte count to copy. In any case, the size must not be
43changed after CURLOPT_COPYPOSTFIELDS(3), unless another CURLOPT_POSTFIELDS(3)
44or CURLOPT_COPYPOSTFIELDS(3) option is set.
46The application does not have to keep the string around after setting this
47option.
49Using this option multiple times makes the last set string override the
50previous ones. Set it to NULL to disable its use again.
52# DEFAULT
54NULL
56# %PROTOCOLS%
58# EXAMPLE
60~~~c
61int main(void)
63 CURL *curl = curl_easy_init();
64 if(curl) {
65 CURLcode result;
66 char local_buffer[1024] = "data to send";
67 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
69 /* size of the data to copy from the buffer and send in the request */
70 curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, 12L);
72 /* send data from the local stack */
73 curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, local_buffer);
75 result = curl_easy_perform(curl);
76 curl_easy_cleanup(curl);
77 }
79~~~
81# %AVAILABILITY%
83# RETURN VALUE
85curl_easy_setopt(3) returns a CURLcode indicating success or error.
87CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
88libcurl-errors(3).
Diagnostics4 git calls · 336 ms
CallStatusSizeTime0336 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=329
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch2001.2 KiB330 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1195
git.response.cache=MISS
git.response.duration_ms=330
git.fetch.wants=96269eb4c8509ce4dc19715b7e60c14424bf29ae
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1195
git.pkt.payload.max=1174
git.sideband.band1.bytes=1173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e381b42861c69c
Request
6a357b71…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format