aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: e30b715087e535e8ce84d9be841d8e6b1fa387ba (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# Taosc

Taosc is an automated makeshift patcher for binary programs.

## Installation

Taosc depends on [AFL++], [Dyninst], [E9Patch], [GNU Findutils], [FUZZOLIC]
and POSIX utilities.  To build taosc, you need [GNU M4] and a compiler
for C++23 and [Zig] 0.15:

    make -j$(nproc)

To install taosc to `$prefix`, you'll also need `install(1p)`:

    make PREFIX=$prefix install

## Usage

    taosc-fix TIMEOUT WORKDIR PROOFS_OF_CONCEPT EXECUTABLE ARG...

Fix `EXECUTABLE`, which crashes for PoC(s) in the `PROOFS_OF_CONCEPT` directory
when it is run with `ARG`(s), where `@@` is the placeholder for input files.

Processes taking more than `TIMEOUT` seconds to terminate
are treated the same as crashes.

Files in `WORKDIR` are overwritten without any warning.

## Copying

Taosc is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.

[AFL++]: https://aflplus.plus
[Dyninst]: https://github.com/dyninst/dyninst
[E9Patch]: https://github.com/gjduck/e9patch
[GNU Findutils]: https://www.gnu.org/software/findutils
[FUZZOLIC]: https://season-lab.github.io/fuzzolic
[GNU M4]: https://www.gnu.org/software/m4
[Zig]: https://ziglang.org