onenand_scan_bbt(9)

💅 onenand_scan_bbt — like, the Kernel API Manual page, but make it make sense 🎀

okay so bestie, welcome to the glow-up of onenand_scan_bbt from the Kernel API Manual ✨ this is the OneNAND Interface's whole bad-block-table situation and honestly it's giving main character energy. let's get into it 💖

---

✨ NAME ✨

onenand_scan_bbt — [OneNAND Interface] scan, find, read and maybe create bad block table(s). yes, all of that. she's multitasking, she contains multitudes 🦋

---

🌸 SYNOPSIS 🌸

int onenand_scan_bbt (struct mtd_info *mtd , struct nand_bbt_descr *bd
);

that's it. that's the whole vibe check. two args, one int return, no cap 💅

---

🎀 ARGUMENTS 🎀

• mtd — the MTD device structure. like, the device itself, the actual star of the show 👑
• bd — the descriptor for the good/bad block search pattern. this is the little instruction sheet that tells us what "good" and "bad" look like 🔍

---

🧚 DESCRIPTION 🧚

okay so first thing she does: she checks if a bad block table(s) is/are already available. like, no point doing all that work if it's already sitting there, right? periodt 💀

but if it's not there? then she scans the device for manufacturer marked good / bad blocks and then writes the bad block table(s) to the selected place. full send. she found the blocks, she read the blocks, she wrote the table. iconic behavior ngl 🔥

💡 important detail bestie: the bad block table memory is allocated here. so this function is the one making the memory happen. and then it is freed by the onenand_release function. so like… onenand_scan_bbt allocates, onenand_release cleans up. tag team. 🤝🫶

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/mtd/nand/onenand/onenand_bbt.c — the source, go read it iykyk 📖
• check_short_pattern(9)
• create_bbt(9)
• onenand_memory_bbt(9)
• onenand_isbad_bbt(9)
• onenand_default_bbt(9)

the whole friend group fr fr 🌈⭐

---

and that's the page!! 🌸 source/version line said ./drivers/mtd/nand/onenand, dated October 2026, and the title up top was onenand_scan_bbt(9) — so yeah, shoutout to the OneNAND crew, October 2026 said hi, and onenand_scan_bbt(9) is the name, don't wear it out 💖🎀✨