[man-pages] - improved explanation about calling listen or connect on the ip(7) man page (#787567)

[pschiffe]

commit cd49b1ab76c728d97b888532aa58ed6007f56390
Author: Peter Schiffer <pschiffe at redhat.com>
Date:   Thu Sep 13 13:40:46 2012 +0200

    - improved explanation about calling listen or connect on the ip(7) man page (#787567)

 man-pages-3.42-ip-local-port.patch |   36 ++++++++++++++++++++++++++++++++++++
 man-pages.spec                     |    4 ++++
 2 files changed, 40 insertions(+), 0 deletions(-)
---
diff --git a/man-pages-3.42-ip-local-port.patch b/man-pages-3.42-ip-local-port.patch
new file mode 100644
index 0000000..bef93c3
--- /dev/null
+++ b/man-pages-3.42-ip-local-port.patch
@@ -0,0 +1,36 @@
+diff -ur man-pages-3.42.orig/man7/ip.7 man-pages-3.42/man7/ip.7
+--- man-pages-3.42.orig/man7/ip.7	2012-09-13 13:28:01.000000000 +0200
++++ man-pages-3.42/man7/ip.7	2012-09-13 13:33:04.571447716 +0200
+@@ -69,12 +69,11 @@
+ you may specify a valid IANA IP protocol defined in
+ RFC\ 1700 assigned numbers.
+ .PP
+-.\" FIXME ip current does an autobind in listen, but I'm not sure
+-.\" if that should be documented.
+ When a process wants to receive new incoming packets or connections, it
+ should bind a socket to a local interface address using
+ .BR bind (2).
+-Only one IP socket may be bound to any given local (address, port) pair.
++In this case, only one IP socket may be bound to any given local
++(address, port) pair.
+ When
+ .B INADDR_ANY
+ is specified in the bind call, the socket will be bound to
+@@ -82,10 +81,14 @@
+ local interfaces.
+ When
+ .BR listen (2)
+-or
++is called on an unbound socket, the socket is automatically bound
++to a random free port with the local address set to
++.BR INADDR_ANY .
++When
+ .BR connect (2)
+-are called on an unbound socket, it is automatically bound to a
+-random free port with the local address set to
++is called on an unbound socket, the socket is automatically bound
++to a random free port or an usable shared port with the local address
++set to
+ .BR INADDR_ANY .
+ 
+ A TCP local socket address that has been bound is unavailable for
diff --git a/man-pages.spec b/man-pages.spec
index 09447f2..c37a763 100644
--- a/man-pages.spec
+++ b/man-pages.spec
@@ -54,6 +54,8 @@ Patch50: man-pages-3.42-resolv-conf.patch
 Patch51: man-pages-3.42-shmop.patch
 # resolves: #804003
 Patch52: man-pages-3.42-ip.patch
+# resolves: #787567
+Patch53: man-pages-3.42-ip-local-port.patch
 
 
 Autoreq: false
@@ -88,6 +90,7 @@ Documentation Project (LDP).
 %patch50 -p1
 %patch51 -p1
 %patch52 -p1
+%patch53 -p1
 
 ## Remove man pages we are not going to use ##
 
@@ -163,6 +166,7 @@ cd ..
 - added description of single-request-reopen to the resolv.conf(5) man page (#717770)
 - add missing EIDRM error code description to the shmop(2) man page (#800256)
 - add documentation of several source-specific multicast socket options to the ip(7) man page (#804003)
+- improved explanation about calling listen or connect on the ip(7) man page (#787567)
 
 * Thu Jul 19 2012 Fedora Release Engineering <rel-eng at lists.fedoraproject.org> - 3.41-2
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_18_Mass_Rebuild