child_regions_with_firmware(9)

✨ NAME ✨

okay so bestie, this is the child_regions_with_firmware(9) page from the Kernel API Manual — and it's used to check the child region info. it's giving “validation era,” and honestly? iconic. 💅

🦋 SYNOPSIS 🦋

int child_regions_with_firmware (struct device_node *overlay );

🎀 ARGUMENTS 🎀

• overlay — device node of the overlay. that's the one you're handing over, no biggie. 🫶

🌸 DESCRIPTION 🌸

so here's the vibe check: if the overlay adds child FPGA regions, those child FPGA regions are not allowed to have a firmware-name property. periodt. 🚫✨

like, do not pass go, do not add firmware-name to a child FPGA region in this overlay. it's giving invalid, and the function will tell you so. 😭

🔥 RETURN 🔥

• 0 — OK, we love to see it. 👑
• -EINVAL — if a child FPGA region adds firmware-name. yeah, that's the no-no. 💀

🌈 SEE ALSO 🌈

the kernel file is ./drivers/fpga/of-fpga-region.c, and here are the related besties, all listed exactly as the manual says:

• of_fpga_region_find(9)
• of_fpga_region_get_mgr(9)
• of_fpga_region_get_bridges(9)
• of_fpga_region_parse_ov(9)
• of_fpga_region_notify_pre_apply(9)
• of_fpga_region_notify_post_remove(9)
• of_fpga_region_notify(9)
• of_fpga_region_init(9)

cute little sign-off: this page lives at ./drivers/fpga, it's dated October 2026, and you've been reading child_regions_with_firmware(9). mwah 💋🎀