From 63a98c4c1192eb9d9e58b45f657da5fad827db58 Mon Sep 17 00:00:00 2001
From: Bob Weinand <bwoebi@php.net>
Date: Wed, 19 Oct 2016 11:06:56 +0000
Subject: [PATCH] Add documentation for so_reuseport, so_broadcast and
 ipv6_v6only socket stream context options

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@340564 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/context/socket.xml | 61 +++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/language/context/socket.xml b/language/context/socket.xml
index 9c9689855b..0c42aa5049 100644
--- a/language/context/socket.xml
+++ b/language/context/socket.xml
@@ -53,6 +53,49 @@
       </note>
      </listitem>
     </varlistentry>
+    <varlistentry xml:id="context.socket.ipv6_v6only">
+     <term><parameter>ipv6_v6only</parameter></term>
+     <listitem>
+      <para>
+       Overrides the OS default regarding mapping IPv4 into IPv6.
+      </para>
+      <note>
+       <para>
+        This is important in particular when trying to listen on IPv4 addresses
+        separately while there exists a binding on <literal>[::]</literal>.
+       </para>
+       <para>
+        This is only applicable to <function>stream_socket_server</function>.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="context.socket.so_reuseport">
+     <term><parameter>so_reuseport</parameter></term>
+     <listitem>
+      <para>
+       Allows multiple bindings to a same ip:port pair, even from separate processes.
+      </para>
+      <note>
+       <para>
+        This is only applicable to <function>stream_socket_server</function>.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="context.socket.so_broadcast">
+     <term><parameter>so_broadcast</parameter></term>
+     <listitem>
+      <para>
+       Enables sending and receiving data to/from broadcast addresses.
+      </para>
+      <note>
+       <para>
+        This is only applicable to <function>stream_socket_server</function>.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1><!-- }}} -->
@@ -69,6 +112,24 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>7.0.1</entry>
+       <entry>
+        Added <parameter>ipv6_v6only</parameter>.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Added <parameter>so_broadcast</parameter>.
+       </entry>
+      </row>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Added <parameter>so_reuseport</parameter>.
+       </entry>
+      </row>
       <row>
        <entry>5.3.3</entry>
        <entry>