DEVICE_ATTACH(9)

💅 DEVICE_ATTACH(9) — attach a device

okay so this icon is straight out of the Kernel Developer's Manual — yes, the kernel-dev manual, we love a technical queen ✨

🎀 NAME 🎀

DEVICE_ATTACH — attach a device

🧚 SYNOPSIS 🧚

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

int
DEVICE_ATTACH(device_t dev);

🌸 DESCRIPTION 🌸

So DEVICE_ATTACH() is the method that attaches a device to the system after DEVICE_PROBE() has been called and has indicated that the device exists. Basically probe says “she’s real” and then attach says “say less, I’ll set her up” 💖

The DEVICE_ATTACH() method should initialize the hardware and allocate other system resources (such as devfs(4) entries). It’s giving hardware setup era, no cap.

Devices which implement buses should use this method to probe for the existence of devices attached to the bus and add them as children. That’s the bus doing a little headcount of its child devices 👑

If this is combined with the use of bus_attach_children(9), the child devices will be automatically probed and attached. automatic? we love to see it 🔥

🔥 RETURN VALUES 🔥

Zero is returned on success, otherwise an appropriate error is returned. So zero = slay, error = read the vibe check and handle it 💅

🦋 SEE ALSO 🦋

• devfs(4)
• bus_attach_children(9)
• device(9)
• DEVICE_DETACH(9)
• DEVICE_IDENTIFY(9)
• DEVICE_PROBE(9)
• DEVICE_SHUTDOWN(9)

👑 AUTHORS 👑

This manual page was written by Doug Rabson <dfr@FreeBSD.org>. iconic, honestly 🫶

---

This page is from the Debian source/version sitch, dated February 5, 2025 — mwah 💋