v4l2_subdev_init_finalize(9)

💅 v4l2_subdev_init_finalize(9) — the Kernel API Manual, bestie edition ✨

okay so this is a page straight out of the Kernel API Manual, and it's about one function that ties the bow on your subdev setup. it's short, it's sweet, and it will absolutely bite you if you call it at the wrong time. let's get into it 🎀

---

🌸 NAME 🌸

v4l2_subdev_init_finalize — it finalizes the initialization of the subdevice. that's the whole vibe. the finishing touch. the last brush of highlighter ✨

---

🦋 SYNOPSIS 🦋

v4l2_subdev_init_finalize (sd );

yep that's it, one argument, no cap 💅

---

💖 ARGUMENTS 💖

• sd — the subdev. the one and only. your main character 🌟

---

👑 DESCRIPTION 👑

okay so here's the tea 🍓 — this function finalizes the initialization of the subdev, and that includes allocation of the active state for the subdev. so it's not just "yeah looks good, ship it", it's actually doing real work behind the scenes.

important!! this function must be called by the subdev drivers that use the centralized active state. not optional. not "if you feel like it". must. 😤

and the timing is everything, bestie — this is the whole vibe check of the page:

1. after the subdev struct has been initialized, and
2. after media_entity_pads_init has been called, but
3. before registering the subdev

so like, init the struct → media_entity_pads_init → this → register. in that order. don't get cute with it 🫶

💀 and one more thing, because cleanup is a whole personality trait: the user must call v4l2_subdev_cleanup when the subdev is being removed. you allocated, you clean up. that's the cycle. no leaks, no drama, periodt ✨

---

🌈 SEE ALSO 🌈

literally the entire subdev cinematic universe, iykyk 💜. the kernel file behind all of this lives at ./include/media/v4l2-subdev.h, struct and all — and here's every single sibling, no skips:

• v4l2_decode_vbi_line(9)
• enum v4l2_subdev_io_pin_bits(9)
• struct v4l2_subdev_io_pin_config(9)
• struct v4l2_subdev_core_ops(9)
• struct v4l2_subdev_tuner_ops(9)
• struct v4l2_subdev_audio_ops(9)
• struct v4l2_mbus_frame_desc_entry_csi2(9)
• enum v4l2_mbus_frame_desc_flags(9)
• struct v4l2_mbus_frame_desc_entry(9)
• enum v4l2_mbus_frame_desc_type(9)
• struct v4l2_mbus_frame_desc(9)
• enum v4l2_subdev_pre_streamon_flags(9)
• struct v4l2_subdev_video_ops(9)
• struct v4l2_subdev_vbi_ops(9)
• struct v4l2_subdev_sensor_ops(9)
• enum v4l2_subdev_ir_mode(9)
• struct v4l2_subdev_ir_parameters(9)
• struct v4l2_subdev_ir_ops(9)
• struct v4l2_subdev_pad_config(9)
• struct v4l2_subdev_stream_configs(9)
• struct v4l2_subdev_krouting(9)
• struct v4l2_subdev_state(9)
• struct v4l2_subdev_pad_ops(9)
• struct v4l2_subdev_ops(9)
• struct v4l2_subdev_internal_ops(9)
• struct v4l2_subdev_platform_data(9)
• struct v4l2_subdev(9)
• media_entity_to_v4l2_subdev(9)
• vdev_to_v4l2_subdev(9)
• struct v4l2_subdev_fh(9)
• to_v4l2_subdev_fh(9)
• v4l2_set_subdevdata(9)
• v4l2_get_subdevdata(9)
• v4l2_set_subdev_hostdata(9)
• v4l2_get_subdev_hostdata(9)
• v4l2_subdev_get_fwnode_pad_1_to_1(9)
• v4l2_subdev_link_validate_default(9)
• v4l2_subdev_link_validate(9)
• v4l2_subdev_has_pad_interdep(9)
• __v4l2_subdev_state_alloc(9)
• __v4l2_subdev_state_free(9)
• v4l2_subdev_cleanup(9)
• v4l2_subdev_state_get_format(9)
• v4l2_subdev_state_get_crop(9)
• v4l2_subdev_state_get_compose(9)
• v4l2_subdev_state_get_interval(9)
• v4l2_subdev_get_fmt(9)
• v4l2_subdev_get_frame_interval(9)
• v4l2_subdev_set_routing(9)
• for_each_active_route(9)
• v4l2_subdev_set_routing_with_fmt(9)
• v4l2_subdev_routing_find_opposite_end(9)
• v4l2_subdev_state_get_opposite_stream_format(9)
• v4l2_subdev_state_xlate_streams(9)
• enum v4l2_subdev_routing_restriction(9)
• v4l2_subdev_routing_validate(9)
• v4l2_subdev_enable_streams(9)
• v4l2_subdev_disable_streams(9)
• v4l2_subdev_s_stream_helper(9)
• __v4l2_subdev_get_frame_desc_passthrough(9)
• v4l2_subdev_get_frame_desc_passthrough(9)
• v4l2_subdev_lock_state(9)
• v4l2_subdev_unlock_state(9)
• v4l2_subdev_lock_states(9)
• v4l2_subdev_unlock_states(9)
• v4l2_subdev_get_unlocked_active_state(9)
• v4l2_subdev_get_locked_active_state(9)
• v4l2_subdev_lock_and_get_active_state(9)
• v4l2_subdev_init(9)
• v4l2_subdev_call(9)
• v4l2_subdev_call_state_active(9)
• v4l2_subdev_call_state_try(9)
• v4l2_subdev_has_op(9)
• v4l2_subdev_notify_event(9)
• v4l2_subdev_is_streaming(9)

like i said. the whole universe. go read them, i'll wait 🧚

---

🎀 sign-off 🎀

this lil page comes to you from the source at ./include/media, dated October 2026 — so you know it's fresh 🌸. now go finalize that subdev, call v4l2_subdev_cleanup later like a responsible icon, and remember: init, pads init, finalize, register. in that order. slay 💅💖✨🦋