Project

General

Profile

Actions

Documentation #5225

open

testing/fuzz: improve documentation on how to fuzz suricata

Added by Juliana Fajardini Reichow about 2 years ago. Updated over 1 year ago.

Status:
In Progress
Priority:
Normal
Assignee:
Target version:
Affected Versions:
Effort:
Difficulty:
Label:

Description

We have a readme page on how to run the fuzzers, and an unfinished devguide page on how to test
suricata with fuzzers.

This task is meant to cover updating the readme file and complete a v1 for the testing page.

This is a follow-up of the work done in https://github.com/OISF/suricata/pull/6569

Actions #1

Updated by Juliana Fajardini Reichow about 2 years ago

  • Description updated (diff)
Actions #2

Updated by Philippe Antoine over 1 year ago

Should I do anything here ?

Actions #3

Updated by Juliana Fajardini Reichow over 1 year ago

Philippe Antoine wrote in #note-2:

Should I do anything here ?

I've been trying to write down something that would make it easier for a community contributor to run the fuzzers locally, especially in the case where our CIFuzz finds a bug in work contributed by them, which they'd ideally like to reproduce locally using the generated artifact, so they could try and fix the bug.

But I have failed, so far, in creating documentation showing how to run Suri fuzzers with oss-fuzz and using a local branch that is accessible and doesn't require lots of tweaking here and there.

You are likely the person with more experience in this, so I think you may be a more suitable contributor to the task, @Philippe Antoine :P

Actions #4

Updated by Philippe Antoine over 1 year ago

Did you not manage with the help of Docker and https://google.github.io/oss-fuzz/advanced-topics/reproducing/ ?

Actions #5

Updated by Juliana Fajardini Reichow over 1 year ago

Not so far. The issues I faced when trying to do so were mainly that I wasn't able to, using docker and following the instructions from https://google.github.io/oss-fuzz/advanced-topics/reproducing/, build an image with my changes - unless I went into changes in files which Victor judged wouldn't be good in the documentation...

Actions

Also available in: Atom PDF