Aaron Ballman | ef11698 | 2015-01-29 16:58:29 +0000 | [diff] [blame] | 1 | //===- FuzzerFlags.def - Run-time flags -------------------------*- C++ -* ===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
| 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
| 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 9 | // Flags. FUZZER_FLAG_INT/FUZZER_FLAG_STRING macros should be defined at the |
| 10 | // point of inclusion. We are not using any flag parsing library for better |
| 11 | // portability and independence. |
Aaron Ballman | ef11698 | 2015-01-29 16:58:29 +0000 | [diff] [blame] | 12 | //===----------------------------------------------------------------------===// |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 13 | FUZZER_FLAG_INT(verbosity, 1, "Verbosity level.") |
| 14 | FUZZER_FLAG_INT(seed, 0, "Random seed. If 0, seed is generated.") |
| 15 | FUZZER_FLAG_INT(iterations, -1, |
Kostya Serebryany | 33f8669 | 2015-02-04 22:20:09 +0000 | [diff] [blame] | 16 | "Number of iterations of the fuzzer internal loop" |
| 17 | " (-1 for infinite iterations).") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 18 | FUZZER_FLAG_INT(runs, -1, |
Kostya Serebryany | 33f8669 | 2015-02-04 22:20:09 +0000 | [diff] [blame] | 19 | "Number of individual test runs (-1 for infinite runs).") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 20 | FUZZER_FLAG_INT(max_len, 64, "Maximal length of the test input.") |
| 21 | FUZZER_FLAG_INT(cross_over, 1, "If 1, cross over inputs.") |
| 22 | FUZZER_FLAG_INT(mutate_depth, 5, |
Aaron Ballman | ef11698 | 2015-01-29 16:58:29 +0000 | [diff] [blame] | 23 | "Apply this number of consecutive mutations to each input.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 24 | FUZZER_FLAG_INT( |
| 25 | prefer_small_during_initial_shuffle, -1, |
Kostya Serebryany | 92e0476 | 2015-02-04 23:42:42 +0000 | [diff] [blame] | 26 | "If 1, always prefer smaller inputs during the initial corpus shuffle." |
| 27 | " If 0, never do that. If -1, do it sometimes.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 28 | FUZZER_FLAG_INT(exit_on_first, 0, |
Aaron Ballman | ef11698 | 2015-01-29 16:58:29 +0000 | [diff] [blame] | 29 | "If 1, exit after the first new interesting input is found.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 30 | FUZZER_FLAG_INT(timeout, -1, "Timeout in seconds (if positive).") |
| 31 | FUZZER_FLAG_INT(help, 0, "Print help.") |
| 32 | FUZZER_FLAG_INT( |
| 33 | save_minimized_corpus, 0, |
Aaron Ballman | ef11698 | 2015-01-29 16:58:29 +0000 | [diff] [blame] | 34 | "If 1, the minimized corpus is saved into the first input directory") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 35 | FUZZER_FLAG_INT(use_counters, 0, "Use coverage counters") |
| 36 | FUZZER_FLAG_INT(use_full_coverage_set, 0, |
Kostya Serebryany | 2e3622b | 2015-02-20 03:02:37 +0000 | [diff] [blame] | 37 | "Experimental: Maximize the number of different full" |
Kostya Serebryany | 2c1b33b | 2015-01-29 23:01:07 +0000 | [diff] [blame] | 38 | " coverage sets as opposed to maximizing the total coverage." |
| 39 | " This is potentially MUCH slower, but may discover more paths.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 40 | FUZZER_FLAG_INT(use_coverage_pairs, 0, |
Kostya Serebryany | 2e3622b | 2015-02-20 03:02:37 +0000 | [diff] [blame] | 41 | "Experimental: Maximize the number of different coverage pairs.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 42 | FUZZER_FLAG_INT(jobs, 0, "Number of jobs to run. If jobs >= 1 we spawn" |
Kostya Serebryany | e8cee11 | 2015-01-31 01:14:40 +0000 | [diff] [blame] | 43 | " this number of jobs in separate worker processes" |
| 44 | " with stdout/stderr redirected to fuzz-JOB.log.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 45 | FUZZER_FLAG_INT(workers, 0, |
Kostya Serebryany | e8cee11 | 2015-01-31 01:14:40 +0000 | [diff] [blame] | 46 | "Number of simultaneous worker processes to run the jobs.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 47 | FUZZER_FLAG_INT(dfsan, 1, "Use DFSan for taint-guided mutations. No-op unless " |
Kostya Serebryany | 16d03bd | 2015-03-30 22:09:51 +0000 | [diff] [blame] | 48 | "the DFSan instrumentation was compiled in.") |
Kostya Serebryany | 52a788e | 2015-03-31 20:13:20 +0000 | [diff] [blame^] | 49 | |
| 50 | FUZZER_FLAG_STRING(tokens, "Use the file with tokens (one token per line) to" |
| 51 | " fuzz a token based input language.") |
| 52 | FUZZER_FLAG_STRING(apply_tokens, "Read the given input file, substitute bytes " |
| 53 | " with tokens and write the result to stdout.") |