components/libdnet/patches/dnet.8.patch
changeset 1043 585b09419d1c
child 5007 0052258cbb9d
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/libdnet/patches/dnet.8.patch	Tue Nov 06 16:27:21 2012 -0800
@@ -0,0 +1,416 @@
+--- libdnet-1.12/test/dnet/dnet.8.orig	2012-05-23 08:30:25.629791399 -0700
++++ libdnet-1.12/test/dnet/dnet.8	2012-05-23 08:47:33.464415318 -0700
+@@ -2,240 +2,235 @@
+ .\"
+ .\" Copyright (c) 2001 Dug Song <[email protected]>
+ .\"
+-.Dd October 17, 2001
+-.Dt DNET 8
+-.Os
+-.Sh NAME
+-.Nm dnet
+-.Nd dumb networking library test program
+-.Sh SYNOPSIS
+-.Nm dnet Ar command Ar args Op ...
+-.Sh DESCRIPTION
+-.Nm
+-is a simple test program for the 
+-.Xr dnet 3
++.TH "DNET" "1M" "October 17, 2001" "SunOS 5.11" "System Manager's Manual"
++.SH "NAME"
++\fBdnet\fP
++\- dumb networking library test program
++.SH "SYNOPSIS"
++\fBdnet \fIcommand\fP \fIargs\fP [...]\fP
++.SH "DESCRIPTION"
++\fBdnet\fP
++is a simple test program for the
++dnet(3)
+ library. It can be used to compose and transmit network datagrams as a
+ Unix-style filter (e.g. reading from or writing to files and pipes) or
+ modify the local system network configuration (including the ARP
+ cache, firewall ruleset, network interfaces, and routing table).
+-.Pp
+-.Ss Payload generation commands
+-.Bl -tag -width "foo"
+-.It Nm addr Ar address Op ...
+-Convert the 
+-.Ar address
++.PP
++.SS "Payload generation commands"
++.TP foo
++\fBaddr\fP \fIaddress\fP [...]
++Convert the
++\fIaddress\fP
+ (specified as a hostname, IP address, or MAC address)
+ into its binary representation on standard output.
+-.It Nm hex Ar string Op ...
++.TP foo
++\fBhex\fP \fIstring\fP [...]
+ Convert the C-style escaped
+-.Ar string
+-(shellcode, for instance) into its binary representation on standard output. 
+-.It Nm rand Ar len
++\fIstring\fP
++(shellcode, for instance) into its binary representation on standard output.
++.TP foo
++\fBrand\fP \fIlen\fP
+ Write
+-.Ar len
++\fIlen\fP
+ random bytes to standard output.
+-.El
+-.Ss Packet encapsulation commands
+-.Bl -tag -width "foo"
+-.It Xo
+-.Nm eth
+-.Op Nm type Ar type 
+-.Op Nm src Ar mac
+-.Op Nm dst Ar mac
+-.Xc
++.SS "Packet encapsulation commands"
++.TP foo
++\fBeth\fP
++[\fBtype\fP \fItype\fP]
++[\fBsrc\fP \fImac\fP]
++[\fBdst\fP \fImac\fP]
+ Prepend the data read from standard input with an Ethernet header on
+ standard output. The Ethernet
+-.Ar type
++\fItype\fP
+ may be specified as
+-.Ql arp ,
+-.Ql ip ,
++`arp',
++`ip',
+ or as a hex, octal, or decimal number.
+-.It Xo
+-.Nm arp
+-.Op Nm op Ar op
+-.Op Nm sha Ar mac
+-.Op Nm spa Ar host
+-.Op Nm tha Ar mac
+-.Op Nm tpa Ar host
+-.Xc
++.TP foo
++\fBarp\fP
++[\fBop\fP \fIop\fP]
++[\fBsha\fP \fImac\fP]
++[\fBspa\fP \fIhost\fP]
++[\fBtha\fP \fImac\fP]
++[\fBtpa\fP \fIhost\fP]
+ Prepend the data read from standard input with an ARP header on
+ standard output. The ARP
+-.Ar op
++\fIop\fP
+ may be specified as
+-.Ql req ,
+-.Ql rep ,
+-.Ql revreq ,
+-.Ql revrep ,
++`req',
++`rep',
++`revreq',
++`revrep',
+ or as a hex, octal, or decimal number.
+-.It Xo
+-.Nm ip
+-.Op Nm tos Ar num
+-.Op Nm id Ar num
+-.Op Nm off Ar offset
+-.Op Nm ttl Ar num
+-.Op Nm proto Ar protocol
+-.Op Nm src Ar host
+-.Bk -words
+-.Op Nm dst Ar dst
+-.Ek
+-.Xc
++.TP foo
++\fBip\fP
++[\fBtos\fP \fInum\fP]
++[\fBid\fP \fInum\fP]
++[\fBoff\fP \fIoffset\fP]
++[\fBttl\fP \fInum\fP]
++[\fBproto\fP \fIprotocol\fP]
++[\fBsrc\fP \fIhost\fP]
++[\fBdst\fP \fIdst\fP]
+ Prepend the data read from standard input with an IP header on
+ standard output. The fragmentation
+-.Ar offset
+-may be specified as a decimal number (optionally concatenated with 
+-.Ql +
+-to indicate more fragments) or as a hex number. The 
+-.Ar protocol
++\fIoffset\fP
++may be specified as a decimal number (optionally concatenated with
++`+'
++to indicate more fragments) or as a hex number. The
++\fIprotocol\fP
+ may be specified by name, or as a hex, octal, or decimal number.
+-.It Xo
+-.Nm icmp
+-.Op Nm type Ar num
+-.Op Nm code Ar num
+-.Xc
++.TP foo
++\fBicmp\fP
++[\fBtype\fP \fInum\fP]
++[\fBcode\fP \fInum\fP]
+ Prepend the data read from standard input with an ICMP header on
+ standard output.
+-.It Xo
+-.Nm tcp
+-.Op Nm sport Ar port
+-.Op Nm dport Ar port
+-.Op Nm flags Ar flags
+-.Op Nm seq Ar num
+-.Op Nm ack Ar num
+-.Op Nm win Ar num
+-.Op Nm urp Ar num
+-.Xc
++.TP foo
++\fBtcp\fP
++[\fBsport\fP \fIport\fP]
++[\fBdport\fP \fIport\fP]
++[\fBflags\fP \fIflags\fP]
++[\fBseq\fP \fInum\fP]
++[\fBack\fP \fInum\fP]
++[\fBwin\fP \fInum\fP]
++[\fBurp\fP \fInum\fP]
+ Prepend the data read from standard input with a TCP header on
+ standard output. A
+-.Ar port
+-may be specified by name or hex, octal, or decimal number. The TCP 
+-.Ar flags
++\fIport\fP
++may be specified by name or hex, octal, or decimal number. The TCP
++\fIflags\fP
+ may be specified as some combination of the characters in the set
+-.Ql SAFRPU
++`SAFRPU'
+ or as a hex number.
+-.It Xo
+-.Nm udp
+-.Op Nm sport Ar port
+-.Op Nm dport Ar port
+-.Xc
++.TP foo
++\fBudp\fP
++[\fBsport\fP \fIport\fP]
++[\fBdport\fP \fIport\fP]
+ Prepend the data read from standard input with a UDP header on
+ standard output. A
+-.Ar port
++\fIport\fP
+ may be specified by name or hex, octal, or decimal number.
+-.El
+-.Ss Packet transmission commands
+-.Bl -tag -width "foo"
+-.It Nm send Op Ar device
++.SS "Packet transmission commands"
++.TP foo
++\fBsend\fP [\fIdevice\fP]
+ Read a packet from standard input and send it over the network. If no
+-.Ar device
++\fIdevice\fP
+ is specified, the packet is assumed to be an IP datagram and routed
+ to its destination. Otherwise, the packet is assumed to be an Ethernet
+ frame and is transmitted on the specified interface.
+-.El
+-.Ss Kernel interface commands
+-.Bl -tag -width "foo"
+-.It Nm arp show
++.SS "Kernel interface commands"
++.TP foo
++\fBarp show\fP
+ Display the kernel ARP cache.
+-.It Nm arp get Ar host
++.TP foo
++\fBarp get\fP \fIhost\fP
+ Display the kernel ARP entry for
+-.Ar host .
+-.It Nm arp add Ar host Ar mac
++\fIhost\fP.
++.TP foo
++\fBarp add\fP \fIhost\fP \fImac\fP
+ Add an ARP entry mapping the
+-.Ar mac
++\fImac\fP
+ address for
+-.Ar host .
+-.It Nm arp delete Ar host
++\fIhost\fP.
++.TP foo
++\fBarp delete\fP \fIhost\fP
+ Delete the ARP entry for
+-.Ar host .
+-.Pp
+-.It Nm fw show
++\fIhost\fP.
++.sp
++.TP foo
++\fBfw show\fP
+ Display the kernel firewall ruleset.
+-.It Xo
+-.Nm fw add Ns \&| Ns Nm delete
+-.Ar action Ar direction Ar device 
+-.Ar protocol 
+-.Ar src Ns Op \&: Ns Ar port[-max]
+-.Ar dst Ns Op \&: Ns Ar port[-max]
+-.Op Ar type Ns Op /code
+-.Xc
++.TP foo
++\fBfw add\fP\&|\fBdelete\fP
++\fIaction\fP \fIdirection\fP \fIdevice\fP
++\fIprotocol\fP
++\fIsrc\fP[\&:\fIport[-max]\fP]
++\fIdst\fP[\&:\fIport[-max]\fP]
++[\fItype\fP[/code]]
+ Add a rule to or delete a rule from the active firewall ruleset. The
+-.Ar action
++\fIaction\fP
+ must be either
+-.Ql allow
++`allow'
+ or
+-.Ql block .
++`block'.
+ The direction must be either
+-.Ql in
++`in'
+ or
+-.Ql out .
+-The 
+-.Ar device
+-may specify an interface name, or 
+-.Ql any .
+-The 
+-.Ar protocol
++`out'.
++The
++\fIdevice\fP
++may specify an interface name, or
++`any'.
++The
++\fIprotocol\fP
+ may be specified by name, or as a decimal number. For TCP and
+-UDP protocols, a 
+-.Ar port
++UDP protocols, a
++\fIport\fP
+ (or range, if specified with a
+-.Ar max
++\fImax\fP
+ value) may be specified in decimal and appended to the source and/or
+ destination address. For ICMP, a
+-.Ar type
++\fItype\fP
+ (and optional
+-.Ar code )
++\fIcode\fP)
+ may be specified in decimal.
+-.It Nm intf show
++.TP foo
++\fBintf show\fP
+ Display the configuration of all network interfaces.
+-.It Nm intf get Ar device
++.TP foo
++\fBintf get\fP \fIdevice\fP
+ Display the configuration for the interface specified by
+-.Ar device .
+-.It Xo
+-.Nm intf set
+-.Ar device
+-.Op Nm alias Ar host
+-.Op Nm dst Ar host
+-.Op Nm inet Ar host
+-.Op Nm link Ar mac
+-.Op Nm up Ns \&| Ns Nm down
+-.Op Nm arp Ns \&| Ns Nm noarp
+-.Xc
++\fIdevice\fP.
++.TP foo
++\fBintf set\fP
++\fIdevice\fP
++[\fBalias\fP \fIhost\fP]
++[\fBdst\fP \fIhost\fP]
++[\fBinet\fP \fIhost\fP]
++[\fBlink\fP \fImac\fP]
++[\fBup\fP\&|\fBdown\fP]
++[\fBarp\fP\&|\fBnoarp\fP]
+ Configure the interface specified by
+-.Ar device .
+-.It Nm route show
++\fIdevice\fP.
++.TP foo
++\fBroute show\fP
+ Display the kernel routing table.
+-.It Nm route get Ar dst
++.TP foo
++\fBroute get\fP \fIdst\fP
+ Display the route for the destination
+-.Ar dst ,
++\fIdst\fP,
+ specified as a hostname, IP address, or network prefix in CIDR notation.
+-.It Nm route add Ar dst Ar gw
++.TP foo
++\fBroute add\fP \fIdst\fP \fIgw\fP
+ Add a route for the destination
+-.Ar dst
++\fIdst\fP
+ through the gateway
+-.Ar gw .
+-.It Nm route delete Ar dst
++\fIgw\fP.
++.TP foo
++\fBroute delete\fP \fIdst\fP
+ Delete the route for the destination
+-.Ar dst .
+-.El
+-.Sh EXAMPLES
++\fIdst\fP.
++.SH "EXAMPLES"
+ Send a UDP datagram containing random shellcode:
+-.Bd -literal -offset indent
++.nf
+ dnet hex "\\xeb\\x1f\\x5e\\x89\\x76\\x08\\x31\\xc0\\x88\\x46\\x07\\x89" \\
+ "\\x46\\x0c\\xb0\\x0b\\x89\\xf3\\x8d\\x4e\\x08\\x8d\\x56\\x0c\\xcd\\x80" \\
+ "\\x31\\xdb\\x89\\xd8\\x40\\xcd\\x80\\xe8\\xdc\\xff\\xff\\xff/bin/sh" | \\
+ dnet udp sport 555 dport 666 | \\
+ dnet ip proto udp src 1.2.3.4 dst 5.6.7.8 | dnet send
+-.Ed
+-.Pp
++.fi
++.PP
+ Save an ARP request in a file and send it twice:
+-.Bd -literal -offset indent
++.nf
+ dnet arp op req sha 0:d:e:a:d:0 spa 10.0.0.3 tpa 10.0.0.4 | \\
+ dnet eth type arp src 0:d:e:a:d:0 dst ff:ff:ff:ff:ff:ff > arp.pkt
+ dnet send fxp0 < arp.pkt
+ dnet send fxp0 < arp.pkt
+-.Ed
+-.Pp
++.fi
++.PP
+ Send a fragmented ping packet:
+-.Bd -literal -offset indent
++.nf
+ # Create ping packet with IP header, to set ICMP checksum
+ echo "monkey monkey monkey monkey" | dnet icmp type 8 code 0 | \\
+ dnet ip proto icmp src 1.2.3.4 dst 5.6.7.8 > ping.pkt
+@@ -251,9 +246,9 @@
+ dnet send
+ dnet ip id 1 off 24 proto icmp src 1.2.3.4 dst 5.6.7.8 < p.ab | \\
+ dnet send
+-.Ed
+-.Sh SEE ALSO
+-.Xr dnet 3
+-.Sh AUTHORS
++.fi
++.SH "SEE ALSO"
++dnet(3)
++.SH "AUTHORS"
+ Dug Song
+-.Aq [email protected]
++<[email protected]>