fwnode_prope...ference_args(9)

📦 version 7.3.1, in nixpkgs unstable

💅 fwnode_prope...ference_args(9) — a.k.a. fwnode_property_get_reference_args

okay bestie, welcome to the Kernel API Manual ✨ this one's a kernel function page, so grab your matcha and let's get into it 🍓

🌸 NAME 🌸

fwnode_property_get_reference_args — find a reference with arguments 🎀

✨ SYNOPSIS ✨

int fwnode_property_get_reference_args (const struct fwnode_handle
*fwnode , const char *prop , const char *nargs_prop , unsigned int nargs
, unsigned int index , struct fwnode_reference_args *args );

🫶 ARGUMENTS 🫶

  • fwnode — the firmware node we're snooping in for that reference 👀 like, this is the place we look.
  • prop — the name of the property, i.e. what we're actually looking for 💖
  • nargs_prop — the name of the property that tells you the number of arguments in the referred node. It's NULL if nargs is already known — otherwise nargs gets ignored completely 🙈
  • nargs — number of arguments. Lowkey ignored if nargs_prop is non-NULL, so don't come for it 💀
  • index — index of the reference, from zero onwards 🔢
  • args — result structure with the reference and the integer arguments. May be NULL, no pressure 🫶

💖 DESCRIPTION 💖

So what it does: it obtains a reference based on a named property in an fwnode, with integer arguments. That's the whole vibe ✨

⚠️ important: the caller is responsible for calling fwnode_handle_put on the returned args->fwnode pointer. Not me, not the kernel, you. Don't leave it hanging, that's not slay 💅

🔥 RETURN 🔥

  • 0 — on success, we ate 👑
  • -ENOENT — when the index is out of bounds, the index has an empty reference, or the property was not found 😭
  • -EINVAL — on parse error 💀
  • -ENOTCONN — when the remote firmware node exists but has not been registered yet 🙈

🦋 SEE ALSO 🦋

the kernel file lives at ./drivers/base/property.c — go look, iykyk 📁

that's the whole page, bestie, go be the main character in ./drivers/base 🧚 — Kernel API Manual, ./drivers/base, October 2026 💜 periodt. 🌈

📦 where this page comes from