doc: Document the dummy $HOME in the build chroot.

This missing documentation reported by Matt <matt@excalamus.com>.

* doc/guix.texi (Build Environment Setup): Document '/homeless-shelter'.
This commit is contained in:
Leo Famulari 2022-01-16 13:14:02 -05:00
parent 8cdecad237
commit 72f3334308
No known key found for this signature in database
GPG key ID: 2646FA30BACA7F08

View file

@ -1178,6 +1178,11 @@ user @file{nobody};
a writable @file{/tmp} directory.
@end itemize
The chroot does contain a @file{/home} directory, and the @env{HOME}
environment variable is set to the non-existent
@file{/homeless-shelter}. This helps to highlight inappropriate uses of
@env{HOME} in the build scripts of packages.
You can influence the directory where the daemon stores build trees
@i{via} the @env{TMPDIR} environment variable. However, the build tree
within the chroot is always called @file{/tmp/guix-build-@var{name}.drv-0},