summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorChris Marusich <cmmarusich@gmail.com>2016-12-02 01:52:04 -0800
committerLudovic Courtès <ludo@gnu.org>2016-12-05 23:19:37 +0100
commit067a2e2de9e5f8437ce020c62f64e08b82af72b8 (patch)
tree216dd46d9f104fe8ca310d19987f8cb8ef9dec16 /doc
parent4bd391f557a66660525805e9ea56d506f8eaed68 (diff)
guix system: If the new system generation already exists, overwrite it.
Fixes <http://bugs.gnu.org/25100>. Before that, 'guix system reconfigure' would fail if the next generation already existed. * guix/scripts/system.scm (switch-to-system): Use 'switch-symlink' instead of 'symlink'. * doc/guix.texi (Using the Configuration System, Invoking guix system): Document the behavior. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi16
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 4d7f96d907..5c94a56c01 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -7174,7 +7174,15 @@ modifying or deleting previous generations. Old system generations get
an entry in the GRUB boot menu, allowing you to boot them in case
something went wrong with the latest generation. Reassuring, no? The
@command{guix system list-generations} command lists the system
-generations available on disk.
+generations available on disk. It is also possible to roll back the
+system via the commands @command{guix system roll-back} and
+@command{guix system switch-generation}.
+
+Although the command @command{guix system reconfigure} will not modify
+previous generations, must take care when the current generation is not
+the latest (e.g., after invoking @command{guix system roll-back}), since
+the operation might overwrite a later generation (@pxref{Invoking guix
+system}).
@unnumberedsubsubsec The Programming Interface
@@ -12599,6 +12607,12 @@ currently running; if a service is currently running, it does not
attempt to upgrade it since this would not be possible without stopping it
first.
+This command creates a new generation whose number is one greater than
+the current generation (as reported by @command{guix system
+list-generations}). If that generation already exists, it will be
+overwritten. This behavior mirrors that of @command{guix package}
+(@pxref{Invoking guix package}).
+
It also adds a GRUB menu entry for the new OS configuration, and moves
entries for older configurations to a submenu---unless
@option{--no-grub} is passed.