fuzz Namespace Reference

Data Structures
class	FrameType
class	InputType
class	TargetInfo

Functions
	abs_join (a, *p)
	create (r)
	check (r)
	tmpdir ()
	parse_targets (in_targets)
	targets_parser (args, description)
	parse_env_flags (args, flags)
	compiler_version (cc, cxx)
	overflow_ubsan_flags (cc, cxx)
	build_parser (args)
	build (args)
	libfuzzer_parser (args)
	libfuzzer (target, corpora=None, artifact=None, seed=None, extra_args=None)
	libfuzzer_cmd (args)
	afl_parser (args)
	afl (args)
	regression (args)
	gen_parser (args)
	gen (args)
	minimize (args)
	zip_cmd (args)
	list_cmd (args)
	short_help (args)
	help (args)
	main ()

Variables
	FUZZ_DIR = os.path.abspath(os.path.dirname(__file__))
	CORPORA_DIR = abs_join(FUZZ_DIR, 'corpora')
dict	TARGET_INFO
	TARGETS = list(TARGET_INFO.keys())
	ALL_TARGETS = TARGETS + ['all']
int	FUZZ_RNG_SEED_SIZE = 4
	CC = os.environ.get('CC', 'cc')
	CXX = os.environ.get('CXX', 'c++')
	CPPFLAGS = os.environ.get('CPPFLAGS', '')
	CFLAGS = os.environ.get('CFLAGS', '-O3')
	CXXFLAGS = os.environ.get('CXXFLAGS', CFLAGS)
	LDFLAGS = os.environ.get('LDFLAGS', '')
	MFLAGS = os.environ.get('MFLAGS', '-j')
	LIB_FUZZING_ENGINE = os.environ.get('LIB_FUZZING_ENGINE', 'libregression.a')
	AFL_FUZZ = os.environ.get('AFL_FUZZ', 'afl-fuzz')
	DECODECORPUS
	ZSTD = os.environ.get('ZSTD', abs_join(FUZZ_DIR, '..', '..', 'zstd'))
	MSAN_EXTRA_CPPFLAGS = os.environ.get('MSAN_EXTRA_CPPFLAGS', '')
	MSAN_EXTRA_CFLAGS = os.environ.get('MSAN_EXTRA_CFLAGS', '')
	MSAN_EXTRA_CXXFLAGS = os.environ.get('MSAN_EXTRA_CXXFLAGS', '')
	MSAN_EXTRA_LDFLAGS = os.environ.get('MSAN_EXTRA_LDFLAGS', '')
	THIRD_PARTY_SEQ_PROD_OBJ = os.environ.get('THIRD_PARTY_SEQ_PROD_OBJ', '')

Function Documentation

abs_join()

abs_join	(		a,
		*	p )

afl()

afl

(

args

)

afl_parser()

afl_parser

(

args

)

build()

build

(

args

)

build_parser()

build_parser

(

args

)

check()

check

(

r

)

compiler_version()

compiler_version	(		cc,
			cxx )

Determines the compiler and version.
Only works for clang and gcc.

create()

create

(

r

)

gen()

gen

(

args

)

gen_parser()

gen_parser

(

args

)

help()

help

(

args

)

libfuzzer()

libfuzzer	(		target,
			corpora = None,
			artifact = None,
			seed = None,
			extra_args = None )

libfuzzer_cmd()

libfuzzer_cmd

(

args

)

libfuzzer_parser()

libfuzzer_parser

(

args

)

list_cmd()

list_cmd

(

args

)

main()

main

(

void

)

minimize()

minimize

(

args

)

overflow_ubsan_flags()

overflow_ubsan_flags	(		cc,
			cxx )

parse_env_flags()

parse_env_flags	(		args,
			flags )

Look for flags set by environment variables.

parse_targets()

parse_targets

(

in_targets

)

regression()

regression

(

args

)

short_help()

short_help

(

args

)

targets_parser()

targets_parser	(		args,
			description )

tmpdir()

tmpdir

(

)

zip_cmd()

zip_cmd

(

args

)

Variable Documentation

AFL_FUZZ

