Below is the promised readme patch.
I didn't include vga.pcf in the patch; Ulrich, please take this file from
the font/ directory in BOCHS, and put it in freemware/misc.
-- Ramon
diff -Nur freemware-old/README freemware/README
--- freemware-old/README Mon Jan 24 11:32:54 2000
+++ freemware/README Mon Jan 24 11:43:39 2000
@@ -20,13 +20,23 @@
|
|--- kernel contains the sources for the
| | FreeMWare kernel driver
+ | |
| `--- include contains header files for the
| FreeMWare kernel driver
+ |
|--- user contains the sources for the
- | user-level VM monitor
+ | | user-level VM monitor
+ | |
+ | `--- plugins contains the sources for the plugins
+ | |
+ | |--- ice ICE plugin; for using remote GDB
+ | `--- bochs BOCHS plugin; contains emulated
+ | hardware devices, and GUI code
+ |
`--- guest contains several simple kernels for
| testing VM functionality as it is added
- |--- virtcode simple do-nothing-loop kernel
+ |
+ |--- virtcode simple non-multitasking kernel (shell)
|--- cooperative simple cooperative multitasking kernel
`--- preemptive simple preemptive multitasking kernel
@@ -61,7 +71,8 @@
3. Make the device node /dev/freemware. FreeMWare needs this
device in order that the user-level VM monitor can communicate
- with the kernel driver. You will need to be root:
+ with the kernel driver. You only have to do this once.
+ You will need to be root:
user> su
root> mknod /dev/freemware0 c 63 0
@@ -73,21 +84,42 @@
root> /sbin/insmod kernel/freemware.o
root> exit
+ You need to have the kernel module installed in order to
+ use FreeMWare. You could load it in your rc.local, for
+ instance.
+
5. Have a look through user/fmw.conf. This configuration
file contains the configuration of the user-level
VM monitor. If you just want to test-run the VM,
the default settings should be okay.
- 6. You can now start up the VM by invoking the user program:
+ 6. If you do not have the VGA font installed, you will need
+ to install it first (you can check this by skipping to
+ point 7, and checking whether it gives an error message).
+ You will only have to do this once. The VGA font resides in
+ misc/vga.pcf. In order to install it, you'll need to be root:
+
+ user> su
+ root> cp misc/vga.pcf X-font-path/misc
+ root> compress X-font-path/vga.pcf
+ root> mkfontdir X-font-path/misc
+ root> xset fp rehash
+ root> exit
+
+ For X-font-path, substitute your X server's (or font server's)
+ font path. On many linux systems, for instance, this path is
+ /usr/X11R6/lib/X11/fonts
+
+ 7. You can now start up the VM by invoking the user program:
user> cd user
- user> ./user
+ user> ./freemware
- 7. Whenever you recompile the kernel stuff, or want to get
+ 8. Whenever you recompile the kernel stuff, or want to get
rid of the kernel module, remove the old kernel module first.
As root:
- root> rmmod freemware
+ root> /sbin/rmmod freemware
Let us know whether it works for you !!! The address of the
