snd_hda_jack_add_kctl_mst(9)

📦 version 7.3.1, in nixpkgs unstable

💅 snd_hda_jack_add_kctl_mst(9) — like, the Kernel API Manual one, bestie 🎀

okay so real talk, the manual page name is snd_hda_jack_add_kctl_mst(9) and it lives in the Kernel API Manual, which is genuinely such a serve. it's giving "small function, big responsibilities" energy and i'm obsessed. let's get into it ✨

🌸 NAME 🌸

snd_hda_jack_add_kctl_mst — add a kctl for the given pin 🎧

literally what it says on the tin. you hand it a pin, it hands you back a kctl. periodt.

✨ SYNOPSIS ✨

int snd_hda_jack_add_kctl_mst (struct hda_codec *codec , hda_nid_t nid ,
int dev_id , const char *name , bool phantom_jack , int type , const
struct hda_jack_keymap *keymap );

that's the whole signature, no notes. returns an int, takes seven things, we love a generous parameter list 💖

🫶 ARGUMENTS 🫶

okay so here's the rundown on every single thing you can pass in, and no we are not skipping any of them:

  • codec — the HDA codec. like, the main character of this whole operation 🌟
  • nid — the pin NID you're assigning. it's the pin's whole identity, lowkey.
  • dev_id — the pin device entry id. yes, there's more than one id involved. don't ask, just pass it 🫠
  • name — a string name for the jack. give it a cute name, or at least a correct one 💅
  • phantom_jack — a flag that says "deal with this as a phantom jack". spooky 👻 but functional.
  • type — the jack type bits to be reported. and listen: 0 means guess from pincfg, so if you don't know, you actually do know, you just pass 0 💡
  • keymap — optional jack / key mapping. optional!! so you can absolutely just not 🌸

🦋 DESCRIPTION 🦋

so what does it actually do? it assigns a jack-detection kctl to the given pin. that's the whole vibe check, and it passes ✅

the kcontrol will have the given name and index. that's the tea. named and indexed, iconic behavior honestly, no cap 🔥

👑 SEE ALSO 👑

here's the friend group — the whole squad, every single reference, not a single one left behind 🫶:

ok quick vibe check before you go: every one of those is a real reference from the original page, so go read them if you actually need them. i'm just the hype girl, not the kernel source 💀

and that's the page bestie!! sign-off time: this whole thing lives under ./sound/hda/common, dated October 2026, and it's page snd_hda_jack_add_kctl_mst(9) of the Kernel API Manual. mwah, go detect some jacks 💋🌈🌸

📦 where this page comes from