# 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