xref: /aosp_15_r20/external/curl/docs/cmdline-opts/url.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: url
5*6236dae4SAndroid Build Coastguard WorkerArg: <url>
6*6236dae4SAndroid Build Coastguard WorkerHelp: URL to work with
7*6236dae4SAndroid Build Coastguard WorkerCategory: curl
8*6236dae4SAndroid Build Coastguard WorkerAdded: 7.5
9*6236dae4SAndroid Build Coastguard WorkerMulti: append
10*6236dae4SAndroid Build Coastguard WorkerSee-also:
11*6236dae4SAndroid Build Coastguard Worker  - next
12*6236dae4SAndroid Build Coastguard Worker  - config
13*6236dae4SAndroid Build Coastguard WorkerExample:
14*6236dae4SAndroid Build Coastguard Worker  - --url $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--url`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerSpecify a URL to fetch or send data to.
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard WorkerIf the given URL is missing a scheme (such as `http://` or `ftp://` etc) curl
22*6236dae4SAndroid Build Coastguard Workerguesses which scheme to use based on the hostname. If the outermost subdomain
23*6236dae4SAndroid Build Coastguard Workername matches DICT, FTP, IMAP, LDAP, POP3 or SMTP case insensitively, then that
24*6236dae4SAndroid Build Coastguard Workerprotocol is used, otherwise it assumes HTTP. Scheme guessing can be avoided by
25*6236dae4SAndroid Build Coastguard Workerproviding a full URL including the scheme, or disabled by setting a default
26*6236dae4SAndroid Build Coastguard Workerprotocol, see --proto-default for details.
27*6236dae4SAndroid Build Coastguard Worker
28*6236dae4SAndroid Build Coastguard WorkerTo control where the contents of a retrieved URL is written instead of the
29*6236dae4SAndroid Build Coastguard Workerdefault stdout, use the --output or the --remote-name options. When retrieving
30*6236dae4SAndroid Build Coastguard Workermultiple URLs in a single invoke, each provided URL needs its own dedicated
31*6236dae4SAndroid Build Coastguard Workerdestination option unless --remote-name-all is used.
32*6236dae4SAndroid Build Coastguard Worker
33*6236dae4SAndroid Build Coastguard WorkerOn Windows, `file://` accesses can be converted to network accesses by the
34*6236dae4SAndroid Build Coastguard Workeroperating system.
35