hping3 README file
[email protected]
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 [email protected]
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:[email protected]:/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:[email protected]:/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
