v4l2_fwnode_parse_link(9)

💅 v4l2_fwnode_parse_link(9) — like, the Kernel API Manual, bestie ✨

okay so picture this: you're deep in the kernel, you're in the Kernel API Manual, and you need to actually understand v4l2_fwnode_parse_link. Don't panic 🫶 — it's honestly not that deep, and I'm gonna walk you through it like we're texting at 2am.

---

✨ NAME ✨

v4l2_fwnode_parse_link — it parses a link between two endpoints. that's it, that's the whole vibe 🌸

---

🎀 SYNOPSIS 🎀

int v4l2_fwnode_parse_link (struct fwnode_handle *fwnode , struct
       v4l2_fwnode_link *link );

---

🦋 ARGUMENTS 🦋

• fwnode — pointer to the endpoint's fwnode at the local end of the link. yes, local — this is your side of the conversation 💬
• link — pointer to the V4L2 fwnode link data structure. this is the little container that's about to get filled up, main character energy fr 🔥

---

👑 DESCRIPTION 👑

So what does it actually do? It fills the link structure with the local and remote nodes and port numbers. Boom, done, slay ✨

The local_node and remote_node fields get set to point to the local and remote port's parent nodes respectively 💖 — and here's the fine print, so listen up:

the port parent node is the parent node of the port node if that node isn't a 'ports' node, or the grand-parent node of the port node otherwise.

iykyk 😌

Also, lowkey important: a reference is taken to both the local and remote nodes, so the caller must use v4l2_fwnode_put_link to drop the references when done with the link. not optional, bestie — clean up after yourself 🧹💅

---

⭐ RETURN ⭐

• 0 on success 🌈
• -ENOLINK if the remote endpoint fwnode can't be found 😭 (it's giving "where is she")

---

🌸 SEE ALSO 🌸

okay this list is long but every single one of these is iconic in her own way, no skipping 👑

• Kernel file ./include/media/v4l2-fwnode.h — go read the source, it's literally right there 📖
• struct v4l2_fwnode_endpoint(9)
• V4L2_FWNODE_PROPERTY_UNSET(9)
• enum v4l2_fwnode_orientation(9)
• struct v4l2_fwnode_device_properties(9)
• struct v4l2_fwnode_link(9)
• enum v4l2_connector_type(9)
• struct v4l2_connector_link(9)
• struct v4l2_fwnode_connector_analog(9)
• struct v4l2_fwnode_connector(9)
• enum v4l2_fwnode_bus_type(9)
• v4l2_fwnode_endpoint_parse(9)
• v4l2_fwnode_endpoint_free(9)
• v4l2_fwnode_endpoint_alloc_parse(9)
• v4l2_fwnode_put_link(9)
• v4l2_fwnode_connector_free(9)
• v4l2_fwnode_connector_parse(9)
• v4l2_fwnode_connector_add_link(9)
• v4l2_fwnode_device_parse(9)

---

and that's the page!! 🎀 this lil beauty lives in ./include/media, dated October 2026, and it's brought to you by the one and only v4l2_fwnode_parse_link(9) 🦋💜 stay hydrated, drop your references with v4l2_fwnode_put_link, and go be the main character of your own fwnode graph ✨💅