From cbc538fe69577068d5676428c77287d82123a704 Mon Sep 17 00:00:00 2001 From: Ludovic Courtès Date: Sat, 7 Feb 2015 18:32:04 +0100 Subject: doc: Document the location of the build directory. Fixes . Reported by Andrei Osipov . * doc/guix.texi (Invoking guix-daemon): Document the build directory location. --- doc/guix.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 3930b96836..510acddb46 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -557,6 +557,19 @@ system directories. By default, the latter contains @file{/dev} and a separate mount name space, its own PID name space, network name space, etc. This helps achieve reproducible builds (@pxref{Features}). +When the daemon performs a build on behalf of the user, it creates a +build directory under @file{/tmp} or under the directory specified by +its @code{TMPDIR} environment variable; this directory is shared with +the container for the duration of the build. Be aware that using a +directory other than @file{/tmp} can affect build results---for example, +with a longer directory name, a build process that uses Unix-domain +sockets might hit the name length limitation for @code{sun_path}, which +it would otherwise not hit. + +The build directory is automatically deleted upon completion, unless the +build failed and the client specified @option{--keep-failed} +(@pxref{Invoking guix build, @option{--keep-failed}}). + The following command-line options are supported: @table @code -- cgit v1.2.3