diff --git a/.gitignore b/.gitignore new file mode 100644 index 000000000..0d20b6487 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +*.pyc diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 000000000..622760aac --- /dev/null +++ b/.travis.yml @@ -0,0 +1,12 @@ +sudo: false + +language: python + +python: + - 2.6 + - 2.7 + +install: + - pip install pycrypto + +script: cd test/ && ./run_tests -F -t regression.uts -K netaccess -K automaton diff --git a/README.md b/README.md new file mode 100644 index 000000000..ac6ec8596 --- /dev/null +++ b/README.md @@ -0,0 +1,38 @@ +# Scapy # + +Scapy is a powerful Python-based interactive packet manipulation +program and library. + +It is able to forge or decode packets of a wide number of protocols, +send them on the wire, capture them, match requests and replies, and +much more. + +It can easily handle most classical tasks like scanning, tracerouting, +probing, unit tests, attacks or network discovery (it can replace +hping, 85% of nmap, arpspoof, arp-sk, arping, tcpdump, tethereal, p0f, +etc.). It also performs very well at a lot of other specific tasks +that most other tools can't handle, like sending invalid frames, +injecting your own 802.11 frames, combining technics (VLAN hopping+ARP +cache poisoning, VOIP decoding on WEP encrypted channel, ...), +etc. + +See +[interactive tutorial](http://www.secdev.org/projects/scapy/doc/usage.html#interactive-tutorial) +and +[the quick demo: an interactive session](http://www.secdev.org/projects/scapy/demo.html) +(some examples may be outdated). + +# License # + +Scapy is free software: you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free +Software Foundation, version 2. + +Scapy is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +for more details. + +You should have received a copy of the GNU General Public License +[along with Scapy](LICENSE). If not, see +[the gnu.org web site](http://www.gnu.org/licenses/).