mdoc'd pages <kwesterback@home.com>

2 files changed, 262 insertions, 181 deletions

diff --git a/usr.sbin/ipsend/ipresend/ipresend.1 b/usr.sbin/ipsend/ipresend/ipresend.1
index 8ffd6416bb9..04259a5c248 100644
--- a/usr.sbin/ipsend/ipresend/ipresend.1
+++ b/usr.sbin/ipsend/ipresend/ipresend.1
@@ -1,106 +1,112 @@
-.TH IPRESEND 1
-.SH NAME
-ipresend \- resend IP packets out to network
-.SH SYNOPSIS
-.B ipsend
-[
-.B \-EHPRSTX
-] [
-.B \-d
-<device>
-] [
-.B \-g
-<\fIgateway\fP>
-] [
-.B \-m
-<\fIMTU\fP>
-] [
-.B \-r
-<\fIfilename\fP>
-]
-.SH DESCRIPTION
-.PP
-\fBipresend\fP was designed to allow packets to be resent, once captured,
-back out onto the network for use in testing.  \fIipresend\fP supports a
-number of different file formats as input, including saved snoop/tcpdump
+.Dd October  9, 1999
+.Dt IPRESEND 1
+.Os
+.Sh NAME
+.Nm ipresend
+.Nd resend IP packets out to network
+.Sh SYNOPSIS
+.Nm ipsend
+.Op Fl EHPRSTX
+.Op Fl d Ar device
+.Op Fl g Ar gateway
+.Op Fl m Ar mtu
+.Op Fl r Ar filename
+.Sh DESCRIPTION
+.Nm
+was designed to allow captured packets to be resent
+onto the network for use in testing.
+.Nm
+supports a
+number of different file formats as input, including saved snoop and
+.Xr tcpdump 8
 binary data.
-.SH OPTIONS
-.TP
-.BR \-d \0<interface>
+.Pp
+.Nm
+must be run as root.
+.Ss OPTIONS
+.Bl -tag -width "d interface "
+.It Fl d Ar interface
 Set the interface name to be the name supplied.  This is useful with the
-\fB\-P, \-S, \-T\fP and \fB\-E\fP options, where it is not otherwise possible
-to associate a packet with an interface.  Normal "text packets" can override
-this setting.
-.TP
-.BR \-g \0<gateway>
-Specify the hostname of the gateway through which to route packets.  This
+.Fl P ,
+.Fl S ,
+.Fl T
+and
+.Fl E
+options, where it is not otherwise possible
+to associate a packet with an interface.  Normal
+.Sq text packets
+can override this setting.
+.It Fl g Ar 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.
-.TP
-.BR \-m \0<MTU>
-Specify the MTU to be used when sending out packets.  This option allows you
+.It Fl m Ar mtu
+Set the MTU used when sending out packets to
+.Ar mtu .
+This option allows you
 to set a fake MTU, allowing the simulation of network interfaces with small
-MTU's without setting them so.
-.TP
-.BR \-r \0<filename>
-Specify the filename from which to take input.  Default is stdin.
-.TP
-.B \-E
-The input file is to be text output from etherfind.  The text formats which
+MTU's.
+.It Fl r Ar filename
+Specify the filename from which to take input. Default is
+.Va stdin .
+.It Fl E
+The input file is to be text output from etherfind. The text formats which
 are currently supported are those which result from the following etherfind
 option combinations:
-.PP
-.nf
-		etherfind -n
-		etherfind -n -t
-.fi
-.LP
-.TP
-.B \-H
+.Bd -literal -offset indent
+etherfind -n
+etherfind -n -t
+.Ed
+.It Fl H
 The input file is to be hex digits, representing the binary makeup of the
-packet.  No length correction is made, if an incorrect length is put in
+packet. No length correction is made if an incorrect length is put in
 the IP header.
-.TP
-.B \-P
-The input file specified by \fB\-i\fP is a binary file produced using libpcap
-(i.e., tcpdump version 3).  Packets are read from this file as being input
+.It Fl P
+The input file specified by
+.Fl r
+is a binary file produced using libpcap
+(i.e.,
+.Xr tcpdump 8
+version 3). Packets are read from this file as being input
 (for rule purposes).
-.TP
-.B \-R
-When sending packets out, send them out "raw" (the way they came in).  The
+.It Fl R
+When sending packets out, send them out
+.Sq  raw
+(the way they came in). The
 only real significance here is that it will expect the link layer (i.e.
 Ethernet) headers to be prepended to the IP packet being output.
