2025-04-29 02:51:27 -04:00

1.7 KiB

c SPDX-License-Identifier Long Arg Help Category Added Multi See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl url <url/file> URL(s) to work with curl 7.5 append
next
config
path-as-is
disallow-username-in-url
--url $URL
--url @file

--url

Specify a URL to fetch or send data to.

If the given URL is missing a scheme (such as http:// or ftp:// etc) curl guesses which scheme to use based on the hostname. If the outermost subdomain name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP case insensitively, then that protocol is used, otherwise it assumes HTTP. Scheme 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 the contents of a retrieved URL is written instead of the default stdout, use the --output or the --remote-name options. When retrieving multiple URLs in a single invoke, each provided URL needs its own dedicated destination option unless --remote-name-all is used.

On Windows, file:// accesses can be converted to network accesses by the operating system.

Starting in curl 8.13.0, curl can be told to download URLs provided in a text file, one URL per line. It is done by with --url @filename: so instead of a URL, you specify a filename prefixed with the @ symbol. It can be told to load the list of URLs from stdin by providing an argument like @-.

When downloading URLs given in a file, it implies using --remote-name for each provided URL. The URLs are full, there is no globbing applied or done on these. Features such as --skip-existing work fine in combination with this.

Lines in the URL file that start with # are treated as comments and are skipped.