ssam_get_controller(9)

✨ ssam_get_controller ✨

okay so this one's from the Kernel API Manual and honestly bestie it's short and sweet and absolutely iconic for it 💅

🌸 SYNOPSIS 🌸

struct ssam_controller * ssam_get_controller (void );

🎀 ARGUMENTS 🎀

• void — literally no arguments. nada. zero. nothing to pass in, bestie 🫶

💖 DESCRIPTION 💖

So what this does is it hands you back a reference to the SSAM controller of the system. and like… it can totally return NULL instead, if:

• there isn't one at all,
• it hasn't been set up yet, or
• it has already been unregistered 🙈

And here's the part you actually need to remember, no cap: this function automatically increments the reference count of the controller. so the calling party must make sure ssam_controller_put gets called once they don't need the controller anymore. like, that's on you, bestie, that's your responsibility 🔥 don't leave it hanging, it's giving leak energy otherwise 💀

🦋 SEE ALSO 🦋

• Kernel file ./drivers/platform/surface/aggregator/core.c
• ssam_try_set_controller(9)
• ssam_clear_controller(9)
• ssam_client_link(9)
• ssam_client_bind(9)

⭐ reminder: grab the controller → get a refcount bump → put it back when you're done. main character resource management, periodt 👑

that's the whole vibe from ./drivers/platform/surface/agg... — October 2026 edition. mwah, go forth and put your controllers, bestie 💜✨