ZeroErr
Loading...
Searching...
No Matches
fuzztest.h
Go to the documentation of this file.
1#pragma once
2
4#include "zeroerr/unittest.h"
5
12
13
14#include <exception>
15#include <functional>
16#include <string>
17#include <tuple>
18#include <type_traits>
19#include <vector>
20
22
23#define ZEROERR_CREATE_FUZZ_TEST_FUNC(function, name, ...) \
24 static void function(zeroerr::TestContext*); \
25 static zeroerr::detail::regTest ZEROERR_NAMEGEN(_zeroerr_reg)( \
26 {name, __FILE__, __LINE__, function, {__VA_ARGS__}}, zeroerr::TestType::fuzz_test); \
27 static void function(ZEROERR_UNUSED(zeroerr::TestContext* _ZEROERR_TEST_CONTEXT))
28
29#define FUZZ_TEST_CASE(name, ...) \
30 ZEROERR_CREATE_FUZZ_TEST_FUNC(ZEROERR_NAMEGEN(_zeroerr_testcase), name, __VA_ARGS__)
31
32#define FUZZ_FUNC(func) zeroerr::FuzzFunction(func, _ZEROERR_TEST_CONTEXT)
33
34
35namespace zeroerr {
36
37namespace detail {
38
43template <typename... Args>
45 static constexpr size_t numOfArgs = sizeof...(Args);
46 using ValueType = std::tuple<Args...>;
47};
48
49template <typename... Args>
51 void (*)(Args...));
52
53template <typename... Args>
55 std::function<void(Args...)>);
56
57
58template <typename T>
60 using type = void;
61};
62
63template <typename Ret, typename Class, typename... Args>
64struct memfun_type<Ret (Class::*)(Args...) const> {
66};
67
68template <typename F>
69typename memfun_type<decltype(&F::operator())>::ret_type FunctionDecompositionImpl(F);
70
71
72template <typename T>
73using FunctionDecompositionT = decltype(FunctionDecompositionImpl(std::declval<T>()));
74
75} // namespace detail
76
77
83template <typename TargetFunction,
85struct FuzzTest;
86
87template <typename TargetFunction, typename FuncType, typename Domain,
90
91struct IFuzzTest {
92 virtual void Run(int count = 1000, int seed = 0) = 0;
93 virtual void RunOneTime(const uint8_t* data, size_t size) = 0;
94 virtual std::string MutateData(const uint8_t* data, size_t size, size_t max_size,
95 unsigned int seed) = 0;
96
97 int count = 0, max_count = 0;
98 bool should_stop() { return count == max_count; }
99};
100
101class FuzzFinishedException : public std::exception {
102public:
103 virtual const char* what() const throw() { return "Fuzzing finished"; }
104};
105
106// The details are described in the declaration of the class.
107template <typename TargetFunction, typename FuncType>
109 using ValueType = typename FuncType::ValueType;
111 FuzzTest(const FuzzTest& other)
112 : func(other.func), context(other.context), seeds(other.seeds) {}
113
114 template <typename... T>
116 FuzzTestWithDomain<TargetFunction, FuncType,
117 AggregateOf<std::tuple<typename T::ValueType...>, T...>>;
118
122 template <typename... T>
124 AggregateOf<std::tuple<typename T::ValueType...>, T...> domain) {
125 return FuzzTestWithDomainType<T...>(*this, domain);
126 }
127
133 template <typename... T>
134 FuzzTestWithDomainType<T...> WithDomains(T&&... domains) {
135 return WithDomains(TupleOf(std::forward<T>(domains)...));
136 }
137
138 FuzzTest& WithSeeds(std::vector<ValueType> _seeds) {
139 this->seeds.insert(this->seeds.end(), _seeds.begin(), _seeds.end());
140 return *this;
141 }
142
143 // This should create default domains
144 virtual void Run(int = 1000, int = 0) {}
145 virtual void RunOneTime(const uint8_t*, size_t) {}
146 virtual std::string MutateData(const uint8_t*, size_t, size_t, unsigned int) { return ""; }
147
148 TargetFunction func;
150 std::vector<ValueType> seeds;
151};
152
153extern void RunFuzzTest(IFuzzTest& fuzz_test, int seed = 0, int runs = 1000, int max_len = 0,
154 int timeout = 1200, int len_control = 100);
155
156
164template <typename TargetFunction, typename FuncType, typename Domain, typename Base>
165struct FuzzTestWithDomain : public Base {
166 FuzzTestWithDomain(const Base& ft, const Domain& domain) : Base(ft), m_domain(domain) {}
167
168 virtual void Run(int _count = 1000, int _seed = 0) override {
169 Base::count = 1;
170 Base::max_count = _count;
171 m_rng = new Rng(_seed);
172 RunFuzzTest(*this, _seed, _count, 500, 1200, 1);
173 delete m_rng;
174 m_rng = nullptr;
175 }
176
177 typename Domain::CorpusType GetRandomCorpus() {
178 Rng& rng = *this->m_rng;
179 if (Base::seeds.size() > 0 && rng.bounded(2) == 0) {
180 return m_domain.FromValue(Base::seeds[rng() % Base::seeds.size()]);
181 }
182 return m_domain.GetRandomCorpus(rng);
183 }
184
185 typename Domain::CorpusType TryParse(const std::string& input) {
186 try {
187 IRObject obj = IRObject::FromString(input);
189 return m_domain.ParseCorpus(obj);
190 } catch (...) {
191 return GetRandomCorpus();
192 }
193 }
194
195 template <typename T, unsigned... I>
196 void apply(T args, detail::seq<I...>) {
197 this->func(std::get<I>(args)...);
198 }
199
200 virtual void RunOneTime(const uint8_t* data, size_t size) override {
201 Base::count++;
202 std::string input = std::string((const char*)data, size);
203 typename Domain::CorpusType corpus = TryParse(input);
204 typename Domain::ValueType value = m_domain.GetValue(corpus);
205 apply(value, detail::gen_seq<std::tuple_size<typename Domain::ValueType>::value>{});
206 }
207
208 virtual std::string MutateData(const uint8_t* data, size_t size, size_t max_size,
209 unsigned int seed) override {
210 Rng rng(seed);
211 std::string input = std::string((const char*)data, size);
212 typename Domain::CorpusType corpus = TryParse(input);
213 m_domain.Mutate(rng, corpus, false);
214 IRObject mutated_obj = m_domain.SerializeCorpus(corpus);
215 return IRObject::ToString(mutated_obj);
216 }
217
220};
221
222
223template <typename T>
225 return FuzzTest<T>(func, context);
226}
227
228template <typename T>
229std::vector<T> ReadCorpusFromDir(std::string dir);
230
231
232} // namespace zeroerr
233
234
AggregateOf is a domain that combines multiple inner domains into a tuple or aggregate type.
Definition aggregate_of.h:41
Domain class for generating random values of a specific type.
Definition domain.h:21
virtual ValueType GetValue(const CorpusType &v) const =0
virtual void Mutate(Rng &rng, CorpusType &v, bool only_shrink=false) const =0
virtual CorpusType GetRandomCorpus(Rng &rng) const =0
virtual IRObject SerializeCorpus(const CorpusType &v) const
Definition domain.h:32
virtual CorpusType FromValue(const ValueType &v) const =0
virtual CorpusType ParseCorpus(IRObject v) const
Definition domain.h:31
Definition fuzztest.h:101
virtual const char * what() const
Definition fuzztest.h:103
Definition rng.h:30
uint32_t bounded(uint32_t range) noexcept
Definition rng.h:126
TestContext is a class that holds the test results and reporter context. There are 8 different matric...
Definition unittest.h:70
#define ZEROERR_SUPPRESS_COMMON_WARNINGS_POP
Definition config.h:265
#define ZEROERR_SUPPRESS_COMMON_WARNINGS_PUSH
Definition config.h:218
decltype(FunctionDecompositionImpl(std::declval< T >())) FunctionDecompositionT
Definition fuzztest.h:73
FunctionDecomposition< typename std::decay< Args >::type... > FunctionDecompositionImpl(void(*)(Args...))
Definition benchmark.cpp:17
void RunFuzzTest(IFuzzTest &fuzz_test, int seed, int runs, int max_len, int timeout, int len_control)
Definition fuzztest.cpp:32
AggregateOf< std::tuple< typename Inner::ValueType... >, Inner... > TupleOf(Inner &&... inner)
Definition aggregate_of.h:107
@ fuzz_test
Definition unittest.h:267
Decorator * timeout(float timeout)
Definition unittest.cpp:850
std::vector< T > ReadCorpusFromDir(std::string dir)
FuzzTest< T > FuzzFunction(T func, TestContext *context)
Definition fuzztest.h:224
FuzzTestWithDomain implements the Base class with the domain passed into.
Definition fuzztest.h:165
Domain m_domain
Definition fuzztest.h:218
FuzzTestWithDomain(const Base &ft, const Domain &domain)
Definition fuzztest.h:166
Domain::CorpusType GetRandomCorpus()
Definition fuzztest.h:177
virtual void RunOneTime(const uint8_t *data, size_t size) override
Definition fuzztest.h:200
void apply(T args, detail::seq< I... >)
Definition fuzztest.h:196
virtual std::string MutateData(const uint8_t *data, size_t size, size_t max_size, unsigned int seed) override
Definition fuzztest.h:208
Rng * m_rng
Definition fuzztest.h:219
virtual void Run(int _count=1000, int _seed=0) override
Definition fuzztest.h:168
Domain::CorpusType TryParse(const std::string &input)
Definition fuzztest.h:185
FuzzTest is a template class to create a fuzz test for the target function.
Definition fuzztest.h:108
TargetFunction func
Definition fuzztest.h:148
FuzzTest(TargetFunction func, TestContext *context)
Definition fuzztest.h:110
std::vector< ValueType > seeds
Definition fuzztest.h:150
TestContext * context
Definition fuzztest.h:149
FuzzTestWithDomainType< T... > WithDomains(T &&... domains)
Definition fuzztest.h:134
virtual void Run(int=1000, int=0)
Definition fuzztest.h:144
virtual void RunOneTime(const uint8_t *, size_t)
Definition fuzztest.h:145
typename FuncType::ValueType ValueType
Definition fuzztest.h:109
FuzzTest & WithSeeds(std::vector< ValueType > _seeds)
Definition fuzztest.h:138
FuzzTest(const FuzzTest &other)
Definition fuzztest.h:111
virtual std::string MutateData(const uint8_t *, size_t, size_t, unsigned int)
Definition fuzztest.h:146
FuzzTestWithDomainType< T... > WithDomains(AggregateOf< std::tuple< typename T::ValueType... >, T... > domain)
Definition fuzztest.h:123
Definition fuzztest.h:91
virtual void RunOneTime(const uint8_t *data, size_t size)=0
virtual std::string MutateData(const uint8_t *data, size_t size, size_t max_size, unsigned int seed)=0
virtual void Run(int count=1000, int seed=0)=0
bool should_stop()
Definition fuzztest.h:98
int max_count
Definition fuzztest.h:97
int count
Definition fuzztest.h:97
Interface for serializable objects.
Definition serialization.h:43
static std::string ToString(IRObject obj)
Definition serialization.cpp:133
static IRObject FromString(std::string str)
Definition serialization.cpp:139
@ Undefined
Definition serialization.h:58
unsigned type
Definition serialization.h:68
FunctionDecomposition is a meta function to decompose the function type. The ValueType and numOfArgs ...
Definition fuzztest.h:44
std::tuple< Args... > ValueType
Definition fuzztest.h:46
static constexpr size_t numOfArgs
Definition fuzztest.h:45
Definition typetraits.h:77
Definition fuzztest.h:59
void type
Definition fuzztest.h:60
Definition typetraits.h:74