i3c_master_get_free_addr(9)

📦 version 7.3.1, in nixpkgs unstable

💅 i3c_master_get_free_addr(9) — the Kernel API Manual page, bestie edition 🎀

okay so real talk: this is a page straight out of the Kernel API Manual and it's all about i3c_master_get_free_addr — aka the little function that goes "hiii, what addresses are free on this bus?" ✨ It lives over in ./drivers/i3c and the version/date tea gets spilled at the very bottom, don't worry 🫶

✨ NAME ✨

i3c_master_get_free_addr — get a free address on the bus 💖

like, literally its whole job. find a free one. slay.

🌸 SYNOPSIS 🌸

int i3c_master_get_free_addr (struct i3c_master_controller *master , u8
start_addr );

it gives you back an int, takes a struct i3c_master_controller *master and a u8 start_addr, and honestly that's the whole vibe check 🌈

🦋 ARGUMENTS 🦋

  • master — the I3C master object 👑 your main character, the one holding the bus
  • start_addr — where to start searching 🔍 like, from here onward bestie

💜 DESCRIPTION 💜

This function must be called with the bus lock held in write mode. no cap. that's not a suggestion, that's the rule 😭

it's giving "read the room before you touch the bus" — please hold the lock correctly or things get weird fr fr 💀

⭐ RETURN ⭐

it hands you back the first free address starting at start_addr (included) ✨ — yes, start_addr counts, it's not skipped, included means included — or, if there's genuinely no more address available, you get -ENOMEM and you just have to deal with that 🥲

🔥 SEE ALSO 🔥

the whole friend group, in ./drivers/i3c/master.c 💅:

and that's the whole page, bestie!! 🧚✨ this little icon dropped in October 2026, it's filed under ./drivers/i3c, and it goes by i3c_master_get_free_addr(9) — mwah, periodt 💋🎀

📦 where this page comes from