Skip to content

LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.

1.9 KB
Raw Blame
/* lbrun.h — LordBench in lord-server (docs/BENCHMARK.md, "0.8.6 — LordBench"): one run at a time, on
 * its own thread. It records the conditions, waits for a quiet system, launches lord-bench (lbmain.c)
 * with the render node and, for Full, a scratch file it opened itself, checks every record that comes
 * back, watches temperatures and throttling, and saves the result as
 * ~/.local/state/lordos/lordbench.json (the previous one becomes lordbench-prev.json). Exposed to JS
 * as lord.sysinfo.bench (ui/js_hw.c). */
#ifndef LORD_BENCH_LBRUN_H
#define LORD_BENCH_LBRUN_H

/* mode: "quick" or "full" (peak performance; then video in lord-media, lbvideo.c), or "desktop" (the
 * compositor's frame times while the app animates a scene, alone and then with lord-bench loading every core
 * at the lowest priority; lbframes.c). sustained_s: Full's sustained test (0 = none, 20–1800); extra: JSON
 * the caller adds as "session" (displays, composition), produced by lord-server itself. 0 started,
 * -1 refused (another run, a bad argument, no helper). Desktop results are kept apart, in
 * lordbench-desktop.json. */
int   lbrun_start(const char *mode, int sustained_s, const char *extra);
void  lbrun_cancel(void);
/* the state as JSON (malloc'd): {"state":"idle|waiting|running|done|stopped|failed|cancelled","mode",
 * "step":"<measurement>","progress":0..1,"result":{…} once finished} */
char *lbrun_poll(void);
/* the saved results (malloc'd JSON text, NULL if none): which = 0 the last peak run, 1 the previous one,
 * 2 the last desktop run, 3 the previous one */
char *lbrun_saved(int which);
/* every recorded boot's time to the first frame, grouped by LordOS version (malloc'd JSON array):
 * [{"version","boots","median","min","max","first","test"}], the first boot after an update kept apart;
 * "test": the latest boot time test's boots of that version (bench/boottest.h), {boots, of, at, median,
 * min, max} */
char *lbrun_boot_history(const char *path);

#endif