Fixed typo

README.md

@@ -1,31 +1,49 @@
 # NEUZZ: a neural-network-assisted fuzzer (S&P'19)
 See IEEE S&P(Oakland)'19 [slides](https://drive.google.com/file/d/1_A33wucTOA2nZpKVArvsXajh-2LNrCZK/view?usp=sharing) and paper [NEUZZ: Efficient Fuzzing with Neural Program Smoothing](https://arxiv.org/abs/1807.05620) for details.
+
 ## Prerequisite
 Tested on a machine with Nvidia 1080Ti, Ubuntu 16.04/18.04, Tensorflow 1.8.0 and Keras 2.2.3.<br/>
 We recommend running NEUZZ on a machine with a Nvidia 1080Ti or higher for efficient NN training.
 - Python 2.7
 - Tensorflow
 - Keras
+
+### Install requirements
+
+```bash
+# run these commands to get your hands on the project
+apt update
+apt install -y python2.7 python-pip gcc git vim # install the essentials and some conveniences
+python2 -m pip install --user virtualenv
+python2 -m virtualenv vneuzz
+echo "vneuzz/*" >> .gitignore
+source vneuzz/bin/activate
+pip install tensorflow-gpu==1.8.0 keras==2.2.3
+echo done
+#deactivate # leave the virtualenv
+```
 ## Build
 ```bash
-    gcc -O3 -funroll-loops ./neuzz.c -o neuzz
+gcc -O3 -funroll-loops ./neuzz.c -o neuzz
 ```
+
 ## Usage
 We use a sample program readelf as an example.<br/>
 Open a terminal, start nn module
 ```bash
-    #python nn.py [program [arguments]]
-    python nn.py ./readelf -a
+#python nn.py [program [arguments]]
+python nn.py ./readelf -a
 ```
 open another terminal, start neuzz module.
 ```bash
-    #./neuzz -i in_dir -o out_dir -l mutation_len [program path [arguments]] @@
-    ./neuzz -i neuzz_in -o seeds -l 7506 ./readelf -a @@  
+#./neuzz -i in_dir -o out_dir -l mutation_len [program path [arguments]] @@
+./neuzz -i neuzz_in -o seeds -l 7506 ./readelf -a @@  
 ```
 If you want to try NEUZZ on a new program, 
 1. Compile the new program from source code using afl-gcc.
 2. Collect the training data by running AFL on the binary for a while(about an hour), then copy the queue folder to neuzz_in.
 3. Follow the above two steps to start NN module and NEUZZ module.
+
 ## Sample programs
 Try 10 real-world programs on NEUZZ. Check setup details at programs/[program names]/README.
 

programs/readelf/README.md

@@ -16,7 +16,7 @@
 ```
 cp /path_to_neuzz/neuzz /path_to_neuzz/programs/readelf
 cp /path_to_neuzz/nn.py /path_to_neuzz/programs/readelf
-cp /path_to_neuzz/alf-showmap /path_to_neuzz/programs/readelf
+cp /path_to_neuzz/afl-showmap /path_to_neuzz/programs/readelf
 ```
 
 4. Create output directory