nau8825_sema_acquire(9)

📦 version 7.3.1, in nixpkgs unstable

💅 nau8825_sema_acquire(9)

okay bestie, welcome to the Kernel API Manual ✨ — this is the page for nau8825_sema_acquire, and yes she's a real one. grab a boba, we're getting into semaphores 🧚

🌸 NAME 🌸

nau8825_sema_acquire — acquire the semaphore of nau88l25 🎀

(not the codec registering, not the jack detecting — the semaphore. main character energy tbh.)

✨ SYNOPSIS ✨

int nau8825_sema_acquire (struct nau8825 *nau8825 , long timeout );

literally that's it. two args, one int back. slay. 💅

🦋 ARGUMENTS 🦋

  • nau8825 — the component you're registering the codec private data with 🫶
  • timeout — how long, in jiffies, to wait before failure… or 0 to wait until release 😭 (yes, zero means forever-ish, choose wisely bestie)

🔥 DESCRIPTION 🔥

okay so. this function attempts to acquire the semaphore with a number of jiffies ⏳

if no more tasks are allowed to acquire the semaphore, calling this function will put the task to sleep 😴 like fr fr, it just tucks it in.

if the semaphore is not released within the specified number of jiffies, this function returns. 🫠

if the semaphore is not released within the specified number of jiffies, this function returns -ETIME. ⏰ (she said it twice, and honestly? iconic. we're keeping both, no notes.)

if the sleep is interrupted by a signal, this function will return -EINTR 🌩️

and it returns 0 if the semaphore was acquired successfully 👑 periodt.

then there's this next bit, and we're including it verbatim-in-spirit because it's on the page, bestie:

acquires the semaphore without jiffies. try to acquire the semaphore atomically. ⚡ returns 0 if the semaphore has been acquired successfully, or 1 if it cannot be acquired 🙈

lowkey read that twice — 0 still means "got it", but out here 1 means "nope, couldn't get it", and that is not the same convention as the jiffies version above. vibe check your return values, seriously 💀

🌈 SEE ALSO 🌈

kernel file ./sound/soc/codecs/nau8825.c and her whole friend group 🫶

and that's the whole page 💖

this lil beauty lives down in ./sound/soc/codecs, straight outta the Kernel API Manual, dated October 2026, and she answers to nau8825_sema_acquire(9) 🎀 go get that semaphore bestie, ily, bye 🦋💜

📦 where this page comes from