Artifactspublic-v0

curl

master
ply4 git calls521 ms288 KiB2 cachedprotocol v2
104 lines3.0 KiBRaw

NAME

CURLOPT_POST - make an HTTP POST

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POST, long post);

DESCRIPTION

A parameter set to 1 tells libcurl to do a regular HTTP post. This also makes libcurl use a "Content-Type: application/x-www-form-urlencoded" header. This is the most commonly used POST method.

Use one of CURLOPT_POSTFIELDS(3) or CURLOPT_COPYPOSTFIELDS(3) options to specify what data to post and CURLOPT_POSTFIELDSIZE(3) or CURLOPT_POSTFIELDSIZE_LARGE(3) to set the data size.

Optionally, you can provide data to POST using the CURLOPT_READFUNCTION(3) and CURLOPT_READDATA(3) options but then you must make sure to not set CURLOPT_POSTFIELDS(3) to anything but NULL. When providing data with a callback, you must transmit it using chunked transfer-encoding or you must set the size of the data with the CURLOPT_POSTFIELDSIZE(3) or CURLOPT_POSTFIELDSIZE_LARGE(3) options. To enable chunked encoding, pass in the appropriate Transfer-Encoding header, see the post-callback.c example.

You can override the default POST Content-Type: header by setting your own with CURLOPT_HTTPHEADER(3).

Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header. You can disable this header with CURLOPT_HTTPHEADER(3) as usual.

If you use POST to an HTTP 1.1 server, you can send data without knowing the size before starting the POST if you use chunked encoding. You enable this by adding a header like "Transfer-Encoding: chunked" with CURLOPT_HTTPHEADER(3). With HTTP 1.0 or without chunked transfer, you must specify the size in the request. libcurl automatically uses chunked encoding for POSTs if the size is unknown.

When setting CURLOPT_POST(3) to 1, libcurl automatically sets CURLOPT_NOBODY(3) and CURLOPT_HTTPGET(3) to 0.

If you issue a POST request and then want to make a HEAD or GET using the same reused handle, you must explicitly set the new request type using CURLOPT_NOBODY(3) or CURLOPT_HTTPGET(3) or similar.

When setting CURLOPT_POST(3) to 0, libcurl resets the request type to the default to disable the POST. Typically that means gets reset to GET. Instead you should set a new request type explicitly as described above.

DEFAULT

0, disabled

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
    curl_easy_setopt(curl, CURLOPT_POST, 1L);

    /* set up the read callback with CURLOPT_READFUNCTION */

    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_POST
5Section: 3
6Source: libcurl
7Protocol:
8 - HTTP
9See-also:
10 - CURLOPT_HTTPPOST (3)
11 - CURLOPT_POSTFIELDS (3)
12 - CURLOPT_UPLOAD (3)
13Added-in: 7.1
14---
16# NAME
18CURLOPT_POST - make an HTTP POST
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POST, long post);
26~~~
28# DESCRIPTION
30A parameter set to 1 tells libcurl to do a regular HTTP post. This also makes
31libcurl use a "Content-Type: application/x-www-form-urlencoded" header. This
32is the most commonly used POST method.
34Use one of CURLOPT_POSTFIELDS(3) or CURLOPT_COPYPOSTFIELDS(3)
35options to specify what data to post and CURLOPT_POSTFIELDSIZE(3) or
36CURLOPT_POSTFIELDSIZE_LARGE(3) to set the data size.
38Optionally, you can provide data to POST using the
39CURLOPT_READFUNCTION(3) and CURLOPT_READDATA(3) options but then
40you must make sure to not set CURLOPT_POSTFIELDS(3) to anything but
41NULL. When providing data with a callback, you must transmit it using chunked
42transfer-encoding or you must set the size of the data with the
43CURLOPT_POSTFIELDSIZE(3) or CURLOPT_POSTFIELDSIZE_LARGE(3)
44options. To enable chunked encoding, pass in the appropriate
45Transfer-Encoding header, see the post-callback.c example.
47You can override the default POST Content-Type: header by setting your own
48with CURLOPT_HTTPHEADER(3).
50Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
51You can disable this header with CURLOPT_HTTPHEADER(3) as usual.
53If you use POST to an HTTP 1.1 server, you can send data without knowing the
54size before starting the POST if you use chunked encoding. You enable this by
55adding a header like "Transfer-Encoding: chunked" with CURLOPT_HTTPHEADER(3).
56With HTTP 1.0 or without chunked transfer, you must specify the size in the
57request. libcurl automatically uses chunked encoding for POSTs if the size is
58unknown.
60When setting CURLOPT_POST(3) to 1, libcurl automatically sets
61CURLOPT_NOBODY(3) and CURLOPT_HTTPGET(3) to 0.
63If you issue a POST request and then want to make a HEAD or GET using the same
64reused handle, you must explicitly set the new request type using
65CURLOPT_NOBODY(3) or CURLOPT_HTTPGET(3) or similar.
67When setting CURLOPT_POST(3) to 0, libcurl resets the request type to the
68default to disable the POST. Typically that means gets reset to GET. Instead
69you should set a new request type explicitly as described above.
71# DEFAULT
730, disabled
75# %PROTOCOLS%
77# EXAMPLE
79~~~c
80int main(void)
82 CURL *curl = curl_easy_init();
83 if(curl) {
84 CURLcode result;
85 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
86 curl_easy_setopt(curl, CURLOPT_POST, 1L);
88 /* set up the read callback with CURLOPT_READFUNCTION */
90 result = curl_easy_perform(curl);
92 curl_easy_cleanup(curl);
93 }
95~~~
97# %AVAILABILITY%
99# RETURN VALUE
101curl_easy_setopt(3) returns a CURLcode indicating success or error.
103CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
104libcurl-errors(3).
Diagnostics4 git calls · 521 ms
CallStatusSizeTime0521 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
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=2
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.5 KiB515 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=515
git.response.bytes=1499
git.response.cache=MISS
git.response.duration_ms=515
git.fetch.wants=1bc634a04fd0c1e54c35eca036c172f5a9ef693c
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=1499
git.pkt.payload.max=1478
git.sideband.band1.bytes=1477
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
a5e330fec93818aa
Request
54d6e86a…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format