Skip to content

Design: reorganize docs around subsystem architecture - #12

Merged
reiase merged 10 commits into
nextfrom
feature/fix_macos_build
Oct 8, 2026
Merged

reiase merged 10 commits into
nextfrom
feature/fix_macos_build

Conversation

@reiase

@reiase reiase commented Oct 7, 2026

Copy link
Copy Markdown
Collaborator

Rewrite the design chapter as a continuous explanation of execution, filesystem, network and state paths. Add the VM, memory, filesystem, network and snapshot subsystem articles plus the records/versions and failure-semantics pages, and split the ADRs into separate files.

Replace the daemon responsibility diagram in favor of the process ownership figure, and add SVGs for copy-up, apply conflicts, cold-page cycles, image reads, journal commits, memory COW and network paths.

Fix macOS portability issues surfaced along the way:

  • Query Darwin peer identity with getpeereid so authorization no longer depends on a live peer PID.
  • Bounds-check the loaded Mach-O image header instead of reading through a libc struct.
  • Make mock S3 listeners blocking, since BSD/macOS can inherit the listener's nonblocking mode.
  • Gate Linux-only helpers and tests behind cfg(target_os = "linux").
  • Rename fields and bindings to silence unused warnings.

Enable CI and docs workflows on the next branch, and enlarge the sparse RAM copy test so the hole survives fsync on APFS.

reiase added 10 commits October 7, 2026 22:44
Rewrite the design chapter as a continuous explanation of execution,
filesystem, network and state paths. Add the VM, memory, filesystem,
network and snapshot subsystem articles plus the records/versions and
failure-semantics pages, and split the ADRs into separate files.

Replace the daemon responsibility diagram in favor of the process
ownership figure, and add SVGs for copy-up, apply conflicts, cold-page
cycles, image reads, journal commits, memory COW and network paths.

Fix macOS portability issues surfaced along the way:

- Query Darwin peer identity with getpeereid so authorization no longer
  depends on a live peer PID.
- Bounds-check the loaded Mach-O image header instead of reading through
  a libc struct.
- Make mock S3 listeners blocking, since BSD/macOS can inherit the
  listener's nonblocking mode.
- Gate Linux-only helpers and tests behind cfg(target_os = "linux").
- Rename fields and bindings to silence unused warnings.

Enable CI and docs workflows on the next branch, and enlarge the sparse
RAM copy test so the hole survives fsync on APFS.
@reiase
reiase merged commit 4f6d0a4 into next Oct 8, 2026
17 checks passed
@reiase
reiase deleted the feature/fix_macos_build branch October 8, 2026 06:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant