qla2x00_poll_flash(9)

💅 qla2x00_poll_flash — like, the kernel API manual page, bestie ✨

okay so picture this: a kernel API manual page, section 9, and its whole entire main character is qla2x00_poll_flash. no cap, that's the name. it polls the flash for completion. that's it. that's the vibe. 🫶

---

✨ SYNOPSIS ✨

int qla2x00_poll_flash (struct qla_hw_data *ha , uint32_t addr , uint8_t
poll_data , uint8_t man_id , uint8_t flash_id );

literally the whole signature. copy it exactly, don't be weird about it. 🎀

---

🌸 ARGUMENTS 🌸

• ha — the HA context. she's the hardware context, she's holding it all together, respect her 💖
• addr — the address in flash that we're polling. like, where in the flash we're looking. that address.
• poll_data — the data to be polled. the data. being polled. yeah 🦋
• man_id — the flash manufacturer ID. who made the flash. iykyk
• flash_id — the flash ID. the other ID. she's different, she's iconic 👑

---

🔥 DESCRIPTION 🔥

so what does she actually do? okay so this function polls the device — like, keeps checking on it, patiently, bestie energy — until bit 7 of what is read matches data bit 7, OR until data bit 5 becomes a 1.

and if that happens? if bit 5 goes 1? 💀 that means the flash ROM timed out. that's a fatal error, ngl, not cute at all.

and here's the little detail that matters: the flash book recommends reading bit 7 again after reading bit 5 as a 1. so do that. the book said so. 📖✨

returns 0 on success, and non-zero otherwise. so like, zero = slay, non-zero = not slay. 💅

---

👀 SEE ALSO 👀

the kernel file ./drivers/scsi/qla2xxx/qla_sup.c — and honestly the whole friend group:

• qla29xx_get_flt_layout(9)
• qla29xx_get_fdt_info(9)
• qla29xx_get_flash_region(9)
• set_segment_bits(9)
• set_chunk_bits(9)
• qla29xx_write_optrom_data(9)
• qla29xx_read_optrom_data(9)
• qla29xx_mpi_optrom_data(9)
• qla2x00_lock_nvram_access(9)
• qla2x00_unlock_nvram_access(9)
• qla2x00_nv_write(9)
• qla2x00_nvram_request(9)
• qla2x00_get_nvram_word(9)
• qla2x00_nv_deselect(9)
• qla2x00_write_nvram_word(9)
• qla2x00_clear_nvram_protection(9)
• qla2x00_flash_enable(9)
• qla2x00_flash_disable(9)
• qla2x00_read_flash_byte(9)
• qla2x00_write_flash_byte(9)
• qla2x00_program_flash_address(9)
• qla2x00_erase_flash(9)
• qla2x00_erase_flash_sector(9)
• qla2x00_get_flash_manufacturer(9)
• qla2x00_get_fcode_version(9)

twenty-five entries, all present, all accounted for, no one left on read 🫶

---

💖 that's the page!! 💖

and before you go — the source lives in ./drivers/scsi/qla2xxx, dated October 2026. mwah, go poll something, bestie. 💜🧚‍♀️