summaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/url.d
blob: f0ce9f43403bac2ebf5e1ff6f31554df2be2422b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
Long: url
Arg: <url>
Help: URL to work with
Category: curl
Example: --url $URL
Added: 7.5
---
Specify a URL to fetch. This option is mostly handy when you want to specify
URL(s) in a config file.

If the given URL is missing a scheme name (such as "http://" or "ftp://" etc)
then curl will make a guess based on the host. If the outermost sub-domain
name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol will be
used, otherwise HTTP will be used. Since 7.45.0 guessing can be disabled by
setting a default protocol, see --proto-default for details.

This option may be used any number of times. To control where this URL is
written, use the --output or the --remote-name options.

**WARNING**: On Windows, particular file:// accesses can be converted to
network accesses by the operating system. Beware!