* **`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
# 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