Skip to content

Commit 3aca698

Browse files
committed
update docs.
1 parent 0971a16 commit 3aca698

File tree

5 files changed

+10
-7
lines changed

5 files changed

+10
-7
lines changed

.idea/sonarlint/issuestore/index.pb

Whitespace-only changes.

dataset/README.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ At this time, IUST PDF Corpus is ready to view and download.
1313
## IUST-PDFCorpus
1414
**Download:** [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3484013.svg)](https://doi.org/10.5281/zenodo.3484013)
1515

16-
![IUSTPDFCorpusDemo Image](pdfs/IUST-PDFCorpusDemo.PNG)
16+
![IUSTPDFCorpusDemo Image](../docs/figs/IUST-PDFCorpusDemo.png)
1717

1818
We are happy to introduce **IUST PDF Corpus**, a large set of various PDF files, aimed at manipulating,
1919
testing and improving the qualification of real-world PDF readers such as [MuPDF](https://mupdf.com/).
@@ -33,3 +33,4 @@ Under gathering, construction and sanitizing. Coming soon :)
3333

3434
Under gathering, construction and sanitizing. Coming Soon :)
3535

36+
*Last update: April 13, 2020*

docs/dataset.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ We refer the user on [dataset subdirectory](../dataset/) of project which is ava
1313
## IUST-PDFCorpus
1414
**Download:** [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3484013.svg)](https://doi.org/10.5281/zenodo.3484013)
1515

16-
![IUSTPDFCorpusDemo Image](pdfs/IUST-PDFCorpusDemo.PNG)
16+
![IUSTPDFCorpusDemo Image](figs/IUST-PDFCorpusDemo.png)
1717

1818
We are happy to introduce **IUST PDF Corpus**, a large set of various PDF files, aimed at manipulating,
1919
testing and improving the qualification of real-world PDF readers such as [MuPDF](https://mupdf.com/).
@@ -33,3 +33,4 @@ Under gathering, construction and sanitizing. Coming soon :)
3333

3434
Under gathering, construction and sanitizing. Coming Soon :)
3535

36+
*Last update: April 13, 2020*
File renamed without changes.

docs/index.md

+6-5
Original file line numberDiff line numberDiff line change
@@ -20,26 +20,27 @@ You need to have Python 3.6.x and and up-to-date TensorFlow and Keras frameworks
2020
* Install [Python 3.6.x](https://www.python.org/)
2121
* Install [TensorFlow](https://www.tensorflow.org/)
2222
* Install [Keras](https://keras.io/)
23-
* Clone the IUST-DeepFuzz repository: `git clone https://github.com/m-zakeri/iust_deep_fuzz.git` or download the latest version https://github.com/m-zakeri/iust_deep_fuzz.git
23+
* Clone the IUST-DeepFuzz repository: `git clone https://github.com/m-zakeri/iust_deep_fuzz.git` or download the latest version [https://github.com/m-zakeri/iust_deep_fuzz.git](https://github.com/m-zakeri/iust_deep_fuzz.git)
2424
* IUST-DeepFuzz is almost ready for test data generation!
2525

2626
### Running
2727
* Configure the `config.py` work with your dataset and to set other paths settings.
28-
* Find the script of specific algorithm that you need.
28+
* Find the `.py` script of specific algorithm that you need.
2929
* Run the script in command line: `python script_name.py`
3030
* Wait until your file format learn and your test data is generate!
31+
* Happy fuzzing.
3132

3233
#### Available Pre-trained Models
33-
A pre-trained model is a model that was trained on a large benchmark dataset to solve a problem similar to the one that we want to solve. For the time being, we provided some pre-trained model for *PDF file format*. Our best trained model is available at [model_checkpoint/best_models](../model_checkpoint/best_models)
34+
A pre-trained model is a model that was trained on a large benchmark dataset to solve a problem similar to the one that we want to solve. For the time being, we provided some pre-trained model for *PDF file format*. Our best trained model is available at [model_checkpoint/best_models](https://github.com/m-zakeri/iust_deep_fuzz/tree/master/model_checkpoint/best_models)
3435

3536
#### Availbale Fuzzing Scripts
3637
ISUT-DeepFuzz has implemented four new deep models and two new fuzz algorithms: DataNeuralFuzz and MetadataNeuralFuzz as our contribution in mentioned thesis. The following algorithms to generate and fuzz test data are available in the current release (r0.3.0):
3738
* `data_neural_fuzz.py`: To implement the DataNeuralFuzz algorithm for fuzzing data in the files.
3839
* `metadata_neural_fuzz.py`: To implement MetadataNeuralFuzz for fuzzing metadata in the files.
39-
* `learn_and_fuzz_3_sample_fuzz.py`: To implement SampleFuzz algorithm introduced in https://arxiv.org/abs/1701.07232.
40+
* `learn_and_fuzz_3_sample_fuzz.py`: To implement SampleFuzz algorithm introduced in the [Learn and Fuzz Paper](https://arxiv.org/abs/1701.07232).
4041

4142
#### Available Dataset
42-
Various file formats for learning with IUST-DeepFuzz and then fuzz testing are available at [dataset directory](dataset.md).
43+
Various file formats for learning with IUST-DeepFuzz and then fuzz testing are available at [dataset directory](https://github.com/m-zakeri/iust_deep_fuzz/tree/master/dataset). Read dataset descriptions [here](dataset.md).
4344

4445

4546
## How It Works?

0 commit comments

Comments
 (0)