out-of-tree kernel {module, exploit} development tool

Go to file

Mikhail Klementev 1b9e72802d Refactor argument parsing		2018-10-27 07:48:06 +00:00
examples	Add kernels for supported list	2018-10-07 22:02:38 +00:00
qemu	Use Docker instead of Vagrant for generate images	2018-10-25 23:43:34 +00:00
tools	Change Ubuntu images symbolic links from distro name to version	2018-10-26 06:43:09 +00:00
.gitignore	Initial commit	2018-09-17 20:15:16 +04:00
LICENSE	Change license to GNU AGPLv3	2018-10-08 20:54:18 +00:00
main.go	Refactor argument parsing	2018-10-27 07:48:06 +00:00
README.md	Refactor argument parsing	2018-10-27 07:48:06 +00:00

README.md

out-of-tree

out-of-tree kernel {module, exploit} development tool

Installation

Read Qemu API.

Generate images

$ cd $GOPATH/src/github.com/jollheef/out-of-tree/tools/qemu-debian-img/
$ docker run --privileged -v $(pwd):/shared -e IMAGE=/shared/ubuntu1404.img -e RELEASE=trusty -t gen-ubuntu1804-image
$ docker run --privileged -v $(pwd):/shared -e IMAGE=/shared/ubuntu1604.img -e RELEASE=xenial -t gen-ubuntu1804-image

Generate kernels

cd $GOPATH/src/github.com/jollheef/out-of-tree/tools/kernel-factory
./bootstrap.sh # more than 6-8 hours for all kernels

"I just want to see how it works"

If you already have Go, Qemu and Docker installed, there's cross-platform installation checklist:

$ go get github.com/jollheef/out-of-tree
$ cd $GOPATH/src/github.com/jollheef/out-of-tree/tools/qemu-debian-img/
$ ./bootstrap.sh
$ docker run --privileged -v $(pwd):/shared -e IMAGE=/shared/ubuntu1604.img -e RELEASE=xenial -t gen-ubuntu1804-image
$ cd ../kernel-factory
$ rm -rf {Debian,CentOS,Ubuntu/{14.04,18.04}} # speed up :)
$ ./bootstrap.sh
$ # wait several hours...
$ export OUT_OF_TREE_KCFG=$GOPATH/src/github.com/jollheef/out-of-tree/tools/kernel-factory/output/kernels.toml
$ cd ../../examples/kernel-exploit
$ # test kernel exploit
$ out-of-tree pew
$ cd ../kernel-module
$ # test kernel module
$ out-of-tree pew