From cd49b1ab76c728d97b888532aa58ed6007f56390 Mon Sep 17 00:00:00 2001
From: Peter Schiffer <pschiffe@redhat.com>
Date: Thu, 13 Sep 2012 13:40:46 +0200
Subject: [PATCH] - 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(+)
 create mode 100644 man-pages-3.42-ip-local-port.patch

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@lists.fedoraproject.org> - 3.41-2
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_18_Mass_Rebuild