diff options
| author | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2017-12-08T12·59+0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-12-08T12·59+0100 |
| commit | d73e16df05691303996b6d7c0c00309622351052 (patch) | |
| tree | b8d4e9ec34686a2ecb5eef0a630a887dacc0934c | |
| parent | 82e6275a7b4ed3ba7924c9ae56fb1d75c084749e (diff) | |
| parent | 0af668426d0916c9d09a06d7aacf2dc1e9590289 (diff) | |
Merge pull request #1718 from markus1189/nix-hash-doc
nix-hash: Add sentence and example for nix-prefetch-url hash
| -rw-r--r-- | doc/manual/command-ref/nix-hash.xml | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/manual/command-ref/nix-hash.xml b/doc/manual/command-ref/nix-hash.xml index b4b509773d33..8d8213c0bca8 100644 --- a/doc/manual/command-ref/nix-hash.xml +++ b/doc/manual/command-ref/nix-hash.xml @@ -44,7 +44,9 @@ cryptographic hash of the contents of each <replaceable>path</replaceable> and prints it on standard output. By default, it computes an MD5 hash, but other hash algorithms are -available as well. The hash is printed in hexadecimal.</para> +available as well. The hash is printed in hexadecimal. To generate +the same hash as <command>nix-prefetch-url</command> you have to +specify multiple arguments, see below for an example.</para> <para>The hash is computed over a <emphasis>serialisation</emphasis> of each path: a dump of the file system tree rooted at the path. This @@ -122,6 +124,15 @@ cryptographic hash as <literal>nix-store --dump <refsection><title>Examples</title> +<para>Computing the same hash as <command>nix-prefetch-url</command>: +<screen> +$ nix-prefetch-url file://<(echo test) +1lkgqb6fclns49861dwk9rzb6xnfkxbpws74mxnx01z9qyv1pjpj +$ nix-hash --type sha256 --flat --base32 <(echo test) +1lkgqb6fclns49861dwk9rzb6xnfkxbpws74mxnx01z9qyv1pjpj +</screen> +</para> + <para>Computing hashes: <screen> |