Skip to content

zero-shell-interface.md

Latest commit

 

History

History
90 lines (66 loc) · 1.73 KB

zero-shell-interface.md

File metadata and controls

90 lines (66 loc) · 1.73 KB
Raw

ZeroShell Interface

This document defines the interface between cardputer-zero-os and cardputer-zero-shell.

Summary

cardputer-zero-os
  -> owns login, session, compositor startup, privilege policy

cardputer-zero-shell
  -> owns post-login launcher and task UI

Launch Path

After Zero greeter PAM authentication:

/usr/local/bin/cardputer-zero-session
  -> /usr/local/bin/cardputer-zero-labwc-session
  -> labwc -S /usr/local/bin/cardputer-zero-shell-session
  -> zero-window-agent
  -> /opt/cardputer-zero-shell/bin/zero-shell-wayland

The shell path can be overridden in:

/etc/cardputer-zero/session.conf

using:

CARDPUTER_ZERO_WAYLAND_SHELL=/path/to/zero-shell-wayland

Runtime Identity

The shell must run as the authenticated user:

pi  1234 /opt/cardputer-zero-shell/bin/zero-shell-wayland

Environment

cardputer-zero-session exports:

XDG_SESSION_TYPE=wayland
XDG_CURRENT_DESKTOP=CardputerZero
XDG_SESSION_DESKTOP=CardputerZero
CARDPUTER_ZERO_SESSION=1

The labwc wrapper exports:

WLR_DRM_DEVICES=/dev/dri/cardputer-zero-internal
WLR_BACKENDS=drm,libinput
WLR_RENDERER=pixman

OS Provides

  • authenticated user session,
  • Wayland compositor on the internal DRM output,
  • zero-window-agent as the authoritative task-state and task-action backend,
  • device permissions,
  • APPLaunch data directories,
  • zero-shell-control,
  • root-owned zero-key-policy.service for global Esc and internal-seat activation policy,
  • zero-helper,
  • polkit agent.

OS Does Not Provide

  • launcher home UI,
  • application scanner,
  • app store UI,
  • file manager UI,
  • terminal UI,
  • settings UI,
  • system monitor UI.

Those are shell or application responsibilities.