diff options
| author | tv <tv@krebsco.de> | 2026-11-19 03:54:54 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-19 05:12:07 +0100 |
| commit | 5611555bd31e5b05bcee6c6e4450adeffd2e820b (patch) | |
| tree | 5169171f4f67e3893c96dbddeff13c2711af2332 /docs/guides | |
| parent | 6c6f978189eafa15add0df865f713dc946dfc5cb (diff) | |
held: a node merges its store's heads beyond what an event may name
Past 64 heads, no event is above them all, and what is written builds on the earliest
64 alone: where nobody writes, heads apart stay apart, and a checkpoint naming them is
never written.
Under a revision with merge events, a node its party lists signs merge events with its
node key where its store holds more heads than an event may name, each on as many as it
may, the earliest taken first, until no more are left (`Holding::merge`). The worker does
so a random wait after the heads first were too many, as it puts again what the document
lacks, so that of the members few do at once.
`federation.md` says so under Nodes, and the guides say what a node writes by itself and
what its log says.
Diffstat (limited to 'docs/guides')
| -rw-r--r-- | docs/guides/federation/running-a-node.md | 4 | ||||
| -rw-r--r-- | docs/guides/federation/watching.md | 5 |
2 files changed, 7 insertions, 2 deletions
diff --git a/docs/guides/federation/running-a-node.md b/docs/guides/federation/running-a-node.md index 6444bbd..94781d4 100644 --- a/docs/guides/federation/running-a-node.md +++ b/docs/guides/federation/running-a-node.md @@ -109,6 +109,10 @@ it takes the checkpoint only where its operator pins it. Pin it, and restart the * **Events its document lacks**, that its store would take and that it has: after a remake, a rejoin, or a change of another node it refused (`Put again events the document lacked`). +* **Merge events**, under a revision with them, where its party lists it and its store + holds more heads than an event may name (64): signed with its node key, a random wait + after there first were (`Merged heads beyond what an event may name`). They count for + nothing, and gather the heads apart, so that what is written after builds on them all. * **Its own protocol data**: its entry, its acks of remakes, and the remakes it coordinates. Remakes are compactions only, acked by the members ([`remakes.md`](../../remakes.md)). diff --git a/docs/guides/federation/watching.md b/docs/guides/federation/watching.md index a54dd7f..da4a93f 100644 --- a/docs/guides/federation/watching.md +++ b/docs/guides/federation/watching.md @@ -55,9 +55,10 @@ At warn or error: read-only disk; * `Couldn't vote by itself`, `Voting by itself, without its party's record: votes none`; * `Couldn't put what it signed for its party: put again later`, `Couldn't write a version - that passed: put again later`, `Couldn't put again events the document lacks`; + that passed: put again later`, `Couldn't put again events the document lacks`, + `Couldn't put a merge event: put again later`; * `Dropped events, as this node's operator says`: whoever may use the node's API did it. At info, worth knowing: `The store's members, as it reads now`, `Writing a version that passed`, `Voting for its party`, `Proposing a checkpoint for its party`, `This node is a -member of its store`. +member of its store`, `Merged heads beyond what an event may name`. |
