BUS_GENERIC_SHUTDOWN(9)

💖 BUS_GENERIC_SHUTDOWN 💖

okay bestie, so this is a page from the Kernel Developer's Manual — yes it's giving very serious grown-up kernel energy but we're gonna make it cute anyway, because you deserve to understand it 🫶

✨ NAME ✨

bus_generic_shutdown — the generic implementation of DEVICE_SHUTDOWN for buses. literally the plug-and-play version, no cap 💅

🌸 SYNOPSIS 🌸

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

int
bus_generic_shutdown(device_t dev);

so you pull in those two headers and then you've got a function that takes one device_t named dev and hands you back an int. that's it. that's the whole vibe check ✨

🎀 DESCRIPTION 🎀

okay so here's the tea 🍓

This function provides an implementation of the DEVICE_SHUTDOWN(9) method which can be used by most bus code.

and when I say it provides an implementation, bestie, I mean it's the low-effort icon — it doesn't do anything fancy. It simply calls the DEVICE_SHUTDOWN(9) method of each child device attached to the bus.

like, that's literally the whole job. it goes down the list of every child device hanging off that bus and tells each one "hey, we're shutting down, do your thing" 💀 one by one. no drama, no extra steps, just delegation. main character energy but for buses 🌈

👑 RETURN VALUES 👑

Zero is returned on success, otherwise an appropriate error is returned.

translation: 0 means we ate and everything's fine 💅 anything else means something went sideways and you're getting an error back instead. not me being vague about which error — the page says "an appropriate error", so that's what we're saying, periodt.

🦋 SEE ALSO 🦋

• device(9)
• driver(9)

go read those too, iykyk, they're the supporting cast and they're iconic in their own right 💜

🌟 AUTHORS 🌟

This manual page was written by Doug Rabson. shoutout Doug, absolute legend, we love a kernel dev who documents their work 🫶✨

and that's the whole page bestie, you're officially caught up 💖 go forth and shut down some buses (responsibly!!) 🚌💨

Debian • January 15, 2017 • BUS_GENERIC_SHUTDOWN(9) — mwah, bye!! 😭💕