diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-04 16:53:45 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-04 16:53:56 -0300 |
| commit | 87d9d6e3fe7122d4a2ff507d6561eebfa569f8e7 (patch) | |
| tree | b628809c132871d6f6543971d8d79b18328bcac3 /docs/typ/building.typ | |
| parent | be3985092df1c3388cfa09ca5e989d2fa66f55ec (diff) | |
| download | pardes-87d9d6e3fe7122d4a2ff507d6561eebfa569f8e7.tar.gz pardes-87d9d6e3fe7122d4a2ff507d6561eebfa569f8e7.zip | |
Tty9p and its pardes-v9fs helper removed (the user: a one-off), a terminal with the session kernel-mounted through Linux v9fs: the builtin and its SPC n 9, the spawn's mounted path and the pane's flag, the host's helper launch, src/linux/v9fs.zig and its build and install, test/v9fs.py, v9fs_driver_test.py and v9fs_terminal.py with their three steps, the docs (the build notes keep how to mount a session by hand); the builtin lists regenerated; core, fs-unit, pane, behaviour and process tests, the gui build and all 113 snap scripts pass; ~/.local/bin/pardes-v9fs, installed before, is left
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs/typ/building.typ')
| -rw-r--r-- | docs/typ/building.typ | 19 |
1 files changed, 2 insertions, 17 deletions
diff --git a/docs/typ/building.typ b/docs/typ/building.typ index d8c089f6..b1d8d127 100644 --- a/docs/typ/building.typ +++ b/docs/typ/building.typ @@ -16,7 +16,7 @@ builds MuPDF and is on by default (`-Dmupdf=false` drops it). 9P over QUIC (`-Dquic=true`) uses system OpenSSL 3.6+ and pkg-config. #pairs( - [`zig build`], [the terminal shell and the SDL window together, *installed into `~/.local/bin`* (`pardes`, `pardes-gui`, and `pardes-v9fs`, the #word("Tty9p") helper)], + [`zig build`], [the terminal shell and the SDL window together, *installed into `~/.local/bin`* (`pardes` and `pardes-gui`)], [`zig build -Dplatform=tty`], [the terminal shell alone], [`zig build -Dplatform=gui`], [the SDL3 window alone], [`zig build web -Dplatform=web -Dtarget=wasm32-freestanding -Ddump=<file>`], [a freestanding wasm core plus vanilla JavaScript (`docs/web.md`)], @@ -85,7 +85,6 @@ zig build agent-session-test interactive session driver checks over 9P zig build 9p-test freestanding protocol tests zig build 9p-io-test native 9P transports and client zig build quic-test -Dquic=true optional QUIC transport tests -zig build v9fs-test a real kernel mount (needs sudo -v; fails, not skips, without it) zig build snap scripted input traces against frozen golden grids zig build monkey random snapshot scripts hunting panics (not a gate) zig build hxdiff differential suite against helix's own behaviour @@ -314,7 +313,7 @@ symlink whose socket refuses a connect is removed with its socket. pardes binds its own socket rather than going through `cloud9.post`, which takes only flat names. A reader of the registry must `stat` through the symlink. -== Kernel mounts and Tty9p +== Kernel mounts For Linux v9fs use `version=9p2000,cache=none,access=any`, `trans=unix` (or `trans=tcp` with `port=`), `uname`, `dfltuid` and `dfltgid` for the @@ -322,20 +321,6 @@ local user, and an empty `aname`. Linux follows `O_TRUNC` with a `Twstat` of zero length and an `mtime` hint; pardes takes the truncation and drops the hint. -#word("Tty9p") starts the normal shell and queues a quoted helper command, -which bash and fish run at their first prompt as a foreground job, so -sudo has the terminal. The unprivileged launcher makes a private temporary -mountpoint and runs `sudo -E`; the elevated `pardes-v9fs` helper makes a -private mount namespace, mounts the session's socket with -`trans=unix,version=9p2000,cache=none,access=any,nosuid,nodev,noexec`, -drops every root id and capability, and runs the shell as the user (with -the caller's `PATH` again). The namespace and the mount go with its last -process. Nothing setuid and no passwordless sudo rule is installed; the -helper takes explicit paths and a command and is no restricted broker, so -never grant it passwordless sudo. The host finds the helper beside its own -executable, or at `PARDES_V9FS_HELPER`. Code: `src/linux/v9fs.zig`; -`zig build v9fs-terminal-test` and `v9fs-driver-test` need no privileges. - = Other notes `docs/` keeps the platform and design notes beside this book: |
