hping3 README file antirez@invece.org DESCRIPTION hping3 is a network tool able to send custom TCP/IP packets and to display target replies like ping do with ICMP replies. hping3 can handle fragmentation, and almost arbitrary packet size and content, using the command line interface. Since version 3, hping implements scripting capabilties, read the API.txt file under the /docs directory to know more about it. As a command line utility, hping is useful to test at many kind of networking devices like firewalls, routers, and so. It can be used as a traceroute alike program over all the supported protocols, firewalk usage, OS fingerprinting, port-scanner (see the --scan option introduced with hping3), TCP/IP stack auditing. It's also really a good didactic tool to learn TCP/IP. Using Tcl/Tk scripting much more can be done, because while the hping3 packet generation code is actually the hping2 put there mainly for compatibility with the command line interface, all the real news are about scripting. See the libs directory for example scripts. To run the example scripts type: hping3 exec ScriptName.htcl <arguments, if required> hping3 is developed and manteined by antirez@invece.org with the help of other hackers, and comes under GPL version 2 of license. Development is open so you can send me patches/suggestions/affronts without inhibitions. Please check the AUTHORS file for a list of people that contribued with code, ideas, bug reports. Also vim developer, ee.lbl.gov for tcpdump and GNU in general. DOCUMENTATION For the hping3 API check docs/API.txt You can find documentation about hping3 specific functions at http://wiki.hping.org Make sure to check the page at http://wiki.hping.org/34 DOWNLOAD The hping3 primary download site is the following: http://www.hping.org ---------------------------------------------------------------- How to get the hping3 source code from the anonymous CVS server ---------------------------------------------------------------- $ cvs -d :pserver:anonymous@cvs.hping2.sourceforge.net:/cvsroot/hping2 login CVS will ask for the password, just press enter, no password is required than type the following to download the full source code. $ cvs -z8 -d :pserver:anonymous@cvs.hping2.sourceforge.net:/cvsroot/hping2 checkout hping3s ----------------------------------- How to update your source code tree ----------------------------------- change the current directory to /somewhere/hping2, than just type: $ cvs update REQUIREMENTS A supported unix-like OS, gcc, root access. Libpcap. Tcl/Tk is optional but strongly suggested. INSTALLATION see INSTALL file. have fun, antirez