UDEV_ENUM...AN_DEVICES(3)

💖 NAME 💖

Okay bestie, welcome to the UDEV_ENUM...AN_DEVICES(3) manual page — yes, that’s the manual name up in the header, and we’re folding it in right here instead of making you read the raw header line. The function squad is udev_enumerate_scan_devices, udev_enumerate_scan_subsystems, udev_enumerate_get_list_entry, udev_enumerate_add_syspath, and udev_enumerate_get_udev. Their collective assignment? Query or modify a udev enumerate object. That’s the vibe, and they understood the assignment. 💅

✨ SYNOPSIS ✨

       #include <libudev.h>

       int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate);

       int
                                          udev_enumerate_scan_subsystems(struct udev_enumerate *udev_enumerate);

       struct udev_list_entry
                                                             *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate);

       int udev_enumerate_add_syspath(struct udev_enumerate *udev_enumerate,
                                      const char *syspath);

       struct udev
                                            *udev_enumerate_get_udev(struct udev_enumerate *udev_enumerate);

🫶 RETURN VALUE 🫶

On success, udev_enumerate_scan_devices(), udev_enumerate_scan_subsystems() and udev_enumerate_add_syspath() return an integer greater than, or equal to, 0. Slay, no negative vibes on success. ✨

On success, udev_enumerate_get_list_entry() returns a pointer to the first entry in the list of found devices. If the list is empty, or on failure, NULL is returned. That’s the whole tea, no cap. 🫶

udev_enumerate_get_udev() always returns a pointer to the udev context that this enumerated object is associated with. Always always, periodt. 👑

🌸 HISTORY 🌸

udev_enumerate_scan_devices(), udev_enumerate_scan_subsystems(), udev_enumerate_get_list_entry(), udev_enumerate_add_syspath(), and udev_enumerate_get_udev() were added in version 221. An iconic era, honestly. 🌸

🦋 SEE ALSO 🦋

• udev_new(3)
• udev_device_new_from_syspath(3)
• udev_enumerate_new(3)
• udev_enumerate_add_match_subsystem(3)
• udev_monitor_new_from_netlink(3)
• udev_list_entry(3)
• systemd(1)

---

Sign-off bestie check 🎀: source/version is systemd 261.3, manual tag is UDEV_ENUM...AN_DEVICES(3), and no separate date is printed in this footer. Mwah 💋✨