pinctrl_par...ex_with_args(9)

💅 pinctrl_parse_index_with_args — from the Kernel API Manual, section 9 🎀

okay so bestie, buckle up, because we're diving into pinctrl_parse_index_with_args(9) and honestly? she's a little niche but she serves. 💖

---

✨ NAME ✨

pinctrl_parse_index_with_args — literally just "find a node pointed by index in a list". that's the whole gig. main character energy but make it a lookup function. 🦋

---

🌸 SYNOPSIS 🌸

int pinctrl_parse_index_with_args (const struct device_node *np ,
                                   const char *list_name ,
                                   int index ,
                                   struct of_phandle_args *out_args );

yeah she takes four args and returns an int, no cap. 💅

---

🧚 ARGUMENTS 🧚

• np — pointer to device node with the property. like, the device node that's holding the thing you want. 🫶
• list_name — property that contains the list. yes, the actual list. she's a const char *, be normal about it. ✨
• index — index within the list. you point at which one you want, an int ofc. ⭐
• out_args — entries in the list pointed by index. this is where the good stuff gets dropped, a struct of_phandle_args *. 🎀

---

🔥 DESCRIPTION 🔥

so what does she do? she finds the selected element in a pinctrl array. and that array is made of two parts, bestie, keep up:

• an index within the controller
• a number of u32 entries specified for each entry

🚨 important vibe check: the device_node is always for the parent pin controller device. always always. don't come for me on this, it's literally in the source. 😭

---

🌈 SEE ALSO 🌈

• the Kernel file ./drivers/pinctrl/devicetree.c (go read her, she's iconic)
• struct pinctrl_dt_map(9)
• pinctrl_get_list_and_count(9)
• pinctrl_count_index_with_args(9)
• pinctrl_copy_args(9)

---

and that's the tea, bestie 🍓 this whole page lives in ./drivers/pinctrl, dated October 2026 — so yeah, she's from the future, and she ate. 💜👑🦋