devm_gpiod_...ray_optional(9)

💅 devm_gpiod_...ray_optional — straight from the Kernel API Manual, bestie

okay so before we even get into it: yes the title is literally devm_gpiod_...ray_optional(9) with the dots and everything, that's not me being lazy, that's the actual page name, the middle got squished like a text message from someone typing too fast 😭 anyway. intent is giving "kernel dev who wants ALL the GPIOs, but responsibly." let's get into it ✨

---

✨ NAME ✨

devm_gpiod_get_array_optional — it's the resource-managed glow-up of gpiod_get_array_optional(). same energy, but the cleanup is handled for you 🫶

---

🎀 SYNOPSIS 🎀

struct gpio_descs * devm_gpiod_get_array_optional (struct device *dev ,
const char *con_id , enum gpiod_flags flags );

bestie look at that signature. struct gpio_descs * coming back at you, three args going in. iconic behavior fr fr 💅

---

🌸 ARGUMENTS 🌸

• dev — the GPIO consumer. like, the device that's about to be obsessed with some GPIOs 👑
• con_id — the function within the GPIO consumer. the name-tag that says which function we're talking about ✨
• flags — optional GPIO initialization flags. optional optional, they're right there in the name 🎀

---

🦋 DESCRIPTION 🦋

so this is the managed version of gpiod_get_array_optional, no cap. the GPIO descriptors you get back from this function? they get automatically disposed on driver detach. you don't have to clean up after yourself, the kernel does it for you. main character energy honestly 🫶

if you want the full tea on how it actually behaves and what it returns, go read gpiod_get_array_optional — this one is literally pointing you there 💖

---

🔥 RETURN 🔥

here's the vibe check on what you get back:

• the GPIO descriptors corresponding to the function con_id of device dev — slay, you got your array 🌈
• NULL if no GPIO has been assigned to the requested function — no GPIOs, no problem, no drama 🙈
• or another IS_ERR code if an error happened while trying to acquire the GPIOs — read it, don't ignore it, that's the whole point 💀

---

⭐ SEE ALSO ⭐

go down the rabbit hole, i promise it's worth it 🧚

• Kernel file ./drivers/gpio/gpiolib-devres.c
• devm_gpiod_get(9)
• devm_gpiod_get_optional(9)
• devm_gpiod_get_index(9)
• devm_fwnode_gpiod_get_index(9)
• devm_gpiod_get_index_optional(9)
• devm_gpiod_get_array(9)
• devm_gpiod_put(9)
• devm_gpiod_unhinge(9)
• devm_gpiod_put_array(9)
• devm_gpiochip_add_data_with_key(9)

---

💜 friendly reminder from your favorite kernel bestie: this whole page lives at ./drivers/gpio, and it's dated October 2026 — so when you cite it, cite it cute. oh and the page name is still devm_gpiod_...ray_optional(9), dots and all, i don't make the rules, i just vibe with them 🎀

that's the whole page, you ate that, periodt 💅✨🌸