master-server/deps/curl/docs/cmdline-opts/url.md

33 lines
897 B
Markdown
Raw Normal View History

2024-05-15 15:20:32 -04:00
---
2023-12-11 20:30:44 -05:00
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
2024-05-15 15:20:32 -04:00
See-also:
- next
- config
Example:
- --url $URL
2023-12-11 20:30:44 -05:00
---
2024-05-15 15:20:32 -04:00
# `--url`
Specify a URL to fetch.
If the given URL is missing a scheme name (such as `http://` or `ftp://` etc)
2023-12-11 20:30:44 -05:00
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 (added in
7.45.0), see --proto-default for details.
To control where this URL is written, use the --output or the --remote-name
options.
2024-05-15 15:20:32 -04:00
**WARNING**: On Windows, particular `file://` accesses can be converted to
2023-12-11 20:30:44 -05:00
network accesses by the operating system. Beware!