curl/docs/cmdline-opts/url.md
Daniel Stenberg 7628502dff
managen: "added in" fixes
- up the limit: remove all mentions of 7.60 or earlier from manpage
   7.60 is 6 years old now.
 - warn on "broken" added in lines, as they avoid detection
 - fixup added in markup in a few curldown files

Closes #14002
2024-06-24 16:20:03 +02:00

33 lines
879 B
Markdown

---
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: url
Arg: <url>
Help: URL to work with
Category: curl
Added: 7.5
Multi: append
See-also:
- next
- config
Example:
- --url $URL
---
# `--url`
Specify a URL to fetch.
If the given URL is missing a scheme name (such as `http://` or `ftp://` etc)
then curl makes a guess based on the host. If the outermost subdomain name
matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol is used,
otherwise HTTP is used. 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 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!