nix-prefetch-url1Nixnix-prefetch-urlcopy a file from a URL into the store and print its hashnix-prefetch-urlhashAlgourlhashDescriptionThe command nix-prefetch-url downloads the
file referenced by the URL url, prints its
cryptographic hash, and copies it into the Nix store. The file name
in the store is
hash-baseName,
where baseName is everything following the
final slash in url.This command is just a convenience for Nix expression writers.
Often a Nix expression fetches some source distribution from the
network using the fetchurl expression contained in
Nixpkgs. However, fetchurl requires a
cryptographic hash. If you don't know the hash, you would have to
download the file first, and then fetchurl would
download it again when you build your Nix expression. Since
fetchurl uses the same name for the downloaded file
as nix-prefetch-url, the redundant download can be
avoided.If hash is specified, then a download
is not performed if the Nix store already contains a file with the
same hash and base name. Otherwise, the file is downloaded, and an
error if signaled if the actual hash of the file does not match the
specified hash.This command prints the hash on standard output. Additionally,
if the environment variable PRINT_PATH is set, the path
of the downloaded file in the Nix store is also printed.OptionshashAlgoUse the specified cryptographic hash algorithm,
which can be one of md5,
sha1, and
sha256.Examples
$ nix-prefetch-url ftp://ftp.nluug.nl/pub/gnu/make/make-3.80.tar.bz2
0bbd1df101bc0294d440471e50feca71
$ PRINT_PATH=1 nix-prefetch-url ftp://ftp.nluug.nl/pub/gnu/make/make-3.80.tar.bz2
0bbd1df101bc0294d440471e50feca71
/nix/store/wvyz8ifdn7wyz1p3pqyn0ra45ka2l492-make-3.80.tar.bz2