aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorant <ant@localhost.localdomain>2012-05-04 22:18:33 -0400
committerDaniel Stenberg <daniel@haxx.se>2012-05-26 23:10:25 +0200
commit462f10f8241ae8785e35b68fd40f74f18c49900e (patch)
tree50b3f5c6167ae6dc7e80f9d73828a07689b78d38 /docs
parent8834448cc15d4360f19152b4ce118c9323e43fe9 (diff)
Add Metalink information and --metalink option to man page
Diffstat (limited to 'docs')
-rw-r--r--docs/curl.114
1 files changed, 12 insertions, 2 deletions
diff --git a/docs/curl.1 b/docs/curl.1
index 65da93412..b6c28f43e 100644
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -833,14 +833,22 @@ option to -1 to make it limitless.
If this option is used several times, the last one will be used.
.IP "--metalink"
-Makes curl parse and process a local Metalink file (RFC 5854) and make use
+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).
-(Added in 7.??.?)
+Example to use a remote Metalink file:
+\fBcurl\fP -O http://www.example.com/example.metalink
+
+
+(Added in 7.??.?, disabled by default)
.IP "-n, --netrc"
Makes curl scan the \fI.netrc\fP (\fI_netrc\fP on Windows) file in the user's
home directory for login name and password. This is typically used for FTP on
@@ -1704,6 +1712,8 @@ authenticate with your current user and password.
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).
.RE
.SH FILES
.I ~/.curlrc