From 3d6197103820e38864e721b8850d502bacdb2dac Mon Sep 17 00:00:00 2001 From: tv Date: Tue, 17 Nov 2026 12:19:59 +0000 Subject: federation.md: kartei's files, identifiers and rules on a federated swarm The registry holds each kartei namespace in its party's, a place per file. What kartei's consumers read as one for all (host and user names, the names hosts go by, addresses and blocks in every net but `internet`) is shared, at places of its own, given by krebs's rules: a party's by its name, and what kartei gives it beyond them by a rule each in the first version. What kartei's consumers read is written out from what counts, but for what names an identifier the current version doesn't give its party. --- docs/federation.md | 38 ++++++++++++++++++++++++++------------ 1 file changed, 26 insertions(+), 12 deletions(-) diff --git a/docs/federation.md b/docs/federation.md index 72bcca1..1c59995 100644 --- a/docs/federation.md +++ b/docs/federation.md @@ -788,19 +788,33 @@ the federation, or a version, its swarm has stops taking events and says so. ## The registry on it -The krebs registry today: users, their hosts, the hosts' names, addresses and keys. On a -federated swarm: - -* the krebs users who will vote are its parties, each its hosts in its namespace - (`home/tv/hosts/laptop`: its keys, its addresses as it uses them). The others are in a - party that is a group, which holds its keys as it likes, their hosts in its namespace, - until a version makes one a party of its own. Every decision takes two thirds of all - parties, quiet ones counted, so the first version names only those that will vote; -* a party's names `names/r/tv` and those under it by a rule each, and so for `names/w`; - its address blocks by a rule each; other names given by versions; +The krebs registry today: users, their hosts, the hosts' names, addresses and keys, as +kartei's files, a directory each user (its namespace), a value each file, which kartei's +consumers read as one registry. On a federated swarm: + +* the krebs users who will vote are its parties, each its kartei namespace in its own, a + place each file, the file's text its value (`home/tv/hosts/laptop/retiolum/ip6`). The + others are in a party that is a group, which holds its keys as it likes, their + namespaces in its own, until a version makes one a party of its own. Every decision + takes two thirds of all parties, quiet ones counted, so the first version names only + those that will vote; +* what kartei's consumers read as one for all is shared, each at its place: a host's + name at its name in `.r` (`names/r/laptop`), and in `.i` too where the host is in the + net `internet`; a user's at `users/tv`; a name a host goes by at its labels + (`names/r/tv/cgit` for `cgit.tv.r`); in each net but `internet`, an address or a block + routed to a host by its parts (`ip4/10/243/7/3`, `ip6/42/1/a46e` for + `42:1:a46e::/48`), a block only on the bounds of its parts, wherever its files name + one, a `Subnet` set in `tinc.extra` too; +* krebs's rules: a party's namespace, its names `names/r/tv` and those under it, and so + for `names/w`, and its user `users/tv`, by a rule each; what kartei gives a party + beyond them by a rule each in the first version, made from kartei, and later by + versions; * kartei's entries signed in by their parties after the root, never as anything before - it; -* a tool reads what counts and writes what kartei's consumers read today. + it, and again as they change; +* what kartei's consumers read written out from what counts: every namespace as its + files, but for a host, a user or a net in `internet` whose name the current version + doesn't give its party, and each line of a name, an address or a block that it + doesn't. So a name a version gives another party is that party's in kartei too. ## Stages -- cgit v1.3.1