== How to install on Ubuntu

=== Install pre-requisites

==== Required stuff

    sudo apt-get install build-essential libssl-dev git

==== Recommended (extra formats and performance)

    sudo apt-get install yasm libgmp-dev libpcap-dev pkg-config

==== If you have an NVIDIA GPU (CUDA and OpenCL support)

    sudo apt-get install nvidia-cuda-toolkit nvidia-opencl-dev

==== If you have an AMD GPU (or want to use CPU as OpenCL device)

    sudo apt-get install fglrx-updates-dev

==== Optional MPI support

    sudo apt-get install libopenmpi-dev openmpi-bin

==== Optional REXGEN support (additional cracking modes)

    sudo apt-get install cmake bison flex
    mkdir ~/src && cd ~/src
    git clone --recursive https://github.com/teeshop/rexgen.git
    cd rexgen/src
    ./install.sh

=== Clone latest bleeding-edge Jumbo and build

==== Clone GIT repo

    cd ~/src
    git clone git://github.com/magnumripper/JohnTheRipper -b bleeding-jumbo john

==== Build

    cd ~/src/john/src
    # For MPI, use './configure --enable-mpi' below
    ./configure && make -s clean && make -sj4

=== Test your build

    $ ../run/john --test=0

=== Benchmark your build

    $ ../run/john --test
