Add README / prepare for Github migration

This commit is contained in:
Pierre LALET 2016-01-12 11:36:39 +01:00
parent 669a62cfb0
commit 064203bba7
3 changed files with 51 additions and 0 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
*.pyc

12
.travis.yml Normal file
View File

@ -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

38
README.md Normal file
View File

@ -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/).