Corrected documentation
[people/xl0/gpxe.git] / contrib / bochs / README
index 8495e3c..20ea44a 100644 (file)
@@ -14,25 +14,31 @@ but it doesn't seem to quite work.)
 
 To get bochs running is fairly simple:
 
 
 To get bochs running is fairly simple:
 
-1.  Get the bochs source code:
-      cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bochs login
-      cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bochs co bochs
+1.  Build the utilities in this directory:
+      make
 
 
-2.  Configure bochs with
+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
       pushd bochs
-      ./configure --enable-all-optimisations --enable-pci --enable-pnic
+      ./configure --enable-all-optimisations --enable-pci --enable-pnic \
                   --enable-debugger --enable-magic-breakpoints --enable-disasm
       popd
 
                   --enable-debugger --enable-magic-breakpoints --enable-disasm
       popd
 
-3.  Build bochs:
+4.  Build bochs:
       make -C bochs
 
       make -C bochs
 
-4.  Set up a TAP virtual network device:
-      modprobe tun
-      tunctl -u <username> -t tap0
-      ifconfig tap0 up 10.254.254.2 netmask 255.255.255.0
+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
 
 
-5.  Add the following fragment to /etc/dhcpd.conf:
+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;
       }
       subnet 10.254.254.0 netmask 255.255.255.252 {
         range dynamic-bootp 10.254.254.1 10.254.254.1;
       }
@@ -42,15 +48,15 @@ To get bochs running is fairly simple:
     machine you are using for running Bochs.  If not, then you're on
     your own.
 
     machine you are using for running Bochs.  If not, then you're on
     your own.
 
-6.  Restart dhcpd
+7.  As root, restart dhcpd
       /etc/init.d/dhcpd restart
 
       /etc/init.d/dhcpd restart
 
-7.  Build Etherboot images
+8.  Build Etherboot images
       pushd ../../src
       make bin/pnic.dsk
       popd
 
       pushd ../../src
       make bin/pnic.dsk
       popd
 
-8.  Start Bochs
+9.  Start Bochs
       ./bochs/bochs -q
     You should get to the debugger prompt "<bochs:1>".  Type "c" to
     start running Bochs.
       ./bochs/bochs -q
     You should get to the debugger prompt "<bochs:1>".  Type "c" to
     start running Bochs.
@@ -66,9 +72,8 @@ 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)
 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 compiled Etherboot
-with appropriate settings such as
-  CFLAGS+= -DCONSOLE_DUAL -DCOMCONSOLE=0x3F8 -DCONSPEED=9600
+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.
 
 There is a manual page for "serial-console"; use
 "man ./serial-console.1" to view it.