Project

General

Profile

Actions

Documentation #5225

open

testing/fuzz: improve documentation on how to fuzz suricata

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

Status:
In Progress
Priority:
Normal
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 over 2 years ago

  • Description updated (diff)
Actions #2

Updated by Philippe Antoine almost 2 years ago

Should I do anything here ?

Actions #3

Updated by Juliana Fajardini Reichow almost 2 years 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 almost 2 years 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 almost 2 years 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 #6

Updated by Philippe Antoine about 2 months ago

  • Assignee changed from OISF Dev to Juliana Fajardini Reichow
Actions

Also available in: Atom PDF