spi_bus_lock(9)

📦 version 7.3.1, in nixpkgs unstable

💅 spi_bus_lock(9) — the Kernel API Manual glow-up

okay so bestie, welcome to spi_bus_lock — the function that says "this SPI bus is mine" and means it. Sit down, we're gonna talk about exclusive access 🎀

✨ NAME ✨

spi_bus_lock — obtain a lock for exclusive SPI bus usage. periodt, that's the whole vibe 🔥

🌸 SYNOPSIS 🌸

int spi_bus_lock (struct spi_controller *ctlr );

🦋 ARGUMENTS 🦋

  • ctlr — the SPI bus controller that should be locked for exclusive bus access. like, the whole bus. not sharing, not "just for a sec", exclusive 💅

🧚 CONTEXT 🧚

can sleep 😴

that's it, that's the context line. she naps.

💖 DESCRIPTION 💖

okay so here's the tea ☕ — this call may only be used from a context that may sleep. the sleep is non-interruptible, and has no timeout. so if you're lying to yourself about what context you're in... bestie, no. 😭

this call should be used by drivers that require exclusive access to the SPI bus. no cap, that's the whole point of her.

the SPI bus must be released by a spi_bus_unlock call when the exclusive access is over — do not just walk away and ghost the bus, that's not the move 🙈

and while the SPI bus lock is held, data transfer must be done by spi_sync_locked and spi_async_locked calls. like, those two specifically. not the regular ones. iykyk 🌈

⭐ RETURN ⭐

always zero. every time. she is consistent, she is unbothered, she is iconic 👑

💜 SEE ALSO 💜

the full extended universe, fr fr — kernel file ./drivers/spi/spi.c plus these legends:

🫶 and that's the page!! this lil gem lives in ./drivers/spi and the version on deck is October 2026 — so go forth, lock that bus, unlock it when you're done, and slay 💅✨🍓

📦 where this page comes from