mirror of
https://github.com/troglobit/finit.git
synced 2026-10-01 05:22:48 +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>
76 lines
2.7 KiB
C
76 lines
2.7 KiB
C
/* sysfs attribute reader and parent-chain walker for keventd
|
|
*
|
|
* 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_SYSFS_H_
|
|
#define KEVENTD_SYSFS_H_
|
|
|
|
#include <stddef.h>
|
|
|
|
/*
|
|
* Read the first line from an absolute path.
|
|
* Returns 0 on success, -1 on failure.
|
|
*/
|
|
int sysfs_read_file(const char *path, char *buf, size_t len);
|
|
|
|
/*
|
|
* Read a sysfs attribute for the device at /sys{devpath}.
|
|
* attr may be a relative path like "device/vendor" or "../serial".
|
|
* Returns 0 on success, -1 if the attribute does not exist.
|
|
*/
|
|
int sysfs_read_attr(const char *devpath, const char *attr,
|
|
char *buf, size_t len);
|
|
|
|
/*
|
|
* Walk the sysfs device tree upward from devpath toward /sys/devices,
|
|
* calling cb at each level. cb receives the absolute syspath and the
|
|
* caller-supplied data pointer. Walk stops when cb returns 0 (found)
|
|
* or the tree root is reached.
|
|
* Returns 0 if cb returned 0, -1 if nothing matched.
|
|
*/
|
|
int sysfs_parent_walk(const char *devpath,
|
|
int (*cb)(const char *syspath, void *data),
|
|
void *data);
|
|
|
|
/*
|
|
* Read the subsystem name at syspath by following the "subsystem"
|
|
* symlink and returning its basename.
|
|
* Returns 0 on success, -1 if there is no subsystem link.
|
|
*/
|
|
int sysfs_read_subsystem(const char *syspath, char *buf, size_t len);
|
|
|
|
/*
|
|
* Read the driver name at syspath by following the "driver" symlink
|
|
* and returning its basename.
|
|
* Returns 0 on success, -1 if there is no driver link.
|
|
*/
|
|
int sysfs_read_driver(const char *syspath, char *buf, size_t len);
|
|
|
|
#endif /* KEVENTD_SYSFS_H_ */
|
|
|
|
/**
|
|
* Local Variables:
|
|
* indent-tabs-mode: t
|
|
* c-file-style: "linux"
|
|
* End:
|
|
*/
|