DEVCLASS_GET_DEVICES(9)

💅 DEVCLASS_GET_DEVICES 💅

ok so this is a page from the Kernel Developer's Manual (section 9, kernel-adjacent besties rise up 🫶) and it's all about devclass_get_devices — yes that whole mouthful, we'll get through it together.

---

🌸 NAME 🌸

devclass_get_devices — bestie, it literally just gets you a list of the devices chillin' in a devclass. that's it. that's the whole vibe check. ✨

---

🎀 SYNOPSIS 🎀

ok first things first, you gotta invite the right headers to the party:

#include <sys/param.h>
#include <sys/bus.h>

and then the actual function, iconic signature and all:

int
devclass_get_devices(devclass_t dc, device_t **devlistp,
    int *devcountp);

---

🦋 DESCRIPTION 🦋

so the tea is: you call this bad boy and it goes and retrieves a list of, like, all the device instances currently in the devclass. every single one. no cap. 💅

it hands you back the list in *devlistp and the count in *devcountp — so you know exactly how many little device besties you're dealing with. so considerate honestly. 👑

⚠️ okay this part is important, don't skip it: the memory allocated for the list needs to be freed using free(*devlistp, M_TEMP) — and yes, you have to do it even if *devcountp is 0. like, even when the list is empty. no excuses, free it. the way that memory leaks are not the move 😭

---

⭐ RETURN VALUES ⭐

• 0 — slay, you did it, success 💖
• anything else — an appropriate error got returned, so… rude, but okay 🙈

---

🌈 SEE ALSO 🌈

• devclass(9)
• device(9)

go read those too, iykyk 🧚

---

👑 AUTHORS 👑

this absolute legend wrote this manual page: Doug Rabson. give him his flowers fr fr 💐

---

and that's the whole page bestie, you ate that 🍓 This little gem came from the Debian crew and it's dated May 19, 2005 — vintage but still serving, periodt 💜