From b40df7e83263cad58e6c7c6ef417ecbfc37541d9 Mon Sep 17 00:00:00 2001 From: Scott Worley Date: Fri, 20 May 2022 14:47:01 -0700 Subject: [PATCH] README: Explain what this is for --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..53067f5 --- /dev/null +++ b/README.md @@ -0,0 +1,16 @@ +nix-pin-deps: GC-anchor a Nix build's dependencies +-------------------------------------------------- + +When a Nix build fails for lack of disk space and a `nix-collect-garbage` +is needed to make disk space available, `nix-collect-garbage` will +unhelpfully delete the successfully-built dependencies of the derivation +that failed because they are are not yet gc-anchored, because the +build failed. + +This tool solves this problem: + + `nix-pin-deps /nix/store/...-foo.drv foo-deps` + +will create gc-anchors in foo-deps/ for all of the dependencies of foo.drv +that exist in the nix store, keeping partial build progress safe from +`nix-collect-garbage`. -- 2.44.1