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

Taosc is an automated makeshift patcher for binary programs.

## Installation

Taosc depends on [AFL++], [AFL Dyninst], [Dyninst], [E9Patch], [PatchELF]
[pacfix-python], and [GNU Parallel].  To build taosc, you need
`make(1p)`, a compiler for C and C++, [GNU M4], and `link(1p)`:

    make -j$(nproc)

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

    make PREFIX=$prefix install

## Usage

    taosc-fix executable address workdir option...
    taosc-fix-lib executable library address workdir 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.

[AFL++]: https://aflplus.plus
[AFL Dyninst]: https://trong.loang.net/~cnx/afl-dyninst
[Dyninst]: https://github.com/dyninst/dyninst
[E9Patch]: https://github.com/gjduck/e9patch
[PatchELF]: https://github.com/NixOS/patchelf
[pacfix-python]: https://github.com/hsh814/pacfix-python
[GNU Parallel]: https://www.gnu.org/software/parallel
[GNU M4]: https://www.gnu.org/software/m4