update_vol(9)

✨ update_vol(9) ✨

okay so this is a page from the Kernel API Manual — yes, the actual kernel manual, and yes, we're gonna read it together bestie, don't panic 💖

🌸 NAME 🌸

update_vol — inserts or updates a LEB which was found a pool.

(not a typo, that's literally what it says: "found a pool" 🫶 we love a slightly cursed sentence, it's giving legacy comment energy)

---

🎀 SYNOPSIS 🎀

int update_vol (struct ubi_device *ubi , struct ubi_attach_info *ai ,
struct ubi_ainf_volume *av , struct ubi_vid_hdr *new_vh , struct
ubi_ainf_peb *new_aeb );

five arguments, all structs, all pointers, all here to do exactly one job 👑

---

🦋 ARGUMENTS 🦋

• ubi — the UBI device object. the main character of this whole subsystem ngl.
• ai — attach info object. the receipts from the attach, basically.
• av — the volume this LEB belongs to. gotta know where it lives 💅
• new_vh — the volume header derived from new_aeb. it's the header's origin story.
• new_aeb — the AEB to be examined. yes, examined. put it under the microscope 🔬

---

🔥 DESCRIPTION 🔥

Returns 0 on success. < 0 indicates an internal error.

that's it. that's the whole description. short, sweet, and honestly iconic for it 💀 no cap, sometimes a function's entire personality is its return value and we respect that.

heads up bestie: if you get a negative back, that's an internal error — not a you problem, an internals problem. still not a slay, but at least you know where to look 🫶

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/mtd/ubi/fastmap.c — plus the whole fastmap friend group, all listed right here so you never have to go looking:

• init_seen(9)
• free_seen(9)
• set_seen(9)
• self_check_seen(9)
• ubi_calc_fm_size(9)
• new_fm_vbuf(9)
• add_aeb(9)
• add_vol(9)
• assign_aeb_to_av(9)
• process_pool_aeb(9)
• unmap_peb(9)
• scan_pool(9)
• count_fastmap_pebs(9)
• ubi_attach_fastmap(9)
• find_fm_anchor(9)
• ubi_scan_fastmap(9)
• ubi_write_fastmap(9)
• invalidate_fastmap(9)
• return_fm_pebs(9)
• ubi_update_fastmap(9)

twenty of them. twenty!! the fastmap.c cast is huge and every single one of them got an invite to the see-also list 🧚✨

---

and that's the page!! ./drivers/mtd/ubi, October 2026, straight from the Kernel API Manual — go forth and update those volumes, bestie, you've got this 💜👑