- cleaned up, added some more detail about tools
This commit is contained in:
parent
e6496cfce9
commit
ea4ac33e96
@ -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>
|
||||||
|
Loading…
Reference in New Issue
Block a user