create_bbt(9)

💅 create_bbt — the Kernel API Manual page, but make it cute ✨

okay so this is create_bbt(9) from the Kernel API Manual and honestly? it's a baddie little function. let's get into it 🎀

---

🌸 NAME

create_bbt — [GENERIC] create a bad block table by scanning the device. that's it. that's the whole vibe. it scans, it tables, it slays 💅

---

✨ SYNOPSIS

int create_bbt (struct nand_chip *this , uint8_t *buf , struct
       nand_bbt_descr *bd , int chip );

like yes, it returns an int, and yes, those spaces before the commas are just how the manpage formatted it — we don't touch the code, bestie, not ever 🙈

---

🦋 ARGUMENTS

• this — the NAND chip object itself, the main character of this whole operation 👑
• buf — a temporary buffer. it's giving "grab a scratchpad, we're working" energy 🍓
• bd — the descriptor for the good/bad block search pattern, aka the little instruction sheet for what counts as bad. iykyk 🔍
• chip — create the table for a specific chip, or -1 to read all chips. heads up though: this only applies if the NAND_BBT_PERCHIP option is set. no option, no per-chip life, fr fr 💀

---

💖 DESCRIPTION

so what it does is: create a bad block table by scanning the device for the given good/bad block identify pattern. that's literally the whole thing. it scans, it finds the pattern, it builds the table. iconic behaviour, no notes 🌈⭐

---

🔥 SEE ALSO

kernel file ./drivers/mtd/nand/raw/nand_bbt.c — and honestly the whole friend group came through for this one, so let's give them their flowers 💐:

check_pattern(9), check_short_pattern(9), add_marker_len(9), read_bbt(9), read_abs_bbt(9), scan_read_oob(9), read_abs_bbts(9), search_bbt(9), search_read_bbts(9), get_bbt_block(9), mark_bbt_block_bad(9), write_bbt(9), nand_memory_bbt(9), check_create(9), nand_update_bbt(9), mark_bbt_region(9), verify_bbt_descr(9), nand_scan_bbt(9), nand_create_badblock_pattern(9), nand_create_bbt(9), nand_isreserved_bbt(9), nand_isbad_bbt(9), nand_markbad_bbt(9)

like, genuinely the whole squad. obsessed 🫶

---

and that's the page!! this little gem lives in ./drivers/mtd/nand/raw, dated October 2026, and it's filed under create_bbt(9) in the Kernel API Manual. go forth and scan those bad blocks, bestie — periodt 💜✨