metasploit-payloads/gem/README.md

Metasploit Payloads

This gem is a Metasploit-specific gem that contains all of the Meterpreter payloads. This is made up of:

• Windows DLLs
• POSIX LSOs
• POSIX BIN
• Java Classes
• PHP/Python Scripts

Installation

Given the nature of the contents of this gem, installation outside of Metasploit is not advised. To use Meterpreter, download and install Metasploit itself.

Building

To build the gem:

1. Update the version number in lib/metasploit-payloads/version.rb
2. Run:

• rake win_prep to build on Windows
• rake posix_prep to build on Linux
• rake java_prep to build Java files
• rake python_prep and rake php_prep to copy the latest PHP/Python meterpreter files into place

1. Binaries will be built in the data folder.
2. Run rake build to generate the new gem file using content in meterpreter folder.
3. Run rake release to release the binary to RubyGems.

Note, when using the command rake win_prep and related Windows rake tasks, you must be in the Visual Studio Developer command prompt, and have a path to a git binary in your default path. If your git.exe is part of posh-git or GitHub for Windows, that means adding something like the following to your path:

"C:\Users\USERNAME\AppData\Local\GitHub\PortableGit_LONG_UUID_STRING_THING\bin"