hwspin_trylock_irq(9)

📦 version 7.3.1, in nixpkgs unstable

💅 hwspin_trylock_irq — the kernel API manual, bestie edition ✨

okay so real talk, this page is from the kernel API manual and it's all about hwspin_trylock_irq(9) — no cap, that's the whole vibe 🎀

✨ NAME ✨

hwspin_trylock_irq — bestie's whole job is try to lock an hwspinlock, disable interrupts. that's it. that's the gig 💅

🌸 SYNOPSIS 🌸

int hwspin_trylock_irq (struct hwspinlock *hwlock );

it's giving "one function, one argument, one int coming back at you" 🦋

🎀 ARGUMENTS 🎀

  • hwlock — an hwspinlock which we want to trylock. yes girl, *try*lock, the name literally told you 🙈 this is the lock you're shooting your shot at.

💖 DESCRIPTION 💖

so here's the tea ☕ — this function attempts to lock the underlying hwspinlock, and it will immediately fail if the hwspinlock is already locked. no waiting, no queuing, no "give me a sec", it's a hard no and it moves on. periodt.

upon a successful return from this function, preemption and local interrupts are disabled, so the caller must not sleep 😴🚫 — like genuinely do not, that's not a suggestion — and you're advised to release the hwspinlock as soon as possible. in and out, quick little visit, main character energy but make it brief ⚡

returns 0 if we successfully locked the hwspinlock, -EBUSY if the hwspinlock was already taken (somebody else got there first 😭), and -EINVAL if hwlock is invalid. three outcomes, all iconic, all documented 💀

🦋 SEE ALSO 🦋

kernel file ./include/linux/hwspinlock.h — go read it, iykyk 📖

the whole friend group 💜:

✨ and that's a wrap, bestie ✨ this little gem lives in ./include/linux, stamped October 2026, and it answers to the name hwspin_trylock_irq(9) 🫶 go forth and trylock responsibly 💖

📦 where this page comes from