ubi_bitflip_check(9)

💅 ubi_bitflip_check(9) — like, the whole entire vibe

okay so welcome to the Kernel API Manual bestie, this is the page for ubi_bitflip_check(9) and honestly? it's giving "tiny function, huge responsibility" ✨

---

✨ NAME ✨

ubi_bitflip_check — check an eraseblock for bitflips and scrub it if needed. 🧚 that's it. that's the whole job. no cap.

---

🌸 SYNOPSIS 🌸

int ubi_bitflip_check (struct ubi_device *ubi , int pnum , int force );

literally just three args, we love a low-arg-count king 👑

---

🎀 ARGUMENTS 🎀

• ubi — the UBI device description object. your main character struct fr.
• pnum — the physical eraseblock to schedule. which one? this one. 💅
• force — don't read the block, assume bitflips happened and take action. bold. assertive. iconique. 🔥

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — this function reads the given eraseblock and checks if bitflips occured. yes, "occured", we're quoting the source, don't come for me 😭

in case of bitflips, the eraseblock is scheduled for scrubbing. cute, responsible, self-care.

but if scrubbing is forced with force, the eraseblock is not read — it's scheduled for scrubbing right away. no vibe check, just go. 💀

---

🌈 RETURN 🌈

the way this function has so many ways to say no — let's go through them one by one 🫶

• EINVAL — PEB is out of range. wrong block bestie, not even in the map 🙈
• ENOENT — PEB is no longer used by UBI. it's moved on, it's healing, let it go 🌸
• EBUSY — PEB cannot be checked now or a check is currently running on it. it's booked and blesséd, try later 💅
• EAGAIN — bit flips happened but scrubbing is currently not possible. the flips are real, the timing is not 😭
• EUCLEAN — bit flips happened and PEB is scheduled for scrubbing. slay, handled, taken care of ✨
• 0 — no bit flips detected. immaculate. pristine. flawless block energy 👑

ngl, map these return codes properly or you'll be debugging at 3am wondering why nothing works. iykyk.

---

💜 SEE ALSO 💜

Kernel file ./drivers/mtd/ubi/wl.c and literally the entire friend group:

wl_tree_add(9), wl_entry_destroy(9), do_work(9), in_wl_tree(9), in_pq(9), prot_queue_add(9), find_wl_entry(9), find_mean_wl_entry(9), wl_get_wle(9), prot_queue_del(9), ubi_sync_erase(9), serve_prot_queue(9), __schedule_ubi_work(9), schedule_ubi_work(9), schedule_erase(9), do_sync_erase(9), wear_leveling_worker(9), ensure_wear_leveling(9), __erase_worker(9), ubi_wl_put_peb(9), ubi_wl_scrub_peb(9), ubi_wl_flush(9), tree_destroy(9), ubi_thread(9), shutdown_work(9), erase_aeb(9), ubi_wl_init(9), protection_queue_destroy(9), ubi_wl_close(9), self_check_ec(9), self_check_in_wl_tree(9), self_check_in_pq(9), produce_free_peb(9), ubi_wl_get_peb(9)

---

okay that's the page!! sourced straight from ./drivers/mtd/ubi, dated October 2026, and yeah — crop it, frame it, screenshot it, it's iconic 🎀💖✨ go check those bitflips bestie, mwah 🫶