glib2 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (620) hide show
  1. data/ChangeLog +46 -0
  2. data/Rakefile +1 -0
  3. data/ext/glib2/rbglib.h +1 -1
  4. data/ext/glib2/rbglib_iochannel.c +15 -6
  5. data/ext/glib2/rbgobj_signal.c +1 -1
  6. data/ext/glib2/rbgobject.h +1 -1
  7. data/lib/1.8/glib2.so +0 -0
  8. data/lib/1.9/glib2.so +0 -0
  9. data/lib/gnome2-raketask.rb +3 -2
  10. data/lib/mkmf-gnome2.rb +47 -23
  11. data/test/glib-test-init.rb +1 -3
  12. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  13. data/vendor/local/bin/glib-gettextize +2 -2
  14. data/vendor/local/bin/glib-mkenums +3 -2
  15. data/vendor/local/bin/gobject-query.exe +0 -0
  16. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  17. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  18. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  19. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  20. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  21. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  22. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  23. data/vendor/local/include/glib-2.0/gio/gaction.h +91 -0
  24. data/vendor/local/include/glib-2.0/gio/gactiongroup.h +151 -0
  25. data/vendor/local/include/glib-2.0/gio/gappinfo.h +11 -1
  26. data/vendor/local/include/glib-2.0/gio/gapplication.h +165 -0
  27. data/vendor/local/include/glib-2.0/gio/gapplicationcommandline.h +118 -0
  28. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +2 -2
  29. data/vendor/local/include/glib-2.0/gio/gcancellable.h +2 -0
  30. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +15 -0
  31. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +2 -2
  32. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +1 -1
  33. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +1 -1
  34. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +1 -1
  35. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +1 -1
  36. data/vendor/local/include/glib-2.0/gio/gio.h +14 -0
  37. data/vendor/local/include/glib-2.0/gio/gioenums.h +158 -2
  38. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +12 -0
  39. data/vendor/local/include/glib-2.0/gio/giomodule.h +1 -1
  40. data/vendor/local/include/glib-2.0/gio/giostream.h +11 -0
  41. data/vendor/local/include/glib-2.0/gio/giotypes.h +48 -0
  42. data/vendor/local/include/glib-2.0/gio/goutputstream.h +1 -1
  43. data/vendor/local/include/glib-2.0/gio/gpollableinputstream.h +101 -0
  44. data/vendor/local/include/glib-2.0/gio/gpollableoutputstream.h +98 -0
  45. data/vendor/local/include/glib-2.0/gio/gsettings.h +9 -2
  46. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +6 -0
  47. data/vendor/local/include/glib-2.0/gio/gsimpleaction.h +95 -0
  48. data/vendor/local/include/glib-2.0/gio/gsimpleactiongroup.h +87 -0
  49. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +11 -1
  50. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +7 -0
  51. data/vendor/local/include/glib-2.0/gio/gtcpwrapperconnection.h +68 -0
  52. data/vendor/local/include/glib-2.0/gio/gtlsbackend.h +92 -0
  53. data/vendor/local/include/glib-2.0/gio/gtlscertificate.h +83 -0
  54. data/vendor/local/include/glib-2.0/gio/gtlsclientconnection.h +72 -0
  55. data/vendor/local/include/glib-2.0/gio/gtlsconnection.h +136 -0
  56. data/vendor/local/include/glib-2.0/gio/gtlsserverconnection.h +61 -0
  57. data/vendor/local/include/glib-2.0/glib/glist.h +2 -0
  58. data/vendor/local/include/glib-2.0/glib/gmain.h +27 -6
  59. data/vendor/local/include/glib-2.0/glib/gmarkup.h +80 -5
  60. data/vendor/local/include/glib-2.0/glib/grand.h +1 -1
  61. data/vendor/local/include/glib-2.0/glib/gsequence.h +8 -0
  62. data/vendor/local/include/glib-2.0/glib/gslist.h +2 -0
  63. data/vendor/local/include/glib-2.0/glib/gtimezone.h +37 -0
  64. data/vendor/local/include/glib-2.0/glib/gtypes.h +1 -0
  65. data/vendor/local/include/glib-2.0/glib/gunicode.h +22 -16
  66. data/vendor/local/include/glib-2.0/glib/gutils.h +5 -0
  67. data/vendor/local/include/glib-2.0/glib/gvariant.h +35 -11
  68. data/vendor/local/include/glib-2.0/gobject/gobject.h +15 -0
  69. data/vendor/local/include/glib-2.0/gobject/gsignal.h +5 -0
  70. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +4 -2
  71. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +1 -1
  72. data/vendor/local/lib/gio-2.0.def +142 -0
  73. data/vendor/local/lib/gio-2.0.lib +0 -0
  74. data/vendor/local/lib/glib-2.0.def +21 -0
  75. data/vendor/local/lib/glib-2.0.lib +0 -0
  76. data/vendor/local/lib/glib-2.0/include/glibconfig.h +1 -1
  77. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  78. data/vendor/local/lib/gobject-2.0.def +3 -0
  79. data/vendor/local/lib/gobject-2.0.lib +0 -0
  80. data/vendor/local/lib/gthread-2.0.lib +0 -0
  81. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  82. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  83. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  84. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  85. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  86. data/vendor/local/lib/pkgconfig/gio-2.0.pc +2 -2
  87. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +1 -1
  88. data/vendor/local/lib/pkgconfig/glib-2.0.pc +1 -1
  89. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +1 -1
  90. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +1 -1
  91. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +1 -1
  92. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +1 -1
  93. data/vendor/local/manifest/{glib-dev_2.26.1-1_win32.mft → glib-dev_2.28.1-1_win32.mft} +55 -19
  94. data/vendor/local/manifest/{glib_2.26.1-1_win32.mft → glib_2.28.1-1_win32.mft} +3 -2
  95. data/vendor/local/share/aclocal/glib-2.0.m4 +4 -4
  96. data/vendor/local/share/doc/{glib-2.26.1 → glib-2.28.1}/COPYING +0 -0
  97. data/vendor/local/share/doc/{glib-dev-2.26.1 → glib-dev-2.28.1}/COPYING +0 -0
  98. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +72 -21
  99. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +21 -8
  100. data/vendor/local/share/gtk-doc/html/gio/GAction.html +469 -0
  101. data/vendor/local/share/gtk-doc/html/gio/GActionGroup.html +754 -0
  102. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +296 -249
  103. data/vendor/local/share/gtk-doc/html/gio/GApplication.html +1458 -0
  104. data/vendor/local/share/gtk-doc/html/gio/GApplicationCommandLine.html +815 -0
  105. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +61 -97
  106. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +31 -38
  107. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +52 -68
  108. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +38 -50
  109. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +120 -77
  110. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +26 -34
  111. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +49 -51
  112. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +39 -62
  113. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +26 -35
  114. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +415 -650
  115. data/vendor/local/share/gtk-doc/html/gio/{gio-GDBusError.html → GDBusError.html} +118 -147
  116. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +204 -347
  117. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +66 -111
  118. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +210 -309
  119. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +68 -87
  120. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +190 -232
  121. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +89 -118
  122. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +196 -270
  123. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +40 -46
  124. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +56 -24
  125. data/vendor/local/share/gtk-doc/html/gio/GFile.html +1090 -1443
  126. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +13 -16
  127. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +66 -86
  128. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +31 -45
  129. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +19 -21
  130. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +466 -602
  131. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +32 -40
  132. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +60 -59
  133. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +32 -47
  134. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +37 -45
  135. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +22 -26
  136. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +22 -26
  137. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +32 -38
  138. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +184 -52
  139. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +45 -54
  140. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +96 -125
  141. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +21 -25
  142. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +49 -71
  143. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +102 -134
  144. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +43 -54
  145. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +21 -24
  146. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +34 -41
  147. data/vendor/local/share/gtk-doc/html/gio/GMount.html +223 -294
  148. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +127 -153
  149. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +35 -46
  150. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +37 -46
  151. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +138 -174
  152. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +46 -68
  153. data/vendor/local/share/gtk-doc/html/gio/GPollableInputStream.html +398 -0
  154. data/vendor/local/share/gtk-doc/html/gio/GPollableOutputStream.html +340 -0
  155. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +89 -32
  156. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +42 -56
  157. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +59 -34
  158. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +82 -95
  159. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +58 -72
  160. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +597 -357
  161. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +125 -75
  162. data/vendor/local/share/gtk-doc/html/gio/GSimpleAction.html +339 -0
  163. data/vendor/local/share/gtk-doc/html/gio/GSimpleActionGroup.html +200 -0
  164. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +232 -167
  165. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +15 -16
  166. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +291 -406
  167. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +39 -45
  168. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +301 -223
  169. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +41 -44
  170. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +41 -49
  171. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +22 -32
  172. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +88 -107
  173. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +26 -32
  174. data/vendor/local/share/gtk-doc/html/gio/{gio-GSrvTarget.html → GSrvTarget.html} +74 -77
  175. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +21 -22
  176. data/vendor/local/share/gtk-doc/html/gio/GTcpWrapperConnection.html +156 -0
  177. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +40 -46
  178. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +29 -35
  179. data/vendor/local/share/gtk-doc/html/gio/GTlsBackend.html +260 -0
  180. data/vendor/local/share/gtk-doc/html/gio/GTlsCertificate.html +396 -0
  181. data/vendor/local/share/gtk-doc/html/gio/GTlsClientConnection.html +428 -0
  182. data/vendor/local/share/gtk-doc/html/gio/GTlsConnection.html +869 -0
  183. data/vendor/local/share/gtk-doc/html/gio/GTlsServerConnection.html +158 -0
  184. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +32 -41
  185. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +28 -34
  186. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +44 -54
  187. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +36 -41
  188. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +35 -32
  189. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +35 -32
  190. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +59 -67
  191. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +49 -57
  192. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +142 -187
  193. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +99 -132
  194. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +33 -32
  195. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +22 -24
  196. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +43 -13
  197. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +5 -5
  198. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +10 -3
  199. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +20 -20
  200. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +8 -8
  201. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +36 -28
  202. data/vendor/local/share/gtk-doc/html/gio/api-index-2-28.html +744 -0
  203. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +3 -3
  204. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +915 -107
  205. data/vendor/local/share/gtk-doc/html/gio/application.html +50 -0
  206. data/vendor/local/share/gtk-doc/html/gio/async.html +5 -5
  207. data/vendor/local/share/gtk-doc/html/gio/ch01.html +4 -4
  208. data/vendor/local/share/gtk-doc/html/gio/ch02.html +5 -5
  209. data/vendor/local/share/gtk-doc/html/gio/ch03.html +23 -24
  210. data/vendor/local/share/gtk-doc/html/gio/ch26.html +54 -36
  211. data/vendor/local/share/gtk-doc/html/gio/ch27.html +188 -41
  212. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +19 -108
  213. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +16 -179
  214. data/vendor/local/share/gtk-doc/html/gio/ch28.html +57 -0
  215. data/vendor/local/share/gtk-doc/html/gio/{ch26s02.html → ch28s02.html} +10 -10
  216. data/vendor/local/share/gtk-doc/html/gio/{ch26s03.html → ch28s03.html} +10 -10
  217. data/vendor/local/share/gtk-doc/html/gio/{ch26s04.html → ch28s04.html} +10 -10
  218. data/vendor/local/share/gtk-doc/html/gio/{ch26s05.html → ch28s05.html} +10 -10
  219. data/vendor/local/share/gtk-doc/html/gio/{ch26s06.html → ch28s06.html} +17 -15
  220. data/vendor/local/share/gtk-doc/html/gio/{ch26s07.html → ch28s07.html} +10 -10
  221. data/vendor/local/share/gtk-doc/html/gio/ch29.html +70 -0
  222. data/vendor/local/share/gtk-doc/html/gio/ch29s02.html +130 -0
  223. data/vendor/local/share/gtk-doc/html/gio/ch29s03.html +202 -0
  224. data/vendor/local/share/gtk-doc/html/gio/{ch27s04.html → ch29s04.html} +11 -11
  225. data/vendor/local/share/gtk-doc/html/gio/{ch27s05.html → ch29s05.html} +12 -12
  226. data/vendor/local/share/gtk-doc/html/gio/{ch27s06.html → ch29s06.html} +10 -10
  227. data/vendor/local/share/gtk-doc/html/gio/conversion.html +3 -3
  228. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +27 -14
  229. data/vendor/local/share/gtk-doc/html/gio/extending.html +5 -5
  230. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +3 -3
  231. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +3 -3
  232. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +3 -3
  233. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +3 -3
  234. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +6 -6
  235. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +18 -18
  236. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +39 -62
  237. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +141 -248
  238. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +28 -40
  239. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +29 -112
  240. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +45 -57
  241. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +58 -68
  242. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +16 -18
  243. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +18 -20
  244. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +82 -76
  245. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +34 -28
  246. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +25 -33
  247. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +87 -113
  248. data/vendor/local/share/gtk-doc/html/gio/gio-TLS-Overview.html +287 -0
  249. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +119 -151
  250. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +62 -95
  251. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +66 -6
  252. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +8 -8
  253. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +312 -91
  254. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +386 -133
  255. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +12 -12
  256. data/vendor/local/share/gtk-doc/html/gio/gsettings-tool.html +162 -0
  257. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +7 -4
  258. data/vendor/local/share/gtk-doc/html/gio/icons.html +3 -3
  259. data/vendor/local/share/gtk-doc/html/gio/index.html +88 -36
  260. data/vendor/local/share/gtk-doc/html/gio/index.sgml +506 -95
  261. data/vendor/local/share/gtk-doc/html/gio/migrating.html +23 -23
  262. data/vendor/local/share/gtk-doc/html/gio/networking.html +3 -3
  263. data/vendor/local/share/gtk-doc/html/gio/permissions.html +5 -5
  264. data/vendor/local/share/gtk-doc/html/gio/pt01.html +4 -4
  265. data/vendor/local/share/gtk-doc/html/gio/pt02.html +68 -17
  266. data/vendor/local/share/gtk-doc/html/gio/resolver.html +6 -6
  267. data/vendor/local/share/gtk-doc/html/gio/settings.html +7 -7
  268. data/vendor/local/share/gtk-doc/html/gio/streaming.html +9 -3
  269. data/vendor/local/share/gtk-doc/html/gio/style.css +2 -1
  270. data/vendor/local/share/gtk-doc/html/gio/tls.html +50 -0
  271. data/vendor/local/share/gtk-doc/html/gio/tools.html +4 -4
  272. data/vendor/local/share/gtk-doc/html/gio/types.html +6 -6
  273. data/vendor/local/share/gtk-doc/html/gio/utils.html +7 -7
  274. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +4 -4
  275. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +8 -11
  276. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +3 -3
  277. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +3 -3
  278. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +3 -3
  279. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +3 -3
  280. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +4 -4
  281. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +3 -3
  282. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +3 -3
  283. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +3 -3
  284. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +3 -3
  285. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +25 -5
  286. data/vendor/local/share/gtk-doc/html/glib/api-index-2-28.html +112 -0
  287. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +6 -6
  288. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +15 -11
  289. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +5 -5
  290. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +9 -5
  291. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +201 -89
  292. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +144 -210
  293. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +97 -136
  294. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +40 -58
  295. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +99 -128
  296. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +104 -155
  297. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +42 -71
  298. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +40 -43
  299. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +224 -314
  300. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +104 -142
  301. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +193 -308
  302. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +51 -76
  303. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +170 -307
  304. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +154 -198
  305. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +45 -67
  306. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +60 -97
  307. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +390 -428
  308. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +265 -333
  309. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +306 -330
  310. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +60 -99
  311. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +122 -152
  312. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +241 -571
  313. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +233 -330
  314. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +310 -34
  315. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +739 -590
  316. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +136 -143
  317. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +22 -29
  318. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +210 -297
  319. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +294 -355
  320. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +27 -39
  321. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +102 -95
  322. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +402 -486
  323. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +308 -442
  324. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +75 -116
  325. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +229 -297
  326. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +36 -36
  327. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +121 -187
  328. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +23 -27
  329. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +80 -107
  330. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +46 -69
  331. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +63 -99
  332. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +121 -115
  333. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +304 -327
  334. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +307 -366
  335. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +39 -20
  336. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +230 -343
  337. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +121 -167
  338. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +31 -45
  339. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +73 -113
  340. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +75 -106
  341. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +229 -184
  342. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +31 -40
  343. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +247 -286
  344. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +281 -283
  345. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +83 -337
  346. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +65 -80
  347. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +36 -42
  348. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +408 -621
  349. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +253 -322
  350. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +161 -252
  351. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +677 -590
  352. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +88 -111
  353. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +378 -475
  354. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +27 -48
  355. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +39 -48
  356. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +19 -25
  357. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +57 -93
  358. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +413 -534
  359. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +117 -21
  360. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +38 -53
  361. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +60 -114
  362. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +38 -39
  363. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +7 -13
  364. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +5 -5
  365. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +3 -3
  366. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +19 -19
  367. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +6 -3
  368. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +3 -3
  369. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +10 -10
  370. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +82 -82
  371. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +9 -9
  372. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +26 -26
  373. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +3 -3
  374. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +144 -103
  375. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +170 -105
  376. data/vendor/local/share/gtk-doc/html/glib/glib.html +3 -3
  377. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +10 -10
  378. data/vendor/local/share/gtk-doc/html/glib/gtester.html +10 -10
  379. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +48 -43
  380. data/vendor/local/share/gtk-doc/html/glib/gvariant-text.html +660 -0
  381. data/vendor/local/share/gtk-doc/html/glib/index.html +8 -4
  382. data/vendor/local/share/gtk-doc/html/glib/index.sgml +67 -2
  383. data/vendor/local/share/gtk-doc/html/glib/style.css +2 -1
  384. data/vendor/local/share/gtk-doc/html/glib/tools.html +5 -5
  385. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +72 -90
  386. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +79 -108
  387. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +67 -85
  388. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +63 -9
  389. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +4 -4
  390. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +3 -3
  391. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +3 -3
  392. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +3 -3
  393. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +3 -3
  394. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +3 -3
  395. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +3 -3
  396. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +6 -6
  397. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-28.html +47 -0
  398. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +4 -4
  399. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +3 -3
  400. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +3 -3
  401. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +3 -3
  402. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +65 -53
  403. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +7 -7
  404. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +4 -4
  405. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +8 -11
  406. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +19 -19
  407. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +6 -6
  408. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +18 -18
  409. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +22 -22
  410. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +16 -16
  411. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +40 -54
  412. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +405 -512
  413. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +170 -213
  414. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +242 -292
  415. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +91 -127
  416. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +407 -573
  417. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +951 -1268
  418. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +383 -441
  419. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +648 -829
  420. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +82 -95
  421. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +31 -49
  422. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +8 -8
  423. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +15 -14
  424. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +10 -10
  425. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +62 -58
  426. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +62 -58
  427. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +6 -6
  428. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +11 -11
  429. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +14 -14
  430. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +6 -6
  431. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +5 -5
  432. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +3 -3
  433. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +7 -7
  434. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +3 -3
  435. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +9 -9
  436. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +10 -10
  437. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +4 -4
  438. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +7 -7
  439. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +6 -6
  440. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +6 -6
  441. data/vendor/local/share/gtk-doc/html/gobject/index.html +11 -10
  442. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +13 -1
  443. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +4 -4
  444. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +7 -7
  445. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +8 -8
  446. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +5 -5
  447. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +4 -4
  448. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +4 -4
  449. data/vendor/local/share/gtk-doc/html/gobject/signal.html +13 -13
  450. data/vendor/local/share/gtk-doc/html/gobject/style.css +2 -1
  451. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +3 -3
  452. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +3 -3
  453. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +6 -6
  454. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +3 -3
  455. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +3 -3
  456. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  457. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  458. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  459. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  460. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  461. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  462. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  463. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  464. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  465. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  466. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  467. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  468. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  469. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  470. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  471. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  472. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  473. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  474. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  475. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  476. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  477. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  478. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  479. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  480. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  481. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  482. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  483. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  484. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  485. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  486. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  487. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  488. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  489. data/vendor/local/share/locale/ug/LC_MESSAGES/glib20.mo +0 -0
  490. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  491. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  492. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  493. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  494. data/vendor/local/share/man/man1/glib-genmarshal.1 +2 -2
  495. data/vendor/local/share/man/man1/glib-mkenums.1 +2 -2
  496. data/vendor/local/share/man/man1/gobject-query.1 +2 -2
  497. data/vendor/local/src/tml/packaging/{glib_2.26.1-1_win32.log → glib_2.28.1-1_win32.log} +690 -773
  498. data/vendor/local/src/tml/packaging/{glib_2.26.1-1_win32.sh → glib_2.28.1-1_win32.sh} +2 -4
  499. metadata +78 -146
  500. data/ext/glib2/Makefile +0 -169
  501. data/ext/glib2/glib-enum-types.c +0 -1065
  502. data/ext/glib2/glib-enum-types.h +0 -144
  503. data/ext/glib2/ruby-glib2.pc +0 -3
  504. data/test-unit/COPYING +0 -56
  505. data/test-unit/GPL +0 -340
  506. data/test-unit/History.txt +0 -279
  507. data/test-unit/Manifest.txt +0 -110
  508. data/test-unit/PSFL +0 -271
  509. data/test-unit/README.txt +0 -75
  510. data/test-unit/Rakefile +0 -53
  511. data/test-unit/TODO +0 -5
  512. data/test-unit/bin/testrb +0 -5
  513. data/test-unit/html/bar.png +0 -0
  514. data/test-unit/html/bar.svg +0 -153
  515. data/test-unit/html/developer.png +0 -0
  516. data/test-unit/html/developer.svg +0 -469
  517. data/test-unit/html/famfamfam-logo.png +0 -0
  518. data/test-unit/html/favicon.ico +0 -0
  519. data/test-unit/html/favicon.png +0 -0
  520. data/test-unit/html/favicon.svg +0 -82
  521. data/test-unit/html/heading-mark.png +0 -0
  522. data/test-unit/html/heading-mark.svg +0 -393
  523. data/test-unit/html/index.html +0 -285
  524. data/test-unit/html/index.html.ja +0 -299
  525. data/test-unit/html/install.png +0 -0
  526. data/test-unit/html/install.svg +0 -636
  527. data/test-unit/html/jp.png +0 -0
  528. data/test-unit/html/kinotan-failure.png +0 -0
  529. data/test-unit/html/kinotan-pass.png +0 -0
  530. data/test-unit/html/logo.png +0 -0
  531. data/test-unit/html/logo.svg +0 -483
  532. data/test-unit/html/reference.png +0 -0
  533. data/test-unit/html/rubyforge.png +0 -0
  534. data/test-unit/html/tango-logo.png +0 -0
  535. data/test-unit/html/test-unit.css +0 -339
  536. data/test-unit/html/tutorial.png +0 -0
  537. data/test-unit/html/tutorial.svg +0 -559
  538. data/test-unit/html/us.png +0 -0
  539. data/test-unit/images/color-diff.png +0 -0
  540. data/test-unit/lib/test/unit.rb +0 -328
  541. data/test-unit/lib/test/unit/assertionfailederror.rb +0 -25
  542. data/test-unit/lib/test/unit/assertions.rb +0 -1792
  543. data/test-unit/lib/test/unit/attribute.rb +0 -125
  544. data/test-unit/lib/test/unit/autorunner.rb +0 -415
  545. data/test-unit/lib/test/unit/collector.rb +0 -38
  546. data/test-unit/lib/test/unit/collector/descendant.rb +0 -23
  547. data/test-unit/lib/test/unit/collector/dir.rb +0 -108
  548. data/test-unit/lib/test/unit/collector/load.rb +0 -187
  549. data/test-unit/lib/test/unit/collector/objectspace.rb +0 -34
  550. data/test-unit/lib/test/unit/collector/xml.rb +0 -250
  551. data/test-unit/lib/test/unit/color-scheme.rb +0 -106
  552. data/test-unit/lib/test/unit/color.rb +0 -96
  553. data/test-unit/lib/test/unit/diff.rb +0 -740
  554. data/test-unit/lib/test/unit/error.rb +0 -131
  555. data/test-unit/lib/test/unit/exceptionhandler.rb +0 -39
  556. data/test-unit/lib/test/unit/failure.rb +0 -136
  557. data/test-unit/lib/test/unit/fixture.rb +0 -185
  558. data/test-unit/lib/test/unit/notification.rb +0 -129
  559. data/test-unit/lib/test/unit/omission.rb +0 -191
  560. data/test-unit/lib/test/unit/pending.rb +0 -150
  561. data/test-unit/lib/test/unit/priority.rb +0 -180
  562. data/test-unit/lib/test/unit/runner/console.rb +0 -52
  563. data/test-unit/lib/test/unit/runner/emacs.rb +0 -8
  564. data/test-unit/lib/test/unit/runner/tap.rb +0 -8
  565. data/test-unit/lib/test/unit/runner/xml.rb +0 -15
  566. data/test-unit/lib/test/unit/testcase.rb +0 -515
  567. data/test-unit/lib/test/unit/testresult.rb +0 -125
  568. data/test-unit/lib/test/unit/testsuite.rb +0 -134
  569. data/test-unit/lib/test/unit/ui/console/outputlevel.rb +0 -14
  570. data/test-unit/lib/test/unit/ui/console/testrunner.rb +0 -467
  571. data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +0 -63
  572. data/test-unit/lib/test/unit/ui/tap/testrunner.rb +0 -82
  573. data/test-unit/lib/test/unit/ui/testrunner.rb +0 -53
  574. data/test-unit/lib/test/unit/ui/testrunnermediator.rb +0 -86
  575. data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +0 -41
  576. data/test-unit/lib/test/unit/ui/xml/testrunner.rb +0 -224
  577. data/test-unit/lib/test/unit/util/backtracefilter.rb +0 -42
  578. data/test-unit/lib/test/unit/util/method-owner-finder.rb +0 -28
  579. data/test-unit/lib/test/unit/util/observable.rb +0 -90
  580. data/test-unit/lib/test/unit/util/output.rb +0 -31
  581. data/test-unit/lib/test/unit/util/procwrapper.rb +0 -48
  582. data/test-unit/lib/test/unit/version.rb +0 -7
  583. data/test-unit/sample/adder.rb +0 -13
  584. data/test-unit/sample/subtracter.rb +0 -12
  585. data/test-unit/sample/test_adder.rb +0 -20
  586. data/test-unit/sample/test_subtracter.rb +0 -20
  587. data/test-unit/sample/test_user.rb +0 -23
  588. data/test-unit/test/collector/test-descendant.rb +0 -133
  589. data/test-unit/test/collector/test-load.rb +0 -442
  590. data/test-unit/test/collector/test_dir.rb +0 -406
  591. data/test-unit/test/collector/test_objectspace.rb +0 -100
  592. data/test-unit/test/run-test.rb +0 -22
  593. data/test-unit/test/test-assertions.rb +0 -1849
  594. data/test-unit/test/test-attribute.rb +0 -86
  595. data/test-unit/test/test-color-scheme.rb +0 -69
  596. data/test-unit/test/test-color.rb +0 -47
  597. data/test-unit/test/test-diff.rb +0 -518
  598. data/test-unit/test/test-emacs-runner.rb +0 -60
  599. data/test-unit/test/test-fixture.rb +0 -324
  600. data/test-unit/test/test-notification.rb +0 -33
  601. data/test-unit/test/test-omission.rb +0 -81
  602. data/test-unit/test/test-pending.rb +0 -70
  603. data/test-unit/test/test-priority.rb +0 -119
  604. data/test-unit/test/test-testcase.rb +0 -569
  605. data/test-unit/test/test_error.rb +0 -26
  606. data/test-unit/test/test_failure.rb +0 -33
  607. data/test-unit/test/test_testresult.rb +0 -113
  608. data/test-unit/test/test_testsuite.rb +0 -137
  609. data/test-unit/test/testunit-test-util.rb +0 -14
  610. data/test-unit/test/ui/test_tap.rb +0 -33
  611. data/test-unit/test/ui/test_testrunmediator.rb +0 -20
  612. data/test-unit/test/util/test-method-owner-finder.rb +0 -38
  613. data/test-unit/test/util/test-output.rb +0 -11
  614. data/test-unit/test/util/test_backtracefilter.rb +0 -41
  615. data/test-unit/test/util/test_observable.rb +0 -102
  616. data/test-unit/test/util/test_procwrapper.rb +0 -36
  617. data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
  618. data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
  619. data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
  620. data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