-.TP
-.B \-S
-The input file is to be in "snoop" format (see RFC 1761).  Packets are read
-from this file and used as input from any interface.  This is perhaps the
+.It Fl S
+The input file is to be in
+.Sq snoop
+format (see
+.Tn RFC 1761 ) .
+Packets are read
+from this file and used as input from any interface. This is perhaps the
 most useful input type, currently.
-.TP
-.B \-T
-The input file is to be text output from tcpdump.  The text formats which
-are currently supported are those which result from the following tcpdump
+.It Fl T
+The input file is to be text output from
+.Xr tcpdump 8 .
+The text formats which
+are currently supported are those which result from the following
+.Xr tcpdump 8
 option combinations:
-.PP
-.nf
-		tcpdump -n
-		tcpdump -nq
-		tcpdump -nqt
-		tcpdump -nqtt
-		tcpdump -nqte
-.fi
-.LP
-.TP
-.B \-X
+.Bd -literal -offset indent
+tcpdump -n
+tcpdump -nq
+tcpdump -nqt
+tcpdump -nqtt
+tcpdump -nqte
+.Ed
+.It Fl X
 The input file is composed of text descriptions of IP packets.
-.DT
-.SH SEE ALSO
-tcpdump(8), ipftest(1), ipresend(1), iptest(1), bpf(4)
-.SH DIAGNOSTICS
-.PP
-Needs to be run as root.
-.SH BUGS
-.PP
+.El
+.Sh SEE ALSO
+.Xr ipftest 1 ,
+.Xr ipresend 1 ,
+.Xr iptest 1 ,
+.Xr bpf 4 ,
+.Xr tcpdump 8
+.Sh BUGS
 Not all of the input formats are sufficiently capable of introducing a
 wide enough variety of packets for them to be all useful in testing.
 If you find any, please send email to me at darrenr@cyber.com.au
