LIDM(1)

SYNOPSIS

lidm [virtual-terminal]

lidm -h

lidm -v

lidm authenticates a local user and starts a selected graphical or shell session. On MOUSE it is normally managed by the /usr/lib/mouse/init.d/lidm OpenRC service through /usr/libexec/lidm-console; it is not started directly.

The graphical profile runs on /dev/ttyE0 and initially selects the MERDE Wayland session described by /usr/share/wayland-sessions/merde.desktop. The tty profile runs on /dev/console and selects the authenticated account's configured login shell. Set lidm_mode to graphical or tty in /etc/conf.d/lidm.

Session descriptions are read from /usr/share/xsessions, /usr/local/share/xsessions, /usr/share/wayland-sessions, and /usr/local/share/wayland-sessions. The account's login shell is also offered when include_defshell is enabled in lidm-config(5).

OPTIONS

virtual-terminal: Switch to the numbered virtual terminal before displaying the login screen. MOUSE's service wrapper selects the console device directly and supplies no number.
-h, --help: Print usage and exit.
-v, --version: Print version and build information and exit.

AUTHENTICATION

MOUSE uses its local password database rather than PAM. Root, unknown, empty-password, and locked accounts cannot log in through lidm. After authentication the session receives TERM, PATH, HOME, USER, SHELL, LOGNAME, XDG_RUNTIME_DIR, and XDG_SESSION_TYPE. The runtime directory is /var/run/user/uid, owned by the account and mode 0700.

ENVIRONMENT

LIDM_CONF: Override the default /etc/lidm.ini configuration path.
LIDM_LOG: Write LiDM's diagnostic log to the named file. The MOUSE service sets it to /var/log/lidm.log.
LIDM_STATE: Override the remembered username and session file. The tty wrapper uses /var/lib/lidm/state-tty; graphical mode uses /var/lib/lidm/state. This variable is intended for service integration, not session configuration.

FILES

/etc/lidm.ini: Display and behavior configuration.
/etc/conf.d/lidm: MOUSE service profile.
/var/lib/lidm/state: Remembered graphical username and session.
/var/lib/lidm/state-tty: Remembered tty username and session.
/var/log/lidm.log: Authentication and session-launch diagnostics.
/usr/share/wayland-sessions/merde.desktop: MERDE session description.

DIAGNOSTICS

LiDM writes authentication, configuration, console, and session-launch failures to /var/log/lidm.log and serious wrapper failures to the system console. Once MERDE starts, its output is in $XDG_RUNTIME_DIR/merde-session.log. Check service state with rc-service lidm status and crashed services with rc-status --crashed.

NAME