aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-16 19:54:35 +0000
committertv <tv@krebsco.de>2026-11-16 21:26:18 +0100
commitc9707297bd393f69461c781a38a5ddb017dced60 (patch)
treebd4bf940103b7f6bc583ef13ba27c9b4eec76c7a /docs/openapi.yaml
parent3ee3816076d07b0e9b2c56cc7ea6e50951745027 (diff)
federation: the store read from the document
A node of a swarm holding a store holds the store, read from its document (`docs/store.md`, What the store takes from the document): `federation::held`. Whenever the document changes, a worker reads the events it holds that the store wasn't offered from it, under the document's lock, and offers them to the store without it, each taken as from anywhere: once its dependencies are held, judged at its history. Another document (a drop, a rejoin) is read as it comes, the store going on. The node reads its store anew from its document whenever it starts, from the root, by what is its own of it: the events it refused by what it took before, and those its operator had it drop, which it keeps in a file (`--store-file`), written whenever that changes, so that a store read anew in another order refuses what it refused before. A file that doesn't read stops the node from starting; without one, a restart may take what it refused.
Diffstat (limited to 'docs/openapi.yaml')
-rw-r--r--docs/openapi.yaml4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index bfb5ba3..0f1af33 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -2802,8 +2802,8 @@ components:
description: |
This node's own files, by kind (`state`: the state file, `document`: the
document file, `backup`: a backup recovered from, `remake`: the input of a
- genesis remake, and behind the `federation` feature `store`: a store's root),
- since it started.
+ genesis remake, and behind the `federation` feature `store`: a store's root,
+ and what the node keeps of its own of its store), since it started.
additionalProperties:
type: object
required: [reads, readBytes, writes, writtenBytes, appends, appendedBytes, errors]