bochs-bin1
Portable x86 emulator.
Part of bochs(1).
Usage
bochs [bochs_options]
[bochsrc_options]
Overview
Bochs is a portable Intel Architecture 32 (x86) emulator that runs on most popular operating systems. Inside the emulator, it can run many operating systems including Linux and Microsoft(R) Windows(R).
Options
When you run Bochs without one of the following options, it will search for a configuration file called .bochsrc in the current directory and your home directory and display the start menu.
-
-q -
With this option the start menu will be skipped after loading the configuration file.
-
-f configfile -
This option specifies the name of the configuration file.
-
-qf configfile -
When you run Bochs with this option, it will skip the start menu and use the specified configuration file.
-
-n -
With this option Bochs doesn't load a configuration file. In that case the setup for the emulation must be done with bochsrc options on the command line or in the start menu.
-
-benchmark N -
Run Bochs in benchmark mode for N millions of emulated ticks
-
-dumpstats N -
Dump Bochs stats every N millions of emulated ticks
-
-r path -
Restore the Bochs state from path
-
-log filename -
Specify Bochs log file name
-
-unlock -
Unlock Bochs images leftover from previous session
-
-h, --help -
Print a summary of the command line options for Bochs and exit
-
-h, --help features -
Display available features / devices and exit
-
-h, --help cpu -
Display supported CPU models and exit
The following options are available if Bochs is compiled with debugger support.
-
-dbg -
Start Bochs internal debugger on startup
-
-rc filename -
Execute debugger commands stored in file
-
-dbglog -
Specify Bochs internal debugger log file name
You can override the settings from the configuration file with command line arguments, using the same syntax as the bochsrc file. If you have any spaces in your command line arguments, they should be enclosed in single quotes. For information on Bochs command line and configuration file arguments, see the man page bochsrc(5).
Example:
bochs -q 'boot:a' 'floppya: 1_44=a.img, status=inserted'
History
- Debian 13 (Trixie): the text shown here
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 10 (Buster)
- Debian 9 (Stretch) to Debian 8 (Jessie)
- Debian 7 (Wheezy)
- Debian 6.0 (Squeeze)
- Debian 5.0 (Lenny)
- Debian 4.0 (Etch)
-benchmark since Debian 12 (Bookworm);
-dbg since Debian 13 (Trixie);
-dbglog since Debian 13 (Trixie);
-dumpstats since Debian 12 (Bookworm);
-log since Debian 8 (Jessie);
-r since Debian 8 (Jessie);
-rc since Debian 13 (Trixie);
-unlock since Debian 12 (Bookworm).