RubyGems - glib2 - Versions diffs - 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32 - Mend

glib2 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1058) hide show

data/vendor/local/share/gtk-doc/html/gio/GSocket.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>GSocket: GIO Reference Manual</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="networking.html" title="Low-level network support">
 <link rel="prev" href="networking.html" title="Low-level network support">
-<link rel="next" href="GInetAddress.html" title="GInetAddress">
-<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<link rel="next" href="GDatagramBased.html" title="GDatagramBased">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -23,7 +23,7 @@
 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 <td><a accesskey="u" href="networking.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 <td><a accesskey="p" href="networking.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
-<td><a accesskey="n" href="GInetAddress.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+<td><a accesskey="n" href="GDatagramBased.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 </tr></table>
 <div class="refentry">
 <a name="GSocket"></a><div class="titlepage"></div>
@@ -36,7 +36,7 @@
 </tr></table></div>
 <div class="refsect1">
 <a name="GSocket.functions"></a><h2>Functions</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="functions_return">
 <col class="functions_name">
@@ -132,6 +132,14 @@
 </tr>
 <tr>
 <td class="function_type">
+<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()">g_socket_receive_messages</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
 <a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
 </td>
 <td class="function_name">
@@ -479,7 +487,7 @@
 </div>
 <div class="refsect1">
 <a name="GSocket.properties"></a><h2>Properties</h2>
-<div class="informaltable"><table border="0">
+<div class="informaltable"><table class="informaltable" border="0">
 <colgroup>
 <col width="150px" class="properties_type">
 <col width="300px" class="properties_name">
@@ -563,7 +571,7 @@
 </div>
 <div class="refsect1">
 <a name="GSocket.other"></a><h2>Types and Values</h2>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="name">
 <col class="description">
@@ -591,6 +599,10 @@
 </tr>
 <tr>
 <td class="datatype_keyword">struct</td>
+<td class="function_name"><a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage">GInputMessage</a></td>
+</tr>
+<tr>
+<td class="datatype_keyword">struct</td>
 <td class="function_name"><a class="link" href="GSocket.html#GOutputVector" title="struct GOutputVector">GOutputVector</a></td>
 </tr>
 <tr>
@@ -610,7 +622,7 @@
 <a name="GSocket.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 <p>
 GSocket implements
- <a class="link" href="GInitable.html" title="GInitable">GInitable</a>.</p>
+ <a class="link" href="GInitable.html" title="GInitable">GInitable</a> and  <a class="link" href="GDatagramBased.html" title="GDatagramBased">GDatagramBased</a>.</p>
 </div>
 <div class="refsect1">
 <a name="GSocket.includes"></a><h2>Includes</h2>
@@ -633,7 +645,8 @@ results before using the object. This is done automatically in
 <a class="link" href="GSocket.html#g-socket-new" title="g_socket_new ()"><code class="function">g_socket_new()</code></a> and <a class="link" href="GSocket.html#g-socket-new-from-fd" title="g_socket_new_from_fd ()"><code class="function">g_socket_new_from_fd()</code></a>, so these functions can return
 <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 <p>Sockets operate in two general modes, blocking or non-blocking. When
-in blocking mode all operations block until the requested operation
+in blocking mode all operations (which don’t take an explicit blocking
+parameter) block until the requested operation
 is finished or there is an error. In non-blocking mode all calls that
 would block return immediately with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error.
 To know when a call would successfully run you can call <a class="link" href="GSocket.html#g-socket-condition-check" title="g_socket_condition_check ()"><code class="function">g_socket_condition_check()</code></a>,
@@ -674,7 +687,7 @@ locking.</p>
 returned by <a class="link" href="GSocket.html#g-socket-create-source" title="g_socket_create_source ()"><code class="function">g_socket_create_source()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.2.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -702,9 +715,8 @@ returned by <a class="link" href="GSocket.html#g-socket-create-source" title="g_
 <div class="refsect3">
 <a name="id-1.4.13.2.10.2.6"></a><h4>Returns</h4>
 <p> it should return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the source should be removed.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -729,7 +741,7 @@ system, so you can use protocols not listed in <a class="link" href="GSocket.htm
 know the protocol number used for it.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.3.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -763,9 +775,8 @@ know the protocol number used for it.</p>
 <a name="id-1.4.13.2.10.3.8"></a><h4>Returns</h4>
 <p> a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -783,9 +794,11 @@ mode of the <a class="link" href="GSocket.html" title="GSocket"><span class="typ
 . On failure, the
 caller must close <em class="parameter"><code>fd</code></em>
  themselves.</p>
