Fixed bug in bridge_and_sniff

Sniff() optionally accepts an interface or a list of interfaces

Added "direction" attribute to pkt when received by L2ListenSocket

Patch PEP08'ified

Do not force to print interface

Updated usage.rst with multi-interfaces sniffing

Fixed missing pic in usage.rst

tethereal -> tshark
3 files changed
tree: 61a2f05566a18e658eeafcb50a502ebca8836a2e
  1. bin/
  2. doc/
  3. scapy/
  4. test/
  5. .gitignore
  6. .hgsigs
  7. .hgtags
  8. .travis.yml
  9. CONTRIBUTING.md
  10. LICENSE
  11. MANIFEST.in
  12. README.md
  13. run_scapy
  14. run_scapy.bat
  15. setup.cfg
  16. setup.py
README.md

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 and the quick demo: an interactive session (some examples may be outdated).

Contributing

Want to contribute? Great! Please take a few minutes to read this!

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. If not, see the gnu.org web site.