cstest: README

This commit is contained in:
Nguyen Anh Quynh 2019-02-12 00:10:54 +08:00
parent 7b10f56c02
commit ee8ddb630f

View File

@ -1,9 +1,18 @@
# Regression testing
This directory contains a tool for regression testing core of Capstone
## Build
- Download [Cmocka](https://git.cryptomilk.org/projects/cmocka.git)
## Dependency
- MacOS users can install cmocka with:
```
brew install cmocka
```
- Or download & build from source code [Cmocka](https://git.cryptomilk.org/projects/cmocka.git)
- Build Cmocka
```
cd cmocka_dir
mkdir build
@ -12,38 +21,53 @@ cmake ..
make
sudo make isntall
```
- Then build `cstest`
## Build
- Build `cstest`
```
cd suite/cstest
make
```
## Usage
- Test for all closed issues
```
cd suite/cstest
./build/cstest -f ./issues.cs
```
- Test for some input from LLVM
```
cd suite/cstest
./build/cstest -f ../MC/AArch64/basic-a64-instructions.s.cs
```
- Test for all cs file in a folder
```
cd suite/cstest
./build/cstest -d ../MC
```
- Test all
```
cd suite/cstest
make cstest
```
## Using report tool
- Usage `python report.py -t <cstest_path> [-f <file_name.cs>] [-d <directory>]`
- Example:
```
python report.py -t build/cstest -d ../MC/PowerPC/
!python report.py -t build/cstest -f issues.cs
python report.py -t build/cstest -f issues.cs
```