Home | History | Annotate | Download | only in cmdline-opts
      1 Long: metalink
      2 Help: Process given URLs as metalink XML file
      3 Added: 7.27.0
      4 Requires: metalink
      5 ---
      6 This option can tell curl to parse and process a given URI as Metalink file
      7 (both version 3 and 4 (RFC 5854) are supported) and make use of the mirrors
      8 listed within for failover if there are errors (such as the file or server not
      9 being available). It will also verify the hash of the file after the download
     10 completes. The Metalink file itself is downloaded and processed in memory and
     11 not stored in the local file system.
     12 
     13 Example to use a remote Metalink file:
     14 
     15  curl --metalink http://www.example.com/example.metalink
     16 
     17 To use a Metalink file in the local file system, use FILE protocol (file://):
     18 
     19  curl --metalink file://example.metalink
     20 
     21 Please note that if FILE protocol is disabled, there is no way to use a local
     22 Metalink file at the time of this writing. Also note that if --metalink and
     23 --include are used together, --include will be ignored. This is because
     24 including headers in the response will break Metalink parser and if the
     25 headers are included in the file described in Metalink file, hash check will
     26 fail.
     27 
     28