Commit fe85cb77 by devttys0

Updated INSTALL.md

parent 996ada94
...@@ -17,46 +17,39 @@ $ make ...@@ -17,46 +17,39 @@ $ make
$ sudo make install $ sudo make install
``` ```
Binwalk's core features will work out of the box without any additional dependencies. However, to take advantage of binwalk's more advanced capabilities, multiple supporting utilities/packages need to be installed. Binwalk's core features will work out of the box without any additional dependencies. However, to take advantage of binwalk's more advanced capabilities, multiple supporting utilities/packages need to be installed (see the Dependencies section below).
To ease "dependency hell", a shell script named `deps.sh` is included which attempts to install all required dependencies for Debian and RedHat based systems:
```bash
$ ./deps.sh
```
If you are running a different system, or prefer to install these dependencies manually, see the Dependencies section below.
Dependencies Dependencies
============ ============
The following dependencies are only required for optional binwalk features, such as file extraction and graphing capabilities. Unless otherwise specified, these dependencies are available from most Linux package managers. The following run-time dependencies are only required for optional binwalk features, such as file extraction and graphing capabilities. Unless otherwise specified, these dependencies are available from most Linux package managers.
Binwalk uses [pyqtgraph](http://www.pyqtgraph.org) to generate graphs and visualizations, which requires the following: Binwalk uses [pyqtgraph](http://www.pyqtgraph.org) to generate graphs and visualizations, which requires the following:
libqt4-opengl ```bash
python-opengl $ sudo apt-get install libqt4-opengl python-opengl python-qt4 python-qt4-gl python-numpy python-scipy
python-qt4 $ sudo pip install pyqtgraph
python-qt4-gl ```
python-numpy
python-scipy Binwalk's `--disasm` option requires the [Capstone](http://www.capstone-engine.org/) disassembly framework and its corresponding Python bindings:
```bash
$ wget http://www.capstone-engine.org/download/2.1.2/capstone-2.1.2.tgz
$ tar -zxvf capstone-2.1.2.tgz
$ (cd capstone-2.1.2 && ./make.sh && sudo make install)
$ (cd capstone-2.1.2/bindings/python && sudo python ./setup.py install)
```
Binwalk relies on multiple external utilties in order to automatically extract/decompress files and data: Binwalk relies on multiple external utilties in order to automatically extract/decompress files and data:
mtd-utils ```bash
zlib1g-dev $ sudo apt-get install mtd-utils zlib1g-dev liblzma-dev ncompress gzip bzip2 tar arj p7zip p7zip-full cabextract openjdk-6-jdk
liblzma-dev ```
ncompress
gzip ```bash
bzip2 $ git clone https://github.com/devttys0/sasquatch
tar $ (cd sasquatch && make && sudo make install)
arj ```
p7zip
cabextract
p7zip-full
openjdk-6-jdk
firmware-mod-kit [https://code.google.com/p/firmware-mod-kit]
capstone [http://www.capstone-engine.org/]
Bundled Software Bundled Software
================ ================
...@@ -64,13 +57,11 @@ Bundled Software ...@@ -64,13 +57,11 @@ Bundled Software
For convenience, the following libraries are bundled with binwalk and will not conflict with system-wide libraries: For convenience, the following libraries are bundled with binwalk and will not conflict with system-wide libraries:
libmagic libmagic
libfuzzy
pyqtgraph
Installation of any individual bundled library can be disabled at build time: Installation of any individual bundled library can be disabled at build time:
```bash ```bash
$ ./configure --disable-libmagic --disable-libfuzzy --disable-pyqtgraph $ ./configure --disable-libmagic
``` ```
Alternatively, installation of all bundled libraries can be disabled at build time: Alternatively, installation of all bundled libraries can be disabled at build time:
...@@ -79,7 +70,7 @@ Alternatively, installation of all bundled libraries can be disabled at build ti ...@@ -79,7 +70,7 @@ Alternatively, installation of all bundled libraries can be disabled at build ti
$ ./configure --disable-bundles $ ./configure --disable-bundles
``` ```
If a bundled library is disabled, the equivalent library must be installed to a standard system library location (e.g., `/usr/lib`, `/usr/local/lib`, etc) in order for binwalk to function properly. If a bundled library is disabled, the equivalent library must be installed to a standard system library location (e.g., `/usr/lib`, `/usr/local/lib`, etc) in order for binwalk to find it at run time.
**Note:** If the bundled libmagic library is not used, be aware that: **Note:** If the bundled libmagic library is not used, be aware that:
...@@ -116,7 +107,7 @@ $ make ida ...@@ -116,7 +107,7 @@ $ make ida
Uninstallation Uninstallation
============== ==============
The following command will remove binwalk from your system. Note that this will *not* remove manually installed packages, or utilities installed via deps.sh: The following command will remove binwalk from your system. Note that this will *not* remove manually installed packages or tools:
```bash ```bash
$ sudo make uninstall $ sudo make uninstall
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment