IPTEST(1)                                                            IPTEST(1)



NAME
       iptest - automatically generate a packets to test IP functionality

SYNOPSIS
       iptest  [ -1234567 ] [ -d <device> ] [ -g <gateway> ] [ -m <MTU> ] [ -p
       <pointtest> ] [ -s <source> ] <destination>

DESCRIPTION
       iptest ...

OPTIONS
       -1     Run IP test group #1.  This group  of  tests  generates  packets
              with  the  IP  header  fields  set to invalid values given other
              packet  characteristics.   The  point  tests  are:  1  (ip_hl  <
              ip_len),  2  (ip_hl  >  ip_len),  3  (ip_v < 4), 4 (ip_v > 4), 5
              (ip_len < packetsize, long packets), 6 (ip_len  >  packet  size,
              short packets), 7 (Zero length fragments), 8 (packet > 64k after
              reassembly), 9 (IP offset with MSB set), 10 (ttl variations).

       -2     Run IP test group #2.  This group  of  tests  generates  packets
              with  the IP options constructed with invalid values given other
              packet characteristics.  The point tests are: 1 (option length >
              packet length), 2 (option length = 0).

       -3     Run  IP  test  group  #3.  This group of tests generates packets
              with the ICMP header fields set  to  non-standard  values.   The
              point tests are: 1 (ICMP types 0-31 & 255), 2 (type 3 & code 0 -
              31), 3 (type 4 & code 0, 127, 128, 255), 4 (type  5  &  code  0,
              127,  128,  255), 5 (types 8-10,13-18 with codes 0, 127, 128 and
              255), 6 (type 12 & code 0, 127, 128, 129, 255) and 7 (type  3  &
              codes 9-10, 13-14 and 17-18 - shortened packets).

       -4     Run  IP  test  group  #4.  This group of tests generates packets
              with the UDP header fields  set  to  non-standard  values.   The
              point  tests  are: 1 (UDP length > packet size), 2 (UDP length <
              packetsize), 3 (sport = 0, 1, 32767, 32768, 65535), 4  (dport  =
              0,  1,  32767,  32768, 65535) and 5 (sizeof(struct ip) <= MTU <=
              sizeof(struct udphdr) + sizeof(struct ip)).

       -5     Run IP test group #5.  This group  of  tests  generates  packets
              with  the  TCP  header  fields  set to non-standard values.  The
              point tests are: 1 (TCP flags variations, all  combinations),  2
              (seq  =  0,  0x7fffffff,  0x8000000, 0xa0000000, 0xffffffff),  3
              (ack = 0, 0x7fffffff, 0x8000000, 0xa0000000, 0xffffffff), 4 (SYN
              packet with window of 0, 32768, 65535), 5 (set urgent pointer to
              1, 0x7fff, 0x8000, 0xffff), 6 (data offset), 7 (sport  =  0,  1,
              32767,  32768, 65535) and 8 (dport = 0, 1, 32767, 32768, 65535).

       -6     Run IP test group #6.  This test generates  a  large  number  of
              fragments  in an attempt to exhaust the network buffers used for
              holding packets for later reassembly.  WARNING: this  may  crash
              or cause serious performance degradation to the target host.

       -7     Run  IP test group #7.  This test generates 1024 random IP pack-
              ets with only the IP version, checksum,  length  and  IP  offset
              field correct.

       -d <interface>
              Set the interface name to be the name supplied.

       -g <gateway>
              Specify the hostname of the gateway through which to route pack-
              ets.  This is  required  whenever  the  destination  host  isn't
              directly  attached  to  the  same network as the host from which
              you're sending.

       -m <MTU>
              Specify the MTU to be  used  when  sending  out  packets.   This
              option  allows you to set a fake MTU, allowing the simulation of
              network interfaces with small MTU's without setting them so.

       -p <test>
              Run a...

SEE ALSO
       ipresend(1), ipsend(1), bpf(4), ipsend(5)

DIAGNOSTICS
       Only one of the numeric test options may be given when iptest is run.

       Needs to be run as root.

BUGS
       If you find any, please send email to me at darrenr@pobox.com



                                                                     IPTEST(1)
