71
edits
(→Getting Started: update steps) |
(update all steps) |
||
| Line 24: | Line 24: | ||
* MozITP - mullet - phone | * MozITP - mullet - phone | ||
== Current Environment & Setup == | |||
Fuzzing testing tests are run by automation; the test suite collects specific test cases on certain target for example:audio play, etc., mutate the testing data and inject to those test cases. Right now we have one 1 fuzzer which is focus on audio file header mutation. | Fuzzing testing tests are run by automation; the test suite collects specific test cases on certain target for example:audio play, etc., mutate the testing data and inject to those test cases. Right now we have one 1 fuzzer which is focus on audio file header mutation. | ||
| Line 48: | Line 48: | ||
If you are on Ubuntu, you need to check that it is configured to support the USB connection to the device. To verify this, connect the device to your computer via USB, open a terminal and enter the adb logcat command to see if it connects. If not, you may need to set up a udev rule for the device. | If you are on Ubuntu, you need to check that it is configured to support the USB connection to the device. To verify this, connect the device to your computer via USB, open a terminal and enter the adb logcat command to see if it connects. If not, you may need to set up a udev rule for the device. | ||
<big>Step 1: Clone the mozCingi repository </big> | |||
Clone the mozcingi repository in a folder you will remember: | Clone the mozcingi repository in a folder you will remember: | ||
git clone https://github.com/ShakoHo/mozCingi | git clone https://github.com/ShakoHo/mozCingi | ||
<big>Step 2: Run the setup </big> | |||
Install all requirements including mozITP and FuzzManager | Install all requirements including mozITP and FuzzManager | ||
| Line 58: | Line 60: | ||
make mutagen-install | make mutagen-install | ||
<big>Step 3: Set configuration variable</big> | |||
You can leverage the sample configuration under conf/, copy the sample configuration and modify it | |||
cp conf/mutagenFuzzer.json.bak conf/mutagenFuzzer.json | |||
vi conf/mutagenFuzzer.json | |||
<big>Step 4: Switch to python virtual environment</big> | |||
switch to python virtual environment, just created by make mutagen-install | switch to python virtual environment, just created by make mutagen-install | ||
source ./env/bin/activate | source ./env/bin/activate | ||
<big>Step 5: Run the tests</big> | |||
use cingi command to start the whole framework, you could add --dirpath to specify configuration folder | use cingi command to start the whole framework, you could add --dirpath to specify configuration folder | ||
cingi --dirpath conf | cingi --dirpath conf | ||
edits