summaryrefslogtreecommitdiff
path: root/docs/typ/building.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/building.typ')
-rw-r--r--docs/typ/building.typ19
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: