Skip to content
This repository has been archived by the owner on May 15, 2024. It is now read-only.

Update Linux INSTALL file #11

Merged
merged 2 commits into from
Nov 18, 2016
Merged

Update Linux INSTALL file #11

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7a48676
Add missing valgrind dependency to main list, and add new instruction…
gwasser Nov 17, 2016
20352fc
In BFF 2.8, file is named zzuf-master.zip not zzuf-patched.zip
gwasser Nov 18, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
105 changes: 72 additions & 33 deletions src/linux/INSTALL
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,27 +6,28 @@ dependencies are met.
===== Dependencies =====

For basic fuzzing functionality, the following packages are required:
Python 2.7
Python Numpy
Python Scipy
Python Yaml
gdb (7.2 or later on Linux is required for exploitability information)
zzuf (patched by CERT)
* Python 2.7 (Python 3.x not currently supported, in progress)
* Python Numpy
* Python Scipy
* Python Yaml
* gdb (7.2 or later on Linux is required for exploitability information)
* zzuf (bundled version patched by CERT preferred)

In order to build zzuf and the other BFF dependencies, the following
packages may be required:
svn
gcc
make
automake
libtool
gcc-c++
ncurses-devel
* svn
* gcc
* make
* automake
* libtool
* gcc-c++
* ncurses-devel

For additional analysis tools that can be used during or after a
fuzzing campaign, the following packages are required:
Python hcluster
Python matplotlib
* valgrind
* Python hcluster
* Python matplotlib


===== Filesystem layout =====
Expand Down Expand Up @@ -75,8 +76,46 @@ changes:

- strip is symlinked to /bin/true, which prevents symbols from being
removed when an application is built.




===== Example installation on openSUSE Leap 42.2 64-bit =====

To install BFF on an openSUSE Leap 42.2 64-bit system, for example, the following steps
can be performed:

1) Install dependencies present in the package system:
sudo zypper ar -f 'http://download.opensuse.org/repositories/devel:/languages:/python/openSUSE_Leap_42.2/' python
sudo zypper install python-numpy python-scipy python-PyYAML valgrind subversion automake libtool gcc-c++ ncurses-devel make

2) Install the zzuf version patched by CERT:
unzip zzuf-master.zip
cd zzuf-master
./bootstrap
./configure
make
sudo make install

3) Install old ImageMagick version as default fuzz target:
sudo zypper install xorg-x11-devel
sudo ln -sf /usr/include/asm/byteorder.h /usr/include/sys/byteorder.h
wget http://downloads.sourceforge.net/project/imagemagick/old-sources/5.x/5.3/ImageMagick-5.3.0.tar.gz
tar xzvf ImageMagick-5.3.0.tar.gz
cd ImageMagick-5.3.0
./configure
make
sudo make install

4) Unzip BFF scripts:
mkdir ~/bff
unzip BFF-2.8.zip -d ~/bff

5) Configure symlink
ln -s /usr/local/bin/convert ~/convert

6) Start fuzzing
~/bff/batch.sh


===== Example installation on Fedora 16 32-bit =====

To install BFF on a Fedora 16 32-bit system, for example, the following steps
Expand All @@ -87,8 +126,8 @@ yum install numpy scipy python-yaml valgrind svn automake libtool gcc-c++ ncurse

2) Install the zzuf version patched by CERT:
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
unzip zzuf-patched.zip
cd zzuf-patched
unzip zzuf-master.zip
cd zzuf-master
./bootstrap
./configure
make
Expand Down Expand Up @@ -133,8 +172,8 @@ sudo yum install fluxbox
(Cick the following options and ensure they are not selected to disable them:)
(Auto Raise)
(Focus New Windows)



===== Example installation on Ubuntu 11.10 32-bit =====

Expand All @@ -145,8 +184,8 @@ can be performed:
sudo apt-get install python-numpy python-scipy python-yaml valgrind subversion automake libtool build-essential libncurses5-dev

2) Install the zzuf version patched by CERT:
unzip zzuf-patched.zip
cd zzuf-patched
unzip zzuf-master.zip
cd zzuf-master
./bootstrap
./configure
make
Expand Down Expand Up @@ -189,10 +228,10 @@ sudo apt-get install fluxbox
(Cick the following options and ensure they are not selected to disable them:)
(Focus New Windows)
(Auto Raise)




===== Example installation on openSUSE 12 32-bit =====

To install BFF on an openSUSE 12 32-bit system, for example, the following steps
Expand All @@ -203,8 +242,8 @@ sudo zypper ar -f 'http://download.opensuse.org/repositories/devel:/languages:/p
sudo zypper install python-numpy python-scipy valgrind subversion automake libtool gcc-c++ ncurses-devel make

2) Install the zzuf version patched by CERT:
unzip zzuf-patched.zip
cd zzuf-patched
unzip zzuf-master.zip
cd zzuf-master
./bootstrap
./configure
make
Expand All @@ -230,7 +269,7 @@ ln -s /usr/local/bin/convert ~/convert
6) Start fuzzing
~/bff/batch.sh

-- System Performance Configurations for Fedora --
-- System Performance Configurations for openSUSE --
a) Disable Memory Randomization:
add "kernel.randomize_va_space=0" to /etc/sysctl.conf
(reboot after this change)
Expand All @@ -250,8 +289,8 @@ sudo zypper install fluxbox
(Cick the following options and ensure they are not selected to disable them:)
(Focus New Windows)
(Auto Raise)


===== Installation on other platforms =====

BFF should run on any UNIX-like operating system. Depending on the features
Expand All @@ -267,4 +306,4 @@ Python Yaml
gdb (7.2 or later on Linux is required for exploitability information)
zzuf (patched by CERT)

Patches may be required to get zzuf compiled on non-Linux systems.
Patches may be required to get zzuf compiled on non-Linux systems.