STRUCT CDX_DRIVER(9)

✨ struct cdx_driver — CDX device driver ✨

okay so bestie, welcome to the struct cdx_driver glow-up 💅 this is the page from the Kernel API Manual, manual name and all — and it's giving "the blueprint every CDX device driver fills in to become a real one" 👑

---

🌸 NAME 🌸

struct cdx_driver — the CDX device driver struct, aka the personality sheet your driver has to fill out 🎀

---

🦋 SYNOPSIS 🦋

struct cdx_driver {
    struct device_driver driver;
    const struct cdx_device_id *match_id_table;
    int (*probe)(struct cdx_device *dev);
    int (*remove)(struct cdx_device *dev);
    void (*shutdown)(struct cdx_device *dev);
    void (*reset_prepare)(struct cdx_device *dev);
    void (*reset_done)(struct cdx_device *dev);
    bool driver_managed_dma;
};

---

💖 Members 💖

⭐ driver

the generic device driver, nestled in there like the base layer of the fit 🫶

⭐ match_id_table

the table of supported device matching Ids — basically the vibes list of which devices this driver is willing to be seen with 😌

⭐ probe

the function called when a device is added 👀 this is the "hi bestie, you're here!" moment

⭐ remove

the function called when a device is removed 😭 the goodbye handler, fr fr

⭐ shutdown

the function called at shutdown time to quiesce the device 💀 quiet it down, tuck it in, no more chaos

⭐ reset_prepare

the function called before is reset to notify driver — heads up before the reset happens, so the driver is never caught off guard 🙈

⭐ reset_done

the function called after reset is complete to notify driver — "okay bestie, we're back, you good?" ✨

⭐ driver_managed_dma

this one is the whole main character, listen up 🔥 the Device driver doesn't use kernel DMA API for DMA. For most device drivers, no need to care about this flag as long as all DMAs are handled through the kernel DMA API. For some special ones, for example VFIO drivers, they know how to manage the DMA themselves and set this flag so that the IOMMU layer will allow them to setup and manage their own I/O address space 👑

so lowkey: if all your DMA goes through the kernel DMA API, you can literally ignore this flag and go live your life 🌈 set it only if you're one of those special drivers that handles DMA on its own, iykyk

---

🧚 SEE ALSO 🧚

• Kernel file ./include/linux/cdx/cdx_bus.h
• CDX_DEVICE(9)
• CDX_DEVICE_DRIVER_OVERRIDE(9)
• struct cdx_ops(9)
• struct cdx_controller(9)
• struct cdx_device(9)
• __cdx_driver_register(9)
• cdx_driver_unregister(9)
• cdx_dev_reset(9)
• cdx_set_master(9)
• cdx_clear_master(9)
• cdx_enable_msi(9)
• cdx_disable_msi(9)

---

and that's the whole page, bestie, no cap 💜 this lil slice of the kernel API lives in ./include/linux/cdx and the version on deck is from October 2026 — go forth and register your drivers, slay 🎀✨🦋