Artifactspublic-v0

curl

master
ply4 git calls158 ms288 KiB2 cachedprotocol v2
58 lines2.0 KiBRaw

--request

Change the method to use when starting the transfer.

curl passes on the verbatim string you give it in the request without any filter or other safe guards. That includes white space and control characters.

HTTP

Specifies a custom request method to use when communicating with the HTTP server. The specified request method is used instead of the method otherwise used (which defaults to GET). Read the HTTP 1.1 specification for details and explanations. Common additional HTTP requests include PUT and DELETE, while related technologies like WebDAV offers PROPFIND, COPY, MOVE and more.

Normally you do not need this option. All sorts of GET, HEAD, POST and PUT requests are rather invoked by using dedicated command line options.

This option only changes the actual word used in the HTTP request, it does not alter the way curl behaves. For example if you want to make a proper HEAD request, using -X HEAD does not suffice. You need to use the --head option.

If --location is used, the method string you set with --request is used for all requests, which may cause unintended side-effects when curl does not change request method according to the HTTP 30x response codes - and similar. Consider using --follow instead in combination with --request.

FTP

Specifies a custom FTP command to use instead of LIST when doing file lists with FTP.

POP3

Specifies a custom POP3 command to use instead of LIST or RETR. (Added in 7.26.0)

IMAP

Specifies a custom IMAP command to use instead of LIST. (Added in 7.30.0)

SMTP

Specifies a custom SMTP command to use instead of HELP or VRFY. (Added in 7.34.0)

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: request
5Short: X
6Arg: <method>
7Help: Specify request method to use
8Category: connection pop3 ftp imap smtp
9Added: 6.0
10Multi: single
11See-also:
12 - request-target
13 - follow
14Example:
15 - --request "DELETE" $URL
16 - -X NLST ftp://example.com/
17---
19# `--request`
21Change the method to use when starting the transfer.
23curl passes on the verbatim string you give it in the request without any
24filter or other safe guards. That includes white space and control characters.
26## HTTP
27Specifies a custom request method to use when communicating with the HTTP
28server. The specified request method is used instead of the method otherwise
29used (which defaults to *GET*). Read the HTTP 1.1 specification for details
30and explanations. Common additional HTTP requests include *PUT* and *DELETE*,
31while related technologies like WebDAV offers *PROPFIND*, *COPY*, *MOVE* and
32more.
34Normally you do not need this option. All sorts of *GET*, *HEAD*, *POST* and
35*PUT* requests are rather invoked by using dedicated command line options.
37This option only changes the actual word used in the HTTP request, it does not
38alter the way curl behaves. For example if you want to make a proper HEAD
39request, using -X HEAD does not suffice. You need to use the --head option.
41If --location is used, the method string you set with --request is used for
42all requests, which may cause unintended side-effects when curl does not
43change request method according to the HTTP 30x response codes - and similar.
44Consider using --follow instead in combination with --request.
46## FTP
47Specifies a custom FTP command to use instead of *LIST* when doing file lists
48with FTP.
50## POP3
51Specifies a custom POP3 command to use instead of *LIST* or *RETR*.
52(Added in 7.26.0)
54## IMAP
55Specifies a custom IMAP command to use instead of *LIST*. (Added in 7.30.0)
57## SMTP
58Specifies a custom SMTP command to use instead of *HELP* or **VRFY**. (Added in 7.34.0)
Diagnostics4 git calls · 158 ms
CallStatusSizeTime0158 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.0 KiB152 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=152
git.response.bytes=1074
git.response.cache=MISS
git.response.duration_ms=152
git.fetch.wants=2c9d7776e587c1e8ad56cb1623f5f6be0340b192
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=1074
git.pkt.payload.max=1053
git.sideband.band1.bytes=1052
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
a5e1e412db09d96e
Request
77968cc9…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format