@@ -16,20 +16,20 @@ Prerequisites
16
16
17
17
- linux.git: You will need our branch with the AFL patches and satconfig patches:
18
18
19
- $ git pull https://github.com/vegard/linux-2.6.git v4.6+kconfig-sat
19
+ $ git pull https://github.com/vegard/linux-2.6.git v4.6+kconfig-sat
20
20
21
21
- kvm/qemu: KVM is required for certain fuzzers or if you just want to use KVM instead of UML.
22
22
23
23
- gcc 5: gcc 5 or later is needed for building the kernel using our instrumentation plugin. On Ubuntu you can do:
24
24
25
- $ sudo add-apt-repository ppa: ubuntu-toolchain-r /test
26
- $ sudo apt-get update
27
- $ sudo apt-get install gcc-5
25
+ $ sudo add-apt-repository ppa:ubuntu-toolchain-r/test
26
+ $ sudo apt-get update
27
+ $ sudo apt-get install gcc-5
28
28
29
29
- Python packages: jinja2 and yaml. On Ubuntu you can do:
30
30
31
- $ sudo apt-get install python-jinja2
32
- $ sudo apt-get install python-yaml
31
+ $ sudo apt-get install python-jinja2
32
+ $ sudo apt-get install python-yaml
33
33
34
34
35
35
Prepare the kernel branch
@@ -41,7 +41,7 @@ Prepare the kernel branch
41
41
42
42
3 . Merge the satconfig branch:
43
43
44
- $ git pull https://github.com/vegard/linux-2.6.git v4.6+kconfig-sat
44
+ $ git pull https://github.com/vegard/linux-2.6.git v4.6+kconfig-sat
45
45
46
46
4 . Set the 'linux_afl_rev' variable in config.yml to point to the resulting commit (can be a branch, a sha1, or even just 'HEAD')
47
47
@@ -59,26 +59,26 @@ Launch a fuzzer
59
59
60
60
2 . Run the following command:
61
61
62
- $ bin/start --master ext4 0
62
+ $ bin/start --master ext4 0
63
63
64
64
This should start a single ext4 fuzzer in the current screen window.
65
65
66
66
3 . If the fuzzer stops or crashes, you can resume it later with:
67
67
68
- $ bin/start --resume --master ext4 0
68
+ $ bin/start --resume --master ext4 0
69
69
70
70
4 . If you want to start additional fuzzers, create a new screen window and run e.g.:
71
71
72
- $ bin/start ext4 1
72
+ $ bin/start ext4 1
73
73
74
74
5 . If you want to run many fuzzers in parallel, it is advised that you bind each fuzzer to a single, specific CPU:
75
75
76
- $ taskset -c 0 bin/start --master ext4 0
77
- $ taskset -c 1 bin/start ext4 1
78
- ...
76
+ $ taskset -c 0 bin/start --master ext4 0
77
+ $ taskset -c 1 bin/start ext4 1
78
+ ...
79
79
80
80
81
81
How to contribute
82
82
=================
83
83
84
- Please see CONTRIBUTING.md .
84
+ Please see [ CONTRIBUTING] ( ./CONTRIBUTING.md ) .
0 commit comments