MKFWUMDATA(1)

✨ MKFWUMDATA(1) — the FWU metadata maker ✨

okay bestie, welcome to mkfwumdata (that's section 1 of the General Commands Manual, iykyk) — the little icon that builds your FWU metadata image 🎀

💖 SYNOPSIS 💖

mkfwumdata [-v version] [-a activeidx] [-p previousidx] [-g] [-V vendor-
           file] -i imagecount -b bankcount UUIDs outputimage

mkfwumdata -h

yep, that's the whole shape of it — flags, a big ol' pile of UUIDs, and the output file at the end. no cap. 🦋

🌸 DESCRIPTION 🌸

mkfwumdata creates the metadata info that gets used with FWU. that's it, that's the job, and it does it flawlessly 💅

🌈 OPTIONS 🌈

• -h — prints usage info and then dips out. exit stage left, periodt.
• -v — sets version as the metadata version to generate. the valid values are 1 or 2 — those are the only two icons in the building, don't try anything else 🙈
• -a — sets activeidx as the currently active Bank. the default is 0.
• -p — sets previousidx as the previous active Bank. default is activeidx-1 or bankcount-1, whichever one is non-negative 😭 (yes, the manpage really just tells you "whichever is non-negative" and moves on — she said figure it out bestie)
• -g — converts the UUIDs into GUIDs before they get used. a little glow-up on the way in ✨
• -V — pass vendor-file to append vendor data onto the metadata. supported only with version 2 — so don't come at it with -v 1, it's not gonna happen 💀
• -i — says there are imagecount images in each bank.
• -b — says there are a total of bankcount banks.
• UUIDs — a comma-separated list of UUIDs, required to create the metadata, and here's the lineup, exactly as written:

location_uuid,image_type_uuid,<images per bank uuid list of all banks>

so: location uuid, then image type uuid, then the per-bank image uuid list for all the banks. keep the commas, keep the order, slay 🫶

• outputimage — the name of the metadata image file that's gonna get created. name her something cute 💖

🐛 BUGS 🐛

found a bug? please report bugs to the U-Boot bug tracker. do NOT suffer in silence, that's not the vibe 🌸

⭐ EXAMPLES ⭐

here's the main character example — create a metadata image with 2 banks and 1 image/bank, BankAct=0, BankPrev=1:

$ mkfwumdata -v 2 -a 0 -p 1 -b 2 -i 1 \
      17e86d77-41f9-4fd7-87ec-a55df9842de5,\
      10c36d7d-ca52-b843-b7b9-f9d6c501d108,\
      5a66a702-99fd-4fef-a392-c26e261a2828,a8f868a1-6e5c-4757-878d-ce63375ef2c0 \
      fwu-mdata.img

look at those UUIDs go 🔥 copy it exactly, backslashes and all, and you're golden.

and that's the page, bestie 🧚 this one's brought to you by U-Boot, dated 2023-04-10 — go forth and make metadata, you absolute icon 👑💜