contrib/ipfilter/ipsend/ipsend.1

   1 .\"     $FreeBSD$
   2 .\"
   3 .TH IPSEND 1
   4 .SH NAME
   5 ipsend \- sends IP packets
   6 .SH SYNOPSIS
   7 .B ipsend
   8 [
   9 .B \-dITUv
  10 ] [
  11 .B \-i
  12 <interface>
  13 ] [
  14 .B \-f
  15 <\fIoffset\fP>
  16 ] [
  17 .B \-g
  18 <\fIgateway\fP>
  19 ] [
  20 .B \-m
  21 <\fIMTU\fP>
  22 ] [
  23 .B \-o
  24 <\fIoption\fP>
  25 ] [
  26 .B \-P
  27 <protocol>
  28 ] [
  29 .B \-s
  30 <\fIsource\fP>
  31 ] [
  32 .B \-t
  33 <\fIdest. port\fP>
  34 ] [
  35 .B \-w
  36 <\fIwindow\fP>
  37 ] <destination> [TCP-flags]
  38 .SH DESCRIPTION
  39 .PP
  40 \fBipsend\fP can be compiled in two ways.  The first is used to send one-off
  41 packets to a destination host, using command line options to specify various
  42 attributes present in the headers.  The \fIdestination\fP must be given as
  43 the last command line option, except for when TCP flags are specified as
  44 a combination of A, S, F, U, P and R, last.
  45 .PP
  46 The other way it may be compiled, with DOSOCKET defined, is to allow an
  47 attempt at making a TCP connection using a with ipsend resending the SYN
  48 packet as per the command line options.
  49 .SH OPTIONS
  50 .TP
  51 .BR \-d
  52 enable debugging mode.
  53 .TP
  54 .BR \-f \0<offset>
  55 The \fI-f\fP allows the IP offset field in the IP header to be set to an
  56 arbitrary value, which can be specified in decimal or hexadecimal.
  57 .TP
  58 .BR \-g \0<gateway>
  59 Specify the hostname of the gateway through which to route packets.  This
  60 is required whenever the destination host isn't directly attached to the
  61 same network as the host from which you're sending.
  62 .TP
  63 .BR \-i \0<interface>
  64 Set the interface name to be the name supplied.
  65 .TP
  66 .TP
  67 .BR \-m \0<MTU>
  68 Specify the MTU to be used when sending out packets.  This option allows you
  69 to set a fake MTU, allowing the simulation of network interfaces with small
  70 MTU's without setting them so.
  71 .TP
  72 .BR \-o \0<option>
  73 Specify options to be included at the end of the IP header.  An EOL option
  74 is automatically appended and need not be given.  If an option would also
  75 have data associated with it (source as an IP# for a lsrr option), then
  76 this will not be initialised.
  77 .TP
  78 .BR \-s \0<source>
  79 Set the source address in the packet to that provided - maybe either a
  80 hostname or IP#.
  81 .TP
  82 .BR \-t \0<dest. port>
  83 Set the destination port for TCP/UDP packets.
  84 .TP
  85 .BR \-w \0<window>
  86 Set the window size for TCP packets.
  87 .TP
  88 .B \-I
  89 Set the protocol to ICMP.
  90 .TP
  91 .B \-P <protocol>
  92 Set the protocol to the value given.  If the parameter is a name, the name
  93 is looked up in the \fI/etc/protocols\fP file.
  94 .TP
  95 .B \-T
  96 Set the protocol to TCP.
  97 .TP
  98 .B \-U
  99 Set the protocol to UDP.
 100 .TP
 101 .BR \-v
 102 enable verbose mode.
 103 .DT
 104 .SH SEE ALSO
 105 ipsend(1), ipresend(1), iptest(1), protocols(4), bpf(4), dlpi(7p)
 106 .SH DIAGNOSTICS
 107 .PP
 108 Needs to be run as root.
 109 .SH BUGS
 110 .PP
 111 If you find any, please send email to me at darrenr@pobox.com