angr / rex

Shellphish's automated exploitation engine, originally created for the Cyber Grand Challenge.
BSD 2-Clause "Simplified" License
634 stars 102 forks source link

Installation Guide #5

Closed Manouchehri closed 6 years ago

Manouchehri commented 8 years ago

Getting rex set up is still somewhat rough, should we add an install guide here or stick with https://github.com/mechaphish/mecha-docs? Either way, it should be linked to in the REAME.md.

(re: email from @Owlz)

Hey David,

Not a VM specifically for it. I do recall having many-a-issue on it. Two things, the first is the correct (or at least required at the time) order of installing packages to get it to install:

https://github.com/shellphish/shellphish-qemu.git

https://github.com/mechaphish/povsim.git

https://github.com/salls/angrop.git

https://github.com/mechaphish/compilerex.git

https://github.com/shellphish/rex.git

https://github.com/angr/tracer

https://github.com/shellphish/shellphish-afl.git

The second, I have a bash script that will install/compile all of Mechaphish reliably. This would probably be overkill for what you're asking, but you can likely remove unwanted components from the install line and it should still give you a working rex copy. It basically boils down to these two lines (with some bash in-between):

sudo apt-get update sudo apt-get install -y virtualenvwrapper python2.7-dev build-essential sudo libxml2-dev libxslt1-dev git libffi-dev cmake libreadline-dev libtool debootstrap debian-archive-keyring libglib2.0-dev libpixman-1-dev libpq-dev python-dev libc6:i386 libncurses5:i386 libstdc++6:i386 zlib1g:i386 pkg-config zlib1g-dev libtool libtool-bin wget automake autoconf coreutils bison libacl1-dev qemu-user qemu-kvm socat postgresql-client nasm binutils-multiarch llvm clang

git clone https://github.com/angr/angr-dev.git $MechaPhishDIR

cd $MechaPhishDIR

./setup.sh -p mechaphish -r https://github.com/shellphish -r https://github.com/mechaphish -r https://github.com/salls -D \ ana idalink cooldict mulpyplexer monkeyhex superstruct \ shellphish-afl shellphish-qemu capstone unicorn peewee \ archinfo vex pyvex cle claripy simuvex angr angr-management angr-doc \ binaries identifier fidget angrop tracer fuzzer driller \ compilerex povsim rex farnsworth patcherex colorguard \ common-utils network_poll_creator patch_performance \ worker meister ambassador scriba virtual-competition manual-interaction

bannsec commented 7 years ago

I've had to update that setup.sh line to remove unicorn given recent changes. unicorn can be pip installed now.

XMGH-z commented 6 years ago

Thank you !