about summary refs log tree commit diff
path: root/README.md
blob: 682632d102f9391a355ce40867d69dc773dcd6db (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
# Taosc

Taosc is an automated makeshift patcher for binary programs.

## Installation

Taosc depends on GDB, [Dyninst], [E9Patch], [FUZZOLIC], [GNU Parallel]
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 WORKDIR TIMEOUT EXECUTABLE PROOFS_OF_CONCEPT [OPTION]...

## 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.

[Dyninst]: https://github.com/dyninst/dyninst
[E9Patch]: https://github.com/gjduck/e9patch
[FUZZOLIC]: https://season-lab.github.io/fuzzolic
[GNU M4]: https://www.gnu.org/software/m4
[GNU Parallel]: https://www.gnu.org/software/parallel
[Zig]: https://ziglang.org