IPTEST(1)						      General Commands Manual							 IPTEST(1)

NAME

       iptest - automatically generate 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 packets 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 packets.  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)