PageRenderTime 63ms CodeModel.GetById 15ms RepoModel.GetById 0ms app.codeStats 0ms

/docs/reference/gio/html/GSocketClient.html

https://gitlab.com/ImageMagick/glib
HTML | 2070 lines | 2068 code | 2 blank | 0 comment | 0 complexity | a0ba2450f919f8b86a3136f1c823e639 MD5 | raw file
Possible License(s): LGPL-2.1, AGPL-3.0 
    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    5. 

  5. <title>GSocketClient: GIO Reference Manual</title>
    6. 

  6. <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
    7. 

  7. <link rel="home" href="index.html" title="GIO Reference Manual">
    8. 

  8. <link rel="up" href="highlevel-socket.html" title="High-level network functionallity">
    9. 

  9. <link rel="prev" href="highlevel-socket.html" title="High-level network functionallity">
    10. 

  10. <link rel="next" href="GSocketConnection.html" title="GSocketConnection">
    11. 

  11. <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
    12. 

  12. <link rel="stylesheet" href="style.css" type="text/css">
    13. 

  13. </head>
    14. 

  14. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    15. 

  15. <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
    16. 

  16. <td width="100%" align="left" class="shortcuts">
    17. 

  17. <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
    18. 

  18.                   <a href="#GSocketClient.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
    19. 

  19.                   <a href="#GSocketClient.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties">  <span class="dim">|</span> 
    20. 

  20.                   <a href="#GSocketClient.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
    21. 

  21.                   <a href="#GSocketClient.signals" class="shortcut">Signals</a></span>
    22. 

  22. </td>
    23. 

  23. <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
    24. 

  24. <td><a accesskey="u" href="highlevel-socket.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
    25. 

  25. <td><a accesskey="p" href="highlevel-socket.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
    26. 

  26. <td><a accesskey="n" href="GSocketConnection.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
    27. 

  27. </tr></table>
    28. 

  28. <div class="refentry">
    29. 

  29. <a name="GSocketClient"></a><div class="titlepage"></div>
    30. 

  30. <div class="refnamediv"><table width="100%"><tr>
    31. 

  31. <td valign="top">
    32. 

  32. <h2><span class="refentrytitle"><a name="GSocketClient.top_of_page"></a>GSocketClient</span></h2>
    33. 

  33. <p>GSocketClient — Helper for connecting to a network service</p>
    34. 

  34. </td>
    35. 

  35. <td class="gallery_image" valign="top" align="right"></td>
    36. 

  36. </tr></table></div>
    37. 

  37. <div class="refsect1">
    38. 

  38. <a name="GSocketClient.functions"></a><h2>Functions</h2>
    39. 

  39. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    40. 

  40. <colgroup>
    41. 

  41. <col width="150px" class="functions_return">
    42. 

  42. <col class="functions_name">
    43. 

  43. </colgroup>
    44. 

  44. <tbody>
    45. 

  45. <tr>
    46. 

  46. <td class="function_type">
    47. 

  47. <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="returnvalue">GSocketClient</span></a> *
    48. 

  48. </td>
    49. 

  49. <td class="function_name">
    50. 

  50. <a class="link" href="GSocketClient.html#g-socket-client-new" title="g_socket_client_new ()">g_socket_client_new</a> <span class="c_punctuation">()</span>
    51. 

  51. </td>
    52. 

  52. </tr>
    53. 

  53. <tr>
    54. 

  54. <td class="function_type">
    55. 

  55. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    56. 

  56. </td>
    57. 

  57. <td class="function_name">
    58. 

  58. <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()">g_socket_client_connect</a> <span class="c_punctuation">()</span>
    59. 

  59. </td>
    60. 

  60. </tr>
    61. 

  61. <tr>
    62. 

  62. <td class="function_type">
    63. 

  63. <span class="returnvalue">void</span>
    64. 

  64. </td>
    65. 

  65. <td class="function_name">
    66. 

  66. <a class="link" href="GSocketClient.html#g-socket-client-connect-async" title="g_socket_client_connect_async ()">g_socket_client_connect_async</a> <span class="c_punctuation">()</span>
    67. 

  67. </td>
    68. 

  68. </tr>
    69. 

  69. <tr>
    70. 

  70. <td class="function_type">
    71. 

  71. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    72. 

  72. </td>
    73. 

  73. <td class="function_name">
    74. 

  74. <a class="link" href="GSocketClient.html#g-socket-client-connect-finish" title="g_socket_client_connect_finish ()">g_socket_client_connect_finish</a> <span class="c_punctuation">()</span>
    75. 

  75. </td>
    76. 

  76. </tr>
    77. 

  77. <tr>
    78. 

  78. <td class="function_type">
    79. 

  79. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    80. 

  80. </td>
    81. 

  81. <td class="function_name">
    82. 

  82. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host" title="g_socket_client_connect_to_host ()">g_socket_client_connect_to_host</a> <span class="c_punctuation">()</span>
    83. 

  83. </td>
    84. 

  84. </tr>
    85. 

  85. <tr>
    86. 

  86. <td class="function_type">
    87. 

  87. <span class="returnvalue">void</span>
    88. 

  88. </td>
    89. 

  89. <td class="function_name">
    90. 

  90. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-async" title="g_socket_client_connect_to_host_async ()">g_socket_client_connect_to_host_async</a> <span class="c_punctuation">()</span>
    91. 

  91. </td>
    92. 

  92. </tr>
    93. 

  93. <tr>
    94. 

  94. <td class="function_type">
    95. 

  95. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    96. 

  96. </td>
    97. 

  97. <td class="function_name">
    98. 

  98. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-finish" title="g_socket_client_connect_to_host_finish ()">g_socket_client_connect_to_host_finish</a> <span class="c_punctuation">()</span>
    99. 

  99. </td>
    100. 

  100. </tr>
    101. 

  101. <tr>
    102. 

  102. <td class="function_type">
    103. 

  103. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    104. 

  104. </td>
    105. 

  105. <td class="function_name">
    106. 

  106. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service" title="g_socket_client_connect_to_service ()">g_socket_client_connect_to_service</a> <span class="c_punctuation">()</span>
    107. 

  107. </td>
    108. 

  108. </tr>
    109. 

  109. <tr>
    110. 

  110. <td class="function_type">
    111. 

  111. <span class="returnvalue">void</span>
    112. 

  112. </td>
    113. 

  113. <td class="function_name">
    114. 

  114. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service-async" title="g_socket_client_connect_to_service_async ()">g_socket_client_connect_to_service_async</a> <span class="c_punctuation">()</span>
    115. 

  115. </td>
    116. 

  116. </tr>
    117. 

  117. <tr>
    118. 

  118. <td class="function_type">
    119. 

  119. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    120. 

  120. </td>
    121. 

  121. <td class="function_name">
    122. 

  122. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service-finish" title="g_socket_client_connect_to_service_finish ()">g_socket_client_connect_to_service_finish</a> <span class="c_punctuation">()</span>
    123. 

  123. </td>
    124. 

  124. </tr>
    125. 

  125. <tr>
    126. 

  126. <td class="function_type">
    127. 

  127. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    128. 

  128. </td>
    129. 

  129. <td class="function_name">
    130. 

  130. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri" title="g_socket_client_connect_to_uri ()">g_socket_client_connect_to_uri</a> <span class="c_punctuation">()</span>
    131. 

  131. </td>
    132. 

  132. </tr>
    133. 

  133. <tr>
    134. 

  134. <td class="function_type">
    135. 

  135. <span class="returnvalue">void</span>
    136. 

  136. </td>
    137. 

  137. <td class="function_name">
    138. 

  138. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri-async" title="g_socket_client_connect_to_uri_async ()">g_socket_client_connect_to_uri_async</a> <span class="c_punctuation">()</span>
    139. 

  139. </td>
    140. 

  140. </tr>
    141. 

  141. <tr>
    142. 

  142. <td class="function_type">
    143. 

  143. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    144. 

  144. </td>
    145. 

  145. <td class="function_name">
    146. 

  146. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri-finish" title="g_socket_client_connect_to_uri_finish ()">g_socket_client_connect_to_uri_finish</a> <span class="c_punctuation">()</span>
    147. 

  147. </td>
    148. 

  148. </tr>
    149. 

  149. <tr>
    150. 

  150. <td class="function_type">
    151. 

  151. <span class="returnvalue">void</span>
    152. 

  152. </td>
    153. 

  153. <td class="function_name">
    154. 

  154. <a class="link" href="GSocketClient.html#g-socket-client-set-family" title="g_socket_client_set_family ()">g_socket_client_set_family</a> <span class="c_punctuation">()</span>
    155. 

  155. </td>
    156. 

  156. </tr>
    157. 

  157. <tr>
    158. 

  158. <td class="function_type">
    159. 

  159. <span class="returnvalue">void</span>
    160. 

  160. </td>
    161. 

  161. <td class="function_name">
    162. 

  162. <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()">g_socket_client_set_local_address</a> <span class="c_punctuation">()</span>
    163. 

  163. </td>
    164. 

  164. </tr>
    165. 

  165. <tr>
    166. 

  166. <td class="function_type">
    167. 

  167. <span class="returnvalue">void</span>
    168. 

  168. </td>
    169. 

  169. <td class="function_name">
    170. 

  170. <a class="link" href="GSocketClient.html#g-socket-client-set-protocol" title="g_socket_client_set_protocol ()">g_socket_client_set_protocol</a> <span class="c_punctuation">()</span>
    171. 

  171. </td>
    172. 

  172. </tr>
    173. 

  173. <tr>
    174. 

  174. <td class="function_type">
    175. 

  175. <span class="returnvalue">void</span>
    176. 

  176. </td>
    177. 

  177. <td class="function_name">
    178. 

  178. <a class="link" href="GSocketClient.html#g-socket-client-set-socket-type" title="g_socket_client_set_socket_type ()">g_socket_client_set_socket_type</a> <span class="c_punctuation">()</span>
    179. 

  179. </td>
    180. 

  180. </tr>
    181. 

  181. <tr>
    182. 

  182. <td class="function_type">
    183. 

  183. <span class="returnvalue">void</span>
    184. 

  184. </td>
    185. 

  185. <td class="function_name">
    186. 

  186. <a class="link" href="GSocketClient.html#g-socket-client-set-timeout" title="g_socket_client_set_timeout ()">g_socket_client_set_timeout</a> <span class="c_punctuation">()</span>
    187. 

  187. </td>
    188. 

  188. </tr>
    189. 

  189. <tr>
    190. 

  190. <td class="function_type">
    191. 

  191. <span class="returnvalue">void</span>
    192. 

  192. </td>
    193. 

  193. <td class="function_name">
    194. 

  194. <a class="link" href="GSocketClient.html#g-socket-client-set-enable-proxy" title="g_socket_client_set_enable_proxy ()">g_socket_client_set_enable_proxy</a> <span class="c_punctuation">()</span>
    195. 

  195. </td>
    196. 

  196. </tr>
    197. 

  197. <tr>
    198. 

  198. <td class="function_type">
    199. 

  199. <span class="returnvalue">void</span>
    200. 

  200. </td>
    201. 

  201. <td class="function_name">
    202. 

  202. <a class="link" href="GSocketClient.html#g-socket-client-set-proxy-resolver" title="g_socket_client_set_proxy_resolver ()">g_socket_client_set_proxy_resolver</a> <span class="c_punctuation">()</span>
    203. 

  203. </td>
    204. 

  204. </tr>
    205. 

  205. <tr>
    206. 

  206. <td class="function_type">
    207. 

  207. <span class="returnvalue">void</span>
    208. 

  208. </td>
    209. 

  209. <td class="function_name">
    210. 

  210. <a class="link" href="GSocketClient.html#g-socket-client-set-tls" title="g_socket_client_set_tls ()">g_socket_client_set_tls</a> <span class="c_punctuation">()</span>
    211. 

  211. </td>
    212. 

  212. </tr>
    213. 

  213. <tr>
    214. 

  214. <td class="function_type">
    215. 

  215. <span class="returnvalue">void</span>
    216. 

  216. </td>
    217. 

  217. <td class="function_name">
    218. 

  218. <a class="link" href="GSocketClient.html#g-socket-client-set-tls-validation-flags" title="g_socket_client_set_tls_validation_flags ()">g_socket_client_set_tls_validation_flags</a> <span class="c_punctuation">()</span>
    219. 

  219. </td>
    220. 

  220. </tr>
    221. 

  221. <tr>
    222. 

  222. <td class="function_type">
    223. 

  223. <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="returnvalue">GSocketFamily</span></a>
    224. 

  224. </td>
    225. 

  225. <td class="function_name">
    226. 

  226. <a class="link" href="GSocketClient.html#g-socket-client-get-family" title="g_socket_client_get_family ()">g_socket_client_get_family</a> <span class="c_punctuation">()</span>
    227. 

  227. </td>
    228. 

  228. </tr>
    229. 

  229. <tr>
    230. 

  230. <td class="function_type">
    231. 

  231. <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="returnvalue">GSocketAddress</span></a> *
    232. 

  232. </td>
    233. 

  233. <td class="function_name">
    234. 

  234. <a class="link" href="GSocketClient.html#g-socket-client-get-local-address" title="g_socket_client_get_local_address ()">g_socket_client_get_local_address</a> <span class="c_punctuation">()</span>
    235. 

  235. </td>
    236. 

  236. </tr>
    237. 

  237. <tr>
    238. 

  238. <td class="function_type">
    239. 

  239. <a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="returnvalue">GSocketProtocol</span></a>
    240. 

  240. </td>
    241. 

  241. <td class="function_name">
    242. 

  242. <a class="link" href="GSocketClient.html#g-socket-client-get-protocol" title="g_socket_client_get_protocol ()">g_socket_client_get_protocol</a> <span class="c_punctuation">()</span>
    243. 

  243. </td>
    244. 

  244. </tr>
    245. 

  245. <tr>
    246. 

  246. <td class="function_type">
    247. 

  247. <a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="returnvalue">GSocketType</span></a>
    248. 

  248. </td>
    249. 

  249. <td class="function_name">
    250. 

  250. <a class="link" href="GSocketClient.html#g-socket-client-get-socket-type" title="g_socket_client_get_socket_type ()">g_socket_client_get_socket_type</a> <span class="c_punctuation">()</span>
    251. 

  251. </td>
    252. 

  252. </tr>
    253. 

  253. <tr>
    254. 

  254. <td class="function_type">
    255. 

  255. <a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
    256. 

  256. </td>
    257. 

  257. <td class="function_name">
    258. 

  258. <a class="link" href="GSocketClient.html#g-socket-client-get-timeout" title="g_socket_client_get_timeout ()">g_socket_client_get_timeout</a> <span class="c_punctuation">()</span>
    259. 

  259. </td>
    260. 

  260. </tr>
    261. 

  261. <tr>
    262. 

  262. <td class="function_type">
    263. 

  263. <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
    264. 

  264. </td>
    265. 

  265. <td class="function_name">
    266. 

  266. <a class="link" href="GSocketClient.html#g-socket-client-get-enable-proxy" title="g_socket_client_get_enable_proxy ()">g_socket_client_get_enable_proxy</a> <span class="c_punctuation">()</span>
    267. 

  267. </td>
    268. 

  268. </tr>
    269. 

  269. <tr>
    270. 

  270. <td class="function_type">
    271. 

  271. <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="returnvalue">GProxyResolver</span></a> *
    272. 

  272. </td>
    273. 

  273. <td class="function_name">
    274. 

  274. <a class="link" href="GSocketClient.html#g-socket-client-get-proxy-resolver" title="g_socket_client_get_proxy_resolver ()">g_socket_client_get_proxy_resolver</a> <span class="c_punctuation">()</span>
    275. 

  275. </td>
    276. 

  276. </tr>
    277. 

  277. <tr>
    278. 

  278. <td class="function_type">
    279. 

  279. <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
    280. 

  280. </td>
    281. 

  281. <td class="function_name">
    282. 

  282. <a class="link" href="GSocketClient.html#g-socket-client-get-tls" title="g_socket_client_get_tls ()">g_socket_client_get_tls</a> <span class="c_punctuation">()</span>
    283. 

  283. </td>
    284. 

  284. </tr>
    285. 

  285. <tr>
    286. 

  286. <td class="function_type">
    287. 

  287. <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a>
    288. 

  288. </td>
    289. 

  289. <td class="function_name">
    290. 

  290. <a class="link" href="GSocketClient.html#g-socket-client-get-tls-validation-flags" title="g_socket_client_get_tls_validation_flags ()">g_socket_client_get_tls_validation_flags</a> <span class="c_punctuation">()</span>
    291. 

  291. </td>
    292. 

  292. </tr>
    293. 

  293. <tr>
    294. 

  294. <td class="function_type">
    295. 

  295. <span class="returnvalue">void</span>
    296. 

  296. </td>
    297. 

  297. <td class="function_name">
    298. 

  298. <a class="link" href="GSocketClient.html#g-socket-client-add-application-proxy" title="g_socket_client_add_application_proxy ()">g_socket_client_add_application_proxy</a> <span class="c_punctuation">()</span>
    299. 

  299. </td>
    300. 

  300. </tr>
    301. 

  301. </tbody>
    302. 

  302. </table></div>
    303. 

  303. </div>
    304. 

  304. <div class="refsect1">
    305. 

  305. <a name="GSocketClient.properties"></a><h2>Properties</h2>
    306. 

  306. <div class="informaltable"><table class="informaltable" border="0">
    307. 

  307. <colgroup>
    308. 

  308. <col width="150px" class="properties_type">
    309. 

  309. <col width="300px" class="properties_name">
    310. 

  310. <col width="200px" class="properties_flags">
    311. 

  311. </colgroup>
    312. 

  312. <tbody>
    313. 

  313. <tr>
    314. 

  314. <td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
    315. 

  315. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--enable-proxy" title="The “enable-proxy” property">enable-proxy</a></td>
    316. 

  316. <td class="property_flags">Read / Write / Construct</td>
    317. 

  317. </tr>
    318. 

  318. <tr>
    319. 

  319. <td class="property_type"><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></td>
    320. 

  320. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--family" title="The “family” property">family</a></td>
    321. 

  321. <td class="property_flags">Read / Write / Construct</td>
    322. 

  322. </tr>
    323. 

  323. <tr>
    324. 

  324. <td class="property_type">
    325. 

  325. <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *</td>
    326. 

  326. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--local-address" title="The “local-address” property">local-address</a></td>
    327. 

  327. <td class="property_flags">Read / Write / Construct</td>
    328. 

  328. </tr>
    329. 

  329. <tr>
    330. 

  330. <td class="property_type"><a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a></td>
    331. 

  331. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--protocol" title="The “protocol” property">protocol</a></td>
    332. 

  332. <td class="property_flags">Read / Write / Construct</td>
    333. 

  333. </tr>
    334. 

  334. <tr>
    335. 

  335. <td class="property_type">
    336. 

  336. <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> *</td>
    337. 

  337. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--proxy-resolver" title="The “proxy-resolver” property">proxy-resolver</a></td>
    338. 

  338. <td class="property_flags">Read / Write / Construct</td>
    339. 

  339. </tr>
    340. 

  340. <tr>
    341. 

  341. <td class="property_type"><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
    342. 

  342. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--timeout" title="The “timeout” property">timeout</a></td>
    343. 

  343. <td class="property_flags">Read / Write / Construct</td>
    344. 

  344. </tr>
    345. 

  345. <tr>
    346. 

  346. <td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
    347. 

  347. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--tls" title="The “tls” property">tls</a></td>
    348. 

  348. <td class="property_flags">Read / Write / Construct</td>
    349. 

  349. </tr>
    350. 

  350. <tr>
    351. 

  351. <td class="property_type"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a></td>
    352. 

  352. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--tls-validation-flags" title="The “tls-validation-flags” property">tls-validation-flags</a></td>
    353. 

  353. <td class="property_flags">Read / Write / Construct</td>
    354. 

  354. </tr>
    355. 

  355. <tr>
    356. 

  356. <td class="property_type"><a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a></td>
    357. 

  357. <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--type" title="The “type” property">type</a></td>
    358. 

  358. <td class="property_flags">Read / Write / Construct</td>
    359. 

  359. </tr>
    360. 

  360. </tbody>
    361. 

  361. </table></div>
    362. 

  362. </div>
    363. 

  363. <div class="refsect1">
    364. 

  364. <a name="GSocketClient.signals"></a><h2>Signals</h2>
    365. 

  365. <div class="informaltable"><table class="informaltable" border="0">
    366. 

  366. <colgroup>
    367. 

  367. <col width="150px" class="signals_return">
    368. 

  368. <col width="300px" class="signals_name">
    369. 

  369. <col width="200px" class="signals_flags">
    370. 

  370. </colgroup>
    371. 

  371. <tbody><tr>
    372. 

  372. <td class="signal_type"><span class="returnvalue">void</span></td>
    373. 

  373. <td class="signal_name"><a class="link" href="GSocketClient.html#GSocketClient-event" title="The “event” signal">event</a></td>
    374. 

  374. <td class="signal_flags"><a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
    375. 

  375. </tr></tbody>
    376. 

  376. </table></div>
    377. 

  377. </div>
    378. 

  378. <div class="refsect1">
    379. 

  379. <a name="GSocketClient.other"></a><h2>Types and Values</h2>
    380. 

  380. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    381. 

  381. <colgroup>
    382. 

  382. <col width="150px" class="name">
    383. 

  383. <col class="description">
    384. 

  384. </colgroup>
    385. 

  385. <tbody>
    386. 

  386. <tr>
    387. 

  387. <td class="datatype_keyword"> </td>
    388. 

  388. <td class="function_name"><a class="link" href="GSocketClient.html#GSocketClient-struct" title="GSocketClient">GSocketClient</a></td>
    389. 

  389. </tr>
    390. 

  390. <tr>
    391. 

  391. <td class="datatype_keyword">enum</td>
    392. 

  392. <td class="function_name"><a class="link" href="GSocketClient.html#GSocketClientEvent" title="enum GSocketClientEvent">GSocketClientEvent</a></td>
    393. 

  393. </tr>
    394. 

  394. </tbody>
    395. 

  395. </table></div>
    396. 

  396. </div>
    397. 

  397. <div class="refsect1">
    398. 

  398. <a name="GSocketClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
    399. 

  399. <pre class="screen">    <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
    400. 

  400.     <span class="lineart">╰──</span> GSocketClient
    401. 

  401. </pre>
    402. 

  402. </div>
    403. 

  403. <div class="refsect1">
    404. 

  404. <a name="GSocketClient.includes"></a><h2>Includes</h2>
    405. 

  405. <pre class="synopsis">#include &lt;gio/gio.h&gt;
    406. 

  406. </pre>
    407. 

  407. </div>
    408. 

  408. <div class="refsect1">
    409. 

  409. <a name="GSocketClient.description"></a><h2>Description</h2>
    410. 

  410. <p><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> is a lightweight high-level utility class for connecting to
    411. 

  411. a network host using a connection oriented socket type.</p>
    412. 

  412. <p>You create a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> object, set any options you want, and then
    413. 

  413. call a sync or async connect operation, which returns a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>
    414. 

  414. subclass on success.</p>
    415. 

  415. <p>The type of the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> object returned depends on the type of
    416. 

  416. the underlying socket that is in use. For instance, for a TCP/IP connection
    417. 

  417. it will be a <a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a>.</p>
    418. 

  418. <p>As <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> is a lightweight object, you don't need to cache it. You
    419. 

  419. can just create a new one any time you need one.</p>
    420. 

  420. </div>
    421. 

  421. <div class="refsect1">
    422. 

  422. <a name="GSocketClient.functions_details"></a><h2>Functions</h2>
    423. 

  423. <div class="refsect2">
    424. 

  424. <a name="g-socket-client-new"></a><h3>g_socket_client_new ()</h3>
    425. 

  425. <pre class="programlisting"><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="returnvalue">GSocketClient</span></a> *
    426. 

  426. g_socket_client_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
    427. 

  427. <p>Creates a new <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> with the default options.</p>
    428. 

  428. <div class="refsect3">
    429. 

  429. <a name="g-socket-client-new.returns"></a><h4>Returns</h4>
    430. 

  430. <p> a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.
    431. 

  431. Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
    432. 

  432. </div>
    433. 

  433. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    434. 

  434. </div>
    435. 

  435. <hr>
    436. 

  436. <div class="refsect2">
    437. 

  437. <a name="g-socket-client-connect"></a><h3>g_socket_client_connect ()</h3>
    438. 

  438. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    439. 

  439. g_socket_client_connect (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    440. 

  440.                          <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *connectable</code></em>,
    441. 

  441.                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    442. 

  442.                          <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    443. 

  443. <p>Tries to resolve the <em class="parameter"><code>connectable</code></em>
    444. 

  444.  and make a network connection to it.</p>
    445. 

  445. <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
    446. 

  446. and returned.  The caller owns this new object and must drop their
    447. 

  447. reference to it when finished with it.</p>
    448. 

  448. <p>The type of the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> object returned depends on the type of
    449. 

  449. the underlying socket that is used. For instance, for a TCP/IP connection
    450. 

  450. it will be a <a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a>.</p>
    451. 

  451. <p>The socket created will be the same family as the address that the
    452. 

  452. <em class="parameter"><code>connectable</code></em>
    453. 

  453.  resolves to, unless family is set with <a class="link" href="GSocketClient.html#g-socket-client-set-family" title="g_socket_client_set_family ()"><code class="function">g_socket_client_set_family()</code></a>
    454. 

  454. or indirectly via <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()"><code class="function">g_socket_client_set_local_address()</code></a>. The socket type
    455. 

  455. defaults to <a class="link" href="GSocket.html#G-SOCKET-TYPE-STREAM:CAPS"><code class="literal">G_SOCKET_TYPE_STREAM</code></a> but can be set with
    456. 

  456. <a class="link" href="GSocketClient.html#g-socket-client-set-socket-type" title="g_socket_client_set_socket_type ()"><code class="function">g_socket_client_set_socket_type()</code></a>.</p>
    457. 

  457. <p>If a local address is specified with <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()"><code class="function">g_socket_client_set_local_address()</code></a> the
    458. 

  458. socket will be bound to this address before connecting.</p>
    459. 

  459. <div class="refsect3">
    460. 

  460. <a name="g-socket-client-connect.parameters"></a><h4>Parameters</h4>
    461. 

  461. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    462. 

  462. <colgroup>
    463. 

  463. <col width="150px" class="parameters_name">
    464. 

  464. <col class="parameters_description">
    465. 

  465. <col width="200px" class="parameters_annotations">
    466. 

  466. </colgroup>
    467. 

  467. <tbody>
    468. 

  468. <tr>
    469. 

  469. <td class="parameter_name"><p>client</p></td>
    470. 

  470. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    471. 

  471. <td class="parameter_annotations"> </td>
    472. 

  472. </tr>
    473. 

  473. <tr>
    474. 

  474. <td class="parameter_name"><p>connectable</p></td>
    475. 

  475. <td class="parameter_description"><p>a <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> specifying the remote address.</p></td>
    476. 

  476. <td class="parameter_annotations"> </td>
    477. 

  477. </tr>
    478. 

  478. <tr>
    479. 

  479. <td class="parameter_name"><p>cancellable</p></td>
    480. 

  480. <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
    481. 

  481. <td class="parameter_annotations"><span class="annotation">[<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>
    482. 

  482. </tr>
    483. 

  483. <tr>
    484. 

  484. <td class="parameter_name"><p>error</p></td>
    485. 

  485. <td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
    486. 

  486. <td class="parameter_annotations"> </td>
    487. 

  487. </tr>
    488. 

  488. </tbody>
    489. 

  489. </table></div>
    490. 

  490. </div>
    491. 

  491. <div class="refsect3">
    492. 

  492. <a name="g-socket-client-connect.returns"></a><h4>Returns</h4>
    493. 

  493. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    494. 

  494. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    495. 

  495. </div>
    496. 

  496. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    497. 

  497. </div>
    498. 

  498. <hr>
    499. 

  499. <div class="refsect2">
    500. 

  500. <a name="g-socket-client-connect-async"></a><h3>g_socket_client_connect_async ()</h3>
    501. 

  501. <pre class="programlisting"><span class="returnvalue">void</span>
    502. 

  502. g_socket_client_connect_async (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    503. 

  503.                                <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *connectable</code></em>,
    504. 

  504.                                <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    505. 

  505.                                <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
    506. 

  506.                                <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
    507. 

  507. <p>This is the asynchronous version of <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a>.</p>
    508. 

  508. <p>When the operation is finished <em class="parameter"><code>callback</code></em>
    509. 

  509.  will be
    510. 

  510. called. You can then call <a class="link" href="GSocketClient.html#g-socket-client-connect-finish" title="g_socket_client_connect_finish ()"><code class="function">g_socket_client_connect_finish()</code></a> to get
    511. 

  511. the result of the operation.</p>
    512. 

  512. <div class="refsect3">
    513. 

  513. <a name="g-socket-client-connect-async.parameters"></a><h4>Parameters</h4>
    514. 

  514. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    515. 

  515. <colgroup>
    516. 

  516. <col width="150px" class="parameters_name">
    517. 

  517. <col class="parameters_description">
    518. 

  518. <col width="200px" class="parameters_annotations">
    519. 

  519. </colgroup>
    520. 

  520. <tbody>
    521. 

  521. <tr>
    522. 

  522. <td class="parameter_name"><p>client</p></td>
    523. 

  523. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    524. 

  524. <td class="parameter_annotations"> </td>
    525. 

  525. </tr>
    526. 

  526. <tr>
    527. 

  527. <td class="parameter_name"><p>connectable</p></td>
    528. 

  528. <td class="parameter_description"><p>a <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> specifying the remote address.</p></td>
    529. 

  529. <td class="parameter_annotations"> </td>
    530. 

  530. </tr>
    531. 

  531. <tr>
    532. 

  532. <td class="parameter_name"><p>cancellable</p></td>
    533. 

  533. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    534. 

  534. <td class="parameter_annotations"><span class="annotation">[<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>
    535. 

  535. </tr>
    536. 

  536. <tr>
    537. 

  537. <td class="parameter_name"><p>callback</p></td>
    538. 

  538. <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. </p></td>
    539. 

  539. <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
    540. 

  540. </tr>
    541. 

  541. <tr>
    542. 

  542. <td class="parameter_name"><p>user_data</p></td>
    543. 

  543. <td class="parameter_description"><p> user data for the callback. </p></td>
    544. 

  544. <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
    545. 

  545. </tr>
    546. 

  546. </tbody>
    547. 

  547. </table></div>
    548. 

  548. </div>
    549. 

  549. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    550. 

  550. </div>
    551. 

  551. <hr>
    552. 

  552. <div class="refsect2">
    553. 

  553. <a name="g-socket-client-connect-finish"></a><h3>g_socket_client_connect_finish ()</h3>
    554. 

  554. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    555. 

  555. g_socket_client_connect_finish (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    556. 

  556.                                 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
    557. 

  557.                                 <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    558. 

  558. <p>Finishes an async connect operation. See <a class="link" href="GSocketClient.html#g-socket-client-connect-async" title="g_socket_client_connect_async ()"><code class="function">g_socket_client_connect_async()</code></a></p>
    559. 

  559. <div class="refsect3">
    560. 

  560. <a name="g-socket-client-connect-finish.parameters"></a><h4>Parameters</h4>
    561. 

  561. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    562. 

  562. <colgroup>
    563. 

  563. <col width="150px" class="parameters_name">
    564. 

  564. <col class="parameters_description">
    565. 

  565. <col width="200px" class="parameters_annotations">
    566. 

  566. </colgroup>
    567. 

  567. <tbody>
    568. 

  568. <tr>
    569. 

  569. <td class="parameter_name"><p>client</p></td>
    570. 

  570. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    571. 

  571. <td class="parameter_annotations"> </td>
    572. 

  572. </tr>
    573. 

  573. <tr>
    574. 

  574. <td class="parameter_name"><p>result</p></td>
    575. 

  575. <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
    576. 

  576. <td class="parameter_annotations"> </td>
    577. 

  577. </tr>
    578. 

  578. <tr>
    579. 

  579. <td class="parameter_name"><p>error</p></td>
    580. 

  580. <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
    581. 

  581. ignore.</p></td>
    582. 

  582. <td class="parameter_annotations"> </td>
    583. 

  583. </tr>
    584. 

  584. </tbody>
    585. 

  585. </table></div>
    586. 

  586. </div>
    587. 

  587. <div class="refsect3">
    588. 

  588. <a name="g-socket-client-connect-finish.returns"></a><h4>Returns</h4>
    589. 

  589. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    590. 

  590. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    591. 

  591. </div>
    592. 

  592. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    593. 

  593. </div>
    594. 

  594. <hr>
    595. 

  595. <div class="refsect2">
    596. 

  596. <a name="g-socket-client-connect-to-host"></a><h3>g_socket_client_connect_to_host ()</h3>
    597. 

  597. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    598. 

  598. g_socket_client_connect_to_host (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    599. 

  599.                                  <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host_and_port</code></em>,
    600. 

  600.                                  <em class="parameter"><code><a href="../glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
    601. 

  601.                                  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    602. 

  602.                                  <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    603. 

  603. <p>This is a helper function for <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a>.</p>
    604. 

  604. <p>Attempts to create a TCP connection to the named host.</p>
    605. 

  605. <p><em class="parameter"><code>host_and_port</code></em>
    606. 

  606.  may be in any of a number of recognized formats; an IPv6
    607. 

  607. address, an IPv4 address, or a domain name (in which case a DNS
    608. 

  608. lookup is performed).  Quoting with [] is supported for all address
    609. 

  609. types.  A port override may be specified in the usual way with a
    610. 

  610. colon.  Ports may be given as decimal numbers or symbolic names (in
    611. 

  611. which case an /etc/services lookup is performed).</p>
    612. 

  612. <p>If no port override is given in <em class="parameter"><code>host_and_port</code></em>
    613. 

  613.  then <em class="parameter"><code>default_port</code></em>
    614. 

  614.  will be
    615. 

  615. used as the port number to connect to.</p>
    616. 

  616. <p>In general, <em class="parameter"><code>host_and_port</code></em>
    617. 

  617.  is expected to be provided by the user (allowing
    618. 

  618. them to give the hostname, and a port override if necessary) and
    619. 

  619. <em class="parameter"><code>default_port</code></em>
    620. 

  620.  is expected to be provided by the application.</p>
    621. 

  621. <p>In the case that an IP address is given, a single connection
    622. 

  622. attempt is made.  In the case that a name is given, multiple
    623. 

  623. connection attempts may be made, in turn and according to the
    624. 

  624. number of address records in DNS, until a connection succeeds.</p>
    625. 

  625. <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
    626. 

  626. and returned.  The caller owns this new object and must drop their
    627. 

  627. reference to it when finished with it.</p>
    628. 

  628. <p>In the event of any failure (DNS error, service not found, no hosts
    629. 

  629. connectable) <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em>
    630. 

  630.  (if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) is set
    631. 

  631. accordingly.</p>
    632. 

  632. <div class="refsect3">
    633. 

  633. <a name="g-socket-client-connect-to-host.parameters"></a><h4>Parameters</h4>
    634. 

  634. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    635. 

  635. <colgroup>
    636. 

  636. <col width="150px" class="parameters_name">
    637. 

  637. <col class="parameters_description">
    638. 

  638. <col width="200px" class="parameters_annotations">
    639. 

  639. </colgroup>
    640. 

  640. <tbody>
    641. 

  641. <tr>
    642. 

  642. <td class="parameter_name"><p>client</p></td>
    643. 

  643. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    644. 

  644. <td class="parameter_annotations"> </td>
    645. 

  645. </tr>
    646. 

  646. <tr>
    647. 

  647. <td class="parameter_name"><p>host_and_port</p></td>
    648. 

  648. <td class="parameter_description"><p>the name and optionally port of the host to connect to</p></td>
    649. 

  649. <td class="parameter_annotations"> </td>
    650. 

  650. </tr>
    651. 

  651. <tr>
    652. 

  652. <td class="parameter_name"><p>default_port</p></td>
    653. 

  653. <td class="parameter_description"><p>the default port to connect to</p></td>
    654. 

  654. <td class="parameter_annotations"> </td>
    655. 

  655. </tr>
    656. 

  656. <tr>
    657. 

  657. <td class="parameter_name"><p>cancellable</p></td>
    658. 

  658. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    659. 

  659. <td class="parameter_annotations"><span class="annotation">[<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>
    660. 

  660. </tr>
    661. 

  661. <tr>
    662. 

  662. <td class="parameter_name"><p>error</p></td>
    663. 

  663. <td class="parameter_description"><p>a pointer to a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
    664. 

  664. <td class="parameter_annotations"> </td>
    665. 

  665. </tr>
    666. 

  666. </tbody>
    667. 

  667. </table></div>
    668. 

  668. </div>
    669. 

  669. <div class="refsect3">
    670. 

  670. <a name="g-socket-client-connect-to-host.returns"></a><h4>Returns</h4>
    671. 

  671. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    672. 

  672. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    673. 

  673. </div>
    674. 

  674. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    675. 

  675. </div>
    676. 

  676. <hr>
    677. 

  677. <div class="refsect2">
    678. 

  678. <a name="g-socket-client-connect-to-host-async"></a><h3>g_socket_client_connect_to_host_async ()</h3>
    679. 

  679. <pre class="programlisting"><span class="returnvalue">void</span>
    680. 

  680. g_socket_client_connect_to_host_async (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    681. 

  681.                                        <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host_and_port</code></em>,
    682. 

  682.                                        <em class="parameter"><code><a href="../glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
    683. 

  683.                                        <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    684. 

  684.                                        <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
    685. 

  685.                                        <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
    686. 

  686. <p>This is the asynchronous version of <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host" title="g_socket_client_connect_to_host ()"><code class="function">g_socket_client_connect_to_host()</code></a>.</p>
    687. 

  687. <p>When the operation is finished <em class="parameter"><code>callback</code></em>
    688. 

  688.  will be
    689. 

  689. called. You can then call <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-finish" title="g_socket_client_connect_to_host_finish ()"><code class="function">g_socket_client_connect_to_host_finish()</code></a> to get
    690. 

  690. the result of the operation.</p>
    691. 

  691. <div class="refsect3">
    692. 

  692. <a name="g-socket-client-connect-to-host-async.parameters"></a><h4>Parameters</h4>
    693. 

  693. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    694. 

  694. <colgroup>
    695. 

  695. <col width="150px" class="parameters_name">
    696. 

  696. <col class="parameters_description">
    697. 

  697. <col width="200px" class="parameters_annotations">
    698. 

  698. </colgroup>
    699. 

  699. <tbody>
    700. 

  700. <tr>
    701. 

  701. <td class="parameter_name"><p>client</p></td>
    702. 

  702. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    703. 

  703. <td class="parameter_annotations"> </td>
    704. 

  704. </tr>
    705. 

  705. <tr>
    706. 

  706. <td class="parameter_name"><p>host_and_port</p></td>
    707. 

  707. <td class="parameter_description"><p>the name and optionally the port of the host to connect to</p></td>
    708. 

  708. <td class="parameter_annotations"> </td>
    709. 

  709. </tr>
    710. 

  710. <tr>
    711. 

  711. <td class="parameter_name"><p>default_port</p></td>
    712. 

  712. <td class="parameter_description"><p>the default port to connect to</p></td>
    713. 

  713. <td class="parameter_annotations"> </td>
    714. 

  714. </tr>
    715. 

  715. <tr>
    716. 

  716. <td class="parameter_name"><p>cancellable</p></td>
    717. 

  717. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    718. 

  718. <td class="parameter_annotations"><span class="annotation">[<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>
    719. 

  719. </tr>
    720. 

  720. <tr>
    721. 

  721. <td class="parameter_name"><p>callback</p></td>
    722. 

  722. <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. </p></td>
    723. 

  723. <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
    724. 

  724. </tr>
    725. 

  725. <tr>
    726. 

  726. <td class="parameter_name"><p>user_data</p></td>
    727. 

  727. <td class="parameter_description"><p> user data for the callback. </p></td>
    728. 

  728. <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
    729. 

  729. </tr>
    730. 

  730. </tbody>
    731. 

  731. </table></div>
    732. 

  732. </div>
    733. 

  733. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    734. 

  734. </div>
    735. 

  735. <hr>
    736. 

  736. <div class="refsect2">
    737. 

  737. <a name="g-socket-client-connect-to-host-finish"></a><h3>g_socket_client_connect_to_host_finish ()</h3>
    738. 

  738. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    739. 

  739. g_socket_client_connect_to_host_finish
    740. 

  740.                                (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    741. 

  741.                                 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
    742. 

  742.                                 <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    743. 

  743. <p>Finishes an async connect operation. See <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-async" title="g_socket_client_connect_to_host_async ()"><code class="function">g_socket_client_connect_to_host_async()</code></a></p>
    744. 

  744. <div class="refsect3">
    745. 

  745. <a name="g-socket-client-connect-to-host-finish.parameters"></a><h4>Parameters</h4>
    746. 

  746. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    747. 

  747. <colgroup>
    748. 

  748. <col width="150px" class="parameters_name">
    749. 

  749. <col class="parameters_description">
    750. 

  750. <col width="200px" class="parameters_annotations">
    751. 

  751. </colgroup>
    752. 

  752. <tbody>
    753. 

  753. <tr>
    754. 

  754. <td class="parameter_name"><p>client</p></td>
    755. 

  755. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    756. 

  756. <td class="parameter_annotations"> </td>
    757. 

  757. </tr>
    758. 

  758. <tr>
    759. 

  759. <td class="parameter_name"><p>result</p></td>
    760. 

  760. <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
    761. 

  761. <td class="parameter_annotations"> </td>
    762. 

  762. </tr>
    763. 

  763. <tr>
    764. 

  764. <td class="parameter_name"><p>error</p></td>
    765. 

  765. <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
    766. 

  766. ignore.</p></td>
    767. 

  767. <td class="parameter_annotations"> </td>
    768. 

  768. </tr>
    769. 

  769. </tbody>
    770. 

  770. </table></div>
    771. 

  771. </div>
    772. 

  772. <div class="refsect3">
    773. 

  773. <a name="g-socket-client-connect-to-host-finish.returns"></a><h4>Returns</h4>
    774. 

  774. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    775. 

  775. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    776. 

  776. </div>
    777. 

  777. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    778. 

  778. </div>
    779. 

  779. <hr>
    780. 

  780. <div class="refsect2">
    781. 

  781. <a name="g-socket-client-connect-to-service"></a><h3>g_socket_client_connect_to_service ()</h3>
    782. 

  782. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    783. 

  783. g_socket_client_connect_to_service (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    784. 

  784.                                     <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
    785. 

  785.                                     <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
    786. 

  786.                                     <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    787. 

  787.                                     <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    788. 

  788. <p>Attempts to create a TCP connection to a service.</p>
    789. 

  789. <p>This call looks up the SRV record for <em class="parameter"><code>service</code></em>
    790. 

  790.  at <em class="parameter"><code>domain</code></em>
    791. 

  791.  for the
    792. 

  792. "tcp" protocol.  It then attempts to connect, in turn, to each of
    793. 

  793. the hosts providing the service until either a connection succeeds
    794. 

  794. or there are no hosts remaining.</p>
    795. 

  795. <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
    796. 

  796. and returned.  The caller owns this new object and must drop their
    797. 

  797. reference to it when finished with it.</p>
    798. 

  798. <p>In the event of any failure (DNS error, service not found, no hosts
    799. 

  799. connectable) <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em>
    800. 

  800.  (if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) is set
    801. 

  801. accordingly.</p>
    802. 

  802. <div class="refsect3">
    803. 

  803. <a name="g-socket-client-connect-to-service.parameters"></a><h4>Parameters</h4>
    804. 

  804. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    805. 

  805. <colgroup>
    806. 

  806. <col width="150px" class="parameters_name">
    807. 

  807. <col class="parameters_description">
    808. 

  808. <col width="200px" class="parameters_annotations">
    809. 

  809. </colgroup>
    810. 

  810. <tbody>
    811. 

  811. <tr>
    812. 

  812. <td class="parameter_name"><p>client</p></td>
    813. 

  813. <td class="parameter_description"><p>a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a></p></td>
    814. 

  814. <td class="parameter_annotations"> </td>
    815. 

  815. </tr>
    816. 

  816. <tr>
    817. 

  817. <td class="parameter_name"><p>domain</p></td>
    818. 

  818. <td class="parameter_description"><p>a domain name</p></td>
    819. 

  819. <td class="parameter_annotations"> </td>
    820. 

  820. </tr>
    821. 

  821. <tr>
    822. 

  822. <td class="parameter_name"><p>service</p></td>
    823. 

  823. <td class="parameter_description"><p>the name of the service to connect to</p></td>
    824. 

  824. <td class="parameter_annotations"> </td>
    825. 

  825. </tr>
    826. 

  826. <tr>
    827. 

  827. <td class="parameter_name"><p>cancellable</p></td>
    828. 

  828. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    829. 

  829. <td class="parameter_annotations"><span class="annotation">[<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>
    830. 

  830. </tr>
    831. 

  831. <tr>
    832. 

  832. <td class="parameter_name"><p>error</p></td>
    833. 

  833. <td class="parameter_description"><p>a pointer to a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
    834. 

  834. <td class="parameter_annotations"> </td>
    835. 

  835. </tr>
    836. 

  836. </tbody>
    837. 

  837. </table></div>
    838. 

  838. </div>
    839. 

  839. <div class="refsect3">
    840. 

  840. <a name="g-socket-client-connect-to-service.returns"></a><h4>Returns</h4>
    841. 

  841. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> if successful, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    842. 

  842. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    843. 

  843. </div>
    844. 

  844. </div>
    845. 

  845. <hr>
    846. 

  846. <div class="refsect2">
    847. 

  847. <a name="g-socket-client-connect-to-service-async"></a><h3>g_socket_client_connect_to_service_async ()</h3>
    848. 

  848. <pre class="programlisting"><span class="returnvalue">void</span>
    849. 

  849. g_socket_client_connect_to_service_async
    850. 

  850.                                (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    851. 

  851.                                 <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
    852. 

  852.                                 <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
    853. 

  853.                                 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    854. 

  854.                                 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
    855. 

  855.                                 <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
    856. 

  856. <p>This is the asynchronous version of
    857. 

  857. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service" title="g_socket_client_connect_to_service ()"><code class="function">g_socket_client_connect_to_service()</code></a>.</p>
    858. 

  858. <div class="refsect3">
    859. 

  859. <a name="g-socket-client-connect-to-service-async.parameters"></a><h4>Parameters</h4>
    860. 

  860. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    861. 

  861. <colgroup>
    862. 

  862. <col width="150px" class="parameters_name">
    863. 

  863. <col class="parameters_description">
    864. 

  864. <col width="200px" class="parameters_annotations">
    865. 

  865. </colgroup>
    866. 

  866. <tbody>
    867. 

  867. <tr>
    868. 

  868. <td class="parameter_name"><p>client</p></td>
    869. 

  869. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    870. 

  870. <td class="parameter_annotations"> </td>
    871. 

  871. </tr>
    872. 

  872. <tr>
    873. 

  873. <td class="parameter_name"><p>domain</p></td>
    874. 

  874. <td class="parameter_description"><p>a domain name</p></td>
    875. 

  875. <td class="parameter_annotations"> </td>
    876. 

  876. </tr>
    877. 

  877. <tr>
    878. 

  878. <td class="parameter_name"><p>service</p></td>
    879. 

  879. <td class="parameter_description"><p>the name of the service to connect to</p></td>
    880. 

  880. <td class="parameter_annotations"> </td>
    881. 

  881. </tr>
    882. 

  882. <tr>
    883. 

  883. <td class="parameter_name"><p>cancellable</p></td>
    884. 

  884. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    885. 

  885. <td class="parameter_annotations"><span class="annotation">[<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>
    886. 

  886. </tr>
    887. 

  887. <tr>
    888. 

  888. <td class="parameter_name"><p>callback</p></td>
    889. 

  889. <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. </p></td>
    890. 

  890. <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
    891. 

  891. </tr>
    892. 

  892. <tr>
    893. 

  893. <td class="parameter_name"><p>user_data</p></td>
    894. 

  894. <td class="parameter_description"><p> user data for the callback. </p></td>
    895. 

  895. <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
    896. 

  896. </tr>
    897. 

  897. </tbody>
    898. 

  898. </table></div>
    899. 

  899. </div>
    900. 

  900. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    901. 

  901. </div>
    902. 

  902. <hr>
    903. 

  903. <div class="refsect2">
    904. 

  904. <a name="g-socket-client-connect-to-service-finish"></a><h3>g_socket_client_connect_to_service_finish ()</h3>
    905. 

  905. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    906. 

  906. g_socket_client_connect_to_service_finish
    907. 

  907.                                (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    908. 

  908.                                 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
    909. 

  909.                                 <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    910. 

  910. <p>Finishes an async connect operation. See <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service-async" title="g_socket_client_connect_to_service_async ()"><code class="function">g_socket_client_connect_to_service_async()</code></a></p>
    911. 

  911. <div class="refsect3">
    912. 

  912. <a name="g-socket-client-connect-to-service-finish.parameters"></a><h4>Parameters</h4>
    913. 

  913. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    914. 

  914. <colgroup>
    915. 

  915. <col width="150px" class="parameters_name">
    916. 

  916. <col class="parameters_description">
    917. 

  917. <col width="200px" class="parameters_annotations">
    918. 

  918. </colgroup>
    919. 

  919. <tbody>
    920. 

  920. <tr>
    921. 

  921. <td class="parameter_name"><p>client</p></td>
    922. 

  922. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    923. 

  923. <td class="parameter_annotations"> </td>
    924. 

  924. </tr>
    925. 

  925. <tr>
    926. 

  926. <td class="parameter_name"><p>result</p></td>
    927. 

  927. <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
    928. 

  928. <td class="parameter_annotations"> </td>
    929. 

  929. </tr>
    930. 

  930. <tr>
    931. 

  931. <td class="parameter_name"><p>error</p></td>
    932. 

  932. <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
    933. 

  933. ignore.</p></td>
    934. 

  934. <td class="parameter_annotations"> </td>
    935. 

  935. </tr>
    936. 

  936. </tbody>
    937. 

  937. </table></div>
    938. 

  938. </div>
    939. 

  939. <div class="refsect3">
    940. 

  940. <a name="g-socket-client-connect-to-service-finish.returns"></a><h4>Returns</h4>
    941. 

  941. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    942. 

  942. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    943. 

  943. </div>
    944. 

  944. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    945. 

  945. </div>
    946. 

  946. <hr>
    947. 

  947. <div class="refsect2">
    948. 

  948. <a name="g-socket-client-connect-to-uri"></a><h3>g_socket_client_connect_to_uri ()</h3>
    949. 

  949. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    950. 

  950. g_socket_client_connect_to_uri (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    951. 

  951.                                 <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>,
    952. 

  952.                                 <em class="parameter"><code><a href="../glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
    953. 

  953.                                 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    954. 

  954.                                 <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    955. 

  955. <p>This is a helper function for <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a>.</p>
    956. 

  956. <p>Attempts to create a TCP connection with a network URI.</p>
    957. 

  957. <p><em class="parameter"><code>uri</code></em>
    958. 

  958.  may be any valid URI containing an "authority" (hostname/port)
    959. 

  959. component. If a port is not specified in the URI, <em class="parameter"><code>default_port</code></em>
    960. 

  960. 

  961. will be used. TLS will be negotiated if <a class="link" href="GSocketClient.html#GSocketClient--tls" title="The “tls” property"><span class="type">“tls”</span></a> is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
    962. 

  962. (<a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> does not know to automatically assume TLS for
    963. 

  963. certain URI schemes.)</p>
    964. 

  964. <p>Using this rather than <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a> or
    965. 

  965. <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host" title="g_socket_client_connect_to_host ()"><code class="function">g_socket_client_connect_to_host()</code></a> allows <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> to
    966. 

  966. determine when to use application-specific proxy protocols.</p>
    967. 

  967. <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
    968. 

  968. and returned.  The caller owns this new object and must drop their
    969. 

  969. reference to it when finished with it.</p>
    970. 

  970. <p>In the event of any failure (DNS error, service not found, no hosts
    971. 

  971. connectable) <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em>
    972. 

  972.  (if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) is set
    973. 

  973. accordingly.</p>
    974. 

  974. <div class="refsect3">
    975. 

  975. <a name="g-socket-client-connect-to-uri.parameters"></a><h4>Parameters</h4>
    976. 

  976. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    977. 

  977. <colgroup>
    978. 

  978. <col width="150px" class="parameters_name">
    979. 

  979. <col class="parameters_description">
    980. 

  980. <col width="200px" class="parameters_annotations">
    981. 

  981. </colgroup>
    982. 

  982. <tbody>
    983. 

  983. <tr>
    984. 

  984. <td class="parameter_name"><p>client</p></td>
    985. 

  985. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    986. 

  986. <td class="parameter_annotations"> </td>
    987. 

  987. </tr>
    988. 

  988. <tr>
    989. 

  989. <td class="parameter_name"><p>uri</p></td>
    990. 

  990. <td class="parameter_description"><p>A network URI</p></td>
    991. 

  991. <td class="parameter_annotations"> </td>
    992. 

  992. </tr>
    993. 

  993. <tr>
    994. 

  994. <td class="parameter_name"><p>default_port</p></td>
    995. 

  995. <td class="parameter_description"><p>the default port to connect to</p></td>
    996. 

  996. <td class="parameter_annotations"> </td>
    997. 

  997. </tr>
    998. 

  998. <tr>
    999. 

  999. <td class="parameter_name"><p>cancellable</p></td>
    1000. 

  1000. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    1001. 

  1001. <td class="parameter_annotations"><span class="annotation">[<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>
    1002. 

  1002. </tr>
    1003. 

  1003. <tr>
    1004. 

  1004. <td class="parameter_name"><p>error</p></td>
    1005. 

  1005. <td class="parameter_description"><p>a pointer to a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
    1006. 

  1006. <td class="parameter_annotations"> </td>
    1007. 

  1007. </tr>
    1008. 

  1008. </tbody>
    1009. 

  1009. </table></div>
    1010. 

  1010. </div>
    1011. 

  1011. <div class="refsect3">
    1012. 

  1012. <a name="g-socket-client-connect-to-uri.returns"></a><h4>Returns</h4>
    1013. 

  1013. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    1014. 

  1014. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    1015. 

  1015. </div>
    1016. 

  1016. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1017. 

  1017. </div>
    1018. 

  1018. <hr>
    1019. 

  1019. <div class="refsect2">
    1020. 

  1020. <a name="g-socket-client-connect-to-uri-async"></a><h3>g_socket_client_connect_to_uri_async ()</h3>
    1021. 

  1021. <pre class="programlisting"><span class="returnvalue">void</span>
    1022. 

  1022. g_socket_client_connect_to_uri_async (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1023. 

  1023.                                       <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>,
    1024. 

  1024.                                       <em class="parameter"><code><a href="../glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
    1025. 

  1025.                                       <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
    1026. 

  1026.                                       <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
    1027. 

  1027.                                       <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
    1028. 

  1028. <p>This is the asynchronous version of <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri" title="g_socket_client_connect_to_uri ()"><code class="function">g_socket_client_connect_to_uri()</code></a>.</p>
    1029. 

  1029. <p>When the operation is finished <em class="parameter"><code>callback</code></em>
    1030. 

  1030.  will be
    1031. 

  1031. called. You can then call <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri-finish" title="g_socket_client_connect_to_uri_finish ()"><code class="function">g_socket_client_connect_to_uri_finish()</code></a> to get
    1032. 

  1032. the result of the operation.</p>
    1033. 

  1033. <div class="refsect3">
    1034. 

  1034. <a name="g-socket-client-connect-to-uri-async.parameters"></a><h4>Parameters</h4>
    1035. 

  1035. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1036. 

  1036. <colgroup>
    1037. 

  1037. <col width="150px" class="parameters_name">
    1038. 

  1038. <col class="parameters_description">
    1039. 

  1039. <col width="200px" class="parameters_annotations">
    1040. 

  1040. </colgroup>
    1041. 

  1041. <tbody>
    1042. 

  1042. <tr>
    1043. 

  1043. <td class="parameter_name"><p>client</p></td>
    1044. 

  1044. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    1045. 

  1045. <td class="parameter_annotations"> </td>
    1046. 

  1046. </tr>
    1047. 

  1047. <tr>
    1048. 

  1048. <td class="parameter_name"><p>uri</p></td>
    1049. 

  1049. <td class="parameter_description"><p>a network uri</p></td>
    1050. 

  1050. <td class="parameter_annotations"> </td>
    1051. 

  1051. </tr>
    1052. 

  1052. <tr>
    1053. 

  1053. <td class="parameter_name"><p>default_port</p></td>
    1054. 

  1054. <td class="parameter_description"><p>the default port to connect to</p></td>
    1055. 

  1055. <td class="parameter_annotations"> </td>
    1056. 

  1056. </tr>
    1057. 

  1057. <tr>
    1058. 

  1058. <td class="parameter_name"><p>cancellable</p></td>
    1059. 

  1059. <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    1060. 

  1060. <td class="parameter_annotations"><span class="annotation">[<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>
    1061. 

  1061. </tr>
    1062. 

  1062. <tr>
    1063. 

  1063. <td class="parameter_name"><p>callback</p></td>
    1064. 

  1064. <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. </p></td>
    1065. 

  1065. <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
    1066. 

  1066. </tr>
    1067. 

  1067. <tr>
    1068. 

  1068. <td class="parameter_name"><p>user_data</p></td>
    1069. 

  1069. <td class="parameter_description"><p> user data for the callback. </p></td>
    1070. 

  1070. <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
    1071. 

  1071. </tr>
    1072. 

  1072. </tbody>
    1073. 

  1073. </table></div>
    1074. 

  1074. </div>
    1075. 

  1075. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1076. 

  1076. </div>
    1077. 

  1077. <hr>
    1078. 

  1078. <div class="refsect2">
    1079. 

  1079. <a name="g-socket-client-connect-to-uri-finish"></a><h3>g_socket_client_connect_to_uri_finish ()</h3>
    1080. 

  1080. <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
    1081. 

  1081. g_socket_client_connect_to_uri_finish (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1082. 

  1082.                                        <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
    1083. 

  1083.                                        <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
    1084. 

  1084. <p>Finishes an async connect operation. See <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri-async" title="g_socket_client_connect_to_uri_async ()"><code class="function">g_socket_client_connect_to_uri_async()</code></a></p>
    1085. 

  1085. <div class="refsect3">
    1086. 

  1086. <a name="g-socket-client-connect-to-uri-finish.parameters"></a><h4>Parameters</h4>
    1087. 

  1087. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1088. 

  1088. <colgroup>
    1089. 

  1089. <col width="150px" class="parameters_name">
    1090. 

  1090. <col class="parameters_description">
    1091. 

  1091. <col width="200px" class="parameters_annotations">
    1092. 

  1092. </colgroup>
    1093. 

  1093. <tbody>
    1094. 

  1094. <tr>
    1095. 

  1095. <td class="parameter_name"><p>client</p></td>
    1096. 

  1096. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1097. 

  1097. <td class="parameter_annotations"> </td>
    1098. 

  1098. </tr>
    1099. 

  1099. <tr>
    1100. 

  1100. <td class="parameter_name"><p>result</p></td>
    1101. 

  1101. <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
    1102. 

  1102. <td class="parameter_annotations"> </td>
    1103. 

  1103. </tr>
    1104. 

  1104. <tr>
    1105. 

  1105. <td class="parameter_name"><p>error</p></td>
    1106. 

  1106. <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
    1107. 

  1107. ignore.</p></td>
    1108. 

  1108. <td class="parameter_annotations"> </td>
    1109. 

  1109. </tr>
    1110. 

  1110. </tbody>
    1111. 

  1111. </table></div>
    1112. 

  1112. </div>
    1113. 

  1113. <div class="refsect3">
    1114. 

  1114. <a name="g-socket-client-connect-to-uri-finish.returns"></a><h4>Returns</h4>
    1115. 

  1115. <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
    1116. 

  1116. <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
    1117. 

  1117. </div>
    1118. 

  1118. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1119. 

  1119. </div>
    1120. 

  1120. <hr>
    1121. 

  1121. <div class="refsect2">
    1122. 

  1122. <a name="g-socket-client-set-family"></a><h3>g_socket_client_set_family ()</h3>
    1123. 

  1123. <pre class="programlisting"><span class="returnvalue">void</span>
    1124. 

  1124. g_socket_client_set_family (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1125. 

  1125.                             <em class="parameter"><code><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a> family</code></em>);</pre>
    1126. 

  1126. <p>Sets the socket family of the socket client.
    1127. 

  1127. If this is set to something other than <a class="link" href="GSocketAddress.html#G-SOCKET-FAMILY-INVALID:CAPS"><code class="literal">G_SOCKET_FAMILY_INVALID</code></a>
    1128. 

  1128. then the sockets created by this object will be of the specified
    1129. 

  1129. family.</p>
    1130. 

  1130. <p>This might be useful for instance if you want to force the local
    1131. 

  1131. connection to be an ipv4 socket, even though the address might
    1132. 

  1132. be an ipv6 mapped to ipv4 address.</p>
    1133. 

  1133. <div class="refsect3">
    1134. 

  1134. <a name="g-socket-client-set-family.parameters"></a><h4>Parameters</h4>
    1135. 

  1135. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1136. 

  1136. <colgroup>
    1137. 

  1137. <col width="150px" class="parameters_name">
    1138. 

  1138. <col class="parameters_description">
    1139. 

  1139. <col width="200px" class="parameters_annotations">
    1140. 

  1140. </colgroup>
    1141. 

  1141. <tbody>
    1142. 

  1142. <tr>
    1143. 

  1143. <td class="parameter_name"><p>client</p></td>
    1144. 

  1144. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1145. 

  1145. <td class="parameter_annotations"> </td>
    1146. 

  1146. </tr>
    1147. 

  1147. <tr>
    1148. 

  1148. <td class="parameter_name"><p>family</p></td>
    1149. 

  1149. <td class="parameter_description"><p>a <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></p></td>
    1150. 

  1150. <td class="parameter_annotations"> </td>
    1151. 

  1151. </tr>
    1152. 

  1152. </tbody>
    1153. 

  1153. </table></div>
    1154. 

  1154. </div>
    1155. 

  1155. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1156. 

  1156. </div>
    1157. 

  1157. <hr>
    1158. 

  1158. <div class="refsect2">
    1159. 

  1159. <a name="g-socket-client-set-local-address"></a><h3>g_socket_client_set_local_address ()</h3>
    1160. 

  1160. <pre class="programlisting"><span class="returnvalue">void</span>
    1161. 

  1161. g_socket_client_set_local_address (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1162. 

  1162.                                    <em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *address</code></em>);</pre>
    1163. 

  1163. <p>Sets the local address of the socket client.
    1164. 

  1164. The sockets created by this object will bound to the
    1165. 

  1165. specified address (if not <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) before connecting.</p>
    1166. 

  1166. <p>This is useful if you want to ensure that the local
    1167. 

  1167. side of the connection is on a specific port, or on
    1168. 

  1168. a specific interface.</p>
    1169. 

  1169. <div class="refsect3">
    1170. 

  1170. <a name="g-socket-client-set-local-address.parameters"></a><h4>Parameters</h4>
    1171. 

  1171. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1172. 

  1172. <colgroup>
    1173. 

  1173. <col width="150px" class="parameters_name">
    1174. 

  1174. <col class="parameters_description">
    1175. 

  1175. <col width="200px" class="parameters_annotations">
    1176. 

  1176. </colgroup>
    1177. 

  1177. <tbody>
    1178. 

  1178. <tr>
    1179. 

  1179. <td class="parameter_name"><p>client</p></td>
    1180. 

  1180. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1181. 

  1181. <td class="parameter_annotations"> </td>
    1182. 

  1182. </tr>
    1183. 

  1183. <tr>
    1184. 

  1184. <td class="parameter_name"><p>address</p></td>
    1185. 

  1185. <td class="parameter_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
    1186. 

  1186. <td class="parameter_annotations"><span class="annotation">[<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>
    1187. 

  1187. </tr>
    1188. 

  1188. </tbody>
    1189. 

  1189. </table></div>
    1190. 

  1190. </div>
    1191. 

  1191. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1192. 

  1192. </div>
    1193. 

  1193. <hr>
    1194. 

  1194. <div class="refsect2">
    1195. 

  1195. <a name="g-socket-client-set-protocol"></a><h3>g_socket_client_set_protocol ()</h3>
    1196. 

  1196. <pre class="programlisting"><span class="returnvalue">void</span>
    1197. 

  1197. g_socket_client_set_protocol (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1198. 

  1198.                               <em class="parameter"><code><a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a> protocol</code></em>);</pre>
    1199. 

  1199. <p>Sets the protocol of the socket client.
    1200. 

  1200. The sockets created by this object will use of the specified
    1201. 

  1201. protocol.</p>
    1202. 

  1202. <p>If <em class="parameter"><code>protocol</code></em>
    1203. 

  1203.  is <code class="literal">0</code> that means to use the default
    1204. 

  1204. protocol for the socket family and type.</p>
    1205. 

  1205. <div class="refsect3">
    1206. 

  1206. <a name="g-socket-client-set-protocol.parameters"></a><h4>Parameters</h4>
    1207. 

  1207. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1208. 

  1208. <colgroup>
    1209. 

  1209. <col width="150px" class="parameters_name">
    1210. 

  1210. <col class="parameters_description">
    1211. 

  1211. <col width="200px" class="parameters_annotations">
    1212. 

  1212. </colgroup>
    1213. 

  1213. <tbody>
    1214. 

  1214. <tr>
    1215. 

  1215. <td class="parameter_name"><p>client</p></td>
    1216. 

  1216. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1217. 

  1217. <td class="parameter_annotations"> </td>
    1218. 

  1218. </tr>
    1219. 

  1219. <tr>
    1220. 

  1220. <td class="parameter_name"><p>protocol</p></td>
    1221. 

  1221. <td class="parameter_description"><p>a <a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a></p></td>
    1222. 

  1222. <td class="parameter_annotations"> </td>
    1223. 

  1223. </tr>
    1224. 

  1224. </tbody>
    1225. 

  1225. </table></div>
    1226. 

  1226. </div>
    1227. 

  1227. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1228. 

  1228. </div>
    1229. 

  1229. <hr>
    1230. 

  1230. <div class="refsect2">
    1231. 

  1231. <a name="g-socket-client-set-socket-type"></a><h3>g_socket_client_set_socket_type ()</h3>
    1232. 

  1232. <pre class="programlisting"><span class="returnvalue">void</span>
    1233. 

  1233. g_socket_client_set_socket_type (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1234. 

  1234.                                  <em class="parameter"><code><a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a> type</code></em>);</pre>
    1235. 

  1235. <p>Sets the socket type of the socket client.
    1236. 

  1236. The sockets created by this object will be of the specified
    1237. 

  1237. type.</p>
    1238. 

  1238. <p>It doesn't make sense to specify a type of <a class="link" href="GSocket.html#G-SOCKET-TYPE-DATAGRAM:CAPS"><code class="literal">G_SOCKET_TYPE_DATAGRAM</code></a>,
    1239. 

  1239. as GSocketClient is used for connection oriented services.</p>
    1240. 

  1240. <div class="refsect3">
    1241. 

  1241. <a name="g-socket-client-set-socket-type.parameters"></a><h4>Parameters</h4>
    1242. 

  1242. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1243. 

  1243. <colgroup>
    1244. 

  1244. <col width="150px" class="parameters_name">
    1245. 

  1245. <col class="parameters_description">
    1246. 

  1246. <col width="200px" class="parameters_annotations">
    1247. 

  1247. </colgroup>
    1248. 

  1248. <tbody>
    1249. 

  1249. <tr>
    1250. 

  1250. <td class="parameter_name"><p>client</p></td>
    1251. 

  1251. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1252. 

  1252. <td class="parameter_annotations"> </td>
    1253. 

  1253. </tr>
    1254. 

  1254. <tr>
    1255. 

  1255. <td class="parameter_name"><p>type</p></td>
    1256. 

  1256. <td class="parameter_description"><p>a <a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a></p></td>
    1257. 

  1257. <td class="parameter_annotations"> </td>
    1258. 

  1258. </tr>
    1259. 

  1259. </tbody>
    1260. 

  1260. </table></div>
    1261. 

  1261. </div>
    1262. 

  1262. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1263. 

  1263. </div>
    1264. 

  1264. <hr>
    1265. 

  1265. <div class="refsect2">
    1266. 

  1266. <a name="g-socket-client-set-timeout"></a><h3>g_socket_client_set_timeout ()</h3>
    1267. 

  1267. <pre class="programlisting"><span class="returnvalue">void</span>
    1268. 

  1268. g_socket_client_set_timeout (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1269. 

  1269.                              <em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> timeout</code></em>);</pre>
    1270. 

  1270. <p>Sets the I/O timeout for sockets created by <em class="parameter"><code>client</code></em>
    1271. 

  1271. . <em class="parameter"><code>timeout</code></em>
    1272. 

  1272.  is a
    1273. 

  1273. time in seconds, or 0 for no timeout (the default).</p>
    1274. 

  1274. <p>The timeout value affects the initial connection attempt as well,
    1275. 

  1275. so setting this may cause calls to <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a>, etc,
    1276. 

  1276. to fail with <a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a>.</p>
    1277. 

  1277. <div class="refsect3">
    1278. 

  1278. <a name="g-socket-client-set-timeout.parameters"></a><h4>Parameters</h4>
    1279. 

  1279. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1280. 

  1280. <colgroup>
    1281. 

  1281. <col width="150px" class="parameters_name">
    1282. 

  1282. <col class="parameters_description">
    1283. 

  1283. <col width="200px" class="parameters_annotations">
    1284. 

  1284. </colgroup>
    1285. 

  1285. <tbody>
    1286. 

  1286. <tr>
    1287. 

  1287. <td class="parameter_name"><p>client</p></td>
    1288. 

  1288. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1289. 

  1289. <td class="parameter_annotations"> </td>
    1290. 

  1290. </tr>
    1291. 

  1291. <tr>
    1292. 

  1292. <td class="parameter_name"><p>timeout</p></td>
    1293. 

  1293. <td class="parameter_description"><p>the timeout</p></td>
    1294. 

  1294. <td class="parameter_annotations"> </td>
    1295. 

  1295. </tr>
    1296. 

  1296. </tbody>
    1297. 

  1297. </table></div>
    1298. 

  1298. </div>
    1299. 

  1299. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1300. 

  1300. </div>
    1301. 

  1301. <hr>
    1302. 

  1302. <div class="refsect2">
    1303. 

  1303. <a name="g-socket-client-set-enable-proxy"></a><h3>g_socket_client_set_enable_proxy ()</h3>
    1304. 

  1304. <pre class="programlisting"><span class="returnvalue">void</span>
    1305. 

  1305. g_socket_client_set_enable_proxy (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1306. 

  1306.                                   <em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);</pre>
    1307. 

  1307. <p>Sets whether or not <em class="parameter"><code>client</code></em>
    1308. 

  1308.  attempts to make connections via a
    1309. 

  1309. proxy server. When enabled (the default), <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> will use a
    1310. 

  1310. <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> to determine if a proxy protocol such as SOCKS is
    1311. 

  1311. needed, and automatically do the necessary proxy negotiation.</p>
    1312. 

  1312. <p>See also <a class="link" href="GSocketClient.html#g-socket-client-set-proxy-resolver" title="g_socket_client_set_proxy_resolver ()"><code class="function">g_socket_client_set_proxy_resolver()</code></a>.</p>
    1313. 

  1313. <div class="refsect3">
    1314. 

  1314. <a name="g-socket-client-set-enable-proxy.parameters"></a><h4>Parameters</h4>
    1315. 

  1315. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1316. 

  1316. <colgroup>
    1317. 

  1317. <col width="150px" class="parameters_name">
    1318. 

  1318. <col class="parameters_description">
    1319. 

  1319. <col width="200px" class="parameters_annotations">
    1320. 

  1320. </colgroup>
    1321. 

  1321. <tbody>
    1322. 

  1322. <tr>
    1323. 

  1323. <td class="parameter_name"><p>client</p></td>
    1324. 

  1324. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1325. 

  1325. <td class="parameter_annotations"> </td>
    1326. 

  1326. </tr>
    1327. 

  1327. <tr>
    1328. 

  1328. <td class="parameter_name"><p>enable</p></td>
    1329. 

  1329. <td class="parameter_description"><p>whether to enable proxies</p></td>
    1330. 

  1330. <td class="parameter_annotations"> </td>
    1331. 

  1331. </tr>
    1332. 

  1332. </tbody>
    1333. 

  1333. </table></div>
    1334. 

  1334. </div>
    1335. 

  1335. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1336. 

  1336. </div>
    1337. 

  1337. <hr>
    1338. 

  1338. <div class="refsect2">
    1339. 

  1339. <a name="g-socket-client-set-proxy-resolver"></a><h3>g_socket_client_set_proxy_resolver ()</h3>
    1340. 

  1340. <pre class="programlisting"><span class="returnvalue">void</span>
    1341. 

  1341. g_socket_client_set_proxy_resolver (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1342. 

  1342.                                     <em class="parameter"><code><a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> *proxy_resolver</code></em>);</pre>
    1343. 

  1343. <p>Overrides the <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> used by <em class="parameter"><code>client</code></em>
    1344. 

  1344. . You can call this if
    1345. 

  1345. you want to use specific proxies, rather than using the system
    1346. 

  1346. default proxy settings.</p>
    1347. 

  1347. <p>Note that whether or not the proxy resolver is actually used
    1348. 

  1348. depends on the setting of <a class="link" href="GSocketClient.html#GSocketClient--enable-proxy" title="The “enable-proxy” property"><span class="type">“enable-proxy”</span></a>, which is not
    1349. 

  1349. changed by this function (but which is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> by default)</p>
    1350. 

  1350. <div class="refsect3">
    1351. 

  1351. <a name="g-socket-client-set-proxy-resolver.parameters"></a><h4>Parameters</h4>
    1352. 

  1352. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1353. 

  1353. <colgroup>
    1354. 

  1354. <col width="150px" class="parameters_name">
    1355. 

  1355. <col class="parameters_description">
    1356. 

  1356. <col width="200px" class="parameters_annotations">
    1357. 

  1357. </colgroup>
    1358. 

  1358. <tbody>
    1359. 

  1359. <tr>
    1360. 

  1360. <td class="parameter_name"><p>client</p></td>
    1361. 

  1361. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1362. 

  1362. <td class="parameter_annotations"> </td>
    1363. 

  1363. </tr>
    1364. 

  1364. <tr>
    1365. 

  1365. <td class="parameter_name"><p>proxy_resolver</p></td>
    1366. 

  1366. <td class="parameter_description"><p> a <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the
    1367. 

  1367. default. </p></td>
    1368. 

  1368. <td class="parameter_annotations"><span class="annotation">[<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>
    1369. 

  1369. </tr>
    1370. 

  1370. </tbody>
    1371. 

  1371. </table></div>
    1372. 

  1372. </div>
    1373. 

  1373. <p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
    1374. 

  1374. </div>
    1375. 

  1375. <hr>
    1376. 

  1376. <div class="refsect2">
    1377. 

  1377. <a name="g-socket-client-set-tls"></a><h3>g_socket_client_set_tls ()</h3>
    1378. 

  1378. <pre class="programlisting"><span class="returnvalue">void</span>
    1379. 

  1379. g_socket_client_set_tls (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1380. 

  1380.                          <em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> tls</code></em>);</pre>
    1381. 

  1381. <p>Sets whether <em class="parameter"><code>client</code></em>
    1382. 

  1382.  creates TLS (aka SSL) connections. If <em class="parameter"><code>tls</code></em>
    1383. 

  1383.  is
    1384. 

  1384. <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, <em class="parameter"><code>client</code></em>
    1385. 

  1385.  will wrap its connections in a <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
    1386. 

  1386. and perform a TLS handshake when connecting.</p>
    1387. 

  1387. <p>Note that since <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> must return a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>,
    1388. 

  1388. but <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> is not a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>, this
    1389. 

  1389. actually wraps the resulting <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> in a
    1390. 

  1390. <a class="link" href="GTcpWrapperConnection.html" title="GTcpWrapperConnection"><span class="type">GTcpWrapperConnection</span></a> when returning it. You can use
    1391. 

  1391. <a class="link" href="GTcpWrapperConnection.html#g-tcp-wrapper-connection-get-base-io-stream" title="g_tcp_wrapper_connection_get_base_io_stream ()"><code class="function">g_tcp_wrapper_connection_get_base_io_stream()</code></a> on the return value
    1392. 

  1392. to extract the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>.</p>
    1393. 

  1393. <p>If you need to modify the behavior of the TLS handshake (eg, by
    1394. 

  1394. setting a client-side certificate to use, or connecting to the
    1395. 

  1395. <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title="The “accept-certificate” signal"><span class="type">“accept-certificate”</span></a> signal), you can connect to
    1396. 

  1396. <em class="parameter"><code>client</code></em>
    1397. 

  1397. 's <a class="link" href="GSocketClient.html#GSocketClient-event" title="The “event” signal"><span class="type">“event”</span></a> signal and wait for it to be
    1398. 

  1398. emitted with <a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-TLS-HANDSHAKING:CAPS"><code class="literal">G_SOCKET_CLIENT_TLS_HANDSHAKING</code></a>, which will give you
    1399. 

  1399. a chance to see the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> before the handshake
    1400. 

  1400. starts.</p>
    1401. 

  1401. <div class="refsect3">
    1402. 

  1402. <a name="g-socket-client-set-tls.parameters"></a><h4>Parameters</h4>
    1403. 

  1403. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1404. 

  1404. <colgroup>
    1405. 

  1405. <col width="150px" class="parameters_name">
    1406. 

  1406. <col class="parameters_description">
    1407. 

  1407. <col width="200px" class="parameters_annotations">
    1408. 

  1408. </colgroup>
    1409. 

  1409. <tbody>
    1410. 

  1410. <tr>
    1411. 

  1411. <td class="parameter_name"><p>client</p></td>
    1412. 

  1412. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1413. 

  1413. <td class="parameter_annotations"> </td>
    1414. 

  1414. </tr>
    1415. 

  1415. <tr>
    1416. 

  1416. <td class="parameter_name"><p>tls</p></td>
    1417. 

  1417. <td class="parameter_description"><p>whether to use TLS</p></td>
    1418. 

  1418. <td class="parameter_annotations"> </td>
    1419. 

  1419. </tr>
    1420. 

  1420. </tbody>
    1421. 

  1421. </table></div>
    1422. 

  1422. </div>
    1423. 

  1423. <p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
    1424. 

  1424. </div>
    1425. 

  1425. <hr>
    1426. 

  1426. <div class="refsect2">
    1427. 

  1427. <a name="g-socket-client-set-tls-validation-flags"></a><h3>g_socket_client_set_tls_validation_flags ()</h3>
    1428. 

  1428. <pre class="programlisting"><span class="returnvalue">void</span>
    1429. 

  1429. g_socket_client_set_tls_validation_flags
    1430. 

  1430.                                (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1431. 

  1431.                                 <em class="parameter"><code><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);</pre>
    1432. 

  1432. <p>Sets the TLS validation flags used when creating TLS connections
    1433. 

  1433. via <em class="parameter"><code>client</code></em>
    1434. 

  1434. . The default value is <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-VALIDATE-ALL:CAPS"><code class="literal">G_TLS_CERTIFICATE_VALIDATE_ALL</code></a>.</p>
    1435. 

  1435. <div class="refsect3">
    1436. 

  1436. <a name="g-socket-client-set-tls-validation-flags.parameters"></a><h4>Parameters</h4>
    1437. 

  1437. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1438. 

  1438. <colgroup>
    1439. 

  1439. <col width="150px" class="parameters_name">
    1440. 

  1440. <col class="parameters_description">
    1441. 

  1441. <col width="200px" class="parameters_annotations">
    1442. 

  1442. </colgroup>
    1443. 

  1443. <tbody>
    1444. 

  1444. <tr>
    1445. 

  1445. <td class="parameter_name"><p>client</p></td>
    1446. 

  1446. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1447. 

  1447. <td class="parameter_annotations"> </td>
    1448. 

  1448. </tr>
    1449. 

  1449. <tr>
    1450. 

  1450. <td class="parameter_name"><p>flags</p></td>
    1451. 

  1451. <td class="parameter_description"><p>the validation flags</p></td>
    1452. 

  1452. <td class="parameter_annotations"> </td>
    1453. 

  1453. </tr>
    1454. 

  1454. </tbody>
    1455. 

  1455. </table></div>
    1456. 

  1456. </div>
    1457. 

  1457. <p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
    1458. 

  1458. </div>
    1459. 

  1459. <hr>
    1460. 

  1460. <div class="refsect2">
    1461. 

  1461. <a name="g-socket-client-get-family"></a><h3>g_socket_client_get_family ()</h3>
    1462. 

  1462. <pre class="programlisting"><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="returnvalue">GSocketFamily</span></a>
    1463. 

  1463. g_socket_client_get_family (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1464. 

  1464. <p>Gets the socket family of the socket client.</p>
    1465. 

  1465. <p>See <a class="link" href="GSocketClient.html#g-socket-client-set-family" title="g_socket_client_set_family ()"><code class="function">g_socket_client_set_family()</code></a> for details.</p>
    1466. 

  1466. <div class="refsect3">
    1467. 

  1467. <a name="g-socket-client-get-family.parameters"></a><h4>Parameters</h4>
    1468. 

  1468. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1469. 

  1469. <colgroup>
    1470. 

  1470. <col width="150px" class="parameters_name">
    1471. 

  1471. <col class="parameters_description">
    1472. 

  1472. <col width="200px" class="parameters_annotations">
    1473. 

  1473. </colgroup>
    1474. 

  1474. <tbody><tr>
    1475. 

  1475. <td class="parameter_name"><p>client</p></td>
    1476. 

  1476. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1477. 

  1477. <td class="parameter_annotations"> </td>
    1478. 

  1478. </tr></tbody>
    1479. 

  1479. </table></div>
    1480. 

  1480. </div>
    1481. 

  1481. <div class="refsect3">
    1482. 

  1482. <a name="g-socket-client-get-family.returns"></a><h4>Returns</h4>
    1483. 

  1483. <p> a <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></p>
    1484. 

  1484. </div>
    1485. 

  1485. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1486. 

  1486. </div>
    1487. 

  1487. <hr>
    1488. 

  1488. <div class="refsect2">
    1489. 

  1489. <a name="g-socket-client-get-local-address"></a><h3>g_socket_client_get_local_address ()</h3>
    1490. 

  1490. <pre class="programlisting"><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="returnvalue">GSocketAddress</span></a> *
    1491. 

  1491. g_socket_client_get_local_address (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1492. 

  1492. <p>Gets the local address of the socket client.</p>
    1493. 

  1493. <p>See <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()"><code class="function">g_socket_client_set_local_address()</code></a> for details.</p>
    1494. 

  1494. <div class="refsect3">
    1495. 

  1495. <a name="g-socket-client-get-local-address.parameters"></a><h4>Parameters</h4>
    1496. 

  1496. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1497. 

  1497. <colgroup>
    1498. 

  1498. <col width="150px" class="parameters_name">
    1499. 

  1499. <col class="parameters_description">
    1500. 

  1500. <col width="200px" class="parameters_annotations">
    1501. 

  1501. </colgroup>
    1502. 

  1502. <tbody><tr>
    1503. 

  1503. <td class="parameter_name"><p>client</p></td>
    1504. 

  1504. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1505. 

  1505. <td class="parameter_annotations"> </td>
    1506. 

  1506. </tr></tbody>
    1507. 

  1507. </table></div>
    1508. 

  1508. </div>
    1509. 

  1509. <div class="refsect3">
    1510. 

  1510. <a name="g-socket-client-get-local-address.returns"></a><h4>Returns</h4>
    1511. 

  1511. <p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Do not free. </p>
    1512. 

  1512. <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
    1513. 

  1513. </div>
    1514. 

  1514. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1515. 

  1515. </div>
    1516. 

  1516. <hr>
    1517. 

  1517. <div class="refsect2">
    1518. 

  1518. <a name="g-socket-client-get-protocol"></a><h3>g_socket_client_get_protocol ()</h3>
    1519. 

  1519. <pre class="programlisting"><a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="returnvalue">GSocketProtocol</span></a>
    1520. 

  1520. g_socket_client_get_protocol (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1521. 

  1521. <p>Gets the protocol name type of the socket client.</p>
    1522. 

  1522. <p>See <a class="link" href="GSocketClient.html#g-socket-client-set-protocol" title="g_socket_client_set_protocol ()"><code class="function">g_socket_client_set_protocol()</code></a> for details.</p>
    1523. 

  1523. <div class="refsect3">
    1524. 

  1524. <a name="g-socket-client-get-protocol.parameters"></a><h4>Parameters</h4>
    1525. 

  1525. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1526. 

  1526. <colgroup>
    1527. 

  1527. <col width="150px" class="parameters_name">
    1528. 

  1528. <col class="parameters_description">
    1529. 

  1529. <col width="200px" class="parameters_annotations">
    1530. 

  1530. </colgroup>
    1531. 

  1531. <tbody><tr>
    1532. 

  1532. <td class="parameter_name"><p>client</p></td>
    1533. 

  1533. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    1534. 

  1534. <td class="parameter_annotations"> </td>
    1535. 

  1535. </tr></tbody>
    1536. 

  1536. </table></div>
    1537. 

  1537. </div>
    1538. 

  1538. <div class="refsect3">
    1539. 

  1539. <a name="g-socket-client-get-protocol.returns"></a><h4>Returns</h4>
    1540. 

  1540. <p> a <a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a></p>
    1541. 

  1541. </div>
    1542. 

  1542. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1543. 

  1543. </div>
    1544. 

  1544. <hr>
    1545. 

  1545. <div class="refsect2">
    1546. 

  1546. <a name="g-socket-client-get-socket-type"></a><h3>g_socket_client_get_socket_type ()</h3>
    1547. 

  1547. <pre class="programlisting"><a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="returnvalue">GSocketType</span></a>
    1548. 

  1548. g_socket_client_get_socket_type (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1549. 

  1549. <p>Gets the socket type of the socket client.</p>
    1550. 

  1550. <p>See <a class="link" href="GSocketClient.html#g-socket-client-set-socket-type" title="g_socket_client_set_socket_type ()"><code class="function">g_socket_client_set_socket_type()</code></a> for details.</p>
    1551. 

  1551. <div class="refsect3">
    1552. 

  1552. <a name="g-socket-client-get-socket-type.parameters"></a><h4>Parameters</h4>
    1553. 

  1553. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1554. 

  1554. <colgroup>
    1555. 

  1555. <col width="150px" class="parameters_name">
    1556. 

  1556. <col class="parameters_description">
    1557. 

  1557. <col width="200px" class="parameters_annotations">
    1558. 

  1558. </colgroup>
    1559. 

  1559. <tbody><tr>
    1560. 

  1560. <td class="parameter_name"><p>client</p></td>
    1561. 

  1561. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1562. 

  1562. <td class="parameter_annotations"> </td>
    1563. 

  1563. </tr></tbody>
    1564. 

  1564. </table></div>
    1565. 

  1565. </div>
    1566. 

  1566. <div class="refsect3">
    1567. 

  1567. <a name="g-socket-client-get-socket-type.returns"></a><h4>Returns</h4>
    1568. 

  1568. <p> a <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></p>
    1569. 

  1569. </div>
    1570. 

  1570. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1571. 

  1571. </div>
    1572. 

  1572. <hr>
    1573. 

  1573. <div class="refsect2">
    1574. 

  1574. <a name="g-socket-client-get-timeout"></a><h3>g_socket_client_get_timeout ()</h3>
    1575. 

  1575. <pre class="programlisting"><a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
    1576. 

  1576. g_socket_client_get_timeout (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1577. 

  1577. <p>Gets the I/O timeout time for sockets created by <em class="parameter"><code>client</code></em>
    1578. 

  1578. .</p>
    1579. 

  1579. <p>See <a class="link" href="GSocketClient.html#g-socket-client-set-timeout" title="g_socket_client_set_timeout ()"><code class="function">g_socket_client_set_timeout()</code></a> for details.</p>
    1580. 

  1580. <div class="refsect3">
    1581. 

  1581. <a name="g-socket-client-get-timeout.parameters"></a><h4>Parameters</h4>
    1582. 

  1582. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1583. 

  1583. <colgroup>
    1584. 

  1584. <col width="150px" class="parameters_name">
    1585. 

  1585. <col class="parameters_description">
    1586. 

  1586. <col width="200px" class="parameters_annotations">
    1587. 

  1587. </colgroup>
    1588. 

  1588. <tbody><tr>
    1589. 

  1589. <td class="parameter_name"><p>client</p></td>
    1590. 

  1590. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    1591. 

  1591. <td class="parameter_annotations"> </td>
    1592. 

  1592. </tr></tbody>
    1593. 

  1593. </table></div>
    1594. 

  1594. </div>
    1595. 

  1595. <div class="refsect3">
    1596. 

  1596. <a name="g-socket-client-get-timeout.returns"></a><h4>Returns</h4>
    1597. 

  1597. <p> the timeout in seconds</p>
    1598. 

  1598. </div>
    1599. 

  1599. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1600. 

  1600. </div>
    1601. 

  1601. <hr>
    1602. 

  1602. <div class="refsect2">
    1603. 

  1603. <a name="g-socket-client-get-enable-proxy"></a><h3>g_socket_client_get_enable_proxy ()</h3>
    1604. 

  1604. <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
    1605. 

  1605. g_socket_client_get_enable_proxy (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1606. 

  1606. <p>Gets the proxy enable state; see <a class="link" href="GSocketClient.html#g-socket-client-set-enable-proxy" title="g_socket_client_set_enable_proxy ()"><code class="function">g_socket_client_set_enable_proxy()</code></a></p>
    1607. 

  1607. <div class="refsect3">
    1608. 

  1608. <a name="g-socket-client-get-enable-proxy.parameters"></a><h4>Parameters</h4>
    1609. 

  1609. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1610. 

  1610. <colgroup>
    1611. 

  1611. <col width="150px" class="parameters_name">
    1612. 

  1612. <col class="parameters_description">
    1613. 

  1613. <col width="200px" class="parameters_annotations">
    1614. 

  1614. </colgroup>
    1615. 

  1615. <tbody><tr>
    1616. 

  1616. <td class="parameter_name"><p>client</p></td>
    1617. 

  1617. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1618. 

  1618. <td class="parameter_annotations"> </td>
    1619. 

  1619. </tr></tbody>
    1620. 

  1620. </table></div>
    1621. 

  1621. </div>
    1622. 

  1622. <div class="refsect3">
    1623. 

  1623. <a name="g-socket-client-get-enable-proxy.returns"></a><h4>Returns</h4>
    1624. 

  1624. <p> whether proxying is enabled</p>
    1625. 

  1625. </div>
    1626. 

  1626. <p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
    1627. 

  1627. </div>
    1628. 

  1628. <hr>
    1629. 

  1629. <div class="refsect2">
    1630. 

  1630. <a name="g-socket-client-get-proxy-resolver"></a><h3>g_socket_client_get_proxy_resolver ()</h3>
    1631. 

  1631. <pre class="programlisting"><a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="returnvalue">GProxyResolver</span></a> *
    1632. 

  1632. g_socket_client_get_proxy_resolver (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1633. 

  1633. <p>Gets the <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> being used by <em class="parameter"><code>client</code></em>
    1634. 

  1634. . Normally, this will
    1635. 

  1635. be the resolver returned by <a class="link" href="GProxyResolver.html#g-proxy-resolver-get-default" title="g_proxy_resolver_get_default ()"><code class="function">g_proxy_resolver_get_default()</code></a>, but you
    1636. 

  1636. can override it with <a class="link" href="GSocketClient.html#g-socket-client-set-proxy-resolver" title="g_socket_client_set_proxy_resolver ()"><code class="function">g_socket_client_set_proxy_resolver()</code></a>.</p>
    1637. 

  1637. <div class="refsect3">
    1638. 

  1638. <a name="g-socket-client-get-proxy-resolver.parameters"></a><h4>Parameters</h4>
    1639. 

  1639. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1640. 

  1640. <colgroup>
    1641. 

  1641. <col width="150px" class="parameters_name">
    1642. 

  1642. <col class="parameters_description">
    1643. 

  1643. <col width="200px" class="parameters_annotations">
    1644. 

  1644. </colgroup>
    1645. 

  1645. <tbody><tr>
    1646. 

  1646. <td class="parameter_name"><p>client</p></td>
    1647. 

  1647. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1648. 

  1648. <td class="parameter_annotations"> </td>
    1649. 

  1649. </tr></tbody>
    1650. 

  1650. </table></div>
    1651. 

  1651. </div>
    1652. 

  1652. <div class="refsect3">
    1653. 

  1653. <a name="g-socket-client-get-proxy-resolver.returns"></a><h4>Returns</h4>
    1654. 

  1654. <p> The <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> being used by
    1655. 

  1655. <em class="parameter"><code>client</code></em>
    1656. 

  1656. . </p>
    1657. 

  1657. <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
    1658. 

  1658. </div>
    1659. 

  1659. <p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
    1660. 

  1660. </div>
    1661. 

  1661. <hr>
    1662. 

  1662. <div class="refsect2">
    1663. 

  1663. <a name="g-socket-client-get-tls"></a><h3>g_socket_client_get_tls ()</h3>
    1664. 

  1664. <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
    1665. 

  1665. g_socket_client_get_tls (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1666. 

  1666. <p>Gets whether <em class="parameter"><code>client</code></em>
    1667. 

  1667.  creates TLS connections. See
    1668. 

  1668. <a class="link" href="GSocketClient.html#g-socket-client-set-tls" title="g_socket_client_set_tls ()"><code class="function">g_socket_client_set_tls()</code></a> for details.</p>
    1669. 

  1669. <div class="refsect3">
    1670. 

  1670. <a name="g-socket-client-get-tls.parameters"></a><h4>Parameters</h4>
    1671. 

  1671. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1672. 

  1672. <colgroup>
    1673. 

  1673. <col width="150px" class="parameters_name">
    1674. 

  1674. <col class="parameters_description">
    1675. 

  1675. <col width="200px" class="parameters_annotations">
    1676. 

  1676. </colgroup>
    1677. 

  1677. <tbody><tr>
    1678. 

  1678. <td class="parameter_name"><p>client</p></td>
    1679. 

  1679. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1680. 

  1680. <td class="parameter_annotations"> </td>
    1681. 

  1681. </tr></tbody>
    1682. 

  1682. </table></div>
    1683. 

  1683. </div>
    1684. 

  1684. <div class="refsect3">
    1685. 

  1685. <a name="g-socket-client-get-tls.returns"></a><h4>Returns</h4>
    1686. 

  1686. <p> whether <em class="parameter"><code>client</code></em>
    1687. 

  1687. uses TLS</p>
    1688. 

  1688. </div>
    1689. 

  1689. <p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
    1690. 

  1690. </div>
    1691. 

  1691. <hr>
    1692. 

  1692. <div class="refsect2">
    1693. 

  1693. <a name="g-socket-client-get-tls-validation-flags"></a><h3>g_socket_client_get_tls_validation_flags ()</h3>
    1694. 

  1694. <pre class="programlisting"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a>
    1695. 

  1695. g_socket_client_get_tls_validation_flags
    1696. 

  1696.                                (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>);</pre>
    1697. 

  1697. <p>Gets the TLS validation flags used creating TLS connections via
    1698. 

  1698. <em class="parameter"><code>client</code></em>
    1699. 

  1699. .</p>
    1700. 

  1700. <div class="refsect3">
    1701. 

  1701. <a name="g-socket-client-get-tls-validation-flags.parameters"></a><h4>Parameters</h4>
    1702. 

  1702. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1703. 

  1703. <colgroup>
    1704. 

  1704. <col width="150px" class="parameters_name">
    1705. 

  1705. <col class="parameters_description">
    1706. 

  1706. <col width="200px" class="parameters_annotations">
    1707. 

  1707. </colgroup>
    1708. 

  1708. <tbody><tr>
    1709. 

  1709. <td class="parameter_name"><p>client</p></td>
    1710. 

  1710. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
    1711. 

  1711. <td class="parameter_annotations"> </td>
    1712. 

  1712. </tr></tbody>
    1713. 

  1713. </table></div>
    1714. 

  1714. </div>
    1715. 

  1715. <div class="refsect3">
    1716. 

  1716. <a name="g-socket-client-get-tls-validation-flags.returns"></a><h4>Returns</h4>
    1717. 

  1717. <p> the TLS validation flags</p>
    1718. 

  1718. </div>
    1719. 

  1719. <p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
    1720. 

  1720. </div>
    1721. 

  1721. <hr>
    1722. 

  1722. <div class="refsect2">
    1723. 

  1723. <a name="g-socket-client-add-application-proxy"></a><h3>g_socket_client_add_application_proxy ()</h3>
    1724. 

  1724. <pre class="programlisting"><span class="returnvalue">void</span>
    1725. 

  1725. g_socket_client_add_application_proxy (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
    1726. 

  1726.                                        <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *protocol</code></em>);</pre>
    1727. 

  1727. <p>Enable proxy protocols to be handled by the application. When the
    1728. 

  1728. indicated proxy protocol is returned by the <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a>,
    1729. 

  1729. <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> will consider this protocol as supported but will
    1730. 

  1730. not try to find a <a class="link" href="GProxy.html" title="GProxy"><span class="type">GProxy</span></a> instance to handle handshaking. The
    1731. 

  1731. application must check for this case by calling
    1732. 

  1732. <a class="link" href="GSocketConnection.html#g-socket-connection-get-remote-address" title="g_socket_connection_get_remote_address ()"><code class="function">g_socket_connection_get_remote_address()</code></a> on the returned
    1733. 

  1733. <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>, and seeing if it's a <a class="link" href="GProxyAddress.html" title="GProxyAddress"><span class="type">GProxyAddress</span></a> of the
    1734. 

  1734. appropriate type, to determine whether or not it needs to handle
    1735. 

  1735. the proxy handshaking itself.</p>
    1736. 

  1736. <p>This should be used for proxy protocols that are dialects of
    1737. 

  1737. another protocol such as HTTP proxy. It also allows cohabitation of
    1738. 

  1738. proxy protocols that are reused between protocols. A good example
    1739. 

  1739. is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also
    1740. 

  1740. be use as generic socket proxy through the HTTP CONNECT method.</p>
    1741. 

  1741. <p>When the proxy is detected as being an application proxy, TLS handshake
    1742. 

  1742. will be skipped. This is required to let the application do the proxy
    1743. 

  1743. specific handshake.</p>
    1744. 

  1744. <div class="refsect3">
    1745. 

  1745. <a name="g-socket-client-add-application-proxy.parameters"></a><h4>Parameters</h4>
    1746. 

  1746. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1747. 

  1747. <colgroup>
    1748. 

  1748. <col width="150px" class="parameters_name">
    1749. 

  1749. <col class="parameters_description">
    1750. 

  1750. <col width="200px" class="parameters_annotations">
    1751. 

  1751. </colgroup>
    1752. 

  1752. <tbody>
    1753. 

  1753. <tr>
    1754. 

  1754. <td class="parameter_name"><p>client</p></td>
    1755. 

  1755. <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    1756. 

  1756. <td class="parameter_annotations"> </td>
    1757. 

  1757. </tr>
    1758. 

  1758. <tr>
    1759. 

  1759. <td class="parameter_name"><p>protocol</p></td>
    1760. 

  1760. <td class="parameter_description"><p>The proxy protocol</p></td>
    1761. 

  1761. <td class="parameter_annotations"> </td>
    1762. 

  1762. </tr>
    1763. 

  1763. </tbody>
    1764. 

  1764. </table></div>
    1765. 

  1765. </div>
    1766. 

  1766. </div>
    1767. 

  1767. </div>
    1768. 

  1768. <div class="refsect1">
    1769. 

  1769. <a name="GSocketClient.other_details"></a><h2>Types and Values</h2>
    1770. 

  1770. <div class="refsect2">
    1771. 

  1771. <a name="GSocketClient-struct"></a><h3>GSocketClient</h3>
    1772. 

  1772. <pre class="programlisting">typedef struct _GSocketClient GSocketClient;</pre>
    1773. 

  1773. <p>A helper class for network clients to make connections.</p>
    1774. 

  1774. <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
    1775. 

  1775. </div>
    1776. 

  1776. <hr>
    1777. 

  1777. <div class="refsect2">
    1778. 

  1778. <a name="GSocketClientEvent"></a><h3>enum GSocketClientEvent</h3>
    1779. 

  1779. <p>Describes an event occurring on a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>. See the
    1780. 

  1780. <a class="link" href="GSocketClient.html#GSocketClient-event" title="The “event” signal"><span class="type">“event”</span></a> signal for more details.</p>
    1781. 

  1781. <p>Additional values may be added to this type in the future.</p>
    1782. 

  1782. <div class="refsect3">
    1783. 

  1783. <a name="GSocketClientEvent.members"></a><h4>Members</h4>
    1784. 

  1784. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    1785. 

  1785. <colgroup>
    1786. 

  1786. <col width="300px" class="enum_members_name">
    1787. 

  1787. <col class="enum_members_description">
    1788. 

  1788. <col width="200px" class="enum_members_annotations">
    1789. 

  1789. </colgroup>
    1790. 

  1790. <tbody>
    1791. 

  1791. <tr>
    1792. 

  1792. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-RESOLVING:CAPS"></a>G_SOCKET_CLIENT_RESOLVING</p></td>
    1793. 

  1793. <td class="enum_member_description">
    1794. 

  1794. <p>The client is doing a DNS lookup.</p>
    1795. 

  1795. </td>
    1796. 

  1796. <td class="enum_member_annotations"> </td>
    1797. 

  1797. </tr>
    1798. 

  1798. <tr>
    1799. 

  1799. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-RESOLVED:CAPS"></a>G_SOCKET_CLIENT_RESOLVED</p></td>
    1800. 

  1800. <td class="enum_member_description">
    1801. 

  1801. <p>The client has completed a DNS lookup.</p>
    1802. 

  1802. </td>
    1803. 

  1803. <td class="enum_member_annotations"> </td>
    1804. 

  1804. </tr>
    1805. 

  1805. <tr>
    1806. 

  1806. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-CONNECTING:CAPS"></a>G_SOCKET_CLIENT_CONNECTING</p></td>
    1807. 

  1807. <td class="enum_member_description">
    1808. 

  1808. <p>The client is connecting to a remote
    1809. 

  1809.   host (either a proxy or the destination server).</p>
    1810. 

  1810. </td>
    1811. 

  1811. <td class="enum_member_annotations"> </td>
    1812. 

  1812. </tr>
    1813. 

  1813. <tr>
    1814. 

  1814. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-CONNECTED:CAPS"></a>G_SOCKET_CLIENT_CONNECTED</p></td>
    1815. 

  1815. <td class="enum_member_description">
    1816. 

  1816. <p>The client has connected to a remote
    1817. 

  1817.   host.</p>
    1818. 

  1818. </td>
    1819. 

  1819. <td class="enum_member_annotations"> </td>
    1820. 

  1820. </tr>
    1821. 

  1821. <tr>
    1822. 

  1822. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-PROXY-NEGOTIATING:CAPS"></a>G_SOCKET_CLIENT_PROXY_NEGOTIATING</p></td>
    1823. 

  1823. <td class="enum_member_description">
    1824. 

  1824. <p>The client is negotiating
    1825. 

  1825.   with a proxy to connect to the destination server.</p>
    1826. 

  1826. </td>
    1827. 

  1827. <td class="enum_member_annotations"> </td>
    1828. 

  1828. </tr>
    1829. 

  1829. <tr>
    1830. 

  1830. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-PROXY-NEGOTIATED:CAPS"></a>G_SOCKET_CLIENT_PROXY_NEGOTIATED</p></td>
    1831. 

  1831. <td class="enum_member_description">
    1832. 

  1832. <p>The client has negotiated
    1833. 

  1833.   with the proxy server.</p>
    1834. 

  1834. </td>
    1835. 

  1835. <td class="enum_member_annotations"> </td>
    1836. 

  1836. </tr>
    1837. 

  1837. <tr>
    1838. 

  1838. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-TLS-HANDSHAKING:CAPS"></a>G_SOCKET_CLIENT_TLS_HANDSHAKING</p></td>
    1839. 

  1839. <td class="enum_member_description">
    1840. 

  1840. <p>The client is performing a
    1841. 

  1841.   TLS handshake.</p>
    1842. 

  1842. </td>
    1843. 

  1843. <td class="enum_member_annotations"> </td>
    1844. 

  1844. </tr>
    1845. 

  1845. <tr>
    1846. 

  1846. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-TLS-HANDSHAKED:CAPS"></a>G_SOCKET_CLIENT_TLS_HANDSHAKED</p></td>
    1847. 

  1847. <td class="enum_member_description">
    1848. 

  1848. <p>The client has performed a
    1849. 

  1849.   TLS handshake.</p>
    1850. 

  1850. </td>
    1851. 

  1851. <td class="enum_member_annotations"> </td>
    1852. 

  1852. </tr>
    1853. 

  1853. <tr>
    1854. 

  1854. <td class="enum_member_name"><p><a name="G-SOCKET-CLIENT-COMPLETE:CAPS"></a>G_SOCKET_CLIENT_COMPLETE</p></td>
    1855. 

  1855. <td class="enum_member_description">
    1856. 

  1856. <p>The client is done with a particular
    1857. 

  1857.   <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a>.</p>
    1858. 

  1858. </td>
    1859. 

  1859. <td class="enum_member_annotations"> </td>
    1860. 

  1860. </tr>
    1861. 

  1861. </tbody>
    1862. 

  1862. </table></div>
    1863. 

  1863. </div>
    1864. 

  1864. <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
    1865. 

  1865. </div>
    1866. 

  1866. </div>
    1867. 

  1867. <div class="refsect1">
    1868. 

  1868. <a name="GSocketClient.property-details"></a><h2>Property Details</h2>
    1869. 

  1869. <div class="refsect2">
    1870. 

  1870. <a name="GSocketClient--enable-proxy"></a><h3>The <code class="literal">“enable-proxy”</code> property</h3>
    1871. 

  1871. <pre class="programlisting">  “enable-proxy”             <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
    1872. 

  1872. <p>Enable proxy support.</p>
    1873. 

  1873. <p>Flags: Read / Write / Construct</p>
    1874. 

  1874. <p>Default value: TRUE</p>
    1875. 

  1875. </div>
    1876. 

  1876. <hr>
    1877. 

  1877. <div class="refsect2">
    1878. 

  1878. <a name="GSocketClient--family"></a><h3>The <code class="literal">“family”</code> property</h3>
    1879. 

  1879. <pre class="programlisting">  “family”                   <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></pre>
    1880. 

  1880. <p>The sockets address family to use for socket construction.</p>
    1881. 

  1881. <p>Flags: Read / Write / Construct</p>
    1882. 

  1882. <p>Default value: G_SOCKET_FAMILY_INVALID</p>
    1883. 

  1883. </div>
    1884. 

  1884. <hr>
    1885. 

  1885. <div class="refsect2">
    1886. 

  1886. <a name="GSocketClient--local-address"></a><h3>The <code class="literal">“local-address”</code> property</h3>
    1887. 

  1887. <pre class="programlisting">  “local-address”            <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *</pre>
    1888. 

  1888. <p>The local address constructed sockets will be bound to.</p>
    1889. 

  1889. <p>Flags: Read / Write / Construct</p>
    1890. 

  1890. </div>
    1891. 

  1891. <hr>
    1892. 

  1892. <div class="refsect2">
    1893. 

  1893. <a name="GSocketClient--protocol"></a><h3>The <code class="literal">“protocol”</code> property</h3>
    1894. 

  1894. <pre class="programlisting">  “protocol”                 <a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a></pre>
    1895. 

  1895. <p>The protocol to use for socket construction, or 0 for default.</p>
    1896. 

  1896. <p>Flags: Read / Write / Construct</p>
    1897. 

  1897. <p>Default value: G_SOCKET_PROTOCOL_DEFAULT</p>
    1898. 

  1898. </div>
    1899. 

  1899. <hr>
    1900. 

  1900. <div class="refsect2">
    1901. 

  1901. <a name="GSocketClient--proxy-resolver"></a><h3>The <code class="literal">“proxy-resolver”</code> property</h3>
    1902. 

  1902. <pre class="programlisting">  “proxy-resolver”           <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> *</pre>
    1903. 

  1903. <p>The proxy resolver to use</p>
    1904. 

  1904. <p>Flags: Read / Write / Construct</p>
    1905. 

  1905. <p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
    1906. 

  1906. </div>
    1907. 

  1907. <hr>
    1908. 

  1908. <div class="refsect2">
    1909. 

  1909. <a name="GSocketClient--timeout"></a><h3>The <code class="literal">“timeout”</code> property</h3>
    1910. 

  1910. <pre class="programlisting">  “timeout”                  <a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
    1911. 

  1911. <p>The I/O timeout for sockets, or 0 for none.</p>
    1912. 

  1912. <p>Flags: Read / Write / Construct</p>
    1913. 

  1913. <p>Default value: 0</p>
    1914. 

  1914. </div>
    1915. 

  1915. <hr>
    1916. 

  1916. <div class="refsect2">
    1917. 

  1917. <a name="GSocketClient--tls"></a><h3>The <code class="literal">“tls”</code> property</h3>
    1918. 

  1918. <pre class="programlisting">  “tls”                      <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
    1919. 

  1919. <p>Whether to create TLS connections.</p>
    1920. 

  1920. <p>Flags: Read / Write / Construct</p>
    1921. 

  1921. <p>Default value: FALSE</p>
    1922. 

  1922. </div>
    1923. 

  1923. <hr>
    1924. 

  1924. <div class="refsect2">
    1925. 

  1925. <a name="GSocketClient--tls-validation-flags"></a><h3>The <code class="literal">“tls-validation-flags”</code> property</h3>
    1926. 

  1926. <pre class="programlisting">  “tls-validation-flags”     <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a></pre>
    1927. 

  1927. <p>TLS validation flags to use.</p>
    1928. 

  1928. <p>Flags: Read / Write / Construct</p>
    1929. 

  1929. <p>Default value: G_TLS_CERTIFICATE_UNKNOWN_CA | G_TLS_CERTIFICATE_BAD_IDENTITY | G_TLS_CERTIFICATE_NOT_ACTIVATED | G_TLS_CERTIFICATE_EXPIRED | G_TLS_CERTIFICATE_REVOKED | G_TLS_CERTIFICATE_INSECURE | G_TLS_CERTIFICATE_GENERIC_ERROR</p>
    1930. 

  1930. </div>
    1931. 

  1931. <hr>
    1932. 

  1932. <div class="refsect2">
    1933. 

  1933. <a name="GSocketClient--type"></a><h3>The <code class="literal">“type”</code> property</h3>
    1934. 

  1934. <pre class="programlisting">  “type”                     <a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a></pre>
    1935. 

  1935. <p>The sockets type to use for socket construction.</p>
    1936. 

  1936. <p>Flags: Read / Write / Construct</p>
    1937. 

  1937. <p>Default value: G_SOCKET_TYPE_STREAM</p>
    1938. 

  1938. </div>
    1939. 

  1939. </div>
    1940. 

  1940. <div class="refsect1">
    1941. 

  1941. <a name="GSocketClient.signal-details"></a><h2>Signal Details</h2>
    1942. 

  1942. <div class="refsect2">
    1943. 

  1943. <a name="GSocketClient-event"></a><h3>The <code class="literal">“event”</code> signal</h3>
    1944. 

  1944. <pre class="programlisting"><span class="returnvalue">void</span>
    1945. 

  1945. user_function (<a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>      *client,
    1946. 

  1946.                <a class="link" href="GSocketClient.html#GSocketClientEvent" title="enum GSocketClientEvent"><span class="type">GSocketClientEvent</span></a>  event,
    1947. 

  1947.                <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *connectable,
    1948. 

  1948.                <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a>          *connection,
    1949. 

  1949.                <a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>            user_data)</pre>
    1950. 

  1950. <p>Emitted when <em class="parameter"><code>client</code></em>
    1951. 

  1951. 's activity on <em class="parameter"><code>connectable</code></em>
    1952. 

  1952.  changes state.
    1953. 

  1953. Among other things, this can be used to provide progress
    1954. 

  1954. information about a network connection in the UI. The meanings of
    1955. 

  1955. the different <em class="parameter"><code>event</code></em>
    1956. 

  1956.  values are as follows:</p>
    1957. 

  1957. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
    1958. 

  1958. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-RESOLVING:CAPS"><code class="literal">G_SOCKET_CLIENT_RESOLVING</code></a>: <em class="parameter"><code>client</code></em>
    1959. 

  1959.  is about to look up <em class="parameter"><code>connectable</code></em>
    1960. 

  1960. 

  1961. in DNS. <em class="parameter"><code>connection</code></em>
    1962. 

  1962.  will be <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></li>
    1963. 

  1963. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-RESOLVED:CAPS"><code class="literal">G_SOCKET_CLIENT_RESOLVED</code></a>:  <em class="parameter"><code>client</code></em>
    1964. 

  1964.  has successfully resolved
    1965. 

  1965. <em class="parameter"><code>connectable</code></em>
    1966. 

  1966.  in DNS. <em class="parameter"><code>connection</code></em>
    1967. 

  1967.  will be <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></li>
    1968. 

  1968. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-CONNECTING:CAPS"><code class="literal">G_SOCKET_CLIENT_CONNECTING</code></a>: <em class="parameter"><code>client</code></em>
    1969. 

  1969.  is about to make a connection
    1970. 

  1970. to a remote host; either a proxy server or the destination server
    1971. 

  1971. itself. <em class="parameter"><code>connection</code></em>
    1972. 

  1972.  is the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>, which is not yet
    1973. 

  1973. connected.  Since GLib 2.40, you can access the remote
    1974. 

  1974. address via <a class="link" href="GSocketConnection.html#g-socket-connection-get-remote-address" title="g_socket_connection_get_remote_address ()"><code class="function">g_socket_connection_get_remote_address()</code></a>.</p></li>
    1975. 

  1975. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-CONNECTED:CAPS"><code class="literal">G_SOCKET_CLIENT_CONNECTED</code></a>: <em class="parameter"><code>client</code></em>
    1976. 

  1976.  has successfully connected
    1977. 

  1977. to a remote host. <em class="parameter"><code>connection</code></em>
    1978. 

  1978.  is the connected <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>.</p></li>
    1979. 

  1979. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-PROXY-NEGOTIATING:CAPS"><code class="literal">G_SOCKET_CLIENT_PROXY_NEGOTIATING</code></a>: <em class="parameter"><code>client</code></em>
    1980. 

  1980.  is about to negotiate
    1981. 

  1981. with a proxy to get it to connect to <em class="parameter"><code>connectable</code></em>
    1982. 

  1982. . <em class="parameter"><code>connection</code></em>
    1983. 

  1983.  is
    1984. 

  1984. the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> to the proxy server.</p></li>
    1985. 

  1985. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-PROXY-NEGOTIATED:CAPS"><code class="literal">G_SOCKET_CLIENT_PROXY_NEGOTIATED</code></a>: <em class="parameter"><code>client</code></em>
    1986. 

  1986.  has negotiated a
    1987. 

  1987. connection to <em class="parameter"><code>connectable</code></em>
    1988. 

  1988.  through a proxy server. <em class="parameter"><code>connection</code></em>
    1989. 

  1989.  is
    1990. 

  1990. the stream returned from <a class="link" href="GProxy.html#g-proxy-connect" title="g_proxy_connect ()"><code class="function">g_proxy_connect()</code></a>, which may or may not
    1991. 

  1991. be a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>.</p></li>
    1992. 

  1992. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-TLS-HANDSHAKING:CAPS"><code class="literal">G_SOCKET_CLIENT_TLS_HANDSHAKING</code></a>: <em class="parameter"><code>client</code></em>
    1993. 

  1993.  is about to begin a TLS
    1994. 

  1994. handshake. <em class="parameter"><code>connection</code></em>
    1995. 

  1995.  is a <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>.</p></li>
    1996. 

  1996. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-TLS-HANDSHAKED:CAPS"><code class="literal">G_SOCKET_CLIENT_TLS_HANDSHAKED</code></a>: <em class="parameter"><code>client</code></em>
    1997. 

  1997.  has successfully completed
    1998. 

  1998. the TLS handshake. <em class="parameter"><code>connection</code></em>
    1999. 

  1999.  is a <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>.</p></li>
    2000. 

  2000. <li class="listitem"><p><a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-COMPLETE:CAPS"><code class="literal">G_SOCKET_CLIENT_COMPLETE</code></a>: <em class="parameter"><code>client</code></em>
    2001. 

  2001.  has either successfully connected
    2002. 

  2002. to <em class="parameter"><code>connectable</code></em>
    2003. 

  2003.  (in which case <em class="parameter"><code>connection</code></em>
    2004. 

  2004.  is the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>
    2005. 

  2005. that it will be returning to the caller) or has failed (in which
    2006. 

  2006. case <em class="parameter"><code>connection</code></em>
    2007. 

  2007.  is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and the client is about to return an error).</p></li>
    2008. 

  2008. </ul></div>
    2009. 

  2009. <p>Each event except <a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-COMPLETE:CAPS"><code class="literal">G_SOCKET_CLIENT_COMPLETE</code></a> may be emitted
    2010. 

  2010. multiple times (or not at all) for a given connectable (in
    2011. 

  2011. particular, if <em class="parameter"><code>client</code></em>
    2012. 

  2012.  ends up attempting to connect to more than
    2013. 

  2013. one address). However, if <em class="parameter"><code>client</code></em>
    2014. 

  2014.  emits the <a class="link" href="GSocketClient.html#GSocketClient-event" title="The “event” signal"><span class="type">“event”</span></a>
    2015. 

  2015. signal at all for a given connectable, that it will always emit
    2016. 

  2016. it with <a class="link" href="GSocketClient.html#G-SOCKET-CLIENT-COMPLETE:CAPS"><code class="literal">G_SOCKET_CLIENT_COMPLETE</code></a> when it is done.</p>
    2017. 

  2017. <p>Note that there may be additional <a class="link" href="GSocketClient.html#GSocketClientEvent" title="enum GSocketClientEvent"><span class="type">GSocketClientEvent</span></a> values in
    2018. 

  2018. the future; unrecognized <em class="parameter"><code>event</code></em>
    2019. 

  2019.  values should be ignored.</p>
    2020. 

  2020. <div class="refsect3">
    2021. 

  2021. <a name="GSocketClient-event.parameters"></a><h4>Parameters</h4>
    2022. 

  2022. <div class="informaltable"><table class="informaltable" width="100%" border="0">
    2023. 

  2023. <colgroup>
    2024. 

  2024. <col width="150px" class="parameters_name">
    2025. 

  2025. <col class="parameters_description">
    2026. 

  2026. <col width="200px" class="parameters_annotations">
    2027. 

  2027. </colgroup>
    2028. 

  2028. <tbody>
    2029. 

  2029. <tr>
    2030. 

  2030. <td class="parameter_name"><p>client</p></td>
    2031. 

  2031. <td class="parameter_description"><p>the <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
    2032. 

  2032. <td class="parameter_annotations"> </td>
    2033. 

  2033. </tr>
    2034. 

  2034. <tr>
    2035. 

  2035. <td class="parameter_name"><p>event</p></td>
    2036. 

  2036. <td class="parameter_description"><p>the event that is occurring</p></td>
    2037. 

  2037. <td class="parameter_annotations"> </td>
    2038. 

  2038. </tr>
    2039. 

  2039. <tr>
    2040. 

  2040. <td class="parameter_name"><p>connectable</p></td>
    2041. 

  2041. <td class="parameter_description"><p>the <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> that <em class="parameter"><code>event</code></em>
    2042. 

  2042. is occurring on</p></td>
    2043. 

  2043. <td class="parameter_annotations"> </td>
    2044. 

  2044. </tr>
    2045. 

  2045. <tr>
    2046. 

  2046. <td class="parameter_name"><p>connection</p></td>
    2047. 

  2047. <td class="parameter_description"><p> the current representation of the connection. </p></td>
    2048. 

  2048. <td class="parameter_annotations"><span class="annotation">[<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>
    2049. 

  2049. </tr>
    2050. 

  2050. <tr>
    2051. 

  2051. <td class="parameter_name"><p>user_data</p></td>
    2052. 

  2052. <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
    2053. 

  2053. <td class="parameter_annotations"> </td>
    2054. 

  2054. </tr>
    2055. 

  2055. </tbody>
    2056. 

  2056. </table></div>
    2057. 

  2057. </div>
    2058. 

  2058. <p>Flags: <a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
    2059. 

  2059. <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
    2060. 

  2060. </div>
    2061. 

  2061. </div>
    2062. 

  2062. <div class="refsect1">
    2063. 

  2063. <a name="GSocketClient.see-also"></a><h2>See Also</h2>
    2064. 

  2064. <p><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>, <a class="link" href="GSocketListener.html" title="GSocketListener"><span class="type">GSocketListener</span></a></p>
    2065. 

  2065. </div>
    2066. 

  2066. </div>
    2067. 

  2067. <div class="footer">
    2068. 

  2068. <hr>Generated by GTK-Doc V1.25.1</div>
    2069. 

  2069. </body>
    2070. 

  2070. </html>
    2071.