diff options
| author | tv <tv@krebsco.de> | 2026-11-16 19:54:35 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-16 21:26:18 +0100 |
| commit | c9707297bd393f69461c781a38a5ddb017dced60 (patch) | |
| tree | bd4bf940103b7f6bc583ef13ba27c9b4eec76c7a /src/config | |
| parent | 3ee3816076d07b0e9b2c56cc7ea6e50951745027 (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 'src/config')
| -rw-r--r-- | src/config/mod.rs | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/src/config/mod.rs b/src/config/mod.rs index ae6070f..afd9c4e 100644 --- a/src/config/mod.rs +++ b/src/config/mod.rs @@ -216,6 +216,14 @@ pub(crate) const OPTIONS: &[OptionSpec] = &[ None, "Join a swarm holding a store (docs/store.md) through seeds, by its ID: its root's SHA-256, in hex. Joining with an empty document, the node takes as its root only that store's genesis change, built again from the root it holds. Can't be combined with store-root, genesis, or what makes a new swarm's first change.", ), + #[cfg(feature = "federation")] + option( + "store-file", + Kind::Text, + "PATH", + None, + "With store-root or store-id: where the node keeps what is its own of its store across restarts, written whenever it changes: the events it refused by what it took before (of two versions changing one, the second), and those its operator had it drop. It reads its store anew from its document whenever it starts: without the file, it may then take what it refused. A file that doesn't read stops the node from starting.", + ), option( "strict-keys", Kind::List, @@ -651,6 +659,8 @@ pub(crate) struct Settings { pub(crate) store_root: Option<PathBuf>, #[cfg(feature = "federation")] pub(crate) store_id: Option<String>, + #[cfg(feature = "federation")] + pub(crate) store_file: Option<PathBuf>, #[serde(default)] pub(crate) strict_keys: Vec<String>, @@ -1116,6 +1126,11 @@ impl Settings { } (Some(_), None) => "store-root", (None, Some(_)) => "store-id", + (None, None) if self.store_file.is_some() => { + bail!( + "store-file keeps what is the node's own of a store: set store-root or store-id" + ) + } (None, None) => return Ok(()), }; let first_change = [ @@ -1169,6 +1184,8 @@ impl Settings { ("store-root", self.store_root.is_some()), #[cfg(feature = "federation")] ("store-id", self.store_id.is_some()), + #[cfg(feature = "federation")] + ("store-file", self.store_file.is_some()), ("alias", self.alias.is_some()), ("dashboard-url", self.dashboard_url.is_some()), ("debug-api", self.debug_api), |
