mirror of
https://dev.lirent.ru/Vatrog/vm-automation-signaling.git
synced 2026-06-25 20:36:36 +03:00
lirent
9bde398b6c
- core: runtime attach/detach of a per-endpoint adapter trio (runtime-safe add_adapter + vmsig_core_detach_endpoint, deferred reap) - roster: VMSIG_EV_ROSTER + CAP_ROSTER, retained per-endpoint and replayed to late subscribers - discovery: inotify trigger dir, vmid/endpoint slot allocator, host probe; vmsigd daemon with config + per-uid admission - input driver and vgpu perception built in-tree; vgpu perception as a separate library - memctx: own the supplied ro_fd (closed at detach) - deb packaging: install rules, systemd unit, tmpfiles, default config
47 lines
2.6 KiB
C
47 lines
2.6 KiB
C
#ifndef VMSIG_DISCOVERY_H
|
|
#define VMSIG_DISCOVERY_H
|
|
#include "vmsig_core.h"
|
|
#include "host_probe.h"
|
|
|
|
/* discovery.h — runtime VM discovery (private to the discovery module).
|
|
*
|
|
* Watches a tmpfs trigger dir for "vm-<vmid>-ram" files, corroborates each candidate via the
|
|
* host-probe seam, assigns a stable endpoint slot, hot-plugs the VM (sink), and publishes the
|
|
* roster. The state machine + slot allocation are decoupled from actuation by a sink seam, so
|
|
* the orchestration is unit-testable without armed adapters. */
|
|
|
|
typedef struct vmsig_discovery vmsig_discovery;
|
|
|
|
/* Actuation seam: bring a discovered VM up / tear it down. Default (NULL) wires the core
|
|
* adapter trio (memctx+vmhost+input via vmsig_core_add_adapter) and detach_endpoint. A test
|
|
* injects a recording sink to verify the state machine without real adapters. Roster publish
|
|
* is owned by discovery (not the sink): ATTACH after a successful attach, DETACH before tear-down. */
|
|
typedef struct {
|
|
int (*attach)(void* ud, vmsig_core* core, uint32_t vmid, uint32_t endpoint,
|
|
const vmsig_host_facts* f); /* 0 = up, -1 = failed (slot freed) */
|
|
void (*detach)(void* ud, vmsig_core* core, uint32_t vmid, uint32_t endpoint);
|
|
void* ud;
|
|
} vmsig_discovery_sink;
|
|
|
|
/* Create discovery over `core`. `watch_dir` (e.g. /dev/shm/vmsig) is scanned once and
|
|
* inotify-watched. `probe` NULL => default Proxmox probe over (watch_dir, pve_conf, qmp_dir);
|
|
* `sink` NULL => default core trio; `slots_path` NULL => no persistence. Registers the inotify
|
|
* + retry-timer loop sources and runs a bootstrap scan. The core owns the lifetime (freed at
|
|
* vmsig_core_free via the source on_free). NULL on error. */
|
|
vmsig_discovery* vmsig_discovery_new(vmsig_core* core,
|
|
const char* watch_dir, const char* pve_conf,
|
|
const char* qmp_dir, const char* slots_path,
|
|
const vmsig_host_probe* probe,
|
|
const vmsig_discovery_sink* sink);
|
|
|
|
/* Resolve vmid -> endpoint for the admission policy (WS4); -1 if not currently attached. */
|
|
int vmsig_discovery_slot_of_vmid(vmsig_discovery* d, uint32_t vmid);
|
|
|
|
/* TEST-ONLY: drive a file appear(present=1)/gone(present=0) directly, bypassing inotify; and
|
|
* force a re-probe of every probing candidate, bypassing the retry timer. Lets the state
|
|
* machine be unit-tested deterministically without threads/timers. */
|
|
void vmsig_discovery_feed(vmsig_discovery* d, uint32_t vmid, int present);
|
|
void vmsig_discovery_tick(vmsig_discovery* d);
|
|
|
|
#endif /* VMSIG_DISCOVERY_H */
|