__v4l2_ctrl_s_ctrl_compound(9)

📦 version 7.3.1, in nixpkgs unstable

💅 __v4l2_ctrl_s_ctrl_compound — the unlocked version that sets a compound control 💅

okay so bestie, welcome to the kernel API manual, this page lives under ./include/media and it's all about __v4l2_ctrl_s_ctrl_compound. yes the double-underscore is on purpose, she's the ✨backstage✨ version, iykyk.

🌸 NAME 🌸

__v4l2_ctrl_s_ctrl_compound — the unlocked variant of the set-compound-control saga. she does the same job as her public cousin but assumes you already hold the lock, because you're a brave little coder inside the framework 🫶

🦋 SYNOPSIS 🦋

int __v4l2_ctrl_s_ctrl_compound (struct v4l2_ctrl *ctrl , enum
v4l2_ctrl_type type , const void *p );

three args, one int back. that's the whole vibe check 💫

🎀 ARGUMENTS 🎀

  • ctrl — the control in question. like, the control. the main character of this function 👑
  • type — the type of the data. be honest about it, bestie, no cap.
  • p — the new compound payload. this is the fresh content you're pushing in 💖

🌈 DESCRIPTION 🌈

so here's the tea 🍵 — this function sets the control's new compound payload safely, and the way it does that is by going through the control framework instead of yeeting raw values at the hardware. icon behavior. it's giving responsible.

the big caveat (and this is the whole reason for the leading underscores): this function assumes the control's handler is already locked. that's not a suggestion, that's the deal. the upside? because it doesn't lock for you, it's safe to use from within the v4l2_ctrl_ops functions — the places where you'd already be holding that lock and grabbing it again would be a whole mess 😭

⚠️ pls do not call this thinking it'll lock stuff for you. it will not. you must already hold the handler lock. fr fr.

also, and this is important: this function is for compound type controls only. do not come at her with a plain int, she will not know what to do with it 💀

⭐ SEE ALSO ⭐

the whole extended friend group, no one gets left out 🫶 — starting with the kernel file ./include/media/v4l2-ctrls.h:

that's the whole page bestie, go forth and set your compound controls safely 💜

mwah 💋 — this gem is from ./include/media, dated October 2026, and the manual page title stays __v4l2_ctrl_s_ctrl_compound(9) in case you need to cite her in a commit message 🎀

📦 where this page comes from