about summary refs log tree commit diff
path: root/doc/builders
diff options
context:
space:
mode:
authorRobert Hensing <robert@roberthensing.nl>2021-12-04 13:17:56 +0000
committerRobert Hensing <robert@roberthensing.nl>2021-12-04 13:49:10 +0000
commitddda5f28e1f85e0f056996dbf2d2d7fa3718da0f (patch)
tree159db948259734c30a3be40bb6078930c13c15f6 /doc/builders
parent0e9bc9ffd107c288571af4e3d4a9c2a6b64cf505 (diff)
dockerTools: Keep fakechroot disabled by default
Avoid risk of breaking existing images by making it opt-in.
Diffstat (limited to 'doc/builders')
-rw-r--r--doc/builders/images/dockertools.section.md6
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/builders/images/dockertools.section.md b/doc/builders/images/dockertools.section.md
index af09f25222344..7ff4b2aeb3690 100644
--- a/doc/builders/images/dockertools.section.md
+++ b/doc/builders/images/dockertools.section.md
@@ -149,13 +149,13 @@ Create a Docker image with many of the store paths being on their own layer to i
 
 `fakeRootCommands` _optional_
 
-: Shell commands to run while creating the archive for the final layer in a fakeroot + fakechroot environment. Unlike `extraCommands`, you can run `chown` to change the owners of the files in the archive, changing fakeroot's state instead of the real filesystem. The latter would require privileges that the build user does not have. Static binaries do not interact with the fakeroot environment. By default all files in the archive will be owned by root.
+: Shell commands to run while creating the archive for the final layer in a fakeroot environment. Unlike `extraCommands`, you can run `chown` to change the owners of the files in the archive, changing fakeroot's state instead of the real filesystem. The latter would require privileges that the build user does not have. Static binaries do not interact with the fakeroot environment. By default all files in the archive will be owned by root.
 
 `enableFakechroot` _optional_
 
-: Whether to run in `fakeRootCommands` in `fakechroot`, making programs behave as though `/` is the root of the image being created, while files in the Nix store are available as usual. This allows most scripts that perform installation in `/` to work as expected. Considering that `fakechroot` is implemented via the same mechanism as `fakeroot`, it is not guaranteed to work and will not work for static binaries.
+: Whether to run in `fakeRootCommands` in `fakechroot`, making programs behave as though `/` is the root of the image being created, while files in the Nix store are available as usual. This allows scripts that perform installation in `/` to work as expected. Considering that `fakechroot` is implemented via the same mechanism as `fakeroot`, the same caveats apply.
 
-    *Default:* `true` when built on Linux, `false` otherwise
+    *Default:* `false`
 
 ### Behavior of `contents` in the final image {#dockerTools-buildLayeredImage-arg-contents}