- cleaned up, added some more detail about tools

This commit is contained in:
Bryce Denney 2001-06-02 00:45:13 +00:00
parent e6496cfce9
commit ea4ac33e96

View File

@ -41,8 +41,11 @@ A.sidebar:hover {color: blue; text-decoration: underline}
<BR> <BR>
<BR> <BR>
This page contains information about Bochs which is specific to the This file is an introduction to Bochs, written for Windows users. It assumes
Windows binary package. <BR><BR> that you have just downloaded a Bochs binary distribution, and now you want to
see it work!
<BR><BR>
<font face="arial, helvetica" color="#1e029a" size="4"> <font face="arial, helvetica" color="#1e029a" size="4">
<b>Contents</b> <b>Contents</b>
@ -51,12 +54,13 @@ Windows binary package. <BR><BR>
<ul> <ul>
<li><a href="#recent">Where is the most recent version?</a> <li><a href="#recent">Where is the most recent version?</a>
<li><a href="#files">What files are installed?</a> <li><a href="#files">What files were installed?</a>
<li>Where's the <a href="docs-html/faq.html">FAQ</a>?
<li>Where is the rest of the documentation? (<a href="docs-html/index.html">local copy</a> - <a href="http://bochs.sourceforge.net/docs-html">online</a>)
<li><a href="#quickstart">How can I try out Bochs in 5 minutes or less?</a> <li><a href="#quickstart">How can I try out Bochs in 5 minutes or less?</a>
<li><a href="#learnmore">Ok, it runs, but how do you....</a>
<li><a href="#tools">What tools are included in this package?</a> <li><a href="#tools">What tools are included in this package?</a>
<li>pointers to all the rest of the documentation (<a href="docs-html/index.html">local copy</a> - <a href="http://bochs.sourceforge.net/docs-html">online</a>) <li><a href="#learnmore">How do I learn more?</a>
<li>link to <a href="http://bochs.sourceforge.net">web site</a> <li>Do you guys have a website? <a href="http://bochs.sourceforge.net">Take me there!</a>
</ul> </ul>
@ -67,14 +71,16 @@ Windows binary package. <BR><BR>
<BR> <BR>
All versions of Bochs can be downloaded from the Bochs website at All versions of Bochs can be downloaded from the Bochs website at
<a href="http://bochs.sourceforge.net"> http://bochs.sourceforge.net </a>. <a href="http://bochs.sourceforge.net"> http://bochs.sourceforge.net </a>.
On the web site, you can download Bochs, learn about In the top-left corner of the web page, there is a link to the latest
the bochs-developers mailing list, submit bug reports, and much more. release. On the web site, in addition to downloading Bochs, you can join
the bochs-developers or bochs-announce mailing lists, submit bug reports,
view the source code, and much more.
<BR> <BR>
<a name="files"> <a name="files">
<BR> <BR>
<font face="arial, helvetica" color="#1e029a" size="4"> <font face="arial, helvetica" color="#1e029a" size="4">
<b>What files are installed?</b> <b>What files were installed?</b>
</font> </font>
<BR> <BR>
When you install a Bochs binary release for win32, you get the Bochs When you install a Bochs binary release for win32, you get the Bochs
@ -82,8 +88,9 @@ executables and tools, ROM image files, documentation, and a sample disk image
that allows Bochs to boot Linux. Once you unzip the Bochs ZIP file, here is a that allows Bochs to boot Linux. Once you unzip the Bochs ZIP file, here is a
list of the files that are installed, and a brief description of each one. The list of the files that are installed, and a brief description of each one. The
files which can be viewed in text form are shown as links. files which can be viewed in text form are shown as links.
<br>
<table border=1> <table align=center border=1>
<th>File name </th> <th> Description </th> <th>File name </th> <th> Description </th>
<tr><td><a href="README.txt ">README.txt </a></td> <td> the ReadMe file from the source distribution. </td> </tr> <tr><td><a href="README.txt ">README.txt </a></td> <td> the ReadMe file from the source distribution. </td> </tr>
<tr><td><a href="COPYING.txt ">COPYING.txt </a></td> <td> copy of the LGPL license </td> </tr> <tr><td><a href="COPYING.txt ">COPYING.txt </a></td> <td> copy of the LGPL license </td> </tr>
@ -110,15 +117,18 @@ files which can be viewed in text form are shown as links.
<a name="quickstart"> <a name="quickstart">
<BR> <BR>
<font face="arial, helvetica" color="#1e029a" size="4"> <font face="arial, helvetica" color="#1e029a" size="4">
<b>How can I try out Bochs in 5 minutes or less?</b> <b>How can I try out Bochs in 10 minutes or less?</b>
</font> </font>
<BR> <BR>
This package includes a sample disk image of DLX Linux, which you can boot This package includes a sample disk image containing DLX Linux, which you can
within Bochs. Use the Windows Explorer to find c:\bochs\dlxlinux\start.bat, boot within Bochs. Use the Windows Explorer to find
and double-click start.bat. This will launch two windows: one is the Bochs c:\bochs\dlxlinux\start.bat, and double-click start.bat. This will launch two
Display window, and the other is text window that shows Bochs log messages. windows: one is the Bochs Display window, and the other is text window that
You may notice that your mouse pointer has disappeared into the Bochs window. shows Bochs log messages. Normally the display window is the most
Press F12 to get the cursor back. interesting, but if something goes wrong the log messages should give
an idea of what has happened. You may notice that your mouse pointer has
disappeared into the Bochs Display window. Press F12 to get the cursor
back.
<br><br> <br><br>
Meanwhile, the Bochs display screen looks like a PC booting, and in fact it is! Meanwhile, the Bochs display screen looks like a PC booting, and in fact it is!
Bochs begins simulating a PC from the time the power turns on. You will see Bochs begins simulating a PC from the time the power turns on. You will see
@ -137,57 +147,55 @@ prompt, type "root". On UNIX systems, root is the system admin user.
There is no password for root on this image, so it lets you log in There is no password for root on this image, so it lets you log in
immediately. Now you should see a UNIX prompt, and you can begin to immediately. Now you should see a UNIX prompt, and you can begin to
type UNIX commands. type UNIX commands.
<BR> <BR><br>
<center>
<table border=1> <table border=1>
<td> <td>
<PRE> <PRE>
Welcome to DLX V1.0 (C) 1995-96 Erich Boehm Welcome to DLX V1.0 (C) 1995-96 Erich Boehm
(C) 1995 Hannes Boehm (C) 1995 Hannes Boehm
dlx login: root dlx login: <b>root</b>
Linux 1.3.89. Linux 1.3.89.
dlx:~# pwd dlx:~# <b>pwd</b>
/root /root
dlx:~# cd / dlx:~# <b>cd /</b>
dlx:~# ls dlx:~# <b>ls</b>
bin/ etc/ lost+found/ root/ usr/ bin/ etc/ lost+found/ root/ usr/
boot/ fd/ mnt/ sbin/ var/ boot/ fd/ mnt/ sbin/ var/
dev/ lib/ proc/ tmp/ zip/ dev/ lib/ proc/ tmp/ zip/
dlx:/# df dlx:/# <b>df</b>
Filesystem 1024-blocks Used Available Capacity Mounted on Filesystem 1024-blocks Used Available Capacity Mounted on
/dev/hda1 10060 2736 6005 29% /dlx login: root /dev/hda1 10060 2736 6005 29% /
dlx:/# _ dlx:/# _
</PRE> </PRE>
</td> </td>
</table> </table>
</center>
<br> <br>
One thing you may notice is that the screen saver (blank screen) turns on very One thing you may notice is that the screen saver turns on (screen goes
quickly when you have stopped typing. What's happening is that Bochs always blank) very quickly when you have stopped typing. The reason is that Bochs
simulates as fast as it can. If the CPU is very busy (running instructions always simulates as fast as it can. If the CPU is very busy (running
nonstop), simulated time goes by slowly. If the CPU is idle, for example instructions nonstop), simulated time goes by slowly. If the CPU is idle (just
waiting for a keypress, simulated time speeds up dramatically. If the screen waiting for you to type, for example), simulated time speeds up dramatically.
saver blanks out the screen, just press a key (shift or control) to restore the In any case, If the screen saver blanks out the screen, just press a key (try
screen. shift or control) to restore the screen.
<br> <br>
<br> <br>
When you get tired of playing with UNIX, just type "reboot" to shut When you get tired of playing with UNIX, just type "reboot" to shut
down the Linux operating system. You can also press the "Power" button to stop the simulation. down the Linux operating system. You can also press the "Power" button to stop the simulation.
<br>
<BR> <br>
<a name="learnmore"> In this brief introduction you saw how Bochs can boot and run an x86 operating
<BR> system in a window. It doesn't have to be Linux, of course! Various people
<font face="arial, helvetica" color="#1e029a" size="4"> have been able to install and run DOS, Windows 3.1, Windows 95, Windows 98,
<b>Ok, it runs, but how do you....</b> Windows NT, Linux, FreeBSD, NetBSD, OpenBSD, and probably others that we've
</font> never even heard of. In fact Bochs is used by many operating system developers
<BR> to test out their software in a controlled environment without having to
Here are some sources of more information about Bochs: reboot their development machine.
<ul> <br><br>
<li> The rest of the documentation (<a href="docs-html/index.html">local copy</a> - <a href="http://bochs.sourceforge.net/docs-html">online</a>)
<li> bochs-developers mailing list ( <a href="http://bochs.sourceforge.net/mailinglists.html"> online </a>)
</ul>
<a name="tools"> <a name="tools">
<BR> <BR>
<font face="arial, helvetica" color="#1e029a" size="4"> <font face="arial, helvetica" color="#1e029a" size="4">
@ -195,19 +203,87 @@ Here are some sources of more information about Bochs:
</font> </font>
<BR> <BR>
There are two tools for win32: bximage and sb16ctrl. There are two tools for win32: bximage and sb16ctrl.
<br><br>
<font face="arial, helvetica" color="#1e029a" size="3">
<b>bximage</b>
</font>
<BR>
Bximage is a small program that helps to create empty floppy disk Bximage is a small program that helps to create empty floppy disk
and hard disk images. To use it, you should run bximage in an MSDOS window. and hard disk images. To use it, you should run bximage in an MSDOS window.
(You could also double-click on it, but then you won't be able to read the last (You could also double-click on it, but then you won't be able to read the last
few lines of output before the window disappears.) Just CD to the directory few lines of output before the window disappears.) Just CD to the directory
where you want the disk images to go, and run bximage. Bximage will ask you where you want the disk images to go, and run bximage. Bximage will ask you
some questions about what type of disk image you need, and then create one for some questions about what type of disk image you need, and then create one for
you. you.
<br><br>
Here is an example run of bximage, in which I made a 12-meg hard disk image called c.img. The default answer to a question is always printed in brackets.
If you want to accept the default choice, you can just press return. Also,
you can always quit bximage by pressing Control-C.
<br><br>
<table align=center border=1>
<td>
<pre>
c:\bochs> <b>bximage</b>
========================================================================
bximage
Disk Image Creation Tool for Bochs
$Id: DOC-win32.htm,v 1.3 2001-06-02 00:45:13 bdenney Exp $
========================================================================
Do you want to create a floppy disk image or a hard disk image?
Please type hd or fd. [hd]
Enter the hard disk size in megabytes, between 1 and 32255
[10] <b>12</b>
I will create a hard disk image with
cyl=24
heads=16
sectors per track=63
total sectors=24192
total size=11.81 megabytes
What should I name the image?
[c.img]
Writing: [............] Done.
I wrote 12386304 bytes to c.img.
The following line should appear in your bochsrc:
diskc: file="c.img", cyl=24, heads=16, spt=63
</pre>
</td>
</table>
<br><br>
In order for Bochs to know to use the hard disk image, you should type
the diskc line into your bochsrc.txt. You can also change it to diskd
if you already have a diskc line, but be careful not to have both
diskd and cdromd--these options cannot be used together.
<br><br> <br><br>
<font face="arial, helvetica" color="#1e029a" size="3">
<b>sb16ctrl</b>
</font>
<BR>
The other tool for windows is called sb16ctrl, and it is used to configure The other tool for windows is called sb16ctrl, and it is used to configure
the Bochs emulated sound blaster. (If you know any more about it please the Bochs emulated sound blaster. (If you know any more about it please
post a description to bochs-developers.) post a description to bochs-developers.)
<br><br>
<a name="learnmore">
<BR>
<font face="arial, helvetica" color="#1e029a" size="4">
<b>Where can I learn more?</b>
</font>
<BR>
Here are some sources of more information about Bochs:
<ul>
<li> The rest of the documentation (<a href="docs-html/index.html"> local copy</a> - <a href="http://bochs.sourceforge.net/docs-html">online</a>)
<li> The bochs-developers mailing list ( <a href="http://bochs.sourceforge.net/mailinglists.html"> online </a>)
<li> The Bochs website at <a href="http://bochs.sourceforge.net">http://bochs.sourceforge.net</a> has a collection of disk images of different operating systems. Some disk images are the size of a floppy disk (1 meg compressed) and others are gigantic (160 meg compressed). ( <a href="http://bochs.sourceforge.net/diskimages.html">Go there</a> )
</ul>
</BODY> </BODY>
</HTML> </HTML>