diff options
| author | Eelco Dolstra <edolstra@gmail.com> | 2020-12-23 21:10:32 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-12-23 21:10:32 +0100 |
| commit | a93916b1905cd7b968e92cd94a3e4a595bff2e0f (patch) | |
| tree | 178e04a23a35b9a4ede224bdcb903e75c188a304 /src/nix/profile-upgrade.md | |
| parent | 8927cba62f5afb33b01016d5c4f7f8b7d0adde3c (diff) | |
| parent | 5178211e963fa111f84c4881b22cc506d5254fde (diff) | |
Merge pull request #4336 from NixOS/manpages
Documentation for nix subcommands
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. + +)"" |