hwspin_trylock_irqsave(9)

💖 hwspin_trylock_irqsave(9) 💖

okay bestie, welcome to the hwspin_trylock_irqsave(9) page from the Kernel API Manual ✨ this one is short, iconic, and very “try it, don’t wait around” energy.

🌸 NAME 🌸

hwspin_trylock_irqsave — try to lock an hwspinlock, disable interrupts 💅

🦋 SYNOPSIS 🦋

int hwspin_trylock_irqsave (struct hwspinlock *hwlock , unsigned long
       *flags );

🎀 ARGUMENTS 🎀

• hwlock — an hwspinlock which we want to trylock 👀
• flags — a pointer to where the caller's interrupt state will be saved at 💾

🔥 DESCRIPTION 🔥

This function attempts to lock the underlying hwspinlock, and will immediately fail if the hwspinlock is already locked. No waiting around, no drama, just instant “nope” energy 😭

Upon a successful return from this function, preemption and local interrupts are disabled (previous interrupts state is saved at flags), so the caller must not sleep, and is advised to release the hwspinlock as soon as possible. That part is important, bestie — do not sleep here, and let that lock go ASAP 🫶

Returns 0 if we successfully locked the hwspinlock, -EBUSY if the hwspinlock was already taken, and -EINVAL if hwlock is invalid. Periodt. 💅

🌈 SEE ALSO 🌈

Kernel file ./include/linux/hwspinlock.h — plus the whole hwspinlock friend group:

• hwspin_trylock_irq(9)
• hwspin_trylock_raw(9)
• hwspin_trylock_in_atomic(9)
• hwspin_trylock(9)
• hwspin_lock_timeout_irqsave(9)
• hwspin_lock_timeout_irq(9)
• hwspin_lock_timeout_raw(9)
• hwspin_lock_timeout_in_atomic(9)
• hwspin_lock_timeout(9)
• hwspin_unlock_irqrestore(9)
• hwspin_unlock_irq(9)
• hwspin_unlock_raw(9)
• hwspin_unlock_in_atomic(9)
• hwspin_unlock(9)

mwah 💋 this page lives under ./include/linux, dated October 2026, and it’s all about hwspin_trylock_irqsave(9). slay and stay locked — or at least try to ✨