diff options
Diffstat (limited to 'docs/peers.md')
| -rw-r--r-- | docs/peers.md | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/docs/peers.md b/docs/peers.md index f5b6ab6..e71d726 100644 --- a/docs/peers.md +++ b/docs/peers.md @@ -13,18 +13,19 @@ says where it is (`mycelium:<public key>`). The identity layer (`transport::iden between the node and its transports keeps the two apart, so everything below speaks of node IDs. A node may have several transports, and reaches a peer on one both have (module `transport::paths`). With several, it measures them: every 30 s (or every -keepalive interval, if that is longer) each gets a PING (the keepalive's, or one of its own), answered by a PONG over the same path, which -gives its round-trip time. A peer's only path is measured the same way once messages -go over it (a busy pair sends no keepalives). The -configured order decides until both are measured; then the node changes to another -path when it is a quarter faster (and at least 5 ms), so it doesn't flap. A send that -fails goes to the next path at once, and a path whose sends fail, or whose PINGs go -unanswered three times in a row, is down: used only when no other works. A path that +keepalive interval, if that is longer) each gets a PING (the keepalive's, or one of its +own), answered by a PONG over the same path, which gives its round-trip time. A peer's +only path is measured the same way once messages go over it (a busy pair sends no +keepalives). The configured order decides until both are measured; then the node changes +to another path when it is a quarter faster (and at least 5 ms), so it doesn't flap. A +send that fails goes to the next path at once, and a path whose sends fail, or whose PINGs +go unanswered three times in a row, is down: used only when no other works. A path that takes messages and drops them shows sooner: when what went to the peer goes unanswered -(the PING that asks again, below, or an overdue sync answer), its other paths come -first until that one answers a PING again, and all of them are pinged at once. A node on -several transports bridges nodes that share none ([`transports.md`](transports.md), Several transports): -the topology links it on each of its transports (below). +(the PING that asks again, below, or an overdue sync answer), its other paths come first +until that one answers a PING again, and all of them are pinged at once. A node on several +transports bridges nodes that share none ([`transports.md`](transports.md), +[Several transports](transports.md#several-transports)): the topology links it on each of +its transports (below). ```mermaid sequenceDiagram |
