about summary refs log tree commit diff
path: root/src/nix-env/help.txt
blob: 4fc1602840c4bc40bf557468b091122a84a47139 (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
nix-env [OPTIONS...] [ARGUMENTS...]

`nix-env' is a tool to manipulate Nix user environments.

Operations:

  --install / -i: add derivations to the user environment
  --upgrade / -u: upgrade derivation in the user environment
  --uninstall / -e: remove derivations from the user environment
  --query / -q: perform a query on an environment or Nix expression

The previous operations take a list of derivation names.  The special
name `*' may be used to indicate all derivations.

  --switch-profile / -S [FILE]: switch to specified profile
  --switch-generation / -G NUMBER: switch to specified generation of profile
  --rollback: switch to the previous generation
  --list-generations: list available generations of a profile
  --delete-generations GENERATIONS...: deleted listed generations,
      `old' for all non-current generations
  
  --import / -I FILE: set default Nix expression

  --version: output version information
  --help: display help

Install / upgrade / uninstall flags:

  --dry-run: show what would be done, but don't do it

Upgrade flags:

  --lt: upgrade unless the current version is older (default)
  --leq: upgrade unless the current version is older or current
  --always: upgrade regardless of current version

Query types:

  --name: print derivation names (default)
  --drv-path: print path of derivation
  --out-path: print path of derivation output
  --status / -s: print installed/present status

Query sources:

  --installed: use installed derivations (default)
  --available / -a: use derivations available in Nix expression

Options:

  --profile / -p LINK: use specified profile instead of target of ~/.nix-profile
  --file / -f FILE: use Nix expression FILE for installation, etc.
  --verbose / -v: verbose operation (may be repeated)
  --keep-failed / -K: keep temporary directories of failed builds
  --preserve-installed: do not replace currently installed versions in `-i'
  --system-filter SYSTEM: only use derivations for specified platform