__media_entity_setup_link(9)

💅 NAME 💅

Okay bestie, you're reading __media_entity_setup_link(9) from the Kernel API Manual — and it's literally here to configure a media link without locking. Slay.

---

✨ SYNOPSIS ✨

int __media_entity_setup_link (struct media_link *link , u32 flags );

---

🎀 ARGUMENTS 🎀

• link — the link being configured. The one getting its little setup moment.
• flags — link configuration flags. Yes, the flags that tell the link how to behave.

---

🦋 DESCRIPTION 🦋

The bulk of link setup is handled by the two entities connected through the link. This function notifies both entities of the link configuration change. It's giving "middle friend passing the message along," but make it kernel.

If the link is immutable — rude — or if the current and new configuration are identical, it returns immediately. No drama, no extra work.

🚨 Important caveat, bestie: the user is expected to hold link->source->parent->mutex. If not, media_entity_setup_link should be used instead. No cap, that mutex detail matters.

---

🌈 SEE ALSO 🌈

The whole kernel friend group is here. Every single reference, periodt:

• Kernel file: ./include/media/media-entity.h
• enum media_gobj_type(9)
• struct media_gobj(9)
• struct media_entity_enum(9)
• struct media_graph(9)
• struct media_pipeline(9)
• struct media_pipeline_pad(9)
• struct media_pipeline_pad_iter(9)
• struct media_pipeline_entity_iter(9)
• struct media_link(9)
• enum media_pad_signal_type(9)
• struct media_pad(9)
• struct media_entity_operations(9)
• enum media_entity_type(9)
• struct media_entity(9)
• media_entity_for_each_pad(9)
• struct media_interface(9)
• struct media_intf_devnode(9)
• media_entity_id(9)
• media_type(9)
• media_id(9)
• media_gobj_gen_id(9)
• is_media_entity_v4l2_video_device(9)
• is_media_entity_v4l2_subdev(9)
• media_entity_enum_init(9)
• media_entity_enum_cleanup(9)
• media_entity_enum_zero(9)
• media_entity_enum_set(9)
• media_entity_enum_clear(9)
• media_entity_enum_test(9)
• media_entity_enum_test_and_set(9)
• media_entity_enum_empty(9)
• media_entity_enum_intersects(9)
• gobj_to_entity(9)
• gobj_to_pad(9)
• gobj_to_link(9)
• gobj_to_intf(9)
• intf_to_devnode(9)
• media_gobj_create(9)
• media_gobj_destroy(9)
• media_entity_pads_init(9)
• media_entity_cleanup(9)
• media_get_pad_index(9)
• media_create_pad_link(9)
• media_create_pad_links(9)
• media_entity_remove_links(9)
• media_entity_setup_link(9)
• media_entity_find_link(9)
• media_pad_remote_pad_first(9)
• media_pad_remote_pad_unique(9)
• media_entity_remote_pad_unique(9)
• media_entity_remote_source_pad_unique(9)
• media_pad_is_streaming(9)
• media_entity_is_streaming(9)
• media_entity_pipeline(9)
• media_pad_pipeline(9)
• media_entity_get_fwnode_pad(9)
• media_graph_walk_init(9)
• media_graph_walk_cleanup(9)
• media_graph_walk_start(9)
• media_graph_walk_next(9)
• media_pipeline_start(9)
• __media_pipeline_start(9)
• media_pipeline_stop(9)
• __media_pipeline_stop(9)
• media_pipeline_for_each_pad(9)
• media_pipeline_entity_iter_init(9)
• media_pipeline_entity_iter_cleanup(9)
• media_pipeline_for_each_entity(9)
• media_pipeline_alloc_start(9)
• media_devnode_create(9)
• media_devnode_remove(9)
• media_create_intf_link(9)
• __media_remove_intf_link(9)
• media_remove_intf_link(9)
• __media_remove_intf_links(9)
• media_remove_intf_links(9)
• media_entity_call(9)
• media_create_ancillary_link(9)
• __media_entity_next_link(9)
• for_each_media_entity_data_link(9)

---

Source spot: ./include/media · date stamp: October 2026 · that's the whole page, bestie — mwah 💋💖