README

   1 meta4ra -- Metalink4 utilities
   2
   3 meta4-create utility is used to create Metalink4
   4 (https://datatracker.ietf.org/doc/html/rfc5854)
   5 .meta4-file for single specified file.
   6
   7 -fn NAME    -- the only required option specifying file's name.
   8 -desc "..." -- set file's description.
   9 -mtime FILE -- let published date be equal to FILE's mtime.
  10 -sig FILE   -- path to armored OpenPGP's signature file.
  11 -torrent URL -- set BitTorrent's URL.
  12 -hashes -- comma-separated list of colon-separated pairs of hash'es
  13            name and the external command used to compute it. Command
  14            shall take the data from stdin and print the digest in
  15            hexadecimal form with the following newline to stdout.
  16
  17 Following hashes are predefined by default:
  18
  19 * sha-256:sha256 -- standardized name; standard command in many OSes
  20                     May be fast on hardware accelerated CPUs.
  21 * sha-512:sha512 -- standardized name; standard command in many OSes
  22                     Faster on 64-bit CPUs than software sha-256.
  23 * skein-256:skein256 -- non-standardized name; out-of-box command in FreeBSD
  24                         Faster than software sha-*/shake*.
  25 * skein-512:skein512 -- non-standardized name; out-of-box command in FreeBSD
  26                         Faster on 64-bit CPUs than skein-256.
  27 * shake128:goshake128 -- standardized name; non-standard command
  28                          Faster than software sha-*. Much faster on hardware.
  29 * shake256:goshake256 -- standardized name; non-standard command
  30                          Same speed as sha-512 on 64-bit CPUs.
  31                          Much faster on hardware.
  32 * streebog-256:streebog256sum -- non-standardized name; command is in contrib/
  33 * streebog-512:streebog512sum -- non-standardized name; command is in contrib/
  34 * blake3-256:b3sum -- non-standardized name; additional package in most OSes
  35                       Fastest parallelizeable software hash
  36
  37 SHA2 and SHA3 (SHAKE*) are USA's NIST standards. Streebog is Russian
  38 Federation's government standard. Skein is SHA3-finalist. BLAKE3 is
  39 reduced round Merklee-tree-based BLAKE2 descendant. BLAKE2 is reduced
  40 round BLAKE, that also was one of SHA3-finalists.
  41
  42 meta4-check utility is used to check files against provided Metalink4.
  43
  44 -extract-sig -- store the OpenPGP signature (if exists) in .asc file nearby.
  45 -hashes      -- same as in meta4-create. Hashes are sorted by preferences
  46                 priority. First matching one will be used to check integrity.