bfb-tool(8)

💖 bfb-tool — the BFB Management Tool, aka bfb-tool(8) 💖

okay bestie, sit down, hydrate, and let me tell you about bfb-tool — she's the girl who extracts and repackages BFBs and she does NOT miss. ✨

---

🌸 NAME 🌸

bfb-tool — the tool for extracting and repackaging BFBs, fr fr.

---

🦋 SYNOPSIS 🦋

bfb-tool <action> --bfb <BFB> --psid <PSID>|--opn <OPN>|--all
[-p|--profile <Profile>] [-o|--output-dir <dir>] [-f|--output-format
<format>] [-B|--output-bfb] [-v|--verbose] [-j|--json]

that's the whole vibe in one block, no cap. 👑

---

💅 DESCRIPTION 💅

so bfb-tool is the main character for managing BFBs (bf-bundle / bf-fwbundle). she supports these actions, and yes they're all iconic:

• extract
• repack
• info

the repack action is literally the multitasker — it extracts and builds a brand new BFB for a specific OPN/PSID. she's giving build-a-bear but for firmware. 🧚

---

✨ OPTIONS ✨

• action — pick your girl, i.e. the action to perform. the supported actions are: extract, repack and info.
  • extract — pulls the payload out of the BFB. rip it out, respectfully. 🙈
  • repack — extracts and then builds a whole new BFB for a specific OPN/PSID. glow-up behavior. 💖
  • info — prints version information for the components chilling inside a BFB. receipts! 🧾
• --bfb <BFB> — tells her which BFB file you mean (either bf-bundle or bf-fwbundle). yes you have to say it out loud.
• --psid <PSID> — the PSID of the DPU you want the payload extracted for. 🎀
• --opn <OPN> — the OPN of the DPU you want the payload extracted for. 🌸
• --all — extract or repack for all applicable configurations. she said everybody eats. 🔥
• -p, --profile <Profile> — specify a configuration profile.
• -o, --output-dir <dir> — the directory where the results get stored. put them somewhere cute.
• -f, --output-format <format> — the output BFB format, either bundle or flat. here's the tea:
  • bundle format is the format for DPU mode, and it's the default. 💜
  • flat format is the format for NIC mode.
• -B, --output-bfb <bfb> — name your output BFB file. the defaults are:
  • bundle format default: bf-fwbundle-<version>-prod-<OPN>.bfb
  • flat format default: bf-fwbundle-<version>-prod-<OPN>.flat.bfb
• -j, --json — prints version information in JSON format. structured queen. 🫶
• -v, --verbose — turns on verbose mode so you get all the detailed output. she will not gatekeep. 😭

---

🌈 EXAMPLES 🌈

extract the payload from a BFB for a specific PSID:

bfb-tool extract --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --psid
MT_0000001070

repack a BFB for a specific OPN:

bfb-tool repack --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --opn
900-9D3B6-F2SV-PA0_Ax

copy those EXACTLY, bestie, character for character, no autocorrect energy. ⭐

---

👀 SEE ALSO 👀

mlx-mkbfb(8) — go read her too, she's also that girl.

---

🎀 AUTHOR 🎀

written by Vladimir Sokolovsky <vlad@nvidia.com> — thank you for your service, king. 👑

---

and that's a wrap! this page is from the bfb-tool manual, dated 2025-03-13 — so if you're reading this, that date is the whole timestamp vibe, and the source is bfb-tool(8), periodt. 💖✨🦋💅