genode

mirror of https://github.com/genodelabs/genode.git synced 2024-12-23 23:42:32 +00:00

History

Alice Domage 74abf8132e tool/port: add .sparse-git install rule Following Github support removal for svn [1], dde_rump port fails to prepare. This commit introduces a new install rule for ports, '.sparse-git'. It performs a sparse-checkout on the port repository, only fetching required files. [1] https://github.blog/2023-01-20-sunsetting-subversion-support/ Co-authored-by: Benjamin Lamowski <benjamin.lamowski@genode-labs.com> Issue genodelabs#5072 Issue genodelabs/goa#28		2023-12-13 12:33:05 +01:00
..
lib	dde_rump: add RISC-V support	2023-04-17 14:48:25 +02:00
patches	dde_rump: add RISC-V support	2023-04-17 14:48:25 +02:00
ports	tool/port: add .sparse-git install rule	2023-12-13 12:33:05 +01:00
recipes	depot: update recipe hashes	2023-11-30 15:11:36 +01:00
run	dde_rump: use [build_artifacts] in run scripts	2023-11-28 14:44:29 +01:00
src	Replace use of base/snprintf.h by format library	2023-03-13 14:32:53 +01:00
README	Update README files	2023-03-13 14:32:53 +01:00
rump.list	rump: reduce size of rump	2017-11-30 11:23:19 +01:00

README

                             ================================
                             Genode's Rump Kernel kernel port
                             ================================

This repository contains the Genode version of the
[http://wiki.netbsd.org/rumpkernel/ - rump kernel].
The kernel is currently used to gain file-system access from within Genode.
In order to achieve that, the rump kernel is integrated into a VFS plugin,
located at _src/lib/vfs/rump_. It can thereby by used directly by libc
applications, or indirectly by using the VFS-server component.


Building instructions
#####################

In order to build the VFS plugin, issue

! ./tool/ports/prepare_port dde_rump

from Genode's toplevel directory.


Add

! REPOSITORIES += $(GENODE_DIR)/repos/dde_rump

to your _etc/build.conf_ file of you build directory.

Finally,

! make lib/vfs_rump

called from your build directory will build the plugin.


Configuration
#############

Here is an example snippet that configures the VFS plugin:

| <rump fs="msdos" ram="7M" writeable="yes"/>"

The VFS plugin obtains a block session. If there is more than one block
session in the system, the block session must be routed to the right
block-session server. The value of the _fs_ attribute can be one of the
following: _ext2fs_ for EXT2, _cd9660_ for ISO-9660, or _msdos_ for FAT
file-system support. When accessing a _msdos_ file system, the optional
attribute 'gemdos="yes"' can be specified to operate in GEMDOS compatibility
mode.

The VFS plugin hands over the specified amount of RAM quota to the rump
kernel. The larger the quota is, the larger the internal block caches of the
rump kernel will be.