summaryrefslogtreecommitdiff
path: root/docs/typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-04 16:53:45 -0300
committerGabriel Schneider <[email protected]>2026-11-04 16:53:56 -0300
commit87d9d6e3fe7122d4a2ff507d6561eebfa569f8e7 (patch)
treeb628809c132871d6f6543971d8d79b18328bcac3 /docs/typ
parentbe3985092df1c3388cfa09ca5e989d2fa66f55ec (diff)
downloadpardes-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')
-rw-r--r--docs/typ/building.typ19
-rw-r--r--docs/typ/builtins-gui.json1
-rw-r--r--docs/typ/builtins-tty.json1
-rw-r--r--docs/typ/cheatsheet.typ1
-rw-r--r--docs/typ/reference.typ9
5 files changed, 3 insertions, 28 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:
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
index e731b75e..c7553186 100644
--- a/docs/typ/builtins-gui.json
+++ b/docs/typ/builtins-gui.json
@@ -146,7 +146,6 @@
{"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
{"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
{"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
- {"name": "Tty9p", "leader": "SPC n 9", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A Linux terminal with the current session mounted through kernel v9fs."},
{"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
{"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
{"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
diff --git a/docs/typ/builtins-tty.json b/docs/typ/builtins-tty.json
index fe81b3fa..613627a7 100644
--- a/docs/typ/builtins-tty.json
+++ b/docs/typ/builtins-tty.json
@@ -129,7 +129,6 @@
{"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
{"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
{"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
- {"name": "Tty9p", "leader": "SPC n 9", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A Linux terminal with the current session mounted through kernel v9fs."},
{"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
{"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
{"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
diff --git a/docs/typ/cheatsheet.typ b/docs/typ/cheatsheet.typ
index a831273b..a70b56e2 100644
--- a/docs/typ/cheatsheet.typ
+++ b/docs/typ/cheatsheet.typ
@@ -92,7 +92,6 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla
key("SPC f c"), word("Config"),
key("SPC d"), word("Del"),
key("SPC n t"), word("Tty"),
- key("SPC n 9"), word("Tty9p"),
key("SPC w"), word("Window"),
key("SPC j j"), word("Last"),
key("SPC j l"), word("Jumplist"),
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 45863f04..b272306c 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -1118,15 +1118,8 @@ every pane pardes spawns gets it as `$PARDES_MOUNT`. Under `9ns --unix SOCK
plan9port's `9p write` opens with OTRUNC, so on #file("body") it replaces
the whole text. To append, use `>>` through a mount. Through a FUSE mount
bash's `read -t` cannot time out: wrap a follow loop in `timeout`. The
-scripting chapter's rule (a mount, else `9p`) covers most uses. Two more:
+scripting chapter's rule (a mount, else `9p`) covers most uses. One more:
-- #word("Tty9p") (#key("SPC n 9")) opens a terminal with the session
- kernel-mounted (Linux v9fs): it asks for your sudo password in the pane,
- mounts the socket in a private mount namespace and starts your shell as
- you, with `PARDES_MOUNT` naming the mount. Only that shell sees it, and
- each takes one of the session's 16 connections. It needs the `9p` and
- `9pnet_fd` kernel modules and the `pardes-v9fs` helper the build installs
- beside `pardes`.
- `test/ninep.py` is a Python 9P client that exists only in the source tree
(it is not installed). It is for when nothing is mounted and `9p` is not
there, or when a fid must stay open (#file("event"), #file("pty/data"), a