forked from lix-project/lix
dcc37c236c
immediately add the result as a permanent GC root. This is the only
way to prevent a race with the garbage collector. For instance, the
old style
ln -s $(nix-store -r $(nix-instantiate foo.nix)) \
/nix/var/nix/gcroots/result
has two time windows in which the garbage collector can interfere
(by GC'ing the derivation and the output, respectively). On the
other hand,
nix-store --add-root /nix/var/nix/gcroots/result -r \
$(nix-instantiate --add-root /nix/var/nix/gcroots/drv \
foo.nix)
is safe.
* nix-build: use `--add-root' to prevent GC races.
46 lines
1.5 KiB
Text
46 lines
1.5 KiB
Text
nix-store [OPTIONS...] [ARGUMENTS...]
|
|
|
|
`nix-store' is a tool to manipulate the Nix store.
|
|
|
|
Operations:
|
|
|
|
--realise / -r: ensure path validity; if a derivation, ensure that
|
|
validity of the outputs
|
|
--add / -A: copy a path to the Nix store
|
|
--query / -q: query information
|
|
|
|
--substitute: register a substitute expression (dangerous!)
|
|
--clear-substitutes: clear all substitutes
|
|
--validpath: register path validity (dangerous!)
|
|
--isvalid: check path validity
|
|
|
|
--dump: dump a path as a Nix archive
|
|
--restore: restore a path from a Nix archive
|
|
|
|
--init: initialise the Nix database
|
|
--verify: verify Nix structures
|
|
|
|
--version: output version information
|
|
--help: display help
|
|
|
|
Query flags:
|
|
|
|
--outputs: query the output paths of a Nix derivation (default)
|
|
--requisites / -R: print all paths necessary to realise a path
|
|
--references: print all paths referenced by the given path
|
|
--referers: print all paths directly refering to the given path
|
|
--referers-closure: print all paths (in)directly refering to the given path
|
|
--graph: print a dot graph rooted at given ids
|
|
|
|
Query switches (not applicable to all queries):
|
|
|
|
--use-output: perform query on output of derivation, not derivation itself
|
|
--force-realise: realise the path before performing the query
|
|
--include-outputs: in `-R' on a derivation, include requisites of outputs
|
|
|
|
Options:
|
|
|
|
--verbose / -v: verbose operation (may be repeated)
|
|
--keep-failed / -K: keep temporary directories of failed builds
|
|
|
|
--add-root: add garbage collector roots for the result
|