aboutsummaryrefslogtreecommitdiffstats
path: root/docs/glossary.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-09 15:41:16 +0000
committertv <tv@krebsco.de>2026-11-09 18:21:47 +0100
commit4340c685ebaa28192b12be8a4c4c193a78fa1368 (patch)
treed352ab6da17e8035dc53beb1d5402b122207a985 /docs/glossary.md
parentf9dff2df9efca585616e650ff9f37fb0203845e4 (diff)
docs: how long a broken path takes to see, with PINGs taking turns
Review 4, 1258's note: the glossary says that a path whose way out broke while the peer's PINGs still come is found by this node's own unanswered PINGs, which with the turns come every one to two intervals, up to twice as long as before, and what still finds it at once.
Diffstat (limited to 'docs/glossary.md')
-rw-r--r--docs/glossary.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/docs/glossary.md b/docs/glossary.md
index e8ccdee..fd165f1 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -95,7 +95,11 @@ STATUS_REPLY instead, carrying the sender's heads (or a digest of them and some
them), epoch and readiness. The two sides of a pair take turns; the one that **leads**
the pair sends the first. The paths layer's PINGs of a path take turns with the peer's
too, so each side measures a path's round trip every other interval: a shorter
-`--keepalive` measures more often.
+`--keepalive` measures more often. A path whose way out broke while the peer's PINGs
+still come is found by this node's own unanswered PINGs, three in a row, which then
+come every one to two intervals: up to twice as long as without the turns. Unanswered
+traffic or a failed send pings at once, and the peer finds it by its own missing
+PONGs.
**initial sync**: a joining node's first complete sync. It's **caught up** once a ready
peer with non-empty heads has nothing left that it lacks.