Metadata-Version: 2.1
Name: dis-cover
Version: 0.1.3
Summary: Disasemble binaries and recover as much info as possible.
Home-page: https://github.com/louismerlin/dis-cover
Author: Louis Merlin
Author-email: louis.merlin@epfl.ch
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: capstone (>=4.0.2)
Requires-Dist: itanium-demangler (>=1.0)
Requires-Dist: pyelftools (>=0.27)


# dis-cover
Disasemble binaries and recover as much info as possible

## How to use

### Run the case studies

To run the case studies, simply `make run-scenarios`. You need to have `docker` installed.

### Command-line

You can access dis-cover by running `make shell`. You will then have access to `dis-cover`.

Here are the options :

```
$ dis-cover --help
usage: dis-cover [-h] [-o OUTPUT_DIRECTORY] [-b | -c] file

Disasemble binaries and recover as much info as possible

positional arguments:
  file                  File to dis-cover

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT_DIRECTORY, --output-directory OUTPUT_DIRECTORY
                        Directory where the temporary files are written
  -b, --bin             Extract info from a binary file (default)
  -c, --cpp             Compile C++ file under multiple scenarios and extract info from the given outputs
```

`dis-cover` is in early development, it will probably not work yet on your own binaries.


