README
¶
IPFS Datastore Fuzzer
The fuzzer provides a go fuzzer interface to Datastore implementations. This can be used for fuzz testing of these implementations.
Usage
First, configure the datastores to fuzz (from this directory):
// either run via `go run`
go run ./cmd/generate github.com/ipfs/go-ds-badger
// or `go generate`
DS_PROVIDERS="github.com/ipfs/go-ds-badger" go generate
Then, build the fuzzing artifact and fuzz:
go-fuzz-build
go-fuzz
If you don't have go-fuzz installed, it can be acquired as:
go get -u github.com/dvyukov/go-fuzz/go-fuzz github.com/dvyukov/go-fuzz/go-fuzz-build
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
var Threads int
Threads is a measure of concurrency. Note: if Threads > 1, determinism is not guaranteed.
Functions ¶
func Fuzz ¶
Fuzz is a go-fuzzer compatible input point for replaying data (interpreted as a script of commands) to known ipfs datastore implementations
Types ¶
type RunState ¶
type RunState struct {
Cancel context.CancelFunc
// contains filtered or unexported fields
}
RunState encapulates the state of a given fuzzing run
func (*RunState) FuzzStream ¶
FuzzStream sends a set of bytes to drive the current instance from a reader.
func (*RunState) TxnDB ¶
func (r *RunState) TxnDB() ds.TxnDatastore
TxnDB returns the transaciton database if the store under test supports transactions
Source Files
Directories