moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2025-02-28 17:31:46 -05:00
Code Issues Releases Wiki Activity

curl.1: Updated Metalink description in man page

Browse Source 
Documented that --include will be ignored if both --metalink
and --include are specified.
Also documented that a Metalink file in the local file system
cannot be used if FILE protocol is disabled.
This commit is contained in:
Tatsuhiro Tsujikawa 2012-06-23 17:08:37 +09:00 committed by Yang Tse
parent 1eb74f94c4
commit 92c40ce190
1 changed files with 23 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
docs/curl.1
View File

@ -833,19 +833,28 @@ option to -1 to make it limitless.
If this option is used several times, the last one will be used.
.IP "--metalink"
If curl is built against the libmetalink library then this option can tell
curl to parse and process a local Metalink file (RFC 5854) and make use
of the mirrors listed within for failover if there are errors (such as the
file or server not being available).
Example to use a local Metalink file:
\fBcurl\fP --metalink example.metalink
If Metalink support is enabled, curl will also use remote Metalinks if they
are offered with the correct MIME type (application/metalink+xml).
If curl is built against the libmetalink library then this option can
tell curl to parse and process a given URI as Metalink file (both
version 3 and 4 (RFC 5854) are supported) and make use of the mirrors
listed within for failover if there are errors (such as the file or
server not being available). The Metalink file itself is downloaded
and processed in memory and not stored in the local file system.
Example to use a remote Metalink file:
\fBcurl\fP -O http://www.example.com/example.metalink
\fBcurl\fP --metalink http://www.example.com/example.metalink
To use a Metalink file in the local file system, use FILE protocol
(file://):
\fBcurl\fP --metalink file://example.metalink
Please note that if FILE protocol is disabled, there is no way to use
a local Metalink file at the time of this writing. Also note that If
--metalink and --include are used together, --include will be
ignored. This is because including headers in the response will break
Metalink parser and if the headers are included in the file described
in Metalink file, hash check will fail.
(Added in 7.27.0)
.IP "-n, --netrc"
@ -1710,9 +1719,9 @@ authenticate with your current user and password.
.IP "TLS-SRP"
SRP (Secure Remote Password) authentication is supported for TLS.
.IP "Metalink"
This curl supports Metalink (RFC 5854), which describes mirrors and hashes.
curl will use mirrors for failover if there are errors (such as the file or
server not being available).
This curl supports Metalink (both version 3 and 4 (RFC 5854)), which
describes mirrors and hashes. curl will use mirrors for failover if
there are errors (such as the file or server not being available).
.RE
.SH FILES
.I ~/.curlrc