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

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>