+<p>Since GLib 2.46, it is no longer a fatal error to call this on a non-socket
+descriptor.  Instead, a GError will be set with code <a class="link" href="gio-GIOError.html#G-IO-ERROR-FAILED:CAPS"><code class="literal">G_IO_ERROR_FAILED</code></a></p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.4.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.4.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -806,12 +819,11 @@ caller must close <em class="parameter"><code>fd</code></em>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.4.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.4.9"></a><h4>Returns</h4>
 <p> a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -847,7 +859,7 @@ broadcast packets sent to that address. (The behavior of unicast
 UDP packets to an address with multiple listeners is not defined.)</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.5.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -880,9 +892,8 @@ UDP packets to an address with multiple listeners is not defined.)</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.5.9"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -898,7 +909,7 @@ to accept incoming requests using <a class="link" href="GSocket.html#g-socket-ac
 <a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_socket_set_listen_backlog ()"><code class="function">g_socket_set_listen_backlog()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.6.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -921,9 +932,8 @@ to accept incoming requests using <a class="link" href="GSocket.html#g-socket-ac
 <div class="refsect3">
 <a name="id-1.4.13.2.10.6.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -943,7 +953,7 @@ or return <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><
 To be notified of an incoming connection, wait for the <a href="../glib/glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.7.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -974,7 +984,7 @@ To be notified of an incoming connection, wait for the <a href="../glib/glib-IO-
 Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1000,7 +1010,7 @@ for the G_IO_OUT condition. The result of the connection must then be
 checked with <a class="link" href="GSocket.html#g-socket-check-connect-result" title="g_socket_check_connect_result ()"><code class="function">g_socket_check_connect_result()</code></a>.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.8.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1033,9 +1043,8 @@ checked with <a class="link" href="GSocket.html#g-socket-check-connect-result" t
 <div class="refsect3">
 <a name="id-1.4.13.2.10.8.9"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if connected, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1048,7 +1057,7 @@ This is used to check for errors when <a class="link" href="GSocket.html#g-socke
 used in non-blocking mode.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.9.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1072,9 +1081,8 @@ used in non-blocking mode.</p>
 <a name="id-1.4.13.2.10.9.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if no error, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise, setting <em class="parameter"><code>error</code></em>
 to the error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1113,7 +1121,7 @@ returned. To be notified when data is available, wait for the
  is set accordingly.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.10.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1154,9 +1162,8 @@ bytes long). </p></td>
 <a name="id-1.4.13.2.10.10.10"></a><h4>Returns</h4>
 <p> Number of bytes read, or 0 if the connection was closed by
 the peer, or -1 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1179,7 +1186,7 @@ source address of the received packet.
 <p>See <a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a> for additional information.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.11.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1226,9 +1233,8 @@ bytes long). </p></td>
 <a name="id-1.4.13.2.10.11.8"></a><h4>Returns</h4>
 <p> Number of bytes read, or 0 if the connection was closed by
 the peer, or -1 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1243,8 +1249,8 @@ g_socket_receive_message (<em class="parameter"><code><a class="link" href="GSoc
                           <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *flags</code></em>,
                           <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
                           <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
-<p>Receive data from a socket.  This is the most complicated and
-fully-featured version of this call. For easier use, see
+<p>Receive data from a socket.  For receiving multiple messages, see
+<a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()"><code class="function">g_socket_receive_messages()</code></a>; for easier use, see
 <a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a> and <a class="link" href="GSocket.html#g-socket-receive-from" title="g_socket_receive_from ()"><code class="function">g_socket_receive_from()</code></a>.</p>
 <p>If <em class="parameter"><code>address</code></em>
  is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <em class="parameter"><code>address</code></em>
@@ -1292,7 +1298,9 @@ in <em class="parameter"><code>messages</code></em>
 for this are available in the <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> enum, but the
 values there are the same as the system values, and the flags
 are passed in as-is, so you can pass in system-specific flags too
-(and <a class="link" href="GSocket.html#g-socket-receive-message" title="g_socket_receive_message ()"><code class="function">g_socket_receive_message()</code></a> may pass system-specific flags out).</p>
+(and <a class="link" href="GSocket.html#g-socket-receive-message" title="g_socket_receive_message ()"><code class="function">g_socket_receive_message()</code></a> may pass system-specific flags out).
+Flags passed in to the parameter affect the receive operation; flags returned
+out of it are relevant to the specific returned message.</p>
 <p>As with <a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a>, data may be discarded if <em class="parameter"><code>socket</code></em>
  is
 <a class="link" href="GSocket.html#G-SOCKET-TYPE-DATAGRAM:CAPS"><code class="literal">G_SOCKET_TYPE_DATAGRAM</code></a> or <a class="link" href="GSocket.html#G-SOCKET-TYPE-SEQPACKET:CAPS"><code class="literal">G_SOCKET_TYPE_SEQPACKET</code></a> and you do not
@@ -1312,7 +1320,7 @@ returned. To be notified when data is available, wait for the
  is set accordingly.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.10.12.15"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1328,7 +1336,7 @@ returned. To be notified when data is available, wait for the
 <td class="parameter_name"><p>address</p></td>
 <td class="parameter_description"><p> a pointer to a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>
 pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>vectors</p></td>
@@ -1345,24 +1353,24 @@ pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="l
 <td class="parameter_name"><p>messages</p></td>
 <td class="parameter_description"><p> a pointer which
 may be filled with an array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>num_messages</p></td>
-<td class="parameter_description"><p>a pointer which will be filled with the number of
+<td class="parameter_description"><p> a pointer which will be filled with the number of
 elements in <em class="parameter"><code>messages</code></em>
-, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
-<td class="parameter_annotations"> </td>
+, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>flags</p></td>
-<td class="parameter_description"><p>a pointer to an int containing <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> flags</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> a pointer to an int containing <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> flags. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>cancellable</p></td>
-<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+<td class="parameter_description"><p>a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
+<td class="parameter_annotations"> </td>
 </tr>
 <tr>
 <td class="parameter_name"><p>error</p></td>
@@ -1376,9 +1384,119 @@ elements in <em class="parameter"><code>messages</code></em>
 <a name="id-1.4.13.2.10.12.16"></a><h4>Returns</h4>
 <p> Number of bytes read, or 0 if the connection was closed by
 the peer, or -1 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-socket-receive-messages"></a><h3>g_socket_receive_messages ()</h3>
+<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
+g_socket_receive_messages (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
+                           <em class="parameter"><code><a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a> *messages</code></em>,
+                           <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_messages</code></em>,
+                           <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> flags</code></em>,
+                           <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
+                           <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<p>Receive multiple data messages from <em class="parameter"><code>socket</code></em>
+ in one go.  This is the most
+complicated and fully-featured version of this call. For easier use, see
+<a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a>, <a class="link" href="GSocket.html#g-socket-receive-from" title="g_socket_receive_from ()"><code class="function">g_socket_receive_from()</code></a>, and <a class="link" href="GSocket.html#g-socket-receive-message" title="g_socket_receive_message ()"><code class="function">g_socket_receive_message()</code></a>.</p>
+<p><em class="parameter"><code>messages</code></em>
+ must point to an array of <a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a> structs and
+<em class="parameter"><code>num_messages</code></em>
+ must be the length of this array. Each <a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a>
+contains a pointer to an array of <a class="link" href="GSocket.html#GInputVector" title="struct GInputVector"><span class="type">GInputVector</span></a> structs describing the
+buffers that the data received in each message will be written to. Using
+multiple <a href="GSocket.html#GInputVector"><span class="type">GInputVectors</span></a> is more memory-efficient than manually copying data
+out of a single buffer to multiple sources, and more system-call-efficient
+than making multiple calls to <a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a>, such as in scenarios where
+a lot of data packets need to be received (e.g. high-bandwidth video
+streaming over RTP/UDP).</p>
+<p><em class="parameter"><code>flags</code></em>
+ modify how all messages are received. The commonly available
+arguments for this are available in the <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too. These
+flags affect the overall receive operation. Flags affecting individual
+messages are returned in <a class="link" href="GSocket.html#GInputMessage.flags"><span class="type">GInputMessage.flags</span></a>.</p>
+<p>The other members of <a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a> are treated as described in its
+documentation.</p>
+<p>If <a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property"><span class="type">“blocking”</span></a> is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the call will block until <em class="parameter"><code>num_messages</code></em>
+ have
+been received, or the end of the stream is reached.</p>
+<p>If <a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property"><span class="type">“blocking”</span></a> is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> the call will return up to <em class="parameter"><code>num_messages</code></em>
+without blocking, or <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> if no messages are queued in the
+operating system to be received.</p>
+<p>In blocking mode, if <a class="link" href="GSocket.html#GSocket--timeout" title="The “timeout” property"><span class="type">“timeout”</span></a> is positive and is reached before any
+messages are received, <a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a> is returned, otherwise up to
+<em class="parameter"><code>num_messages</code></em>
+ are returned. (Note: This is effectively the
+behaviour of <code class="literal">MSG_WAITFORONE</code> with <code class="function">recvmmsg()</code>.)</p>
+<p>To be notified when messages are available, wait for the
+<a href="../glib/glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition. Note though that you may still receive
+<a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> from <a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()"><code class="function">g_socket_receive_messages()</code></a> even if you were
+previously notified of a <a href="../glib/glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition.</p>
+<p>If the remote peer closes the connection, any messages queued in the
+operating system will be returned, and subsequent calls to
+<a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()"><code class="function">g_socket_receive_messages()</code></a> will return 0 (with no error set).</p>
+<p>On error -1 is returned and <em class="parameter"><code>error</code></em>
+ is set accordingly. An error will only
+be returned if zero messages could be received; otherwise the number of
+messages successfully received before the error will be returned.</p>
+<div class="refsect3">
+<a name="id-1.4.13.2.10.13.14"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>socket</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>messages</p></td>
+<td class="parameter_description"><p> an array of <a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a> structs. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>num_messages</p></td>
+<td class="parameter_description"><p>the number of elements in <em class="parameter"><code>messages</code></em>
+</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>flags</p></td>
+<td class="parameter_description"><p>an int containing <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> flags for the overall operation</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.13.2.10.13.15"></a><h4>Returns</h4>
+<p> number of messages received, or -1 on error. Note that the number
+of messages received may be smaller than <em class="parameter"><code>num_messages</code></em>
+if in non-blocking
+mode, if the peer closed the connection, or if <em class="parameter"><code>num_messages</code></em>
+was larger than <code class="literal">UIO_MAXIOV</code> (1024), in which case the caller may re-try
+to receive the remaining messages.</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-48.html#api-index-2.48">2.48</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1396,8 +1514,8 @@ the <em class="parameter"><code>blocking</code></em>
  argument rather than by <em class="parameter"><code>socket</code></em>
 's properties.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.13.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.14.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1440,12 +1558,11 @@ bytes long). </p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.13.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.14.6"></a><h4>Returns</h4>
 <p> Number of bytes read, or 0 if the connection was closed by
 the peer, or -1 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1473,8 +1590,8 @@ very common due to the way the underlying APIs work.)</p>
 <p>On error -1 is returned and <em class="parameter"><code>error</code></em>
  is set accordingly.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.14.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.15.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1511,13 +1628,12 @@ containing the data to send. </p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.14.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.15.8"></a><h4>Returns</h4>
 <p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
 ), or -1
 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1538,8 +1654,8 @@ g_socket_send_to (<em class="parameter"><code><a class="link" href="GSocket.html
 <a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()"><code class="function">g_socket_connect()</code></a>).</p>
 <p>See <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> for additional information.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.15.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.16.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1581,13 +1697,12 @@ containing the data to send. </p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.15.7"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.16.7"></a><h4>Returns</h4>
 <p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
 ), or -1
 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1604,8 +1719,8 @@ g_socket_send_message (<em class="parameter"><code><a class="link" href="GSocket
                        <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>Send data to <em class="parameter"><code>address</code></em>
  on <em class="parameter"><code>socket</code></em>
-.  This is the most complicated and
-fully-featured version of this call. For easier use, see
+.  For sending multiple messages see
+<a class="link" href="GSocket.html#g-socket-send-messages" title="g_socket_send_messages ()"><code class="function">g_socket_send_messages()</code></a>; for easier use, see
 <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> and <a class="link" href="GSocket.html#g-socket-send-to" title="g_socket_send_to ()"><code class="function">g_socket_send_to()</code></a>.</p>
 <p>If <em class="parameter"><code>address</code></em>
  is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the message is sent to the default receiver
@@ -1647,8 +1762,8 @@ very common due to the way the underlying APIs work.)</p>
 <p>On error -1 is returned and <em class="parameter"><code>error</code></em>
  is set accordingly.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.16.11"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.17.11"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1707,13 +1822,12 @@ array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlM
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.16.12"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.17.12"></a><h4>Returns</h4>
 <p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
 ), or -1
 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1757,10 +1871,12 @@ wait for the <a href="../glib/glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="
 notified of a <a href="../glib/glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. (On Windows in particular, this is
 very common due to the way the underlying APIs work.)</p>
 <p>On error -1 is returned and <em class="parameter"><code>error</code></em>
