Not sure I count as a network developer but this looks fine to me.
On Sun, Jan 09, 2011 at 01:15:51PM -0800, Jeremy Evans wrote:
> jmc@ and I discussed these man page changes. He's OK with this patch,
> but would like another network developer to approve. So, looking for
> OKs.
>
> Jeremy
>
> Index: nc.1
> ===================================================================
> RCS file: /cvs/src/usr.bin/nc/nc.1,v
> retrieving revision 1.56
> diff -u -p -r1.56 nc.1
> --- nc.1 8 Jan 2011 00:44:19 -0000 1.56
> +++ nc.1 9 Jan 2011 21:10:44 -0000
> @@ -40,7 +40,7 @@
> .Op Fl O Ar length
> .Op Fl P Ar proxy_username
> .Op Fl p Ar source_port
> -.Op Fl s Ar source_ip_address
> +.Op Fl s Ar source
> .Op Fl T Ar ToS
> .Op Fl V Ar rtable
> .Op Fl w Ar timeout
> @@ -49,7 +49,7 @@
> .Fl x Ar proxy_address Ns Oo : Ns
> .Ar port Oc
> .Xc Oc
> -.Op Ar hostname
> +.Op Ar destination
> .Op Ar port
> .Ek
> .Sh DESCRIPTION
> @@ -57,8 +57,10 @@ The
> .Nm
> (or
> .Nm netcat )
> -utility is used for just about anything under the sun involving TCP
> -or UDP.
> +utility is used for just about anything under the sun involving TCP,
> +UDP, or
> +.Ux Ns -domain
> +sockets.
> It can open TCP connections, send UDP packets, listen on arbitrary
> TCP and UDP ports, do port scanning, and deal with both IPv4 and
> IPv6.
> @@ -153,7 +155,7 @@ instead of sequentially within a range o
> assigns them.
> .It Fl S
> Enables the RFC 2385 TCP MD5 signature option.
> -.It Fl s Ar source_ip_address
> +.It Fl s Ar source
> Specifies the IP of the interface which is used to send the packets.
> For
> .Ux Ns -domain
> @@ -234,7 +236,7 @@ If the protocol is not specified, SOCKS
> Requests that
> .Nm
> should connect to
> -.Ar hostname
> +.Ar destination
> using a proxy at
> .Ar proxy_address
> and
> @@ -252,16 +254,22 @@ It is an error to use this option in con
> option.
> .El
> .Pp
> -.Ar hostname
> +.Ar destination
> can be a numerical IP address or a symbolic hostname
> (unless the
> .Fl n
> option is given).
> -In general, a hostname must be specified,
> +In general, a destination must be specified,
> unless the
> .Fl l
> option is given
> (in which case the local host is used).
> +For
> +.Ux Ns -domain
> +sockets, a destination is required and is the socket path to connect to
> +(or listen on if the
> +.Fl l
> +option is given).
> .Pp
> .Ar port
> can be a single integer or a range of ports.
> @@ -270,8 +278,7 @@ In general,
> a destination port must be specified,
> unless the
> .Fl U
> -option is given
> -(in which case a socket must be specified).
> +option is given.
> .Sh CLIENT/SERVER MODEL
> It is quite simple to build a very basic client/server model using
> .Nm .
> @@ -404,7 +411,7 @@ IP for the local end of the connection:
> .Pp
> Create and listen on a
> .Ux Ns -domain
> -socket:
> +stream socket:
> .Pp
> .Dl $ nc -lU /var/tmp/dsocket
> .Pp
> Index: netcat.c
> ===================================================================
> RCS file: /cvs/src/usr.bin/nc/netcat.c,v
> retrieving revision 1.99
> diff -u -p -r1.99 netcat.c
> --- netcat.c 8 Jan 2011 00:44:19 -0000 1.99
> +++ netcat.c 9 Jan 2011 21:10:45 -0000
> @@ -930,9 +930,9 @@ usage(int ret)
> {
> fprintf(stderr,
> "usage: nc [-46DdhklnrStUuvz] [-I length] [-i interval] [-O
> length]\n"
> - "\t [-P proxy_username] [-p source_port] [-s source_ip_address]
> [-T ToS]\n"
> + "\t [-P proxy_username] [-p source_port] [-s source] [-T ToS]\n"
> "\t [-V rtable] [-w timeout] [-X proxy_protocol]\n"
> - "\t [-x proxy_address[:port]] [hostname] [port]\n");
> + "\t [-x proxy_address[:port]] [destination] [port]\n");
> if (ret)
> exit(1);
> }
