VIRTNBDMAP(1)

👑 VIRTNBDMAP — the virtnbdmap manual, bestie edition

okay so real talk, this is the page for virtnbdmap, a User Commands situation, and yes it's giving "I read the whole thing so you don't have to" energy. Let's get into it 🫶

---

✨ NAME ✨

virtnbdmap — map virtnbdbackup image files to nbd devices 💅

---

🌸 DESCRIPTION 🌸

Bestie, here's the whole usage vibe, copy-pasted exactly because I would never do you like that:

usage: virtnbdmap [-h] -f FILE [-b BLOCKSIZE] [-d DEVICE] [-e EXPORT_NAME]
       [-t THREADS] [-l LISTEN_ADDRESS] [-p LISTEN_PORT] [-n] [-L LOGFILE]
       [--nocolor] [-r] [-H] [-v] [-V]

What does it do? Map backup image(s) to a block device. That's the whole main character moment. 🎀

💖 options: 💖

• -h, --help — shows this very help message and then dips out, exit stage left. 🦋

🧚 General options: 🧚

• -f, --file FILE — the list of Backup files you wanna map. yeah this one's basically required, no cap.
• -b, --blocksize BLOCKSIZE — the maximum blocksize that gets passed to nbdkit. (default: 4096) ✨
• -d, --device DEVICE — the target device, aka where this whole thing lands. (default: /dev/nbd0)
• -e, --export-name EXPORT_NAME — the export name handed over to nbdkit. (default: sda)
• -t, --threads THREADS — how many threads get passed to the nbdkit process. (default: 1)
• -l, --listen-address LISTEN_ADDRESS — the IP Address the nbdkit process listens on. (default: 127.0.0.1) 💜
• -p, --listen-port LISTEN_PORT — the Port the nbdkit process listens on. (default: 10809)
• -n, --noprogress — kills the progress bar. no more lil loading vibes, just silence 🙈

🍓 Logging options: 🍓

• -L, --logfile LOGFILE — path to the Logfile. (default: /home/abi/virtnbdmap.log)
• --nocolor — disables colored output. (default: False) yes bestie, that's the literal default value, I'm not making this up

💀 Debug options: 💀

• -r, --readonly — maps the image readonly, so nothing gets written back. (default: False) 🧊
• -H, --hexdump — hexdumps data into the logfile for debugging. (default: False)
• -v, --verbose — turns on debug output. the yapper setting 🔥
• -V, --version — shows the version and exits. periodt.

---

🌈 EXAMPLES 🌈

okay these are the actual examples, verbatim, do not @ me:

# Map full backup to device /dev/nbd0:

virtnbdmap -f /backup/sda.full.data

# Map full backup to device /dev/nbd2:

virtnbdmap -f /backup/sda.full.data -d /dev/nbd2

# Map sequence of full and incremental to device /dev/nbd2:

virtnbdmap -f /backup/sda.full.data,/backup/sda.inc.1.data -d /dev/nbd2

like… the way that last one just chains a full and an incremental with a lil comma?? iconic. 👑

---

and that's the whole thing bestie, you ate 💅 this was virtnbdmap 2.49, dated July 2026 — go map something and slay ✨🦋💖