-# Bees Configuration File Reference
+# bees Configuration File Reference
This page describes the bees configuration options. For the location
and syntax of configuration, see [bees configuration format
* The path must be relative to the filesystem root; symlinks are not followed.
* The default `"."` is implemented by opening the target filesystem root
directly and works on any kernel version.
- * Any other value requires `openat2(2)` (Linux 5.6+). Bees will exit at
+ * Any other value requires `openat2(2)` (Linux 5.6+). bees will exit at
startup if `openat2` is unavailable rather than fall back to `openat(2)`,
which cannot enforce `RESOLVE_BENEATH` or `RESOLVE_NO_SYMLINKS`.
* Because `O_TMPFILE` inodes are anonymous, `dir` does not need to be listed
* `7` – Extent-level dedupe operations (filenames, offsets, and lengths), progress updates, statistics, minor errors.
* `8` – Full debugging information.
Default: `8` (full debug).
- **Note**: Bees currently does not produce any log messages at level 3 or lower.
+ **Note**: bees currently does not produce any log messages at level 3 or lower.
* **`timestamps`** *(legacy `--timestamps` / `--no-timestamps`)*
Whether to include timestamps in log entries.
if every active report uses an absolute filename; an active report with a
relative filename and an empty `paths.reports` is a startup error.
* Substitution variables `${UUID}`, `${LABEL}`, and `${BASENAME}` are expanded.
- * Bees creates this directory if an active report with a relative filename
+ * This directory is created if an active report with a relative filename
needs it. Only the final path component is created (a plain `mkdir()`,
not `mkdir -p`); the parent must already exist. This is deliberately
a single level: it lets a system that has `/run` gain `/run/bees`