diff options
| author | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2013-10-11 14:07:53 +0200 |
|---|---|---|
| committer | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2013-10-13 17:35:54 +0200 |
| commit | a042d9129008d0a929d2541e70b5553d9dad2588 (patch) | |
| tree | 2d0c50c613b02125c26d8c008110294c908aafa0 /nixos/doc/manual/man-nixos-rebuild.xml | |
| parent | f1a03addae88d985cbf9894377d429eab57c04bf (diff) | |
| download | nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.tar nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.tar.gz nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.tar.bz2 nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.tar.lz nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.tar.xz nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.tar.zst nixpkgs-a042d9129008d0a929d2541e70b5553d9dad2588.zip | |
nixos-rebuild: Document --profile-name
Diffstat (limited to 'nixos/doc/manual/man-nixos-rebuild.xml')
| -rw-r--r-- | nixos/doc/manual/man-nixos-rebuild.xml | 37 |
1 files changed, 36 insertions, 1 deletions
diff --git a/nixos/doc/manual/man-nixos-rebuild.xml b/nixos/doc/manual/man-nixos-rebuild.xml index e43dafd3cfe..e08153c723d 100644 --- a/nixos/doc/manual/man-nixos-rebuild.xml +++ b/nixos/doc/manual/man-nixos-rebuild.xml @@ -33,6 +33,14 @@ <arg><option>--fast</option></arg> <arg><option>--rollback</option></arg> <sbr /> + <arg> + <group choice='req'> + <arg choice='plain'><option>--profile-name</option></arg> + <arg choice='plain'><option>-p</option></arg> + </group> + <replaceable>name</replaceable> + </arg> + <sbr /> <arg><option>--show-trace</option></arg> </cmdsynopsis> </refsynopsisdiv> @@ -229,7 +237,34 @@ $ ./result/bin/run-*-vm <filename>/etc/nixos/configuration.nix</filename>, roll back to the previous configuration. (The previous configuration is defined as the one before the “current” generation of the - profile <filename>/nix/var/nix/profiles/system</filename>.)</para> + Nix profile <filename>/nix/var/nix/profiles/system</filename>.)</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--profile-name</option></term> + <term><option>-p</option></term> + <listitem> + <para>Instead of using the Nix profile + <filename>/nix/var/nix/profiles/system</filename> to keep track + of the current and previous system configurations, use + <filename>/nix/var/nix/profiles/system-profiles/<replaceable>name</replaceable></filename>. + When you use GRUB 2, for every system profile created with this + flag, NixOS will create a submenu named “NixOS - Profile + '<replaceable>name</replaceable>'” in GRUB’s boot menu, + containing the current and previous configurations of this + profile.</para> + + <para>For instance, if you want to test a configuration file + named <filename>test.nix</filename> without affecting the + default system profile, you would do: + +<screen> +$ nixos-rebuild switch -p test -I nixos-config=./test.nix +</screen> + + The new configuration will appear in the GRUB 2 submenu “NixOS - Profile + 'test'”.</para> </listitem> </varlistentry> |