blob: 5ec61b1dff567be62733ad1b55eec546b5df6a0e [file] [log] [blame]
xf.li6c8fc1e2023-08-12 00:11:09 -07001c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
2SPDX-License-Identifier: curl
3Long: url
4Arg: <url>
5Help: URL to work with
6Category: curl
7Example: --url $URL
8Added: 7.5
9See-also: next config
10Multi: append
11---
12Specify a URL to fetch. This option is mostly handy when you want to specify
13URL(s) in a config file.
14
15If the given URL is missing a scheme name (such as "http://" or "ftp://" etc)
16then curl will make a guess based on the host. If the outermost sub-domain
17name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol will be
18used, otherwise HTTP will be used. Since 7.45.0 guessing can be disabled by
19setting a default protocol, see --proto-default for details.
20
21To control where this URL is written, use the --output or the --remote-name
22options.
23
24**WARNING**: On Windows, particular file:// accesses can be converted to
25network accesses by the operating system. Beware!