philiptaron/lix
0
0
Fork 0
forked from lix-project/lix
Code Pull requests Activity

Merge pull request #1718 from markus1189/nix-hash-doc

Browse source 
nix-hash: Add sentence and example for nix-prefetch-url hash
This commit is contained in:
Eelco Dolstra 2017-12-08 13:59:41 +01:00 committed by GitHub
parent 82e6275a7b 0af668426d
commit d73e16df05
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
doc/manual/command-ref/nix-hash.xml
View file

@ -44,7 +44,9 @@
cryptographic hash of the contents of each cryptographic hash of the contents of each
<replaceable>path</replaceable> and prints it on standard output. By <replaceable>path</replaceable> and prints it on standard output. By
default, it computes an MD5 hash, but other hash algorithms are 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> <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 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> <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: <para>Computing hashes:
<screen> <screen>