aboutsummaryrefslogtreecommitdiffstats
path: root/src/config/mod.rs
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 /src/config/mod.rs
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 'src/config/mod.rs')
-rw-r--r--src/config/mod.rs17
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),