bximage - Man Page

Interactive Disk Image Creation, Conversion, Resize and Redolog Commit Tool for Bochs


bximage [options] [filename1] [filename2]


Bximage is an easy to use console based tool for creating, converting and resizing disk images, particularly for  use with Bochs. It also  supports committing  redolog files to their  base images.  It is  completely  interactive  if no command line  arguments are used.  It can be switched to a non-interactive mode  if all required parameters are given in the command line.


When you run bximage without one of the following options, it will  appear  in  interactive  mode and  ask   for  all required parameters to manipulate an image.


Operation to perform (create, convert, resize, commit, info)


Create: floppy image with size code (e.g. 360k, 720k, 1.44M)


Create/resize: hard disk image with size in megabytes (M) or gigabytes (G)


Create/convert: hard disk image mode - see the bochsrc sample for supported options.


Convert/resize: create a backup of the source image. Commit: create backups of base image and redolog file.


Quiet  mode (don't prompt for user input). Without this option bximage uses the  command  line parameters as defaults for the interactive mode. If this option is given and one of the required parameters is missing, bximage will fall back to interactive mode.

This example creates a harddisk image in flat mode and sector size 512:

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


Print  a  summary  of  the command line options for bximage and exit.

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).


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 details on the license and the lack of warranty.


The latest version of this program can be found at:

See Also

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

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

Online Bochs Documentation


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.


Please  report all  bugs to the bug tracker  on  our  web site. Just go to http://bochs.sourceforge.net, and click "Bug Reports" on the sidebar under "Feedback."

Provide a detailed description of the bug, the version of the program you are running, the operating system you are running the program on  and  the  operating   system  you are running in the emulator.

Referenced By

bochs(1), bochsrc(5).

10 Dec 2023 The Bochs Project