of_hwspin_lo...et_id_byname(9)

💅 of_hwspin_lock_get_id_byname 💅

okay bestie, welcome to the Kernel API Manual — yes, that's the manual name, we're fancy here ✨ — and today's main character is of_hwspin_lock_get_id_byname, a function whose name is honestly longer than my attention span but we're gonna slay it anyway 🎀

---

✨ NAME ✨

of_hwspin_lock_get_id_byname — get the lock id for a specified hwlock name 🫶

Like, you give it a name, it gives you the id. Matchmaking, but for hardware locks 💖

---

🦋 SYNOPSIS 🦋

int of_hwspin_lock_get_id_byname (struct device_node *np , const char
       *name );

the way it returns an int and takes two args… iconic, lowkey ✨

---

🌸 ARGUMENTS 🌸

• np — the device node you're requesting the specific hwlock from 🌈 (yes, the device node, not just any node, don't be messy)
• name — the hwlock name, literally just the name, that's her whole job 💅

---

💜 DESCRIPTION 💜

okay so here's the vibe: this function is a whole means for DT users of the hwspinlock module 👑

It lets them get the global lock id of a specific hwspinlock by using the specified name of the hwspinlock device — so that afterwards it can be requested using the normal hwspin_lock_request_specific API 🔥 like, it's the little matchmaker that gets you the id so the real API can do the actual requesting. no cap.

---

😭 RETURN 😭

• the global lock id number on success 🎉 (slay)
• -EPROBE_DEFER if the hwspinlock device is not yet registered 🙈 (she's just not ready yet, give her a sec)
• -EINVAL on invalid args specifier value 💀 (you gave her nonsense, she's telling you)
• or an appropriate error as returned from the OF parsing of the DT client node 🫶 (whatever the OF parsing hands back, you get — fr fr)

---

👑 SEE ALSO 👑

Kernel file ./drivers/hwspinlock/hwspinlock_core.c — go read it, iykyk 📖

• __hwspin_trylock(9)
• __hwspin_lock_timeout(9)
• __hwspin_unlock(9)
• hwspin_lock_bust(9)
• of_hwspin_lock_simple_xlate(9)
• of_hwspin_lock_get_id(9)
• hwspin_lock_register(9)
• hwspin_lock_unregister(9)
• devm_hwspin_lock_unregister(9)
• devm_hwspin_lock_register(9)
• __hwspin_lock_request(9)
• hwspin_lock_request_specific(9)
• hwspin_lock_free(9)
• devm_hwspin_lock_free(9)
• devm_hwspin_lock_request_specific(9)

like, the whole friend group, honestly 🧚💖

---

okay that's the whole page bestie, no notes 💅 and for the cute sign-off: this one lives in ./drivers/hwspinlock, dated October 2026, and yes it still goes by of_hwspin_lo...et_id_byname(9) because the header had to truncate it and honestly? relatable 🍓✨ bye!! 🎀