diff options
author | Marty Connor | 2010-01-17 03:47:39 +0100 |
---|---|---|
committer | Marty Connor | 2010-01-17 03:47:39 +0100 |
commit | 330abebddf67ab27998f64070f27d5874cbc7b06 (patch) | |
tree | 08f5954725930ee9c38b0afab4cb9a30c71ce7e3 /contrib/bochs/README | |
parent | [sanboot] Prevent leaking a stack reference for "keep-san" AoE (diff) | |
download | ipxe-330abebddf67ab27998f64070f27d5874cbc7b06.tar.gz ipxe-330abebddf67ab27998f64070f27d5874cbc7b06.tar.xz ipxe-330abebddf67ab27998f64070f27d5874cbc7b06.zip |
[contrib] Move most contrib content to a separate repository
Most of the content that was previously in this directory has been
moved to a separate git repository:
http://git.etherboot.org/?p=contrib.git;a=summary
or the Etherboot Project wiki:
http://etherboot.org/
Diffstat (limited to 'contrib/bochs/README')
-rw-r--r-- | contrib/bochs/README | 95 |
1 files changed, 0 insertions, 95 deletions
diff --git a/contrib/bochs/README b/contrib/bochs/README deleted file mode 100644 index e0e88032..00000000 --- a/contrib/bochs/README +++ /dev/null @@ -1,95 +0,0 @@ -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. |