| 1 |
Vers 1.11.4 - 28 August 95 |
| 2 |
|
| 3 |
ICMPINFO: |
| 4 |
|
| 5 |
icmpinfo is a tool for looking at the icmp messages received on |
| 6 |
the running host. |
| 7 |
|
| 8 |
The source code is written by Laurent Demailly, and comes from an |
| 9 |
heavily modified BSD ping source; it comes AS IS - no warranty, etc... |
| 10 |
see LICENSE <[email protected]> |
| 11 |
|
| 12 |
need to be chmod 4555 , chown root, or run as root [like ping] |
| 13 |
|
| 14 |
USAGE: |
| 15 |
|
| 16 |
icmpinfo o Gives info about weird packets only [mainly icmp_unreachable]. |
| 17 |
icmpinfo -v o Gives info about all icmp packets [that includes your own |
| 18 |
traceroutes...] except pings (icmp_echo_reply). |
| 19 |
icmpinfo -vv o To see pings too. |
| 20 |
icmpinfo -vvv o Will add an ascci/hexa dump of the packet. |
| 21 |
icmpinfo -n o Avoids name queries (faster, lighter). |
| 22 |
icmpinfo -p o Avoids port number to service name queries (faster, lighter). |
| 23 |
icmpinfo -s o Also decode the ip_src field which is the address of the |
| 24 |
interface receiving the packet. This option is not usefull |
| 25 |
for hosts with a single network interface. |
| 26 |
icmpinfo -l o Run like a daemon (forks) and output to SYSLOG. |
| 27 |
(It now checks that you are root for that) |
| 28 |
|
| 29 |
The output format is as follows (output can be shorter for some icmp |
| 30 |
messages (like for echo/echo_reply (pings)) and the field names intend |
| 31 |
to be fully meaningful for icmp unreachables packets mainly (default |
| 32 |
behaviour)) : |
| 33 |
|
| 34 |
MMM DD HH:MM:SS ICMP_type[sub-type] < sender_ip [sender_name] > unreach_ip |
| 35 |
[unreach_name] sp=source_port [src_port_name] dp=dest_port [dest_port_name] |
| 36 |
seq=sequence sz=packet_size |
| 37 |
|
| 38 |
or if you use -s option : |
| 39 |
|
| 40 |
MMM DD HH:MM:SS ICMP_type[sub-type] < sender_ip [sender_name] - my_ip |
| 41 |
[my_name] > unreach_ip [unreach_name] sp=source_port [src_port_name] |
| 42 |
dp=dest_port [dest_port_name] seq=sequence sz=packet_size |
| 43 |
|
| 44 |
(Real output will be on one line, it has been show cut here.) |
| 45 |
|
| 46 |
Sample bomb output : |
| 47 |
|
| 48 |
date&time ICMP_Dest_Unreachable[Port/Source/...] < bomber > bombed |
| 49 |
... service bombed ... |
| 50 |
|
| 51 |
Note that to be a bomb 'bomber' must not be one of the router between |
| 52 |
you and 'bombed' [in that case, it is just a normal net break,...] |
| 53 |
double check with traceroute,...etc... before complaining ! |
| 54 |
Also note that port number/service can be easily faked by bombing programs. |
| 55 |
|
| 56 |
I'll suggest that you leave icmpinfo running all time (with -l, or -lnp for |
| 57 |
minimal resource consumption (also see NOTE below)) and recording its |
| 58 |
output for further reference. |
| 59 |
It is a very light process using only few kbytes of memory and almost no cpu. |
| 60 |
|
| 61 |
It is free software, see the LICENSE file. [plus Berkeley (c) where applicable] |
| 62 |
|
| 63 |
The latest version should always be avaliable via anonymous ftp on |
| 64 |
hplyot.obspm.fr:/net/icmpinfo-*.tar.gz |
| 65 |
It is now mirrored on |
| 66 |
ftp.sunet.se:/pub/network/monitoring/icmpinfo/icmpinfo-*.tar.gz |
| 67 |
ftp.leo.org:/pub/comp/networking/net-tools/icmpinfo/icmpinfo-*.tar.gz |
| 68 |
and also (maybe less uptodate) on : |
| 69 |
ftp.funet.fi:/pub/unix/networking/icmpinfo-*.tar.gz |
| 70 |
|
| 71 |
If you have W3 access, have a look at |
| 72 |
http://hplyot.obspm.fr/~dl/icmpinfo.html |
| 73 |
|
| 74 |
INSTALLATION |
| 75 |
------------ |
| 76 |
o If you plan to use syslog(3) facility (-l) and don't want the |
| 77 |
default daemon.notice output, edit icmpinfo.c and change ligne 128. |
| 78 |
|
| 79 |
o Have a look at the makefile, make, and maybe look at defs.h if you have |
| 80 |
compile errors/includes missing (some linux boxes might need a symlink). |
| 81 |
|
| 82 |
o Copy icmpinfo to your favorite bin path, chown root icmpinfo, |
| 83 |
chmod 4555 icmpinfo. Copy icmpinfo.man to your MANPATH/man1/icmpinfo.1 |
| 84 |
|
| 85 |
IMPORTANT NOTE : *If* you machine is running a named (is a name |
| 86 |
server) you MUST USE -n when leaving icmpinfo unattended, to avoid |
| 87 |
some possible looping, when icmpinfo tries to resolve an ip in an |
| 88 |
unreachable domain. [this problem of domain generated icmps has been |
| 89 |
worked upon... but I found no satisfary solutions, suggestions welcome, |
| 90 |
maybe a solution for v1.12 !] |
| 91 |
|
| 92 |
If you have any problems and/or suggestion, drop me a mail... |
| 93 |
|
| 94 |
Enjoy ! |
| 95 |
|
| 96 |
dl - <[email protected]> |
| 97 |
<A HREF="http://hplyot.obspm.fr/~dl/">Laurent Demailly</A> - finger for PGP key |
| 98 |
|
| 99 |
Credits - Thanx to Vesa for help in debugging buggy bsd code! |
| 100 |
To Dave for providing the original man page! |
| 101 |
And to ScottM for making my english readable! |
| 102 |
|
| 103 |
Note 1 - icmpinfo distribution now includes PGP signed md5 CHECKSUMS |
| 104 |
Note 2 - read the file CHANGES to get information about new features. |