path: root/src/nix-store/help.txt

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