fwnode_grap...dpoint_by_id(9)

📦 version 7.3.1, in nixpkgs unstable

💅 fwnode_grap...dpoint_by_id(9) 💅

okay so bestie, welcome to the Kernel API Manual — yes that's the whole manual name, we're in the big leagues now 🎀 — and today's main character is fwnode_graph_get_endpoint_by_id. Let's get into it, no cap.

✨ NAME ✨

fwnode_graph_get_endpoint_by_id — literally just "get endpoint by port and endpoint numbers" 💖 like it says on the tin, she's not hiding anything.

🌸 SYNOPSIS 🌸

struct fwnode_handle * fwnode_graph_get_endpoint_by_id (const struct
fwnode_handle *fwnode , u32 port , u32 endpoint , unsigned long flags );

that's the whole signature, copy it exactly, don't get creative with it 🙈

🦋 ARGUMENTS 🦋

  • fwnode — the parent fwnode_handle that's holding the graph, aka the whole friend group this endpoint lives in 🫶
  • port — the identifier of the port node, so like which port we're sliding into (respectfully) 💅
  • endpoint — the identifier of the endpoint node sitting under that port node, the actual one you want 👑
  • flags — the fwnode lookup flags, the little switches that change how the search behaves ⭐

🔥 DESCRIPTION 🔥

first things first, and this is important so listen up: the caller is responsible for calling fwnode_handle_put on the returned fwnode pointer. that's on you, bestie, not on the function. cleanup is your job 🧹✨

now, the cute part. if FWNODE_GRAPH_ENDPOINT_NEXT is passed in flags and the endpoint you asked for hasn't been found, she doesn't just give up — she goes looking for the closest endpoint ID greater than the specified one and returns the endpoint that corresponds to it, if present. it's giving "next best thing" energy 💖

and here's the vibe check: she does not return endpoints that belong to disabled devices, or endpoints that are unconnected — unless, that is, FWNODE_GRAPH_DEVICE_DISABLED is passed in flags. then the doors open 🚪✨

👑 RETURN 👑

she returns the fwnode handle of the local endpoint corresponding to your port and endpoint IDs 🎯 …or NULL if it's not found 😭 that's it, that's the whole deal.

🌈 SEE ALSO 🌈

the whole extended universe, fr fr — starting with the kernel file ./drivers/base/property.c:

💜 okay that's the whole page, go read the graph code, and don't forget the fwnode_handle_put or I will find out 🫶

and that's a wrap, babe 💅 this little masterpiece lives in ./drivers/base and it's stamped October 2026 — slay, iconic, periodt ✨🌸🦋

📦 where this page comes from