Skip to content

Latest commit

 

History

History
147 lines (93 loc) · 2.83 KB

USECASES.md

File metadata and controls

147 lines (93 loc) · 2.83 KB
Raw

Corpora

Upload Corpus

Corpus is identified with a label, so to upload corpus files with label test.

fuzzy cli corpora add test corpus/*

Download Corpus

Download corpus to a new_corpus folder.

fuzzy cli corpora download test new_corpus

Delete Corpus

Delete old corpus with label old.

fuzzy cli corpora delete old

Minimize Corpus

It is recommended to stop any running tasks that is using this corpus while doing this.

  • Download corpus that needs to be minimized to a new_corpus folder.
fuzzy cli corpora download test new_corpus
  • Apply any minimizations as necessary with appropriate tools and write to minimized_corpus/.
  • Delete old corpus with same label test.
fuzzy cli corpora delete test
  • Upload new minimized corpus with same label.
fuzzy cli corpora add test minimized_corpus/*

Download Latest Corpus

To download latest 100 new corpus that is being saved with label new

fuzzy cli corpora download new new_corpus/ --latest 100

This can generally be used to generate lcov html reports locally to see how coverage is proceeding.

Tasks

Add Task

fuzzy cli tasks add specialTask <path to profile.yaml>

List Tasks

fuzzy cli tasks list

Stop Task

To stop a task snappy with id 1.

fuzzy cli tasks stop 1

Update Task

To update a task snappy with id 1 with a new profile.

fuzzy cli tasks edit 1 --profile <path_to_profile.yaml>

Restart Task

To start a task snappy with id 1.

fuzzy cli tasks start 1

Crashes

Download Crashes

To download crashes with a label snappy_uncompress

fuzzy cli crashes snappy_uncompress new_crashes/

To download only verified crashes for a particular task alone

fuzzy cli crashes snappy_uncompress new_crashes/ --task-id 1 --verified

To download crashes that match a particular crash pattern

fuzzy cli crashes snappy_uncompress new_crashes/ --output "%SIGSEGV%"

Revalidate Crashes

If you have changed fuzz profile and need to validate your crashes again, let us say for task id 2

fuzzy cli crashes revalidate 2 /tmp:/tmp --all

--all flag revalidates verified crashes again with new config.

Deduplicate Crashes

If you have changed fuzz profile and need to deduplicate your crashes again, let us say for task id 2

fuzzy cli crashes deduplicate 2 /tmp:/tmp --all

--all flag revalidates verified crashes again with new config.

Searching Crashes

If you have enabled crash validation, stdout and stderr are saved as output. This can be searched using cli flag --output using ilike patterns of postgres.

fuzzy cli crashes download 1 ~/workspace/fuzzy_configs/ats/crashes/ --output "%str_alloc%"