High level conclusions

Reachability and coverage overview

The following table shows data about each function in the project. The functions included in this table correspond to all functions that exist in the executables of the fuzzers. As such, there may be functions that are from third-party libraries.

Fuzzer: tests/fuzz/simple_decompress.c

Call tree

Fuzzer: tests/fuzz/decompress_cross_format.c

Call tree

Fuzzer: tests/fuzz/dictionary_round_trip.c

Call tree

Fuzzer: tests/fuzz/stream_decompress.c

Call tree

Fuzzer: tests/fuzz/generate_sequences.c

Call tree

Fuzzer: tests/fuzz/decompress_dstSize_tooSmall.c

Call tree

Fuzzer: tests/fuzz/block_decompress.c

Call tree

Fuzzer: tests/fuzz/zstd_frame_info.c

Call tree

Fuzzer: tests/fuzz/simple_compress.c

Call tree

Fuzzer: tests/fuzz/dictionary_loader.c

Call tree

Fuzzer: tests/fuzz/seekable_roundtrip.c

Call tree

Fuzzer: tests/fuzz/huf_decompress.c

Call tree

Fuzzer: tests/fuzz/huf_round_trip.c

Call tree

Fuzzer: tests/fuzz/fse_read_ncount.c

Call tree

Fuzzer: tests/fuzz/raw_dictionary_round_trip.c

Call tree

Fuzzer: tests/fuzz/simple_round_trip.c

Call tree

Fuzzer: tests/fuzz/dictionary_decompress.c

Call tree

Fuzzer: tests/fuzz/stream_round_trip.c

Call tree

Fuzzer: tests/fuzz/sequence_compression_api.c

Call tree

Fuzzer: tests/fuzz/block_round_trip.c

Call tree

Fuzzer: tests/fuzz/dictionary_stream_round_trip.c

Call tree

Optimal target analysis

Remaining optimal interesting functions

The following table shows a list of functions that are optimal targets. Optimal targets are identified by finding the functions that in combination, yield a high code coverage.

Implementing fuzzers that target the above functions will improve reachability such that it becomes:

All functions overview

If you implement fuzzers for these functions, the status of all functions in the project will be:

This sections provides heuristics that can be used as input to a fuzz engine when running a given fuzz target. The current focus is on providing input that is usable by libFuzzer.

tests/fuzz/simple_decompress.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/decompress_cross_format.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/dictionary_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/stream_decompress.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/generate_sequences.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/decompress_dstSize_tooSmall.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/block_decompress.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/zstd_frame_info.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/simple_compress.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/dictionary_loader.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/seekable_roundtrip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/huf_decompress.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/huf_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/fse_read_ncount.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/raw_dictionary_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/simple_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/dictionary_decompress.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/stream_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/sequence_compression_api.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/block_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

tests/fuzz/dictionary_stream_round_trip.c

Dictionary

Use this with the libFuzzer -dict=DICT.file flag

New fuzzers

The below fuzzers are templates and suggestions for how to target the set of optimal functions above

dibio.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target DiB_trainFromFiles */
  char *new_var0 = ada_safe_get_char_p();
  UNKNOWN_TYPE unknown_1;
  char **new_var2 = af_get_double_char_p();
  int new_var3 = ada_safe_get_int();
  UNKNOWN_TYPE unknown_4;
  UNKNOWN_TYPE unknown_5;
  UNKNOWN_TYPE unknown_6;
  UNKNOWN_TYPE unknown_7;
  int new_var8 = ada_safe_get_int();
  UNKNOWN_TYPE unknown_9;
  DiB_trainFromFiles(new_var0, unknown_1, new_var2, new_var3, unknown_4, unknown_5, unknown_6, unknown_7, new_var8, unknown_9);

  af_safe_gb_cleanup();
}

fileio.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target FIO_compressMultipleFilenames */
  UNKNOWN_TYPE unknown_10;
  UNKNOWN_TYPE unknown_11;
  char **new_var12 = af_get_double_char_p();
  char *new_var13 = ada_safe_get_char_p();
  char *new_var14 = ada_safe_get_char_p();
  char *new_var15 = ada_safe_get_char_p();
  char *new_var16 = ada_safe_get_char_p();
  char *new_var17 = ada_safe_get_char_p();
  int new_var18 = ada_safe_get_int();
  UNKNOWN_TYPE unknown_19;
  FIO_compressMultipleFilenames(unknown_10, unknown_11, new_var12, new_var13, new_var14, new_var15, new_var16, new_var17, new_var18, unknown_19);

  af_safe_gb_cleanup();
}

zstreamtest.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target basicUnitTests */
  UNKNOWN_TYPE unknown_20;
  UNKNOWN_TYPE unknown_21;
  int new_var22 = ada_safe_get_int();
  basicUnitTests(unknown_20, unknown_21, new_var22);

  af_safe_gb_cleanup();
}

paramgrill.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target optimizeForSize */
  char **new_var23 = af_get_double_char_p();
  UNKNOWN_TYPE unknown_24;
  char *new_var25 = ada_safe_get_char_p();
  UNKNOWN_TYPE unknown_26;
  UNKNOWN_TYPE unknown_27;
  int new_var28 = ada_safe_get_int();
  int new_var29 = ada_safe_get_int();
  UNKNOWN_TYPE unknown_30;
  optimizeForSize(new_var23, unknown_24, new_var25, unknown_26, unknown_27, new_var28, new_var29, unknown_30);

  af_safe_gb_cleanup();
}

example.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target test_gzio */
  char *new_var31 = ada_safe_get_char_p();
  UNKNOWN_TYPE unknown_32;
  UNKNOWN_TYPE unknown_33;
  test_gzio(new_var31, unknown_32, unknown_33);

  af_safe_gb_cleanup();
}

decodecorpus.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target runTestMode */
  UNKNOWN_TYPE unknown_34;
  UNKNOWN_TYPE unknown_35;
  UNKNOWN_TYPE unknown_36;
  UNKNOWN_TYPE unknown_37;
  runTestMode(unknown_34, unknown_35, unknown_36, unknown_37);

  af_safe_gb_cleanup();
}

zstd_decompress.c

#include "ada_fuzz_header.h"

int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {
  af_safe_gb_init(data, size);

  /* target decode_frame */
  UNKNOWN_TYPE unknown_38;
  UNKNOWN_TYPE unknown_39;
  UNKNOWN_TYPE unknown_40;
  decode_frame(unknown_38, unknown_39, unknown_40);

  af_safe_gb_cleanup();
}

Files in report

Directories in report

This section shows a list of 3rd party function calls and their relative coverage information. By static analysis of the target project code, all of the 3rd party function call and their caller information, including the source file and line number that initiate the call are captured. The caller source code file and line number are shown in column 2 while column 1 is the function name of the 3rd party function call. Each occurrent of the 3rd party function call will occuply a separate row. Column 3 of each row indicate if the 3rd party call in the source file line is unreachable. Column 4 lists all fuzzers that have covered that particular system call in that specific location (source file and line)during their dynamic fuzzing.

Function in each files in report