Module Name: src
Committed By: pooka
Date: Tue Jan 8 13:12:26 UTC 2013
Modified Files:
src/sys/rump: README.dirs
Log Message:
Update a bit.
To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/sys/rump/README.dirs
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/rump/README.dirs
diff -u src/sys/rump/README.dirs:1.11 src/sys/rump/README.dirs:1.12
--- src/sys/rump/README.dirs:1.11 Tue May 11 11:58:14 2010
+++ src/sys/rump/README.dirs Tue Jan 8 13:12:26 2013
@@ -1,22 +1,21 @@
- $NetBSD: README.dirs,v 1.11 2010/05/11 11:58:14 pooka Exp $
+ $NetBSD: README.dirs,v 1.12 2013/01/08 13:12:26 pooka Exp $
The following is a quick rundown of the current directory structure.
First, components in the kernel namespace, i.e. compiled with -D_KERNEL
-sys/rump/librump - kernel runtime emulation
+sys/rump/librump - rump kernel base and factions
/rumpkern - kernel core, e.g. syscall, interrupt and lock support
- /rumpcrypto - kernel cryptographic routines
/rumpdev - device support, e.g. autoconf subsystem
/rumpnet - networking support and sockets layer
/rumpvfs - file system support
sys/rump/include
- /machine - used for architectures where the rump ABI is not yet the
+ /machine - used for architectures where the rump kernel ABI is not yet the
same as the kernel module ABI. will eventually disappear
completely
- /rump - rump headers installed to userspace
+ /rump - kernel headers installed to userspace
sys/rump/dev - device components, e.g. audio, raidframe, usb drivers
@@ -28,18 +27,30 @@ sys/rump/net - networking components
/lib/libnetinet - TCP/IP
/lib/libvirtif - a virtual interface which uses host tap(4) to shovel
packets. This is used by netinet and if_ethersubr.
+ /lib/libshmif - a virtual interface which uses a memory mapped file
+ as an ethernet bus. works completely unprivileged.
/lib/libsockin - implements PF_INET using host kernel sockets. This is
mutually exclusive with net, netinet and virtif.
-The rest are out-of-kernel components (i.e. no -D_KERNEL)
-related to rump.
+The rest are out-of-kernel components (i.e. no -D_KERNEL).
hypercall interface:
src/lib/librumpuser
- The "rumpuser" set of interfaces is used by rump to communicate
- with the host.
+ The "rumpuser" hypercall interfaces are used by a rump kernel to
+ access host resources.
+
+remote client interface:
+src/lib/librumpclient
+ The rumpclient library provides remote access to rump kernel servers.
+
+system call hijacking:
+src/lib/librumphijack
+ The rumphijack library allows intercepting system calls and redirecting
+ them to a rump kernel server instead of the host kernel. In other
+ words, it allows existing binaries to request indicated services from
+ a rump kernel instead of from the host kernel.
Users:
src/lib
@@ -47,11 +58,11 @@ src/lib
/libukfs - user kernel file system, a library to access file system
images (or devices) directly in userspace without going
through a system call and puffs. It provides a slightly
- higher interface than pure rump syscalls.
+ higher interface than syscalls.
src/usr.sbin/puffs
rump_$fs - userspace file system daemons using the kernel fs code
src/share/examples/rump
- Various examples detailing use of rump in different scenarios.
+ Various examples detailing use of rump kernels in different scenarios.
These are provided source-only.
