GameCult/Idunn
Watch
9
0
Fork
You've already forked Idunn
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Docs: member connection limit and the cached presence answer

Browse source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
Meta Vens 2026-10-23 04:34:28 +02:00
commit 2ea0572a4c
2 changed files with 7 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

1
README.md
View file

@ -194,6 +194,7 @@ private_port_end = 18839
[route.member] [route.member]
stable_endpoint = "tcp://10.77.0.1:8448" stable_endpoint = "tcp://10.77.0.1:8448"
private_port_start = 18841 private_port_start = 18841
# max_connections = 128 # nginx limit_conn on the member listener (1-65535)
``` ```
## Contracts ## Contracts

8
docs/authority-map.md
View file

@ -90,10 +90,14 @@ activation key.
back. back.
- **Route:** Idunn owns both listeners of the route: the Expected route's - **Route:** Idunn owns both listeners of the route: the Expected route's
stable endpoint (presence) and, when the binding has `[route.member]`, the stable endpoint (presence) and, when the binding has `[route.member]`, the
member endpoint, rendered as a second server block in the one nginx fragment. member endpoint, rendered as a second server block in the one nginx fragment
with a `limit_conn` on one per-route zone (`max_connections`, default 128), so
members cannot exhaust the connections the presence block shares with them.
The launcher binds the candidate endpoint and answers Idunn's challenge there, The launcher binds the candidate endpoint and answers Idunn's challenge there,
one connection at a time within a one-second deadline; any other first byte one connection at a time within a one-second deadline; any other first byte
closes the connection. The child binds the member bind Idunn sets in closes the connection. The answer never waits on the child: it reports the
lifecycle's last probe, and a failed, missing or stale probe reads `degraded`.
The child binds the member bind Idunn sets in
`GAMECULT_IDUNN_MEMBER_BIND`, derived from the candidate port. Member bytes `GAMECULT_IDUNN_MEMBER_BIND`, derived from the candidate port. Member bytes
never touch the launcher. never touch the launcher.
- **Lease:** with `write_lease_required` the launcher starts the child only - **Lease:** with `write_lease_required` the launcher starts the child only