| commit | ae83ef09b3343ff51844ba46cdfaf80a9a976801 | [log] [tgz] |
|---|---|---|
| author | Vitaly Buka <vitalybuka@chromium.org> | Thu Jan 12 13:15:40 2017 -0800 |
| committer | Vitaly Buka <vitalybuka@gmail.com> | Thu Jan 12 22:44:22 2017 -0800 |
| tree | 8066cc843b4e5c9ae991f0e9e5a6fe9401395b68 | |
| parent | 0e1e46bf3e333095326f201b0b8c1119be22f0da [diff] |
Add Travis Ci config
libprotobuf-mutator is a library to randomly mutate protobuffers.
It could be used together with guided fuzzing engines, such as libFuzzer.
Install prerequisites:
sudo apt-get update sudo apt-get install binutils cmake ninja-build
Compile and test everything:
mkdir build cd build cmake .. -GNinja -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_BUILD_TYPE=Debug ninja check
Clang is only needed for libFuzzer integration.
To use libprotobuf-mutator simply include protobuf_mutator.h and protobuf_mutator.cc into your build files.
The ProtobufMutator class implements mutations of the protobuf tree structure and mutations of individual fields. The field mutation logic is very basic -- for better results you should override the ProtobufMutator::Mutate* methods with more sophisticated logic, e.g. using libFuzzer's mutators.
To apply one mutation to a protobuf object do the following:
class MyProtobufMutator : public ProtobufMutator {
public:
MyProtobufMutator(uint32_t seed) : ProtobufMutator(seed) {}
// Optionally redefine the Mutate* methods to perform more sophisticated mutations.
}
void Mutate(MyMessage* message) {
MyProtobufMutator mutator(my_random_seed);
mutator.Mutate(message, 200);
}
See also the ProtobufMutatorMessagesTest.UsageExample test from protobuf_mutator_test.cc.
LibFuzzerProtobufMutator can help to integrate with libFuzzer. Please see libfuzzer_example.cc as an example.