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.
C cdebiandesktop-environmentebpffirewalllandlocklinuxlinux-distributionopen-sourceprivacyquickjsraspberry-pi-5reactsecuritywaylandwayland-compositor
/* pwguard.h — the firewall's "no microphone" and "no camera" for Linux apps inside PipeWire
* (docs/FIREWALL.md, "Linux apps").
*
* Linux apps talk to PipeWire directly (natively, or through pipewire-pulse), so the kernel's
* device rules don't cover the microphone (PipeWire opens the sound card, not the app) nor a
* camera that PipeWire serves. lord-server keeps one connection of its own to the session's
* PipeWire, on the manager socket ($XDG_RUNTIME_DIR/pipewire-0-manager), with our own
* implementation of the native protocol (no libpipewire). For every PipeWire client it works out
* the app (the PID's cgroup → the launcher's scope → desktop:<id>) and, if that app is
* restricted (sec/restrict.h):
* - hides from that client every capture node: Audio/Source* and Audio/Duplex for "no
* microphone", Video/Source for "no camera", and their ports (permission 0, so it can neither
* see nor link them), and every other client (so it can't change anyone's permissions);
* - destroys every capture stream that client creates (Stream/Input/Audio, Stream/Input/Video),
* as soon as it appears.
* The rules are lord.fw's store (the one Settings edits), read every second: a restriction set or
* lifted on a running app applies within a second, without restarting it. Nothing is written to a
* file the apps could change.
*
* Who a client is: PipeWire's own pipewire.sec.pid (from the socket's credentials) for native
* clients. Apps using the PulseAudio API all reach PipeWire through pipewire-pulse's process, so
* for those the PID is the application.process.id the app itself reported to pipewire-pulse (see
* the documentation for what that means). */
#ifndef LORD_SEC_PWGUARD_H
#define LORD_SEC_PWGUARD_H
#include <stddef.h>
#include <stdint.h>
int pwguard_start(void); /* 0 connected; retried by pwguard_tick if PipeWire isn't up */
int pwguard_fd(void); /* -1 if not connected */
int pwguard_wants_write(void);
void pwguard_dispatch(void);
void pwguard_tick(void); /* every pass of the main loop; does work once a second */
/* ---- for tests (tests/pwguard_test.c) ---- */
/* A SPA POD reader over buf: the n-th field of a Struct and its kind. */
typedef struct { const uint8_t *p; size_t n; } PwPod;
int pwpod_struct_field(PwPod s, int index, PwPod *out); /* 0 ok */
int pwpod_int(PwPod p, int32_t *v);
int pwpod_string(PwPod p, const char **s);
/* Which restriction makes a node a capture node to hide ("Audio/Source" → FW_R_NO_MIC...), 0 none. */
uint32_t pwguard_capture_flag(const char *media_class);
/* The same for a stream an app creates to capture ("Stream/Input/Audio" → FW_R_NO_MIC). */
uint32_t pwguard_stream_flag(const char *media_class);
#endif