aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/federation.md36
1 files changed, 25 insertions, 11 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 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 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 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