diff options
| author | Eelco Dolstra <edolstra@gmail.com> | 2020-12-18 14:25:36 +0100 |
|---|---|---|
| committer | Eelco Dolstra <edolstra@gmail.com> | 2020-12-21 13:32:29 +0100 |
| commit | 16e34085e8f45758b97c41cfcd720552c68a3c98 (patch) | |
| tree | c846ed429234e09dc467688b0a24a4a1191e51ee /src/nix/profile-upgrade.md | |
| parent | 0c09f63de84e15c15e8621a53d6d25f023b4ad06 (diff) | |
Add 'nix profile' manpage
Diffstat (limited to 'src/nix/profile-upgrade.md')
| -rw-r--r-- | src/nix/profile-upgrade.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/src/nix/profile-upgrade.md b/src/nix/profile-upgrade.md new file mode 100644 index 000000000..2bd5d256d --- /dev/null +++ b/src/nix/profile-upgrade.md @@ -0,0 +1,41 @@ +R""( + +# Examples + +* Upgrade all packages that were installed using a mutable flake + reference: + + ```console + # nix profile upgrade '.*' + ``` + +* Upgrade a specific package: + + ```console + # nix profile upgrade packages.x86_64-linux.hello + ``` + +* Upgrade a specific profile element by number: + + ```console + # nix profile info + 0 flake:nixpkgs#legacyPackages.x86_64-linux.spotify … + + # nix profile upgrade 0 + ``` + +# Description + +This command upgrades a previously installed package in a Nix profile, +by fetching and evaluating the latest version of the flake from which +the package was installed. + +> **Warning** +> +> This only works if you used a *mutable* flake reference at +> installation time, e.g. `nixpkgs#hello`. It does not work if you +> used an *immutable* flake reference +> (e.g. `github:NixOS/nixpkgs/13d0c311e3ae923a00f734b43fd1d35b47d8943a#hello`), +> since in that case the "latest version" is always the same. + +)"" |