50 lines
2.0 KiB
Markdown
50 lines
2.0 KiB
Markdown
[](https://app.codacy.com/app/jollheef/out-of-tree?utm_source=github.com&utm_medium=referral&utm_content=jollheef/out-of-tree&utm_campaign=Badge_Grade_Dashboard)
|
|
[](https://goreportcard.com/report/code.dumpstack.io/tools/out-of-tree)
|
|
[](https://out-of-tree.readthedocs.io/en/latest/?badge=latest)
|
|
|
|
# [out-of-tree](https://out-of-tree.io)
|
|
|
|
out-of-tree kernel {module, exploit} development tool
|
|
|
|
out-of-tree is for automating some routine actions for creating development environments for debugging kernel modules and exploits, generating reliability statistics for exploits, and also provides the ability to easily integrate into CI (Continuous Integration).
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
### GNU/Linux (with [Nix](https://nixos.org/nix/))
|
|
|
|
$ curl -fsSL https://get.docker.com | sh
|
|
$ sudo usermod -aG docker user && newgrp docker
|
|
$ curl -L https://nixos.org/nix/install | sh
|
|
$ nix-env -iA nixpkgs.out-of-tree # Note: may not be up to date immediately, in this case consider installing from source
|
|
|
|
Note that adding a user to group *docker* has serious security implications. Check Docker documentation for more information.
|
|
|
|
### macOS
|
|
|
|
$ brew install --cask docker
|
|
$ open --background -a Docker && sleep 1m
|
|
$ brew tap out-of-tree/repo
|
|
$ brew install out-of-tree
|
|
|
|
Read [documentation](https://out-of-tree.readthedocs.io) for further info.
|
|
|
|
## Examples
|
|
|
|
Generate all Ubuntu 22.04 kernels:
|
|
|
|
$ out-of-tree kernel genall --distro=Ubuntu --ver=22.04
|
|
|
|
Run tests based on .out-of-tree.toml definitions:
|
|
|
|
$ out-of-tree pew
|
|
|
|
Test with a specific kernel:
|
|
|
|
$ out-of-tree pew --kernel='Ubuntu:5.4.0-29-generic'
|
|
|
|
Run debug environment:
|
|
|
|
$ out-of-tree debug --kernel='Ubuntu:5.4.0-29-generic'
|