tools
/
out-of-tree
1
0
Fork 0
Code Releases Activity
out-of-tree kernel {module, exploit} development tool
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
86 Commits
1 Branch
10 Tags
2.5 MiB
 
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'e91af205f4'
${ noResults }
Go to file
dump_stack() e91af205f4
Allow to enumerate distro types 		4 years ago
examples Add kernels for supported list 5 years ago
qemu Use Docker instead of Vagrant for generate images 4 years ago
tools Do not use privileged flag for copy kernel/initrd/module 4 years ago
.gitignore Initial commit 5 years ago
LICENSE Change license to GNU AGPLv3 5 years ago
README.md Implements support build/run/test only for one kernel 4 years ago
main.go Allow to enumerate distro types 4 years ago

README.md

out-of-tree

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

Screenshot

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

Examples

Test only with one kernel:

$ out-of-tree pew --kernel='Ubuntu:4.10.0-30-generic'