bximage(1)

🎀 bximage — the Bochs disk image bestie 🎀

okay so this is bximage, part of The Bochs Project — it's the interactive disk image creation, conversion, resize and redolog commit tool for Bochs. yeah. it does all of that. sit down bestie, we're gonna get through it together 💖

---

✨ SYNOPSIS ✨

bximage [options] [filename1] [filename2]

---

🦋 DESCRIPTION 🦋

bximage is a console based tool that's genuinely so easy to use — it creates, converts and resizes disk images, especially for using with Bochs. it also supports committing redolog files to their base images, which is lowkey the coolest part ngl.

and here's the vibe: if you run it with no command line arguments at all, it's completely interactive — it'll just ask you for everything, main character energy 🫶. but if you give it all the required parameters on the command line, it switches to non-interactive mode and just does the thing. slay.

---

💅 OPTIONS 💅

okay so when you run bximage without one of the following options, it appears in interactive mode and asks for all the required parameters you need to manipulate an image. very "let's figure this out together" of it.

• -func=... — the operation to perform. your choices are create, convert, resize, commit, info. pick your fighter ✨
• -fd=... — for Create: makes a floppy image with a size code (e.g. 360k, 720k, 1.44M). retro vibes fr 🎀
• -hd=... — for Create/resize: hard disk image with the size in megabytes (M) or gigabytes (G). big disk energy.
• -imgmode=... — for Create/convert: the hard disk image mode — go check the bochsrc sample for the supported options, iykyk.
• -b — for Convert/resize: create a backup of the source image. for Commit: create backups of the base image and the redolog file. protect yourself bestie 💜
• -q — quiet mode (don't prompt for user input). without this option, bximage uses the command line parameters as defaults for the interactive mode. if you do give this option and one of the required parameters is missing, bximage will fall back to interactive mode. no cap, it just will.

this example creates a harddisk image in flat mode with sector size 512:

bximage -q -func=create -hd=100M hd100meg.img

• --help — prints a summary of the command line options for bximage and exits. the "hey bestie here's the tl;dr" of flags 🌸

---

so about the filenames 👑

the filename1 parameter specifies the name of the new image (create), the source image (convert/resize) or the base image (commit).

the filename2 parameter specifies the name of the destination image (convert/resize) or the redolog (journal) file (commit).

---

📜 LICENSE 📜

this program is distributed under the terms of the GNU Lesser General Public License as published by the Free Software Foundation. see the LICENSE and COPYING files located in /usr/share/doc/bochs/ for the details on the license and the lack of warranty. (yes, the lack of warranty. read it. 🙈)

---

🌈 AVAILABILITY 🌈

the latest version of this program can be found at:

https://bochs.sourceforge.io/getcurrent.html

go get it bestie ⭐

---

🔥 SEE ALSO 🔥

• bochs(1)
• bochsrc(5)
• bochs-dlx(1)

the Bochs IA-32 Emulator site on the World Wide Web:

https://bochs.sourceforge.io

online Bochs documentation:

https://bochs.sourceforge.io/doc/docbook

---

👑 AUTHORS 👑

the original version of bximage was written by Bryce Denney, based on several similar tools from the bochs-developers list. the support for converting and resizing images has been added by Volker Ruppert. legends, both of them 💖

---

💀 BUGS 💀

please report all bugs to the bug tracker on our web site. just go to https://bochs.sourceforge.io, and click "Bug Reports" on the sidebar under "Feedback." easy.

when you do, provide:

• a detailed description of the bug
• the version of the program you're running
• the operating system you're running the program on
• the operating system you're running in the emulator

all four, bestie. don't make them guess 😭

---

and that's the whole page!! this one's from the Bochs Project, dated 26 Mar 2024 — bximage version energy, mwah 💅✨