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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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>