AFLplusplus-protobuf-mutator

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #go #android #linux #docker #macos #cli #awesome-list #ios #openai

AFLplusplus-protobuf-mutator

(★ 60)

AFLplusplus + libprotobuf-mutator

AFLplusplus-protobuf-mutator 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AFLplusplus-protobuf-mutator
AFLplusplus + libprotobuf-mutator 
## Overview
[AFLplusplus-protobuf-mutator](https://github.com/P1umer/AFLplusplus-protobuf-mutator) integrates [AFLplusplus](https://github.com/AFLplusplus/AFLplusplus) and [libprotobuf-mutator](https://github.com/google/libprotobuf-mutator).
It could be used to feed the target on INTERESTING data based on protobuf.

## Quick start
### Install prerequisites
```
sudo apt-get update
sudo apt-get install liblzma-dev libz-dev
```
### Download source code && update submodule
```
git clone https://github.com/P1umer/AFLplusplus-protobuf-mutator.git
cd AFLplusplus-protobuf-mutator
git submodule update
```
AFLplusplus needs to be compiled separately according to the [README.md](https://github.com/AFLplusplus/AFLplusplus/blob/stable/README.md)

### Build
use CMake to build.
```
mkdir build
cd build
cmake ..
make
```
Clang is needed for compilation.
By default, protobuf and LPM will be automatically downloaded and built for this library. However, you can also pass `LIB_PROTOBUF_DOWNLOAD/LIB_PROTOBUF_MUTATOR_DOWNLOAD=OFF` to use system-installed version of protobuf/LPM

## Usage
To use AFLplusplus-protobuf-mutator simply include [afl-mutator.h](https://github.com/P1umer/AFLplusplus-protobuf-mutator/blob/main/src/afl-mutator.h) into your files. `DEFINE_AFL_PROTO_FUZZER` defines the functions required by afl++ for custom mutations. To apply one mutation to a protobuf object do the following:
```
#include "src/afl-mutator.h"

DEFINE_AFL_PROTO_FUZZER(const MessageType& input, unsigned char **out_buf){
    // transfer the input to some interesting DATA
    // and output the DATA to *out_buf
    
    /*
     * @param[in] Protobuf Buffer containing the test case
     * @param[out] out_buf Pointer to the buffer containing the test case after tranferance. 
     * @return Size of the output buffer after processing or the needed amount.
    */
    TransferMessageType(input, out_buf); 
}
```
The generated library can be passed to afl-fuzz via the `AFL_CUSTOM_MUTATOR_LIBRARY`.
Please see [test_fuzzzer.cc](https://github.com/P1umer/AFLplusplus-protobuf-mutator/blob/main/example/test_fuzzer.cc) as an example.
And there is a [harness.c](https://github.com/P1umer/AFLplusplus-protobuf-mutator/blob/main/example/harness.c) file for testing, which needs to be compiled with `afl-cc` generated by [AFLplusplus](https://github.com/AFLplusplus/AFLplusplus).

Note: It is recommended to set `AFL_CUSTOM_MUTATOR_ONLY` flag to make all mutations solely be performed with the custom mutator.

AFLplusplus-protobuf-mutator

AFLplusplus-protobuf-mutator 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

AFLplusplus-protobuf-mutator

AFLplusplus-protobuf-mutator 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README