gpiochip_query_valid_mask(9)

📦 version 7.3.1, in nixpkgs unstable

👑 gpiochip_query_valid_mask — the whole vibe ✨

okay so bestie, welcome to the Kernel API Manual, section 9, and today's main character is gpiochip_query_valid_mask 💅 like yes the name is a mouthful but she's literally the "which pins are actually real" girlie and we're obsessed 🎀

✨ NAME ✨

gpiochip_query_valid_mask — returns the GPIO validity information 🦋

🌸 SYNOPSIS 🌸

const unsigned long * gpiochip_query_valid_mask (const struct gpio_chip
*gc );

🎀 ARGUMENTS 🎀

  • gc — the gpio chip whose validity information is being queried. yeah that's the whole assignment, she's the one we're interrogating 🔍

⭐ RETURN ⭐

A bitmap representing the valid GPIOs, or NULL if all GPIOs are valid. so like 💭 no bitmap = nothing's broken = every pin is invited to the party, periodt 🎉

💖 DESCRIPTION 💖

Some GPIO chips are lowkey built for configurations where a few of the pins just… aren't available 😭 and those chips can set valid_mask to represent the valid GPIOs. this function is how you go retrieve that info — it's giving "let me check who's actually on the guest list before I start handing out invites" 🫶✨

ngl bestie, if you skip this and assume every pin works, that's on you 🙈

🌈 SEE ALSO 🌈

first up, the kernel file: ./drivers/gpio/gpiolib.c — that's where the magic lives 🧚 and then, okay, the crossover episode is REAL, here is everyone in this cinematic universe, no cap:

like, that's the whole extended friend group 😭 tag yourself, i'm gpiod_put_array(9) 🍓

and that's the tea bestie — this page lives in ./drivers/gpio, dated October 2026, filed under gpiochip_query_valid_mask(9) 💜 slay, go read your GPIOs responsibly 🔥👑

📦 where this page comes from