monolith

public

Star0

Fork 0

Watch0

57 commits 1 branch 0 tags 0 releases1.5 MiB

Commit `82a6f2fca59f`

tarball

atagen <boss@atagen.co>2026-10-16 23:19 UTC

2 files changed+45-3

design: add the M5 to M7 test checklist and refresh parked items

Modified file: design/parked.md+5 additions−3 deletions@@ -4,9 +4,10 @@ Issues found while building, with the milestone that owns them.
 
 ## M7
 
-- vkcube shows a black window for about half a second at startup since early import, first-buffer holds and explicit sync landed. A spans log of a launch tells which.
-- Every 1024th queue submit on NVIDIA stalls for 2.5 to 15 ms, one dropped frame every 6.2 s at 165 Hz. See research/nvidia.md.
-- First-time dmabuf imports (15 to 27 ms each on NVIDIA) and direct scanout setup on fullscreen still land on the main thread and cost about ten frames per transition.
+- vkcube showed a black window for about half a second at startup. First-time dmabuf imports now run on a worker thread, which was the likeliest cause. Needs a re-test on bare metal, with a spans log if it persists.
+- Direct scanout setup on a fullscreen switch (framebuffer creation for client buffers) still runs on the main thread inside `render_frame`. Measure its cost before moving it.
+- shm uploads still copy damaged rows into staging on the main thread. Moving the copy off-thread races the client reusing its buffer after release, so measure a full-screen shm redraw first and only move it if it shows up.
+- SCHED_RR and the realtime queue priority both need CAP_SYS_NICE, which monolith does not have when started normally.
 
 ## After M6
 
@@ -14,3 +15,4 @@ Issues found while building, with the milestone that owns them.
 - Taskbars want wlr-foreign-toplevel-management, which smithay does not ship.
 - X11 windows do not raise in X stacking order on focus, which only matters for overlapping floating X windows.
 - Dialogs from xdg toplevels with a parent tile like any window. X11 dialogs, transients and fixed-size windows float.
+- Some programs open an X connection just to probe, vkcube among them, which starts Xwayland lazily even though they draw through Wayland.

Added file: design/test-checklist.md+40 additions@@ -0,0 +1,40 @@
+# Test checklist for M5 to M7
+
+Everything below landed while you were away and was only smoke-tested nested. Bare metal, multi-monitor and real apps are still unverified.
+
+Build and run from the repo root in nushell.
+
+```nu
+nix develop -c cargo build --release -p monolith
+nix develop -c sh -c 'RUST_LOG=monolith=debug target/release/monolith run --backend drm 2> monolith.log'
+```
+
+## M5
+
+- [ ] **VRR.** The log line `output connected` should say `vrr_capable=true` for DP-2. Fullscreen vkcube and look for `adaptive sync vrr=true`, and check the monitor's OSD shows a varying refresh rate. Leaving fullscreen should log `vrr=false`. The default is `[output] vrr = "fullscreen"`, and `"on"` and `"off"` also work.
+- [ ] **VRR cursor cap.** With a fullscreen game below 165 fps, moving the mouse should not push the refresh rate up. Cursor-only frames are capped at 60 Hz.
+- [ ] Hotplug, a second monitor and the Intel pass, still open from before.
+
+## M6
+
+- [ ] **layer-shell.** `waybar` reserves its strip and tiles stay clear of it. A fullscreen window covers it. Its workspaces module should list the tags through ext-workspace.
+- [ ] **Launchers.** `fuzzel` takes the keyboard while open and gives it back on close. The launched app should land on the tag you were on when you launched it.
+- [ ] **Session lock.** `swaylock` hides everything, takes input and unlocks with your password. VT switching still works while locked. Killing swaylock leaves the session locked, which is what the protocol wants. Unlock it by starting `swaylock` again from a VT.
+- [ ] **Idle.** `swayidle -w timeout 10 'notify-send idle'` fires after 10 s without input. A playing `mpv` should hold it off while visible and stop holding it off once its tag is hidden.
+- [ ] **Clipboard.** `wl-copy` and `wl-paste` work both ways with foot or beer. Middle-click paste uses the primary selection.
+- [ ] **Screenshots.** `grim` and `grim -g (slurp)`.
+- [ ] **Portals.** Needs `xdg-desktop-portal-wlr` installed and monolith's package in your profile so `share/xdg-desktop-portal/monolith-portals.conf` is found. Screen sharing a whole output from a browser should work. Window sharing does not exist yet.
+- [ ] **Xwayland.** Run an X app, like `xeyes`, Steam or a Proton game. The log shows `starting Xwayland` on its first connection. Check keyboard input, fullscreen and menu placement. Dialogs should float. After the last X client closes, Xwayland exits and should start again for the next one.
+- [ ] **Activation.** Launch something slow from fuzzel on tag 2, switch to tag 3 before it appears. It should land on tag 2 and mark it urgent.
+
+## M7
+
+- [ ] **Submit stall.** It used to drop one frame every 6.2 s at 165 Hz. With vkcube running, the `frame rate` debug lines should read 165 of 165 indefinitely, with no `frame missed its vblank` in steady state.
+- [ ] **vkcube black start.** Is the half second of black at launch gone?
+- [ ] **Fullscreen switches.** Toggle fullscreen on vkcube a few times and look for `slow frame` lines. First-time imports now run on a worker thread.
+- [ ] **Realtime, optional.** SCHED_RR and the realtime Vulkan queue need CAP_SYS_NICE. To try them, wrap the binary with `security.wrappers` and `capabilities = "cap_sys_nice+ep"`, then look for `compositor thread runs SCHED_RR` and `queue global priority priority=Some(REALTIME)`. File capabilities make the loader ignore variables like `VK_DRIVER_FILES`.
+
+## Known
+
+- Nested monolith stops redrawing when the host compositor stops sending it frame callbacks, for example while its window is hidden. Clients inside then freeze until it is shown again.
+- See `parked.md` for what is left over.

monolith

Commit 82a6f2fca59f

Commit `82a6f2fca59f`