summaryrefslogtreecommitdiffstats
path: root/qemu/roms/openbios/kernel/README
diff options
context:
space:
mode:
authorRajithaY <rajithax.yerrumsetty@intel.com>2017-04-25 03:31:15 -0700
committerRajitha Yerrumchetty <rajithax.yerrumsetty@intel.com>2017-05-22 06:48:08 +0000
commitbb756eebdac6fd24e8919e2c43f7d2c8c4091f59 (patch)
treeca11e03542edf2d8f631efeca5e1626d211107e3 /qemu/roms/openbios/kernel/README
parenta14b48d18a9ed03ec191cf16b162206998a895ce (diff)
Adding qemu as a submodule of KVMFORNFV
This Patch includes the changes to add qemu as a submodule to kvmfornfv repo and make use of the updated latest qemu for the execution of all testcase Change-Id: I1280af507a857675c7f81d30c95255635667bdd7 Signed-off-by:RajithaY<rajithax.yerrumsetty@intel.com>
Diffstat (limited to 'qemu/roms/openbios/kernel/README')
-rw-r--r--qemu/roms/openbios/kernel/README93
1 files changed, 0 insertions, 93 deletions
diff --git a/qemu/roms/openbios/kernel/README b/qemu/roms/openbios/kernel/README
deleted file mode 100644
index c84879b83..000000000
--- a/qemu/roms/openbios/kernel/README
+++ /dev/null
@@ -1,93 +0,0 @@
-
-Welcome to the OpenBIOS forth core "begin again".
-
-Find more information about OpenBIOS at http://www.openbios.org/
-
-This program was written by Patrick Mauritz and Stefan Reinauer in 2003
-For license details on this piece of software, check Documentation/COPYING.
-
-How OpenBIOS works
-------------------
-
- The OpenBIOS forth core is split into a forth kernel written in C
- and a forth dictionary which operated on by the kernel.
-
- When building the forth core, you get different versions of
- the forth kernel:
-
- * a "hosted" unix binary. This binary can be used on a unix system
-
- - to execute a forth dictionary from a file. This can be used for
- testing openbios code in a development environment on a unix host.
-
- - to create a dictionary file. Such a dictionary file sets up
- all of the forth language. Primitives are indexed to save relocations.
-
- The default is to create a forth dictionary forth.dict from
- forth/start.fs. This file includes all of the basic forth language
- constructs from forth/bootstrap.fs and starts the interpreter.
-
- To achieve this, the hosted unix version contains a basic set of
- forth words coded in C that allow creating a full dictionary.
-
- * a varying number of target specific binaries. On x86 you can start
- openbios for example from GRUB or LinuxBIOS. They are all based on
- the same forth engine consisting of a dictionary scheduler, primitive
- words needed to build the forth environment, 2 stacks and a simple
- set of console functions. These binaries can not be started directly
- in the unix host environment.
-
-Requirements
-------------
- * gcc
- * grub or any other multiboot loader to run the standalone
- binary "openbios.multiboot"
-
-Building & Usage
-----------------
-
- * make
-
- this builds "openbios.multiboot", the standalone image and "unix",
- the hosted image. Additionally it creates a forth dictionary
- file from forth/start.fs. All generated files are written to
- the absolute directory held by the variable BUILDDIR, which defaults
- to obj-[platform]. Some compile time parameters can be tweaked in
- include/config.h
-
- * use "unix" to create a forth dictionary on your own:
- $ ./unix -Iforth start.fs
- creates the file forth.dict from forth source forth/start.fs.
-
- * use "unix" to run a created dictionary:
- $ ./unix forth.dict
- This is useful for testing
-
- * booting openbios
- You can boot openbios i.e. in grub. Add the following lines to
- your menu.lst:
-
- title openbios
- kernel (hd0,2)/boot/openbios.multiboot
- module (hd0,2)/boot/openfirmware.dict
-
- Note: change (hd0,2) to the partition you copied openbios and
- forth.dict to.
-
- To boot OpenBIOS from LinuxBIOS/etherboot, you can either use
- "openbios" or "openbios.full":
-
- - openbios is the pure kernel that loads the dictionary from a
- hardcoded address in flash memory (0xfffe0000)
-
- - openbios.full also includes the dictionary directly so that it
- can be easily used from etherboot or the LinuxBIOS builtin ELF
- loader without taking care of the dictionary
-
-
-Comments are welcome.
-
- OpenBIOS team
-
-------------------------------------------------------------------------
-tag: README for openbios forth core