fde119e889
Some users are having trouble installing pcap. Others want postgres to remain optional. The move to requiring bundler in a git environment has made this hard. This commit provides a path for these users. By default, bundler will install all gems, including postgres and pcaprub. If it fails to install some, Metasploit will not function. But there is hope. Users can explicitly exclude the gem groups they don't want. For example: bundle install --without db pcap will exclude the pcap and postgres gems (and their depedencies). bundle install --without db pcap development test will exclude all non-essential gems. The good news is that the user only needs to use the `--without` option once. Bundler will remember it. So future runs can still do `bundle install` (or simply `bundle`) and the gems will still be excluded. And if the user changes their mind and wants the optional gems, they can remove their stored *without* preference using: bundle config --delete without [FIXRM #7891] |
||
---|---|---|
config | ||
data | ||
db | ||
documentation | ||
external | ||
lib | ||
modules | ||
plugins | ||
scripts | ||
spec | ||
test | ||
tools | ||
.gitignore | ||
.mailmap | ||
.rspec | ||
.simplecov | ||
.travis.yml | ||
.yardopts | ||
CONTRIBUTING.md | ||
COPYING | ||
Gemfile | ||
Gemfile.lock | ||
HACKING | ||
LICENSE | ||
README.md | ||
Rakefile | ||
armitage | ||
msfbinscan | ||
msfcli | ||
msfconsole | ||
msfd | ||
msfelfscan | ||
msfencode | ||
msfgui | ||
msfmachscan | ||
msfpayload | ||
msfpescan | ||
msfrop | ||
msfrpc | ||
msfrpcd | ||
msfupdate | ||
msfvenom |
README.md
Metasploit
The Metasploit Framework is released under a BSD-style license. See COPYING for more details.
The latest version of this software is available from http://metasploit.com/
Bug tracking and development information can be found at: https://dev.metasploit.com/redmine/projects/framework/
The public GitHub source repository can be found at: https://github.com/rapid7/metasploit-framework
Questions and suggestions can be sent to: msfdev(at)metasploit.com
The framework mailing list is the place to discuss features and ask for help. To subscribe, visit the following web page: https://mail.metasploit.com/mailman/listinfo/framework
The mailing list archives are available from: https://mail.metasploit.com/pipermail/framework/
Installing
Generally, you should use the installer which contains all dependencies and will get you up and running with a few clicks. See the Dev Environment Setup if you'd like to deal with dependencies on your own.
Using Metasploit
Metasploit can do all sorts of things. The first thing you'll want to do
is start msfconsole
, but after that, you'll probably be best served by
reading some of the great tutorials online:
Contributing
See the Dev Environment Setup guide on GitHub which will walk you through the whole process starting from installing all the dependencies, to cloning the repository, and finally to submitting a pull request. For slightly more info, see Contributing.