bochs

NAME

bochs - Portable x86 Emulator.

SYNOPSIS

bochs [bochs_options] [bochsrc_options]

DESCRIPTION

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

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'

LICENSE

This program is distributed under the terms of the GNU Lesser General Public License as published by the Free Software Foundation. See the LGPL file located in /usr/share/common-licenses/ for details on the license and the lack of warranty.

AVAILABILITY

The latest version of this program can be found at: http://bochs.sourceforge.net/getcurrent.html

SEE ALSO

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

The Bochs IA-32 Emulator site on the World Wide Web:
	http://bochs.sourceforge.net

Online Bochs Documentation
	http://bochs.sourceforge.net/doc/docbook

AUTHORS

The Bochs emulator was created by Kevin Lawton ([email protected]), and is currently maintained by the members of the Bochs x86 Emulator Project. You can see a current roster of members at: http://bochs.sourceforge.net/getinvolved.html

BUGS

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.