Artifactspublic-v0

curl

master
ply4 git calls39 ms288 KiB3 cachedprotocol v2
49 lines1.7 KiBRaw

--url

Specify a URL to fetch or send data to.

If the given URL is missing a scheme (such as http:// or ftp:// etc) curl guesses which scheme to use based on the hostname. If the outermost subdomain name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP case insensitively, then that protocol is used, otherwise it assumes HTTP. Scheme guessing can be avoided by providing a full URL including the scheme, or disabled by setting a default protocol, see --proto-default for details.

To control where the contents of a retrieved URL is written instead of the default stdout, use the --output or the --remote-name options. When retrieving multiple URLs in a single invoke, each provided URL needs its own dedicated destination option unless --remote-name-all is used.

On Windows, file:// accesses can be converted to network accesses by the operating system.

Starting in curl 8.13.0, curl can be told to download URLs provided in a text file, one URL per line. It is done with --url @filename: so instead of a URL, you specify a filename prefixed with the @ symbol. It can be told to load the list of URLs from stdin by providing an argument like @-.

When downloading URLs given in a file, it implies using --remote-name for each provided URL. The URLs are full, there is no globbing applied or done on these. Features such as --skip-existing work fine in combination with this.

Lines in the URL file that start with # are treated as comments and are skipped.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: url
5Arg: <url/file>
6Help: URL(s) to work with
7Category: curl
8Added: 7.5
9Multi: append
10See-also:
11 - next
12 - config
13 - path-as-is
14 - disallow-username-in-url
15Example:
16 - --url $URL
17 - --url @file
18---
20# `--url`
22Specify a URL to fetch or send data to.
24If the given URL is missing a scheme (such as `http://` or `ftp://` etc) curl
25guesses which scheme to use based on the hostname. If the outermost subdomain
26name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP case insensitively, then that
27protocol is used, otherwise it assumes HTTP. Scheme guessing can be avoided by
28providing a full URL including the scheme, or disabled by setting a default
29protocol, see --proto-default for details.
31To control where the contents of a retrieved URL is written instead of the
32default stdout, use the --output or the --remote-name options. When retrieving
33multiple URLs in a single invoke, each provided URL needs its own dedicated
34destination option unless --remote-name-all is used.
36On Windows, `file://` accesses can be converted to network accesses by the
37operating system.
39Starting in curl 8.13.0, curl can be told to download URLs provided in a text
40file, one URL per line. It is done with `--url @filename`: so instead of a
41URL, you specify a filename prefixed with the `@` symbol. It can be told to
42load the list of URLs from stdin by providing an argument like `@-`.
44When downloading URLs given in a file, it implies using --remote-name for each
45provided URL. The URLs are full, there is no globbing applied or done on
46these. Features such as --skip-existing work fine in combination with this.
48Lines in the URL file that start with `#` are treated as comments and are
49skipped.
Diagnostics4 git calls · 39 ms
CallStatusSizeTime039 ms
discover200152 B6 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
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 · hit6 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=6
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=6
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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=31
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
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 · hit31 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1034
git.response.cache=HIT
git.response.duration_ms=31
git.fetch.wants=e569dad5ade1f9259ea559f3a273d1483899c2c5
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=1034
git.pkt.payload.max=1013
git.sideband.band1.bytes=1012
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
a5e30c03dcbdee28
Request
3cc9089f…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format