contrib/ipfilter/ipsend/ipresend.1

   1 .\"     $FreeBSD$
   2 .\"
   3 .TH IPRESEND 1
   4 .SH NAME
   5 ipresend \- resend IP packets out to network
   6 .SH SYNOPSIS
   7 .B ipresend
   8 [
   9 .B \-EHPRSTX
  10 ] [
  11 .B \-d
  12 <device>
  13 ] [
  14 .B \-g
  15 <\fIgateway\fP>
  16 ] [
  17 .B \-m
  18 <\fIMTU\fP>
  19 ] [
  20 .B \-r
  21 <\fIfilename\fP>
  22 ]
  23 .SH DESCRIPTION
  24 .PP
  25 \fBipresend\fP was designed to allow packets to be resent, once captured,
  26 back out onto the network for use in testing.  \fIipresend\fP supports a
  27 number of different file formats as input, including saved snoop/tcpdump
  28 binary data.
  29 .SH OPTIONS
  30 .TP
  31 .BR \-d \0<interface>
  32 Set the interface name to be the name supplied.  This is useful with the
  33 \fB\-P, \-S, \-T\fP and \fB\-E\fP options, where it is not otherwise possible
  34 to associate a packet with an interface.  Normal "text packets" can override
  35 this setting.
  36 .TP
  37 .BR \-g \0<gateway>
  38 Specify the hostname of the gateway through which to route packets.  This
  39 is required whenever the destination host isn't directly attached to the
  40 same network as the host from which you're sending.
  41 .TP
  42 .BR \-m \0<MTU>
  43 Specify the MTU to be used when sending out packets.  This option allows you
  44 to set a fake MTU, allowing the simulation of network interfaces with small
  45 MTU's without setting them so.
  46 .TP
  47 .BR \-r \0<filename>
  48 Specify the filename from which to take input.  Default is stdin.
  49 .TP
  50 .B \-E
  51 The input file is to be text output from etherfind.  The text formats which
  52 are currently supported are those which result from the following etherfind
  53 option combinations:
  54 .PP
  55 .nf
  56                 etherfind -n
  57                 etherfind -n -t
  58 .fi
  59 .LP
  60 .TP
  61 .B \-H
  62 The input file is to be hex digits, representing the binary makeup of the
  63 packet.  No length correction is made, if an incorrect length is put in
  64 the IP header.
  65 .TP
  66 .B \-P
  67 The input file specified by \fB\-i\fP is a binary file produced using libpcap
  68 (i.e., tcpdump version 3).  Packets are read from this file as being input
  69 (for rule purposes).
  70 .TP
  71 .B \-R
  72 When sending packets out, send them out "raw" (the way they came in).  The
  73 only real significance here is that it will expect the link layer (i.e.
  74 ethernet) headers to be prepended to the IP packet being output.
  75 .TP
  76 .B \-S
  77 The input file is to be in "snoop" format (see RFC 1761).  Packets are read
  78 from this file and used as input from any interface.  This is perhaps the
  79 most useful input type, currently.
  80 .TP
  81 .B \-T
  82 The input file is to be text output from tcpdump.  The text formats which
  83 are currently supported are those which result from the following tcpdump
  84 option combinations:
  85 .PP
  86 .nf
  87                 tcpdump -n
  88                 tcpdump -nq
  89                 tcpdump -nqt
  90                 tcpdump -nqtt
  91                 tcpdump -nqte
  92 .fi
  93 .LP
  94 .TP
  95 .B \-X
  96 The input file is composed of text descriptions of IP packets.
  97 .DT
  98 .SH SEE ALSO
  99 snoop(1m), tcpdump(8), etherfind(8c), ipftest(1), ipresend(1), iptest(1), bpf(4), dlpi(7p)
 100 .SH DIAGNOSTICS
 101 .PP
 102 Needs to be run as root.
 103 .SH BUGS
 104 .PP
 105 Not all of the input formats are sufficiently capable of introducing a
 106 wide enough variety of packets for them to be all useful in testing.
 107 If you find any, please send email to me at darrenr@pobox.com
 108