1
0
out-of-tree/README.md

70 lines
2.3 KiB
Markdown
Raw Normal View History

2019-06-20 10:11:30 +00:00
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/aba4aad2046b4d1a9a99cf98e22c018b)](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)
2019-02-02 21:24:29 +00:00
[![Go Report Card](https://goreportcard.com/badge/code.dumpstack.io/tools/out-of-tree)](https://goreportcard.com/report/code.dumpstack.io/tools/out-of-tree)
2019-08-16 20:51:45 +00:00
[![Documentation Status](https://readthedocs.org/projects/out-of-tree/badge/?version=latest)](https://out-of-tree.readthedocs.io/en/latest/?badge=latest)
2018-10-05 07:47:49 +00:00
2018-12-02 02:29:58 +00:00
# [out-of-tree](https://out-of-tree.io)
2018-12-02 00:27:07 +00:00
2018-10-05 07:47:49 +00:00
out-of-tree kernel {module, exploit} development tool
2019-08-21 08:08:35 +00:00
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).
2018-11-19 19:39:03 +00:00
![Screenshot](https://cloudflare-ipfs.com/ipfs/Qmb88fgdDjbWkxz91sWsgmoZZNfVThnCtj37u3mF2s3T3T)
2018-10-08 19:35:54 +00:00
2019-12-27 07:12:09 +00:00
## Installation
### GNU/Linux (with [Nix](https://nixos.org/nix/))
2019-12-27 08:18:45 +00:00
$ curl -fsSL https://get.docker.com | sh
2019-12-27 08:25:55 +00:00
$ sudo usermod -aG docker user && newgrp docker
2020-06-18 15:22:35 +00:00
$ curl -L https://nixos.org/nix/install | sh
2019-12-27 07:12:09 +00:00
$ nix-env -iA nixpkgs.out-of-tree
2019-12-28 08:50:10 +00:00
Note that adding a user to group *docker* has serious security implications. Check Docker documentation for more information.
2019-12-27 07:12:09 +00:00
### macOS
2019-12-27 08:18:45 +00:00
$ brew cask install docker
$ open --background -a Docker && sleep 1m
2019-12-27 07:12:09 +00:00
$ brew tap jollheef/repo
$ brew install out-of-tree
Read [documentation](https://out-of-tree.readthedocs.io) for further info.
2019-12-27 08:25:55 +00:00
## Examples
2018-10-27 17:37:58 +00:00
Run by absolute path
$ out-of-tree --path /path/to/exploit/directory pew
Test only with one kernel:
2020-05-30 14:37:41 +00:00
$ out-of-tree pew --kernel='Ubuntu:5.4.0-29-generic
2018-10-27 15:33:54 +00:00
2018-11-25 14:46:29 +00:00
Run debug environment:
2020-05-30 14:37:41 +00:00
$ out-of-tree debug --kernel='Ubuntu:5.4.0-29-generic
2018-11-25 14:46:29 +00:00
2018-10-27 20:07:52 +00:00
Test binary module/exploit with implicit defined test ($BINARY_test)
$ out-of-tree pew --binary /path/to/exploit
Test binary module/exploit with explicit defined test
$ out-of-tree pew --binary /path/to/exploit --test /path/to/exploit_test
2018-10-27 15:33:54 +00:00
Guess work kernels:
$ out-of-tree pew --guess
2018-10-27 17:37:58 +00:00
Use custom kernels config
$ out-of-tree --kernels /path/to/kernels.toml pew
Generate all kernels
2018-12-01 17:16:34 +00:00
2023-01-19 17:22:25 +00:00
$ out-of-tree kernel genall --distro Ubuntu --ver 22.04
2019-08-20 21:55:40 +00:00
## Development
Read [Qemu API](qemu/README.md).