AFL_FUZZ = os.environ.get('AFL_FUZZ', 'afl-fuzz')

ALL_TARGETS

ALL_TARGETS = TARGETS + ['all']

CC

CC = os.environ.get('CC', 'cc')

CFLAGS

CFLAGS = os.environ.get('CFLAGS', '-O3')

CORPORA_DIR

CORPORA_DIR = abs_join(FUZZ_DIR, 'corpora')

CPPFLAGS

CPPFLAGS = os.environ.get('CPPFLAGS', '')

CXX

CXX = os.environ.get('CXX', 'c++')

CXXFLAGS

CXXFLAGS = os.environ.get('CXXFLAGS', CFLAGS)

DECODECORPUS

DECODECORPUS

Initial value:

=  os.environ.get('DECODECORPUS',
                              abs_join(FUZZ_DIR, '..', 'decodecorpus'))

FUZZ_DIR

FUZZ_DIR = os.path.abspath(os.path.dirname(__file__))

FUZZ_RNG_SEED_SIZE

int FUZZ_RNG_SEED_SIZE = 4

LDFLAGS

LDFLAGS = os.environ.get('LDFLAGS', '')

LIB_FUZZING_ENGINE

LIB_FUZZING_ENGINE = os.environ.get('LIB_FUZZING_ENGINE', 'libregression.a')

MFLAGS

MFLAGS = os.environ.get('MFLAGS', '-j')

MSAN_EXTRA_CFLAGS

MSAN_EXTRA_CFLAGS = os.environ.get('MSAN_EXTRA_CFLAGS', '')

MSAN_EXTRA_CPPFLAGS

MSAN_EXTRA_CPPFLAGS = os.environ.get('MSAN_EXTRA_CPPFLAGS', '')

MSAN_EXTRA_CXXFLAGS

MSAN_EXTRA_CXXFLAGS = os.environ.get('MSAN_EXTRA_CXXFLAGS', '')

MSAN_EXTRA_LDFLAGS

MSAN_EXTRA_LDFLAGS = os.environ.get('MSAN_EXTRA_LDFLAGS', '')

TARGET_INFO

dict TARGET_INFO

Initial value:

=  {
    'simple_round_trip': TargetInfo(InputType.RAW_DATA),
    'stream_round_trip': TargetInfo(InputType.RAW_DATA),
    'block_round_trip': TargetInfo(InputType.RAW_DATA, FrameType.BLOCK),
    'simple_decompress': TargetInfo(InputType.COMPRESSED_DATA),
    'stream_decompress': TargetInfo(InputType.COMPRESSED_DATA),
    'block_decompress': TargetInfo(InputType.COMPRESSED_DATA, FrameType.BLOCK),
    'dictionary_round_trip': TargetInfo(InputType.RAW_DATA),
    'dictionary_decompress': TargetInfo(InputType.COMPRESSED_DATA),
    'zstd_frame_info': TargetInfo(InputType.COMPRESSED_DATA),
    'simple_compress': TargetInfo(InputType.RAW_DATA),
    'dictionary_loader': TargetInfo(InputType.DICTIONARY_DATA),
    'raw_dictionary_round_trip': TargetInfo(InputType.RAW_DATA),
    'dictionary_stream_round_trip': TargetInfo(InputType.RAW_DATA),
    'decompress_dstSize_tooSmall': TargetInfo(InputType.RAW_DATA),
    'fse_read_ncount': TargetInfo(InputType.RAW_DATA),
    'sequence_compression_api': TargetInfo(InputType.RAW_DATA),
    'seekable_roundtrip': TargetInfo(InputType.RAW_DATA),
    'huf_round_trip': TargetInfo(InputType.RAW_DATA),
    'huf_decompress': TargetInfo(InputType.RAW_DATA),
}

TARGETS

TARGETS = list(TARGET_INFO.keys())

THIRD_PARTY_SEQ_PROD_OBJ

THIRD_PARTY_SEQ_PROD_OBJ = os.environ.get('THIRD_PARTY_SEQ_PROD_OBJ', '')

ZSTD

ZSTD = os.environ.get('ZSTD', abs_join(FUZZ_DIR, '..', '..', 'zstd'))