mirror of
https://github.com/genodelabs/genode.git
synced 2024-12-29 18:18:54 +00:00
c450ddcb3d
This patch removes possible ambiguities with respect to the naming of kernel-dependent binaries and libraries. It also removes the use of kernel-specific global side effects from the build system. The reach of kernel-specific peculiarities has thereby become limited to the actual users of the respective 'syscall-<kernel>' libraries. Kernel-specific build artifacts are no longer generated at magic places within the build directory (like okl4's includes, or the L4 build directories of L4/Fiasco and Fiasco.OC, or the build directories of various kernels). Instead, such artifacts have been largely moved to the libcache. E.g., the former '<build-dir>/l4/' build directory for the L4 build system resides at '<build-dir>/var/libcache/syscall-foc/build/'. This way, the location is unique to the kernel. Note that various tools are still generated somewhat arbitrarily under '<build-dir>/tool/' as there is no proper formalism for building host tools yet. As the result of this work, it has become possible to use a joint Genode build directory that is usable with all kernels of a given hardware platform. E.g., on x86_32, one can now seamlessly switch between linux, nova, sel4, okl4, fiasco, foc, and pistachio without rebuilding any components except for core, the kernel, the dynamic linker, and the timer driver. At the current stage, such a build directory must still be created manually. A change of the 'create_builddir' tool will follow to make this feature easily available. This patch also simplifies various 'run/boot_dir' plugins by removing the option for an externally hosted kernel. This option remained unused for many years now. Issue #2190
119 lines
3.9 KiB
Plaintext
119 lines
3.9 KiB
Plaintext
|
|
===================================
|
|
Genode on the Fiasco.OC microkernel
|
|
===================================
|
|
|
|
|
|
Stefan Kalkowski
|
|
|
|
|
|
Fiasco.OC is a microkernel developed by the OS group of the TU-Dresden. It's
|
|
an object-oriented capability-based system for x86, ARM and PowerPC platforms.
|
|
|
|
This document provides brief instructions about downloading, building and
|
|
booting the Fiasco.OC version of Genode.
|
|
|
|
|
|
Prerequisites
|
|
#############
|
|
|
|
You need certain tools to use the Fiasco.OC build system. On Debian/Ubuntu
|
|
systems you have to install the following packages:
|
|
|
|
! apt-get install make gawk pkg-config subversion patch
|
|
|
|
Moreover, you need to download and install the tool-chain used by Genode. Have
|
|
a look at this page:
|
|
|
|
:[http://genode.org/download/tool-chain]:
|
|
Genode tool-chain
|
|
|
|
If you want to use the so called run-scripts in Genode, a mechanism that
|
|
automates building, integration and testing of components, you have to install
|
|
the following, additional package:
|
|
|
|
! apt-get install expect
|
|
|
|
|
|
Building the Fiasco.OC version of Genode
|
|
########################################
|
|
|
|
The current version of Genode is available at the public subversion repository:
|
|
|
|
:http://genode.org/download/subversion-repository:
|
|
Information about accessing the Genode public subversion repository
|
|
|
|
After you've fetched the Genode source tree from the subversion repository, or
|
|
downloaded the latest release tar archive, you need the Fiasco.OC source code,
|
|
its kernel-bindings, additional bootstrap tools etc. To simplify that step,
|
|
you can use the 'prepare_port' tool:
|
|
|
|
! ./tool/ports/prepare_port foc
|
|
|
|
This will install all necessary third-party source code in the 'contrib' folder.
|
|
|
|
For the vesa driver on x86 the x86emu library is required and can be downloaded
|
|
and prepared by invoking the following command:
|
|
|
|
! ./tool/ports/prepare_port x86emu
|
|
|
|
Now, go to a directory where you want the Genode/Fiasco.OC build directory to
|
|
remain. Use the helper script in the 'tool' directory of the Genode
|
|
source tree to create the initial build environment. You need to state the
|
|
build directory you want to create, and the hardware architecture to run
|
|
Fiasco.OC/Genode on. Choose 'foc_x86_32', 'foc_x86_64', or 'foc_pbxa9'
|
|
depending on whether you want to build for the 32-bit or 64-bit X86
|
|
architecture, or for ARMs Cortex-A9.
|
|
|
|
! <genode-dir>/tool/create_builddir foc_x86_32 \
|
|
! BUILD_DIR=<build-dir>
|
|
|
|
Now, go to the newly created build directory and type make:
|
|
|
|
! cd <build-dir>
|
|
! make
|
|
|
|
This will build the Fiasco.OC kernel, its bootstrap code, and every Genode component,
|
|
that runs on top of Fiasco.OC.
|
|
|
|
If you just want to give Genode/Fiasco.OC a try, you can call e.g.: the demo run-script
|
|
instead of building everything:
|
|
|
|
! cd <build-dir>
|
|
! make run/demo
|
|
|
|
|
|
Running L4Linux on top of Genode
|
|
################################
|
|
|
|
To get the L4Linux running on top of Genode, you have to change prepare its
|
|
sources:
|
|
|
|
! ./tool/ports/prepare_port l4linux
|
|
|
|
This will fetch the currently supported version from the L4Linux subversion
|
|
repository, and apply a patch to it, that is needed to execute it on top of
|
|
Genode.
|
|
|
|
Before compiling L4Linux for Genode/Fiasco.OC you have to integrate the 'ports-foc'
|
|
repository into your build environment. Therefore edit the 'etc/build.conf' file
|
|
in your build directory, and uncomment the following line:
|
|
|
|
! REPOSITORIES += $(GENODE_DIR)/repos/ports-foc
|
|
|
|
After that you can build and run L4Linux by issuing:
|
|
|
|
! make run/l4linux
|
|
|
|
in your build directory. This run-script boots a single L4Linux instance into
|
|
a minimal console environment. After booting completes, the run-scripts tries
|
|
to download the Genode project webpage via the 'wget' tool within the L4Linux
|
|
environment. If all wents fine the run-script completes successfully.
|
|
|
|
|
|
Further Information
|
|
###################
|
|
|
|
:[http://os.inf.tu-dresden.de/fiasco]:
|
|
Official website for the Fiasco.OC microkernel.
|