]> Sergey Matveev's repositories - meta4ra.git/blob - README
ee95c19e5bacc81f83d9e2db38c2c8a7a3cea37a
[meta4ra.git] / 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                     Maybe 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:shake128sum -- standardized name; command is in contrib/
28                           Can be faster on hardware than sha-*/skein-*
29 * shake256:shake256sum -- standardized name; command is in contrib/
30 * streebog-256:streebog256sum -- non-standardized name; command is in contrib/
31 * streebog-512:streebog512sum -- non-standardized name; command is in contrib/
32 * blake3-256:b3sum -- non-standardized name; additional package in most OSes
33                       Fastest parallelizeable software hash
34
35 SHA2 and SHA3 (SHAKE*) are USA's NIST standards. Streebog is Russian
36 Federation's government standard. Skein is SHA3-finalist. BLAKE3 is
37 reduced round Merklee-tree-based BLAKE2 descendant. BLAKE2 is reduced
38 round BLAKE, that also was one of SHA3-finalists.