aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTatsuhiro Tsujikawa <tatsuhiro.t@gmail.com>2012-06-23 17:08:37 +0900
committerYang Tse <yangsita@gmail.com>2012-06-25 19:22:17 +0200
commit92c40ce190d6450367ff4952b3c8d320b4afaa99 (patch)
treebd66f3041df9256487bd0da896a2e0d3c8e32d85
parent1eb74f94c46aa3168eb37da304288d84241e92ec (diff)
curl.1: Updated Metalink description in man page
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.
-rw-r--r--docs/curl.135
1 files changed, 22 insertions, 13 deletions
diff --git a/docs/curl.1 b/docs/curl.1
index c6664d3a0..78b5220df 100644
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -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).
+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 local Metalink file:
-\fBcurl\fP --metalink example.metalink
+Example to use a remote Metalink file:
-If Metalink support is enabled, curl will also use remote Metalinks if they
-are offered with the correct MIME type (application/metalink+xml).
+\fBcurl\fP --metalink http://www.example.com/example.metalink
-Example to use a remote Metalink file:
-\fBcurl\fP -O 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