Changes:

This is our fork of the original dune repo. We plan to use Dune as the basis for a project on runtime enforcement of determinism. We will make any changes to libdune and the dune kernel module here, while factoring out the determinising client code as a separte repo.

Overview

Dune is a system that lets you safely run applications in Ring 0 by using hardware virtualization. This lets applications access privileged CPU features and do things like change their own page table, register interrupt handlers and more, while still being able to perform normal system calls. More information is available here:

https://github.com/project-dune

This work was published on OSDI'12:

http://dl.acm.org/citation.cfm?id=2387913

Dune has two components:

A kernel module to enable virtualization (kern)
A utility library to help with using Dune (libdune)

We also provide an optional patched glibc (eglibc-2.14). It slightly improves system call performance by performing a VMCALL directly. If used, it does not need to be installed globally.

Dune is enabled only on applications that call dune_init(). All other applications on the system remain unaffected.

The directory layout of this archive is as follows: kern/ -> the Dune kernel module libdune/ -> the Dune library OS bench/ -> a series of benchmarks to compare Dune and Linux performance test/ -> simple test programs and examples sandbox/ -> a generic implementation for sandboxing untrusted binaries

Requirements

A 64-bit x86 Linux environment
A recent Intel CPU (we use Nehalem and later) with VT-x support.
A recent kernel version --- We use 3.0 and later, but earlier versions may also work.
Kernel headers must be installed for the running kernel.

We provide a script called dune_req.sh that will attempt to verify if these requirements are met.

Setup

sudo make

insmod kern/dune.ko

test/hello

You'll need to be root to load the module. However, applications can use Dune without running as root; simply change the permission of '/dev/dune' accordingly.

Another program worth trying after Dune is setup is the Dune benchmark suite. It can be run with the following command:

bench/bench_dune

Run the following command to build a faster version of glibc (optional):

make libc

If eglibc build fails some systems (e.g. Ubuntu) may have incompatible default CFLAGS set. Before running the libc build set the following flags.

setenv CFLAGS "-U_FORTIFY_SOURCE -O2 -fno-stack-protector"

The alternate glibc can be used by prefixing dune apps with the dune_env.sh script.

Limitations

Dune is fairly far along, but could benefit from better support for signals and more robust pthread support inside libdune. We're currently working on these issues.

Dune does not support kernel address space layout randomization (KASLR). For newer kernels, you must specify the nokaslr parameter in the kernel command line. Check before inserting the module by executing cat /proc/cmdline. If the command line does not include the nokaslr parameter, then you must add it. In order to add it in Ubuntu-based distributions, you must:

edit the file /etc/default/grub,
append nokaslr in the GRUB_CMDLINE_LINUX_DEFAULT option,
execute sudo update-grub, and
reboot the system.

Programming

Call dune_init() to enter dune mode. (Link to libdune.)
The application will continue to function as normal. You can use printf, use sockets, access files, etc.
But you can then also perform privileged CPU instructions.

Contributing

Found a bug and know how to fix it? Not sure if that small improvement is worth a pull request? Do it! It will be greatly appreciated.

However, any significant improvement or change should be documented as a GitHub issue before anybody starts working on it.

Questions?

This is a fork of the original dune. Any bugs or erros should be reported to gatowololo at gmail dot com instead of the original dune folks.

upenn-acg/dune