You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
384 lines
7.9 KiB
384 lines
7.9 KiB
4 years ago
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||
|
|
<HTML
|
||
|
|
><HEAD
|
||
|
|
><TITLE
|
||
|
|
>The configuration interface 'textconfig'</TITLE
|
||
|
|
><META
|
||
|
|
NAME="GENERATOR"
|
||
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||
|
|
REL="HOME"
|
||
|
|
TITLE="Bochs User Manual"
|
||
|
|
HREF="index.html"><LINK
|
||
|
|
REL="UP"
|
||
|
|
TITLE="Using Bochs"
|
||
|
|
HREF="using-bochs.html"><LINK
|
||
|
|
REL="PREVIOUS"
|
||
|
|
TITLE="Search order for the configuration file"
|
||
|
|
HREF="search-order.html"><LINK
|
||
|
|
REL="NEXT"
|
||
|
|
TITLE="Save and restore simulation"
|
||
|
|
HREF="using-save-restore.html"></HEAD
|
||
|
|
><BODY
|
||
|
|
CLASS="SECTION"
|
||
|
|
BGCOLOR="#FFFFFF"
|
||
|
|
TEXT="#000000"
|
||
|
|
LINK="#0000FF"
|
||
|
|
VLINK="#840084"
|
||
|
|
ALINK="#0000FF"
|
||
|
|
><DIV
|
||
|
|
CLASS="NAVHEADER"
|
||
|
|
><TABLE
|
||
|
|
SUMMARY="Header navigation table"
|
||
|
|
WIDTH="100%"
|
||
|
|
BORDER="0"
|
||
|
|
CELLPADDING="0"
|
||
|
|
CELLSPACING="0"
|
||
|
|
><TR
|
||
|
|
><TH
|
||
|
|
COLSPAN="3"
|
||
|
|
ALIGN="center"
|
||
|
|
>Bochs User Manual</TH
|
||
|
|
></TR
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="10%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="bottom"
|
||
|
|
><A
|
||
|
|
HREF="search-order.html"
|
||
|
|
ACCESSKEY="P"
|
||
|
|
>Prev</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="80%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="bottom"
|
||
|
|
>Chapter 5. Using Bochs</TD
|
||
|
|
><TD
|
||
|
|
WIDTH="10%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="bottom"
|
||
|
|
><A
|
||
|
|
HREF="using-save-restore.html"
|
||
|
|
ACCESSKEY="N"
|
||
|
|
>Next</A
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
><HR
|
||
|
|
ALIGN="LEFT"
|
||
|
|
WIDTH="100%"></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H1
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="TEXTCONFIG"
|
||
|
|
>5.3. The configuration interface 'textconfig'</A
|
||
|
|
></H1
|
||
|
|
><P
|
||
|
|
>The configuration interface 'textconfig' is the text mode version of the Bochs
|
||
|
|
configuration system. It is a series of menus (using stdin/stdout) that allows
|
||
|
|
you to edit all the settings that control Bochs' behavior. If you do not write
|
||
|
|
a config_interface line, Bochs will choose it as the default for you (unless Bochs
|
||
|
|
is compiled for wxWidgets only).</P
|
||
|
|
><P
|
||
|
|
>It consists of these three parts:
|
||
|
|
<P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>the start menu</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>the headerbar buttons</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>the runtime configuration</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H2
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="AEN2491"
|
||
|
|
>5.3.1. The start menu</A
|
||
|
|
></H2
|
||
|
|
><P
|
||
|
|
>If you start Bochs without the quickstart argument (-q), the Bochs configuration
|
||
|
|
main menu appears:
|
||
|
|
<TABLE
|
||
|
|
BORDER="0"
|
||
|
|
BGCOLOR="#E0E0E0"
|
||
|
|
WIDTH="100%"
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
><PRE
|
||
|
|
CLASS="SCREEN"
|
||
|
|
>------------------------------
|
||
|
|
Bochs Configuration: Main Menu
|
||
|
|
------------------------------
|
||
|
|
|
||
|
|
This is the Bochs Configuration Interface, where you can describe the
|
||
|
|
machine that you want to simulate. Bochs has already searched for a
|
||
|
|
configuration file (typically called bochsrc.txt) and loaded it if it
|
||
|
|
could be found. When you are satisfied with the configuration, go
|
||
|
|
ahead and start the simulation.
|
||
|
|
|
||
|
|
You can also start bochs with the -q option to skip these menus.
|
||
|
|
|
||
|
|
1. Restore factory default configuration
|
||
|
|
2. Read options from...
|
||
|
|
3. Edit options
|
||
|
|
4. Save options to...
|
||
|
|
5. Begin simulation
|
||
|
|
6. Quit now
|
||
|
|
|
||
|
|
Please choose one: [5]</PRE
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>Here you can load, edit and save the configuration and finally start the simulation.
|
||
|
|
It is possible to start Bochs without a config file and to edit all the settings using
|
||
|
|
the item "Edit options". Don't forget to save the configuration if you want to use this
|
||
|
|
setup for another Bochs session.</P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H2
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="HEADERBAR"
|
||
|
|
>5.3.2. The Bochs headerbar</A
|
||
|
|
></H2
|
||
|
|
><P
|
||
|
|
><P
|
||
|
|
><IMG
|
||
|
|
SRC="../images/headerbar.png"></P
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>The headerbar appears on top of the Bochs simulation window. Here you can control the
|
||
|
|
behavoiur of Bochs at runtime if you click on one of these buttons:
|
||
|
|
<P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>floppy buttons</P
|
||
|
|
><P
|
||
|
|
> Here you can toggle the status of the floppy media (inserted/ejected). Bochs for
|
||
|
|
win32 presents you a small dialog box for changing the floppy image. You can
|
||
|
|
setup floppy drives using <A
|
||
|
|
HREF="bochsrc.html#BOCHSOPT-FLOPPYAB"
|
||
|
|
>floppya/floppyb option</A
|
||
|
|
>.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>cdrom button</P
|
||
|
|
><P
|
||
|
|
> Here you can toggle the status of the cdrom media (inserted/ejected). CD-ROM drives
|
||
|
|
can be set up using <A
|
||
|
|
HREF="bochsrc.html#BOCHSOPT-ATA-MASTER-SLAVE"
|
||
|
|
>ata(0-3)-master/-slave option</A
|
||
|
|
>.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>mouse button</P
|
||
|
|
><P
|
||
|
|
> Here you can enable the creation of mouse events by the host. Once mouse
|
||
|
|
events are captured, you cannot reach the button anymore, in order to disable
|
||
|
|
capturing again. In this case, use "Ctrl+3rd mouse button" to disable it.</P
|
||
|
|
><P
|
||
|
|
><IMG
|
||
|
|
SRC="../images/undercon.png"> Support for 2 button mouse to toggle the capture mode not yet complete.
|
||
|
|
Some display libraries still don't support the new feature, but
|
||
|
|
it is already supported on X11, SDL, wxWidgets and Win32.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>user button</P
|
||
|
|
><P
|
||
|
|
> Press this button if you want to send the keyboard shortcut defined with the
|
||
|
|
<A
|
||
|
|
HREF="bochsrc.html#BOCHSOPT-USER-SHORTCUT"
|
||
|
|
>user_shortcut option</A
|
||
|
|
> to the guest.
|
||
|
|
Depending on the used <A
|
||
|
|
HREF="bochsrc.html#BOCHSOPT-DISPLAYLIBRARY"
|
||
|
|
>display_library option</A
|
||
|
|
>,
|
||
|
|
it may even be possible to edit the shortcut before sending it.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>copy button</P
|
||
|
|
><P
|
||
|
|
>The text mode screen text can be exported to the clipboard after pressing this
|
||
|
|
button. The button has no effect in graphics mode.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>paste button</P
|
||
|
|
><P
|
||
|
|
>Text in the clipboard can also be pasted, through Bochs, to the
|
||
|
|
guest OS, as simulated keystrokes. Keyboard mapping must be enabled to make this
|
||
|
|
feature work.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>snapshot button</P
|
||
|
|
><P
|
||
|
|
>Press this button if you want to save a snapshot of the text mode screen.
|
||
|
|
Bochs for win32 presents you a "Save as..." dialog box. All other platforms are
|
||
|
|
using the fixed filename "snapshot.txt".</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>config button</P
|
||
|
|
><P
|
||
|
|
>This button stops the Bochs simulation and starts the runtime configuration.
|
||
|
|
(see below).</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>reset button</P
|
||
|
|
><P
|
||
|
|
>Press this button to trigger a hardware reset.</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>power button</P
|
||
|
|
><P
|
||
|
|
>This button stops the simulation and quits bochs.</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>Some of this features may not be implemented or work different on your host platform.</P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H2
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="AEN2539"
|
||
|
|
>5.3.3. The runtime configuration</A
|
||
|
|
></H2
|
||
|
|
><P
|
||
|
|
>If you want to change certain settings at runtime, you have to press the "config" button in
|
||
|
|
the headerbar. The simulation stops and the runtime menu appears on the console window / xterm.
|
||
|
|
<TABLE
|
||
|
|
BORDER="0"
|
||
|
|
BGCOLOR="#E0E0E0"
|
||
|
|
WIDTH="100%"
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
><PRE
|
||
|
|
CLASS="SCREEN"
|
||
|
|
>---------------------
|
||
|
|
Bochs Runtime Options
|
||
|
|
---------------------
|
||
|
|
1. Floppy disk 0: /dev/fd0, size=1.44M, inserted
|
||
|
|
2. Floppy disk 1: floppyb.img, size=1.44M, inserted
|
||
|
|
3. 1st CDROM: (master on ata1) /dev/cdrom, ejected
|
||
|
|
4. 2nd CDROM: (slave on ata1) /dev/cdrecorder, ejected
|
||
|
|
5. 3rd CDROM: (not present)
|
||
|
|
6. 4th CDROM: (not present)
|
||
|
|
7. (not implemented)
|
||
|
|
8. Log options for all devices
|
||
|
|
9. Log options for individual devices
|
||
|
|
10. VGA Update Interval: 100000
|
||
|
|
11. Mouse: disabled
|
||
|
|
12. Keyboard paste delay: 100000
|
||
|
|
13. Userbutton shortcut: ctrlaltdel
|
||
|
|
14. Instruction tracing: off (doesn't exist yet)
|
||
|
|
15. Continue simulation
|
||
|
|
16. Quit now
|
||
|
|
|
||
|
|
Please choose one: [15] </PRE
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>In the runtime configuration you can change the floppy/cdrom image or device,
|
||
|
|
change the log options or adjust some other settings. If you have trouble with
|
||
|
|
a specific device, you can change the log options for this device only to get
|
||
|
|
more information (e.g. report debug messages). This cannot be done in the configuration
|
||
|
|
file yet.</P
|
||
|
|
></DIV
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="NAVFOOTER"
|
||
|
|
><HR
|
||
|
|
ALIGN="LEFT"
|
||
|
|
WIDTH="100%"><TABLE
|
||
|
|
SUMMARY="Footer navigation table"
|
||
|
|
WIDTH="100%"
|
||
|
|
BORDER="0"
|
||
|
|
CELLPADDING="0"
|
||
|
|
CELLSPACING="0"
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="search-order.html"
|
||
|
|
ACCESSKEY="P"
|
||
|
|
>Prev</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="34%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="index.html"
|
||
|
|
ACCESSKEY="H"
|
||
|
|
>Home</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="using-save-restore.html"
|
||
|
|
ACCESSKEY="N"
|
||
|
|
>Next</A
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="top"
|
||
|
|
>Search order for the configuration file</TD
|
||
|
|
><TD
|
||
|
|
WIDTH="34%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="using-bochs.html"
|
||
|
|
ACCESSKEY="U"
|
||
|
|
>Up</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="top"
|
||
|
|
>Save and restore simulation</TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
></DIV
|
||
|
|
></BODY
|
||
|
|
></HTML
|
||
|
|
>
|