STRUCT V4L2_FH(9)

struct v4l2_fh(9) — Kernel API Manual ✨

🌸 NAME 🌸

struct v4l2_fh — describes a V4L2 file handler, bestie. That's the whole vibe 💅

✨ SYNOPSIS ✨

struct v4l2_fh {
    struct list_head        list;
    struct video_device     *vdev;
    struct v4l2_ctrl_handler *ctrl_handler;
    enum v4l2_priority      prio;
    wait_queue_head_t wait;
    struct mutex            subscribe_lock;
    struct list_head        subscribed;
    struct list_head        available;
    unsigned int            navailable;
    u32 sequence;
    struct v4l2_m2m_ctx     *m2m_ctx;
 };

🎀 Members 🎀

• list — list of file handlers. It's giving "the group chat roster" energy 🫶
• vdev — pointer to struct video_device, no cap.
• ctrl_handler — pointer to struct v4l2_ctrl_handler, iconic.
• prio — priority of the file handler, as defined by enum v4l2_priority. Main character priority settings, literally 💅
• wait — event's wait queue. The event is waiting here, iykyk 🦋
• subscribe_lock — serialises changes to the subscribed list; guarantees that the add and del event callbacks are orderly called. Very "keep the group chat drama in order" of it 🔥
• subscribed — list of subscribed events. Obsessed with a curated list ✨
• available — list of events waiting to be dequeued. They're lined up and ready 🎀
• navailable — number of available events at available list. Math but make it cute 🔢
• sequence — event sequence number. Order matters, periodt 🌈
• m2m_ctx — pointer to struct v4l2_m2m_ctx. We love a context pointer 💜

👑 SEE ALSO 👑

Kernel file ./include/media/v4l2-fh.h is the place to be 💖, and the whole squad is: file_to_v4l2_fh(9), v4l2_fh_init(9), v4l2_fh_add(9), v4l2_fh_open(9), v4l2_fh_del(9), v4l2_fh_exit(9), v4l2_fh_release(9), v4l2_fh_is_singular(9), v4l2_fh_is_singular_file(9). Go check 'em, bestie 🧚

Okay that's the whole page 💖. This one came from source/version ./include/media, dated October 2026, and the manual page is struct v4l2_fh(9) — she ate, fr fr 🫶🌸