.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix-hash" "1" ""
.SH Name
\fCnix-hash\fR - compute the cryptographic hash of a path
.SH Synopsis
\fCnix-hash\fR [\fC--flat\fR] [\fC--base32\fR] [\fC--truncate\fR] [\fC--type\fR \fIhashAlgo\fR] \fIpath…\fR
.PP
\fCnix-hash\fR \fC--to-base16\fR \fIhash…\fR
.PP
\fCnix-hash\fR \fC--to-base32\fR \fIhash…\fR
.SH Description
The command \fCnix-hash\fR computes the cryptographic hash of the contents
of each \fIpath\fR 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. To generate the same hash as
\fCnix-prefetch-url\fR you have to specify multiple arguments, see below for
an example.
.PP
The hash is computed over a \fIserialisation\fR of each path: a dump of
the file system tree rooted at the path. This allows directories and
symlinks to be hashed as well as regular files. The dump is in the
\fINAR format\fR produced by \fB\fCnix-store
--dump\fR\fR (\fInix-store.md#operation---dump\fR).  Thus, \fCnix-hash path\fR
yields the same cryptographic hash as \fCnix-store --dump path |
md5sum\fR.
.SH Options
.IP "\(bu" 2
\fC--flat\fR
.br
Print the cryptographic hash of the contents of each regular file
\fIpath\fR. That is, do not compute the hash over the dump of \fIpath\fR.
The result is identical to that produced by the GNU commands
\fCmd5sum\fR and \fCsha1sum\fR.
.IP "\(bu" 2
\fC--base32\fR
.br
Print the hash in a base-32 representation rather than hexadecimal.
This base-32 representation is more compact and can be used in Nix
expressions (such as in calls to \fCfetchurl\fR).
.IP "\(bu" 2
\fC--truncate\fR
.br
Truncate hashes longer than 160 bits (such as SHA-256) to 160 bits.
.IP "\(bu" 2
\fC--type\fR \fIhashAlgo\fR
.br
Use the specified cryptographic hash algorithm, which can be one of
\fCmd5\fR, \fCsha1\fR, \fCsha256\fR, and \fCsha512\fR.
.IP "\(bu" 2
\fC--to-base16\fR
.br
Don’t hash anything, but convert the base-32 hash representation
\fIhash\fR to hexadecimal.
.IP "\(bu" 2
\fC--to-base32\fR
.br
Don’t hash anything, but convert the hexadecimal hash representation
\fIhash\fR to base-32.
.SH Examples
Computing the same hash as \fCnix-prefetch-url\fR:
.LP
.EX
$ nix-prefetch-url file://<(echo test)
1lkgqb6fclns49861dwk9rzb6xnfkxbpws74mxnx01z9qyv1pjpj
$ nix-hash --type sha256 --flat --base32 <(echo test)
1lkgqb6fclns49861dwk9rzb6xnfkxbpws74mxnx01z9qyv1pjpj
.EE
.PP
Computing hashes:
.LP
.EX
$ mkdir test
$ echo \(dqhello\(dq > test/world

$ nix-hash test/ (MD5 hash; default)
8179d3caeff1869b5ba1744e5a245c04

$ nix-store --dump test/ | md5sum (for comparison)
8179d3caeff1869b5ba1744e5a245c04  -

$ nix-hash --type sha1 test/
e4fd8ba5f7bbeaea5ace89fe10255536cd60dab6

$ nix-hash --type sha1 --base32 test/
nvd61k9nalji1zl9rrdfmsmvyyjqpzg4

$ nix-hash --type sha256 --flat test/
error: reading file \(gatest/': Is a directory

$ nix-hash --type sha256 --flat test/world
5891b5b522d5df086d0ff0b110fbd9d21bb4fc7163af34d08286a2e846f6be03
.EE
.PP
Converting between hexadecimal and base-32:
.LP
.EX
$ nix-hash --type sha1 --to-base32 e4fd8ba5f7bbeaea5ace89fe10255536cd60dab6
nvd61k9nalji1zl9rrdfmsmvyyjqpzg4

$ nix-hash --type sha1 --to-base16 nvd61k9nalji1zl9rrdfmsmvyyjqpzg4
e4fd8ba5f7bbeaea5ace89fe10255536cd60dab6
.EE