Artifactspublic-v0

curl

master
ply4 git calls63 ms288 KiB3 cachedprotocol v2
54 lines1.9 KiBRaw

--data

Send the specified data to a server.

For HTTP(S), this is done with the POST method in the same way that a browser does when a user has filled in an HTML form and presses the submit button. This option makes curl pass the data to the server using the content-type application/x-www-form-urlencoded.

For MQTT, the data is sent as a PUBLISH.

--data-raw is almost the same but does not have a special interpretation of the @ character. To post data purely binary, you should instead use the --data-binary option. To URL-encode the value of a form field you may use --data-urlencode.

If any of these options is used more than once on the same command line, the data pieces specified are merged with a separating &-symbol. Thus, using '-d name=daniel -d skill=lousy' would generate a post chunk that looks like 'name=daniel&skill=lousy'.

If you start the data with the letter @, the rest should be a filename to read the data from, or - if you want curl to read the data from stdin. Posting data from a file named 'foobar' would thus be done with --data @foobar. When --data is told to read from a file like that, carriage returns, newlines and null bytes are stripped out. If you do not want the @ character to have a special interpretation use --data-raw instead.

The data for this option is passed on to the server exactly as provided on the command line. curl does not convert, change or improve it. It is up to the user to provide the data in the correct form.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: data
5Short: d
6Arg: <data>
7Help: Post data
8Protocols: HTTP MQTT
9Mutexed: form head upload-file
10Category: important http post upload mqtt
11Added: 4.0
12Multi: append
13See-also:
14 - data-binary
15 - data-urlencode
16 - data-raw
17 - form
18Example:
19 - -d "name=curl" $URL
20 - -d "name=curl" -d "tool=cmdline" $URL
21 - -d @filename $URL
22---
24# `--data`
26Send the specified data to a server.
28For HTTP(S), this is done with the POST method in the same way that a browser
29does when a user has filled in an HTML form and presses the submit button.
30This option makes curl pass the data to the server using the content-type
31application/x-www-form-urlencoded.
33For MQTT, the data is sent as a PUBLISH.
35--data-raw is almost the same but does not have a special interpretation of
36the @ character. To post data purely binary, you should instead use the
37--data-binary option. To URL-encode the value of a form field you may use
38--data-urlencode.
40If any of these options is used more than once on the same command line, the
41data pieces specified are merged with a separating &-symbol. Thus, using
42'-d name=daniel -d skill=lousy' would generate a post chunk that looks like
43'name=daniel&skill=lousy'.
45If you start the data with the letter @, the rest should be a filename to read
46the data from, or - if you want curl to read the data from stdin. Posting data
47from a file named 'foobar' would thus be done with --data @foobar. When --data
48is told to read from a file like that, carriage returns, newlines and null
49bytes are stripped out. If you do not want the @ character to have a special
50interpretation use --data-raw instead.
52The data for this option is passed on to the server exactly as provided on the
53command line. curl does not convert, change or improve it. It is up to the
54user to provide the data in the correct form.
Diagnostics4 git calls · 63 ms
CallStatusSizeTime063 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=4
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 · hit20 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=41
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=20
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.0 KiB · hit41 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1039
git.response.cache=HIT
git.response.duration_ms=41
git.fetch.wants=6faaad628dde134b264b99528e9f38b88093afa6
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=1039
git.pkt.payload.max=1018
git.sideband.band1.bytes=1017
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
a5e2bceaba8bcfc3
Request
4b7140b5…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format