NAME

       ipgrab - A Verbose Packet Sniffer

SYNOPSIS

       ipgrab [ -ablmnPprTtwx ] [ -c cnt ] [ -i if ] [ expr ]

DESCRIPTION

       ipgrab reads and parses packets from the link layer through the application layer, dumping
       explicit header information along the way.  It is a lot like tcpdump except that it prints
       almost every header field.

   Options
       -a     Do not display application layer data.

       -b     Buffer standard output. Useful when you're redirecting output to a file.

       -c cnt, --count cnt
              Terminate after receiving cnt packets.

       -C proto, --CCP proto
              Assume  a  particular CCP protocol, such as MPPC. MPPC is the only one supported as
              yet.

       -d     Dump extra padding in packets. For example, according to an IP header,  the  packet
              ends  at  a  certain point, but the link layer may have padded it beyond that. This
              option displays the padding. Not valid in minimal mode.

       -h, --help
              Display usage screen with a brief description of the command line options.

       -i if, --interface if
              Makes ipgrab listen to packets on interface if, e.g., eth0. If this option  is  not
              used, the default interface will be assumed.

       -l     Don't display link-layer headers. The following protocols are considered to be link
              layer: ARP, CHAP, Ethernet, IPCP, LCP, LLC, Loopback, PPP, PPPoE, Raw, Slip.

       -m     Minimal mode output. When operating in this mode, ipgrab displays only brief header
              information.

       -n     Don't  display  network-layer headers. The following protocols are considered to be
              network layer: AH, ESP, GRE, ICMP, ICMPv6, IGMP, IP, IPv6, IPX, IPXRIP.

       -P string
              Initiate a dynamic port mapping. This option must be followed by a  string  of  the
              form `<protocol>=<port>', such as `http=8080'.

       -p     Dump  packet payloads beyond what IPgrab parses. In other words, if IPgrab does not
              parse a particular application, this option will dump application data in  hex  and
              text format.

       -r FILE
              Read  packets  from a file, rather than an interface. The file shoule be created in
              "raw" format, such as with '-w' option.

       -T     Do not display timestamps in minimal mode.

       -t     Don't display transport layer headers. The following protocols are considered to be
              transport layer: SPX, TCP, UDP.

       -v, --version
              Display version number and then quit.

       -w FILE
              Write  the  raw  packets to a file, rather than the screen. The packets will not be
              parsed. The file can be read with the '-r' option.

       -x     Hex dump mode. After processing each layer, dump out the contents of that layer  in
              hex and text. Only valid in main mode.

       expr   Berkeley  packet  filter  expression.   See  tcpdump(8)  man  page  for details and
              examples.

SEE ALSO

       tcpdump(8)

NOTES

       Requires libpcap version 0.3 or greater to be installed.

AUTHOR

       Michael S. Borella
       http://www.borella.net/mike/
       mike@borella.net

                                          07 March 2007                                 IPGRAB(8)