Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.
Michael Brown a30c70727a [contrib] Bring bochs/qemu READMEs up to date with latest upstream code 16 роки тому
..
.gitignore Ignore external directories (bochs, qemu) within contrib/bochs. 17 роки тому
Makefile Added tunctl (since it is difficult to find for many distros). 18 роки тому
README [contrib] Bring bochs/qemu READMEs up to date with latest upstream code 16 роки тому
README.qemu [contrib] Bring bochs/qemu READMEs up to date with latest upstream code 16 роки тому
README.windows-ris Don't build option-overloaded packets; they just confuse people (ISC DHCPD and Windows RIS in particular). 17 роки тому
bochsrc.txt Build bochs with ne2000 support, and add sample lines in bochsrc.txt to match. 17 роки тому
qemu-patch Document requisite patch for qemu 18 роки тому
serial-console Updated to syntax required by latest bochs CVS. 18 роки тому
serial-console.1 Initial revision 19 роки тому
tunctl.c Added tunctl (since it is difficult to find for many distros). 18 роки тому

README

Running Etherboot within Bochs
==============================

Michael Brown <mbrown@fensystems.co.uk>
Based on an idea suggested by H. Peter Anvin <hpa@zytor.com>.

$Id$

Bochs is a program that simulates a complete Intel x86 computer,
including hardware. It can be used to test Etherboot. There is a
special pseudo NIC ("pnic") implemented in Bochs, with a corresponding
driver in Etherboot. (There is also an NE2000 ISA driver in Bochs,
but it doesn't seem to quite work.)

To get bochs running is fairly simple:

1. Build the utilities in this directory:
make

2. Get the bochs source code:
cvs -d:pserver:anonymous@bochs.cvs.sourceforge.net:/cvsroot/bochs \
login
cvs -d:pserver:anonymous@bochs.cvs.sourceforge.net:/cvsroot/bochs \
co bochs

3. Configure bochs with
pushd bochs
./configure --enable-all-optimisations --enable-show-ips \
--enable-cpu-level=6 \
--enable-pci --enable-pnic --enable-ne2000 \
--enable-debugger --enable-disasm
popd

4. Build bochs:
make -C bochs

5. As root, set up a TAP virtual network device:
/sbin/modprobe tun
chmod o+rw /dev/net/tun
./tunctl -u <username> -t tap0
/sbin/ifconfig tap0 up 10.254.254.2 netmask 255.255.255.0

6. As root, add the following fragment to /etc/dhcpd.conf:
subnet 10.254.254.0 netmask 255.255.255.252 {
range dynamic-bootp 10.254.254.1 10.254.254.1;
}
You will also need to add in any of your usual declarations for
Etherboot, e.g. 'filename "vmlinuz.ltsp";'. Note that this setup
assumes that your DHCP server, TFTP server etc. all live on the
machine you are using for running Bochs. If not, then you're on
your own.

7. As root, restart dhcpd
/etc/init.d/dhcpd restart

8. Build Etherboot images
pushd ../../src
make bin/pnic.dsk
popd

9. Start Bochs
./bochs/bochs -q
You should get to the debugger prompt "<bochs:1>". Type "c" to
start running Bochs.

You should see Bochs start up, load up Etherboot and attempt to boot
from the network.



Serial console
==============

You can use the program "serial-console" to obtain a virtual serial
console for Etherboot running within Bochs. Simply run
"./serial-console" on a spare tty (e.g. a separate xterm window)
before starting Bochs, and ensure that you have enabled CONSOLE_SERIAL
in config.h.

There is a manual page for "serial-console"; use
"man ./serial-console.1" to view it.



TODO
====

Packet forwarding/masquerading - document what must be set up.

Mention possibility of using RFB as the display device - in
conjunction with the serial console, gives you a test facility that
can be accessed remotely.

Mention use of BOCHSBP instruction (xchgw %bx,%bx) to avoid need to
calculate breakpoints.