set_mode(9)

📦 version 7.3.1, in nixpkgs unstable

💅 set_mode — like, the tuner's whole personality switch

okay bestie, so this one's from the Kernel API Manual (section 9, the kernel API girlies ✨) and it's called set_mode. it's giving "one tiny function, one big vibe change." let's get into it 🎀

✨ SYNOPSIS ✨

int set_mode (struct tuner *t , enum v4l2_tuner_type mode );

that's it. that's the whole signature. short and iconic 👑

🫶 ARGUMENTS 🫶

  • t — a pointer to the module's internal struct_tuner. like, the tuner's whole self. its main character data structure 💖
  • mode — an enum v4l2_type, and it's either radio or TV. that's the vibe we're switching to, no in-between 🌸

🔥 DESCRIPTION 🔥

so here's the tea. set_mode switches the tuner over to another mode. dramatic? a little. necessary? absolutely.

the way it works is: if the tuner doesn't support the mode you're asking for (radio or TV), it prints a debug message and returns -EINVAL — and lowkey that's not all, because it also changes its state to standby. so it's like "no bestie, i can't do that" and then it just sits down 💀

otherwise — and this is the slay case — it changes the mode and returns 0. success. we love to see it. periodt 🌈

ngl, if you're getting -EINVAL back, check that your mode is actually one of the supported ones (radio or TV) before you start blaming the driver. the tuner's just being honest with you 🫶

👑 SEE ALSO 👑

everything else in this little kernel-family group chat, starting with the kernel file itself:

that's the whole squad, iykyk 💅

and that's the page, bestie 🦋 this little gem lives at ./drivers/media/v4l2-core, dated October 2026, and it's filed under set_mode(9) — so go forth and switch modes responsibly, mwah 💜✨

📦 where this page comes from