- is set accordingly.</p>
+ is set accordingly. An error will only
+be returned if zero messages could be sent; otherwise the number of messages
+successfully sent before the error will be returned.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.17.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.18.9"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1802,16 +1918,15 @@ very common due to the way the underlying APIs work.)</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.17.10"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.18.10"></a><h4>Returns</h4>
 <p> number of messages sent, or -1 on error. Note that the number of
 messages sent may be smaller than <em class="parameter"><code>num_messages</code></em>
 if the socket is
 non-blocking or if <em class="parameter"><code>num_messages</code></em>
 was larger than UIO_MAXIOV (1024),
 in which case the caller may re-try to send the remaining messages.</p>
-<p></p>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1829,8 +1944,8 @@ the <em class="parameter"><code>blocking</code></em>
  argument rather than by <em class="parameter"><code>socket</code></em>
 's properties.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.18.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.19.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1872,13 +1987,12 @@ containing the data to send. </p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.18.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.19.6"></a><h4>Returns</h4>
 <p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
 ), or -1
 on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1913,8 +2027,8 @@ connection, after which the server can safely call <a class="link" href="GSocket
 only works if the client will close its connection after the server
 does.)</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.19.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.20.9"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1935,11 +2049,10 @@ does.)</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.19.10"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.20.10"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1948,8 +2061,8 @@ does.)</p>
 g_socket_is_closed (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
 <p>Checks whether a socket is closed.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.20.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.21.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -1963,11 +2076,10 @@ g_socket_is_closed (<em class="parameter"><code><a class="link" href="GSocket.ht
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.20.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.21.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if socket is closed, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1977,7 +2089,7 @@ g_socket_shutdown (<em class="parameter"><code><a class="link" href="GSocket.htm
                    <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> shutdown_read</code></em>,
                    <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> shutdown_write</code></em>,
                    <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
-<p>Shut down part of a full-duplex connection.</p>
+<p>Shut down part or all of a full-duplex connection.</p>
 <p>If <em class="parameter"><code>shutdown_read</code></em>
  is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then the receiving side of the connection
 is shut down, and further reading is disallowed.</p>
@@ -1987,12 +2099,13 @@ is shut down, and further writing is disallowed.</p>
 <p>It is allowed for both <em class="parameter"><code>shutdown_read</code></em>
  and <em class="parameter"><code>shutdown_write</code></em>
  to be <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
-<p>One example where this is used is graceful disconnect for TCP connections
-where you close the sending side, then wait for the other side to close
-the connection, thus ensuring that the other side saw all sent data.</p>
+<p>One example where it is useful to shut down only one side of a connection is
+graceful disconnect for TCP connections where you close the sending side,
+then wait for the other side to close the connection, thus ensuring that the
+other side saw all sent data.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.21.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.22.9"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2023,11 +2136,10 @@ the connection, thus ensuring that the other side saw all sent data.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.21.10"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.22.10"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2036,9 +2148,13 @@ the connection, thus ensuring that the other side saw all sent data.</p>
 g_socket_is_connected (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
 <p>Check whether the socket is connected. This is only useful for
 connection-oriented sockets.</p>
+<p>If using <a class="link" href="GSocket.html#g-socket-shutdown" title="g_socket_shutdown ()"><code class="function">g_socket_shutdown()</code></a>, this function will return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> until the
+socket has been shut down for reading and writing. If you do a non-blocking
+connect, this function will not return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> until after you call
+<a class="link" href="GSocket.html#g-socket-check-connect-result" title="g_socket_check_connect_result ()"><code class="function">g_socket_check_connect_result()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.22.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.23.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2052,11 +2168,10 @@ connection-oriented sockets.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.22.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.23.7"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if socket is connected, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2089,9 +2204,10 @@ occurs, the source will then trigger anyway, reporting <a href="../glib/glib-IO-
  will have been
 marked as having had a timeout, and so the next <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> I/O method
 you call will then fail with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a>.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.23.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.24.10"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2117,11 +2233,11 @@ you call will then fail with a <a class="link" href="gio-GIOError.html#G-IO-ERRO
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.23.10"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.24.11"></a><h4>Returns</h4>
 <p> a newly allocated <a href="../glib/glib-The-Main-Event-Loop.html#GSource"><code class="literal">GSource</code></a>, free with <a href="../glib/glib-The-Main-Event-Loop.html#g-source-unref"><code class="function">g_source_unref()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2147,8 +2263,8 @@ the initial attempt returns <a class="link" href="gio-GIOError.html#G-IO-ERROR-W
 these conditions will always be set in the output if they are true.</p>
 <p>This call never blocks.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.24.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.25.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2169,12 +2285,11 @@ these conditions will always be set in the output if they are true.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.24.9"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.25.9"></a><h4>Returns</h4>
 <p> the <em class="parameter"><code>GIOCondition</code></em>
 mask of the current state</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2197,8 +2312,8 @@ the appropriate value (<a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCEL
 <a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a>).</p>
 <p>See also <a class="link" href="GSocket.html#g-socket-condition-timed-wait" title="g_socket_condition_timed_wait ()"><code class="function">g_socket_condition_timed_wait()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.25.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.26.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2229,11 +2344,10 @@ the appropriate value (<a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCEL
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.25.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.26.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the condition was met, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2267,8 +2381,8 @@ resolution, and the behavior is undefined if <em class="parameter"><code>timeout
  is not an
 exact number of milliseconds.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.26.8"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.27.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2304,18 +2418,17 @@ exact number of milliseconds.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.26.9"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.27.9"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the condition was met, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="g-socket-get-available-bytes"></a><h3>g_socket_get_available_bytes ()</h3>
 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
 g_socket_get_available_bytes (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
-<p>Get the amount of data pending in the OS input buffer.</p>
+<p>Get the amount of data pending in the OS input buffer, without blocking.</p>
 <p>If <em class="parameter"><code>socket</code></em>
  is a UDP or SCTP socket, this will return the size of
 just the next packet, even if additional packets are buffered after
@@ -2327,8 +2440,8 @@ of the incoming packet, it is better to just do a
 <a class="link" href="GSocket.html#g-socket-get-available-bytes" title="g_socket_get_available_bytes ()"><code class="function">g_socket_get_available_bytes()</code></a> first and then doing a receive of
 exactly the right size.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.27.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.28.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2342,12 +2455,11 @@ exactly the right size.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.27.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.28.8"></a><h4>Returns</h4>
 <p> the number of bytes that can be read from the socket
 without blocking or truncating, or -1 on error.</p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2362,8 +2474,8 @@ on time then the new connections will be refused.</p>
 <p>Note that this must be called before <a class="link" href="GSocket.html#g-socket-listen" title="g_socket_listen ()"><code class="function">g_socket_listen()</code></a> and has no
 effect if called after that.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.28.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.29.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2383,7 +2495,7 @@ effect if called after that.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2393,8 +2505,8 @@ g_socket_get_listen_backlog (<em class="parameter"><code><a class="link" href="G
 <p>Gets the listen backlog setting of the socket. For details on this,
 see <a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_socket_set_listen_backlog ()"><code class="function">g_socket_set_listen_backlog()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.29.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.30.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2408,11 +2520,10 @@ see <a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_soc
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.29.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.30.6"></a><h4>Returns</h4>
 <p> the maximum number of pending connections.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2422,8 +2533,8 @@ g_socket_get_blocking (<em class="parameter"><code><a class="link" href="GSocket
 <p>Gets the blocking mode of the socket. For details on blocking I/O,
 see <a class="link" href="GSocket.html#g-socket-set-blocking" title="g_socket_set_blocking ()"><code class="function">g_socket_set_blocking()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.30.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.31.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2437,11 +2548,10 @@ see <a class="link" href="GSocket.html#g-socket-set-blocking" title="g_socket_se
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.30.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.31.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if blocking I/O is used, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2450,15 +2560,16 @@ see <a class="link" href="GSocket.html#g-socket-set-blocking" title="g_socket_se
 g_socket_set_blocking (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
                        <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> blocking</code></em>);</pre>
 <p>Sets the blocking mode of the socket. In blocking mode
-all operations block until they succeed or there is an error. In
+all operations (which don’t take an explicit blocking parameter) block until
+they succeed or there is an error. In
 non-blocking mode all functions return results immediately or
 with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error.</p>
 <p>All sockets are created in blocking mode. However, note that the
 platform level socket is always non-blocking, and blocking mode
 is a GSocket level feature.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.31.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.32.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2478,7 +2589,7 @@ is a GSocket level feature.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2488,8 +2599,8 @@ g_socket_get_keepalive (<em class="parameter"><code><a class="link" href="GSocke
 <p>Gets the keepalive mode of the socket. For details on this,
 see <a class="link" href="GSocket.html#g-socket-set-keepalive" title="g_socket_set_keepalive ()"><code class="function">g_socket_set_keepalive()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.32.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.33.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2503,11 +2614,10 @@ see <a class="link" href="GSocket.html#g-socket-set-keepalive" title="g_socket_s
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.32.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.33.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if keepalive is active, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2529,8 +2639,8 @@ on a server socket if you want to allow clients to remain idle for long
 periods of time, but also want to ensure that connections are eventually
 garbage-collected if clients crash or become unreachable.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.33.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.34.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2550,7 +2660,7 @@ garbage-collected if clients crash or become unreachable.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2560,8 +2670,8 @@ g_socket_get_timeout (<em class="parameter"><code><a class="link" href="GSocket.
 <p>Gets the timeout setting of the socket. For details on this, see
 <a class="link" href="GSocket.html#g-socket-set-timeout" title="g_socket_set_timeout ()"><code class="function">g_socket_set_timeout()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.34.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.35.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2575,11 +2685,10 @@ g_socket_get_timeout (<em class="parameter"><code><a class="link" href="GSocket.
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.34.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.35.6"></a><h4>Returns</h4>
 <p> the timeout in seconds</p>
-<p></p>
 </div>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2608,8 +2717,8 @@ on their own.</p>
 <p>Note that if an I/O operation is interrupted by a signal, this may
 cause the timeout to be reset.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.35.9"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.36.9"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2630,7 +2739,7 @@ cause the timeout to be reset.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2642,8 +2751,8 @@ g_socket_set_ttl (<em class="parameter"><code><a class="link" href="GSocket.html
 .
 By default the platform-specific default value is used.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.36.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.37.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2664,7 +2773,7 @@ By default the platform-specific default value is used.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2675,8 +2784,8 @@ g_socket_get_ttl (<em class="parameter"><code><a class="link" href="GSocket.html
 ; see
 <a class="link" href="GSocket.html#g-socket-set-ttl" title="g_socket_set_ttl ()"><code class="function">g_socket_set_ttl()</code></a> for more details.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.37.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.38.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2690,12 +2799,11 @@ g_socket_get_ttl (<em class="parameter"><code><a class="link" href="GSocket.html
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.37.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.38.6"></a><h4>Returns</h4>
 <p> the time-to-live setting on <em class="parameter"><code>socket</code></em>
 </p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2707,8 +2815,8 @@ g_socket_get_broadcast (<em class="parameter"><code><a class="link" href="GSocke
 it is possible to send packets to broadcast
 addresses.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.38.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.39.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2722,12 +2830,11 @@ addresses.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.38.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.39.6"></a><h4>Returns</h4>
 <p> the broadcast setting on <em class="parameter"><code>socket</code></em>
 </p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2739,8 +2846,8 @@ g_socket_set_broadcast (<em class="parameter"><code><a class="link" href="GSocke
  should allow sending to broadcast addresses.
 This is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> by default.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.39.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.40.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2762,7 +2869,7 @@ addresses</p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2787,8 +2894,8 @@ headers.</p>
  is still a pointer to a <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> variable, not a <a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>;
 <a class="link" href="GSocket.html#g-socket-get-option" title="g_socket_get_option ()"><code class="function">g_socket_get_option()</code></a> will handle the conversion internally.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.40.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.41.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2824,14 +2931,13 @@ headers.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.40.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.41.8"></a><h4>Returns</h4>
 <p> success or failure. On failure, <em class="parameter"><code>error</code></em>
 will be set, and
 the system error value (<code class="literal">errno</code> or <code class="function">WSAGetLastError()</code>) will still
 be set to the result of the <code class="function">getsockopt()</code> call.</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2852,8 +2958,8 @@ standard/portable socket options. For unusual socket protocols or
 platform-dependent options, you may need to include additional
 headers.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.41.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.42.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2889,14 +2995,13 @@ headers.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.41.7"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.42.7"></a><h4>Returns</h4>
 <p> success or failure. On failure, <em class="parameter"><code>error</code></em>
 will be set, and
 the system error value (<code class="literal">errno</code> or <code class="function">WSAGetLastError()</code>) will still
 be set to the result of the <code class="function">setsockopt()</code> call.</p>
-<p></p>
 </div>
-<p class="since">Since 2.36</p>
+<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2905,8 +3010,8 @@ be set to the result of the <code class="function">setsockopt()</code> call.</p>
 g_socket_get_family (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
 <p>Gets the socket family of the socket.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.42.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.43.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2920,11 +3025,10 @@ g_socket_get_family (<em class="parameter"><code><a class="link" href="GSocket.h
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.42.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.43.6"></a><h4>Returns</h4>
 <p> a <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2937,8 +3041,8 @@ a Winsock2 SOCKET handle. This may be useful for
 doing platform specific or otherwise unusual operations
 on the socket.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.43.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.44.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2952,11 +3056,10 @@ on the socket.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.43.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.44.6"></a><h4>Returns</h4>
 <p> the file descriptor of the socket.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2968,8 +3071,8 @@ g_socket_get_local_address (<em class="parameter"><code><a class="link" href="GS
 useful if the socket has been bound to a local address,
 either explicitly or implicitly when connecting.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.44.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.45.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -2990,12 +3093,12 @@ either explicitly or implicitly when connecting.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.44.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.45.6"></a><h4>Returns</h4>
 <p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3005,8 +3108,8 @@ g_socket_get_protocol (<em class="parameter"><code><a class="link" href="GSocket
 <p>Gets the socket protocol id the socket was created with.
 In case the protocol is unknown, -1 is returned.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.45.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.46.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3020,11 +3123,10 @@ In case the protocol is unknown, -1 is returned.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.45.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.46.6"></a><h4>Returns</h4>
 <p> a protocol id, or -1 if unknown</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3035,8 +3137,8 @@ g_socket_get_remote_address (<em class="parameter"><code><a class="link" href="G
 <p>Try to get the remove address of a connected socket. This is only
 useful for connection oriented sockets that have been connected.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.46.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.47.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3057,12 +3159,12 @@ useful for connection oriented sockets that have been connected.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.46.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.47.6"></a><h4>Returns</h4>
 <p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3071,8 +3173,8 @@ Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.h
 g_socket_get_socket_type (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
 <p>Gets the socket type of the socket.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.47.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.48.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3086,11 +3188,10 @@ g_socket_get_socket_type (<em class="parameter"><code><a class="link" href="GSoc
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.47.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.48.6"></a><h4>Returns</h4>
 <p> a <a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a></p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3105,8 +3206,8 @@ information.</p>
 <p>No other types of sockets are currently considered as being capable
 of speaking IPv4.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.48.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.49.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3120,11 +3221,10 @@ of speaking IPv4.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.48.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.49.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if this socket can be used with IPv4.</p>
-<p></p>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3143,8 +3243,8 @@ by reading the <code class="literal">SO_PEERCRED</code> option on the underlying
 <a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials" title="g_unix_connection_send_credentials ()"><code class="function">g_unix_connection_send_credentials()</code></a> /
 <a class="link" href="GUnixConnection.html#g-unix-connection-receive-credentials" title="g_unix_connection_receive_credentials ()"><code class="function">g_unix_connection_receive_credentials()</code></a> functions.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.49.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.50.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3165,13 +3265,13 @@ by reading the <code class="literal">SO_PEERCRED</code> option on the underlying
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.49.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.50.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 is set, otherwise a <a class="link" href="GCredentials.html" title="GCredentials"><span class="type">GCredentials</span></a> object
 that must be freed with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3198,8 +3298,8 @@ to bind to based on <em class="parameter"><code>group</code></em>
 in RFC 4604 is used. Note that on older platforms this may fail
 with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a> error.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.50.7"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.51.7"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3235,11 +3335,10 @@ with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><c
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.50.8"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.51.8"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3261,8 +3360,8 @@ when you joined the group).</p>
  remains bound to its address and port, and can still receive
 unicast messages after calling this.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.51.6"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.52.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3298,11 +3397,10 @@ unicast messages after calling this.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.51.7"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.52.7"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3314,8 +3412,8 @@ g_socket_get_multicast_loopback (<em class="parameter"><code><a class="link" hre
 default), outgoing multicast packets will be looped back to
 multicast listeners on the same host.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.52.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.53.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3329,12 +3427,11 @@ multicast listeners on the same host.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.52.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.53.6"></a><h4>Returns</h4>
 <p> the multicast loopback setting on <em class="parameter"><code>socket</code></em>
 </p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3346,8 +3443,8 @@ g_socket_set_multicast_loopback (<em class="parameter"><code><a class="link" hre
 listening on that multicast address on the same host. This is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
 by default.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.53.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.54.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3369,7 +3466,7 @@ multicast groups from the local host</p></td>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3380,8 +3477,8 @@ g_socket_get_multicast_ttl (<em class="parameter"><code><a class="link" href="GS
 ; see
 <a class="link" href="GSocket.html#g-socket-set-multicast-ttl" title="g_socket_set_multicast_ttl ()"><code class="function">g_socket_set_multicast_ttl()</code></a> for more details.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.54.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.55.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3395,12 +3492,11 @@ g_socket_get_multicast_ttl (<em class="parameter"><code><a class="link" href="GS
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.54.6"></a><h4>Returns</h4>
+<a name="id-1.4.13.2.10.55.6"></a><h4>Returns</h4>
 <p> the multicast time-to-live setting on <em class="parameter"><code>socket</code></em>
 </p>
-<p></p>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3413,8 +3509,8 @@ g_socket_set_multicast_ttl (<em class="parameter"><code><a class="link" href="GS
 By default, this is 1, meaning that multicast packets will not leave
 the local network.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.10.55.5"></a><h4>Parameters</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.10.56.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
 <col class="parameters_description">
@@ -3435,7 +3531,7 @@ the local network.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -3444,7 +3540,7 @@ the local network.</p>
 <a name="GSocket-struct"></a><h3>GSocket</h3>
 <pre class="programlisting">typedef struct _GSocket GSocket;</pre>
 <p>A lowlevel network socket object.</p>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3453,7 +3549,7 @@ the local network.</p>
 all the socket types.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.11.3.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -3493,7 +3589,7 @@ all the socket types.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3506,7 +3602,7 @@ can also pass any other identifiers handled by the platform in order to
 use protocols not listed here.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.11.4.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -3551,7 +3647,7 @@ use protocols not listed here.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3563,7 +3659,7 @@ are passed in/out as is. So to use a platform specific flag, just include
 the right system header and pass in the flag.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.11.5.4"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
 <col class="enum_members_description">
@@ -3603,7 +3699,7 @@ the right system header and pass in the flag.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3619,7 +3715,7 @@ and the operation will store the read data starting in the
 first buffer, switching to the next as needed.</p>
 <div class="refsect3">
 <a name="id-1.4.13.2.11.6.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -3640,7 +3736,101 @@ first buffer, switching to the next as needed.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GInputMessage"></a><h3>struct GInputMessage</h3>
+<pre class="programlisting">struct GInputMessage {
+  GSocketAddress         **address;
+  GInputVector            *vectors;
+  guint                    num_vectors;
+  gsize                    bytes_received;
+  gint                     flags;
+  GSocketControlMessage ***control_messages;
+  guint                   *num_control_messages;
+};
+</pre>
+<p>Structure used for scatter/gather data input when receiving multiple
+messages or packets in one go. You generally pass in an array of empty
+<a href="GSocket.html#GInputVector"><span class="type">GInputVectors</span></a> and the operation will use all the buffers as if they
+were one buffer, and will set <em class="parameter"><code>bytes_received</code></em>
+ to the total number of bytes
+received across all <a href="GSocket.html#GInputVector"><span class="type">GInputVectors</span></a>.</p>
+<p>This structure closely mirrors <code class="literal">struct mmsghdr</code> and <code class="literal">struct msghdr</code> from
+the POSIX sockets API (see <code class="literal">man 2 recvmmsg</code>).</p>
+<p>If <em class="parameter"><code>address</code></em>
+ is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is set to the source address the message
+was received from, and the caller must free it afterwards.</p>
+<p>If <em class="parameter"><code>control_messages</code></em>
+ is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is set to an array of control
+messages received with the message (if any), and the caller must free it
+afterwards. <em class="parameter"><code>num_control_messages</code></em>
+ is set to the number of elements in
+this array, which may be zero.</p>
+<p>Flags relevant to this message will be returned in <em class="parameter"><code>flags</code></em>
+. For example,
+<code class="literal">MSG_EOR</code> or <code class="literal">MSG_TRUNC</code>.</p>
+<div class="refsect3">
+<a name="id-1.4.13.2.11.7.9"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="300px" class="struct_members_name">
+<col class="struct_members_description">
+<col width="200px" class="struct_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="struct_member_name"><p><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> **<em class="structfield"><code><a name="GInputMessage.address"></a>address</code></em>;</p></td>
+<td class="struct_member_description"><p> return location
+for a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
+<td class="struct_member_annotations"><span class="annotation">[<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><a class="link" href="GSocket.html#GInputVector" title="struct GInputVector"><span class="type">GInputVector</span></a> *<em class="structfield"><code><a name="GInputMessage.vectors"></a>vectors</code></em>;</p></td>
+<td class="struct_member_description"><p> pointer to an
+array of input vectors. </p></td>
+<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_vectors][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GInputMessage.num-vectors"></a>num_vectors</code></em>;</p></td>
+<td class="struct_member_description"><p>the number of input vectors pointed to by <em class="parameter"><code>vectors</code></em>
+</p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> <em class="structfield"><code><a name="GInputMessage.bytes-received"></a>bytes_received</code></em>;</p></td>
+<td class="struct_member_description"><p> will be set to the number of bytes that have been
+received. </p></td>
+<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GInputMessage.flags"></a>flags</code></em>;</p></td>
+<td class="struct_member_description"><p> collection of <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> for the received message,
+outputted by the call. </p></td>
+<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> ***<em class="structfield"><code><a name="GInputMessage.control-messages"></a>control_messages</code></em>;</p></td>
+<td class="struct_member_description"><p>(array length=num_control_messages) (optional)
+(out) (transfer full): return location for a
+caller-allocated array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *<em class="structfield"><code><a name="GInputMessage.num-control-messages"></a>num_control_messages</code></em>;</p></td>
+<td class="struct_member_description"><p> return location for the number of
+elements in <em class="parameter"><code>control_messages</code></em>
+. </p></td>
+<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-48.html#api-index-2.48">2.48</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3655,8 +3845,8 @@ You generally pass in an array of <a href="GSocket.html#GOutputVector"><span cla
 and the operation will use all the buffers as if they were
 one buffer.</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.11.7.5"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.11.8.5"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -3677,7 +3867,7 @@ one buffer.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.22</p>
+<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3702,8 +3892,8 @@ were one buffer.</p>
  is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the message is sent to the default receiver
 (as previously set by <a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()"><code class="function">g_socket_connect()</code></a>).</p>
 <div class="refsect3">
-<a name="id-1.4.13.2.11.8.6"></a><h4>Members</h4>
-<div class="informaltable"><table width="100%" border="0">
+<a name="id-1.4.13.2.11.9.6"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="300px" class="struct_members_name">
 <col class="struct_members_description">
@@ -3747,7 +3937,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 2.44</p>
+<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
 </div>
 </div>
 <div class="refsect1">
@@ -3766,7 +3956,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 <p>Whether the socket should allow sending to broadcast addresses.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: FALSE</p>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3815,7 +4005,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 <p>Whether outgoing multicast packets loop back to the local host.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: TRUE</p>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3824,7 +4014,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 <p>Time-to-live out outgoing multicast packets</p>
 <p>Flags: Read / Write</p>
 <p>Default value: 1</p>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3848,7 +4038,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 <p>The timeout in seconds on socket I/O</p>
 <p>Flags: Read / Write</p>
 <p>Default value: 0</p>
-<p class="since">Since 2.26</p>
+<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3857,7 +4047,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 <p>Time-to-live for outgoing unicast packets</p>
 <p>Flags: Read / Write</p>
 <p>Default value: 0</p>
-<p class="since">Since 2.32</p>
+<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3874,7 +4064,6 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21.1</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>