data/vendor/local/share/gtk-doc/html/gio/GTlsClientConnection.html ADDED
@@ -0,0 +1,428 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>GTlsClientConnection</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
+ <link rel="home" href="index.html" title="GIO Reference Manual">
8
+ <link rel="up" href="tls.html" title="TLS (SSL) support">
9
+ <link rel="prev" href="GTlsConnection.html" title="GTlsConnection">
10
+ <link rel="next" href="GTlsServerConnection.html" title="GTlsServerConnection">
11
+ <meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
14
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
+ <tr valign="middle">
17
+ <td><a accesskey="p" href="GTlsConnection.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="tls.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
+ <th width="100%" align="center">GIO Reference Manual</th>
21
+ <td><a accesskey="n" href="GTlsServerConnection.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
+ </tr>
23
+ <tr><td colspan="5" class="shortcuts">
24
+ <a href="#GTlsClientConnection.synopsis" class="shortcut">Top</a>
25
+  | 
26
+ <a href="#GTlsClientConnection.description" class="shortcut">Description</a>
27
+  | 
28
+ <a href="#GTlsClientConnection.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
+  | 
30
+ <a href="#GTlsClientConnection.prerequisites" class="shortcut">Prerequisites</a>
31
+  | 
32
+ <a href="#GTlsClientConnection.properties" class="shortcut">Properties</a>
33
+ </td></tr>
34
+ </table>
35
+ <div class="refentry">
36
+ <a name="GTlsClientConnection"></a><div class="titlepage"></div>
37
+ <div class="refnamediv"><table width="100%"><tr>
38
+ <td valign="top">
39
+ <h2><span class="refentrytitle"><a name="GTlsClientConnection.top_of_page"></a>GTlsClientConnection</span></h2>
40
+ <p>GTlsClientConnection — TLS client-side connection</p>
41
+ </td>
42
+ <td valign="top" align="right"></td>
43
+ </tr></table></div>
44
+ <div class="refsynopsisdiv">
45
+ <a name="GTlsClientConnection.synopsis"></a><h2>Synopsis</h2>
46
+ <pre class="synopsis">
47
+ #include &lt;gio/gio.h&gt;
48
+
49
+ <a class="link" href="GTlsClientConnection.html#GTlsClientConnection-struct" title="GTlsClientConnection">GTlsClientConnection</a>;
50
+ struct <a class="link" href="GTlsClientConnection.html#GTlsClientConnectionInterface" title="struct GTlsClientConnectionInterface">GTlsClientConnectionInterface</a>;
51
+ <a class="link" href="GIOStream.html" title="GIOStream"><span class="returnvalue">GIOStream</span></a> * <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-new" title="g_tls_client_connection_new ()">g_tls_client_connection_new</a> (<em class="parameter"><code><a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a> *base_io_stream</code></em>,
52
+ <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *server_identity</code></em>,
53
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
54
+ <span class="returnvalue">void</span> <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-set-server-identity" title="g_tls_client_connection_set_server_identity ()">g_tls_client_connection_set_server_identity</a>
55
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>,
56
+ <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *identity</code></em>);
57
+ <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="returnvalue">GSocketConnectable</span></a> * <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-get-server-identity" title="g_tls_client_connection_get_server_identity ()">g_tls_client_connection_get_server_identity</a>
58
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);
59
+ <span class="returnvalue">void</span> <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-set-validation-flags" title="g_tls_client_connection_set_validation_flags ()">g_tls_client_connection_set_validation_flags</a>
60
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>,
61
+ <em class="parameter"><code><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);
62
+ <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-get-validation-flags" title="g_tls_client_connection_get_validation_flags ()">g_tls_client_connection_get_validation_flags</a>
63
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);
64
+ <span class="returnvalue">void</span> <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-set-use-ssl3" title="g_tls_client_connection_set_use_ssl3 ()">g_tls_client_connection_set_use_ssl3</a>
65
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>,
66
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_ssl3</code></em>);
67
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-get-use-ssl3" title="g_tls_client_connection_get_use_ssl3 ()">g_tls_client_connection_get_use_ssl3</a>
68
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);
69
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-get-accepted-cas" title="g_tls_client_connection_get_accepted_cas ()">g_tls_client_connection_get_accepted_cas</a>
70
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);
71
+ </pre>
72
+ </div>
73
+ <div class="refsect1">
74
+ <a name="GTlsClientConnection.object-hierarchy"></a><h2>Object Hierarchy</h2>
75
+ <pre class="synopsis">
76
+ GInterface
77
+ +----GTlsClientConnection
78
+ </pre>
79
+ </div>
80
+ <div class="refsect1">
81
+ <a name="GTlsClientConnection.prerequisites"></a><h2>Prerequisites</h2>
82
+ <p>
83
+ GTlsClientConnection requires
84
+ <a class="link" href="GTlsConnection.html" title="GTlsConnection">GTlsConnection</a>.</p>
85
+ </div>
86
+ <div class="refsect1">
87
+ <a name="GTlsClientConnection.properties"></a><h2>Properties</h2>
88
+ <pre class="synopsis">
89
+ "<a class="link" href="GTlsClientConnection.html#GTlsClientConnection--accepted-cas" title='The "accepted-cas" property'>accepted-cas</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> : Read
90
+ "<a class="link" href="GTlsClientConnection.html#GTlsClientConnection--server-identity" title='The "server-identity" property'>server-identity</a>" <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a>* : Read / Write / Construct
91
+ "<a class="link" href="GTlsClientConnection.html#GTlsClientConnection--use-ssl3" title='The "use-ssl3" property'>use-ssl3</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct
92
+ "<a class="link" href="GTlsClientConnection.html#GTlsClientConnection--validation-flags" title='The "validation-flags" property'>validation-flags</a>" <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> : Read / Write / Construct
93
+ </pre>
94
+ </div>
95
+ <div class="refsect1">
96
+ <a name="GTlsClientConnection.description"></a><h2>Description</h2>
97
+ <p>
98
+ <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> is the client-side subclass of
99
+ <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>, representing a client-side TLS connection.
100
+ </p>
101
+ </div>
102
+ <div class="refsect1">
103
+ <a name="GTlsClientConnection.details"></a><h2>Details</h2>
104
+ <div class="refsect2">
105
+ <a name="GTlsClientConnection-struct"></a><h3>GTlsClientConnection</h3>
106
+ <pre class="programlisting">typedef struct _GTlsClientConnection GTlsClientConnection;</pre>
107
+ <p>
108
+ TLS client-side connection; the client-side implementation of a
109
+ <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
110
+ </p>
111
+ <p class="since">Since 2.28</p>
112
+ </div>
113
+ <hr>
114
+ <div class="refsect2">
115
+ <a name="GTlsClientConnectionInterface"></a><h3>struct GTlsClientConnectionInterface</h3>
116
+ <pre class="programlisting">struct GTlsClientConnectionInterface {
117
+ GTypeInterface g_iface;
118
+ };
119
+ </pre>
120
+ <p>
121
+ </p>
122
+ </div>
123
+ <hr>
124
+ <div class="refsect2">
125
+ <a name="g-tls-client-connection-new"></a><h3>g_tls_client_connection_new ()</h3>
126
+ <pre class="programlisting"><a class="link" href="GIOStream.html" title="GIOStream"><span class="returnvalue">GIOStream</span></a> * g_tls_client_connection_new (<em class="parameter"><code><a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a> *base_io_stream</code></em>,
127
+ <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *server_identity</code></em>,
128
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
129
+ <p>
130
+ Creates a new <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> wrapping <em class="parameter"><code>base_io_stream</code></em> (which
131
+ must have pollable input and output streams) which is assumed to
132
+ communicate with the server identified by <em class="parameter"><code>server_identity</code></em>.
133
+ </p>
134
+ <div class="variablelist"><table border="0">
135
+ <col align="left" valign="top">
136
+ <tbody>
137
+ <tr>
138
+ <td><p><span class="term"><em class="parameter"><code>base_io_stream</code></em> :</span></p></td>
139
+ <td>the <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a> to wrap</td>
140
+ </tr>
141
+ <tr>
142
+ <td><p><span class="term"><em class="parameter"><code>server_identity</code></em> :</span></p></td>
143
+ <td>the expected identity of the server. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
144
+ </td>
145
+ </tr>
146
+ <tr>
147
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
148
+ <td>
149
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</td>
150
+ </tr>
151
+ <tr>
152
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
153
+ <td>the new <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</td>
154
+ </tr>
155
+ </tbody>
156
+ </table></div>
157
+ <p class="since">Since 2.28</p>
158
+ </div>
159
+ <hr>
160
+ <div class="refsect2">
161
+ <a name="g-tls-client-connection-set-server-identity"></a><h3>g_tls_client_connection_set_server_identity ()</h3>
162
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_client_connection_set_server_identity
163
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>,
164
+ <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *identity</code></em>);</pre>
165
+ <p>
166
+ Sets <em class="parameter"><code>conn</code></em>'s expected server identity, which is used both to tell
167
+ servers on virtual hosts which certificate to present, and also
168
+ to let <em class="parameter"><code>conn</code></em> know what name to look for in the certificate when
169
+ performing <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-BAD-IDENTITY:CAPS"><code class="literal">G_TLS_CERTIFICATE_BAD_IDENTITY</code></a> validation, if enabled.
170
+ </p>
171
+ <div class="variablelist"><table border="0">
172
+ <col align="left" valign="top">
173
+ <tbody>
174
+ <tr>
175
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
176
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
177
+ </td>
178
+ </tr>
179
+ <tr>
180
+ <td><p><span class="term"><em class="parameter"><code>identity</code></em> :</span></p></td>
181
+ <td>a <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> describing the expected server identity</td>
182
+ </tr>
183
+ </tbody>
184
+ </table></div>
185
+ <p class="since">Since 2.28</p>
186
+ </div>
187
+ <hr>
188
+ <div class="refsect2">
189
+ <a name="g-tls-client-connection-get-server-identity"></a><h3>g_tls_client_connection_get_server_identity ()</h3>
190
+ <pre class="programlisting"><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="returnvalue">GSocketConnectable</span></a> * g_tls_client_connection_get_server_identity
191
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);</pre>
192
+ <p>
193
+ Gets <em class="parameter"><code>conn</code></em>'s expected server identity
194
+ </p>
195
+ <div class="variablelist"><table border="0">
196
+ <col align="left" valign="top">
197
+ <tbody>
198
+ <tr>
199
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
200
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
201
+ </td>
202
+ </tr>
203
+ <tr>
204
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
205
+ <td>a <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> describing the
206
+ expected server identity, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the expected identity is not
207
+ known.</td>
208
+ </tr>
209
+ </tbody>
210
+ </table></div>
211
+ <p class="since">Since 2.28</p>
212
+ </div>
213
+ <hr>
214
+ <div class="refsect2">
215
+ <a name="g-tls-client-connection-set-validation-flags"></a><h3>g_tls_client_connection_set_validation_flags ()</h3>
216
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_client_connection_set_validation_flags
217
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>,
218
+ <em class="parameter"><code><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);</pre>
219
+ <p>
220
+ Sets <em class="parameter"><code>conn</code></em>'s validation flags, to override the default set of
221
+ checks performed when validating a server certificate. By default,
222
+ <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-VALIDATE-ALL:CAPS"><code class="literal">G_TLS_CERTIFICATE_VALIDATE_ALL</code></a> is used.
223
+ </p>
224
+ <div class="variablelist"><table border="0">
225
+ <col align="left" valign="top">
226
+ <tbody>
227
+ <tr>
228
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
229
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
230
+ </td>
231
+ </tr>
232
+ <tr>
233
+ <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
234
+ <td>the <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> to use</td>
235
+ </tr>
236
+ </tbody>
237
+ </table></div>
238
+ <p class="since">Since 2.28</p>
239
+ </div>
240
+ <hr>
241
+ <div class="refsect2">
242
+ <a name="g-tls-client-connection-get-validation-flags"></a><h3>g_tls_client_connection_get_validation_flags ()</h3>
243
+ <pre class="programlisting"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> g_tls_client_connection_get_validation_flags
244
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);</pre>
245
+ <p>
246
+ Gets <em class="parameter"><code>conn</code></em>'s validation flags
247
+ </p>
248
+ <div class="variablelist"><table border="0">
249
+ <col align="left" valign="top">
250
+ <tbody>
251
+ <tr>
252
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
253
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
254
+ </td>
255
+ </tr>
256
+ <tr>
257
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
258
+ <td>the validation flags</td>
259
+ </tr>
260
+ </tbody>
261
+ </table></div>
262
+ <p class="since">Since 2.28</p>
263
+ </div>
264
+ <hr>
265
+ <div class="refsect2">
266
+ <a name="g-tls-client-connection-set-use-ssl3"></a><h3>g_tls_client_connection_set_use_ssl3 ()</h3>
267
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_client_connection_set_use_ssl3
268
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>,
269
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_ssl3</code></em>);</pre>
270
+ <p>
271
+ If <em class="parameter"><code>use_ssl3</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this forces <em class="parameter"><code>conn</code></em> to use SSL 3.0 rather than
272
+ trying to properly negotiate the right version of TLS or SSL to use.
273
+ This can be used when talking to servers that do not implement the
274
+ fallbacks correctly and which will therefore fail to handshake with
275
+ a "modern" TLS handshake attempt.
276
+ </p>
277
+ <div class="variablelist"><table border="0">
278
+ <col align="left" valign="top">
279
+ <tbody>
280
+ <tr>
281
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
282
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
283
+ </td>
284
+ </tr>
285
+ <tr>
286
+ <td><p><span class="term"><em class="parameter"><code>use_ssl3</code></em> :</span></p></td>
287
+ <td>whether to use SSL 3.0</td>
288
+ </tr>
289
+ </tbody>
290
+ </table></div>
291
+ <p class="since">Since 2.28</p>
292
+ </div>
293
+ <hr>
294
+ <div class="refsect2">
295
+ <a name="g-tls-client-connection-get-use-ssl3"></a><h3>g_tls_client_connection_get_use_ssl3 ()</h3>
296
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_tls_client_connection_get_use_ssl3
297
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);</pre>
298
+ <p>
299
+ Gets whether <em class="parameter"><code>conn</code></em> will use SSL 3.0 rather than the
300
+ highest-supported version of TLS; see
301
+ <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-set-use-ssl3" title="g_tls_client_connection_set_use_ssl3 ()"><code class="function">g_tls_client_connection_set_use_ssl3()</code></a>.
302
+ </p>
303
+ <div class="variablelist"><table border="0">
304
+ <col align="left" valign="top">
305
+ <tbody>
306
+ <tr>
307
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
308
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
309
+ </td>
310
+ </tr>
311
+ <tr>
312
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
313
+ <td>whether <em class="parameter"><code>conn</code></em> will use SSL 3.0</td>
314
+ </tr>
315
+ </tbody>
316
+ </table></div>
317
+ <p class="since">Since 2.28</p>
318
+ </div>
319
+ <hr>
320
+ <div class="refsect2">
321
+ <a name="g-tls-client-connection-get-accepted-cas"></a><h3>g_tls_client_connection_get_accepted_cas ()</h3>
322
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * g_tls_client_connection_get_accepted_cas
323
+ (<em class="parameter"><code><a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> *conn</code></em>);</pre>
324
+ <p>
325
+ Gets the list of distinguished names of the Certificate Authorities
326
+ that the server will accept certificates from. This will be set
327
+ during the TLS handshake if the server requests a certificate.
328
+ Otherwise, it will be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
329
+ </p>
330
+ <p>
331
+ Each item in the list is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray"><span class="type">GByteArray</span></a> which contains the complete
332
+ subject DN of the certificate authority.
333
+ </p>
334
+ <div class="variablelist"><table border="0">
335
+ <col align="left" valign="top">
336
+ <tbody>
337
+ <tr>
338
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
339
+ <td>the <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>
340
+ </td>
341
+ </tr>
342
+ <tr>
343
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
344
+ <td>the list of
345
+ CA DNs. You should unref each element with <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#g-byte-array-unref"><code class="function">g_byte_array_unref()</code></a> and then
346
+ the free the list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GByteArray][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
347
+ </td>
348
+ </tr>
349
+ </tbody>
350
+ </table></div>
351
+ <p class="since">Since 2.28</p>
352
+ </div>
353
+ </div>
354
+ <div class="refsect1">
355
+ <a name="GTlsClientConnection.property-details"></a><h2>Property Details</h2>
356
+ <div class="refsect2">
357
+ <a name="GTlsClientConnection--accepted-cas"></a><h3>The <code class="literal">"accepted-cas"</code> property</h3>
358
+ <pre class="programlisting"> "accepted-cas" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> : Read</pre>
359
+ <p>
360
+ A list of the distinguished names of the Certificate Authorities
361
+ that the server will accept client certificates signed by. If the
362
+ server requests a client certificate during the handshake, then
363
+ this property will be set after the handshake completes.
364
+ </p>
365
+ <p>
366
+ Each item in the list is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray"><span class="type">GByteArray</span></a> which contains the complete
367
+ subject DN of the certificate authority.
368
+ </p>
369
+ <p class="since">Since 2.28</p>
370
+ </div>
371
+ <hr>
372
+ <div class="refsect2">
373
+ <a name="GTlsClientConnection--server-identity"></a><h3>The <code class="literal">"server-identity"</code> property</h3>
374
+ <pre class="programlisting"> "server-identity" <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a>* : Read / Write / Construct</pre>
375
+ <p>
376
+ A <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> describing the identity of the server that
377
+ is expected on the other end of the connection.
378
+ </p>
379
+ <p>
380
+ If the <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-BAD-IDENTITY:CAPS"><code class="literal">G_TLS_CERTIFICATE_BAD_IDENTITY</code></a> flag is set in
381
+ <a class="link" href="GTlsClientConnection.html#GTlsClientConnection--validation-flags" title='The "validation-flags" property'><span class="type">"validation-flags"</span></a>, this object will be used
382
+ to determine the expected identify of the remote end of the
383
+ connection; if <a class="link" href="GTlsClientConnection.html#GTlsClientConnection--server-identity" title='The "server-identity" property'><span class="type">"server-identity"</span></a> is not set,
384
+ or does not match the identity presented by the server, then the
385
+ <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-BAD-IDENTITY:CAPS"><code class="literal">G_TLS_CERTIFICATE_BAD_IDENTITY</code></a> validation will fail.
386
+ </p>
387
+ <p>
388
+ In addition to its use in verifying the server certificate,
389
+ this is also used to give a hint to the server about what
390
+ certificate we expect, which is useful for servers that serve
391
+ virtual hosts.
392
+ </p>
393
+ <p class="since">Since 2.28</p>
394
+ </div>
395
+ <hr>
396
+ <div class="refsect2">
397
+ <a name="GTlsClientConnection--use-ssl3"></a><h3>The <code class="literal">"use-ssl3"</code> property</h3>
398
+ <pre class="programlisting"> "use-ssl3" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct</pre>
399
+ <p>
400
+ If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, tells the connection to use SSL 3.0 rather than trying
401
+ to negotiate the best version of TLS or SSL to use. This can be
402
+ used when talking to servers that don't implement version
403
+ negotiation correctly and therefore refuse to handshake at all with
404
+ a "modern" TLS handshake.
405
+ </p>
406
+ <p>Default value: FALSE</p>
407
+ <p class="since">Since 2.28</p>
408
+ </div>
409
+ <hr>
410
+ <div class="refsect2">
411
+ <a name="GTlsClientConnection--validation-flags"></a><h3>The <code class="literal">"validation-flags"</code> property</h3>
412
+ <pre class="programlisting"> "validation-flags" <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> : Read / Write / Construct</pre>
413
+ <p>
414
+ What steps to perform when validating a certificate received from
415
+ a server. Server certificates that fail to validate in all of the
416
+ ways indicated here will be rejected unless the application
417
+ overrides the default via <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a>.
418
+ </p>
419
+ <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>
420
+ <p class="since">Since 2.28</p>
421
+ </div>
422
+ </div>
423
+ </div>
424
+ <div class="footer">
425
+ <hr>
426
+ Generated by GTK-Doc V1.16.1</div>
427
+ </body>
428
+ </html>
data/vendor/local/share/gtk-doc/html/gio/GTlsConnection.html ADDED
@@ -0,0 +1,869 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>GTlsConnection</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
+ <link rel="home" href="index.html" title="GIO Reference Manual">
8
+ <link rel="up" href="tls.html" title="TLS (SSL) support">
9
+ <link rel="prev" href="GTlsCertificate.html" title="GTlsCertificate">
10
+ <link rel="next" href="GTlsClientConnection.html" title="GTlsClientConnection">
11
+ <meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
14
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
+ <tr valign="middle">
17
+ <td><a accesskey="p" href="GTlsCertificate.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="tls.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
+ <th width="100%" align="center">GIO Reference Manual</th>
21
+ <td><a accesskey="n" href="GTlsClientConnection.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
+ </tr>
23
+ <tr><td colspan="5" class="shortcuts">
24
+ <a href="#GTlsConnection.synopsis" class="shortcut">Top</a>
25
+  | 
26
+ <a href="#GTlsConnection.description" class="shortcut">Description</a>
27
+  | 
28
+ <a href="#GTlsConnection.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
+  | 
30
+ <a href="#GTlsConnection.derived-interfaces" class="shortcut">Known Derived Interfaces</a>
31
+  | 
32
+ <a href="#GTlsConnection.properties" class="shortcut">Properties</a>
33
+  | 
34
+ <a href="#GTlsConnection.signals" class="shortcut">Signals</a>
35
+ </td></tr>
36
+ </table>
37
+ <div class="refentry">
38
+ <a name="GTlsConnection"></a><div class="titlepage"></div>
39
+ <div class="refnamediv"><table width="100%"><tr>
40
+ <td valign="top">
41
+ <h2><span class="refentrytitle"><a name="GTlsConnection.top_of_page"></a>GTlsConnection</span></h2>
42
+ <p>GTlsConnection — TLS connection type</p>
43
+ </td>
44
+ <td valign="top" align="right"></td>
45
+ </tr></table></div>
46
+ <div class="refsynopsisdiv">
47
+ <a name="GTlsConnection.synopsis"></a><h2>Synopsis</h2>
48
+ <a name="GTlsRehandshakeMode"></a><pre class="synopsis">
49
+ #include &lt;gio/gio.h&gt;
50
+
51
+ <a class="link" href="GTlsConnection.html#GTlsConnection-struct" title="GTlsConnection">GTlsConnection</a>;
52
+ <span class="returnvalue">void</span> <a class="link" href="GTlsConnection.html#g-tls-connection-set-certificate" title="g_tls_connection_set_certificate ()">g_tls_connection_set_certificate</a> (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
53
+ <em class="parameter"><code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a> *certificate</code></em>);
54
+ <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="returnvalue">GTlsCertificate</span></a> * <a class="link" href="GTlsConnection.html#g-tls-connection-get-certificate" title="g_tls_connection_get_certificate ()">g_tls_connection_get_certificate</a> (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);
55
+ <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="returnvalue">GTlsCertificate</span></a> * <a class="link" href="GTlsConnection.html#g-tls-connection-get-peer-certificate" title="g_tls_connection_get_peer_certificate ()">g_tls_connection_get_peer_certificate</a>
56
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);
57
+ <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-get-peer-certificate-errors" title="g_tls_connection_get_peer_certificate_errors ()">g_tls_connection_get_peer_certificate_errors</a>
58
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);
59
+ <span class="returnvalue">void</span> <a class="link" href="GTlsConnection.html#g-tls-connection-set-require-close-notify" title="g_tls_connection_set_require_close_notify ()">g_tls_connection_set_require_close_notify</a>
60
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
61
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> require_close_notify</code></em>);
62
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-get-require-close-notify" title="g_tls_connection_get_require_close_notify ()">g_tls_connection_get_require_close_notify</a>
63
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);
64
+ enum <a class="link" href="GTlsConnection.html#GTlsRehandshakeMode">GTlsRehandshakeMode</a>;
65
+ <span class="returnvalue">void</span> <a class="link" href="GTlsConnection.html#g-tls-connection-set-rehandshake-mode" title="g_tls_connection_set_rehandshake_mode ()">g_tls_connection_set_rehandshake_mode</a>
66
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
67
+ <em class="parameter"><code><a class="link" href="GTlsConnection.html#GTlsRehandshakeMode"><span class="type">GTlsRehandshakeMode</span></a> mode</code></em>);
68
+ <a class="link" href="GTlsConnection.html#GTlsRehandshakeMode"><span class="returnvalue">GTlsRehandshakeMode</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-get-rehandshake-mode" title="g_tls_connection_get_rehandshake_mode ()">g_tls_connection_get_rehandshake_mode</a>
69
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);
70
+ <span class="returnvalue">void</span> <a class="link" href="GTlsConnection.html#g-tls-connection-set-use-system-certdb" title="g_tls_connection_set_use_system_certdb ()">g_tls_connection_set_use_system_certdb</a>
71
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
72
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_system_certdb</code></em>);
73
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-get-use-system-certdb" title="g_tls_connection_get_use_system_certdb ()">g_tls_connection_get_use_system_certdb</a>
74
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);
75
+
76
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-handshake" title="g_tls_connection_handshake ()">g_tls_connection_handshake</a> (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
77
+ <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
78
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
79
+ <span class="returnvalue">void</span> <a class="link" href="GTlsConnection.html#g-tls-connection-handshake-async" title="g_tls_connection_handshake_async ()">g_tls_connection_handshake_async</a> (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
80
+ <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
81
+ <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
82
+ <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
83
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
84
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-handshake-finish" title="g_tls_connection_handshake_finish ()">g_tls_connection_handshake_finish</a> (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
85
+ <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
86
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
87
+
88
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GTlsConnection.html#g-tls-connection-emit-accept-certificate" title="g_tls_connection_emit_accept_certificate ()">g_tls_connection_emit_accept_certificate</a>
89
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
90
+ <em class="parameter"><code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a> *peer_cert</code></em>,
91
+ <em class="parameter"><code><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> errors</code></em>);
92
+ </pre>
93
+ </div>
94
+ <div class="refsect1">
95
+ <a name="GTlsConnection.object-hierarchy"></a><h2>Object Hierarchy</h2>
96
+ <pre class="synopsis">
97
+ <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
98
+ +----<a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a>
99
+ +----GTlsConnection
100
+ </pre>
101
+ <pre class="synopsis">
102
+ GEnum
103
+ +----GTlsRehandshakeMode
104
+ </pre>
105
+ </div>
106
+ <div class="refsect1">
107
+ <a name="GTlsConnection.derived-interfaces"></a><h2>Known Derived Interfaces</h2>
108
+ <p>
109
+ GTlsConnection is required by
110
+ <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection">GTlsClientConnection</a> and <a class="link" href="GTlsServerConnection.html" title="GTlsServerConnection">GTlsServerConnection</a>.</p>
111
+ </div>
112
+ <div class="refsect1">
113
+ <a name="GTlsConnection.properties"></a><h2>Properties</h2>
114
+ <pre class="synopsis">
115
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--base-io-stream" title='The "base-io-stream" property'>base-io-stream</a>" <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a>* : Read / Write / Construct Only
116
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--certificate" title='The "certificate" property'>certificate</a>" <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a>* : Read / Write
117
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--peer-certificate" title='The "peer-certificate" property'>peer-certificate</a>" <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a>* : Read
118
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--peer-certificate-errors" title='The "peer-certificate-errors" property'>peer-certificate-errors</a>" <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> : Read
119
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--rehandshake-mode" title='The "rehandshake-mode" property'>rehandshake-mode</a>" <a class="link" href="GTlsConnection.html#GTlsRehandshakeMode"><span class="type">GTlsRehandshakeMode</span></a> : Read / Write / Construct
120
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--require-close-notify" title='The "require-close-notify" property'>require-close-notify</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct
121
+ "<a class="link" href="GTlsConnection.html#GTlsConnection--use-system-certdb" title='The "use-system-certdb" property'>use-system-certdb</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct
122
+ </pre>
123
+ </div>
124
+ <div class="refsect1">
125
+ <a name="GTlsConnection.signals"></a><h2>Signals</h2>
126
+ <pre class="synopsis">
127
+ "<a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'>accept-certificate</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
128
+ </pre>
129
+ </div>
130
+ <div class="refsect1">
131
+ <a name="GTlsConnection.description"></a><h2>Description</h2>
132
+ <p>
133
+ <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> is the base TLS connection class type, which wraps
134
+ a <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a> and provides TLS encryption on top of it. Its
135
+ subclasses, <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a> and <a class="link" href="GTlsServerConnection.html" title="GTlsServerConnection"><span class="type">GTlsServerConnection</span></a>,
136
+ implement client-side and server-side TLS, respectively.
137
+ </p>
138
+ </div>
139
+ <div class="refsect1">
140
+ <a name="GTlsConnection.details"></a><h2>Details</h2>
141
+ <div class="refsect2">
142
+ <a name="GTlsConnection-struct"></a><h3>GTlsConnection</h3>
143
+ <pre class="programlisting">typedef struct _GTlsConnection GTlsConnection;</pre>
144
+ <p>
145
+ TLS connection. This is an abstract type that will be subclassed by
146
+ a TLS-library-specific subtype.
147
+ </p>
148
+ <p class="since">Since 2.28</p>
149
+ </div>
150
+ <hr>
151
+ <div class="refsect2">
152
+ <a name="g-tls-connection-set-certificate"></a><h3>g_tls_connection_set_certificate ()</h3>
153
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_connection_set_certificate (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
154
+ <em class="parameter"><code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a> *certificate</code></em>);</pre>
155
+ <p>
156
+ This sets the certificate that <em class="parameter"><code>conn</code></em> will present to its peer
157
+ during the TLS handshake. For a <a class="link" href="GTlsServerConnection.html" title="GTlsServerConnection"><span class="type">GTlsServerConnection</span></a>, it is
158
+ mandatory to set this, and that will normally be done at construct
159
+ time.
160
+ </p>
161
+ <p>
162
+ For a <a class="link" href="GTlsClientConnection.html" title="GTlsClientConnection"><span class="type">GTlsClientConnection</span></a>, this is optional. If a handshake fails
163
+ with <a class="link" href="gio-TLS-Overview.html#G-TLS-ERROR-CERTIFICATE-REQUIRED:CAPS"><code class="literal">G_TLS_ERROR_CERTIFICATE_REQUIRED</code></a>, that means that the server
164
+ requires a certificate, and if you try connecting again, you should
165
+ call this method first. You can call
166
+ <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-get-accepted-cas" title="g_tls_client_connection_get_accepted_cas ()"><code class="function">g_tls_client_connection_get_accepted_cas()</code></a> on the failed connection
167
+ to get a list of Certificate Authorities that the server will
168
+ accept certificates from.
169
+ </p>
170
+ <p>
171
+ (It is also possible that a server will allow the connection with
172
+ or without a certificate; in that case, if you don't provide a
173
+ certificate, you can tell that the server requested one by the fact
174
+ that <a class="link" href="GTlsClientConnection.html#g-tls-client-connection-get-accepted-cas" title="g_tls_client_connection_get_accepted_cas ()"><code class="function">g_tls_client_connection_get_accepted_cas()</code></a> will return
175
+ non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.)
176
+ </p>
177
+ <div class="variablelist"><table border="0">
178
+ <col align="left" valign="top">
179
+ <tbody>
180
+ <tr>
181
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
182
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
183
+ </td>
184
+ </tr>
185
+ <tr>
186
+ <td><p><span class="term"><em class="parameter"><code>certificate</code></em> :</span></p></td>
187
+ <td>the certificate to use for <em class="parameter"><code>conn</code></em>
188
+ </td>
189
+ </tr>
190
+ </tbody>
191
+ </table></div>
192
+ <p class="since">Since 2.28</p>
193
+ </div>
194
+ <hr>
195
+ <div class="refsect2">
196
+ <a name="g-tls-connection-get-certificate"></a><h3>g_tls_connection_get_certificate ()</h3>
197
+ <pre class="programlisting"><a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="returnvalue">GTlsCertificate</span></a> * g_tls_connection_get_certificate (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);</pre>
198
+ <p>
199
+ Gets <em class="parameter"><code>conn</code></em>'s certificate, as set by
200
+ <a class="link" href="GTlsConnection.html#g-tls-connection-set-certificate" title="g_tls_connection_set_certificate ()"><code class="function">g_tls_connection_set_certificate()</code></a>.
201
+ </p>
202
+ <div class="variablelist"><table border="0">
203
+ <col align="left" valign="top">
204
+ <tbody>
205
+ <tr>
206
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
207
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
208
+ </td>
209
+ </tr>
210
+ <tr>
211
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
212
+ <td>
213
+ <em class="parameter"><code>conn</code></em>'s certificate, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
214
+ </td>
215
+ </tr>
216
+ </tbody>
217
+ </table></div>
218
+ <p class="since">Since 2.28</p>
219
+ </div>
220
+ <hr>
221
+ <div class="refsect2">
222
+ <a name="g-tls-connection-get-peer-certificate"></a><h3>g_tls_connection_get_peer_certificate ()</h3>
223
+ <pre class="programlisting"><a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="returnvalue">GTlsCertificate</span></a> * g_tls_connection_get_peer_certificate
224
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);</pre>
225
+ <p>
226
+ Gets <em class="parameter"><code>conn</code></em>'s peer's certificate after the handshake has completed.
227
+ (It is not set during the emission of
228
+ <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a>.)
229
+ </p>
230
+ <div class="variablelist"><table border="0">
231
+ <col align="left" valign="top">
232
+ <tbody>
233
+ <tr>
234
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
235
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
236
+ </td>
237
+ </tr>
238
+ <tr>
239
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
240
+ <td>
241
+ <em class="parameter"><code>conn</code></em>'s peer's certificate, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
242
+ </td>
243
+ </tr>
244
+ </tbody>
245
+ </table></div>
246
+ <p class="since">Since 2.28</p>
247
+ </div>
248
+ <hr>
249
+ <div class="refsect2">
250
+ <a name="g-tls-connection-get-peer-certificate-errors"></a><h3>g_tls_connection_get_peer_certificate_errors ()</h3>
251
+ <pre class="programlisting"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> g_tls_connection_get_peer_certificate_errors
252
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);</pre>
253
+ <p>
254
+ Gets the errors associated with validating <em class="parameter"><code>conn</code></em>'s peer's
255
+ certificate, after the handshake has completed. (It is not set
256
+ during the emission of <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a>.)
257
+ </p>
258
+ <div class="variablelist"><table border="0">
259
+ <col align="left" valign="top">
260
+ <tbody>
261
+ <tr>
262
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
263
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
264
+ </td>
265
+ </tr>
266
+ <tr>
267
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
268
+ <td>
269
+ <em class="parameter"><code>conn</code></em>'s peer's certificate errors</td>
270
+ </tr>
271
+ </tbody>
272
+ </table></div>
273
+ <p class="since">Since 2.28</p>
274
+ </div>
275
+ <hr>
276
+ <div class="refsect2">
277
+ <a name="g-tls-connection-set-require-close-notify"></a><h3>g_tls_connection_set_require_close_notify ()</h3>
278
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_connection_set_require_close_notify
279
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
280
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> require_close_notify</code></em>);</pre>
281
+ <p>
282
+ Sets whether or not <em class="parameter"><code>conn</code></em> expects a proper TLS close notification
283
+ before the connection is closed. If this is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> (the default),
284
+ then <em class="parameter"><code>conn</code></em> will expect to receive a TLS close notification from its
285
+ peer before the connection is closed, and will return a
286
+ <a class="link" href="gio-TLS-Overview.html#G-TLS-ERROR-EOF:CAPS"><code class="literal">G_TLS_ERROR_EOF</code></a> error if the connection is closed without proper
287
+ notification (since this may indicate a network error, or
288
+ man-in-the-middle attack).
289
+ </p>
290
+ <p>
291
+ In some protocols, the application will know whether or not the
292
+ connection was closed cleanly based on application-level data
293
+ (because the application-level data includes a length field, or is
294
+ somehow self-delimiting); in this case, the close notify is
295
+ redundant and sometimes omitted. (TLS 1.1 explicitly allows this;
296
+ in TLS 1.0 it is technically an error, but often done anyway.) You
297
+ can use <a class="link" href="GTlsConnection.html#g-tls-connection-set-require-close-notify" title="g_tls_connection_set_require_close_notify ()"><code class="function">g_tls_connection_set_require_close_notify()</code></a> to tell <em class="parameter"><code>conn</code></em>
298
+ to allow an "unannounced" connection close, in which case the close
299
+ will show up as a 0-length read, as in a non-TLS
300
+ <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>, and it is up to the application to check that
301
+ the data has been fully received.
302
+ </p>
303
+ <p>
304
+ Note that this only affects the behavior when the peer closes the
305
+ connection; when the application calls <a class="link" href="GIOStream.html#g-io-stream-close" title="g_io_stream_close ()"><code class="function">g_io_stream_close()</code></a> itself
306
+ on <em class="parameter"><code>conn</code></em>, this will send a close notification regardless of the
307
+ setting of this property. If you explicitly want to do an unclean
308
+ close, you can close <em class="parameter"><code>conn</code></em>'s <a class="link" href="GTlsConnection.html#GTlsConnection--base-io-stream" title='The "base-io-stream" property'><span class="type">"base-io-stream"</span></a> rather
309
+ than closing <em class="parameter"><code>conn</code></em> itself.
310
+ </p>
311
+ <div class="variablelist"><table border="0">
312
+ <col align="left" valign="top">
313
+ <tbody>
314
+ <tr>
315
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
316
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
317
+ </td>
318
+ </tr>
319
+ <tr>
320
+ <td><p><span class="term"><em class="parameter"><code>require_close_notify</code></em> :</span></p></td>
321
+ <td>whether or not to require close notification</td>
322
+ </tr>
323
+ </tbody>
324
+ </table></div>
325
+ <p class="since">Since 2.28</p>
326
+ </div>
327
+ <hr>
328
+ <div class="refsect2">
329
+ <a name="g-tls-connection-get-require-close-notify"></a><h3>g_tls_connection_get_require_close_notify ()</h3>
330
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_tls_connection_get_require_close_notify
331
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);</pre>
332
+ <p>
333
+ Tests whether or not <em class="parameter"><code>conn</code></em> expects a proper TLS close notification
334
+ when the connection is closed. See
335
+ <a class="link" href="GTlsConnection.html#g-tls-connection-set-require-close-notify" title="g_tls_connection_set_require_close_notify ()"><code class="function">g_tls_connection_set_require_close_notify()</code></a> for details.
336
+ </p>
337
+ <div class="variablelist"><table border="0">
338
+ <col align="left" valign="top">
339
+ <tbody>
340
+ <tr>
341
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
342
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
343
+ </td>
344
+ </tr>
345
+ <tr>
346
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
347
+ <td>
348
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>conn</code></em> requires a proper TLS close
349
+ notification.</td>
350
+ </tr>
351
+ </tbody>
352
+ </table></div>
353
+ <p class="since">Since 2.28</p>
354
+ </div>
355
+ <hr>
356
+ <div class="refsect2">
357
+ <a name="GTlsRehandshakeMode"></a><h3>enum GTlsRehandshakeMode</h3>
358
+ <pre class="programlisting">typedef enum {
359
+ G_TLS_REHANDSHAKE_NEVER,
360
+ G_TLS_REHANDSHAKE_SAFELY,
361
+ G_TLS_REHANDSHAKE_UNSAFELY
362
+ } GTlsRehandshakeMode;
363
+ </pre>
364
+ <p>
365
+ When to allow rehandshaking. See
366
+ <a class="link" href="GTlsConnection.html#g-tls-connection-set-rehandshake-mode" title="g_tls_connection_set_rehandshake_mode ()"><code class="function">g_tls_connection_set_rehandshake_mode()</code></a>.
367
+ </p>
368
+ <div class="variablelist"><table border="0">
369
+ <col align="left" valign="top">
370
+ <tbody>
371
+ <tr>
372
+ <td><p><a name="G-TLS-REHANDSHAKE-NEVER:CAPS"></a><span class="term"><code class="literal">G_TLS_REHANDSHAKE_NEVER</code></span></p></td>
373
+ <td>Never allow rehandshaking
374
+ </td>
375
+ </tr>
376
+ <tr>
377
+ <td><p><a name="G-TLS-REHANDSHAKE-SAFELY:CAPS"></a><span class="term"><code class="literal">G_TLS_REHANDSHAKE_SAFELY</code></span></p></td>
378
+ <td>Allow safe rehandshaking only
379
+ </td>
380
+ </tr>
381
+ <tr>
382
+ <td><p><a name="G-TLS-REHANDSHAKE-UNSAFELY:CAPS"></a><span class="term"><code class="literal">G_TLS_REHANDSHAKE_UNSAFELY</code></span></p></td>
383
+ <td>Allow unsafe rehandshaking
384
+ </td>
385
+ </tr>
386
+ </tbody>
387
+ </table></div>
388
+ <p class="since">Since 2.28</p>
389
+ </div>
390
+ <hr>
391
+ <div class="refsect2">
392
+ <a name="g-tls-connection-set-rehandshake-mode"></a><h3>g_tls_connection_set_rehandshake_mode ()</h3>
393
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_connection_set_rehandshake_mode
394
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
395
+ <em class="parameter"><code><a class="link" href="GTlsConnection.html#GTlsRehandshakeMode"><span class="type">GTlsRehandshakeMode</span></a> mode</code></em>);</pre>
396
+ <p>
397
+ Sets how <em class="parameter"><code>conn</code></em> behaves with respect to rehandshaking requests.
398
+ </p>
399
+ <p>
400
+ <a class="link" href="GTlsConnection.html#G-TLS-REHANDSHAKE-NEVER:CAPS"><code class="literal">G_TLS_REHANDSHAKE_NEVER</code></a> means that it will never agree to
401
+ rehandshake after the initial handshake is complete. (For a client,
402
+ this means it will refuse rehandshake requests from the server, and
403
+ for a server, this means it will close the connection with an error
404
+ if the client attempts to rehandshake.)
405
+ </p>
406
+ <p>
407
+ <a class="link" href="GTlsConnection.html#G-TLS-REHANDSHAKE-SAFELY:CAPS"><code class="literal">G_TLS_REHANDSHAKE_SAFELY</code></a> means that the connection will allow a
408
+ rehandshake only if the other end of the connection supports the
409
+ TLS <code class="literal">renegotiation_info</code> extension. This is the
410
+ default behavior, but means that rehandshaking will not work
411
+ against older implementations that do not support that extension.
412
+ </p>
413
+ <p>
414
+ <a class="link" href="GTlsConnection.html#G-TLS-REHANDSHAKE-UNSAFELY:CAPS"><code class="literal">G_TLS_REHANDSHAKE_UNSAFELY</code></a> means that the connection will allow
415
+ rehandshaking even without the
416
+ <code class="literal">renegotiation_info</code> extension. On the server side
417
+ in particular, this is not recommended, since it leaves the server
418
+ open to certain attacks. However, this mode is necessary if you
419
+ need to allow renegotiation with older client software.
420
+ </p>
421
+ <div class="variablelist"><table border="0">
422
+ <col align="left" valign="top">
423
+ <tbody>
424
+ <tr>
425
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
426
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
427
+ </td>
428
+ </tr>
429
+ <tr>
430
+ <td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
431
+ <td>the rehandshaking mode</td>
432
+ </tr>
433
+ </tbody>
434
+ </table></div>
435
+ <p class="since">Since 2.28</p>
436
+ </div>
437
+ <hr>
438
+ <div class="refsect2">
439
+ <a name="g-tls-connection-get-rehandshake-mode"></a><h3>g_tls_connection_get_rehandshake_mode ()</h3>
440
+ <pre class="programlisting"><a class="link" href="GTlsConnection.html#GTlsRehandshakeMode"><span class="returnvalue">GTlsRehandshakeMode</span></a> g_tls_connection_get_rehandshake_mode
441
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);</pre>
442
+ <p>
443
+ Gets <em class="parameter"><code>conn</code></em> rehandshaking mode. See
444
+ <code class="function">g_tls_connection_set_rehandshake()</code> for details.
445
+ </p>
446
+ <div class="variablelist"><table border="0">
447
+ <col align="left" valign="top">
448
+ <tbody>
449
+ <tr>
450
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
451
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
452
+ </td>
453
+ </tr>
454
+ <tr>
455
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
456
+ <td>
457
+ <em class="parameter"><code>conn</code></em>'s rehandshaking mode</td>
458
+ </tr>
459
+ </tbody>
460
+ </table></div>
461
+ <p class="since">Since 2.28</p>
462
+ </div>
463
+ <hr>
464
+ <div class="refsect2">
465
+ <a name="g-tls-connection-set-use-system-certdb"></a><h3>g_tls_connection_set_use_system_certdb ()</h3>
466
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_connection_set_use_system_certdb
467
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
468
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_system_certdb</code></em>);</pre>
469
+ <p>
470
+ Sets whether <em class="parameter"><code>conn</code></em> uses the system certificate database to verify
471
+ peer certificates. This is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> by default. If set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, then
472
+ peer certificate validation will always set the
473
+ <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-UNKNOWN-CA:CAPS"><code class="literal">G_TLS_CERTIFICATE_UNKNOWN_CA</code></a> error (meaning
474
+ <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a> will always be emitted on
475
+ client-side connections, unless that bit is not set in
476
+ <a class="link" href="GTlsClientConnection.html#GTlsClientConnection--validation-flags" title='The "validation-flags" property'><span class="type">"validation-flags"</span></a>).
477
+ </p>
478
+ <div class="variablelist"><table border="0">
479
+ <col align="left" valign="top">
480
+ <tbody>
481
+ <tr>
482
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
483
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
484
+ </td>
485
+ </tr>
486
+ <tr>
487
+ <td><p><span class="term"><em class="parameter"><code>use_system_certdb</code></em> :</span></p></td>
488
+ <td>whether to use the system certificate database</td>
489
+ </tr>
490
+ </tbody>
491
+ </table></div>
492
+ <p class="since">Since 2.28</p>
493
+ </div>
494
+ <hr>
495
+ <div class="refsect2">
496
+ <a name="g-tls-connection-get-use-system-certdb"></a><h3>g_tls_connection_get_use_system_certdb ()</h3>
497
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_tls_connection_get_use_system_certdb
498
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>);</pre>
499
+ <p>
500
+ Gets whether <em class="parameter"><code>conn</code></em> uses the system certificate database to verify
501
+ peer certificates. See <a class="link" href="GTlsConnection.html#g-tls-connection-set-use-system-certdb" title="g_tls_connection_set_use_system_certdb ()"><code class="function">g_tls_connection_set_use_system_certdb()</code></a>.
502
+ </p>
503
+ <div class="variablelist"><table border="0">
504
+ <col align="left" valign="top">
505
+ <tbody>
506
+ <tr>
507
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
508
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
509
+ </td>
510
+ </tr>
511
+ <tr>
512
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
513
+ <td>whether <em class="parameter"><code>conn</code></em> uses the system certificate database</td>
514
+ </tr>
515
+ </tbody>
516
+ </table></div>
517
+ <p class="since">Since 2.28</p>
518
+ </div>
519
+ <hr>
520
+ <div class="refsect2">
521
+ <a name="g-tls-connection-handshake"></a><h3>g_tls_connection_handshake ()</h3>
522
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_tls_connection_handshake (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
523
+ <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
524
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
525
+ <p>
526
+ Attempts a TLS handshake on <em class="parameter"><code>conn</code></em>.
527
+ </p>
528
+ <p>
529
+ On the client side, it is never necessary to call this method;
530
+ although the connection needs to perform a handshake after
531
+ connecting (or after sending a "STARTTLS"-type command) and may
532
+ need to rehandshake later if the server requests it,
533
+ <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> will handle this for you automatically when you try
534
+ to send or receive data on the connection. However, you can call
535
+ <a class="link" href="GTlsConnection.html#g-tls-connection-handshake" title="g_tls_connection_handshake ()"><code class="function">g_tls_connection_handshake()</code></a> manually if you want to know for sure
536
+ whether the initial handshake succeeded or failed (as opposed to
537
+ just immediately trying to write to <em class="parameter"><code>conn</code></em>'s output stream, in which
538
+ case if it fails, it may not be possible to tell if it failed
539
+ before or after completing the handshake).
540
+ </p>
541
+ <p>
542
+ Likewise, on the server side, although a handshake is necessary at
543
+ the beginning of the communication, you do not need to call this
544
+ function explicitly unless you want clearer error reporting.
545
+ However, you may call <a class="link" href="GTlsConnection.html#g-tls-connection-handshake" title="g_tls_connection_handshake ()"><code class="function">g_tls_connection_handshake()</code></a> later on to
546
+ renegotiate parameters (encryption methods, etc) with the client.
547
+ </p>
548
+ <p>
549
+ <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept_certificate"</span></a> may be emitted during the
550
+ handshake.
551
+ </p>
552
+ <div class="variablelist"><table border="0">
553
+ <col align="left" valign="top">
554
+ <tbody>
555
+ <tr>
556
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
557
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
558
+ </td>
559
+ </tr>
560
+ <tr>
561
+ <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
562
+ <td>a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
563
+ </td>
564
+ </tr>
565
+ <tr>
566
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
567
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
568
+ </td>
569
+ </tr>
570
+ <tr>
571
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
572
+ <td>success or failure</td>
573
+ </tr>
574
+ </tbody>
575
+ </table></div>
576
+ <p class="since">Since 2.28</p>
577
+ </div>
578
+ <hr>
579
+ <div class="refsect2">
580
+ <a name="g-tls-connection-handshake-async"></a><h3>g_tls_connection_handshake_async ()</h3>
581
+ <pre class="programlisting"><span class="returnvalue">void</span> g_tls_connection_handshake_async (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
582
+ <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
583
+ <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
584
+ <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
585
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
586
+ <p>
587
+ Asynchronously performs a TLS handshake on <em class="parameter"><code>conn</code></em>. See
588
+ <a class="link" href="GTlsConnection.html#g-tls-connection-handshake" title="g_tls_connection_handshake ()"><code class="function">g_tls_connection_handshake()</code></a> for more information.
589
+ </p>
590
+ <div class="variablelist"><table border="0">
591
+ <col align="left" valign="top">
592
+ <tbody>
593
+ <tr>
594
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
595
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
596
+ </td>
597
+ </tr>
598
+ <tr>
599
+ <td><p><span class="term"><em class="parameter"><code>io_priority</code></em> :</span></p></td>
600
+ <td>the <a class="link" href="gio-GIOScheduler.html#io-priority">I/O priority</a>
601
+ of the request.</td>
602
+ </tr>
603
+ <tr>
604
+ <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
605
+ <td>a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
606
+ </td>
607
+ </tr>
608
+ <tr>
609
+ <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
610
+ <td>callback to call when the handshake is complete</td>
611
+ </tr>
612
+ <tr>
613
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
614
+ <td>the data to pass to the callback function</td>
615
+ </tr>
616
+ </tbody>
617
+ </table></div>
618
+ <p class="since">Since 2.28</p>
619
+ </div>
620
+ <hr>
621
+ <div class="refsect2">
622
+ <a name="g-tls-connection-handshake-finish"></a><h3>g_tls_connection_handshake_finish ()</h3>
623
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_tls_connection_handshake_finish (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
624
+ <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
625
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
626
+ <p>
627
+ Finish an asynchronous TLS handshake operation. See
628
+ <a class="link" href="GTlsConnection.html#g-tls-connection-handshake" title="g_tls_connection_handshake ()"><code class="function">g_tls_connection_handshake()</code></a> for more information.
629
+ </p>
630
+ <div class="variablelist"><table border="0">
631
+ <col align="left" valign="top">
632
+ <tbody>
633
+ <tr>
634
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
635
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
636
+ </td>
637
+ </tr>
638
+ <tr>
639
+ <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
640
+ <td>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</td>
641
+ </tr>
642
+ <tr>
643
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
644
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> pointer, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
645
+ </td>
646
+ </tr>
647
+ <tr>
648
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
649
+ <td>
650
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure, in which
651
+ case <em class="parameter"><code>error</code></em> will be set.</td>
652
+ </tr>
653
+ </tbody>
654
+ </table></div>
655
+ <p class="since">Since 2.28</p>
656
+ </div>
657
+ <hr>
658
+ <div class="refsect2">
659
+ <a name="g-tls-connection-emit-accept-certificate"></a><h3>g_tls_connection_emit_accept_certificate ()</h3>
660
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_tls_connection_emit_accept_certificate
661
+ (<em class="parameter"><code><a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn</code></em>,
662
+ <em class="parameter"><code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a> *peer_cert</code></em>,
663
+ <em class="parameter"><code><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> errors</code></em>);</pre>
664
+ <p>
665
+ Used by <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> implementations to emit the
666
+ <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a> signal.
667
+ </p>
668
+ <div class="variablelist"><table border="0">
669
+ <col align="left" valign="top">
670
+ <tbody>
671
+ <tr>
672
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
673
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
674
+ </td>
675
+ </tr>
676
+ <tr>
677
+ <td><p><span class="term"><em class="parameter"><code>peer_cert</code></em> :</span></p></td>
678
+ <td>the peer's <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a>
679
+ </td>
680
+ </tr>
681
+ <tr>
682
+ <td><p><span class="term"><em class="parameter"><code>errors</code></em> :</span></p></td>
683
+ <td>the problems with <em class="parameter"><code>peer_cert</code></em>
684
+ </td>
685
+ </tr>
686
+ <tr>
687
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
688
+ <td>
689
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if one of the signal handlers has returned
690
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to accept <em class="parameter"><code>peer_cert</code></em>
691
+ </td>
692
+ </tr>
693
+ </tbody>
694
+ </table></div>
695
+ <p class="since">Since 2.28</p>
696
+ </div>
697
+ </div>
698
+ <div class="refsect1">
699
+ <a name="GTlsConnection.property-details"></a><h2>Property Details</h2>
700
+ <div class="refsect2">
701
+ <a name="GTlsConnection--base-io-stream"></a><h3>The <code class="literal">"base-io-stream"</code> property</h3>
702
+ <pre class="programlisting"> "base-io-stream" <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a>* : Read / Write / Construct Only</pre>
703
+ <p>
704
+ The <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a> that the connection wraps
705
+ </p>
706
+ <p class="since">Since 2.28</p>
707
+ </div>
708
+ <hr>
709
+ <div class="refsect2">
710
+ <a name="GTlsConnection--certificate"></a><h3>The <code class="literal">"certificate"</code> property</h3>
711
+ <pre class="programlisting"> "certificate" <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a>* : Read / Write</pre>
712
+ <p>
713
+ The connection's certificate; see
714
+ <a class="link" href="GTlsConnection.html#g-tls-connection-set-certificate" title="g_tls_connection_set_certificate ()"><code class="function">g_tls_connection_set_certificate()</code></a>.
715
+ </p>
716
+ <p class="since">Since 2.28</p>
717
+ </div>
718
+ <hr>
719
+ <div class="refsect2">
720
+ <a name="GTlsConnection--peer-certificate"></a><h3>The <code class="literal">"peer-certificate"</code> property</h3>
721
+ <pre class="programlisting"> "peer-certificate" <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a>* : Read</pre>
722
+ <p>
723
+ The connection's peer's certificate, after the TLS handshake has
724
+ completed and the certificate has been accepted. Note in
725
+ particular that this is not yet set during the emission of
726
+ <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a>.
727
+ </p>
728
+ <p>
729
+ (You can watch for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal on this property to
730
+ detect when a handshake has occurred.)
731
+ </p>
732
+ <p class="since">Since 2.28</p>
733
+ </div>
734
+ <hr>
735
+ <div class="refsect2">
736
+ <a name="GTlsConnection--peer-certificate-errors"></a><h3>The <code class="literal">"peer-certificate-errors"</code> property</h3>
737
+ <pre class="programlisting"> "peer-certificate-errors" <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> : Read</pre>
738
+ <p>
739
+ The errors noticed-and-ignored while verifying
740
+ <a class="link" href="GTlsConnection.html#GTlsConnection--peer-certificate" title='The "peer-certificate" property'><span class="type">"peer-certificate"</span></a>. Normally this should be <code class="literal">0</code>, but
741
+ it may not be if <span class="type">"validation-flags"</span> is not
742
+ <a class="link" href="gio-TLS-Overview.html#G-TLS-CERTIFICATE-VALIDATE-ALL:CAPS"><code class="literal">G_TLS_CERTIFICATE_VALIDATE_ALL</code></a>, or if
743
+ <a class="link" href="GTlsConnection.html#GTlsConnection-accept-certificate" title='The "accept-certificate" signal'><span class="type">"accept-certificate"</span></a> overrode the default
744
+ behavior.
745
+ </p>
746
+ <p class="since">Since 2.28</p>
747
+ </div>
748
+ <hr>
749
+ <div class="refsect2">
750
+ <a name="GTlsConnection--rehandshake-mode"></a><h3>The <code class="literal">"rehandshake-mode"</code> property</h3>
751
+ <pre class="programlisting"> "rehandshake-mode" <a class="link" href="GTlsConnection.html#GTlsRehandshakeMode"><span class="type">GTlsRehandshakeMode</span></a> : Read / Write / Construct</pre>
752
+ <p>
753
+ The rehandshaking mode. See
754
+ <a class="link" href="GTlsConnection.html#g-tls-connection-set-rehandshake-mode" title="g_tls_connection_set_rehandshake_mode ()"><code class="function">g_tls_connection_set_rehandshake_mode()</code></a>.
755
+ </p>
756
+ <p>Default value: G_TLS_REHANDSHAKE_SAFELY</p>
757
+ <p class="since">Since 2.28</p>
758
+ </div>
759
+ <hr>
760
+ <div class="refsect2">
761
+ <a name="GTlsConnection--require-close-notify"></a><h3>The <code class="literal">"require-close-notify"</code> property</h3>
762
+ <pre class="programlisting"> "require-close-notify" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct</pre>
763
+ <p>
764
+ Whether or not proper TLS close notification is required.
765
+ See <a class="link" href="GTlsConnection.html#g-tls-connection-set-require-close-notify" title="g_tls_connection_set_require_close_notify ()"><code class="function">g_tls_connection_set_require_close_notify()</code></a>.
766
+ </p>
767
+ <p>Default value: TRUE</p>
768
+ <p class="since">Since 2.28</p>
769
+ </div>
770
+ <hr>
771
+ <div class="refsect2">
772
+ <a name="GTlsConnection--use-system-certdb"></a><h3>The <code class="literal">"use-system-certdb"</code> property</h3>
773
+ <pre class="programlisting"> "use-system-certdb" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct</pre>
774
+ <p>
775
+ Whether or not the system certificate database will be used to
776
+ verify peer certificates. See
777
+ <a class="link" href="GTlsConnection.html#g-tls-connection-set-use-system-certdb" title="g_tls_connection_set_use_system_certdb ()"><code class="function">g_tls_connection_set_use_system_certdb()</code></a>.
778
+ </p>
779
+ <p>Default value: TRUE</p>
780
+ <p class="since">Since 2.28</p>
781
+ </div>
782
+ </div>
783
+ <div class="refsect1">
784
+ <a name="GTlsConnection.signal-details"></a><h2>Signal Details</h2>
785
+ <div class="refsect2">
786
+ <a name="GTlsConnection-accept-certificate"></a><h3>The <code class="literal">"accept-certificate"</code> signal</h3>
787
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> user_function (<a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a> *conn,
788
+ <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a> *peer_cert,
789
+ <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> errors,
790
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
791
+ <p>
792
+ Emitted during the TLS handshake after the peer certificate has
793
+ been received. You can examine <em class="parameter"><code>peer_cert</code></em>'s certification path by
794
+ calling <a class="link" href="GTlsCertificate.html#g-tls-certificate-get-issuer" title="g_tls_certificate_get_issuer ()"><code class="function">g_tls_certificate_get_issuer()</code></a> on it.
795
+ </p>
796
+ <p>
797
+ For a client-side connection, <em class="parameter"><code>peer_cert</code></em> is the server's
798
+ certificate, and the signal will only be emitted if the
799
+ certificate was not acceptable according to <em class="parameter"><code>conn</code></em>'s
800
+ <a class="link" href="GTlsClientConnection.html#GTlsClientConnection--validation-flags" title='The "validation-flags" property'><span class="type">"validation_flags"</span></a>. If you would like the
801
+ certificate to be accepted despite <em class="parameter"><code>errors</code></em>, return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from the
802
+ signal handler. Otherwise, if no handler accepts the certificate,
803
+ the handshake will fail with <a class="link" href="gio-TLS-Overview.html#G-TLS-ERROR-BAD-CERTIFICATE:CAPS"><code class="literal">G_TLS_ERROR_BAD_CERTIFICATE</code></a>.
804
+ </p>
805
+ <p>
806
+ For a server-side connection, <em class="parameter"><code>peer_cert</code></em> is the certificate
807
+ presented by the client, if this was requested via the server's
808
+ <a class="link" href="GTlsServerConnection.html#GTlsServerConnection--authentication-mode" title='The "authentication-mode" property'><span class="type">"authentication_mode"</span></a>. On the server side,
809
+ the signal is always emitted when the client presents a
810
+ certificate, and the certificate will only be accepted if a
811
+ handler returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
812
+ </p>
813
+ <p>
814
+ Note that if this signal is emitted as part of asynchronous I/O
815
+ in the main thread, then you should not attempt to interact with
816
+ the user before returning from the signal handler. If you want to
817
+ let the user decide whether or not to accept the certificate, you
818
+ would have to return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> from the signal handler on the first
819
+ attempt, and then after the connection attempt returns a
820
+ <a class="link" href="gio-TLS-Overview.html#G-TLS-ERROR-HANDSHAKE:CAPS"><code class="literal">G_TLS_ERROR_HANDSHAKE</code></a>, you can interact with the user, and if
821
+ the user decides to accept the certificate, remember that fact,
822
+ create a new connection, and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from the signal handler
823
+ the next time.
824
+ </p>
825
+ <p>
826
+ If you are doing I/O in another thread, you do not
827
+ need to worry about this, and can simply block in the signal
828
+ handler until the UI thread returns an answer.
829
+ </p>
830
+ <div class="variablelist"><table border="0">
831
+ <col align="left" valign="top">
832
+ <tbody>
833
+ <tr>
834
+ <td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
835
+ <td>a <a class="link" href="GTlsConnection.html" title="GTlsConnection"><span class="type">GTlsConnection</span></a>
836
+ </td>
837
+ </tr>
838
+ <tr>
839
+ <td><p><span class="term"><em class="parameter"><code>peer_cert</code></em> :</span></p></td>
840
+ <td>the peer's <a class="link" href="GTlsCertificate.html" title="GTlsCertificate"><span class="type">GTlsCertificate</span></a>
841
+ </td>
842
+ </tr>
843
+ <tr>
844
+ <td><p><span class="term"><em class="parameter"><code>errors</code></em> :</span></p></td>
845
+ <td>the problems with <em class="parameter"><code>peer_cert</code></em>.</td>
846
+ </tr>
847
+ <tr>
848
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
849
+ <td>user data set when the signal handler was connected.</td>
850
+ </tr>
851
+ <tr>
852
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
853
+ <td>
854
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to accept <em class="parameter"><code>peer_cert</code></em> (which will also
855
+ immediately end the signal emission). <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to allow the signal
856
+ emission to continue, which will cause the handshake to fail if
857
+ no one else overrides it.</td>
858
+ </tr>
859
+ </tbody>
860
+ </table></div>
861
+ <p class="since">Since 2.28</p>
862
+ </div>
863
+ </div>
864
+ </div>
865
+ <div class="footer">
866
+ <hr>
867
+ Generated by GTK-Doc V1.16.1</div>
868
+ </body>
869
+ </html>