daemon

Documentation

Overview

Package daemon implements the z13ctl long-running daemon: Unix socket server, hardware device management, state persistence, and Armoury Crate button watcher.

Designed as a systemd user service using two units:

• z13ctl.socket — systemd manages the socket fd (socket activation)
• z13ctl.service — Type=notify, Restart=on-failure

Can also be run directly for development: z13ctl daemon.

The daemon socket client (Send*, Subscribe, SocketPath) lives in the public api package: github.com/dahui/z13ctl/api.

Index

• func Run(ctx context.Context, opts Options) error
• type Daemon
• type Options

Functions

func Run

func Run(ctx context.Context, opts Options) error

Run starts the daemon and blocks until ctx is cancelled. It opens HID devices, restores the last-saved state, starts the button watcher, and serves the Unix socket.

Types

type Daemon

type Daemon struct {
	// contains filtered or unexported fields
}

Daemon holds the runtime state for the long-running z13ctl process.

type Options

type Options struct {
	// WatchButton starts the Armoury Crate button watcher (--no-button clears it).
	WatchButton bool
	// SleepRelease hands the fans back to the firmware before sleep, so the EC
	// stops them (--no-sleep-release clears it).
	SleepRelease bool
}

Options configures the daemon. A zero value disables both watchers, so callers state what they want rather than relying on positional bools — Run(ctx, true, false) said nothing about which flag was which.