mirror of
https://github.com/troglobit/finit.git
synced 2026-10-06 15:50:12 +07:00
Joachim Wiberg
67d61a8282
Transform keventd from a power-supply monitor + basic hotplug handler into
a full udev-compatible device manager.
Rules engine (rules.c):
- Full .rules file parser covering all udev key types: ACTION, KERNEL,
SUBSYSTEM, DEVPATH, ENV, ATTR, SYSCTL, TAG, RESULT, PROGRAM, TEST,
parent-chain KERNELS/SUBSYSTEMS/ATTRS/DRIVERS, and more
- Pattern matching: plain string, fnmatch glob, and pipe-separated alternatives
- Operators: ==, !=, =, +=, -=, :=
- Assignments: NAME=, MODE=, OWNER=, GROUP=, SYMLINK+=, ENV{k}=, TAG+=, RUN+=
- IMPORT{program|file|builtin|parent|cmdline|db}=
- PROGRAM= with stdout capture for subsequent RESULT== matching
- GOTO=/LABEL= flow control
- Loads *.rules from /lib/udev/rules.d, /run/udev/rules.d, /etc/udev/rules.d
and an optional extra directory (-r DIR); reloads on SIGHUP
Builtin framework (builtin.c):
- kmod: load module by MODALIAS or explicit alias
- hwdb: match device against *.hwdb text files in udev hwdb dirs; builds
correct lookup key per subsystem — evdev:input:b*v*p*e* for input,
usb:v*p* for USB, raw modalias for PCI/platform
- path_id: build stable ID_PATH / ID_PATH_TAG from sysfs topology (PCI, USB,
ATA, NVMe, platform, ACPI, virtio)
- usb_id: read idVendor/idProduct/bcdDevice/serial from sysfs; look up
ID_VENDOR_FROM_DATABASE and ID_MODEL_FROM_DATABASE from usb.ids
(hwdata package) when available; silent fallback when absent
- input_id: classify input devices (keyboard, mouse, joystick, touchscreen,
touchpad) from evdev capability bitmasks in sysfs
- net_id: generate predictable names — MAC-based enx<mac> and PCI-slot-based
enp<bus>s<dev>[f<func>]
- blkid: probe filesystem type, UUID, and label via libblkid; sets ID_FS_*
and ID_PART_TABLE_* properties
Network interface renaming (uevent.c):
- netdev_add() renames interfaces via SIOCSIFNAME when a NAME= rule matched,
then sets the Finit dev/ condition on the final name; and any setup using
persistent interface naming via udev rules
Device node and symlink improvements (uevent.c):
- NAME=, MODE=, OWNER=, GROUP= overrides from matched rules applied at
mknod/chown time, falling back to the built-in permission table
- SYMLINK+= links from rules applied alongside built-in by-id/by-path links
Device property database (udevdb.c):
- Persist per-device E:/S:/I: records to /run/udev/data/ on ADD/CHANGE,
delete on REMOVE; IMPORT{db}= restores saved properties into event env
Build:
- libblkid (util-linux) is now required for keventd
Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
73 lines
2.5 KiB
C
73 lines
2.5 KiB
C
/* udev-compatible per-device database in /run/udev/data/
|
|
*
|
|
* Copyright (c) 2025 Joachim Wiberg <troglobit@gmail.com>
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef KEVENTD_UDEVDB_H_
|
|
#define KEVENTD_UDEVDB_H_
|
|
|
|
#include "keventd.h"
|
|
|
|
/*
|
|
* Database root directory, compatible with systemd/eudev's /run/udev/data/.
|
|
* One text file per device, keyed by device ID (see udevdb_path()).
|
|
*
|
|
* Record format (one per line):
|
|
* I:<usec> initialisation timestamp
|
|
* E:<KEY>=<VAL> environment / property
|
|
* S:<path> symlink (relative to /dev/)
|
|
* G:<tag> tag (for G: records)
|
|
* Q:<tag> tag (for Q: query records, mirrors G:)
|
|
* V:1 format version sentinel, always last
|
|
*/
|
|
#define UDEVDB_PATH "/run/udev/data"
|
|
|
|
/*
|
|
* Write a device's properties to the database after event processing.
|
|
* Creates /run/udev/data/<id> with I:, E:, S:, G:, Q:, V: records.
|
|
*/
|
|
int udevdb_write (const struct uevent *ev);
|
|
|
|
/*
|
|
* Read a device's properties from the database into ev's env store.
|
|
* Used by IMPORT{db} and IMPORT{parent} in the rules engine (Phase 4).
|
|
*/
|
|
int udevdb_read (struct uevent *ev);
|
|
|
|
/*
|
|
* Like udevdb_read(), but for the parent device of ev.
|
|
*/
|
|
int udevdb_read_parent (struct uevent *ev);
|
|
|
|
/*
|
|
* Delete a device's database entry on ACT_REMOVE.
|
|
*/
|
|
void udevdb_delete (const struct uevent *ev);
|
|
|
|
#endif /* KEVENTD_UDEVDB_H_ */
|
|
|
|
/**
|
|
* Local Variables:
|
|
* indent-tabs-mode: t
|
|
* c-file-style: "linux"
|
|
* End:
|
|
*/
|