snd_interval_list(9)

💖 snd_interval_list(9) — the Kernel API Manual page, bestie edition 💖

okay so this is a page from the Kernel API Manual, and no, it's not about that kind of interval — it's about audio parameter intervals in the kernel, and honestly? it's kind of iconic.

---

✨ NAME ✨

snd_interval_list — refine the interval value from the list

like, it takes your interval and makes it make sense against a list of allowed values. that's the whole gig.

---

🎀 SYNOPSIS 🎀

int snd_interval_list (struct snd_interval *i , unsigned int count ,
const unsigned int *list , unsigned int mask );

---

🦋 ARGUMENTS 🦋

• i — the interval value to refine. this is the main character, the one getting a glow-up.
• count — the number of elements in the list. yes bestie, you gotta tell it how long your list is, it's not gonna count for you.
• list — the value list. the actual vibes we're picking from.
• mask — the bit-mask to evaluate. this is the little filter that decides which list entries get to show up to the party.

---

🌸 DESCRIPTION 🌸

So it refines the interval value from the list. That's the whole thing — it takes your interval and tightens it up against the values you handed it. no cap.

and here's the little detail that matters: when mask is non-zero, only the elements corresponding to bit 1 are evaluated. so like, the elements whose bit is 0? they're not invited. they're not even in the group chat. only the bit-1 girlies get evaluated. 💅

---

⭐ RETURN ⭐

• Positive if the value is changed — slay, something moved.
• zero if it's not changed — nothing happened, and that's valid too.
• a negative error code — 😭 something went wrong bestie, check it.

---

👑 SEE ALSO 👑

okay this is the long part and I'm not skipping any of it because every single one of these deserves their mention. periodt.

• Kernel file ./sound/core/pcm_lib.c
• snd_pcm_set_ops(9)
• snd_pcm_set_sync_per_card(9)
• snd_interval_refine(9)
• snd_interval_div(9)
• snd_interval_muldivk(9)
• snd_interval_mulkdiv(9)
• snd_interval_ratnum(9)
• snd_interval_ratden(9)
• snd_interval_ranges(9)
• snd_pcm_hw_rule_add(9)
• snd_pcm_hw_constraint_mask(9)
• snd_pcm_hw_constraint_mask64(9)
• snd_pcm_hw_constraint_integer(9)
• snd_pcm_hw_constraint_minmax(9)
• snd_pcm_hw_constraint_list(9)
• snd_pcm_hw_constraint_ranges(9)
• snd_pcm_hw_constraint_ratnums(9)
• snd_pcm_hw_constraint_ratdens(9)
• snd_pcm_hw_constraint_msbits(9)
• snd_pcm_hw_constraint_step(9)
• snd_pcm_hw_constraint_pow2(9)
• snd_pcm_hw_rule_noresample(9)
• snd_pcm_hw_param_value(9)
• snd_pcm_hw_param_first(9)
• snd_pcm_hw_param_last(9)
• snd_pcm_hw_params_bits(9)
• snd_pcm_lib_ioctl(9)
• snd_pcm_period_elapsed_under_stream_lock(9)
• snd_pcm_period_elapsed(9)
• snd_pcm_add_chmap_ctls(9)

---

and that's the page!! 🫶

cute little sign-off to close it out: this one lives over in ./sound/core (the directory, bestie — that's where the source is at), and it's dated October 2026. the manual page itself is literally called snd_interval_list(9), which — yeah — we been knew. 💜✨