about summary refs log tree commit diff
path: root/src/nix-store/help.txt
blob: ed4a29a67e17687849587c29270f25f448b1495a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Usage: nix-store [OPTIONS...] [ARGUMENTS...]

`nix-store' is a tool to manipulate the Nix store.

Operations:

  --realise / -r: ensure path validity; if a derivation, ensure the
      validity of the outputs
  --add / -A: copy a path to the Nix store
  --delete: safely delete paths from the Nix store
  --query / -q: query information
  --read-log / -l: print build log of given store paths

  --register-validity: register path validity (dangerous!)
  --check-validity: check path validity

  --gc: run the garbage collector

  --dump: dump a path as a Nix archive (NAR), forgetting dependencies
  --restore: restore a path from a Nix archive, without
      registering validity

  --export: export a path as a Nix archive, marking dependencies
  --import: import a path from a Nix archive, and register as 
      valid

  --verify: verify Nix structures
  --verify-path: verify whether the given store paths haven't been modified
  --optimise: optimise the Nix store by hard-linking identical files

  --query-failed-paths: list paths that failed to build (if enabled)
  --clear-failed-paths: clear the failed status of the given paths

  --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 the path
  --references: print all paths referenced by the path
  --referrers: print all paths directly refering to the path
  --referrers-closure: print all paths (in)directly refering to the path
  --tree: print a tree showing the dependency graph of the path
  --graph: print a dot graph rooted at given path
  --xml: emit an XML representation of the graph rooted at the given path
  --hash: print the SHA-256 hash of the contents of the path
  --size: print the size of the NAR dump of the path
  --roots: print the garbage collector roots that point to the path

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

Garbage collector options:

  --print-roots: print GC roots and exit
  --print-live: print live paths and exit
  --print-dead: print dead paths and exit
  --delete: delete dead paths (default)
    
Options:

  --verbose / -v: verbose operation (may be repeated)
  --keep-failed / -K: keep temporary directories of failed builds
  --keep-going / -k: build as many dependencies as possible, even if
      some dependencies fail to build

  --add-root: add garbage collector roots for the result