media_entity_get_fwnode_pad(9)

👑 NAME 👑

media_entity_get_fwnode_pad(9) — Get pad number from fwnode. This icon is from the Kernel API Manual, and she's here to help you find the right pad without losing your whole entire mind 💅✨

🎀 SYNOPSIS 🎀

int media_entity_get_fwnode_pad (struct media_entity *entity , const
       struct fwnode_handle *fwnode , unsigned long direction_flags );

💅 ARGUMENTS 💅

• entity — The entity. That's the main character here.
• fwnode — Pointer to the fwnode_handle which should be used to find the pad. This is the little clue that helps you track it down 🔍
• direction_flags — Expected direction of the pad, as defined in :ref: for include/uapi/linux/media.h (<media_header>) — seek for MEDIA_PAD_FL_* 💫

🌸 DESCRIPTION 🌸

okay so bestie, this function can be used to resolve the media pad number from a fwnode. It's genuinely useful for devices which use more complex mappings of media pads — like when the pad situation is giving "custom layout" and not "one-size-fits-all" 🦋

If the entity does not implement the get_fwnode_pad operation then this function searches the entity for the first pad that matches the direction_flags. Lowkey a fallback queen 👑

💖 RETURN 💖

returns the pad number on success or a negative error code. So on success you get the pad number, and on failure you get a negative error code — no cap, that's the whole vibe check 😭

🦋 SEE ALSO 🦋

The whole extended media family is in the group chat too:

• 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_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_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)

okay bestie, that's the whole page 💖 this one lives in ./include/media, stamped October 2026, and it's media_entity_get_fwnode_pad(9) signing off 🎀✨