featurebase/roaring
Seebs 7d1fde7438 drop anti-entropy feature, since it doesn't work
The anti-entropy feature has never actually worked. We've been
talking about removing it or replacing it for ages, but haven't
had a concrete motivation.

But the anti-entropy interface is the sole user of several components
of the Tx interface, and now that we're trying to replace that
interface, being able to drop those components has some appeal, so
let's remove the one thing that used them, in the hopes that this
will simplify life.

This also lets us drop ForEach and ForEachRange, which were
barely used at all. The one surviving usage (CSV export) can be
handled by using the container iterator we already have, and
making ContainerCallback exported so we can use it to just call
things for every bit.

(cherry picked from commit fff9ddc1f5)
2022-11-15 11:31:13 -08:00
..
benchpretty Updated dependency paths to reflect new repo location 2022-09-06 09:39:22 -07:00
testdata cleanup #1622 2018-09-06 16:27:10 -05:00
add.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
add_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
btree.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
btree_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
container_archetypes.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
container_stash.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
containers_btree.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
containers_slice.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
containers_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
filter.go drop anti-entropy feature, since it doesn't work 2022-11-15 11:31:13 -08:00
filter_internal_test.go Updated dependency paths to reflect new repo location 2022-09-06 09:39:22 -07:00
fuzz_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
fuzzer.go fix: updating code to meet linting requirements (#2171) 2022-09-29 12:34:29 -04:00
inst.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
naive.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
naive_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
nop_inst.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
printutil.go Updated dependency paths to reflect new repo location 2022-09-06 09:39:22 -07:00
printutil_test.go Updated dependency paths to reflect new repo location 2022-09-06 09:39:22 -07:00
README.md Fixed typo 2019-06-17 16:47:28 -05:00
roaring.go drop anti-entropy feature, since it doesn't work 2022-11-15 11:31:13 -08:00
roaring_container_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_helpers_test.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_internal_test.go drop anti-entropy feature, since it doesn't work 2022-11-15 11:31:13 -08:00
roaring_nop_paranoia.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_nop_sentinel.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_nop_stats.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_paranoia.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_sentinel.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00
roaring_stats.go Updated dependency paths to reflect new repo location 2022-09-06 09:39:22 -07:00
roaring_test.go Updated dependency paths to reflect new repo location 2022-09-06 09:39:22 -07:00
unmarshal_binary.go Updated code to latest version for open-sourcing. 2022-09-02 13:23:39 -07:00

The Fuzzer

For complete documentation on go-fuzz, please see: https://github.com/dvyukov/go-fuzz

The fuzzer in relation to the roaring package checks the Bitmap.UnmarshalBinary function found in roaring.go. In order to use the fuzzer, you can follow these steps:

cd $GOPATH/src/github.com/pilosa/pilosa/roaring

go-fuzz-build ./

You must now make the workdir/corpus directory. This is achieved by:

mkdir workdir/corpus

The fuzzer needs some input to start the fuzzing with. Copy some sample Pilosa fragments into the workdir/corpus folder. For example:

cp ~/.pilosa/my-index/my-field/views/standard/fragments/0 workdir/corpus

Once you have copied your sample inputs, you are ready to run the fuzzer:

go-fuzz -bin=roaring-fuzz.zip -workdir=workdir -func=FuzzBitmapUnmarshalBinary

Understanding the Fuzzer Output

The fuzzer will output something similar to the follwoing:

2015/04/25 12:39:53 workers: 8, corpus: 124 (12s ago), crashers: 37, restarts: 1/15, execs: 35342 (2941/sec), cover: 403, uptime: 12s

The most important part of the output is the crashers and cover. The crashers records how many combinations were discovered that fail and the cover tells you how much code is being accessed. For a complete explanation of the output, please see: https://github.com/dvyukov/go-fuzz.

The fuzzer will document the crashers in a folder labeled "crashers." It will record the fragment and the error that was produced in two separate files within this folder. This is the final product.

Happy Fuzzing!