Browse Source

Updated instructions to reflect current reality.

tags/v0.9.3
Michael Brown 19 years ago
parent
commit
82c4afcb32
1 changed files with 24 additions and 57 deletions
  1. 24
    57
      contrib/bochs/README

+ 24
- 57
contrib/bochs/README View File

15
 To get bochs running is fairly simple:
15
 To get bochs running is fairly simple:
16
 
16
 
17
 1.  Get the bochs source code:
17
 1.  Get the bochs source code:
18
-    a)  cvs -d:pserver:anonymous:@cvs.sourceforge.net:/cvsroot/bochs login
18
+      cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bochs login
19
-    b)  cvs -d:pserver:anonymous:@cvs.sourceforge.net:/cvsroot/bochs co bochs
19
+      cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/bochs co bochs
20
 
20
 
21
 2.  Configure bochs with
21
 2.  Configure bochs with
22
-      ./configure --enable-all-optimisations --enable-pci \
22
+      pushd bochs
23
-	 	 --enable-ne2000 --enable-pnic
23
+      ./configure --enable-all-optimisations --enable-pci --enable-pnic
24
-    Other potentially useful configure options:
24
+                  --enable-debugger --enable-magic-breakpoints --enable-disasm
25
-      --prefix=/usr
25
+      popd
26
-          to force use of standard file locations
27
-      --enable-debugger
28
-          to enable the internal debugger
29
 
26
 
30
 3.  Build bochs:
27
 3.  Build bochs:
31
-      make
28
+      make -C bochs
32
 
29
 
33
-4.  Configure Etherboot with CONFIG_PCI_DIRECT: add the line
30
+4.  Set up a TAP virtual network device:
34
-      CFLAGS += -DCONFIG_PCI_DIRECT
35
-    to the end of src/arch/i386/Config.
36
-
37
-5.  Build bin/pnic.zrom:
38
-      make bin/pnic.zrom
39
-
40
-6.  Load the TUN/TAP kernel module:
41
       modprobe tun
31
       modprobe tun
42
-    You should see the device /dev/net/tun is created automatically if
32
+      tunctl -u <username> -t tap0
43
-    you're using devfs, otherwise you may have to create it by hand with:
33
+      ifconfig tap0 up 10.254.254.2 netmask 255.255.255.0
44
-      mknod /dev/net/tun c 10 200
45
-
46
-7.  Grant yourself write access to /dev/net/tun:
47
-      su -c 'chown <your user id> /dev/net/tun'
48
-    The alternative to this is to run Bochs as root.  Don't do that.
49
 
34
 
50
-8.  Add the following fragment to /etc/dhcpd.conf:
35
+5.  Add the following fragment to /etc/dhcpd.conf:
51
       subnet 10.254.254.0 netmask 255.255.255.252 {
36
       subnet 10.254.254.0 netmask 255.255.255.252 {
52
         range dynamic-bootp 10.254.254.1 10.254.254.1;
37
         range dynamic-bootp 10.254.254.1 10.254.254.1;
53
       }
38
       }
57
     machine you are using for running Bochs.  If not, then you're on
42
     machine you are using for running Bochs.  If not, then you're on
58
     your own.
43
     your own.
59
 
44
 
60
-9.  Change back to this directory and run bochs from your Bochs source tree:
45
+6.  Restart dhcpd
61
-      cd /path/to/Etherboot/contrib/bochs
46
+      /etc/init.d/dhcpd restart
62
-      /path/to/bochs/source/tree/bochs
63
-
64
-10. Select option 5 (Begin simulation).  You will be prompted for your
65
-    root password.  This is required in order to configure the tun1
66
-    network interface and to restart the DHCP server.
67
-
68
-11. You should see Bochs start up and attempt to boot from the network,
69
-    with a screen that looks like:
70
-
71
-VGA BIOS - Version 2.40
72
-Copyright (C) 1990-2000 Elpin Systems, Inc.
73
-All rights reserved.
74
-
75
-Licensed for use with bochs, courtesy of MandrakeSoft.
76
-
77
-For information on this or other VGA development products, contact
78
-Elpin Systems at: (800) 723-9038 or www.elpin.com
79
-
80
-Bochs BIOS, 1 cpu, $Revision$ $Date$
81
-
82
 
47
 
83
-Etherboot 5.3.6 (GPL) http://etherboot.org Tagged ELF for [PNIC]
48
+7.  Build Etherboot images
84
-Relocating _text from: [00091020,0009fb50) to [01ef14d0,01f00000)
49
+      pushd ../../src
85
-Boot from (N)etwork or (Q)uit?
50
+      make bin/pnic.dsk
51
+      popd
86
 
52
 
87
-Probing pci nic...
53
+8.  Start Bochs
88
-[pnic] - Detected Bochs Pseudo NIC MAC FE:FD:00:00:00:01 (API v1.0) at 0xdc00
54
+      ./bochs/bochs -q
89
-Searching for server (DHCP)...
55
+    You should get to the debugger prompt "<bochs:1>".  Type "c" to
90
-..Me: 10.254.254.1, Server: 10.254.254.2
56
+    start running Bochs.
91
-Loading 10.254.254.2:/tftpboot/kernel
92
 
57
 
58
+You should see Bochs start up, load up Etherboot and attempt to boot
59
+from the network.
93
 
60
 
94
 
61
 
95
 
62
 
101
 "./serial-console" on a spare tty (e.g. a separate xterm window)
68
 "./serial-console" on a spare tty (e.g. a separate xterm window)
102
 before starting Bochs, and ensure that you have compiled Etherboot
69
 before starting Bochs, and ensure that you have compiled Etherboot
103
 with appropriate settings such as
70
 with appropriate settings such as
104
-  CFLAGS+=      -DCONSOLE_DUAL -DCOMCONSOLE=0x3F8 -DCONSPEED=9600
71
+  CFLAGS+= -DCONSOLE_DUAL -DCOMCONSOLE=0x3F8 -DCONSPEED=9600
105
 
72
 
106
 There is a manual page for "serial-console"; use
73
 There is a manual page for "serial-console"; use
107
 "man ./serial-console.1" to view it.
74
 "man ./serial-console.1" to view it.

Loading…
Cancel
Save