diff --git a/bochs/build/win32/DOC-win32.htm b/bochs/build/win32/DOC-win32.htm index a3c5689df..1d3a5cc74 100755 --- a/bochs/build/win32/DOC-win32.htm +++ b/bochs/build/win32/DOC-win32.htm @@ -41,8 +41,11 @@ A.sidebar:hover {color: blue; text-decoration: underline}

-This page contains information about Bochs which is specific to the -Windows binary package.

+This file is an introduction to Bochs, written for Windows users. It assumes +that you have just downloaded a Bochs binary distribution, and now you want to +see it work! + +

Contents @@ -51,12 +54,13 @@ Windows binary package.

@@ -67,14 +71,16 @@ Windows binary package.


All versions of Bochs can be downloaded from the Bochs website at http://bochs.sourceforge.net . -On the web site, you can download Bochs, learn about -the bochs-developers mailing list, submit bug reports, and much more. +In the top-left corner of the web page, there is a link to the latest +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.

-What files are installed? +What files were installed?
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 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. +
- +
@@ -110,15 +117,18 @@ files which can be viewed in text form are shown as links.
-How can I try out Bochs in 5 minutes or less? +How can I try out Bochs in 10 minutes or less?
-This package includes a sample disk image of DLX Linux, which you can boot -within Bochs. Use the Windows Explorer to find c:\bochs\dlxlinux\start.bat, -and double-click start.bat. This will launch two windows: one is the Bochs -Display window, and the other is text window that shows Bochs log messages. -You may notice that your mouse pointer has disappeared into the Bochs window. -Press F12 to get the cursor back. +This package includes a sample disk image containing DLX Linux, which you can +boot within Bochs. Use the Windows Explorer to find +c:\bochs\dlxlinux\start.bat, and double-click start.bat. This will launch two +windows: one is the Bochs Display window, and the other is text window that +shows Bochs log messages. Normally the display window is the most +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.

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 @@ -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 immediately. Now you should see a UNIX prompt, and you can begin to type UNIX commands. -
+

+
File name Description
README.txt the ReadMe file from the source distribution.
COPYING.txt copy of the LGPL license 
   Welcome to DLX V1.0 (C) 1995-96 Erich Boehm
                       (C) 1995    Hannes Boehm
 
-  dlx login: root
+  dlx login: root
   Linux 1.3.89.
-  dlx:~# pwd
+  dlx:~# pwd
   /root
-  dlx:~# cd /
-  dlx:~# ls
+  dlx:~# cd /
+  dlx:~# ls
   bin/       etc/       lost+found/       root/       usr/
   boot/      fd/        mnt/              sbin/       var/
   dev/       lib/       proc/             tmp/        zip/
-  dlx:/# df
+  dlx:/# df
   Filesystem    1024-blocks   Used  Available Capacity Mounted on
-  /dev/hda1        10060      2736      6005     29%   /dlx login: root
+  /dev/hda1        10060      2736      6005     29%   /
   dlx:/# _
+
-One thing you may notice is that the screen saver (blank screen) turns on very -quickly when you have stopped typing. What's happening is that Bochs always -simulates as fast as it can. If the CPU is very busy (running instructions -nonstop), simulated time goes by slowly. If the CPU is idle, for example -waiting for a keypress, simulated time speeds up dramatically. If the screen -saver blanks out the screen, just press a key (shift or control) to restore the -screen. +One thing you may notice is that the screen saver turns on (screen goes +blank) very quickly when you have stopped typing. The reason is that Bochs +always simulates as fast as it can. If the CPU is very busy (running +instructions nonstop), simulated time goes by slowly. If the CPU is idle (just +waiting for you to type, for example), simulated time speeds up dramatically. +In any case, If the screen saver blanks out the screen, just press a key (try +shift or control) to restore the screen.

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. - -
- -
- -Ok, it runs, but how do you.... - -
-Here are some sources of more information about Bochs: - - +
+
+In this brief introduction you saw how Bochs can boot and run an x86 operating +system in a window. It doesn't have to be Linux, of course! Various people +have been able to install and run DOS, Windows 3.1, Windows 95, Windows 98, +Windows NT, Linux, FreeBSD, NetBSD, OpenBSD, and probably others that we've +never even heard of. In fact Bochs is used by many operating system developers +to test out their software in a controlled environment without having to +reboot their development machine. +


@@ -195,19 +203,87 @@ Here are some sources of more information about Bochs:
There are two tools for win32: bximage and sb16ctrl. +

+ + +bximage + +
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. (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 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 -you. +you. +

+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. +

+ + +
+
+c:\bochs> bximage
+========================================================================
+                                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] 12
+
+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
+
+
+

+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.

+ +sb16ctrl + +
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 post a description to bochs-developers.) +

+ +
+ +Where can I learn more? + +
+Here are some sources of more information about Bochs: +