summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2017-06-07 14:36:32 +0200
committerLudovic Courtès <ludo@gnu.org>2017-06-07 14:36:32 +0200
commitfa511e29526891743172cedbb17fa7ef75bd2d46 (patch)
treefb80ed81b3e685e1b4d3b61584ac8e5186d4b6d2
parent8a7304d60986fd1f6a98301a2ceb0b2b0ac993ce (diff)
downloadguix-fa511e29526891743172cedbb17fa7ef75bd2d46.tar.gz
doc: Use 'guix environment --no-grafts' to debug build failures.
* doc/guix.texi (Debugging Build Failures): Pass --no-grafts to 'guix
environment' and explain.
-rw-r--r--doc/guix.texi7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 13e692ff66..f69c84dea6 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -5329,7 +5329,7 @@ a container similar to the one the build daemon creates:
 $ guix build -K foo
 @dots{}
 $ cd /tmp/guix-build-foo.drv-0
-$ guix environment -C foo --ad-hoc strace gdb
+$ guix environment --no-grafts -C foo --ad-hoc strace gdb
 [env]# source ./environment-variables
 [env]# cd foo-1.2
 @end example
@@ -5337,7 +5337,10 @@ $ guix environment -C foo --ad-hoc strace gdb
 Here, @command{guix environment -C} creates a container and spawns a new
 shell in it (@pxref{Invoking guix environment}).  The @command{--ad-hoc
 strace gdb} part adds the @command{strace} and @command{gdb} commands to
-the container, which would may find handy while debugging.
+the container, which would may find handy while debugging.  The
+@option{--no-grafts} option makes sure we get the exact same
+environment, with ungrafted packages (@pxref{Security Updates}, for more
+info on grafts).
 
 To get closer to a container like that used by the build daemon, we can
 remove @file{/bin/sh}: