regmap_read_poll_timeout(9)

✨ regmap_read_poll_timeout(9) ✨

okay so welcome to the Kernel API Manual, bestie 💖 this page is literally all about regmap_read_poll_timeout — the “poll until a condition is met or a timeout occurs” icon of the regmap world. no cap. 🦋

🌸 NAME 🌸

regmap_read_poll_timeout — poll until a condition is met or a timeout occurs. periodt. 💅

🎀 SYNOPSIS 🎀

regmap_read_poll_timeout (map , addr , val , cond , sleep_us ,
       timeout_us );

💖 ARGUMENTS 💖

• map — the regmap you're reading from. main character regmap energy. 👑
• addr — the address to poll. like, we keep checking this spot. 📍
• val — an unsigned integer variable to read the value into. the value goes in here, bestie. 🎀
• cond — the break condition (usually involving val). this is the “are we done yet?” vibe check. ✨
• sleep_us — maximum time to sleep between reads in us (0 tight-loops). pls read the usleep_range function description for details and limitations. 🫶
• timeout_us — timeout in us; 0 means never timeout. ⏳

🌈 DESCRIPTION 🌈

This is modelled after the readx_poll_timeout macros in linux/iopoll.h. that's the whole description, and honestly? iconic. ✨

🔥 RETURN 🔥

• 0 on success. slay. 💖
• -ETIMEDOUT upon a timeout. 😭
• or the regmap_read error return value in case of a error read. 💀

In the two former cases, the last read value at addr is stored in val.

⚠️ Must not be called from atomic context if sleep_us or timeout_us are used. fr fr, respect the atomic-context boundary. 🚫

👑 SEE ALSO 👑

the whole SEE ALSO list is giving regmap extended universe 🌈💜

• Kernel file ./include/linux/regmap.h
• struct reg_default(9)
• struct reg_sequence(9)
• regmap_read_poll_timeout_atomic(9)
• regmap_field_read_poll_timeout(9)
• struct regmap_range(9)
• struct regmap_access_table(9)
• struct regmap_config(9)
• struct regmap_range_cfg(9)
• struct regmap_sdw_mbq_cfg(9)
• struct regmap_bus(9)
• regmap_init(9)
• regmap_init_i2c(9)
• regmap_init_mdio(9)
• regmap_init_sccb(9)
• regmap_init_slimbus(9)
• regmap_init_spi(9)
• regmap_init_spmi_base(9)
• regmap_init_spmi_ext(9)
• regmap_init_w1(9)
• regmap_init_mmio_clk(9)
• regmap_init_mmio(9)
• regmap_init_ac97(9)
• regmap_init_sdw(9)
• regmap_init_sdw_mbq(9)
• regmap_init_sdw_mbq_cfg(9)
• regmap_init_i3c(9)
• regmap_init_spi_avmm(9)
• regmap_init_fsi(9)
• devm_regmap_init(9)
• devm_regmap_init_i2c(9)
• devm_regmap_init_mdio(9)
• devm_regmap_init_sccb(9)
• devm_regmap_init_spi(9)
• devm_regmap_init_spmi_base(9)
• devm_regmap_init_spmi_ext(9)
• devm_regmap_init_w1(9)
• devm_regmap_init_mmio_clk(9)
• devm_regmap_init_mmio(9)
• devm_regmap_init_ac97(9)
• devm_regmap_init_sdw(9)
• devm_regmap_init_sdw_mbq(9)
• devm_regmap_init_sdw_mbq_cfg(9)
• devm_regmap_init_slimbus(9)
• devm_regmap_init_i3c(9)
• devm_regmap_init_spi_avmm(9)
• devm_regmap_init_fsi(9)
• struct reg_field(9)
• struct regmap_irq_type(9)
• struct regmap_irq(9)
• struct regmap_irq_chip(9)

---

source/version: ./include/linux · date: October 2026 — k bye bestie, mwah 💋🫶✨