fwnode_prop...ead_u8_array(9)

💖 fwnode_property_read_u8_array — the Kernel API Manual, bestie edition ✨

okay so this is fwnode_prop...ead_u8_array(9), from the Kernel API Manual, and no cap it's giving "grab a whole little array of tiny numbers out of a firmware node" energy. it's literally in the NAME section and everything 🎀

---

✨ NAME ✨

fwnode_property_read_u8_array — return a u8 array property of firmware node 🦋

---

🌸 SYNOPSIS 🌸

int fwnode_property_read_u8_array (const struct fwnode_handle *fwnode ,
const char *propname , u8 *val , size_t nval );

like… that's the whole signature, she's not complicated, she just has four arguments and a dream 💅

---

🎀 ARGUMENTS 🎀

• fwnode — the firmware node you wanna get the property of. that's your main character, the whole reason we're here 👑
• propname — name of the property. literally just the string bestie 🏷️
• val — the values get stored here. OR you can pass NULL if you just want the number of values back instead (iykyk) 🙈
• nval — size of the val array. don't lie to her about this one fr fr 📏

---

💀 DESCRIPTION 💀

so basically: read an array of u8 properties with propname from fwnode, and store them into val if they're found. that's it, that's the vibe ⭐

lowkey important note: it's recommended to call fwnode_property_count_u8 instead of calling this function with val equals NULL and nval equals 0. like yes you can do the other thing but the count function is right there and she's literally built for it 🧚

---

🔥 RETURN 🔥

what you get back, and it's giving ✨choose your own adventure✨:

• number of values if val was NULL 💖
• 0 if the property was found (success!) — slay 🌈
• -EINVAL if given arguments are not valid 🚫
• -ENODATA if the property does not have a value 😭
• -EPROTO if the property is not an array of numbers 💀
• -EOVERFLOW if the size of the property is not as expected 🫠
• -ENXIO if no suitable firmware interface is present 🙈

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/base/property.c

and the whole friend group, in order, no one left behind:

• device_property_present(9)
• fwnode_property_present(9)
• device_property_read_bool(9)
• fwnode_property_read_bool(9)
• device_property_read_u8_array(9)
• device_property_read_u16_array(9)
• device_property_read_u32_array(9)
• device_property_read_u64_array(9)
• device_property_read_string_array(9)
• device_property_read_string(9)
• device_property_match_string(9)
• fwnode_property_read_u16_array(9)
• fwnode_property_read_u32_array(9)
• fwnode_property_read_u64_array(9)
• fwnode_property_read_string_array(9)
• fwnode_property_read_string(9)
• fwnode_property_match_string(9)
• fwnode_property_match_property_string(9)
• fwnode_property_get_reference_args(9)
• fwnode_find_reference(9)
• fwnode_get_name(9)
• fwnode_get_name_prefix(9)
• fwnode_name_eq(9)
• fwnode_get_parent(9)
• fwnode_get_next_parent(9)
• fwnode_count_parents(9)
• fwnode_get_nth_parent(9)
• fwnode_get_next_child_node(9)
• fwnode_get_next_available_child_node(9)
• device_get_next_child_node(9)
• fwnode_get_named_child_node(9)
• device_get_named_child_node(9)
• fwnode_handle_get(9)
• fwnode_device_is_available(9)
• fwnode_get_child_node_count(9)
• fwnode_get_named_child_node_count(9)
• fwnode_get_phy_mode(9)
• device_get_phy_mode(9)
• fwnode_iomap(9)
• fwnode_irq_get(9)
• fwnode_irq_get_byname(9)
• fwnode_graph_get_next_endpoint(9)
• fwnode_graph_get_port_parent(9)
• fwnode_graph_get_remote_port_parent(9)
• fwnode_graph_get_remote_port(9)
• fwnode_graph_get_remote_endpoint(9)
• fwnode_graph_get_endpoint_by_id(9)
• fwnode_graph_get_endpoint_count(9)
• fwnode_graph_parse_endpoint(9)
• fwnode_connection_find_match(9)
• fwnode_connection_find_matches(9)

---

and that's the whole page, bestie 💜 this lil guy lives in ./drivers/base, the version/date stamp on her is October 2026, and she answers to fwnode_prop...ead_u8_array(9) if you ever need her 🫶✨