about summary refs log tree commit diff
path: root/nix.conf.example
diff options
context:
space:
mode:
authorEelco Dolstra <e.dolstra@tudelft.nl>2007-10-27T16·06+0000
committerEelco Dolstra <e.dolstra@tudelft.nl>2007-10-27T16·06+0000
commitdc6f373842ae65d6c407d8169089367d9c0d4e1a (patch)
treeddcb062622d753171a0cc2a4e8f0c40be4957a1a /nix.conf.example
parent9397cd30c8a6ffd65fc3b85985ea59ecfb72672b (diff)
* Delete the chroot directory automatically.
* Removed some debug messages.

Diffstat (limited to 'nix.conf.example')
-rw-r--r--nix.conf.example38
1 files changed, 38 insertions, 0 deletions
diff --git a/nix.conf.example b/nix.conf.example
index be6a955a8d5f..99a94bfb9173 100644
--- a/nix.conf.example
+++ b/nix.conf.example
@@ -135,6 +135,44 @@
 #build-users-group =
 
 
+### Option `build-use-chroot'
+#
+# If set to `true', builds will be performed in a chroot environment,
+# i.e., the build will be isolated from the normal file system
+# hierarchy and will only see the Nix store, the temporary build
+# directory, and the directories configured with the
+# `build-chroot-dirs' option (such as /proc and /dev).  This is useful
+# to prevent undeclared dependencies on files in directories such as
+# /usr/bin.
+#
+# The use of a chroot requires that Nix is run as root (but you can
+# still use the "build users" feature to perform builds under
+# different users than root).  Currently, chroot builds only work on
+# Linux because Nix uses "bind mounts" to make the Nix store and other
+# directories available inside the chroot.
+#
+# The default is `false'.
+#
+# Example:
+#   build-use-chroot = true
+#build-use-chroot = false
+
+
+### Option `build-chroot-dirs'
+#
+# When builds are performed in a chroot environment, Nix will mount
+# (using `mount --bind' on Linux) some directories from the normal
+# file system hierarchy inside the chroot.  These are the Nix store,
+# the temporary build directory (usually /tmp/nix-<pid>-<number>) and
+# the directories listed here.  The default is "/dev /proc".  Files
+# in /dev (such as /dev/null) are needed by many builds, and some
+# files in /proc may also be needed occasionally.
+#
+# Example:
+#   build-use-chroot = /dev /proc /bin
+#build-chroot-dirs = /dev /proc
+
+
 ### Option `system'
 #
 # This option specifies the canonical Nix system name of the current