-
diff --git a/usr.sbin/ipsend/iptest/iptest.1 b/usr.sbin/ipsend/iptest/iptest.1
index 4f51052f0e3..c705bb5f620 100644
--- a/usr.sbin/ipsend/iptest/iptest.1
+++ b/usr.sbin/ipsend/iptest/iptest.1
@@ -1,102 +1,177 @@
-.\"     $OpenBSD: iptest.1,v 1.3 1999/10/07 06:35:50 ericj Exp $
-.TH IPTEST 1
-.SH NAME
-iptest \- automatically generate a packets to test IP functionality
-.SH SYNOPSIS
-.B iptest
-[
-.B \-1234567
-] [
-.B \-d
-<device>
-] [
-.B \-g
-<gateway>
-] [
-.B \-m
-<\fIMTU\fP>
-] [
-.B \-p
-<\fIpointtest\fP>
-] [
-.B \-s
-<\fIsource\fP>
-] <destination>
-.SH DESCRIPTION
-.PP
-\fBiptest\fP ...
-.SH OPTIONS
-.TP
-.B \-1
-Run IP test group #1.  This group of tests generates packets with the IP
+.\"     $OpenBSD: iptest.1,v 1.4 1999/10/10 17:50:03 ericj Exp $
+.Dd October  8, 1999
+.Dt IPTEST 1
+.Os
+.Sh NAME
+.Nm iptest
+.Nd automatically generate packets to test IP functionality
+.Sh SYNOPSIS
+.Nm iptest
+.Op Fl 1234567
+.Op Fl d Ar device
+.Op Fl g Ar gateway
+.Op Fl m Ar mtu
+.Op Fl p Ar pointtest
+.Op Fl s Ar src
+.Ar destination
+.Sh DESCRIPTION
+.Nm
+generates a series of IP packets to
+.Ar destination
+via
+.Ar gateway
+using the interface
+.Ar device .
+The packets generated test various aspects of IP functionality.
+.Pp
+By default all tests are done, using the interface
+.Sq lan0 .
+This interface does not normally exist on
+.Ox
+so an existing interface must be specified with the
+.Fl d
+option.
+To limit the tests to a single group or to a single test within a group the 
+.Fl 1234567
+and 
+.Fl p
+options are available. It is not possible to specify more than one
+test group or point test at a time.
+.Pp
+.Nm
+must be run as root.
+.Ss Options
+.Bl -tag -width "-r "
+.It Fl 1
+IP header tests. 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).
-.TP
-.B \-2
-Run IP test group #2.  This group of tests generates packets with the IP
+The point tests are:
+.Pp
+.Bl -tag -width "10 " -compact -offset indent
+.It 1
+ip_hl < ip_len
+.It 2
+ip_hl > ip_len
+.It 3
+ip_v < 4
+.It 4
+ip_v > 4
+.It 5
+ip_len < packetsize, long packets
+.It 6
+ip_len > packet size, short packets
+.It 7
+Zero length fragments
+.It 8
+packet > 64k after reassembly
+.It 9 
+IP offset with MSB set
+.It 10 
+ttl variations
+.El
+.It Fl 2
+IP options tests. 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).
-.TP
-.B \-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).
-.TP
-.B \-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)).
-.TP
-.B \-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).
-.TP
-.B \-6
-Run IP test group #6.  This test generates a large number of fragments in
+The point tests are:
+.Pp
+.Bl -tag -compact -width "1  " -offset indent
+.It 1 
+option length > packet length
+.It 2 
+option length = 0
+.El
+.It Fl 3
+ICMP tests. This group of tests generates packets with the ICMP
+header fields set to non-standard values.
+The point tests are:
+.Pp
+.Bl -tag -compact -width "1  " -offset indent
+.It 1 
+ICMP types 0-31 & 255
+.It 2
+type 3 & codes 0-31
+.It 3
+type 4 & codes 0, 127, 128, 255
+.It 4
+type 5 & codes 0, 127, 128, 255
+.It 5
+types 8-10, 13-18 with codes 0, 127, 128 and 255
+.It 6
+type 12 & codes 0, 127, 128, 129, 255
+.It 7
+type 3 & codes 9-10, 13-14 and 17-18 - shortened packets
+.El
+.It Fl 4
+UDP tests. This group of tests generates packets with the UDP
+header fields set to non-standard values. The point tests are:
+.Pp
+.Bl -tag -width "1  " -compact -offset indent
+.It 1
+UDP length > packet size
+.It 2
+UDP length < packetsize
+.It 3
+sport = 0, 1, 32767, 32768, 65535
+.It 4
+dport = 0, 1, 32767, 32768, 65535
+.It 5
+sizeof(struct ip) <= MTU <= sizeof(struct udphdr) + sizeof(struct ip)
+.El
+.It Fl 5
+TCP tests. This group of tests generates packets with the TCP
+header fields set to non-standard values. The point tests are:
+.Pp
+.Bl -tag -width "1  " -compact -offset indent
+.It 1
+TCP flags variations, all combinations
+.It 2 
+seq = 0, 0x7fffffff, 0x8000000, 0xa0000000, 0xffffffff
+.It 3 
+ack = 0, 0x7fffffff, 0x8000000, 0xa0000000, 0xffffffff
+.It 4 
+SYN packet with window of 0, 32768, 65535 
+.It 5 
+set urgent pointer to 1, 0x7fff, 0x8000, 0xffff
+.It 6 
+data offset
+.It 7 
+sport = 0, 1, 32767, 32768, 65535
+.It 8 
+dport = 0, 1, 32767, 32768, 65535
+.El
+.It Fl 6
+Overlapping fragments test. 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
+reassembly.
+.Pp
+WARNING: this may crash or cause serious performance degradation
 to the target host.
-.TP
-.B \-7
-Run IP test group #7.  This test generates 1024 random IP packets with only
+.It Fl 7
+Random packets. This test generates 1024 random IP packets with only
 the IP version, checksum, length and IP offset field correct.
-.TP
-.BR \-d \0<interface>
+.It Fl d Ar device
 Set the interface name to be the name supplied.
-.TP
-.BR \-g \0<gateway>
-Specify the hostname of the gateway through which to route packets.  This
+.It Fl g Ar 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.
-.TP
-.BR \-m \0<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.
-.TP
-.B \-p <test>
-Run a...
-.DT
-.SH SEE ALSO
-ipsend(1), ipresend(1), bpf(4)
-.SH DIAGNOSTICS
-Only one of the numeric test options may be given when \fIiptest\fP is run.
-.PP
-Needs to be run as root.
-.SH BUGS
-.PP
+.It Fl m Ar mtu
+Set the MTU used when sending out packets to
+.Ar mtu .
+This option lets you
+set a fake MTU, allowing the simulation of network interfaces with small
+MTU's.
+.It Fl p Ar pointtest
+Run point test
+.Ar pointtest
+of the test group.
+.It Fl s Ar src
+Specify the source address of the IP packets as
+.Ar src
+.El
+.Sh SEE ALSO
+.Xr ipsend 1 ,
+.Xr ipresend 1 ,
+.Xr bpf 4 
+.Sh BUGS
 If you find any, please send email to me at darrenr@cyber.com.au