2011-12-22 15:19:25 +00:00
|
|
|
|
|
|
|
|
=========================================
|
|
|
|
|
Genode on the L4ka::Pistachio microkernel
|
|
|
|
|
=========================================
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Norman Feske
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Pistachio is the reference implementation of the L4 API version x.2 (also
|
|
|
|
|
referred to a v4). It is developed by the System Architecture Group at the
|
|
|
|
|
University of Karlsruhe, Germany and the DiSy group at the University of
|
|
|
|
|
New South Wales, Australia.
|
|
|
|
|
|
|
|
|
|
Because this kernel has been the experimentation platform for a lot of exciting
|
|
|
|
|
research experiments at the L4ka group and it is the basis for the commercial
|
|
|
|
|
version of L4 developed by OK-Labs, Pistachio is a very interesting base
|
|
|
|
|
platform for the Genode OS Framework.
|
|
|
|
|
|
|
|
|
|
The original port of the Genode OS Framework to Pistachio is the work of Julian
|
|
|
|
|
Stecklina who wanted to elaborate on the portability of the framework and
|
|
|
|
|
explore the use of Pistachio's multi-processor capabilities with Genode.
|
|
|
|
|
|
|
|
|
|
This document provides brief instructions about downloading, building and
|
|
|
|
|
booting the Pistachio version of Genode.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Downloading, building, and using L4ka::Pistachio
|
|
|
|
|
################################################
|
|
|
|
|
|
|
|
|
|
Please make sure that you haved downloaded and installed the tool chain,
|
|
|
|
|
which will be used for both, the L4ka::Pistachio kernel and Genode.
|
|
|
|
|
|
|
|
|
|
:[http://genode.org/download/tool-chain]:
|
|
|
|
|
Preconfigured GNU tool chain for building Genode
|
|
|
|
|
|
2016-03-11 09:54:00 +00:00
|
|
|
To download the kernel source codes, issue './tool/ports/prepare_port pistachio'.
|
|
|
|
|
This command will checkout the upstream Git repository of the kernel. Please
|
|
|
|
|
make sure to have Git installed.
|
2012-12-18 15:38:49 +00:00
|
|
|
|
|
|
|
|
For the vesa driver on x86 the x86emu library is required and can be downloaded
|
2016-03-11 09:54:00 +00:00
|
|
|
and prepared by invoking the following command:
|
2012-12-18 15:38:49 +00:00
|
|
|
|
2016-03-11 09:54:00 +00:00
|
|
|
! ./tool/ports/prepare_port x86emu
|
2012-12-18 15:38:49 +00:00
|
|
|
|
|
|
|
|
After having successfully prepared the 'base-pistachio' repository and
|
|
|
|
|
'libports' you are ready to create a Genode build directory using the
|
|
|
|
|
'tool/create_builddir':
|
2011-12-22 15:19:25 +00:00
|
|
|
|
|
|
|
|
! <genode-dir>/tool/create_builddir pistachio_x86 \
|
|
|
|
|
! BUILD_DIR=<build-dir>
|
|
|
|
|
|
|
|
|
|
From within this directory, you can build the kernel by using 'make kernel'.
|
|
|
|
|
The kernel will be built within '<build-dir>/kernel/pistachio' using the Genode
|
|
|
|
|
tool chain.
|
|
|
|
|
|
|
|
|
|
To build and start Genode directly from within the Genode build directory,
|
|
|
|
|
issue
|
|
|
|
|
|
|
|
|
|
! make run/demo
|
|
|
|
|
|
|
|
|
|
This command will execute the steps described in the run script located at
|
|
|
|
|
'os/run/demo.run'. It will build all Genode components needed for the demo
|
|
|
|
|
scenario, create a configuration, and start the scenario using Qemu. To inspect
|
|
|
|
|
the individual steps more closely or learn the steps needed to manually
|
|
|
|
|
integrate Genode with L4ka::Pistachio, please revisit the Pistachio-specific
|
Disambiguate kernel-specific file names
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
2016-12-10 00:30:38 +00:00
|
|
|
run environment at 'tool/run/boot_dir/pistachio'.
|
2011-12-22 15:19:25 +00:00
|
|
|
|
