DEVCLASS_GET_DEVICES(9)

💖 DEVCLASS_GET_DEVICES 💖

okay bestie, so this one lives in the Kernel Developer's Manual (section 9, kernel devs only, iykyk) and it's literally just "hey, gimme all the devices in this devclass" 🦋

✨ NAME ✨

devclass_get_devices — get a list of devices in a devclass 💅

🌸 SYNOPSIS 🌸

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

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

like, you gotta include both of those headers, no skipping 🙈

🎀 DESCRIPTION 🎀

So basically you call this and it retrieves a list of all device instances that are currently chillin' in the devclass, then hands you back:

• the list itself in *devlistp 🌈
• the count in *devcountp 🔢

⚠️ okay this part is IMPORTANT, no cap: the memory that gets allocated for that list has to be freed with free(*devlistp, M_TEMP) — and yes, you do this even if *devcountp is 0. Zero devices still means allocated memory, bestie. don't leak on me 😭

💜 RETURN VALUES 💜

Zero on success, slay ✨ otherwise it returns whatever appropriate error fits the situation. not zero = something went sideways, periodt.

🦋 SEE ALSO 🦋

• devclass(9)
• device(9)

the girlies that go with this one 👑 go read 'em, fr fr

👑 AUTHORS 👑

This manual page was written by Doug Rabson. iconic behavior honestly 💖

k bye this page came from the Debian crew, dated May 19, 2005, and it's DEVCLASS_GET_DEVICES(9) all the way through 🎀✨