add_volume(9)

💅 add_volume — Kernel API Manual ✨

okay so bestie, you found yourself deep in the kernel docs, specifically the add_volume(9) page from the Kernel API Manual, and honestly? it's giving "small function, big responsibilities." let's get into it 🫶

---

✨ NAME ✨

add_volume — adds a volume to the attaching information. that's the whole vibe, no cap 💖

---

🎀 SYNOPSIS 🎀

struct ubi_ainf_volume * add_volume (struct ubi_attach_info *ai , int
vol_id , int pnum , const struct ubi_vid_hdr *vid_hdr );

look at that signature, she's iconic 👑

---

🌸 ARGUMENTS 🌸

• ai — the attaching information. this is the main character of the whole operation, fr fr 🦋
• vol_id — the ID of the volume you want to add. yes, this one specifically 💅
• pnum — the physical eraseblock number. lowkey important 🍓
• vid_hdr — the volume identifier header. the whole reason we're here 🌈

---

💜 DESCRIPTION 💜

so here's the tea ☕: if the volume that corresponds to the vid_hdr logical eraseblock is already present in the attaching information, this function literally does nothing. like, nothing nothing. she's on break 🙈

otherwise? she adds the corresponding volume to the attaching information, and that's the slay ✨

on success you get a pointer back to the allocated "av" object — that's your win, bestie 🏆 — and in the case of failure you get a negative error code instead. so, y'know, vibe check the return value 😭

---

🧚 SEE ALSO 🧚

so many friends in the kernel filesystem neighborhood, i'm obsessed 💖 these all live near Kernel file ./drivers/mtd/ubi/attach.c:

• find_or_add_av(9)
• ubi_find_or_add_av(9)
• ubi_alloc_aeb(9)
• ubi_free_aeb(9)
• add_to_list(9)
• add_corrupted(9)
• add_fastmap(9)
• validate_vid_hdr(9)
• ubi_compare_lebs(9)
• ubi_add_to_av(9)
• ubi_add_av(9)
• ubi_find_av(9)
• ubi_remove_av(9)
• early_erase_peb(9)
• ubi_early_get_peb(9)
• check_corruption(9)
• scan_peb(9)
• late_analysis(9)
• destroy_av(9)
• destroy_ai(9)
• scan_all(9)
• scan_fast(9)
• ubi_attach(9)
• self_check_ai(9)

go read them, iykyk 📚💅

---

and that's the whole page, bestie! brought to you by ./drivers/mtd/ubi, dated October 2026 — mwah, catch you in the next manpage 🌸🎀💖