find_or_add_av(9)

✨ find_or_add_av(9) ✨

okay so bestie, we're deep in the Kernel API Manual today and this one is literally called find_or_add_av — the internal function that finds a volume, adds a volume, or does both (find and add if missing). multi-talented icon behaviour fr fr 💅

---

🌸 SYNOPSIS 🌸

struct ubi_ainf_volume * find_or_add_av (struct ubi_attach_info *ai ,
int vol_id , unsigned int flags , bool *created );

that's the whole vibe check right there 🦋

---

💖 ARGUMENTS 💖

• ai — the attaching information. like, the whole context of what we're attaching. 🎀
• vol_id — the volume ID you're asking for. the one you want. the main character. 👑
• flags — a combination of the AV_FIND and AV_ADD flags, and they describe the expected operation. this is the important part so pay attention bestie 😭
  • If only AV_ADD is set, -EEXIST is returned if the volume already exists.
  • If only AV_FIND is set, NULL is returned if the volume does not exist.
  • And if both flags are set, the helper first tries to find an existing volume, and if it does not exist it creates a new one. two-for-one combo, we love to see it ✨
• created — an in value used to inform the caller whether it's a newly created volume or not. so like, "hey, was this fresh out the oven or already here?" 🍓

---

🦋 DESCRIPTION 🦋

This function returns a pointer to a volume description — or an ERR_PTR if the operation failed. 😭

It can also return NULL if only AV_FIND is set and the volume does not exist. no cap, that's a whole three-way exit situation, so check your returns properly 🙈

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/mtd/ubi/attach.c plus the whole friend group:

• 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)
• add_volume(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)

---

💀 reminder bestie: this lives in ./drivers/mtd/ubi and it's the October 2026 edition of the page. go off, read the source, slay 💜

mwah 💖 thanks for reading my ted talk, now go call find_or_add_av responsibly 🧚