aboutsummaryrefslogtreecommitdiff
path: root/contrib/guix/INSTALL.md
diff options
context:
space:
mode:
authorCarl Dong <contact@carldong.me>2021-07-08 12:08:46 -0400
committerCarl Dong <contact@carldong.me>2021-07-19 18:24:36 -0400
commit5da2ee49d5b44de803b671aedbdd14e5c1d71ea9 (patch)
tree8e6b335319f7cd0d214bcfc0eea0161c648b9294 /contrib/guix/INSTALL.md
parent318c60700b7bbb7ec09a29bf037e7c2787646be6 (diff)
guix/INSTALL: Add coreutils/inotify-dir-recreate troubleshooting
Diffstat (limited to 'contrib/guix/INSTALL.md')
-rw-r--r--contrib/guix/INSTALL.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/contrib/guix/INSTALL.md b/contrib/guix/INSTALL.md
index cf04dd1bf4..34fb0c8430 100644
--- a/contrib/guix/INSTALL.md
+++ b/contrib/guix/INSTALL.md
@@ -778,6 +778,26 @@ Basically:
6. Turn NTP back on
7. Turn networking back on
+### coreutils: FAIL: tests/tail-2/inotify-dir-recreate
+
+The inotify-dir-create test fails on "remote" filesystems such as overlayfs
+(Docker's default filesystem) due to the filesystem being mistakenly recognized
+as non-remote.
+
+A relatively easy workaround to this is to make sure that a somewhat traditional
+filesystem is mounted at `/tmp` (where `guix-daemon` performs its builds). For
+Docker users, this might mean [using a volume][docker/volumes], [binding
+mounting][docker/bind-mnt] from host, or (for those with enough RAM and swap)
+[mounting a tmpfs][docker/tmpfs] using the `--tmpfs` flag.
+
+Please see the following links for more details:
+
+- An upstream coreutils bug has been filed: [debbugs#47940](https://debbugs.gnu.org/cgi/bugreport.cgi?bug=47940)
+- A Guix bug detailing the underlying problem has been filed: [guix-issues#47935](https://issues.guix.gnu.org/47935)
+- A commit to skip this test in Guix has been merged into the core-updates branch:
+[savannah/guix@6ba1058](https://git.savannah.gnu.org/cgit/guix.git/commit/?id=6ba1058df0c4ce5611c2367531ae5c3cdc729ab4)
+
+
[install-script]: #options-1-and-2-using-the-official-shell-installer-script-or-binary-tarball
[install-bin-tarball]: #options-1-and-2-using-the-official-shell-installer-script-or-binary-tarball
[install-fanquake-docker]: #option-3-using-fanquakes-docker-image
@@ -786,3 +806,7 @@ Basically:
[fix-argv0]: #creating-and-starting-a-guix-daemon-original-service-with-a-fixed-argv0
[security-model]: ./README.md#choosing-your-security-model
+
+[docker/volumes]: https://docs.docker.com/storage/volumes/
+[docker/bind-mnt]: https://docs.docker.com/storage/bind-mounts/
+[docker/tmpfs]: https://docs.docker.com/storage/tmpfs/