about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorMarkus Hauck <markus1189@gmail.com>2017-12-08T09·27+0100
committerMarkus Hauck <markus1189@gmail.com>2017-12-08T09·27+0100
commit0af668426d0916c9d09a06d7aacf2dc1e9590289 (patch)
tree1369ca406e449983b69a0ac13422d72b68bd4595 /doc
parente3013543d36926ecfe51e9eceab42c88cb40b138 (diff)
nix-hash: Add sentence and example for nix-prefetch-url hash
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/command-ref/nix-hash.xml13
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>