• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: url
5Arg: <url>
6Help: URL to work with
7Category: curl
8Added: 7.5
9Multi: append
10See-also:
11  - next
12  - config
13Example:
14  - --url $URL
15---
16
17# `--url`
18
19Specify a URL to fetch. This option is mostly handy when you want to specify
20URL(s) in a config file.
21
22If the given URL is missing a scheme name (such as "http://" or "ftp://" etc)
23then curl makes a guess based on the host. If the outermost subdomain name
24matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol is used,
25otherwise HTTP is used. Guessing can be avoided by providing a full URL
26including the scheme, or disabled by setting a default protocol (added in
277.45.0), see --proto-default for details.
28
29To control where this URL is written, use the --output or the --remote-name
30options.
31
32**WARNING**: On Windows, particular file:// accesses can be converted to
33network accesses by the operating system. Beware!
34