]> git.hungrycats.org Git - bees/commitdiff
docs: document the ref_foreign event counter
authorZygo Blaxell <bees@furryterror.org>
Tue, 1 Sep 2026 01:55:54 +0000 (21:55 -0400)
committerZygo Blaxell <bees@furryterror.org>
Sat, 10 Oct 2026 19:00:05 +0000 (15:00 -0400)
Commit fc23c4e8ac43ec2816a6d93329dd9b84ddf22f6b
("extent-layer: stop dedupe from leaving refs that describe other extents")
added the counter without an entry in docs/event-counters.md.

Assisted-by: Claude-Code:claude-opus-5-5
docs/event-counters.md

index e6d00433d0c177ccb54519adaa233e9cb16a8604..65f005f089ebb7fb97967fd4d686df59fad06628 100644 (file)
@@ -380,6 +380,13 @@ The `readahead` event group consists of events related to data prefetching (form
  * `readahead_skip`: Number of times a duplicate read was identified in the cache and skipped.
  * `readahead_unread_ms`: Total time spent running `posix_fadvise(..., POSIX_FADV_DONTNEED)`.
 
+ref
+---
+
+The `ref` event group consists of events related to individual references in an extent node's reference list.
+
+ * `ref_foreign`: A reference's file offset now maps to a different extent than the one whose reference list contains it, typically because a dedupe redirected the range after the list was built.  The reference's geometry is left undetermined, so callers treat it as absent.
+
 refs
 ----