UDEV_ENUMERATE_NEW(3)

💖 udev_enumerate_new, udev_enumerate_ref, udev_enumerate_unref 💖

okay bestie, welcome to UDEV_ENUMERATE_NEW(3), aka the little libudev trio that handles making, holding, and yeeting an enumerate object. it’s giving “reference counting but make it cute” ✨

---

🌸 NAME 🌸

• udev_enumerate_new, udev_enumerate_ref, udev_enumerate_unref — create, acquire and release a udev enumerate object 🫶

---

✨ SYNOPSIS ✨

#include <libudev.h>

struct udev_enumerate *udev_enumerate_new(struct udev *udev);

struct udev_enumerate *udev_enumerate_ref(struct udev_enumerate *udev_enumerate);

struct udev_enumerate *udev_enumerate_unref(struct udev_enumerate *udev_enumerate);

---

🦋 DESCRIPTION 🦋

okay so udev_enumerate_new() creates an enumeration context to scan /sys/. that’s literally its whole job, and it ate 💅

udev_enumerate_ref() takes a reference of an enumeration context. yup, it’s just out here acquiring a reference, main character behavior 👑

udev_enumerate_unref() drops a reference of an enumeration context. if the refcount reaches zero, all resources of the enumeration context will be released. poof, gone, resources freed, no cap 💀

---

🎀 RETURN VALUE 🎀

• On success, udev_enumerate_new() returns a pointer to the allocated enumeration object. slay ✨
• On failure, NULL is returned. sad girl hours 😭
• udev_enumerate_ref() returns the argument that it was passed, unmodified. it’s not changing a thing, just returning the vibe 🫶
• udev_enumerate_unref() always returns NULL. always. every time. periodt 💅

---

👑 HISTORY 👑

udev_enumerate_new(), udev_enumerate_ref(), and udev_enumerate_unref() were added in version 221. iconic from the start, fr fr 🌟

---

🌈 SEE ALSO 🌈

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

---

signed, sealed, and delivered by systemd 261.3 — and the date? this page doesn’t print one, bestie, so the vibe is timeless 💖✨🦋