doc_backup_oob(9)

💖 NAME 💖

okay so bestie, this is doc_backup_oob(9) from the Kernel API Manual, and it's literally here to back up OOB into the docg3 structure. iconic.

🌸 SYNOPSIS 🌸

int doc_backup_oob (struct docg3 *docg3 , loff_t to , struct mtd_oob_ops *ops );

🦋 ARGUMENTS 🦋

• docg3 — the device, the main character.
• to — the page offset in the chip.
• ops — the OOB size and buffer.

💅 DESCRIPTION 💅

Okay so picture this: docg3 should write a page with its OOB in one pass, and some userland applications do write_oob to setup the OOB and then write, store the OOB into a temporary storage. That's the setup, and it's giving chaos.

⚠️ This is very dangerous, as 2 concurrent applications could store an OOB, and then write their pages (which will result into one having its OOB corrupted). 💀

The only reliable way would be for userland to call doc_write_oob with both the page data and the OOB area.

Returns 0 if success, -EINVAL if ops content invalid. fr fr.

🎀 SEE ALSO 🎀

Kernel file ./drivers/mtd/devices/docg3.c — and the whole crew: doc_delay(9), doc_read_data_area(9), doc_write_data_area(9), doc_set_reliable_mode(9), doc_set_asic_mode(9), doc_set_device_id(9), doc_set_extra_page_mode(9), doc_setup_addr_sector(9), doc_setup_writeaddr_sector(9), doc_read_seek(9), doc_write_seek(9), doc_read_page_ecc_init(9), doc_write_page_ecc_init(9), doc_ecc_disable(9), doc_hamming_ecc_init(9), doc_ecc_bch_fix_data(9), doc_read_page_prepare(9), doc_read_page_getbytes(9), doc_write_page_putbytes(9), doc_get_bch_hw_ecc(9), doc_page_finish(9), doc_read_page_finish(9), calc_block_sector(9), doc_read_oob(9), doc_block_isbad(9), doc_get_erase_count(9), doc_get_op_status(9), doc_write_erase_wait_status(9), doc_erase_block(9), doc_erase(9), doc_write_page(9), doc_guess_autoecc(9), doc_fill_autooob(9), doc_write_oob(9), doc_set_driver_info(9), doc_probe_device(9), doc_release_device(9), docg3_resume(9), docg3_suspend(9), docg3_probe(9), docg3_release(9).

mwah 💋 — source/version: ./drivers/mtd/devices, date: October 2026, page: doc_backup_oob(9). 🫶