]> git.hungrycats.org Git - bees/commitdiff
config: default workaround-clone-logical-ino to auto
authorZygo Blaxell <bees@furryterror.org>
Thu, 24 Sep 2026 02:22:25 +0000 (22:22 -0400)
committerZygo Blaxell <bees@furryterror.org>
Tue, 6 Oct 2026 05:51:40 +0000 (01:51 -0400)
With resolve.commit-root defaulting to yes, "auto" keeps the
clone/LOGICAL_INO serialization exactly as long as it can matter:  until
the kernel has shown it walks the commit root.  On kernels without the
COMMIT_ROOT flag, and with resolve.commit-root = no, it behaves as "yes".

Assisted-by: Claude-Code:claude-opus-5-5
docs/config-file.md
src/bees-config-v2.cc

index df37b9939704dce57e262c7da9111dd54c4cc41e..afb9832e23ee0cf484c3254f9ba001399f3b26ab 100644 (file)
@@ -721,13 +721,13 @@ The `[thread]` section sets how many worker threads bees runs and how aggressive
 * **`workaround-clone-logical-ino`**
   Whether to serialize the dedupe (clone) ioctl against the `LOGICAL_INO` ioctl to avoid a btrfs kernel bug that can be triggered when both run concurrently.
 
-  * `yes` (the default) prevents any thread from running dedupe while another thread is running `LOGICAL_INO`, and vice versa.  The two ioctls never overlap.
+  * `yes` prevents any thread from running dedupe while another thread is running `LOGICAL_INO`, and vice versa.  The two ioctls never overlap.
   * `no` removes the restriction: any thread may run either operation at any time.  This is faster under high concurrency but unsafe on kernels affected by the bug.
-  * `auto` starts like `yes`, and switches to `no` once a `LOGICAL_INO` call has successfully walked the commit root (see `resolve.commit-root`).  The bug needs `LOGICAL_INO` to walk the same trees dedupe is modifying, and commit-root walks do not.  The restriction stays in place if `resolve.commit-root = no`, or if the kernel does not support commit-root walks.
+  * `auto` (the default) starts like `yes`, and switches to `no` once a `LOGICAL_INO` call has successfully walked the commit root (see `resolve.commit-root`).  The bug needs `LOGICAL_INO` to walk the same trees dedupe is modifying, and commit-root walks do not.  The restriction stays in place if `resolve.commit-root = no`, or if the kernel does not support commit-root walks.
 
-  Leave this enabled unless you have confirmed your kernel is not affected.
+  Do not set `no` unless you have confirmed your kernel is not affected.
 
-  Default: `yes`.
+  Default: `auto`.
 
 ## [throttle] section
 
index b491ca370bd6a335348c2041099a7d5a99da4fe9..3140d1d2a5469c9fc06d8046d65e0a5621f3ffbf 100644 (file)
@@ -43,7 +43,7 @@ static const char bees_config_v2[] = R"--v2-config--(
         # on affected kernels).  auto: yes until a LOGICAL_INO call using
         # the commit root succeeds, then no; stays yes if
         # resolve.commit-root = no or the kernel lacks the flag.
-        workaround-clone-logical-ino = yes
+        workaround-clone-logical-ino = auto
 
 
 # The [resolve] section controls how bees maps physical addresses back to