glib2 3.0.8-x64-mingw32 → 3.0.9-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +2 -2
- data/ext/glib2/extconf.rb +0 -1
- data/ext/glib2/rbglib-variant-type.c +5 -1
- data/ext/glib2/rbglib-variant.c +21 -7
- data/ext/glib2/rbglib.c +0 -38
- data/ext/glib2/rbglib.h +2 -2
- data/ext/glib2/rbglib_convert.c +3 -9
- data/ext/glib2/rbglib_matchinfo.c +4 -0
- data/ext/glib2/rbglib_regex.c +12 -1
- data/ext/glib2/rbgobj_object.c +112 -10
- data/ext/glib2/rbgobj_signal.c +12 -1
- data/ext/glib2/rbgobj_type.c +7 -1
- data/ext/glib2/rbgobject.c +0 -6
- data/ext/glib2/rbgprivate.h +0 -4
- data/ext/glib2/rbgutil.c +0 -2
- data/ext/glib2/rbgutil.h +1 -3
- data/lib/2.2/glib2.so +0 -0
- data/lib/2.3/glib2.so +0 -0
- data/lib/glib2.rb +7 -0
- data/lib/gnome2/rake/external-package.rb +119 -2
- data/lib/gnome2/rake/package-task.rb +63 -3
- data/lib/gnome2/rake/windows-binary-build-task.rb +343 -337
- data/lib/gnome2/rake/windows-binary-download-task.rb +151 -148
- data/lib/mkmf-gnome2.rb +11 -30
- data/test/test-binding.rb +157 -66
- data/test/test_glib2.rb +21 -6
- data/vendor/local/bin/asn1Coding.exe +0 -0
- data/vendor/local/bin/asn1Decoding.exe +0 -0
- data/vendor/local/bin/asn1Parser.exe +0 -0
- data/vendor/local/bin/gdbus.exe +0 -0
- data/vendor/local/bin/gio-querymodules.exe +0 -0
- data/vendor/local/bin/glib-compile-resources.exe +0 -0
- data/vendor/local/bin/glib-compile-schemas.exe +0 -0
- data/vendor/local/bin/glib-genmarshal.exe +0 -0
- data/vendor/local/bin/glib-gettextize +1 -1
- data/vendor/local/bin/glib-mkenums +1 -1
- data/vendor/local/bin/gobject-query.exe +0 -0
- data/vendor/local/bin/gresource.exe +0 -0
- data/vendor/local/bin/gsettings.exe +0 -0
- data/vendor/local/bin/gspawn-win64-helper-console.exe +0 -0
- data/vendor/local/bin/gspawn-win64-helper.exe +0 -0
- data/vendor/local/bin/iconv.exe +0 -0
- data/vendor/local/bin/libgio-2.0-0.dll +0 -0
- data/vendor/local/bin/libglib-2.0-0.dll +0 -0
- data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
- data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
- data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
- data/vendor/local/bin/libnettle-6-2.dll +0 -0
- data/vendor/local/bin/nettle-pbkdf2.exe +0 -0
- data/vendor/local/bin/pkcs1-conv.exe +0 -0
- data/vendor/local/include/glib-2.0/gio/gioenums.h +1 -1
- data/vendor/local/include/glib-2.0/glib/gmacros.h +21 -6
- data/vendor/local/include/glib-2.0/glib/gregex.h +1 -1
- data/vendor/local/lib/gio/modules/libgiognutls.a +0 -0
- data/vendor/local/lib/gio/modules/libgiognutls.dll +0 -0
- data/vendor/local/lib/gio/modules/libgiognutls.dll.a +0 -0
- data/vendor/local/lib/glib-2.0/include/glibconfig.h +1 -1
- data/vendor/local/lib/libasprintf.dll.a +0 -0
- data/vendor/local/lib/libcharset.dll.a +0 -0
- data/vendor/local/lib/libffi.dll.a +0 -0
- data/vendor/local/lib/libgio-2.0.dll.a +0 -0
- data/vendor/local/lib/libgio-2.0.la +1 -1
- data/vendor/local/lib/libglib-2.0.dll.a +0 -0
- data/vendor/local/lib/libglib-2.0.la +1 -1
- data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
- data/vendor/local/lib/libgmodule-2.0.la +1 -1
- data/vendor/local/lib/libgmp.dll.a +0 -0
- data/vendor/local/lib/libgnutls.dll.a +0 -0
- data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
- data/vendor/local/lib/libgobject-2.0.la +1 -1
- data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
- data/vendor/local/lib/libgthread-2.0.la +1 -1
- data/vendor/local/lib/libhogweed.dll.a +0 -0
- data/vendor/local/lib/libiconv.dll.a +0 -0
- data/vendor/local/lib/libidn.dll.a +0 -0
- data/vendor/local/lib/libintl.dll.a +0 -0
- data/vendor/local/lib/libnettle.dll.a +0 -0
- data/vendor/local/lib/libp11-kit.dll.a +0 -0
- data/vendor/local/lib/libpcre.dll.a +0 -0
- data/vendor/local/lib/libpcrecpp.dll.a +0 -0
- data/vendor/local/lib/libpcreposix.dll.a +0 -0
- data/vendor/local/lib/libtasn1.dll.a +0 -0
- data/vendor/local/lib/p11-kit/p11-kit-remote.exe +0 -0
- data/vendor/local/lib/pkcs11/p11-kit-trust.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/gio-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/glib-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-export-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gobject-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gthread-2.0.pc +1 -1
- data/vendor/local/share/gdb/auto-load/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/{libglib-2.0.so.0.4800.0-gdb.py → libglib-2.0.so.0.4800.1-gdb.py} +0 -0
- data/vendor/local/share/gdb/auto-load/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/{libgobject-2.0.so.0.4800.0-gdb.py → libgobject-2.0.so.0.4800.1-gdb.py} +0 -0
- data/vendor/local/share/glib-2.0/codegen/__init__.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/__init__.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_docbook.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_docbook.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_main.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/codegen_main.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/config.py +1 -1
- data/vendor/local/share/glib-2.0/codegen/config.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/config.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/dbustypes.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/dbustypes.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/parser.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/parser.pyo +0 -0
- data/vendor/local/share/glib-2.0/codegen/utils.pyc +0 -0
- data/vendor/local/share/glib-2.0/codegen/utils.pyo +0 -0
- data/vendor/local/share/gtk-doc/html/gio/GAction.html +98 -104
- data/vendor/local/share/gtk-doc/html/gio/GActionGroup.html +116 -121
- data/vendor/local/share/gtk-doc/html/gio/GActionMap.html +28 -33
- data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +206 -211
- data/vendor/local/share/gtk-doc/html/gio/GAppInfoMonitor.html +9 -9
- data/vendor/local/share/gtk-doc/html/gio/GApplication.html +219 -221
- data/vendor/local/share/gtk-doc/html/gio/GApplicationCommandLine.html +87 -87
- data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +63 -68
- data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +36 -41
- data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +62 -62
- data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +29 -29
- data/vendor/local/share/gtk-doc/html/gio/GBytesIcon.html +18 -18
- data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +81 -81
- data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +28 -28
- data/vendor/local/share/gtk-doc/html/gio/GConverter.html +16 -21
- data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +43 -43
- data/vendor/local/share/gtk-doc/html/gio/GDBusActionGroup.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +38 -38
- data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +526 -526
- data/vendor/local/share/gtk-doc/html/gio/GDBusInterface.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/GDBusInterfaceSkeleton.html +66 -71
- data/vendor/local/share/gtk-doc/html/gio/GDBusMenuModel.html +8 -8
- data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +202 -202
- data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +76 -76
- data/vendor/local/share/gtk-doc/html/gio/GDBusObject.html +29 -29
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectManager.html +43 -43
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectManagerClient.html +141 -146
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectManagerServer.html +32 -36
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectProxy.html +12 -16
- data/vendor/local/share/gtk-doc/html/gio/GDBusObjectSkeleton.html +28 -35
- data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +229 -229
- data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +51 -51
- data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +160 -160
- data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +86 -86
- data/vendor/local/share/gtk-doc/html/gio/GDatagramBased.html +73 -78
- data/vendor/local/share/gtk-doc/html/gio/GDrive.html +181 -186
- data/vendor/local/share/gtk-doc/html/gio/GDtlsClientConnection.html +29 -33
- data/vendor/local/share/gtk-doc/html/gio/GDtlsConnection.html +122 -122
- data/vendor/local/share/gtk-doc/html/gio/GDtlsServerConnection.html +12 -16
- data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +14 -14
- data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/GFile.html +890 -895
- data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +9 -16
- data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +78 -78
- data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +21 -21
- data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +9 -9
- data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +239 -239
- data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +18 -18
- data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +29 -29
- data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +21 -21
- data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +19 -19
- data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +39 -39
- data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +60 -60
- data/vendor/local/share/gtk-doc/html/gio/GIcon.html +48 -53
- data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +110 -110
- data/vendor/local/share/gtk-doc/html/gio/GInetAddressMask.html +37 -37
- data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +31 -31
- data/vendor/local/share/gtk-doc/html/gio/GInitable.html +68 -75
- data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +142 -142
- data/vendor/local/share/gtk-doc/html/gio/GListModel.html +44 -49
- data/vendor/local/share/gtk-doc/html/gio/GListStore.html +35 -35
- data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +19 -24
- data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +19 -19
- data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +57 -57
- data/vendor/local/share/gtk-doc/html/gio/GMenu.html +143 -143
- data/vendor/local/share/gtk-doc/html/gio/GMenuModel.html +107 -107
- data/vendor/local/share/gtk-doc/html/gio/GMount.html +161 -166
- data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +83 -83
- data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +45 -45
- data/vendor/local/share/gtk-doc/html/gio/GNetworkMonitor.html +54 -59
- data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +34 -34
- data/vendor/local/share/gtk-doc/html/gio/GNotification.html +51 -51
- data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +186 -186
- data/vendor/local/share/gtk-doc/html/gio/GPermission.html +71 -71
- data/vendor/local/share/gtk-doc/html/gio/GPollableInputStream.html +40 -45
- data/vendor/local/share/gtk-doc/html/gio/GPollableOutputStream.html +40 -45
- data/vendor/local/share/gtk-doc/html/gio/GPropertyAction.html +36 -36
- data/vendor/local/share/gtk-doc/html/gio/GProxy.html +25 -30
- data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +59 -59
- data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +32 -37
- data/vendor/local/share/gtk-doc/html/gio/GRemoteActionGroup.html +18 -23
- data/vendor/local/share/gtk-doc/html/gio/GResolver.html +147 -147
- data/vendor/local/share/gtk-doc/html/gio/GResource.html +114 -114
- data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +46 -51
- data/vendor/local/share/gtk-doc/html/gio/GSettings.html +354 -354
- data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +47 -52
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAction.html +46 -46
- data/vendor/local/share/gtk-doc/html/gio/GSimpleActionGroup.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +146 -146
- data/vendor/local/share/gtk-doc/html/gio/GSimpleIOStream.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/GSimpleProxyResolver.html +19 -19
- data/vendor/local/share/gtk-doc/html/gio/GSocket.html +454 -454
- data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +26 -26
- data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +138 -138
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +37 -42
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +54 -54
- data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +20 -20
- data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +91 -91
- data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +22 -22
- data/vendor/local/share/gtk-doc/html/gio/GSrvTarget.html +38 -38
- data/vendor/local/share/gtk-doc/html/gio/GSubprocess.html +139 -139
- data/vendor/local/share/gtk-doc/html/gio/GSubprocessLauncher.html +63 -63
- data/vendor/local/share/gtk-doc/html/gio/GTask.html +219 -219
- data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +12 -12
- data/vendor/local/share/gtk-doc/html/gio/GTcpWrapperConnection.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/GTestDBus.html +21 -21
- data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +24 -24
- data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +16 -16
- data/vendor/local/share/gtk-doc/html/gio/GTlsBackend.html +53 -58
- data/vendor/local/share/gtk-doc/html/gio/GTlsCertificate.html +57 -57
- data/vendor/local/share/gtk-doc/html/gio/GTlsClientConnection.html +40 -47
- data/vendor/local/share/gtk-doc/html/gio/GTlsConnection.html +84 -84
- data/vendor/local/share/gtk-doc/html/gio/GTlsDatabase.html +79 -84
- data/vendor/local/share/gtk-doc/html/gio/GTlsFileDatabase.html +13 -17
- data/vendor/local/share/gtk-doc/html/gio/GTlsInteraction.html +32 -32
- data/vendor/local/share/gtk-doc/html/gio/GTlsPassword.html +41 -46
- data/vendor/local/share/gtk-doc/html/gio/GTlsServerConnection.html +11 -15
- data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +52 -52
- data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +12 -12
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +43 -43
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +25 -25
- data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +25 -25
- data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +25 -25
- data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +38 -38
- data/vendor/local/share/gtk-doc/html/gio/GVfs.html +24 -24
- data/vendor/local/share/gtk-doc/html/gio/GVolume.html +117 -122
- data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +87 -87
- data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +14 -14
- data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +10 -10
- data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-28.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-30.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-32.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-34.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-36.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-38.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-40.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-42.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-44.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-46.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-48.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/application.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/async.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch02.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/ch03.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch32.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch33.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/ch33s02.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/ch33s03.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch34.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s03.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch34s04.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s05.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch34s06.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/ch34s07.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/ch35.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch35s02.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/ch35s03.html +10 -10
- data/vendor/local/share/gtk-doc/html/gio/ch35s04.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/conversion.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/data-models.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/extending.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/file_mon.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/file_ops.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gapplication-tool.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gdbus-codegen.html +55 -55
- data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gdbus-example-gdbus-codegen.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gdbus.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +51 -51
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +188 -188
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +72 -72
- data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +110 -117
- data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +48 -48
- data/vendor/local/share/gtk-doc/html/gio/gio-GActionGroup-exporter.html +11 -11
- data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +86 -86
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +103 -103
- data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +22 -22
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +15 -15
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +41 -41
- data/vendor/local/share/gtk-doc/html/gio/gio-GMenuModel-exporter.html +11 -11
- data/vendor/local/share/gtk-doc/html/gio/gio-GSettingsSchema-GSettingsSchemaSource.html +108 -108
- data/vendor/local/share/gtk-doc/html/gio/gio-GWin32InputStream.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/gio-GWin32OutputStream.html +17 -17
- data/vendor/local/share/gtk-doc/html/gio/gio-GWin32RegistryKey.html +221 -221
- data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +63 -63
- data/vendor/local/share/gtk-doc/html/gio/gio-TLS-Overview.html +16 -23
- data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +128 -128
- data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +57 -57
- data/vendor/local/share/gtk-doc/html/gio/gio-gnetworking.h.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gio-gpollableutils.html +71 -71
- data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +450 -10
- data/vendor/local/share/gtk-doc/html/gio/glib-compile-resources.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gresource-tool.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/gsettings-tool.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/icons.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/migrating.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/networking.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/permissions.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/pt01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/pt02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/registry.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/resolver.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/resources.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/running-gio-apps.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/settings.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/streaming.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/subprocesses.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/testing.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/tls.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/tools.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/types.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/utils.html +2 -2
- data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-28.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-30.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-32.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-34.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-36.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-38.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +3 -10
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-40.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-42.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-44.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-46.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-48.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +3 -10
- data/vendor/local/share/gtk-doc/html/glib/deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +42 -42
- data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +44 -44
- data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +40 -40
- data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +18 -18
- data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +32 -32
- data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +14 -14
- data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +5 -5
- data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +68 -68
- data/vendor/local/share/gtk-doc/html/glib/glib-Bounds-checked-integer-arithmetic.html +14 -14
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +56 -56
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +120 -120
- data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +15 -15
- data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +35 -35
- data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +72 -72
- data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +21 -21
- data/vendor/local/share/gtk-doc/html/glib/glib-Data-HMACs.html +17 -17
- data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +24 -24
- data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +93 -93
- data/vendor/local/share/gtk-doc/html/glib/glib-Deprecated-Thread-APIs.html +50 -50
- data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +64 -64
- data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +69 -69
- data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +21 -21
- data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +80 -80
- data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +157 -157
- data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +20 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +292 -266
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +423 -421
- data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +13 -13
- data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +92 -92
- data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +62 -62
- data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +12 -12
- data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +27 -56
- data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +84 -84
- data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +81 -81
- data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +31 -31
- data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +45 -45
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +55 -55
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +22 -22
- data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +80 -78
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +36 -36
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +83 -83
- data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +81 -81
- data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +4 -4
- data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +84 -84
- data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +34 -34
- data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +15 -15
- data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +30 -30
- data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +20 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +67 -67
- data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +9 -9
- data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +34 -34
- data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +58 -58
- data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +30 -30
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +12 -12
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +195 -189
- data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +65 -65
- data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +91 -91
- data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +166 -166
- data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +24 -24
- data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +86 -86
- data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +11 -11
- data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +8 -8
- data/vendor/local/share/gtk-doc/html/glib/glib-UNIX-specific-utilities-and-integration.html +46 -38
- data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +16 -16
- data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +134 -134
- data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +128 -128
- data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +20 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-building.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-core.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-programming.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-running.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +189 -51
- data/vendor/local/share/gtk-doc/html/glib/glib.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/gtester.html +2 -2
- data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +15 -15
- data/vendor/local/share/gtk-doc/html/glib/gvariant-text.html +17 -17
- data/vendor/local/share/gtk-doc/html/glib/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/tools.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +55 -55
- data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +28 -33
- data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +12 -12
- data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-28.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-30.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-32.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-34.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-36.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-38.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-40.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-42.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-44.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-46.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +72 -62
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +301 -301
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +71 -71
- data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +139 -139
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +92 -92
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +304 -304
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +570 -682
- data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +276 -276
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +349 -349
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +54 -54
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +15 -15
- data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +153 -8
- data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +9 -9
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +15 -15
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-override.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-prerequisite.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +9 -9
- data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/pr01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/pt01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/pt02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/pt03.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/rn01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/rn02.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/signal.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +2 -2
- data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +2 -2
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-Future.html +4 -4
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-Modules.html +12 -12
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-PIN-Callbacks.html +15 -15
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-URIs.html +2 -2
- data/vendor/local/share/gtk-doc/html/p11-kit/p11-kit-Utilities.html +2 -2
- data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/fur/LC_MESSAGES/glib-networking.mo +0 -0
- data/vendor/local/share/locale/gd/LC_MESSAGES/glib-networking.mo +0 -0
- data/vendor/local/share/locale/oc/LC_MESSAGES/glib-networking.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/man/man1/gapplication.1 +1 -1
- data/vendor/local/share/man/man1/gdbus-codegen.1 +1 -1
- data/vendor/local/share/man/man1/gdbus.1 +1 -1
- data/vendor/local/share/man/man1/gio-querymodules.1 +1 -1
- data/vendor/local/share/man/man1/glib-compile-resources.1 +1 -1
- data/vendor/local/share/man/man1/glib-compile-schemas.1 +1 -1
- data/vendor/local/share/man/man1/glib-genmarshal.1 +1 -1
- data/vendor/local/share/man/man1/glib-gettextize.1 +1 -1
- data/vendor/local/share/man/man1/glib-mkenums.1 +1 -1
- data/vendor/local/share/man/man1/gobject-query.1 +1 -1
- data/vendor/local/share/man/man1/gresource.1 +1 -1
- data/vendor/local/share/man/man1/gsettings.1 +1 -1
- data/vendor/local/share/man/man1/gtester-report.1 +1 -1
- data/vendor/local/share/man/man1/gtester.1 +1 -1
- metadata +6 -8
- data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -4612
- data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -3447
- data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -924
@@ -8,7 +8,7 @@
|
|
8
8
|
<link rel="up" href="streaming.html" title="Streaming I/O">
|
9
9
|
<link rel="prev" href="GIOStream.html" title="GIOStream">
|
10
10
|
<link rel="next" href="GFileInputStream.html" title="GFileInputStream">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
@@ -89,7 +89,7 @@
|
|
89
89
|
</div>
|
90
90
|
<div class="refsect1">
|
91
91
|
<a name="GSimpleIOStream.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
92
|
-
<pre class="screen"> <a href="../gobject
|
92
|
+
<pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
93
93
|
<span class="lineart">╰──</span> <a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a>
|
94
94
|
<span class="lineart">╰──</span> GSimpleIOStream
|
95
95
|
</pre>
|
@@ -121,7 +121,7 @@ g_simple_io_stream_new (<em class="parameter"><code><a class="link" href="GInput
|
|
121
121
|
.
|
122
122
|
See also <a class="link" href="GIOStream.html" title="GIOStream"><span class="type">GIOStream</span></a>.</p>
|
123
123
|
<div class="refsect3">
|
124
|
-
<a name="
|
124
|
+
<a name="g-simple-io-stream-new.parameters"></a><h4>Parameters</h4>
|
125
125
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
126
126
|
<colgroup>
|
127
127
|
<col width="150px" class="parameters_name">
|
@@ -143,7 +143,7 @@ See also <a class="link" href="GIOStream.html" title="GIOStream"><span class="ty
|
|
143
143
|
</table></div>
|
144
144
|
</div>
|
145
145
|
<div class="refsect3">
|
146
|
-
<a name="
|
146
|
+
<a name="g-simple-io-stream-new.returns"></a><h4>Returns</h4>
|
147
147
|
<p> a new <a class="link" href="GSimpleIOStream.html" title="GSimpleIOStream"><span class="type">GSimpleIOStream</span></a> instance.</p>
|
148
148
|
</div>
|
149
149
|
<p class="since">Since: <a class="link" href="api-index-2-44.html#api-index-2.44">2.44</a></p>
|
@@ -182,6 +182,6 @@ See also <a class="link" href="GIOStream.html" title="GIOStream"><span class="ty
|
|
182
182
|
</div>
|
183
183
|
</div>
|
184
184
|
<div class="footer">
|
185
|
-
<hr>Generated by GTK-Doc V1.
|
185
|
+
<hr>Generated by GTK-Doc V1.25.1</div>
|
186
186
|
</body>
|
187
187
|
</html>
|
@@ -8,7 +8,7 @@
|
|
8
8
|
<link rel="up" href="permissions.html" title="Permissions">
|
9
9
|
<link rel="prev" href="GPermission.html" title="GPermission">
|
10
10
|
<link rel="next" href="data-models.html" title="Data Models">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
@@ -64,7 +64,7 @@
|
|
64
64
|
</div>
|
65
65
|
<div class="refsect1">
|
66
66
|
<a name="GSimplePermission.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
67
|
-
<pre class="screen"> <a href="../gobject
|
67
|
+
<pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
68
68
|
<span class="lineart">╰──</span> <a class="link" href="GPermission.html" title="GPermission">GPermission</a>
|
69
69
|
<span class="lineart">╰──</span> GSimplePermission
|
70
70
|
</pre>
|
@@ -86,11 +86,11 @@ value is given at construction and doesn't change.</p>
|
|
86
86
|
<div class="refsect2">
|
87
87
|
<a name="g-simple-permission-new"></a><h3>g_simple_permission_new ()</h3>
|
88
88
|
<pre class="programlisting"><a class="link" href="GPermission.html" title="GPermission"><span class="returnvalue">GPermission</span></a> *
|
89
|
-
g_simple_permission_new (<em class="parameter"><code><a href="../glib
|
89
|
+
g_simple_permission_new (<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allowed</code></em>);</pre>
|
90
90
|
<p>Creates a new <a class="link" href="GPermission.html" title="GPermission"><span class="type">GPermission</span></a> instance that represents an action that is
|
91
91
|
either always or never allowed.</p>
|
92
92
|
<div class="refsect3">
|
93
|
-
<a name="
|
93
|
+
<a name="g-simple-permission-new.parameters"></a><h4>Parameters</h4>
|
94
94
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
95
95
|
<colgroup>
|
96
96
|
<col width="150px" class="parameters_name">
|
@@ -99,13 +99,13 @@ either always or never allowed.</p>
|
|
99
99
|
</colgroup>
|
100
100
|
<tbody><tr>
|
101
101
|
<td class="parameter_name"><p>allowed</p></td>
|
102
|
-
<td class="parameter_description"><p><a href="../glib
|
102
|
+
<td class="parameter_description"><p><a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the action is allowed</p></td>
|
103
103
|
<td class="parameter_annotations"> </td>
|
104
104
|
</tr></tbody>
|
105
105
|
</table></div>
|
106
106
|
</div>
|
107
107
|
<div class="refsect3">
|
108
|
-
<a name="
|
108
|
+
<a name="g-simple-permission-new.returns"></a><h4>Returns</h4>
|
109
109
|
<p> the <a class="link" href="GSimplePermission.html" title="GSimplePermission"><span class="type">GSimplePermission</span></a>, as a <a class="link" href="GPermission.html" title="GPermission"><span class="type">GPermission</span></a></p>
|
110
110
|
</div>
|
111
111
|
<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
|
@@ -122,6 +122,6 @@ except for those defined by <a class="link" href="GPermission.html" title="GPerm
|
|
122
122
|
</div>
|
123
123
|
</div>
|
124
124
|
<div class="footer">
|
125
|
-
<hr>Generated by GTK-Doc V1.
|
125
|
+
<hr>Generated by GTK-Doc V1.25.1</div>
|
126
126
|
</body>
|
127
127
|
</html>
|
@@ -8,7 +8,7 @@
|
|
8
8
|
<link rel="up" href="resolver.html" title="DNS resolution">
|
9
9
|
<link rel="prev" href="GProxyResolver.html" title="GProxyResolver">
|
10
10
|
<link rel="next" href="GSocketConnectable.html" title="GSocketConnectable">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
@@ -88,12 +88,12 @@
|
|
88
88
|
<tbody>
|
89
89
|
<tr>
|
90
90
|
<td class="property_type">
|
91
|
-
<a href="../glib
|
91
|
+
<a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
|
92
92
|
<td class="property_name"><a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--default-proxy" title="The “default-proxy” property">default-proxy</a></td>
|
93
93
|
<td class="property_flags">Read / Write</td>
|
94
94
|
</tr>
|
95
95
|
<tr>
|
96
|
-
<td class="property_type"><a href="../glib
|
96
|
+
<td class="property_type"><a href="../glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td>
|
97
97
|
<td class="property_name"><a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--ignore-hosts" title="The “ignore-hosts” property">ignore-hosts</a></td>
|
98
98
|
<td class="property_flags">Read / Write</td>
|
99
99
|
</tr>
|
@@ -115,7 +115,7 @@
|
|
115
115
|
</div>
|
116
116
|
<div class="refsect1">
|
117
117
|
<a name="GSimpleProxyResolver.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
118
|
-
<pre class="screen"> <a href="../gobject
|
118
|
+
<pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
119
119
|
<span class="lineart">╰──</span> GSimpleProxyResolver
|
120
120
|
</pre>
|
121
121
|
</div>
|
@@ -145,14 +145,14 @@ with <a class="link" href="GSocketClient.html#g-socket-client-set-proxy-resolver
|
|
145
145
|
<div class="refsect2">
|
146
146
|
<a name="g-simple-proxy-resolver-new"></a><h3>g_simple_proxy_resolver_new ()</h3>
|
147
147
|
<pre class="programlisting"><a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="returnvalue">GProxyResolver</span></a> *
|
148
|
-
g_simple_proxy_resolver_new (<em class="parameter"><code>const <a href="../glib
|
149
|
-
<em class="parameter"><code><a href="../glib
|
148
|
+
g_simple_proxy_resolver_new (<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *default_proxy</code></em>,
|
149
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **ignore_hosts</code></em>);</pre>
|
150
150
|
<p>Creates a new <a class="link" href="GSimpleProxyResolver.html" title="GSimpleProxyResolver"><span class="type">GSimpleProxyResolver</span></a>. See
|
151
151
|
<a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--default-proxy" title="The “default-proxy” property"><span class="type">“default-proxy”</span></a> and
|
152
152
|
<a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--ignore-hosts" title="The “ignore-hosts” property"><span class="type">“ignore-hosts”</span></a> for more details on how the
|
153
153
|
arguments are interpreted.</p>
|
154
154
|
<div class="refsect3">
|
155
|
-
<a name="
|
155
|
+
<a name="g-simple-proxy-resolver-new.parameters"></a><h4>Parameters</h4>
|
156
156
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
157
157
|
<colgroup>
|
158
158
|
<col width="150px" class="parameters_name">
|
@@ -176,7 +176,7 @@ to not use a proxy for. </p></td>
|
|
176
176
|
</table></div>
|
177
177
|
</div>
|
178
178
|
<div class="refsect3">
|
179
|
-
<a name="
|
179
|
+
<a name="g-simple-proxy-resolver-new.returns"></a><h4>Returns</h4>
|
180
180
|
<p> (transfer full) a new <a class="link" href="GSimpleProxyResolver.html" title="GSimpleProxyResolver"><span class="type">GSimpleProxyResolver</span></a></p>
|
181
181
|
</div>
|
182
182
|
<p class="since">Since: <a class="link" href="api-index-2-36.html#api-index-2.36">2.36</a></p>
|
@@ -187,7 +187,7 @@ to not use a proxy for. </p></td>
|
|
187
187
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
188
188
|
g_simple_proxy_resolver_set_default_proxy
|
189
189
|
(<em class="parameter"><code><a class="link" href="GSimpleProxyResolver.html" title="GSimpleProxyResolver"><span class="type">GSimpleProxyResolver</span></a> *resolver</code></em>,
|
190
|
-
<em class="parameter"><code>const <a href="../glib
|
190
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *default_proxy</code></em>);</pre>
|
191
191
|
<p>Sets the default proxy on <em class="parameter"><code>resolver</code></em>
|
192
192
|
, to be used for any URIs that
|
193
193
|
don't match <a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--ignore-hosts" title="The “ignore-hosts” property"><span class="type">“ignore-hosts”</span></a> or a proxy set
|
@@ -197,7 +197,7 @@ via <a class="link" href="GSimpleProxyResolver.html#g-simple-proxy-resolver-set-
|
|
197
197
|
<a class="link" href="GSimpleProxyResolver.html" title="GSimpleProxyResolver"><span class="type">GSimpleProxyResolver</span></a> will treat it as referring to all three of
|
198
198
|
the socks5, socks4a, and socks4 proxy types.</p>
|
199
199
|
<div class="refsect3">
|
200
|
-
<a name="
|
200
|
+
<a name="g-simple-proxy-resolver-set-default-proxy.parameters"></a><h4>Parameters</h4>
|
201
201
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
202
202
|
<colgroup>
|
203
203
|
<col width="150px" class="parameters_name">
|
@@ -226,13 +226,13 @@ the socks5, socks4a, and socks4 proxy types.</p>
|
|
226
226
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
227
227
|
g_simple_proxy_resolver_set_ignore_hosts
|
228
228
|
(<em class="parameter"><code><a class="link" href="GSimpleProxyResolver.html" title="GSimpleProxyResolver"><span class="type">GSimpleProxyResolver</span></a> *resolver</code></em>,
|
229
|
-
<em class="parameter"><code><a href="../glib
|
229
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **ignore_hosts</code></em>);</pre>
|
230
230
|
<p>Sets the list of ignored hosts.</p>
|
231
231
|
<p>See <a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--ignore-hosts" title="The “ignore-hosts” property"><span class="type">“ignore-hosts”</span></a> for more details on how the
|
232
232
|
<em class="parameter"><code>ignore_hosts</code></em>
|
233
233
|
argument is interpreted.</p>
|
234
234
|
<div class="refsect3">
|
235
|
-
<a name="
|
235
|
+
<a name="g-simple-proxy-resolver-set-ignore-hosts.parameters"></a><h4>Parameters</h4>
|
236
236
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
237
237
|
<colgroup>
|
238
238
|
<col width="150px" class="parameters_name">
|
@@ -247,7 +247,7 @@ g_simple_proxy_resolver_set_ignore_hosts
|
|
247
247
|
</tr>
|
248
248
|
<tr>
|
249
249
|
<td class="parameter_name"><p>ignore_hosts</p></td>
|
250
|
-
<td class="parameter_description"><p><a href="../glib
|
250
|
+
<td class="parameter_description"><p><a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of hosts/IP addresses
|
251
251
|
to not use a proxy for</p></td>
|
252
252
|
<td class="parameter_annotations"> </td>
|
253
253
|
</tr>
|
@@ -261,8 +261,8 @@ to not use a proxy for</p></td>
|
|
261
261
|
<a name="g-simple-proxy-resolver-set-uri-proxy"></a><h3>g_simple_proxy_resolver_set_uri_proxy ()</h3>
|
262
262
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
263
263
|
g_simple_proxy_resolver_set_uri_proxy (<em class="parameter"><code><a class="link" href="GSimpleProxyResolver.html" title="GSimpleProxyResolver"><span class="type">GSimpleProxyResolver</span></a> *resolver</code></em>,
|
264
|
-
<em class="parameter"><code>const <a href="../glib
|
265
|
-
<em class="parameter"><code>const <a href="../glib
|
264
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri_scheme</code></em>,
|
265
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *proxy</code></em>);</pre>
|
266
266
|
<p>Adds a URI-scheme-specific proxy to <em class="parameter"><code>resolver</code></em>
|
267
267
|
; URIs whose scheme
|
268
268
|
matches <em class="parameter"><code>uri_scheme</code></em>
|
@@ -275,7 +275,7 @@ matches <em class="parameter"><code>uri_scheme</code></em>
|
|
275
275
|
as referring to all three of the socks5, socks4a, and socks4 proxy
|
276
276
|
types.</p>
|
277
277
|
<div class="refsect3">
|
278
|
-
<a name="
|
278
|
+
<a name="g-simple-proxy-resolver-set-uri-proxy.parameters"></a><h4>Parameters</h4>
|
279
279
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
280
280
|
<colgroup>
|
281
281
|
<col width="150px" class="parameters_name">
|
@@ -317,7 +317,7 @@ types.</p>
|
|
317
317
|
<a name="GSimpleProxyResolver.property-details"></a><h2>Property Details</h2>
|
318
318
|
<div class="refsect2">
|
319
319
|
<a name="GSimpleProxyResolver--default-proxy"></a><h3>The <code class="literal">“default-proxy”</code> property</h3>
|
320
|
-
<pre class="programlisting"> “default-proxy” <a href="../glib
|
320
|
+
<pre class="programlisting"> “default-proxy” <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
|
321
321
|
<p>The default proxy URI that will be used for any URI that doesn't
|
322
322
|
match <a class="link" href="GSimpleProxyResolver.html#GSimpleProxyResolver--ignore-hosts" title="The “ignore-hosts” property"><span class="type">“ignore-hosts”</span></a>, and doesn't match any
|
323
323
|
of the schemes set with <a class="link" href="GSimpleProxyResolver.html#g-simple-proxy-resolver-set-uri-proxy" title="g_simple_proxy_resolver_set_uri_proxy ()"><code class="function">g_simple_proxy_resolver_set_uri_proxy()</code></a>.</p>
|
@@ -330,7 +330,7 @@ to all three of the socks5, socks4a, and socks4 proxy types.</p>
|
|
330
330
|
<hr>
|
331
331
|
<div class="refsect2">
|
332
332
|
<a name="GSimpleProxyResolver--ignore-hosts"></a><h3>The <code class="literal">“ignore-hosts”</code> property</h3>
|
333
|
-
<pre class="programlisting"> “ignore-hosts” <a href="../glib
|
333
|
+
<pre class="programlisting"> “ignore-hosts” <a href="../glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre>
|
334
334
|
<p>A list of hostnames and IP addresses that the resolver should
|
335
335
|
allow direct connections to.</p>
|
336
336
|
<p>Entries can be in one of 4 formats:</p>
|
@@ -368,6 +368,6 @@ commonly used by other applications.</p>
|
|
368
368
|
</div>
|
369
369
|
</div>
|
370
370
|
<div class="footer">
|
371
|
-
<hr>Generated by GTK-Doc V1.
|
371
|
+
<hr>Generated by GTK-Doc V1.25.1</div>
|
372
372
|
</body>
|
373
373
|
</html>
|
@@ -8,7 +8,7 @@
|
|
8
8
|
<link rel="up" href="networking.html" title="Low-level network support">
|
9
9
|
<link rel="prev" href="networking.html" title="Low-level network support">
|
10
10
|
<link rel="next" href="GDatagramBased.html" title="GDatagramBased">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
@@ -44,7 +44,7 @@
|
|
44
44
|
<tbody>
|
45
45
|
<tr>
|
46
46
|
<td class="function_type">
|
47
|
-
<a href="../glib
|
47
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
48
48
|
</td>
|
49
49
|
<td class="function_name">
|
50
50
|
<span class="c_punctuation">(</span><a class="link" href="GSocket.html#GSocketSourceFunc" title="GSocketSourceFunc ()">*GSocketSourceFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
@@ -68,7 +68,7 @@
|
|
68
68
|
</tr>
|
69
69
|
<tr>
|
70
70
|
<td class="function_type">
|
71
|
-
<a href="../glib
|
71
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
72
72
|
</td>
|
73
73
|
<td class="function_name">
|
74
74
|
<a class="link" href="GSocket.html#g-socket-bind" title="g_socket_bind ()">g_socket_bind</a> <span class="c_punctuation">()</span>
|
@@ -76,7 +76,7 @@
|
|
76
76
|
</tr>
|
77
77
|
<tr>
|
78
78
|
<td class="function_type">
|
79
|
-
<a href="../glib
|
79
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
80
80
|
</td>
|
81
81
|
<td class="function_name">
|
82
82
|
<a class="link" href="GSocket.html#g-socket-listen" title="g_socket_listen ()">g_socket_listen</a> <span class="c_punctuation">()</span>
|
@@ -92,7 +92,7 @@
|
|
92
92
|
</tr>
|
93
93
|
<tr>
|
94
94
|
<td class="function_type">
|
95
|
-
<a href="../glib
|
95
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
96
96
|
</td>
|
97
97
|
<td class="function_name">
|
98
98
|
<a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()">g_socket_connect</a> <span class="c_punctuation">()</span>
|
@@ -100,7 +100,7 @@
|
|
100
100
|
</tr>
|
101
101
|
<tr>
|
102
102
|
<td class="function_type">
|
103
|
-
<a href="../glib
|
103
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
104
104
|
</td>
|
105
105
|
<td class="function_name">
|
106
106
|
<a class="link" href="GSocket.html#g-socket-check-connect-result" title="g_socket_check_connect_result ()">g_socket_check_connect_result</a> <span class="c_punctuation">()</span>
|
@@ -108,7 +108,7 @@
|
|
108
108
|
</tr>
|
109
109
|
<tr>
|
110
110
|
<td class="function_type">
|
111
|
-
<a href="../glib
|
111
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
112
112
|
</td>
|
113
113
|
<td class="function_name">
|
114
114
|
<a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()">g_socket_receive</a> <span class="c_punctuation">()</span>
|
@@ -116,7 +116,7 @@
|
|
116
116
|
</tr>
|
117
117
|
<tr>
|
118
118
|
<td class="function_type">
|
119
|
-
<a href="../glib
|
119
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
120
120
|
</td>
|
121
121
|
<td class="function_name">
|
122
122
|
<a class="link" href="GSocket.html#g-socket-receive-from" title="g_socket_receive_from ()">g_socket_receive_from</a> <span class="c_punctuation">()</span>
|
@@ -124,7 +124,7 @@
|
|
124
124
|
</tr>
|
125
125
|
<tr>
|
126
126
|
<td class="function_type">
|
127
|
-
<a href="../glib
|
127
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
128
128
|
</td>
|
129
129
|
<td class="function_name">
|
130
130
|
<a class="link" href="GSocket.html#g-socket-receive-message" title="g_socket_receive_message ()">g_socket_receive_message</a> <span class="c_punctuation">()</span>
|
@@ -132,7 +132,7 @@
|
|
132
132
|
</tr>
|
133
133
|
<tr>
|
134
134
|
<td class="function_type">
|
135
|
-
<a href="../glib
|
135
|
+
<a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
136
136
|
</td>
|
137
137
|
<td class="function_name">
|
138
138
|
<a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()">g_socket_receive_messages</a> <span class="c_punctuation">()</span>
|
@@ -140,7 +140,7 @@
|
|
140
140
|
</tr>
|
141
141
|
<tr>
|
142
142
|
<td class="function_type">
|
143
|
-
<a href="../glib
|
143
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
144
144
|
</td>
|
145
145
|
<td class="function_name">
|
146
146
|
<a class="link" href="GSocket.html#g-socket-receive-with-blocking" title="g_socket_receive_with_blocking ()">g_socket_receive_with_blocking</a> <span class="c_punctuation">()</span>
|
@@ -148,7 +148,7 @@
|
|
148
148
|
</tr>
|
149
149
|
<tr>
|
150
150
|
<td class="function_type">
|
151
|
-
<a href="../glib
|
151
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
152
152
|
</td>
|
153
153
|
<td class="function_name">
|
154
154
|
<a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()">g_socket_send</a> <span class="c_punctuation">()</span>
|
@@ -156,7 +156,7 @@
|
|
156
156
|
</tr>
|
157
157
|
<tr>
|
158
158
|
<td class="function_type">
|
159
|
-
<a href="../glib
|
159
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
160
160
|
</td>
|
161
161
|
<td class="function_name">
|
162
162
|
<a class="link" href="GSocket.html#g-socket-send-to" title="g_socket_send_to ()">g_socket_send_to</a> <span class="c_punctuation">()</span>
|
@@ -164,7 +164,7 @@
|
|
164
164
|
</tr>
|
165
165
|
<tr>
|
166
166
|
<td class="function_type">
|
167
|
-
<a href="../glib
|
167
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
168
168
|
</td>
|
169
169
|
<td class="function_name">
|
170
170
|
<a class="link" href="GSocket.html#g-socket-send-message" title="g_socket_send_message ()">g_socket_send_message</a> <span class="c_punctuation">()</span>
|
@@ -172,7 +172,7 @@
|
|
172
172
|
</tr>
|
173
173
|
<tr>
|
174
174
|
<td class="function_type">
|
175
|
-
<a href="../glib
|
175
|
+
<a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
176
176
|
</td>
|
177
177
|
<td class="function_name">
|
178
178
|
<a class="link" href="GSocket.html#g-socket-send-messages" title="g_socket_send_messages ()">g_socket_send_messages</a> <span class="c_punctuation">()</span>
|
@@ -180,7 +180,7 @@
|
|
180
180
|
</tr>
|
181
181
|
<tr>
|
182
182
|
<td class="function_type">
|
183
|
-
<a href="../glib
|
183
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
184
184
|
</td>
|
185
185
|
<td class="function_name">
|
186
186
|
<a class="link" href="GSocket.html#g-socket-send-with-blocking" title="g_socket_send_with_blocking ()">g_socket_send_with_blocking</a> <span class="c_punctuation">()</span>
|
@@ -188,7 +188,7 @@
|
|
188
188
|
</tr>
|
189
189
|
<tr>
|
190
190
|
<td class="function_type">
|
191
|
-
<a href="../glib
|
191
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
192
192
|
</td>
|
193
193
|
<td class="function_name">
|
194
194
|
<a class="link" href="GSocket.html#g-socket-close" title="g_socket_close ()">g_socket_close</a> <span class="c_punctuation">()</span>
|
@@ -196,7 +196,7 @@
|
|
196
196
|
</tr>
|
197
197
|
<tr>
|
198
198
|
<td class="function_type">
|
199
|
-
<a href="../glib
|
199
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
200
200
|
</td>
|
201
201
|
<td class="function_name">
|
202
202
|
<a class="link" href="GSocket.html#g-socket-is-closed" title="g_socket_is_closed ()">g_socket_is_closed</a> <span class="c_punctuation">()</span>
|
@@ -204,7 +204,7 @@
|
|
204
204
|
</tr>
|
205
205
|
<tr>
|
206
206
|
<td class="function_type">
|
207
|
-
<a href="../glib
|
207
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
208
208
|
</td>
|
209
209
|
<td class="function_name">
|
210
210
|
<a class="link" href="GSocket.html#g-socket-shutdown" title="g_socket_shutdown ()">g_socket_shutdown</a> <span class="c_punctuation">()</span>
|
@@ -212,7 +212,7 @@
|
|
212
212
|
</tr>
|
213
213
|
<tr>
|
214
214
|
<td class="function_type">
|
215
|
-
<a href="../glib
|
215
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
216
216
|
</td>
|
217
217
|
<td class="function_name">
|
218
218
|
<a class="link" href="GSocket.html#g-socket-is-connected" title="g_socket_is_connected ()">g_socket_is_connected</a> <span class="c_punctuation">()</span>
|
@@ -220,7 +220,7 @@
|
|
220
220
|
</tr>
|
221
221
|
<tr>
|
222
222
|
<td class="function_type">
|
223
|
-
<a href="../glib
|
223
|
+
<a href="../glib-The-Main-Event-Loop.html#GSource"><span class="returnvalue">GSource</span></a> *
|
224
224
|
</td>
|
225
225
|
<td class="function_name">
|
226
226
|
<a class="link" href="GSocket.html#g-socket-create-source" title="g_socket_create_source ()">g_socket_create_source</a> <span class="c_punctuation">()</span>
|
@@ -228,7 +228,7 @@
|
|
228
228
|
</tr>
|
229
229
|
<tr>
|
230
230
|
<td class="function_type">
|
231
|
-
<a href="../glib
|
231
|
+
<a href="../glib-IO-Channels.html#GIOCondition"><span class="returnvalue">GIOCondition</span></a>
|
232
232
|
</td>
|
233
233
|
<td class="function_name">
|
234
234
|
<a class="link" href="GSocket.html#g-socket-condition-check" title="g_socket_condition_check ()">g_socket_condition_check</a> <span class="c_punctuation">()</span>
|
@@ -236,7 +236,7 @@
|
|
236
236
|
</tr>
|
237
237
|
<tr>
|
238
238
|
<td class="function_type">
|
239
|
-
<a href="../glib
|
239
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
240
240
|
</td>
|
241
241
|
<td class="function_name">
|
242
242
|
<a class="link" href="GSocket.html#g-socket-condition-wait" title="g_socket_condition_wait ()">g_socket_condition_wait</a> <span class="c_punctuation">()</span>
|
@@ -244,7 +244,7 @@
|
|
244
244
|
</tr>
|
245
245
|
<tr>
|
246
246
|
<td class="function_type">
|
247
|
-
<a href="../glib
|
247
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
248
248
|
</td>
|
249
249
|
<td class="function_name">
|
250
250
|
<a class="link" href="GSocket.html#g-socket-condition-timed-wait" title="g_socket_condition_timed_wait ()">g_socket_condition_timed_wait</a> <span class="c_punctuation">()</span>
|
@@ -252,7 +252,7 @@
|
|
252
252
|
</tr>
|
253
253
|
<tr>
|
254
254
|
<td class="function_type">
|
255
|
-
<a href="../glib
|
255
|
+
<a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
256
256
|
</td>
|
257
257
|
<td class="function_name">
|
258
258
|
<a class="link" href="GSocket.html#g-socket-get-available-bytes" title="g_socket_get_available_bytes ()">g_socket_get_available_bytes</a> <span class="c_punctuation">()</span>
|
@@ -268,7 +268,7 @@
|
|
268
268
|
</tr>
|
269
269
|
<tr>
|
270
270
|
<td class="function_type">
|
271
|
-
<a href="../glib
|
271
|
+
<a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
272
272
|
</td>
|
273
273
|
<td class="function_name">
|
274
274
|
<a class="link" href="GSocket.html#g-socket-get-listen-backlog" title="g_socket_get_listen_backlog ()">g_socket_get_listen_backlog</a> <span class="c_punctuation">()</span>
|
@@ -276,7 +276,7 @@
|
|
276
276
|
</tr>
|
277
277
|
<tr>
|
278
278
|
<td class="function_type">
|
279
|
-
<a href="../glib
|
279
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
280
280
|
</td>
|
281
281
|
<td class="function_name">
|
282
282
|
<a class="link" href="GSocket.html#g-socket-get-blocking" title="g_socket_get_blocking ()">g_socket_get_blocking</a> <span class="c_punctuation">()</span>
|
@@ -292,7 +292,7 @@
|
|
292
292
|
</tr>
|
293
293
|
<tr>
|
294
294
|
<td class="function_type">
|
295
|
-
<a href="../glib
|
295
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
296
296
|
</td>
|
297
297
|
<td class="function_name">
|
298
298
|
<a class="link" href="GSocket.html#g-socket-get-keepalive" title="g_socket_get_keepalive ()">g_socket_get_keepalive</a> <span class="c_punctuation">()</span>
|
@@ -308,7 +308,7 @@
|
|
308
308
|
</tr>
|
309
309
|
<tr>
|
310
310
|
<td class="function_type">
|
311
|
-
<a href="../glib
|
311
|
+
<a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
312
312
|
</td>
|
313
313
|
<td class="function_name">
|
314
314
|
<a class="link" href="GSocket.html#g-socket-get-timeout" title="g_socket_get_timeout ()">g_socket_get_timeout</a> <span class="c_punctuation">()</span>
|
@@ -332,7 +332,7 @@
|
|
332
332
|
</tr>
|
333
333
|
<tr>
|
334
334
|
<td class="function_type">
|
335
|
-
<a href="../glib
|
335
|
+
<a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
336
336
|
</td>
|
337
337
|
<td class="function_name">
|
338
338
|
<a class="link" href="GSocket.html#g-socket-get-ttl" title="g_socket_get_ttl ()">g_socket_get_ttl</a> <span class="c_punctuation">()</span>
|
@@ -340,7 +340,7 @@
|
|
340
340
|
</tr>
|
341
341
|
<tr>
|
342
342
|
<td class="function_type">
|
343
|
-
<a href="../glib
|
343
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
344
344
|
</td>
|
345
345
|
<td class="function_name">
|
346
346
|
<a class="link" href="GSocket.html#g-socket-get-broadcast" title="g_socket_get_broadcast ()">g_socket_get_broadcast</a> <span class="c_punctuation">()</span>
|
@@ -356,7 +356,7 @@
|
|
356
356
|
</tr>
|
357
357
|
<tr>
|
358
358
|
<td class="function_type">
|
359
|
-
<a href="../glib
|
359
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
360
360
|
</td>
|
361
361
|
<td class="function_name">
|
362
362
|
<a class="link" href="GSocket.html#g-socket-get-option" title="g_socket_get_option ()">g_socket_get_option</a> <span class="c_punctuation">()</span>
|
@@ -364,7 +364,7 @@
|
|
364
364
|
</tr>
|
365
365
|
<tr>
|
366
366
|
<td class="function_type">
|
367
|
-
<a href="../glib
|
367
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
368
368
|
</td>
|
369
369
|
<td class="function_name">
|
370
370
|
<a class="link" href="GSocket.html#g-socket-set-option" title="g_socket_set_option ()">g_socket_set_option</a> <span class="c_punctuation">()</span>
|
@@ -420,7 +420,7 @@
|
|
420
420
|
</tr>
|
421
421
|
<tr>
|
422
422
|
<td class="function_type">
|
423
|
-
<a href="../glib
|
423
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
424
424
|
</td>
|
425
425
|
<td class="function_name">
|
426
426
|
<a class="link" href="GSocket.html#g-socket-speaks-ipv4" title="g_socket_speaks_ipv4 ()">g_socket_speaks_ipv4</a> <span class="c_punctuation">()</span>
|
@@ -436,7 +436,7 @@
|
|
436
436
|
</tr>
|
437
437
|
<tr>
|
438
438
|
<td class="function_type">
|
439
|
-
<a href="../glib
|
439
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
440
440
|
</td>
|
441
441
|
<td class="function_name">
|
442
442
|
<a class="link" href="GSocket.html#g-socket-join-multicast-group" title="g_socket_join_multicast_group ()">g_socket_join_multicast_group</a> <span class="c_punctuation">()</span>
|
@@ -444,7 +444,7 @@
|
|
444
444
|
</tr>
|
445
445
|
<tr>
|
446
446
|
<td class="function_type">
|
447
|
-
<a href="../glib
|
447
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
448
448
|
</td>
|
449
449
|
<td class="function_name">
|
450
450
|
<a class="link" href="GSocket.html#g-socket-leave-multicast-group" title="g_socket_leave_multicast_group ()">g_socket_leave_multicast_group</a> <span class="c_punctuation">()</span>
|
@@ -452,7 +452,7 @@
|
|
452
452
|
</tr>
|
453
453
|
<tr>
|
454
454
|
<td class="function_type">
|
455
|
-
<a href="../glib
|
455
|
+
<a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
456
456
|
</td>
|
457
457
|
<td class="function_name">
|
458
458
|
<a class="link" href="GSocket.html#g-socket-get-multicast-loopback" title="g_socket_get_multicast_loopback ()">g_socket_get_multicast_loopback</a> <span class="c_punctuation">()</span>
|
@@ -468,7 +468,7 @@
|
|
468
468
|
</tr>
|
469
469
|
<tr>
|
470
470
|
<td class="function_type">
|
471
|
-
<a href="../glib
|
471
|
+
<a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
472
472
|
</td>
|
473
473
|
<td class="function_name">
|
474
474
|
<a class="link" href="GSocket.html#g-socket-get-multicast-ttl" title="g_socket_get_multicast_ttl ()">g_socket_get_multicast_ttl</a> <span class="c_punctuation">()</span>
|
@@ -495,12 +495,12 @@
|
|
495
495
|
</colgroup>
|
496
496
|
<tbody>
|
497
497
|
<tr>
|
498
|
-
<td class="property_type"><a href="../glib
|
498
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
|
499
499
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property">blocking</a></td>
|
500
500
|
<td class="property_flags">Read / Write</td>
|
501
501
|
</tr>
|
502
502
|
<tr>
|
503
|
-
<td class="property_type"><a href="../glib
|
503
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
|
504
504
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--broadcast" title="The “broadcast” property">broadcast</a></td>
|
505
505
|
<td class="property_flags">Read / Write</td>
|
506
506
|
</tr>
|
@@ -510,17 +510,17 @@
|
|
510
510
|
<td class="property_flags">Read / Write / Construct Only</td>
|
511
511
|
</tr>
|
512
512
|
<tr>
|
513
|
-
<td class="property_type"><a href="../glib
|
513
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
|
514
514
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--fd" title="The “fd” property">fd</a></td>
|
515
515
|
<td class="property_flags">Read / Write / Construct Only</td>
|
516
516
|
</tr>
|
517
517
|
<tr>
|
518
|
-
<td class="property_type"><a href="../glib
|
518
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
|
519
519
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--keepalive" title="The “keepalive” property">keepalive</a></td>
|
520
520
|
<td class="property_flags">Read / Write</td>
|
521
521
|
</tr>
|
522
522
|
<tr>
|
523
|
-
<td class="property_type"><a href="../glib
|
523
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
|
524
524
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--listen-backlog" title="The “listen-backlog” property">listen-backlog</a></td>
|
525
525
|
<td class="property_flags">Read / Write</td>
|
526
526
|
</tr>
|
@@ -531,12 +531,12 @@
|
|
531
531
|
<td class="property_flags">Read</td>
|
532
532
|
</tr>
|
533
533
|
<tr>
|
534
|
-
<td class="property_type"><a href="../glib
|
534
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
|
535
535
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--multicast-loopback" title="The “multicast-loopback” property">multicast-loopback</a></td>
|
536
536
|
<td class="property_flags">Read / Write</td>
|
537
537
|
</tr>
|
538
538
|
<tr>
|
539
|
-
<td class="property_type"><a href="../glib
|
539
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
|
540
540
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--multicast-ttl" title="The “multicast-ttl” property">multicast-ttl</a></td>
|
541
541
|
<td class="property_flags">Read / Write</td>
|
542
542
|
</tr>
|
@@ -552,12 +552,12 @@
|
|
552
552
|
<td class="property_flags">Read</td>
|
553
553
|
</tr>
|
554
554
|
<tr>
|
555
|
-
<td class="property_type"><a href="../glib
|
555
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
|
556
556
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--timeout" title="The “timeout” property">timeout</a></td>
|
557
557
|
<td class="property_flags">Read / Write</td>
|
558
558
|
</tr>
|
559
559
|
<tr>
|
560
|
-
<td class="property_type"><a href="../glib
|
560
|
+
<td class="property_type"><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
|
561
561
|
<td class="property_name"><a class="link" href="GSocket.html#GSocket--ttl" title="The “ttl” property">ttl</a></td>
|
562
562
|
<td class="property_flags">Read / Write</td>
|
563
563
|
</tr>
|
@@ -614,7 +614,7 @@
|
|
614
614
|
</div>
|
615
615
|
<div class="refsect1">
|
616
616
|
<a name="GSocket.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
617
|
-
<pre class="screen"> <a href="../gobject
|
617
|
+
<pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
618
618
|
<span class="lineart">╰──</span> GSocket
|
619
619
|
</pre>
|
620
620
|
</div>
|
@@ -640,10 +640,10 @@ use it directly, but rather through classes like <a class="link" href="GSocketCl
|
|
640
640
|
<a class="link" href="GSocketService.html" title="GSocketService"><span class="type">GSocketService</span></a> and <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>. However there may be cases where
|
641
641
|
direct use of <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> is useful.</p>
|
642
642
|
<p><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> implements the <a class="link" href="GInitable.html" title="GInitable"><span class="type">GInitable</span></a> interface, so if it is manually constructed
|
643
|
-
by e.g. <a href="../gobject
|
643
|
+
by e.g. <a href="../gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a> you must call <a class="link" href="GInitable.html#g-initable-init" title="g_initable_init ()"><code class="function">g_initable_init()</code></a> and check the
|
644
644
|
results before using the object. This is done automatically in
|
645
645
|
<a class="link" href="GSocket.html#g-socket-new" title="g_socket_new ()"><code class="function">g_socket_new()</code></a> and <a class="link" href="GSocket.html#g-socket-new-from-fd" title="g_socket_new_from_fd ()"><code class="function">g_socket_new_from_fd()</code></a>, so these functions can return
|
646
|
-
<a href="../glib
|
646
|
+
<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
|
647
647
|
<p>Sockets operate in two general modes, blocking or non-blocking. When
|
648
648
|
in blocking mode all operations (which don’t take an explicit blocking
|
649
649
|
parameter) block until the requested operation
|
@@ -651,7 +651,7 @@ is finished or there is an error. In non-blocking mode all calls that
|
|
651
651
|
would block return immediately with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error.
|
652
652
|
To know when a call would successfully run you can call <a class="link" href="GSocket.html#g-socket-condition-check" title="g_socket_condition_check ()"><code class="function">g_socket_condition_check()</code></a>,
|
653
653
|
or <a class="link" href="GSocket.html#g-socket-condition-wait" title="g_socket_condition_wait ()"><code class="function">g_socket_condition_wait()</code></a>. You can also use <a class="link" href="GSocket.html#g-socket-create-source" title="g_socket_create_source ()"><code class="function">g_socket_create_source()</code></a> and
|
654
|
-
attach it to a <a href="../glib
|
654
|
+
attach it to a <a href="../glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> to get callbacks when I/O is possible.
|
655
655
|
Note that all sockets are always set to non blocking mode in the system, and
|
656
656
|
blocking mode is emulated in GSocket.</p>
|
657
657
|
<p>When working in non-blocking mode applications should always be able to
|
@@ -660,7 +660,7 @@ function said that I/O was possible. This can easily happen in case
|
|
660
660
|
of a race condition in the application, but it can also happen for other
|
661
661
|
reasons. For instance, on Windows a socket is always seen as writable
|
662
662
|
until a write returns <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a>.</p>
|
663
|
-
<p><a href="GSocket.html"><span class="type">GSockets</span></a> can be either connection oriented or datagram based.
|
663
|
+
<p><a href="GSocket.html#GSocket-struct"><span class="type">GSockets</span></a> can be either connection oriented or datagram based.
|
664
664
|
For connection oriented types you must first establish a connection by
|
665
665
|
either connecting to an address or accepting a connection from another
|
666
666
|
address. For connectionless socket types the target/source address is
|
@@ -679,14 +679,14 @@ locking.</p>
|
|
679
679
|
<a name="GSocket.functions_details"></a><h2>Functions</h2>
|
680
680
|
<div class="refsect2">
|
681
681
|
<a name="GSocketSourceFunc"></a><h3>GSocketSourceFunc ()</h3>
|
682
|
-
<pre class="programlisting"><a href="../glib
|
682
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
683
683
|
<span class="c_punctuation">(</span>*GSocketSourceFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
684
|
-
<em class="parameter"><code><a href="../glib
|
685
|
-
<em class="parameter"><code><a href="../glib
|
686
|
-
<p>This is the function type of the callback used for the <a href="../glib
|
684
|
+
<em class="parameter"><code><a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> condition</code></em>,
|
685
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
686
|
+
<p>This is the function type of the callback used for the <a href="../glib-The-Main-Event-Loop.html#GSource"><span class="type">GSource</span></a>
|
687
687
|
returned by <a class="link" href="GSocket.html#g-socket-create-source" title="g_socket_create_source ()"><code class="function">g_socket_create_source()</code></a>.</p>
|
688
688
|
<div class="refsect3">
|
689
|
-
<a name="
|
689
|
+
<a name="GSocketSourceFunc.parameters"></a><h4>Parameters</h4>
|
690
690
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
691
691
|
<colgroup>
|
692
692
|
<col width="150px" class="parameters_name">
|
@@ -713,8 +713,8 @@ returned by <a class="link" href="GSocket.html#g-socket-create-source" title="g_
|
|
713
713
|
</table></div>
|
714
714
|
</div>
|
715
715
|
<div class="refsect3">
|
716
|
-
<a name="
|
717
|
-
<p> it should return <a href="../glib
|
716
|
+
<a name="GSocketSourceFunc.returns"></a><h4>Returns</h4>
|
717
|
+
<p> it should return <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the source should be removed.</p>
|
718
718
|
</div>
|
719
719
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
720
720
|
</div>
|
@@ -725,7 +725,7 @@ returned by <a class="link" href="GSocket.html#g-socket-create-source" title="g_
|
|
725
725
|
g_socket_new (<em class="parameter"><code><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a> family</code></em>,
|
726
726
|
<em class="parameter"><code><a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a> type</code></em>,
|
727
727
|
<em class="parameter"><code><a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a> protocol</code></em>,
|
728
|
-
<em class="parameter"><code><a href="../glib
|
728
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
729
729
|
<p>Creates a new <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> with the defined family, type and protocol.
|
730
730
|
If <em class="parameter"><code>protocol</code></em>
|
731
731
|
is 0 (<a class="link" href="GSocket.html#G-SOCKET-PROTOCOL-DEFAULT:CAPS"><code class="literal">G_SOCKET_PROTOCOL_DEFAULT</code></a>) the default protocol type
|
@@ -740,7 +740,7 @@ the family and type.</p>
|
|
740
740
|
system, so you can use protocols not listed in <a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a> if you
|
741
741
|
know the protocol number used for it.</p>
|
742
742
|
<div class="refsect3">
|
743
|
-
<a name="
|
743
|
+
<a name="g-socket-new.parameters"></a><h4>Parameters</h4>
|
744
744
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
745
745
|
<colgroup>
|
746
746
|
<col width="150px" class="parameters_name">
|
@@ -765,16 +765,16 @@ know the protocol number used for it.</p>
|
|
765
765
|
</tr>
|
766
766
|
<tr>
|
767
767
|
<td class="parameter_name"><p>error</p></td>
|
768
|
-
<td class="parameter_description"><p><a href="../glib
|
768
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
769
769
|
<td class="parameter_annotations"> </td>
|
770
770
|
</tr>
|
771
771
|
</tbody>
|
772
772
|
</table></div>
|
773
773
|
</div>
|
774
774
|
<div class="refsect3">
|
775
|
-
<a name="
|
776
|
-
<p> a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> or <a href="../glib
|
777
|
-
Free the returned object with <a href="../gobject
|
775
|
+
<a name="g-socket-new.returns"></a><h4>Returns</h4>
|
776
|
+
<p> a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
|
777
|
+
Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
|
778
778
|
</div>
|
779
779
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
780
780
|
</div>
|
@@ -782,8 +782,8 @@ Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.h
|
|
782
782
|
<div class="refsect2">
|
783
783
|
<a name="g-socket-new-from-fd"></a><h3>g_socket_new_from_fd ()</h3>
|
784
784
|
<pre class="programlisting"><a class="link" href="GSocket.html" title="GSocket"><span class="returnvalue">GSocket</span></a> *
|
785
|
-
g_socket_new_from_fd (<em class="parameter"><code><a href="../glib
|
786
|
-
<em class="parameter"><code><a href="../glib
|
785
|
+
g_socket_new_from_fd (<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> fd</code></em>,
|
786
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
787
787
|
<p>Creates a new <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> from a native file descriptor
|
788
788
|
or winsock SOCKET handle.</p>
|
789
789
|
<p>This reads all the settings from the file descriptor so that
|
@@ -797,7 +797,7 @@ caller must close <em class="parameter"><code>fd</code></em>
|
|
797
797
|
<p>Since GLib 2.46, it is no longer a fatal error to call this on a non-socket
|
798
798
|
descriptor. Instead, a GError will be set with code <a class="link" href="gio-GIOError.html#G-IO-ERROR-FAILED:CAPS"><code class="literal">G_IO_ERROR_FAILED</code></a></p>
|
799
799
|
<div class="refsect3">
|
800
|
-
<a name="
|
800
|
+
<a name="g-socket-new-from-fd.parameters"></a><h4>Parameters</h4>
|
801
801
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
802
802
|
<colgroup>
|
803
803
|
<col width="150px" class="parameters_name">
|
@@ -812,27 +812,27 @@ descriptor. Instead, a GError will be set with code <a class="link" href="gio-G
|
|
812
812
|
</tr>
|
813
813
|
<tr>
|
814
814
|
<td class="parameter_name"><p>error</p></td>
|
815
|
-
<td class="parameter_description"><p><a href="../glib
|
815
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
816
816
|
<td class="parameter_annotations"> </td>
|
817
817
|
</tr>
|
818
818
|
</tbody>
|
819
819
|
</table></div>
|
820
820
|
</div>
|
821
821
|
<div class="refsect3">
|
822
|
-
<a name="
|
823
|
-
<p> a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> or <a href="../glib
|
824
|
-
Free the returned object with <a href="../gobject
|
822
|
+
<a name="g-socket-new-from-fd.returns"></a><h4>Returns</h4>
|
823
|
+
<p> a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
|
824
|
+
Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
|
825
825
|
</div>
|
826
826
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
827
827
|
</div>
|
828
828
|
<hr>
|
829
829
|
<div class="refsect2">
|
830
830
|
<a name="g-socket-bind"></a><h3>g_socket_bind ()</h3>
|
831
|
-
<pre class="programlisting"><a href="../glib
|
831
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
832
832
|
g_socket_bind (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
833
833
|
<em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *address</code></em>,
|
834
|
-
<em class="parameter"><code><a href="../glib
|
835
|
-
<em class="parameter"><code><a href="../glib
|
834
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allow_reuse</code></em>,
|
835
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
836
836
|
<p>When a socket is created it is attached to an address family, but it
|
837
837
|
doesn't have an address in this family. <a class="link" href="GSocket.html#g-socket-bind" title="g_socket_bind ()"><code class="function">g_socket_bind()</code></a> assigns the
|
838
838
|
address (sometimes called name) of the socket.</p>
|
@@ -843,9 +843,9 @@ used to initiate connections, though this is not normally required.</p>
|
|
843
843
|
<p>If <em class="parameter"><code>socket</code></em>
|
844
844
|
is a TCP socket, then <em class="parameter"><code>allow_reuse</code></em>
|
845
845
|
controls the setting
|
846
|
-
of the <code class="literal">SO_REUSEADDR</code> socket option; normally it should be <a href="../glib
|
846
|
+
of the <code class="literal">SO_REUSEADDR</code> socket option; normally it should be <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for
|
847
847
|
server sockets (sockets that you will eventually call
|
848
|
-
<a class="link" href="GSocket.html#g-socket-accept" title="g_socket_accept ()"><code class="function">g_socket_accept()</code></a> on), and <a href="../glib
|
848
|
+
<a class="link" href="GSocket.html#g-socket-accept" title="g_socket_accept ()"><code class="function">g_socket_accept()</code></a> on), and <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for client sockets. (Failing to
|
849
849
|
set this flag on a server socket may cause <a class="link" href="GSocket.html#g-socket-bind" title="g_socket_bind ()"><code class="function">g_socket_bind()</code></a> to return
|
850
850
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-ADDRESS-IN-USE:CAPS"><code class="literal">G_IO_ERROR_ADDRESS_IN_USE</code></a> if the server program is stopped and then
|
851
851
|
immediately restarted.)</p>
|
@@ -858,7 +858,7 @@ same address, and they will all receive all of the multicast and
|
|
858
858
|
broadcast packets sent to that address. (The behavior of unicast
|
859
859
|
UDP packets to an address with multiple listeners is not defined.)</p>
|
860
860
|
<div class="refsect3">
|
861
|
-
<a name="
|
861
|
+
<a name="g-socket-bind.parameters"></a><h4>Parameters</h4>
|
862
862
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
863
863
|
<colgroup>
|
864
864
|
<col width="150px" class="parameters_name">
|
@@ -883,24 +883,24 @@ UDP packets to an address with multiple listeners is not defined.)</p>
|
|
883
883
|
</tr>
|
884
884
|
<tr>
|
885
885
|
<td class="parameter_name"><p>error</p></td>
|
886
|
-
<td class="parameter_description"><p><a href="../glib
|
886
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
887
887
|
<td class="parameter_annotations"> </td>
|
888
888
|
</tr>
|
889
889
|
</tbody>
|
890
890
|
</table></div>
|
891
891
|
</div>
|
892
892
|
<div class="refsect3">
|
893
|
-
<a name="
|
894
|
-
<p> <a href="../glib
|
893
|
+
<a name="g-socket-bind.returns"></a><h4>Returns</h4>
|
894
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
|
895
895
|
</div>
|
896
896
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
897
897
|
</div>
|
898
898
|
<hr>
|
899
899
|
<div class="refsect2">
|
900
900
|
<a name="g-socket-listen"></a><h3>g_socket_listen ()</h3>
|
901
|
-
<pre class="programlisting"><a href="../glib
|
901
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
902
902
|
g_socket_listen (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
903
|
-
<em class="parameter"><code><a href="../glib
|
903
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
904
904
|
<p>Marks the socket as a server socket, i.e. a socket that is used
|
905
905
|
to accept incoming requests using <a class="link" href="GSocket.html#g-socket-accept" title="g_socket_accept ()"><code class="function">g_socket_accept()</code></a>.</p>
|
906
906
|
<p>Before calling this the socket must be bound to a local address using
|
@@ -908,7 +908,7 @@ to accept incoming requests using <a class="link" href="GSocket.html#g-socket-ac
|
|
908
908
|
<p>To set the maximum amount of outstanding clients, use
|
909
909
|
<a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_socket_set_listen_backlog ()"><code class="function">g_socket_set_listen_backlog()</code></a>.</p>
|
910
910
|
<div class="refsect3">
|
911
|
-
<a name="
|
911
|
+
<a name="g-socket-listen.parameters"></a><h4>Parameters</h4>
|
912
912
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
913
913
|
<colgroup>
|
914
914
|
<col width="150px" class="parameters_name">
|
@@ -923,15 +923,15 @@ to accept incoming requests using <a class="link" href="GSocket.html#g-socket-ac
|
|
923
923
|
</tr>
|
924
924
|
<tr>
|
925
925
|
<td class="parameter_name"><p>error</p></td>
|
926
|
-
<td class="parameter_description"><p><a href="../glib
|
926
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
927
927
|
<td class="parameter_annotations"> </td>
|
928
928
|
</tr>
|
929
929
|
</tbody>
|
930
930
|
</table></div>
|
931
931
|
</div>
|
932
932
|
<div class="refsect3">
|
933
|
-
<a name="
|
934
|
-
<p> <a href="../glib
|
933
|
+
<a name="g-socket-listen.returns"></a><h4>Returns</h4>
|
934
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
|
935
935
|
</div>
|
936
936
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
937
937
|
</div>
|
@@ -941,7 +941,7 @@ to accept incoming requests using <a class="link" href="GSocket.html#g-socket-ac
|
|
941
941
|
<pre class="programlisting"><a class="link" href="GSocket.html" title="GSocket"><span class="returnvalue">GSocket</span></a> *
|
942
942
|
g_socket_accept (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
943
943
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
944
|
-
<em class="parameter"><code><a href="../glib
|
944
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
945
945
|
<p>Accept incoming connections on a connection-based socket. This removes
|
946
946
|
the first outstanding connection request from the listening socket and
|
947
947
|
creates a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> object for it.</p>
|
@@ -950,9 +950,9 @@ creates a <a class="link" href="GSocket.html" title="GSocket"><span class="type"
|
|
950
950
|
must be listening for incoming connections (<a class="link" href="GSocket.html#g-socket-listen" title="g_socket_listen ()"><code class="function">g_socket_listen()</code></a>).</p>
|
951
951
|
<p>If there are no outstanding connections then the operation will block
|
952
952
|
or return <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> if non-blocking I/O is enabled.
|
953
|
-
To be notified of an incoming connection, wait for the <a href="../glib
|
953
|
+
To be notified of an incoming connection, wait for the <a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition.</p>
|
954
954
|
<div class="refsect3">
|
955
|
-
<a name="
|
955
|
+
<a name="g-socket-accept.parameters"></a><h4>Parameters</h4>
|
956
956
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
957
957
|
<colgroup>
|
958
958
|
<col width="150px" class="parameters_name">
|
@@ -967,21 +967,21 @@ To be notified of an incoming connection, wait for the <a href="../glib/glib-IO-
|
|
967
967
|
</tr>
|
968
968
|
<tr>
|
969
969
|
<td class="parameter_name"><p>cancellable</p></td>
|
970
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
970
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
971
971
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
972
972
|
</tr>
|
973
973
|
<tr>
|
974
974
|
<td class="parameter_name"><p>error</p></td>
|
975
|
-
<td class="parameter_description"><p><a href="../glib
|
975
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
976
976
|
<td class="parameter_annotations"> </td>
|
977
977
|
</tr>
|
978
978
|
</tbody>
|
979
979
|
</table></div>
|
980
980
|
</div>
|
981
981
|
<div class="refsect3">
|
982
|
-
<a name="
|
983
|
-
<p> a new <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a>, or <a href="../glib
|
984
|
-
Free the returned object with <a href="../gobject
|
982
|
+
<a name="g-socket-accept.returns"></a><h4>Returns</h4>
|
983
|
+
<p> a new <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
|
984
|
+
Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
|
985
985
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
986
986
|
</div>
|
987
987
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -989,11 +989,11 @@ Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.h
|
|
989
989
|
<hr>
|
990
990
|
<div class="refsect2">
|
991
991
|
<a name="g-socket-connect"></a><h3>g_socket_connect ()</h3>
|
992
|
-
<pre class="programlisting"><a href="../glib
|
992
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
993
993
|
g_socket_connect (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
994
994
|
<em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *address</code></em>,
|
995
995
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
996
|
-
<em class="parameter"><code><a href="../glib
|
996
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
997
997
|
<p>Connect the socket to the specified remote address.</p>
|
998
998
|
<p>For connection oriented socket this generally means we attempt to make
|
999
999
|
a connection to the <em class="parameter"><code>address</code></em>
|
@@ -1009,7 +1009,7 @@ and the user can be notified of the connection finishing by waiting
|
|
1009
1009
|
for the G_IO_OUT condition. The result of the connection must then be
|
1010
1010
|
checked with <a class="link" href="GSocket.html#g-socket-check-connect-result" title="g_socket_check_connect_result ()"><code class="function">g_socket_check_connect_result()</code></a>.</p>
|
1011
1011
|
<div class="refsect3">
|
1012
|
-
<a name="
|
1012
|
+
<a name="g-socket-connect.parameters"></a><h4>Parameters</h4>
|
1013
1013
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1014
1014
|
<colgroup>
|
1015
1015
|
<col width="150px" class="parameters_name">
|
@@ -1029,34 +1029,34 @@ checked with <a class="link" href="GSocket.html#g-socket-check-connect-result" t
|
|
1029
1029
|
</tr>
|
1030
1030
|
<tr>
|
1031
1031
|
<td class="parameter_name"><p>cancellable</p></td>
|
1032
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1032
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1033
1033
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1034
1034
|
</tr>
|
1035
1035
|
<tr>
|
1036
1036
|
<td class="parameter_name"><p>error</p></td>
|
1037
|
-
<td class="parameter_description"><p><a href="../glib
|
1037
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1038
1038
|
<td class="parameter_annotations"> </td>
|
1039
1039
|
</tr>
|
1040
1040
|
</tbody>
|
1041
1041
|
</table></div>
|
1042
1042
|
</div>
|
1043
1043
|
<div class="refsect3">
|
1044
|
-
<a name="
|
1045
|
-
<p> <a href="../glib
|
1044
|
+
<a name="g-socket-connect.returns"></a><h4>Returns</h4>
|
1045
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if connected, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
|
1046
1046
|
</div>
|
1047
1047
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
1048
1048
|
</div>
|
1049
1049
|
<hr>
|
1050
1050
|
<div class="refsect2">
|
1051
1051
|
<a name="g-socket-check-connect-result"></a><h3>g_socket_check_connect_result ()</h3>
|
1052
|
-
<pre class="programlisting"><a href="../glib
|
1052
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1053
1053
|
g_socket_check_connect_result (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1054
|
-
<em class="parameter"><code><a href="../glib
|
1054
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1055
1055
|
<p>Checks and resets the pending connect error for the socket.
|
1056
1056
|
This is used to check for errors when <a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()"><code class="function">g_socket_connect()</code></a> is
|
1057
1057
|
used in non-blocking mode.</p>
|
1058
1058
|
<div class="refsect3">
|
1059
|
-
<a name="
|
1059
|
+
<a name="g-socket-check-connect-result.parameters"></a><h4>Parameters</h4>
|
1060
1060
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1061
1061
|
<colgroup>
|
1062
1062
|
<col width="150px" class="parameters_name">
|
@@ -1071,15 +1071,15 @@ used in non-blocking mode.</p>
|
|
1071
1071
|
</tr>
|
1072
1072
|
<tr>
|
1073
1073
|
<td class="parameter_name"><p>error</p></td>
|
1074
|
-
<td class="parameter_description"><p><a href="../glib
|
1074
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1075
1075
|
<td class="parameter_annotations"> </td>
|
1076
1076
|
</tr>
|
1077
1077
|
</tbody>
|
1078
1078
|
</table></div>
|
1079
1079
|
</div>
|
1080
1080
|
<div class="refsect3">
|
1081
|
-
<a name="
|
1082
|
-
<p> <a href="../glib
|
1081
|
+
<a name="g-socket-check-connect-result.returns"></a><h4>Returns</h4>
|
1082
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if no error, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise, setting <em class="parameter"><code>error</code></em>
|
1083
1083
|
to the error</p>
|
1084
1084
|
</div>
|
1085
1085
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -1087,17 +1087,17 @@ to the error</p>
|
|
1087
1087
|
<hr>
|
1088
1088
|
<div class="refsect2">
|
1089
1089
|
<a name="g-socket-receive"></a><h3>g_socket_receive ()</h3>
|
1090
|
-
<pre class="programlisting"><a href="../glib
|
1090
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1091
1091
|
g_socket_receive (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1092
|
-
<em class="parameter"><code><a href="../glib
|
1093
|
-
<em class="parameter"><code><a href="../glib
|
1092
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
1093
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> size</code></em>,
|
1094
1094
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1095
|
-
<em class="parameter"><code><a href="../glib
|
1095
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1096
1096
|
<p>Receive data (up to <em class="parameter"><code>size</code></em>
|
1097
1097
|
bytes) from a socket. This is mainly used by
|
1098
1098
|
connection-oriented sockets; it is identical to <a class="link" href="GSocket.html#g-socket-receive-from" title="g_socket_receive_from ()"><code class="function">g_socket_receive_from()</code></a>
|
1099
1099
|
with <em class="parameter"><code>address</code></em>
|
1100
|
-
set to <a href="../glib
|
1100
|
+
set to <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
|
1101
1101
|
<p>For <a class="link" href="GSocket.html#G-SOCKET-TYPE-DATAGRAM:CAPS"><code class="literal">G_SOCKET_TYPE_DATAGRAM</code></a> and <a class="link" href="GSocket.html#G-SOCKET-TYPE-SEQPACKET:CAPS"><code class="literal">G_SOCKET_TYPE_SEQPACKET</code></a> sockets,
|
1102
1102
|
<a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a> will always read either 0 or 1 complete messages from
|
1103
1103
|
the socket. If the received message is too large to fit in <em class="parameter"><code>buffer</code></em>
|
@@ -1116,11 +1116,11 @@ is some data to receive, the connection is closed, or there is an
|
|
1116
1116
|
error. If there is no data available and the socket is in
|
1117
1117
|
non-blocking mode, a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error will be
|
1118
1118
|
returned. To be notified when data is available, wait for the
|
1119
|
-
<a href="../glib
|
1119
|
+
<a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition.</p>
|
1120
1120
|
<p>On error -1 is returned and <em class="parameter"><code>error</code></em>
|
1121
1121
|
is set accordingly.</p>
|
1122
1122
|
<div class="refsect3">
|
1123
|
-
<a name="
|
1123
|
+
<a name="g-socket-receive.parameters"></a><h4>Parameters</h4>
|
1124
1124
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1125
1125
|
<colgroup>
|
1126
1126
|
<col width="150px" class="parameters_name">
|
@@ -1147,19 +1147,19 @@ bytes long). </p></td>
|
|
1147
1147
|
</tr>
|
1148
1148
|
<tr>
|
1149
1149
|
<td class="parameter_name"><p>cancellable</p></td>
|
1150
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1150
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1151
1151
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1152
1152
|
</tr>
|
1153
1153
|
<tr>
|
1154
1154
|
<td class="parameter_name"><p>error</p></td>
|
1155
|
-
<td class="parameter_description"><p><a href="../glib
|
1155
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1156
1156
|
<td class="parameter_annotations"> </td>
|
1157
1157
|
</tr>
|
1158
1158
|
</tbody>
|
1159
1159
|
</table></div>
|
1160
1160
|
</div>
|
1161
1161
|
<div class="refsect3">
|
1162
|
-
<a name="
|
1162
|
+
<a name="g-socket-receive.returns"></a><h4>Returns</h4>
|
1163
1163
|
<p> Number of bytes read, or 0 if the connection was closed by
|
1164
1164
|
the peer, or -1 on error</p>
|
1165
1165
|
</div>
|
@@ -1168,24 +1168,24 @@ the peer, or -1 on error</p>
|
|
1168
1168
|
<hr>
|
1169
1169
|
<div class="refsect2">
|
1170
1170
|
<a name="g-socket-receive-from"></a><h3>g_socket_receive_from ()</h3>
|
1171
|
-
<pre class="programlisting"><a href="../glib
|
1171
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1172
1172
|
g_socket_receive_from (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1173
1173
|
<em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> **address</code></em>,
|
1174
|
-
<em class="parameter"><code><a href="../glib
|
1175
|
-
<em class="parameter"><code><a href="../glib
|
1174
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
1175
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> size</code></em>,
|
1176
1176
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1177
|
-
<em class="parameter"><code><a href="../glib
|
1177
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1178
1178
|
<p>Receive data (up to <em class="parameter"><code>size</code></em>
|
1179
1179
|
bytes) from a socket.</p>
|
1180
1180
|
<p>If <em class="parameter"><code>address</code></em>
|
1181
|
-
is non-<a href="../glib
|
1181
|
+
is non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <em class="parameter"><code>address</code></em>
|
1182
1182
|
will be set equal to the
|
1183
1183
|
source address of the received packet.
|
1184
1184
|
<em class="parameter"><code>address</code></em>
|
1185
1185
|
is owned by the caller.</p>
|
1186
1186
|
<p>See <a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a> for additional information.</p>
|
1187
1187
|
<div class="refsect3">
|
1188
|
-
<a name="
|
1188
|
+
<a name="g-socket-receive-from.parameters"></a><h4>Parameters</h4>
|
1189
1189
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1190
1190
|
<colgroup>
|
1191
1191
|
<col width="150px" class="parameters_name">
|
@@ -1201,7 +1201,7 @@ source address of the received packet.
|
|
1201
1201
|
<tr>
|
1202
1202
|
<td class="parameter_name"><p>address</p></td>
|
1203
1203
|
<td class="parameter_description"><p> a pointer to a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>
|
1204
|
-
pointer, or <a href="../glib
|
1204
|
+
pointer, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1205
1205
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1206
1206
|
</tr>
|
1207
1207
|
<tr>
|
@@ -1218,19 +1218,19 @@ bytes long). </p></td>
|
|
1218
1218
|
</tr>
|
1219
1219
|
<tr>
|
1220
1220
|
<td class="parameter_name"><p>cancellable</p></td>
|
1221
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1221
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1222
1222
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1223
1223
|
</tr>
|
1224
1224
|
<tr>
|
1225
1225
|
<td class="parameter_name"><p>error</p></td>
|
1226
|
-
<td class="parameter_description"><p><a href="../glib
|
1226
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1227
1227
|
<td class="parameter_annotations"> </td>
|
1228
1228
|
</tr>
|
1229
1229
|
</tbody>
|
1230
1230
|
</table></div>
|
1231
1231
|
</div>
|
1232
1232
|
<div class="refsect3">
|
1233
|
-
<a name="
|
1233
|
+
<a name="g-socket-receive-from.returns"></a><h4>Returns</h4>
|
1234
1234
|
<p> Number of bytes read, or 0 if the connection was closed by
|
1235
1235
|
the peer, or -1 on error</p>
|
1236
1236
|
</div>
|
@@ -1239,21 +1239,21 @@ the peer, or -1 on error</p>
|
|
1239
1239
|
<hr>
|
1240
1240
|
<div class="refsect2">
|
1241
1241
|
<a name="g-socket-receive-message"></a><h3>g_socket_receive_message ()</h3>
|
1242
|
-
<pre class="programlisting"><a href="../glib
|
1242
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1243
1243
|
g_socket_receive_message (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1244
1244
|
<em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> **address</code></em>,
|
1245
1245
|
<em class="parameter"><code><a class="link" href="GSocket.html#GInputVector" title="struct GInputVector"><span class="type">GInputVector</span></a> *vectors</code></em>,
|
1246
|
-
<em class="parameter"><code><a href="../glib
|
1246
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> num_vectors</code></em>,
|
1247
1247
|
<em class="parameter"><code><a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> ***messages</code></em>,
|
1248
|
-
<em class="parameter"><code><a href="../glib
|
1249
|
-
<em class="parameter"><code><a href="../glib
|
1248
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> *num_messages</code></em>,
|
1249
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> *flags</code></em>,
|
1250
1250
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1251
|
-
<em class="parameter"><code><a href="../glib
|
1251
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1252
1252
|
<p>Receive data from a socket. For receiving multiple messages, see
|
1253
1253
|
<a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()"><code class="function">g_socket_receive_messages()</code></a>; for easier use, see
|
1254
1254
|
<a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a> and <a class="link" href="GSocket.html#g-socket-receive-from" title="g_socket_receive_from ()"><code class="function">g_socket_receive_from()</code></a>.</p>
|
1255
1255
|
<p>If <em class="parameter"><code>address</code></em>
|
1256
|
-
is non-<a href="../glib
|
1256
|
+
is non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <em class="parameter"><code>address</code></em>
|
1257
1257
|
will be set equal to the
|
1258
1258
|
source address of the received packet.
|
1259
1259
|
<em class="parameter"><code>address</code></em>
|
@@ -1266,33 +1266,33 @@ describe the buffers that received data will be scattered into.
|
|
1266
1266
|
If <em class="parameter"><code>num_vectors</code></em>
|
1267
1267
|
is -1, then <em class="parameter"><code>vectors</code></em>
|
1268
1268
|
is assumed to be terminated
|
1269
|
-
by a <a class="link" href="GSocket.html#GInputVector" title="struct GInputVector"><span class="type">GInputVector</span></a> with a <a href="../glib
|
1269
|
+
by a <a class="link" href="GSocket.html#GInputVector" title="struct GInputVector"><span class="type">GInputVector</span></a> with a <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> buffer pointer.</p>
|
1270
1270
|
<p>As a special case, if <em class="parameter"><code>num_vectors</code></em>
|
1271
1271
|
is 0 (in which case, <em class="parameter"><code>vectors</code></em>
|
1272
1272
|
|
1273
|
-
may of course be <a href="../glib
|
1273
|
+
may of course be <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), then a single byte is received and
|
1274
1274
|
discarded. This is to facilitate the common practice of sending a
|
1275
1275
|
single '\0' byte for the purposes of transferring ancillary data.</p>
|
1276
1276
|
<p><em class="parameter"><code>messages</code></em>
|
1277
|
-
, if non-<a href="../glib
|
1278
|
-
array of <a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> instances or <a href="../glib
|
1277
|
+
, if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, will be set to point to a newly-allocated
|
1278
|
+
array of <a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> instances or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such
|
1279
1279
|
messages was received. These correspond to the control messages
|
1280
1280
|
received from the kernel, one <a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> per message
|
1281
|
-
from the kernel. This array is <a href="../glib
|
1282
|
-
by the caller using <a href="../glib
|
1281
|
+
from the kernel. This array is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated and must be freed
|
1282
|
+
by the caller using <a href="../glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after calling <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on each
|
1283
1283
|
element. If <em class="parameter"><code>messages</code></em>
|
1284
|
-
is <a href="../glib
|
1284
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, any control messages received will
|
1285
1285
|
be discarded.</p>
|
1286
1286
|
<p><em class="parameter"><code>num_messages</code></em>
|
1287
|
-
, if non-<a href="../glib
|
1287
|
+
, if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, will be set to the number of control
|
1288
1288
|
messages received.</p>
|
1289
1289
|
<p>If both <em class="parameter"><code>messages</code></em>
|
1290
1290
|
and <em class="parameter"><code>num_messages</code></em>
|
1291
|
-
are non-<a href="../glib
|
1291
|
+
are non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
|
1292
1292
|
<em class="parameter"><code>num_messages</code></em>
|
1293
1293
|
gives the number of <a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> instances
|
1294
1294
|
in <em class="parameter"><code>messages</code></em>
|
1295
|
-
(ie: not including the <a href="../glib
|
1295
|
+
(ie: not including the <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminator).</p>
|
1296
1296
|
<p><em class="parameter"><code>flags</code></em>
|
1297
1297
|
is an in/out parameter. The commonly available arguments
|
1298
1298
|
for this are available in the <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> enum, but the
|
@@ -1315,11 +1315,11 @@ is some data to receive, the connection is closed, or there is an
|
|
1315
1315
|
error. If there is no data available and the socket is in
|
1316
1316
|
non-blocking mode, a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error will be
|
1317
1317
|
returned. To be notified when data is available, wait for the
|
1318
|
-
<a href="../glib
|
1318
|
+
<a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition.</p>
|
1319
1319
|
<p>On error -1 is returned and <em class="parameter"><code>error</code></em>
|
1320
1320
|
is set accordingly.</p>
|
1321
1321
|
<div class="refsect3">
|
1322
|
-
<a name="
|
1322
|
+
<a name="g-socket-receive-message.parameters"></a><h4>Parameters</h4>
|
1323
1323
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1324
1324
|
<colgroup>
|
1325
1325
|
<col width="150px" class="parameters_name">
|
@@ -1335,7 +1335,7 @@ returned. To be notified when data is available, wait for the
|
|
1335
1335
|
<tr>
|
1336
1336
|
<td class="parameter_name"><p>address</p></td>
|
1337
1337
|
<td class="parameter_description"><p> a pointer to a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>
|
1338
|
-
pointer, or <a href="../glib
|
1338
|
+
pointer, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1339
1339
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
1340
1340
|
</tr>
|
1341
1341
|
<tr>
|
@@ -1352,14 +1352,14 @@ pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="l
|
|
1352
1352
|
<tr>
|
1353
1353
|
<td class="parameter_name"><p>messages</p></td>
|
1354
1354
|
<td class="parameter_description"><p> a pointer which
|
1355
|
-
may be filled with an array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib
|
1355
|
+
may be filled with an array of <a href="GSocketControlMessage.html#GSocketControlMessage-struct"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1356
1356
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
1357
1357
|
</tr>
|
1358
1358
|
<tr>
|
1359
1359
|
<td class="parameter_name"><p>num_messages</p></td>
|
1360
1360
|
<td class="parameter_description"><p> a pointer which will be filled with the number of
|
1361
1361
|
elements in <em class="parameter"><code>messages</code></em>
|
1362
|
-
, or <a href="../glib
|
1362
|
+
, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1363
1363
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
1364
1364
|
</tr>
|
1365
1365
|
<tr>
|
@@ -1369,19 +1369,19 @@ elements in <em class="parameter"><code>messages</code></em>
|
|
1369
1369
|
</tr>
|
1370
1370
|
<tr>
|
1371
1371
|
<td class="parameter_name"><p>cancellable</p></td>
|
1372
|
-
<td class="parameter_description"><p>a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1372
|
+
<td class="parameter_description"><p>a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
1373
1373
|
<td class="parameter_annotations"> </td>
|
1374
1374
|
</tr>
|
1375
1375
|
<tr>
|
1376
1376
|
<td class="parameter_name"><p>error</p></td>
|
1377
|
-
<td class="parameter_description"><p>a <a href="../glib
|
1377
|
+
<td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> pointer, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
1378
1378
|
<td class="parameter_annotations"> </td>
|
1379
1379
|
</tr>
|
1380
1380
|
</tbody>
|
1381
1381
|
</table></div>
|
1382
1382
|
</div>
|
1383
1383
|
<div class="refsect3">
|
1384
|
-
<a name="
|
1384
|
+
<a name="g-socket-receive-message.returns"></a><h4>Returns</h4>
|
1385
1385
|
<p> Number of bytes read, or 0 if the connection was closed by
|
1386
1386
|
the peer, or -1 on error</p>
|
1387
1387
|
</div>
|
@@ -1390,13 +1390,13 @@ the peer, or -1 on error</p>
|
|
1390
1390
|
<hr>
|
1391
1391
|
<div class="refsect2">
|
1392
1392
|
<a name="g-socket-receive-messages"></a><h3>g_socket_receive_messages ()</h3>
|
1393
|
-
<pre class="programlisting"><a href="../glib
|
1393
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
1394
1394
|
g_socket_receive_messages (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1395
1395
|
<em class="parameter"><code><a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a> *messages</code></em>,
|
1396
|
-
<em class="parameter"><code><a href="../glib
|
1397
|
-
<em class="parameter"><code><a href="../glib
|
1396
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_messages</code></em>,
|
1397
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> flags</code></em>,
|
1398
1398
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1399
|
-
<em class="parameter"><code><a href="../glib
|
1399
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1400
1400
|
<p>Receive multiple data messages from <em class="parameter"><code>socket</code></em>
|
1401
1401
|
in one go. This is the most
|
1402
1402
|
complicated and fully-featured version of this call. For easier use, see
|
@@ -1421,10 +1421,10 @@ flags affect the overall receive operation. Flags affecting individual
|
|
1421
1421
|
messages are returned in <a class="link" href="GSocket.html#GInputMessage.flags"><span class="type">GInputMessage.flags</span></a>.</p>
|
1422
1422
|
<p>The other members of <a class="link" href="GSocket.html#GInputMessage" title="struct GInputMessage"><span class="type">GInputMessage</span></a> are treated as described in its
|
1423
1423
|
documentation.</p>
|
1424
|
-
<p>If <a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property"><span class="type">“blocking”</span></a> is <a href="../glib
|
1424
|
+
<p>If <a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property"><span class="type">“blocking”</span></a> is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the call will block until <em class="parameter"><code>num_messages</code></em>
|
1425
1425
|
have
|
1426
1426
|
been received, or the end of the stream is reached.</p>
|
1427
|
-
<p>If <a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property"><span class="type">“blocking”</span></a> is <a href="../glib
|
1427
|
+
<p>If <a class="link" href="GSocket.html#GSocket--blocking" title="The “blocking” property"><span class="type">“blocking”</span></a> is <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> the call will return up to <em class="parameter"><code>num_messages</code></em>
|
1428
1428
|
|
1429
1429
|
without blocking, or <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> if no messages are queued in the
|
1430
1430
|
operating system to be received.</p>
|
@@ -1434,9 +1434,9 @@ messages are received, <a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-
|
|
1434
1434
|
are returned. (Note: This is effectively the
|
1435
1435
|
behaviour of <code class="literal">MSG_WAITFORONE</code> with <code class="function">recvmmsg()</code>.)</p>
|
1436
1436
|
<p>To be notified when messages are available, wait for the
|
1437
|
-
<a href="../glib
|
1437
|
+
<a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition. Note though that you may still receive
|
1438
1438
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> from <a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()"><code class="function">g_socket_receive_messages()</code></a> even if you were
|
1439
|
-
previously notified of a <a href="../glib
|
1439
|
+
previously notified of a <a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition.</p>
|
1440
1440
|
<p>If the remote peer closes the connection, any messages queued in the
|
1441
1441
|
operating system will be returned, and subsequent calls to
|
1442
1442
|
<a class="link" href="GSocket.html#g-socket-receive-messages" title="g_socket_receive_messages ()"><code class="function">g_socket_receive_messages()</code></a> will return 0 (with no error set).</p>
|
@@ -1445,7 +1445,7 @@ operating system will be returned, and subsequent calls to
|
|
1445
1445
|
be returned if zero messages could be received; otherwise the number of
|
1446
1446
|
messages successfully received before the error will be returned.</p>
|
1447
1447
|
<div class="refsect3">
|
1448
|
-
<a name="
|
1448
|
+
<a name="g-socket-receive-messages.parameters"></a><h4>Parameters</h4>
|
1449
1449
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1450
1450
|
<colgroup>
|
1451
1451
|
<col width="150px" class="parameters_name">
|
@@ -1476,19 +1476,19 @@ messages successfully received before the error will be returned.</p>
|
|
1476
1476
|
</tr>
|
1477
1477
|
<tr>
|
1478
1478
|
<td class="parameter_name"><p>cancellable</p></td>
|
1479
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1479
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1480
1480
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1481
1481
|
</tr>
|
1482
1482
|
<tr>
|
1483
1483
|
<td class="parameter_name"><p>error</p></td>
|
1484
|
-
<td class="parameter_description"><p><a href="../glib
|
1484
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</p></td>
|
1485
1485
|
<td class="parameter_annotations"> </td>
|
1486
1486
|
</tr>
|
1487
1487
|
</tbody>
|
1488
1488
|
</table></div>
|
1489
1489
|
</div>
|
1490
1490
|
<div class="refsect3">
|
1491
|
-
<a name="
|
1491
|
+
<a name="g-socket-receive-messages.returns"></a><h4>Returns</h4>
|
1492
1492
|
<p> number of messages received, or -1 on error. Note that the number
|
1493
1493
|
of messages received may be smaller than <em class="parameter"><code>num_messages</code></em>
|
1494
1494
|
if in non-blocking
|
@@ -1501,20 +1501,20 @@ to receive the remaining messages.</p>
|
|
1501
1501
|
<hr>
|
1502
1502
|
<div class="refsect2">
|
1503
1503
|
<a name="g-socket-receive-with-blocking"></a><h3>g_socket_receive_with_blocking ()</h3>
|
1504
|
-
<pre class="programlisting"><a href="../glib
|
1504
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1505
1505
|
g_socket_receive_with_blocking (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1506
|
-
<em class="parameter"><code><a href="../glib
|
1507
|
-
<em class="parameter"><code><a href="../glib
|
1508
|
-
<em class="parameter"><code><a href="../glib
|
1506
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
1507
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> size</code></em>,
|
1508
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> blocking</code></em>,
|
1509
1509
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1510
|
-
<em class="parameter"><code><a href="../glib
|
1510
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1511
1511
|
<p>This behaves exactly the same as <a class="link" href="GSocket.html#g-socket-receive" title="g_socket_receive ()"><code class="function">g_socket_receive()</code></a>, except that
|
1512
1512
|
the choice of blocking or non-blocking behavior is determined by
|
1513
1513
|
the <em class="parameter"><code>blocking</code></em>
|
1514
1514
|
argument rather than by <em class="parameter"><code>socket</code></em>
|
1515
1515
|
's properties.</p>
|
1516
1516
|
<div class="refsect3">
|
1517
|
-
<a name="
|
1517
|
+
<a name="g-socket-receive-with-blocking.parameters"></a><h4>Parameters</h4>
|
1518
1518
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1519
1519
|
<colgroup>
|
1520
1520
|
<col width="150px" class="parameters_name">
|
@@ -1546,19 +1546,19 @@ bytes long). </p></td>
|
|
1546
1546
|
</tr>
|
1547
1547
|
<tr>
|
1548
1548
|
<td class="parameter_name"><p>cancellable</p></td>
|
1549
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1549
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1550
1550
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1551
1551
|
</tr>
|
1552
1552
|
<tr>
|
1553
1553
|
<td class="parameter_name"><p>error</p></td>
|
1554
|
-
<td class="parameter_description"><p><a href="../glib
|
1554
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1555
1555
|
<td class="parameter_annotations"> </td>
|
1556
1556
|
</tr>
|
1557
1557
|
</tbody>
|
1558
1558
|
</table></div>
|
1559
1559
|
</div>
|
1560
1560
|
<div class="refsect3">
|
1561
|
-
<a name="
|
1561
|
+
<a name="g-socket-receive-with-blocking.returns"></a><h4>Returns</h4>
|
1562
1562
|
<p> Number of bytes read, or 0 if the connection was closed by
|
1563
1563
|
the peer, or -1 on error</p>
|
1564
1564
|
</div>
|
@@ -1567,30 +1567,30 @@ the peer, or -1 on error</p>
|
|
1567
1567
|
<hr>
|
1568
1568
|
<div class="refsect2">
|
1569
1569
|
<a name="g-socket-send"></a><h3>g_socket_send ()</h3>
|
1570
|
-
<pre class="programlisting"><a href="../glib
|
1570
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1571
1571
|
g_socket_send (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1572
|
-
<em class="parameter"><code>const <a href="../glib
|
1573
|
-
<em class="parameter"><code><a href="../glib
|
1572
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
1573
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> size</code></em>,
|
1574
1574
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1575
|
-
<em class="parameter"><code><a href="../glib
|
1575
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1576
1576
|
<p>Tries to send <em class="parameter"><code>size</code></em>
|
1577
1577
|
bytes from <em class="parameter"><code>buffer</code></em>
|
1578
1578
|
on the socket. This is
|
1579
1579
|
mainly used by connection-oriented sockets; it is identical to
|
1580
1580
|
<a class="link" href="GSocket.html#g-socket-send-to" title="g_socket_send_to ()"><code class="function">g_socket_send_to()</code></a> with <em class="parameter"><code>address</code></em>
|
1581
|
-
set to <a href="../glib
|
1581
|
+
set to <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
|
1582
1582
|
<p>If the socket is in blocking mode the call will block until there is
|
1583
1583
|
space for the data in the socket queue. If there is no space available
|
1584
1584
|
and the socket is in non-blocking mode a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error
|
1585
1585
|
will be returned. To be notified when space is available, wait for the
|
1586
|
-
<a href="../glib
|
1586
|
+
<a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. Note though that you may still receive
|
1587
1587
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> from <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> even if you were previously
|
1588
|
-
notified of a <a href="../glib
|
1588
|
+
notified of a <a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. (On Windows in particular, this is
|
1589
1589
|
very common due to the way the underlying APIs work.)</p>
|
1590
1590
|
<p>On error -1 is returned and <em class="parameter"><code>error</code></em>
|
1591
1591
|
is set accordingly.</p>
|
1592
1592
|
<div class="refsect3">
|
1593
|
-
<a name="
|
1593
|
+
<a name="g-socket-send.parameters"></a><h4>Parameters</h4>
|
1594
1594
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1595
1595
|
<colgroup>
|
1596
1596
|
<col width="150px" class="parameters_name">
|
@@ -1616,19 +1616,19 @@ containing the data to send. </p></td>
|
|
1616
1616
|
</tr>
|
1617
1617
|
<tr>
|
1618
1618
|
<td class="parameter_name"><p>cancellable</p></td>
|
1619
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1619
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1620
1620
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1621
1621
|
</tr>
|
1622
1622
|
<tr>
|
1623
1623
|
<td class="parameter_name"><p>error</p></td>
|
1624
|
-
<td class="parameter_description"><p><a href="../glib
|
1624
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1625
1625
|
<td class="parameter_annotations"> </td>
|
1626
1626
|
</tr>
|
1627
1627
|
</tbody>
|
1628
1628
|
</table></div>
|
1629
1629
|
</div>
|
1630
1630
|
<div class="refsect3">
|
1631
|
-
<a name="
|
1631
|
+
<a name="g-socket-send.returns"></a><h4>Returns</h4>
|
1632
1632
|
<p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
|
1633
1633
|
), or -1
|
1634
1634
|
on error</p>
|
@@ -1638,23 +1638,23 @@ on error</p>
|
|
1638
1638
|
<hr>
|
1639
1639
|
<div class="refsect2">
|
1640
1640
|
<a name="g-socket-send-to"></a><h3>g_socket_send_to ()</h3>
|
1641
|
-
<pre class="programlisting"><a href="../glib
|
1641
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1642
1642
|
g_socket_send_to (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1643
1643
|
<em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *address</code></em>,
|
1644
|
-
<em class="parameter"><code>const <a href="../glib
|
1645
|
-
<em class="parameter"><code><a href="../glib
|
1644
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
1645
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> size</code></em>,
|
1646
1646
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1647
|
-
<em class="parameter"><code><a href="../glib
|
1647
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1648
1648
|
<p>Tries to send <em class="parameter"><code>size</code></em>
|
1649
1649
|
bytes from <em class="parameter"><code>buffer</code></em>
|
1650
1650
|
to <em class="parameter"><code>address</code></em>
|
1651
1651
|
. If <em class="parameter"><code>address</code></em>
|
1652
1652
|
is
|
1653
|
-
<a href="../glib
|
1653
|
+
<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the message is sent to the default receiver (set by
|
1654
1654
|
<a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()"><code class="function">g_socket_connect()</code></a>).</p>
|
1655
1655
|
<p>See <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> for additional information.</p>
|
1656
1656
|
<div class="refsect3">
|
1657
|
-
<a name="
|
1657
|
+
<a name="g-socket-send-to.parameters"></a><h4>Parameters</h4>
|
1658
1658
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1659
1659
|
<colgroup>
|
1660
1660
|
<col width="150px" class="parameters_name">
|
@@ -1669,7 +1669,7 @@ g_socket_send_to (<em class="parameter"><code><a class="link" href="GSocket.html
|
|
1669
1669
|
</tr>
|
1670
1670
|
<tr>
|
1671
1671
|
<td class="parameter_name"><p>address</p></td>
|
1672
|
-
<td class="parameter_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib
|
1672
|
+
<td class="parameter_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1673
1673
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1674
1674
|
</tr>
|
1675
1675
|
<tr>
|
@@ -1685,19 +1685,19 @@ containing the data to send. </p></td>
|
|
1685
1685
|
</tr>
|
1686
1686
|
<tr>
|
1687
1687
|
<td class="parameter_name"><p>cancellable</p></td>
|
1688
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1688
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1689
1689
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1690
1690
|
</tr>
|
1691
1691
|
<tr>
|
1692
1692
|
<td class="parameter_name"><p>error</p></td>
|
1693
|
-
<td class="parameter_description"><p><a href="../glib
|
1693
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1694
1694
|
<td class="parameter_annotations"> </td>
|
1695
1695
|
</tr>
|
1696
1696
|
</tbody>
|
1697
1697
|
</table></div>
|
1698
1698
|
</div>
|
1699
1699
|
<div class="refsect3">
|
1700
|
-
<a name="
|
1700
|
+
<a name="g-socket-send-to.returns"></a><h4>Returns</h4>
|
1701
1701
|
<p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
|
1702
1702
|
), or -1
|
1703
1703
|
on error</p>
|
@@ -1707,23 +1707,23 @@ on error</p>
|
|
1707
1707
|
<hr>
|
1708
1708
|
<div class="refsect2">
|
1709
1709
|
<a name="g-socket-send-message"></a><h3>g_socket_send_message ()</h3>
|
1710
|
-
<pre class="programlisting"><a href="../glib
|
1710
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1711
1711
|
g_socket_send_message (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1712
1712
|
<em class="parameter"><code><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *address</code></em>,
|
1713
1713
|
<em class="parameter"><code><a class="link" href="GSocket.html#GOutputVector" title="struct GOutputVector"><span class="type">GOutputVector</span></a> *vectors</code></em>,
|
1714
|
-
<em class="parameter"><code><a href="../glib
|
1714
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> num_vectors</code></em>,
|
1715
1715
|
<em class="parameter"><code><a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> **messages</code></em>,
|
1716
|
-
<em class="parameter"><code><a href="../glib
|
1717
|
-
<em class="parameter"><code><a href="../glib
|
1716
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> num_messages</code></em>,
|
1717
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> flags</code></em>,
|
1718
1718
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1719
|
-
<em class="parameter"><code><a href="../glib
|
1719
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1720
1720
|
<p>Send data to <em class="parameter"><code>address</code></em>
|
1721
1721
|
on <em class="parameter"><code>socket</code></em>
|
1722
1722
|
. For sending multiple messages see
|
1723
1723
|
<a class="link" href="GSocket.html#g-socket-send-messages" title="g_socket_send_messages ()"><code class="function">g_socket_send_messages()</code></a>; for easier use, see
|
1724
1724
|
<a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> and <a class="link" href="GSocket.html#g-socket-send-to" title="g_socket_send_to ()"><code class="function">g_socket_send_to()</code></a>.</p>
|
1725
1725
|
<p>If <em class="parameter"><code>address</code></em>
|
1726
|
-
is <a href="../glib
|
1726
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the message is sent to the default receiver
|
1727
1727
|
(set by <a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()"><code class="function">g_socket_connect()</code></a>).</p>
|
1728
1728
|
<p><em class="parameter"><code>vectors</code></em>
|
1729
1729
|
must point to an array of <a class="link" href="GSocket.html#GOutputVector" title="struct GOutputVector"><span class="type">GOutputVector</span></a> structs and
|
@@ -1732,19 +1732,19 @@ g_socket_send_message (<em class="parameter"><code><a class="link" href="GSocket
|
|
1732
1732
|
is -1,
|
1733
1733
|
then <em class="parameter"><code>vectors</code></em>
|
1734
1734
|
is assumed to be terminated by a <a class="link" href="GSocket.html#GOutputVector" title="struct GOutputVector"><span class="type">GOutputVector</span></a> with a
|
1735
|
-
<a href="../glib
|
1735
|
+
<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> buffer pointer.) The <a class="link" href="GSocket.html#GOutputVector" title="struct GOutputVector"><span class="type">GOutputVector</span></a> structs describe the buffers
|
1736
1736
|
that the sent data will be gathered from. Using multiple
|
1737
1737
|
<a href="GSocket.html#GOutputVector"><span class="type">GOutputVectors</span></a> is more memory-efficient than manually copying
|
1738
1738
|
data from multiple sources into a single buffer, and more
|
1739
1739
|
network-efficient than making multiple calls to <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a>.</p>
|
1740
1740
|
<p><em class="parameter"><code>messages</code></em>
|
1741
|
-
, if non-<a href="../glib
|
1741
|
+
, if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, is taken to point to an array of <em class="parameter"><code>num_messages</code></em>
|
1742
1742
|
|
1743
1743
|
<a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> instances. These correspond to the control
|
1744
1744
|
messages to be sent on the socket.
|
1745
1745
|
If <em class="parameter"><code>num_messages</code></em>
|
1746
1746
|
is -1 then <em class="parameter"><code>messages</code></em>
|
1747
|
-
is treated as a <a href="../glib
|
1747
|
+
is treated as a <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
|
1748
1748
|
array.</p>
|
1749
1749
|
<p><em class="parameter"><code>flags</code></em>
|
1750
1750
|
modify how the message is sent. The commonly available arguments
|
@@ -1755,14 +1755,14 @@ are passed in as-is, so you can pass in system-specific flags too.</p>
|
|
1755
1755
|
space for the data in the socket queue. If there is no space available
|
1756
1756
|
and the socket is in non-blocking mode a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error
|
1757
1757
|
will be returned. To be notified when space is available, wait for the
|
1758
|
-
<a href="../glib
|
1758
|
+
<a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. Note though that you may still receive
|
1759
1759
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> from <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> even if you were previously
|
1760
|
-
notified of a <a href="../glib
|
1760
|
+
notified of a <a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. (On Windows in particular, this is
|
1761
1761
|
very common due to the way the underlying APIs work.)</p>
|
1762
1762
|
<p>On error -1 is returned and <em class="parameter"><code>error</code></em>
|
1763
1763
|
is set accordingly.</p>
|
1764
1764
|
<div class="refsect3">
|
1765
|
-
<a name="
|
1765
|
+
<a name="g-socket-send-message.parameters"></a><h4>Parameters</h4>
|
1766
1766
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1767
1767
|
<colgroup>
|
1768
1768
|
<col width="150px" class="parameters_name">
|
@@ -1777,7 +1777,7 @@ very common due to the way the underlying APIs work.)</p>
|
|
1777
1777
|
</tr>
|
1778
1778
|
<tr>
|
1779
1779
|
<td class="parameter_name"><p>address</p></td>
|
1780
|
-
<td class="parameter_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib
|
1780
|
+
<td class="parameter_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1781
1781
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1782
1782
|
</tr>
|
1783
1783
|
<tr>
|
@@ -1794,7 +1794,7 @@ very common due to the way the underlying APIs work.)</p>
|
|
1794
1794
|
<tr>
|
1795
1795
|
<td class="parameter_name"><p>messages</p></td>
|
1796
1796
|
<td class="parameter_description"><p> a pointer to an
|
1797
|
-
array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib
|
1797
|
+
array of <a href="GSocketControlMessage.html#GSocketControlMessage-struct"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1798
1798
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_messages][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1799
1799
|
</tr>
|
1800
1800
|
<tr>
|
@@ -1810,19 +1810,19 @@ array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlM
|
|
1810
1810
|
</tr>
|
1811
1811
|
<tr>
|
1812
1812
|
<td class="parameter_name"><p>cancellable</p></td>
|
1813
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1813
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1814
1814
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1815
1815
|
</tr>
|
1816
1816
|
<tr>
|
1817
1817
|
<td class="parameter_name"><p>error</p></td>
|
1818
|
-
<td class="parameter_description"><p><a href="../glib
|
1818
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1819
1819
|
<td class="parameter_annotations"> </td>
|
1820
1820
|
</tr>
|
1821
1821
|
</tbody>
|
1822
1822
|
</table></div>
|
1823
1823
|
</div>
|
1824
1824
|
<div class="refsect3">
|
1825
|
-
<a name="
|
1825
|
+
<a name="g-socket-send-message.returns"></a><h4>Returns</h4>
|
1826
1826
|
<p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
|
1827
1827
|
), or -1
|
1828
1828
|
on error</p>
|
@@ -1832,13 +1832,13 @@ on error</p>
|
|
1832
1832
|
<hr>
|
1833
1833
|
<div class="refsect2">
|
1834
1834
|
<a name="g-socket-send-messages"></a><h3>g_socket_send_messages ()</h3>
|
1835
|
-
<pre class="programlisting"><a href="../glib
|
1835
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
1836
1836
|
g_socket_send_messages (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1837
1837
|
<em class="parameter"><code><a class="link" href="GSocket.html#GOutputMessage" title="struct GOutputMessage"><span class="type">GOutputMessage</span></a> *messages</code></em>,
|
1838
|
-
<em class="parameter"><code><a href="../glib
|
1839
|
-
<em class="parameter"><code><a href="../glib
|
1838
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_messages</code></em>,
|
1839
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> flags</code></em>,
|
1840
1840
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1841
|
-
<em class="parameter"><code><a href="../glib
|
1841
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1842
1842
|
<p>Send multiple data messages from <em class="parameter"><code>socket</code></em>
|
1843
1843
|
in one go. This is the most
|
1844
1844
|
complicated and fully-featured version of this call. For easier use, see
|
@@ -1866,16 +1866,16 @@ space for all the data in the socket queue. If there is no space available
|
|
1866
1866
|
and the socket is in non-blocking mode a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> error
|
1867
1867
|
will be returned if no data was written at all, otherwise the number of
|
1868
1868
|
messages sent will be returned. To be notified when space is available,
|
1869
|
-
wait for the <a href="../glib
|
1869
|
+
wait for the <a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. Note though that you may still receive
|
1870
1870
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a> from <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a> even if you were previously
|
1871
|
-
notified of a <a href="../glib
|
1871
|
+
notified of a <a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> condition. (On Windows in particular, this is
|
1872
1872
|
very common due to the way the underlying APIs work.)</p>
|
1873
1873
|
<p>On error -1 is returned and <em class="parameter"><code>error</code></em>
|
1874
1874
|
is set accordingly. An error will only
|
1875
1875
|
be returned if zero messages could be sent; otherwise the number of messages
|
1876
1876
|
successfully sent before the error will be returned.</p>
|
1877
1877
|
<div class="refsect3">
|
1878
|
-
<a name="
|
1878
|
+
<a name="g-socket-send-messages.parameters"></a><h4>Parameters</h4>
|
1879
1879
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1880
1880
|
<colgroup>
|
1881
1881
|
<col width="150px" class="parameters_name">
|
@@ -1906,19 +1906,19 @@ successfully sent before the error will be returned.</p>
|
|
1906
1906
|
</tr>
|
1907
1907
|
<tr>
|
1908
1908
|
<td class="parameter_name"><p>cancellable</p></td>
|
1909
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1909
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1910
1910
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1911
1911
|
</tr>
|
1912
1912
|
<tr>
|
1913
1913
|
<td class="parameter_name"><p>error</p></td>
|
1914
|
-
<td class="parameter_description"><p><a href="../glib
|
1914
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1915
1915
|
<td class="parameter_annotations"> </td>
|
1916
1916
|
</tr>
|
1917
1917
|
</tbody>
|
1918
1918
|
</table></div>
|
1919
1919
|
</div>
|
1920
1920
|
<div class="refsect3">
|
1921
|
-
<a name="
|
1921
|
+
<a name="g-socket-send-messages.returns"></a><h4>Returns</h4>
|
1922
1922
|
<p> number of messages sent, or -1 on error. Note that the number of
|
1923
1923
|
messages sent may be smaller than <em class="parameter"><code>num_messages</code></em>
|
1924
1924
|
if the socket is
|
@@ -1931,20 +1931,20 @@ in which case the caller may re-try to send the remaining messages.</p>
|
|
1931
1931
|
<hr>
|
1932
1932
|
<div class="refsect2">
|
1933
1933
|
<a name="g-socket-send-with-blocking"></a><h3>g_socket_send_with_blocking ()</h3>
|
1934
|
-
<pre class="programlisting"><a href="../glib
|
1934
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
1935
1935
|
g_socket_send_with_blocking (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
1936
|
-
<em class="parameter"><code>const <a href="../glib
|
1937
|
-
<em class="parameter"><code><a href="../glib
|
1938
|
-
<em class="parameter"><code><a href="../glib
|
1936
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buffer</code></em>,
|
1937
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> size</code></em>,
|
1938
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> blocking</code></em>,
|
1939
1939
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
1940
|
-
<em class="parameter"><code><a href="../glib
|
1940
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
1941
1941
|
<p>This behaves exactly the same as <a class="link" href="GSocket.html#g-socket-send" title="g_socket_send ()"><code class="function">g_socket_send()</code></a>, except that
|
1942
1942
|
the choice of blocking or non-blocking behavior is determined by
|
1943
1943
|
the <em class="parameter"><code>blocking</code></em>
|
1944
1944
|
argument rather than by <em class="parameter"><code>socket</code></em>
|
1945
1945
|
's properties.</p>
|
1946
1946
|
<div class="refsect3">
|
1947
|
-
<a name="
|
1947
|
+
<a name="g-socket-send-with-blocking.parameters"></a><h4>Parameters</h4>
|
1948
1948
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
1949
1949
|
<colgroup>
|
1950
1950
|
<col width="150px" class="parameters_name">
|
@@ -1975,19 +1975,19 @@ containing the data to send. </p></td>
|
|
1975
1975
|
</tr>
|
1976
1976
|
<tr>
|
1977
1977
|
<td class="parameter_name"><p>cancellable</p></td>
|
1978
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
1978
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
1979
1979
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
1980
1980
|
</tr>
|
1981
1981
|
<tr>
|
1982
1982
|
<td class="parameter_name"><p>error</p></td>
|
1983
|
-
<td class="parameter_description"><p><a href="../glib
|
1983
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
1984
1984
|
<td class="parameter_annotations"> </td>
|
1985
1985
|
</tr>
|
1986
1986
|
</tbody>
|
1987
1987
|
</table></div>
|
1988
1988
|
</div>
|
1989
1989
|
<div class="refsect3">
|
1990
|
-
<a name="
|
1990
|
+
<a name="g-socket-send-with-blocking.returns"></a><h4>Returns</h4>
|
1991
1991
|
<p> Number of bytes written (which may be less than <em class="parameter"><code>size</code></em>
|
1992
1992
|
), or -1
|
1993
1993
|
on error</p>
|
@@ -1997,9 +1997,9 @@ on error</p>
|
|
1997
1997
|
<hr>
|
1998
1998
|
<div class="refsect2">
|
1999
1999
|
<a name="g-socket-close"></a><h3>g_socket_close ()</h3>
|
2000
|
-
<pre class="programlisting"><a href="../glib
|
2000
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2001
2001
|
g_socket_close (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2002
|
-
<em class="parameter"><code><a href="../glib
|
2002
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2003
2003
|
<p>Closes the socket, shutting down any active connection.</p>
|
2004
2004
|
<p>Closing a socket does not wait for all outstanding I/O operations
|
2005
2005
|
to finish, so the caller should not rely on them to be guaranteed
|
@@ -2012,7 +2012,7 @@ is dropped, but you might want to call this function to make sure
|
|
2012
2012
|
resources are released as early as possible.</p>
|
2013
2013
|
<p>Beware that due to the way that TCP works, it is possible for
|
2014
2014
|
recently-sent data to be lost if either you close a socket while the
|
2015
|
-
<a href="../glib
|
2015
|
+
<a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> condition is set, or else if the remote connection tries to
|
2016
2016
|
send something to you after you close the socket but before it has
|
2017
2017
|
finished reading all of the data you sent. There is no easy generic
|
2018
2018
|
way to avoid this problem; the easiest fix is to design the network
|
@@ -2027,7 +2027,7 @@ connection, after which the server can safely call <a class="link" href="GSocket
|
|
2027
2027
|
only works if the client will close its connection after the server
|
2028
2028
|
does.)</p>
|
2029
2029
|
<div class="refsect3">
|
2030
|
-
<a name="
|
2030
|
+
<a name="g-socket-close.parameters"></a><h4>Parameters</h4>
|
2031
2031
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2032
2032
|
<colgroup>
|
2033
2033
|
<col width="150px" class="parameters_name">
|
@@ -2042,26 +2042,26 @@ does.)</p>
|
|
2042
2042
|
</tr>
|
2043
2043
|
<tr>
|
2044
2044
|
<td class="parameter_name"><p>error</p></td>
|
2045
|
-
<td class="parameter_description"><p><a href="../glib
|
2045
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
2046
2046
|
<td class="parameter_annotations"> </td>
|
2047
2047
|
</tr>
|
2048
2048
|
</tbody>
|
2049
2049
|
</table></div>
|
2050
2050
|
</div>
|
2051
2051
|
<div class="refsect3">
|
2052
|
-
<a name="
|
2053
|
-
<p> <a href="../glib
|
2052
|
+
<a name="g-socket-close.returns"></a><h4>Returns</h4>
|
2053
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
|
2054
2054
|
</div>
|
2055
2055
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2056
2056
|
</div>
|
2057
2057
|
<hr>
|
2058
2058
|
<div class="refsect2">
|
2059
2059
|
<a name="g-socket-is-closed"></a><h3>g_socket_is_closed ()</h3>
|
2060
|
-
<pre class="programlisting"><a href="../glib
|
2060
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2061
2061
|
g_socket_is_closed (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2062
2062
|
<p>Checks whether a socket is closed.</p>
|
2063
2063
|
<div class="refsect3">
|
2064
|
-
<a name="
|
2064
|
+
<a name="g-socket-is-closed.parameters"></a><h4>Parameters</h4>
|
2065
2065
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2066
2066
|
<colgroup>
|
2067
2067
|
<col width="150px" class="parameters_name">
|
@@ -2076,35 +2076,35 @@ g_socket_is_closed (<em class="parameter"><code><a class="link" href="GSocket.ht
|
|
2076
2076
|
</table></div>
|
2077
2077
|
</div>
|
2078
2078
|
<div class="refsect3">
|
2079
|
-
<a name="
|
2080
|
-
<p> <a href="../glib
|
2079
|
+
<a name="g-socket-is-closed.returns"></a><h4>Returns</h4>
|
2080
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if socket is closed, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
|
2081
2081
|
</div>
|
2082
2082
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2083
2083
|
</div>
|
2084
2084
|
<hr>
|
2085
2085
|
<div class="refsect2">
|
2086
2086
|
<a name="g-socket-shutdown"></a><h3>g_socket_shutdown ()</h3>
|
2087
|
-
<pre class="programlisting"><a href="../glib
|
2087
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2088
2088
|
g_socket_shutdown (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2089
|
-
<em class="parameter"><code><a href="../glib
|
2090
|
-
<em class="parameter"><code><a href="../glib
|
2091
|
-
<em class="parameter"><code><a href="../glib
|
2089
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> shutdown_read</code></em>,
|
2090
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> shutdown_write</code></em>,
|
2091
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2092
2092
|
<p>Shut down part or all of a full-duplex connection.</p>
|
2093
2093
|
<p>If <em class="parameter"><code>shutdown_read</code></em>
|
2094
|
-
is <a href="../glib
|
2094
|
+
is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then the receiving side of the connection
|
2095
2095
|
is shut down, and further reading is disallowed.</p>
|
2096
2096
|
<p>If <em class="parameter"><code>shutdown_write</code></em>
|
2097
|
-
is <a href="../glib
|
2097
|
+
is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then the sending side of the connection
|
2098
2098
|
is shut down, and further writing is disallowed.</p>
|
2099
2099
|
<p>It is allowed for both <em class="parameter"><code>shutdown_read</code></em>
|
2100
2100
|
and <em class="parameter"><code>shutdown_write</code></em>
|
2101
|
-
to be <a href="../glib
|
2101
|
+
to be <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
|
2102
2102
|
<p>One example where it is useful to shut down only one side of a connection is
|
2103
2103
|
graceful disconnect for TCP connections where you close the sending side,
|
2104
2104
|
then wait for the other side to close the connection, thus ensuring that the
|
2105
2105
|
other side saw all sent data.</p>
|
2106
2106
|
<div class="refsect3">
|
2107
|
-
<a name="
|
2107
|
+
<a name="g-socket-shutdown.parameters"></a><h4>Parameters</h4>
|
2108
2108
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2109
2109
|
<colgroup>
|
2110
2110
|
<col width="150px" class="parameters_name">
|
@@ -2129,31 +2129,31 @@ other side saw all sent data.</p>
|
|
2129
2129
|
</tr>
|
2130
2130
|
<tr>
|
2131
2131
|
<td class="parameter_name"><p>error</p></td>
|
2132
|
-
<td class="parameter_description"><p><a href="../glib
|
2132
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
2133
2133
|
<td class="parameter_annotations"> </td>
|
2134
2134
|
</tr>
|
2135
2135
|
</tbody>
|
2136
2136
|
</table></div>
|
2137
2137
|
</div>
|
2138
2138
|
<div class="refsect3">
|
2139
|
-
<a name="
|
2140
|
-
<p> <a href="../glib
|
2139
|
+
<a name="g-socket-shutdown.returns"></a><h4>Returns</h4>
|
2140
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p>
|
2141
2141
|
</div>
|
2142
2142
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2143
2143
|
</div>
|
2144
2144
|
<hr>
|
2145
2145
|
<div class="refsect2">
|
2146
2146
|
<a name="g-socket-is-connected"></a><h3>g_socket_is_connected ()</h3>
|
2147
|
-
<pre class="programlisting"><a href="../glib
|
2147
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2148
2148
|
g_socket_is_connected (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2149
2149
|
<p>Check whether the socket is connected. This is only useful for
|
2150
2150
|
connection-oriented sockets.</p>
|
2151
|
-
<p>If using <a class="link" href="GSocket.html#g-socket-shutdown" title="g_socket_shutdown ()"><code class="function">g_socket_shutdown()</code></a>, this function will return <a href="../glib
|
2151
|
+
<p>If using <a class="link" href="GSocket.html#g-socket-shutdown" title="g_socket_shutdown ()"><code class="function">g_socket_shutdown()</code></a>, this function will return <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> until the
|
2152
2152
|
socket has been shut down for reading and writing. If you do a non-blocking
|
2153
|
-
connect, this function will not return <a href="../glib
|
2153
|
+
connect, this function will not return <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> until after you call
|
2154
2154
|
<a class="link" href="GSocket.html#g-socket-check-connect-result" title="g_socket_check_connect_result ()"><code class="function">g_socket_check_connect_result()</code></a>.</p>
|
2155
2155
|
<div class="refsect3">
|
2156
|
-
<a name="
|
2156
|
+
<a name="g-socket-is-connected.parameters"></a><h4>Parameters</h4>
|
2157
2157
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2158
2158
|
<colgroup>
|
2159
2159
|
<col width="150px" class="parameters_name">
|
@@ -2168,29 +2168,29 @@ connect, this function will not return <a href="../glib/glib-Standard-Macros.htm
|
|
2168
2168
|
</table></div>
|
2169
2169
|
</div>
|
2170
2170
|
<div class="refsect3">
|
2171
|
-
<a name="
|
2172
|
-
<p> <a href="../glib
|
2171
|
+
<a name="g-socket-is-connected.returns"></a><h4>Returns</h4>
|
2172
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if socket is connected, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
2173
2173
|
</div>
|
2174
2174
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2175
2175
|
</div>
|
2176
2176
|
<hr>
|
2177
2177
|
<div class="refsect2">
|
2178
2178
|
<a name="g-socket-create-source"></a><h3>g_socket_create_source ()</h3>
|
2179
|
-
<pre class="programlisting"><a href="../glib
|
2179
|
+
<pre class="programlisting"><a href="../glib-The-Main-Event-Loop.html#GSource"><span class="returnvalue">GSource</span></a> *
|
2180
2180
|
g_socket_create_source (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2181
|
-
<em class="parameter"><code><a href="../glib
|
2181
|
+
<em class="parameter"><code><a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> condition</code></em>,
|
2182
2182
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre>
|
2183
|
-
<p>Creates a <a href="../glib
|
2183
|
+
<p>Creates a <a href="../glib-The-Main-Event-Loop.html#GSource"><span class="type">GSource</span></a> that can be attached to a <a href="../glib-The-Main-Event-Loop.html#GMainContext"><code class="literal">GMainContext</code></a> to monitor
|
2184
2184
|
for the availability of the specified <em class="parameter"><code>condition</code></em>
|
2185
|
-
on the socket. The <a href="../glib
|
2185
|
+
on the socket. The <a href="../glib-The-Main-Event-Loop.html#GSource"><span class="type">GSource</span></a>
|
2186
2186
|
keeps a reference to the <em class="parameter"><code>socket</code></em>
|
2187
2187
|
.</p>
|
2188
2188
|
<p>The callback on the source is of the <a class="link" href="GSocket.html#GSocketSourceFunc" title="GSocketSourceFunc ()"><span class="type">GSocketSourceFunc</span></a> type.</p>
|
2189
|
-
<p>It is meaningless to specify <a href="../glib
|
2189
|
+
<p>It is meaningless to specify <a href="../glib-IO-Channels.html#G-IO-ERR:CAPS"><code class="literal">G_IO_ERR</code></a> or <a href="../glib-IO-Channels.html#G-IO-HUP:CAPS"><code class="literal">G_IO_HUP</code></a> in <em class="parameter"><code>condition</code></em>
|
2190
2190
|
;
|
2191
2191
|
these conditions will always be reported output if they are true.</p>
|
2192
2192
|
<p><em class="parameter"><code>cancellable</code></em>
|
2193
|
-
if not <a href="../glib
|
2193
|
+
if not <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> can be used to cancel the source, which will
|
2194
2194
|
cause the source to trigger, reporting the current condition (which
|
2195
2195
|
is likely 0 unless cancellation happened at the same time as a
|
2196
2196
|
condition change). You can check for this in the callback using
|
@@ -2198,15 +2198,15 @@ condition change). You can check for this in the callback using
|
|
2198
2198
|
<p>If <em class="parameter"><code>socket</code></em>
|
2199
2199
|
has a timeout set, and it is reached before <em class="parameter"><code>condition</code></em>
|
2200
2200
|
|
2201
|
-
occurs, the source will then trigger anyway, reporting <a href="../glib
|
2202
|
-
<a href="../glib
|
2201
|
+
occurs, the source will then trigger anyway, reporting <a href="../glib-IO-Channels.html#G-IO-IN:CAPS"><code class="literal">G_IO_IN</code></a> or
|
2202
|
+
<a href="../glib-IO-Channels.html#G-IO-OUT:CAPS"><code class="literal">G_IO_OUT</code></a> depending on <em class="parameter"><code>condition</code></em>
|
2203
2203
|
. However, <em class="parameter"><code>socket</code></em>
|
2204
2204
|
will have been
|
2205
2205
|
marked as having had a timeout, and so the next <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> I/O method
|
2206
2206
|
you call will then fail with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a>.</p>
|
2207
2207
|
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
2208
2208
|
<div class="refsect3">
|
2209
|
-
<a name="
|
2209
|
+
<a name="g-socket-create-source.parameters"></a><h4>Parameters</h4>
|
2210
2210
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2211
2211
|
<colgroup>
|
2212
2212
|
<col width="150px" class="parameters_name">
|
@@ -2221,20 +2221,20 @@ you call will then fail with a <a class="link" href="gio-GIOError.html#G-IO-ERRO
|
|
2221
2221
|
</tr>
|
2222
2222
|
<tr>
|
2223
2223
|
<td class="parameter_name"><p>condition</p></td>
|
2224
|
-
<td class="parameter_description"><p>a <a href="../glib
|
2224
|
+
<td class="parameter_description"><p>a <a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> mask to monitor</p></td>
|
2225
2225
|
<td class="parameter_annotations"> </td>
|
2226
2226
|
</tr>
|
2227
2227
|
<tr>
|
2228
2228
|
<td class="parameter_name"><p>cancellable</p></td>
|
2229
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib
|
2229
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><code class="literal">GCancellable</code></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2230
2230
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2231
2231
|
</tr>
|
2232
2232
|
</tbody>
|
2233
2233
|
</table></div>
|
2234
2234
|
</div>
|
2235
2235
|
<div class="refsect3">
|
2236
|
-
<a name="
|
2237
|
-
<p> a newly allocated <a href="../glib
|
2236
|
+
<a name="g-socket-create-source.returns"></a><h4>Returns</h4>
|
2237
|
+
<p> a newly allocated <a href="../glib-The-Main-Event-Loop.html#GSource"><code class="literal">GSource</code></a>, free with <a href="../glib-The-Main-Event-Loop.html#g-source-unref"><code class="function">g_source_unref()</code></a>. </p>
|
2238
2238
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2239
2239
|
</div>
|
2240
2240
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -2242,9 +2242,9 @@ you call will then fail with a <a class="link" href="gio-GIOError.html#G-IO-ERRO
|
|
2242
2242
|
<hr>
|
2243
2243
|
<div class="refsect2">
|
2244
2244
|
<a name="g-socket-condition-check"></a><h3>g_socket_condition_check ()</h3>
|
2245
|
-
<pre class="programlisting"><a href="../glib
|
2245
|
+
<pre class="programlisting"><a href="../glib-IO-Channels.html#GIOCondition"><span class="returnvalue">GIOCondition</span></a>
|
2246
2246
|
g_socket_condition_check (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2247
|
-
<em class="parameter"><code><a href="../glib
|
2247
|
+
<em class="parameter"><code><a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> condition</code></em>);</pre>
|
2248
2248
|
<p>Checks on the readiness of <em class="parameter"><code>socket</code></em>
|
2249
2249
|
to perform operations.
|
2250
2250
|
The operations specified in <em class="parameter"><code>condition</code></em>
|
@@ -2259,11 +2259,11 @@ writing. Rather than calling <a class="link" href="GSocket.html#g-socket-conditi
|
|
2259
2259
|
writing to the socket if it succeeds, it is generally better to
|
2260
2260
|
simply try writing to the socket right away, and try again later if
|
2261
2261
|
the initial attempt returns <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></a>.</p>
|
2262
|
-
<p>It is meaningless to specify <a href="../glib
|
2262
|
+
<p>It is meaningless to specify <a href="../glib-IO-Channels.html#G-IO-ERR:CAPS"><code class="literal">G_IO_ERR</code></a> or <a href="../glib-IO-Channels.html#G-IO-HUP:CAPS"><code class="literal">G_IO_HUP</code></a> in condition;
|
2263
2263
|
these conditions will always be set in the output if they are true.</p>
|
2264
2264
|
<p>This call never blocks.</p>
|
2265
2265
|
<div class="refsect3">
|
2266
|
-
<a name="
|
2266
|
+
<a name="g-socket-condition-check.parameters"></a><h4>Parameters</h4>
|
2267
2267
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2268
2268
|
<colgroup>
|
2269
2269
|
<col width="150px" class="parameters_name">
|
@@ -2278,14 +2278,14 @@ these conditions will always be set in the output if they are true.</p>
|
|
2278
2278
|
</tr>
|
2279
2279
|
<tr>
|
2280
2280
|
<td class="parameter_name"><p>condition</p></td>
|
2281
|
-
<td class="parameter_description"><p>a <a href="../glib
|
2281
|
+
<td class="parameter_description"><p>a <a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> mask to check</p></td>
|
2282
2282
|
<td class="parameter_annotations"> </td>
|
2283
2283
|
</tr>
|
2284
2284
|
</tbody>
|
2285
2285
|
</table></div>
|
2286
2286
|
</div>
|
2287
2287
|
<div class="refsect3">
|
2288
|
-
<a name="
|
2288
|
+
<a name="g-socket-condition-check.returns"></a><h4>Returns</h4>
|
2289
2289
|
<p> the <em class="parameter"><code>GIOCondition</code></em>
|
2290
2290
|
mask of the current state</p>
|
2291
2291
|
</div>
|
@@ -2294,25 +2294,25 @@ mask of the current state</p>
|
|
2294
2294
|
<hr>
|
2295
2295
|
<div class="refsect2">
|
2296
2296
|
<a name="g-socket-condition-wait"></a><h3>g_socket_condition_wait ()</h3>
|
2297
|
-
<pre class="programlisting"><a href="../glib
|
2297
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2298
2298
|
g_socket_condition_wait (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2299
|
-
<em class="parameter"><code><a href="../glib
|
2299
|
+
<em class="parameter"><code><a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> condition</code></em>,
|
2300
2300
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
2301
|
-
<em class="parameter"><code><a href="../glib
|
2301
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2302
2302
|
<p>Waits for <em class="parameter"><code>condition</code></em>
|
2303
2303
|
to become true on <em class="parameter"><code>socket</code></em>
|
2304
2304
|
. When the condition
|
2305
|
-
is met, <a href="../glib
|
2305
|
+
is met, <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned.</p>
|
2306
2306
|
<p>If <em class="parameter"><code>cancellable</code></em>
|
2307
2307
|
is cancelled before the condition is met, or if the
|
2308
2308
|
socket has a timeout set and it is reached before the condition is
|
2309
|
-
met, then <a href="../glib
|
2310
|
-
, if non-<a href="../glib
|
2309
|
+
met, then <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>error</code></em>
|
2310
|
+
, if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, is set to
|
2311
2311
|
the appropriate value (<a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> or
|
2312
2312
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a>).</p>
|
2313
2313
|
<p>See also <a class="link" href="GSocket.html#g-socket-condition-timed-wait" title="g_socket_condition_timed_wait ()"><code class="function">g_socket_condition_timed_wait()</code></a>.</p>
|
2314
2314
|
<div class="refsect3">
|
2315
|
-
<a name="
|
2315
|
+
<a name="g-socket-condition-wait.parameters"></a><h4>Parameters</h4>
|
2316
2316
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2317
2317
|
<colgroup>
|
2318
2318
|
<col width="150px" class="parameters_name">
|
@@ -2327,48 +2327,48 @@ the appropriate value (<a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCEL
|
|
2327
2327
|
</tr>
|
2328
2328
|
<tr>
|
2329
2329
|
<td class="parameter_name"><p>condition</p></td>
|
2330
|
-
<td class="parameter_description"><p>a <a href="../glib
|
2330
|
+
<td class="parameter_description"><p>a <a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> mask to wait for</p></td>
|
2331
2331
|
<td class="parameter_annotations"> </td>
|
2332
2332
|
</tr>
|
2333
2333
|
<tr>
|
2334
2334
|
<td class="parameter_name"><p>cancellable</p></td>
|
2335
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib
|
2335
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2336
2336
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2337
2337
|
</tr>
|
2338
2338
|
<tr>
|
2339
2339
|
<td class="parameter_name"><p>error</p></td>
|
2340
|
-
<td class="parameter_description"><p>a <a href="../glib
|
2340
|
+
<td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> pointer, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
2341
2341
|
<td class="parameter_annotations"> </td>
|
2342
2342
|
</tr>
|
2343
2343
|
</tbody>
|
2344
2344
|
</table></div>
|
2345
2345
|
</div>
|
2346
2346
|
<div class="refsect3">
|
2347
|
-
<a name="
|
2348
|
-
<p> <a href="../glib
|
2347
|
+
<a name="g-socket-condition-wait.returns"></a><h4>Returns</h4>
|
2348
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the condition was met, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
|
2349
2349
|
</div>
|
2350
2350
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2351
2351
|
</div>
|
2352
2352
|
<hr>
|
2353
2353
|
<div class="refsect2">
|
2354
2354
|
<a name="g-socket-condition-timed-wait"></a><h3>g_socket_condition_timed_wait ()</h3>
|
2355
|
-
<pre class="programlisting"><a href="../glib
|
2355
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2356
2356
|
g_socket_condition_timed_wait (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2357
|
-
<em class="parameter"><code><a href="../glib
|
2358
|
-
<em class="parameter"><code><a href="../glib
|
2357
|
+
<em class="parameter"><code><a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> condition</code></em>,
|
2358
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timeout</code></em>,
|
2359
2359
|
<em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
2360
|
-
<em class="parameter"><code><a href="../glib
|
2360
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2361
2361
|
<p>Waits for up to <em class="parameter"><code>timeout</code></em>
|
2362
2362
|
microseconds for <em class="parameter"><code>condition</code></em>
|
2363
2363
|
to become true
|
2364
2364
|
on <em class="parameter"><code>socket</code></em>
|
2365
|
-
. If the condition is met, <a href="../glib
|
2365
|
+
. If the condition is met, <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned.</p>
|
2366
2366
|
<p>If <em class="parameter"><code>cancellable</code></em>
|
2367
2367
|
is cancelled before the condition is met, or if
|
2368
2368
|
<em class="parameter"><code>timeout</code></em>
|
2369
2369
|
(or the socket's <a class="link" href="GSocket.html#GSocket--timeout" title="The “timeout” property"><span class="type">“timeout”</span></a>) is reached before the
|
2370
|
-
condition is met, then <a href="../glib
|
2371
|
-
, if non-<a href="../glib
|
2370
|
+
condition is met, then <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>error</code></em>
|
2371
|
+
, if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
|
2372
2372
|
is set to the appropriate value (<a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> or
|
2373
2373
|
<a class="link" href="gio-GIOError.html#G-IO-ERROR-TIMED-OUT:CAPS"><code class="literal">G_IO_ERROR_TIMED_OUT</code></a>).</p>
|
2374
2374
|
<p>If you don't want a timeout, use <a class="link" href="GSocket.html#g-socket-condition-wait" title="g_socket_condition_wait ()"><code class="function">g_socket_condition_wait()</code></a>.
|
@@ -2381,7 +2381,7 @@ resolution, and the behavior is undefined if <em class="parameter"><code>timeout
|
|
2381
2381
|
is not an
|
2382
2382
|
exact number of milliseconds.</p>
|
2383
2383
|
<div class="refsect3">
|
2384
|
-
<a name="
|
2384
|
+
<a name="g-socket-condition-timed-wait.parameters"></a><h4>Parameters</h4>
|
2385
2385
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2386
2386
|
<colgroup>
|
2387
2387
|
<col width="150px" class="parameters_name">
|
@@ -2396,7 +2396,7 @@ exact number of milliseconds.</p>
|
|
2396
2396
|
</tr>
|
2397
2397
|
<tr>
|
2398
2398
|
<td class="parameter_name"><p>condition</p></td>
|
2399
|
-
<td class="parameter_description"><p>a <a href="../glib
|
2399
|
+
<td class="parameter_description"><p>a <a href="../glib-IO-Channels.html#GIOCondition"><span class="type">GIOCondition</span></a> mask to wait for</p></td>
|
2400
2400
|
<td class="parameter_annotations"> </td>
|
2401
2401
|
</tr>
|
2402
2402
|
<tr>
|
@@ -2406,27 +2406,27 @@ exact number of milliseconds.</p>
|
|
2406
2406
|
</tr>
|
2407
2407
|
<tr>
|
2408
2408
|
<td class="parameter_name"><p>cancellable</p></td>
|
2409
|
-
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib
|
2409
|
+
<td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2410
2410
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2411
2411
|
</tr>
|
2412
2412
|
<tr>
|
2413
2413
|
<td class="parameter_name"><p>error</p></td>
|
2414
|
-
<td class="parameter_description"><p>a <a href="../glib
|
2414
|
+
<td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> pointer, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
2415
2415
|
<td class="parameter_annotations"> </td>
|
2416
2416
|
</tr>
|
2417
2417
|
</tbody>
|
2418
2418
|
</table></div>
|
2419
2419
|
</div>
|
2420
2420
|
<div class="refsect3">
|
2421
|
-
<a name="
|
2422
|
-
<p> <a href="../glib
|
2421
|
+
<a name="g-socket-condition-timed-wait.returns"></a><h4>Returns</h4>
|
2422
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the condition was met, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
|
2423
2423
|
</div>
|
2424
2424
|
<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
|
2425
2425
|
</div>
|
2426
2426
|
<hr>
|
2427
2427
|
<div class="refsect2">
|
2428
2428
|
<a name="g-socket-get-available-bytes"></a><h3>g_socket_get_available_bytes ()</h3>
|
2429
|
-
<pre class="programlisting"><a href="../glib
|
2429
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
|
2430
2430
|
g_socket_get_available_bytes (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2431
2431
|
<p>Get the amount of data pending in the OS input buffer, without blocking.</p>
|
2432
2432
|
<p>If <em class="parameter"><code>socket</code></em>
|
@@ -2440,7 +2440,7 @@ of the incoming packet, it is better to just do a
|
|
2440
2440
|
<a class="link" href="GSocket.html#g-socket-get-available-bytes" title="g_socket_get_available_bytes ()"><code class="function">g_socket_get_available_bytes()</code></a> first and then doing a receive of
|
2441
2441
|
exactly the right size.</p>
|
2442
2442
|
<div class="refsect3">
|
2443
|
-
<a name="
|
2443
|
+
<a name="g-socket-get-available-bytes.parameters"></a><h4>Parameters</h4>
|
2444
2444
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2445
2445
|
<colgroup>
|
2446
2446
|
<col width="150px" class="parameters_name">
|
@@ -2455,7 +2455,7 @@ exactly the right size.</p>
|
|
2455
2455
|
</table></div>
|
2456
2456
|
</div>
|
2457
2457
|
<div class="refsect3">
|
2458
|
-
<a name="
|
2458
|
+
<a name="g-socket-get-available-bytes.returns"></a><h4>Returns</h4>
|
2459
2459
|
<p> the number of bytes that can be read from the socket
|
2460
2460
|
without blocking or truncating, or -1 on error.</p>
|
2461
2461
|
</div>
|
@@ -2466,7 +2466,7 @@ without blocking or truncating, or -1 on error.</p>
|
|
2466
2466
|
<a name="g-socket-set-listen-backlog"></a><h3>g_socket_set_listen_backlog ()</h3>
|
2467
2467
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2468
2468
|
g_socket_set_listen_backlog (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2469
|
-
<em class="parameter"><code><a href="../glib
|
2469
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> backlog</code></em>);</pre>
|
2470
2470
|
<p>Sets the maximum number of outstanding connections allowed
|
2471
2471
|
when listening on this socket. If more clients than this are
|
2472
2472
|
connecting to the socket and the application is not handling them
|
@@ -2474,7 +2474,7 @@ on time then the new connections will be refused.</p>
|
|
2474
2474
|
<p>Note that this must be called before <a class="link" href="GSocket.html#g-socket-listen" title="g_socket_listen ()"><code class="function">g_socket_listen()</code></a> and has no
|
2475
2475
|
effect if called after that.</p>
|
2476
2476
|
<div class="refsect3">
|
2477
|
-
<a name="
|
2477
|
+
<a name="g-socket-set-listen-backlog.parameters"></a><h4>Parameters</h4>
|
2478
2478
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2479
2479
|
<colgroup>
|
2480
2480
|
<col width="150px" class="parameters_name">
|
@@ -2500,12 +2500,12 @@ effect if called after that.</p>
|
|
2500
2500
|
<hr>
|
2501
2501
|
<div class="refsect2">
|
2502
2502
|
<a name="g-socket-get-listen-backlog"></a><h3>g_socket_get_listen_backlog ()</h3>
|
2503
|
-
<pre class="programlisting"><a href="../glib
|
2503
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
|
2504
2504
|
g_socket_get_listen_backlog (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2505
2505
|
<p>Gets the listen backlog setting of the socket. For details on this,
|
2506
2506
|
see <a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_socket_set_listen_backlog ()"><code class="function">g_socket_set_listen_backlog()</code></a>.</p>
|
2507
2507
|
<div class="refsect3">
|
2508
|
-
<a name="
|
2508
|
+
<a name="g-socket-get-listen-backlog.parameters"></a><h4>Parameters</h4>
|
2509
2509
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2510
2510
|
<colgroup>
|
2511
2511
|
<col width="150px" class="parameters_name">
|
@@ -2520,7 +2520,7 @@ see <a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_soc
|
|
2520
2520
|
</table></div>
|
2521
2521
|
</div>
|
2522
2522
|
<div class="refsect3">
|
2523
|
-
<a name="
|
2523
|
+
<a name="g-socket-get-listen-backlog.returns"></a><h4>Returns</h4>
|
2524
2524
|
<p> the maximum number of pending connections.</p>
|
2525
2525
|
</div>
|
2526
2526
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -2528,12 +2528,12 @@ see <a class="link" href="GSocket.html#g-socket-set-listen-backlog" title="g_soc
|
|
2528
2528
|
<hr>
|
2529
2529
|
<div class="refsect2">
|
2530
2530
|
<a name="g-socket-get-blocking"></a><h3>g_socket_get_blocking ()</h3>
|
2531
|
-
<pre class="programlisting"><a href="../glib
|
2531
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2532
2532
|
g_socket_get_blocking (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2533
2533
|
<p>Gets the blocking mode of the socket. For details on blocking I/O,
|
2534
2534
|
see <a class="link" href="GSocket.html#g-socket-set-blocking" title="g_socket_set_blocking ()"><code class="function">g_socket_set_blocking()</code></a>.</p>
|
2535
2535
|
<div class="refsect3">
|
2536
|
-
<a name="
|
2536
|
+
<a name="g-socket-get-blocking.parameters"></a><h4>Parameters</h4>
|
2537
2537
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2538
2538
|
<colgroup>
|
2539
2539
|
<col width="150px" class="parameters_name">
|
@@ -2548,8 +2548,8 @@ see <a class="link" href="GSocket.html#g-socket-set-blocking" title="g_socket_se
|
|
2548
2548
|
</table></div>
|
2549
2549
|
</div>
|
2550
2550
|
<div class="refsect3">
|
2551
|
-
<a name="
|
2552
|
-
<p> <a href="../glib
|
2551
|
+
<a name="g-socket-get-blocking.returns"></a><h4>Returns</h4>
|
2552
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if blocking I/O is used, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
2553
2553
|
</div>
|
2554
2554
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2555
2555
|
</div>
|
@@ -2558,7 +2558,7 @@ see <a class="link" href="GSocket.html#g-socket-set-blocking" title="g_socket_se
|
|
2558
2558
|
<a name="g-socket-set-blocking"></a><h3>g_socket_set_blocking ()</h3>
|
2559
2559
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2560
2560
|
g_socket_set_blocking (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2561
|
-
<em class="parameter"><code><a href="../glib
|
2561
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> blocking</code></em>);</pre>
|
2562
2562
|
<p>Sets the blocking mode of the socket. In blocking mode
|
2563
2563
|
all operations (which don’t take an explicit blocking parameter) block until
|
2564
2564
|
they succeed or there is an error. In
|
@@ -2568,7 +2568,7 @@ with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-WOULD-BLOCK:CAPS"><cod
|
|
2568
2568
|
platform level socket is always non-blocking, and blocking mode
|
2569
2569
|
is a GSocket level feature.</p>
|
2570
2570
|
<div class="refsect3">
|
2571
|
-
<a name="
|
2571
|
+
<a name="g-socket-set-blocking.parameters"></a><h4>Parameters</h4>
|
2572
2572
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2573
2573
|
<colgroup>
|
2574
2574
|
<col width="150px" class="parameters_name">
|
@@ -2594,12 +2594,12 @@ is a GSocket level feature.</p>
|
|
2594
2594
|
<hr>
|
2595
2595
|
<div class="refsect2">
|
2596
2596
|
<a name="g-socket-get-keepalive"></a><h3>g_socket_get_keepalive ()</h3>
|
2597
|
-
<pre class="programlisting"><a href="../glib
|
2597
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2598
2598
|
g_socket_get_keepalive (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2599
2599
|
<p>Gets the keepalive mode of the socket. For details on this,
|
2600
2600
|
see <a class="link" href="GSocket.html#g-socket-set-keepalive" title="g_socket_set_keepalive ()"><code class="function">g_socket_set_keepalive()</code></a>.</p>
|
2601
2601
|
<div class="refsect3">
|
2602
|
-
<a name="
|
2602
|
+
<a name="g-socket-get-keepalive.parameters"></a><h4>Parameters</h4>
|
2603
2603
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2604
2604
|
<colgroup>
|
2605
2605
|
<col width="150px" class="parameters_name">
|
@@ -2614,8 +2614,8 @@ see <a class="link" href="GSocket.html#g-socket-set-keepalive" title="g_socket_s
|
|
2614
2614
|
</table></div>
|
2615
2615
|
</div>
|
2616
2616
|
<div class="refsect3">
|
2617
|
-
<a name="
|
2618
|
-
<p> <a href="../glib
|
2617
|
+
<a name="g-socket-get-keepalive.returns"></a><h4>Returns</h4>
|
2618
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if keepalive is active, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
2619
2619
|
</div>
|
2620
2620
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
2621
2621
|
</div>
|
@@ -2624,7 +2624,7 @@ see <a class="link" href="GSocket.html#g-socket-set-keepalive" title="g_socket_s
|
|
2624
2624
|
<a name="g-socket-set-keepalive"></a><h3>g_socket_set_keepalive ()</h3>
|
2625
2625
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2626
2626
|
g_socket_set_keepalive (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2627
|
-
<em class="parameter"><code><a href="../glib
|
2627
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keepalive</code></em>);</pre>
|
2628
2628
|
<p>Sets or unsets the <code class="literal">SO_KEEPALIVE</code> flag on the underlying socket. When
|
2629
2629
|
this flag is set on a socket, the system will attempt to verify that the
|
2630
2630
|
remote socket endpoint is still present if a sufficiently long period of
|
@@ -2639,7 +2639,7 @@ on a server socket if you want to allow clients to remain idle for long
|
|
2639
2639
|
periods of time, but also want to ensure that connections are eventually
|
2640
2640
|
garbage-collected if clients crash or become unreachable.</p>
|
2641
2641
|
<div class="refsect3">
|
2642
|
-
<a name="
|
2642
|
+
<a name="g-socket-set-keepalive.parameters"></a><h4>Parameters</h4>
|
2643
2643
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2644
2644
|
<colgroup>
|
2645
2645
|
<col width="150px" class="parameters_name">
|
@@ -2665,12 +2665,12 @@ garbage-collected if clients crash or become unreachable.</p>
|
|
2665
2665
|
<hr>
|
2666
2666
|
<div class="refsect2">
|
2667
2667
|
<a name="g-socket-get-timeout"></a><h3>g_socket_get_timeout ()</h3>
|
2668
|
-
<pre class="programlisting"><a href="../glib
|
2668
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
2669
2669
|
g_socket_get_timeout (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2670
2670
|
<p>Gets the timeout setting of the socket. For details on this, see
|
2671
2671
|
<a class="link" href="GSocket.html#g-socket-set-timeout" title="g_socket_set_timeout ()"><code class="function">g_socket_set_timeout()</code></a>.</p>
|
2672
2672
|
<div class="refsect3">
|
2673
|
-
<a name="
|
2673
|
+
<a name="g-socket-get-timeout.parameters"></a><h4>Parameters</h4>
|
2674
2674
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2675
2675
|
<colgroup>
|
2676
2676
|
<col width="150px" class="parameters_name">
|
@@ -2685,7 +2685,7 @@ g_socket_get_timeout (<em class="parameter"><code><a class="link" href="GSocket.
|
|
2685
2685
|
</table></div>
|
2686
2686
|
</div>
|
2687
2687
|
<div class="refsect3">
|
2688
|
-
<a name="
|
2688
|
+
<a name="g-socket-get-timeout.returns"></a><h4>Returns</h4>
|
2689
2689
|
<p> the timeout in seconds</p>
|
2690
2690
|
</div>
|
2691
2691
|
<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
|
@@ -2695,7 +2695,7 @@ g_socket_get_timeout (<em class="parameter"><code><a class="link" href="GSocket.
|
|
2695
2695
|
<a name="g-socket-set-timeout"></a><h3>g_socket_set_timeout ()</h3>
|
2696
2696
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2697
2697
|
g_socket_set_timeout (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2698
|
-
<em class="parameter"><code><a href="../glib
|
2698
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> timeout</code></em>);</pre>
|
2699
2699
|
<p>Sets the time in seconds after which I/O operations on <em class="parameter"><code>socket</code></em>
|
2700
2700
|
will
|
2701
2701
|
time out if they have not yet completed.</p>
|
@@ -2717,7 +2717,7 @@ on their own.</p>
|
|
2717
2717
|
<p>Note that if an I/O operation is interrupted by a signal, this may
|
2718
2718
|
cause the timeout to be reset.</p>
|
2719
2719
|
<div class="refsect3">
|
2720
|
-
<a name="
|
2720
|
+
<a name="g-socket-set-timeout.parameters"></a><h4>Parameters</h4>
|
2721
2721
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2722
2722
|
<colgroup>
|
2723
2723
|
<col width="150px" class="parameters_name">
|
@@ -2746,12 +2746,12 @@ cause the timeout to be reset.</p>
|
|
2746
2746
|
<a name="g-socket-set-ttl"></a><h3>g_socket_set_ttl ()</h3>
|
2747
2747
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2748
2748
|
g_socket_set_ttl (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2749
|
-
<em class="parameter"><code><a href="../glib
|
2749
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> ttl</code></em>);</pre>
|
2750
2750
|
<p>Sets the time-to-live for outgoing unicast packets on <em class="parameter"><code>socket</code></em>
|
2751
2751
|
.
|
2752
2752
|
By default the platform-specific default value is used.</p>
|
2753
2753
|
<div class="refsect3">
|
2754
|
-
<a name="
|
2754
|
+
<a name="g-socket-set-ttl.parameters"></a><h4>Parameters</h4>
|
2755
2755
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2756
2756
|
<colgroup>
|
2757
2757
|
<col width="150px" class="parameters_name">
|
@@ -2778,13 +2778,13 @@ By default the platform-specific default value is used.</p>
|
|
2778
2778
|
<hr>
|
2779
2779
|
<div class="refsect2">
|
2780
2780
|
<a name="g-socket-get-ttl"></a><h3>g_socket_get_ttl ()</h3>
|
2781
|
-
<pre class="programlisting"><a href="../glib
|
2781
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
2782
2782
|
g_socket_get_ttl (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2783
2783
|
<p>Gets the unicast time-to-live setting on <em class="parameter"><code>socket</code></em>
|
2784
2784
|
; see
|
2785
2785
|
<a class="link" href="GSocket.html#g-socket-set-ttl" title="g_socket_set_ttl ()"><code class="function">g_socket_set_ttl()</code></a> for more details.</p>
|
2786
2786
|
<div class="refsect3">
|
2787
|
-
<a name="
|
2787
|
+
<a name="g-socket-get-ttl.parameters"></a><h4>Parameters</h4>
|
2788
2788
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2789
2789
|
<colgroup>
|
2790
2790
|
<col width="150px" class="parameters_name">
|
@@ -2799,7 +2799,7 @@ g_socket_get_ttl (<em class="parameter"><code><a class="link" href="GSocket.html
|
|
2799
2799
|
</table></div>
|
2800
2800
|
</div>
|
2801
2801
|
<div class="refsect3">
|
2802
|
-
<a name="
|
2802
|
+
<a name="g-socket-get-ttl.returns"></a><h4>Returns</h4>
|
2803
2803
|
<p> the time-to-live setting on <em class="parameter"><code>socket</code></em>
|
2804
2804
|
</p>
|
2805
2805
|
</div>
|
@@ -2808,14 +2808,14 @@ g_socket_get_ttl (<em class="parameter"><code><a class="link" href="GSocket.html
|
|
2808
2808
|
<hr>
|
2809
2809
|
<div class="refsect2">
|
2810
2810
|
<a name="g-socket-get-broadcast"></a><h3>g_socket_get_broadcast ()</h3>
|
2811
|
-
<pre class="programlisting"><a href="../glib
|
2811
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2812
2812
|
g_socket_get_broadcast (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
2813
2813
|
<p>Gets the broadcast setting on <em class="parameter"><code>socket</code></em>
|
2814
|
-
; if <a href="../glib
|
2814
|
+
; if <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
|
2815
2815
|
it is possible to send packets to broadcast
|
2816
2816
|
addresses.</p>
|
2817
2817
|
<div class="refsect3">
|
2818
|
-
<a name="
|
2818
|
+
<a name="g-socket-get-broadcast.parameters"></a><h4>Parameters</h4>
|
2819
2819
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2820
2820
|
<colgroup>
|
2821
2821
|
<col width="150px" class="parameters_name">
|
@@ -2830,7 +2830,7 @@ addresses.</p>
|
|
2830
2830
|
</table></div>
|
2831
2831
|
</div>
|
2832
2832
|
<div class="refsect3">
|
2833
|
-
<a name="
|
2833
|
+
<a name="g-socket-get-broadcast.returns"></a><h4>Returns</h4>
|
2834
2834
|
<p> the broadcast setting on <em class="parameter"><code>socket</code></em>
|
2835
2835
|
</p>
|
2836
2836
|
</div>
|
@@ -2841,12 +2841,12 @@ addresses.</p>
|
|
2841
2841
|
<a name="g-socket-set-broadcast"></a><h3>g_socket_set_broadcast ()</h3>
|
2842
2842
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2843
2843
|
g_socket_set_broadcast (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2844
|
-
<em class="parameter"><code><a href="../glib
|
2844
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> broadcast</code></em>);</pre>
|
2845
2845
|
<p>Sets whether <em class="parameter"><code>socket</code></em>
|
2846
2846
|
should allow sending to broadcast addresses.
|
2847
|
-
This is <a href="../glib
|
2847
|
+
This is <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> by default.</p>
|
2848
2848
|
<div class="refsect3">
|
2849
|
-
<a name="
|
2849
|
+
<a name="g-socket-set-broadcast.parameters"></a><h4>Parameters</h4>
|
2850
2850
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2851
2851
|
<colgroup>
|
2852
2852
|
<col width="150px" class="parameters_name">
|
@@ -2874,12 +2874,12 @@ addresses</p></td>
|
|
2874
2874
|
<hr>
|
2875
2875
|
<div class="refsect2">
|
2876
2876
|
<a name="g-socket-get-option"></a><h3>g_socket_get_option ()</h3>
|
2877
|
-
<pre class="programlisting"><a href="../glib
|
2877
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2878
2878
|
g_socket_get_option (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2879
|
-
<em class="parameter"><code><a href="../glib
|
2880
|
-
<em class="parameter"><code><a href="../glib
|
2881
|
-
<em class="parameter"><code><a href="../glib
|
2882
|
-
<em class="parameter"><code><a href="../glib
|
2879
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> level</code></em>,
|
2880
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> optname</code></em>,
|
2881
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>,
|
2882
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2883
2883
|
<p>Gets the value of an integer-valued option on <em class="parameter"><code>socket</code></em>
|
2884
2884
|
, as with
|
2885
2885
|
<code class="function">getsockopt()</code>. (If you need to fetch a non-integer-valued option,
|
@@ -2891,10 +2891,10 @@ platform-dependent options, you may need to include additional
|
|
2891
2891
|
headers.</p>
|
2892
2892
|
<p>Note that even for socket options that are a single byte in size,
|
2893
2893
|
<em class="parameter"><code>value</code></em>
|
2894
|
-
is still a pointer to a <a href="../glib
|
2894
|
+
is still a pointer to a <a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> variable, not a <a href="../glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>;
|
2895
2895
|
<a class="link" href="GSocket.html#g-socket-get-option" title="g_socket_get_option ()"><code class="function">g_socket_get_option()</code></a> will handle the conversion internally.</p>
|
2896
2896
|
<div class="refsect3">
|
2897
|
-
<a name="
|
2897
|
+
<a name="g-socket-get-option.parameters"></a><h4>Parameters</h4>
|
2898
2898
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2899
2899
|
<colgroup>
|
2900
2900
|
<col width="150px" class="parameters_name">
|
@@ -2924,14 +2924,14 @@ headers.</p>
|
|
2924
2924
|
</tr>
|
2925
2925
|
<tr>
|
2926
2926
|
<td class="parameter_name"><p>error</p></td>
|
2927
|
-
<td class="parameter_description"><p><a href="../glib
|
2927
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
2928
2928
|
<td class="parameter_annotations"> </td>
|
2929
2929
|
</tr>
|
2930
2930
|
</tbody>
|
2931
2931
|
</table></div>
|
2932
2932
|
</div>
|
2933
2933
|
<div class="refsect3">
|
2934
|
-
<a name="
|
2934
|
+
<a name="g-socket-get-option.returns"></a><h4>Returns</h4>
|
2935
2935
|
<p> success or failure. On failure, <em class="parameter"><code>error</code></em>
|
2936
2936
|
will be set, and
|
2937
2937
|
the system error value (<code class="literal">errno</code> or <code class="function">WSAGetLastError()</code>) will still
|
@@ -2942,12 +2942,12 @@ be set to the result of the <code class="function">getsockopt()</code> call.</p>
|
|
2942
2942
|
<hr>
|
2943
2943
|
<div class="refsect2">
|
2944
2944
|
<a name="g-socket-set-option"></a><h3>g_socket_set_option ()</h3>
|
2945
|
-
<pre class="programlisting"><a href="../glib
|
2945
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2946
2946
|
g_socket_set_option (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
2947
|
-
<em class="parameter"><code><a href="../glib
|
2948
|
-
<em class="parameter"><code><a href="../glib
|
2949
|
-
<em class="parameter"><code><a href="../glib
|
2950
|
-
<em class="parameter"><code><a href="../glib
|
2947
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> level</code></em>,
|
2948
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> optname</code></em>,
|
2949
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>,
|
2950
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2951
2951
|
<p>Sets the value of an integer-valued option on <em class="parameter"><code>socket</code></em>
|
2952
2952
|
, as with
|
2953
2953
|
<code class="function">setsockopt()</code>. (If you need to set a non-integer-valued option,
|
@@ -2958,7 +2958,7 @@ standard/portable socket options. For unusual socket protocols or
|
|
2958
2958
|
platform-dependent options, you may need to include additional
|
2959
2959
|
headers.</p>
|
2960
2960
|
<div class="refsect3">
|
2961
|
-
<a name="
|
2961
|
+
<a name="g-socket-set-option.parameters"></a><h4>Parameters</h4>
|
2962
2962
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
2963
2963
|
<colgroup>
|
2964
2964
|
<col width="150px" class="parameters_name">
|
@@ -2988,14 +2988,14 @@ headers.</p>
|
|
2988
2988
|
</tr>
|
2989
2989
|
<tr>
|
2990
2990
|
<td class="parameter_name"><p>error</p></td>
|
2991
|
-
<td class="parameter_description"><p><a href="../glib
|
2991
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
2992
2992
|
<td class="parameter_annotations"> </td>
|
2993
2993
|
</tr>
|
2994
2994
|
</tbody>
|
2995
2995
|
</table></div>
|
2996
2996
|
</div>
|
2997
2997
|
<div class="refsect3">
|
2998
|
-
<a name="
|
2998
|
+
<a name="g-socket-set-option.returns"></a><h4>Returns</h4>
|
2999
2999
|
<p> success or failure. On failure, <em class="parameter"><code>error</code></em>
|
3000
3000
|
will be set, and
|
3001
3001
|
the system error value (<code class="literal">errno</code> or <code class="function">WSAGetLastError()</code>) will still
|
@@ -3010,7 +3010,7 @@ be set to the result of the <code class="function">setsockopt()</code> call.</p>
|
|
3010
3010
|
g_socket_get_family (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
3011
3011
|
<p>Gets the socket family of the socket.</p>
|
3012
3012
|
<div class="refsect3">
|
3013
|
-
<a name="
|
3013
|
+
<a name="g-socket-get-family.parameters"></a><h4>Parameters</h4>
|
3014
3014
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3015
3015
|
<colgroup>
|
3016
3016
|
<col width="150px" class="parameters_name">
|
@@ -3025,7 +3025,7 @@ g_socket_get_family (<em class="parameter"><code><a class="link" href="GSocket.h
|
|
3025
3025
|
</table></div>
|
3026
3026
|
</div>
|
3027
3027
|
<div class="refsect3">
|
3028
|
-
<a name="
|
3028
|
+
<a name="g-socket-get-family.returns"></a><h4>Returns</h4>
|
3029
3029
|
<p> a <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></p>
|
3030
3030
|
</div>
|
3031
3031
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -3041,7 +3041,7 @@ a Winsock2 SOCKET handle. This may be useful for
|
|
3041
3041
|
doing platform specific or otherwise unusual operations
|
3042
3042
|
on the socket.</p>
|
3043
3043
|
<div class="refsect3">
|
3044
|
-
<a name="
|
3044
|
+
<a name="g-socket-get-fd.parameters"></a><h4>Parameters</h4>
|
3045
3045
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3046
3046
|
<colgroup>
|
3047
3047
|
<col width="150px" class="parameters_name">
|
@@ -3056,7 +3056,7 @@ on the socket.</p>
|
|
3056
3056
|
</table></div>
|
3057
3057
|
</div>
|
3058
3058
|
<div class="refsect3">
|
3059
|
-
<a name="
|
3059
|
+
<a name="g-socket-get-fd.returns"></a><h4>Returns</h4>
|
3060
3060
|
<p> the file descriptor of the socket.</p>
|
3061
3061
|
</div>
|
3062
3062
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -3066,12 +3066,12 @@ on the socket.</p>
|
|
3066
3066
|
<a name="g-socket-get-local-address"></a><h3>g_socket_get_local_address ()</h3>
|
3067
3067
|
<pre class="programlisting"><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="returnvalue">GSocketAddress</span></a> *
|
3068
3068
|
g_socket_get_local_address (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3069
|
-
<em class="parameter"><code><a href="../glib
|
3069
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
3070
3070
|
<p>Try to get the local address of a bound socket. This is only
|
3071
3071
|
useful if the socket has been bound to a local address,
|
3072
3072
|
either explicitly or implicitly when connecting.</p>
|
3073
3073
|
<div class="refsect3">
|
3074
|
-
<a name="
|
3074
|
+
<a name="g-socket-get-local-address.parameters"></a><h4>Parameters</h4>
|
3075
3075
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3076
3076
|
<colgroup>
|
3077
3077
|
<col width="150px" class="parameters_name">
|
@@ -3086,16 +3086,16 @@ either explicitly or implicitly when connecting.</p>
|
|
3086
3086
|
</tr>
|
3087
3087
|
<tr>
|
3088
3088
|
<td class="parameter_name"><p>error</p></td>
|
3089
|
-
<td class="parameter_description"><p><a href="../glib
|
3089
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
3090
3090
|
<td class="parameter_annotations"> </td>
|
3091
3091
|
</tr>
|
3092
3092
|
</tbody>
|
3093
3093
|
</table></div>
|
3094
3094
|
</div>
|
3095
3095
|
<div class="refsect3">
|
3096
|
-
<a name="
|
3097
|
-
<p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib
|
3098
|
-
Free the returned object with <a href="../gobject
|
3096
|
+
<a name="g-socket-get-local-address.returns"></a><h4>Returns</h4>
|
3097
|
+
<p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
|
3098
|
+
Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
|
3099
3099
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
3100
3100
|
</div>
|
3101
3101
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -3108,7 +3108,7 @@ g_socket_get_protocol (<em class="parameter"><code><a class="link" href="GSocket
|
|
3108
3108
|
<p>Gets the socket protocol id the socket was created with.
|
3109
3109
|
In case the protocol is unknown, -1 is returned.</p>
|
3110
3110
|
<div class="refsect3">
|
3111
|
-
<a name="
|
3111
|
+
<a name="g-socket-get-protocol.parameters"></a><h4>Parameters</h4>
|
3112
3112
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3113
3113
|
<colgroup>
|
3114
3114
|
<col width="150px" class="parameters_name">
|
@@ -3123,7 +3123,7 @@ In case the protocol is unknown, -1 is returned.</p>
|
|
3123
3123
|
</table></div>
|
3124
3124
|
</div>
|
3125
3125
|
<div class="refsect3">
|
3126
|
-
<a name="
|
3126
|
+
<a name="g-socket-get-protocol.returns"></a><h4>Returns</h4>
|
3127
3127
|
<p> a protocol id, or -1 if unknown</p>
|
3128
3128
|
</div>
|
3129
3129
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -3133,11 +3133,11 @@ In case the protocol is unknown, -1 is returned.</p>
|
|
3133
3133
|
<a name="g-socket-get-remote-address"></a><h3>g_socket_get_remote_address ()</h3>
|
3134
3134
|
<pre class="programlisting"><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="returnvalue">GSocketAddress</span></a> *
|
3135
3135
|
g_socket_get_remote_address (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3136
|
-
<em class="parameter"><code><a href="../glib
|
3136
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
3137
3137
|
<p>Try to get the remove address of a connected socket. This is only
|
3138
3138
|
useful for connection oriented sockets that have been connected.</p>
|
3139
3139
|
<div class="refsect3">
|
3140
|
-
<a name="
|
3140
|
+
<a name="g-socket-get-remote-address.parameters"></a><h4>Parameters</h4>
|
3141
3141
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3142
3142
|
<colgroup>
|
3143
3143
|
<col width="150px" class="parameters_name">
|
@@ -3152,16 +3152,16 @@ useful for connection oriented sockets that have been connected.</p>
|
|
3152
3152
|
</tr>
|
3153
3153
|
<tr>
|
3154
3154
|
<td class="parameter_name"><p>error</p></td>
|
3155
|
-
<td class="parameter_description"><p><a href="../glib
|
3155
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
3156
3156
|
<td class="parameter_annotations"> </td>
|
3157
3157
|
</tr>
|
3158
3158
|
</tbody>
|
3159
3159
|
</table></div>
|
3160
3160
|
</div>
|
3161
3161
|
<div class="refsect3">
|
3162
|
-
<a name="
|
3163
|
-
<p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib
|
3164
|
-
Free the returned object with <a href="../gobject
|
3162
|
+
<a name="g-socket-get-remote-address.returns"></a><h4>Returns</h4>
|
3163
|
+
<p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
|
3164
|
+
Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
|
3165
3165
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
3166
3166
|
</div>
|
3167
3167
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -3173,7 +3173,7 @@ Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.h
|
|
3173
3173
|
g_socket_get_socket_type (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
3174
3174
|
<p>Gets the socket type of the socket.</p>
|
3175
3175
|
<div class="refsect3">
|
3176
|
-
<a name="
|
3176
|
+
<a name="g-socket-get-socket-type.parameters"></a><h4>Parameters</h4>
|
3177
3177
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3178
3178
|
<colgroup>
|
3179
3179
|
<col width="150px" class="parameters_name">
|
@@ -3188,7 +3188,7 @@ g_socket_get_socket_type (<em class="parameter"><code><a class="link" href="GSoc
|
|
3188
3188
|
</table></div>
|
3189
3189
|
</div>
|
3190
3190
|
<div class="refsect3">
|
3191
|
-
<a name="
|
3191
|
+
<a name="g-socket-get-socket-type.returns"></a><h4>Returns</h4>
|
3192
3192
|
<p> a <a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a></p>
|
3193
3193
|
</div>
|
3194
3194
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
@@ -3196,7 +3196,7 @@ g_socket_get_socket_type (<em class="parameter"><code><a class="link" href="GSoc
|
|
3196
3196
|
<hr>
|
3197
3197
|
<div class="refsect2">
|
3198
3198
|
<a name="g-socket-speaks-ipv4"></a><h3>g_socket_speaks_ipv4 ()</h3>
|
3199
|
-
<pre class="programlisting"><a href="../glib
|
3199
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
3200
3200
|
g_socket_speaks_ipv4 (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
3201
3201
|
<p>Checks if a socket is capable of speaking IPv4.</p>
|
3202
3202
|
<p>IPv4 sockets are capable of speaking IPv4. On some operating systems
|
@@ -3206,7 +3206,7 @@ information.</p>
|
|
3206
3206
|
<p>No other types of sockets are currently considered as being capable
|
3207
3207
|
of speaking IPv4.</p>
|
3208
3208
|
<div class="refsect3">
|
3209
|
-
<a name="
|
3209
|
+
<a name="g-socket-speaks-ipv4.parameters"></a><h4>Parameters</h4>
|
3210
3210
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3211
3211
|
<colgroup>
|
3212
3212
|
<col width="150px" class="parameters_name">
|
@@ -3221,8 +3221,8 @@ of speaking IPv4.</p>
|
|
3221
3221
|
</table></div>
|
3222
3222
|
</div>
|
3223
3223
|
<div class="refsect3">
|
3224
|
-
<a name="
|
3225
|
-
<p> <a href="../glib
|
3224
|
+
<a name="g-socket-speaks-ipv4.returns"></a><h4>Returns</h4>
|
3225
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if this socket can be used with IPv4.</p>
|
3226
3226
|
</div>
|
3227
3227
|
<p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
|
3228
3228
|
</div>
|
@@ -3231,7 +3231,7 @@ of speaking IPv4.</p>
|
|
3231
3231
|
<a name="g-socket-get-credentials"></a><h3>g_socket_get_credentials ()</h3>
|
3232
3232
|
<pre class="programlisting"><a class="link" href="GCredentials.html" title="GCredentials"><span class="returnvalue">GCredentials</span></a> *
|
3233
3233
|
g_socket_get_credentials (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3234
|
-
<em class="parameter"><code><a href="../glib
|
3234
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
3235
3235
|
<p>Returns the credentials of the foreign process connected to this
|
3236
3236
|
socket, if any (e.g. it is only supported for <a class="link" href="GSocketAddress.html#G-SOCKET-FAMILY-UNIX:CAPS"><code class="literal">G_SOCKET_FAMILY_UNIX</code></a>
|
3237
3237
|
sockets).</p>
|
@@ -3243,7 +3243,7 @@ by reading the <code class="literal">SO_PEERCRED</code> option on the underlying
|
|
3243
3243
|
<a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials" title="g_unix_connection_send_credentials ()"><code class="function">g_unix_connection_send_credentials()</code></a> /
|
3244
3244
|
<a class="link" href="GUnixConnection.html#g-unix-connection-receive-credentials" title="g_unix_connection_receive_credentials ()"><code class="function">g_unix_connection_receive_credentials()</code></a> functions.</p>
|
3245
3245
|
<div class="refsect3">
|
3246
|
-
<a name="
|
3246
|
+
<a name="g-socket-get-credentials.parameters"></a><h4>Parameters</h4>
|
3247
3247
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3248
3248
|
<colgroup>
|
3249
3249
|
<col width="150px" class="parameters_name">
|
@@ -3258,17 +3258,17 @@ by reading the <code class="literal">SO_PEERCRED</code> option on the underlying
|
|
3258
3258
|
</tr>
|
3259
3259
|
<tr>
|
3260
3260
|
<td class="parameter_name"><p>error</p></td>
|
3261
|
-
<td class="parameter_description"><p><a href="../glib
|
3261
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
3262
3262
|
<td class="parameter_annotations"> </td>
|
3263
3263
|
</tr>
|
3264
3264
|
</tbody>
|
3265
3265
|
</table></div>
|
3266
3266
|
</div>
|
3267
3267
|
<div class="refsect3">
|
3268
|
-
<a name="
|
3269
|
-
<p> <a href="../glib
|
3268
|
+
<a name="g-socket-get-credentials.returns"></a><h4>Returns</h4>
|
3269
|
+
<p> <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
|
3270
3270
|
is set, otherwise a <a class="link" href="GCredentials.html" title="GCredentials"><span class="type">GCredentials</span></a> object
|
3271
|
-
that must be freed with <a href="../gobject
|
3271
|
+
that must be freed with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
|
3272
3272
|
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
3273
3273
|
</div>
|
3274
3274
|
<p class="since">Since: <a class="link" href="api-index-2-26.html#api-index-2.26">2.26</a></p>
|
@@ -3276,12 +3276,12 @@ that must be freed with <a href="../gobject/gobject-The-Base-Object-Type.html#g-
|
|
3276
3276
|
<hr>
|
3277
3277
|
<div class="refsect2">
|
3278
3278
|
<a name="g-socket-join-multicast-group"></a><h3>g_socket_join_multicast_group ()</h3>
|
3279
|
-
<pre class="programlisting"><a href="../glib
|
3279
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
3280
3280
|
g_socket_join_multicast_group (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3281
3281
|
<em class="parameter"><code><a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a> *group</code></em>,
|
3282
|
-
<em class="parameter"><code><a href="../glib
|
3283
|
-
<em class="parameter"><code>const <a href="../glib
|
3284
|
-
<em class="parameter"><code><a href="../glib
|
3282
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> source_specific</code></em>,
|
3283
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *iface</code></em>,
|
3284
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
3285
3285
|
<p>Registers <em class="parameter"><code>socket</code></em>
|
3286
3286
|
to receive multicast messages sent to <em class="parameter"><code>group</code></em>
|
3287
3287
|
.
|
@@ -3290,15 +3290,15 @@ g_socket_join_multicast_group (<em class="parameter"><code><a class="link" href=
|
|
3290
3290
|
been bound to an appropriate interface and port with
|
3291
3291
|
<a class="link" href="GSocket.html#g-socket-bind" title="g_socket_bind ()"><code class="function">g_socket_bind()</code></a>.</p>
|
3292
3292
|
<p>If <em class="parameter"><code>iface</code></em>
|
3293
|
-
is <a href="../glib
|
3293
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the system will automatically pick an interface
|
3294
3294
|
to bind to based on <em class="parameter"><code>group</code></em>
|
3295
3295
|
.</p>
|
3296
3296
|
<p>If <em class="parameter"><code>source_specific</code></em>
|
3297
|
-
is <a href="../glib
|
3297
|
+
is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, source-specific multicast as defined
|
3298
3298
|
in RFC 4604 is used. Note that on older platforms this may fail
|
3299
3299
|
with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a> error.</p>
|
3300
3300
|
<div class="refsect3">
|
3301
|
-
<a name="
|
3301
|
+
<a name="g-socket-join-multicast-group.parameters"></a><h4>Parameters</h4>
|
3302
3302
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3303
3303
|
<colgroup>
|
3304
3304
|
<col width="150px" class="parameters_name">
|
@@ -3318,37 +3318,37 @@ with a <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><c
|
|
3318
3318
|
</tr>
|
3319
3319
|
<tr>
|
3320
3320
|
<td class="parameter_name"><p>iface</p></td>
|
3321
|
-
<td class="parameter_description"><p> Name of the interface to use, or <a href="../glib
|
3321
|
+
<td class="parameter_description"><p> Name of the interface to use, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
3322
3322
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
3323
3323
|
</tr>
|
3324
3324
|
<tr>
|
3325
3325
|
<td class="parameter_name"><p>source_specific</p></td>
|
3326
|
-
<td class="parameter_description"><p><a href="../glib
|
3326
|
+
<td class="parameter_description"><p><a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if source-specific multicast should be used</p></td>
|
3327
3327
|
<td class="parameter_annotations"> </td>
|
3328
3328
|
</tr>
|
3329
3329
|
<tr>
|
3330
3330
|
<td class="parameter_name"><p>error</p></td>
|
3331
|
-
<td class="parameter_description"><p><a href="../glib
|
3331
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
3332
3332
|
<td class="parameter_annotations"> </td>
|
3333
3333
|
</tr>
|
3334
3334
|
</tbody>
|
3335
3335
|
</table></div>
|
3336
3336
|
</div>
|
3337
3337
|
<div class="refsect3">
|
3338
|
-
<a name="
|
3339
|
-
<p> <a href="../glib
|
3338
|
+
<a name="g-socket-join-multicast-group.returns"></a><h4>Returns</h4>
|
3339
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
|
3340
3340
|
</div>
|
3341
3341
|
<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
|
3342
3342
|
</div>
|
3343
3343
|
<hr>
|
3344
3344
|
<div class="refsect2">
|
3345
3345
|
<a name="g-socket-leave-multicast-group"></a><h3>g_socket_leave_multicast_group ()</h3>
|
3346
|
-
<pre class="programlisting"><a href="../glib
|
3346
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
3347
3347
|
g_socket_leave_multicast_group (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3348
3348
|
<em class="parameter"><code><a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a> *group</code></em>,
|
3349
|
-
<em class="parameter"><code><a href="../glib
|
3350
|
-
<em class="parameter"><code>const <a href="../glib
|
3351
|
-
<em class="parameter"><code><a href="../glib
|
3349
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> source_specific</code></em>,
|
3350
|
+
<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *iface</code></em>,
|
3351
|
+
<em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
3352
3352
|
<p>Removes <em class="parameter"><code>socket</code></em>
|
3353
3353
|
from the multicast group defined by <em class="parameter"><code>group</code></em>
|
3354
3354
|
, <em class="parameter"><code>iface</code></em>
|
@@ -3360,7 +3360,7 @@ when you joined the group).</p>
|
|
3360
3360
|
remains bound to its address and port, and can still receive
|
3361
3361
|
unicast messages after calling this.</p>
|
3362
3362
|
<div class="refsect3">
|
3363
|
-
<a name="
|
3363
|
+
<a name="g-socket-leave-multicast-group.parameters"></a><h4>Parameters</h4>
|
3364
3364
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3365
3365
|
<colgroup>
|
3366
3366
|
<col width="150px" class="parameters_name">
|
@@ -3385,34 +3385,34 @@ unicast messages after calling this.</p>
|
|
3385
3385
|
</tr>
|
3386
3386
|
<tr>
|
3387
3387
|
<td class="parameter_name"><p>source_specific</p></td>
|
3388
|
-
<td class="parameter_description"><p><a href="../glib
|
3388
|
+
<td class="parameter_description"><p><a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if source-specific multicast was used</p></td>
|
3389
3389
|
<td class="parameter_annotations"> </td>
|
3390
3390
|
</tr>
|
3391
3391
|
<tr>
|
3392
3392
|
<td class="parameter_name"><p>error</p></td>
|
3393
|
-
<td class="parameter_description"><p><a href="../glib
|
3393
|
+
<td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
|
3394
3394
|
<td class="parameter_annotations"> </td>
|
3395
3395
|
</tr>
|
3396
3396
|
</tbody>
|
3397
3397
|
</table></div>
|
3398
3398
|
</div>
|
3399
3399
|
<div class="refsect3">
|
3400
|
-
<a name="
|
3401
|
-
<p> <a href="../glib
|
3400
|
+
<a name="g-socket-leave-multicast-group.returns"></a><h4>Returns</h4>
|
3401
|
+
<p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.</p>
|
3402
3402
|
</div>
|
3403
3403
|
<p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
|
3404
3404
|
</div>
|
3405
3405
|
<hr>
|
3406
3406
|
<div class="refsect2">
|
3407
3407
|
<a name="g-socket-get-multicast-loopback"></a><h3>g_socket_get_multicast_loopback ()</h3>
|
3408
|
-
<pre class="programlisting"><a href="../glib
|
3408
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
3409
3409
|
g_socket_get_multicast_loopback (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
3410
3410
|
<p>Gets the multicast loopback setting on <em class="parameter"><code>socket</code></em>
|
3411
|
-
; if <a href="../glib
|
3411
|
+
; if <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> (the
|
3412
3412
|
default), outgoing multicast packets will be looped back to
|
3413
3413
|
multicast listeners on the same host.</p>
|
3414
3414
|
<div class="refsect3">
|
3415
|
-
<a name="
|
3415
|
+
<a name="g-socket-get-multicast-loopback.parameters"></a><h4>Parameters</h4>
|
3416
3416
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3417
3417
|
<colgroup>
|
3418
3418
|
<col width="150px" class="parameters_name">
|
@@ -3427,7 +3427,7 @@ multicast listeners on the same host.</p>
|
|
3427
3427
|
</table></div>
|
3428
3428
|
</div>
|
3429
3429
|
<div class="refsect3">
|
3430
|
-
<a name="
|
3430
|
+
<a name="g-socket-get-multicast-loopback.returns"></a><h4>Returns</h4>
|
3431
3431
|
<p> the multicast loopback setting on <em class="parameter"><code>socket</code></em>
|
3432
3432
|
</p>
|
3433
3433
|
</div>
|
@@ -3438,12 +3438,12 @@ multicast listeners on the same host.</p>
|
|
3438
3438
|
<a name="g-socket-set-multicast-loopback"></a><h3>g_socket_set_multicast_loopback ()</h3>
|
3439
3439
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
3440
3440
|
g_socket_set_multicast_loopback (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3441
|
-
<em class="parameter"><code><a href="../glib
|
3441
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> loopback</code></em>);</pre>
|
3442
3442
|
<p>Sets whether outgoing multicast packets will be received by sockets
|
3443
|
-
listening on that multicast address on the same host. This is <a href="../glib
|
3443
|
+
listening on that multicast address on the same host. This is <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
|
3444
3444
|
by default.</p>
|
3445
3445
|
<div class="refsect3">
|
3446
|
-
<a name="
|
3446
|
+
<a name="g-socket-set-multicast-loopback.parameters"></a><h4>Parameters</h4>
|
3447
3447
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3448
3448
|
<colgroup>
|
3449
3449
|
<col width="150px" class="parameters_name">
|
@@ -3471,13 +3471,13 @@ multicast groups from the local host</p></td>
|
|
3471
3471
|
<hr>
|
3472
3472
|
<div class="refsect2">
|
3473
3473
|
<a name="g-socket-get-multicast-ttl"></a><h3>g_socket_get_multicast_ttl ()</h3>
|
3474
|
-
<pre class="programlisting"><a href="../glib
|
3474
|
+
<pre class="programlisting"><a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
|
3475
3475
|
g_socket_get_multicast_ttl (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>);</pre>
|
3476
3476
|
<p>Gets the multicast time-to-live setting on <em class="parameter"><code>socket</code></em>
|
3477
3477
|
; see
|
3478
3478
|
<a class="link" href="GSocket.html#g-socket-set-multicast-ttl" title="g_socket_set_multicast_ttl ()"><code class="function">g_socket_set_multicast_ttl()</code></a> for more details.</p>
|
3479
3479
|
<div class="refsect3">
|
3480
|
-
<a name="
|
3480
|
+
<a name="g-socket-get-multicast-ttl.parameters"></a><h4>Parameters</h4>
|
3481
3481
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3482
3482
|
<colgroup>
|
3483
3483
|
<col width="150px" class="parameters_name">
|
@@ -3492,7 +3492,7 @@ g_socket_get_multicast_ttl (<em class="parameter"><code><a class="link" href="GS
|
|
3492
3492
|
</table></div>
|
3493
3493
|
</div>
|
3494
3494
|
<div class="refsect3">
|
3495
|
-
<a name="
|
3495
|
+
<a name="g-socket-get-multicast-ttl.returns"></a><h4>Returns</h4>
|
3496
3496
|
<p> the multicast time-to-live setting on <em class="parameter"><code>socket</code></em>
|
3497
3497
|
</p>
|
3498
3498
|
</div>
|
@@ -3503,13 +3503,13 @@ g_socket_get_multicast_ttl (<em class="parameter"><code><a class="link" href="GS
|
|
3503
3503
|
<a name="g-socket-set-multicast-ttl"></a><h3>g_socket_set_multicast_ttl ()</h3>
|
3504
3504
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
3505
3505
|
g_socket_set_multicast_ttl (<em class="parameter"><code><a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a> *socket</code></em>,
|
3506
|
-
<em class="parameter"><code><a href="../glib
|
3506
|
+
<em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> ttl</code></em>);</pre>
|
3507
3507
|
<p>Sets the time-to-live for outgoing multicast datagrams on <em class="parameter"><code>socket</code></em>
|
3508
3508
|
.
|
3509
3509
|
By default, this is 1, meaning that multicast packets will not leave
|
3510
3510
|
the local network.</p>
|
3511
3511
|
<div class="refsect3">
|
3512
|
-
<a name="
|
3512
|
+
<a name="g-socket-set-multicast-ttl.parameters"></a><h4>Parameters</h4>
|
3513
3513
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3514
3514
|
<colgroup>
|
3515
3515
|
<col width="150px" class="parameters_name">
|
@@ -3548,7 +3548,7 @@ the local network.</p>
|
|
3548
3548
|
<p>Flags used when creating a <a class="link" href="GSocket.html" title="GSocket"><span class="type">GSocket</span></a>. Some protocols may not implement
|
3549
3549
|
all the socket types.</p>
|
3550
3550
|
<div class="refsect3">
|
3551
|
-
<a name="
|
3551
|
+
<a name="GSocketType.members"></a><h4>Members</h4>
|
3552
3552
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3553
3553
|
<colgroup>
|
3554
3554
|
<col width="300px" class="enum_members_name">
|
@@ -3601,7 +3601,7 @@ the particular family/type.</p>
|
|
3601
3601
|
can also pass any other identifiers handled by the platform in order to
|
3602
3602
|
use protocols not listed here.</p>
|
3603
3603
|
<div class="refsect3">
|
3604
|
-
<a name="
|
3604
|
+
<a name="GSocketProtocol.members"></a><h4>Members</h4>
|
3605
3605
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3606
3606
|
<colgroup>
|
3607
3607
|
<col width="300px" class="enum_members_name">
|
@@ -3658,7 +3658,7 @@ values used for them are the same as on the platform, and any other flags
|
|
3658
3658
|
are passed in/out as is. So to use a platform specific flag, just include
|
3659
3659
|
the right system header and pass in the flag.</p>
|
3660
3660
|
<div class="refsect3">
|
3661
|
-
<a name="
|
3661
|
+
<a name="GSocketMsgFlags.members"></a><h4>Members</h4>
|
3662
3662
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3663
3663
|
<colgroup>
|
3664
3664
|
<col width="300px" class="enum_members_name">
|
@@ -3714,7 +3714,7 @@ You generally pass in an array of <a href="GSocket.html#GInputVector"><span clas
|
|
3714
3714
|
and the operation will store the read data starting in the
|
3715
3715
|
first buffer, switching to the next as needed.</p>
|
3716
3716
|
<div class="refsect3">
|
3717
|
-
<a name="
|
3717
|
+
<a name="GInputVector.members"></a><h4>Members</h4>
|
3718
3718
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3719
3719
|
<colgroup>
|
3720
3720
|
<col width="300px" class="struct_members_name">
|
@@ -3723,12 +3723,12 @@ first buffer, switching to the next as needed.</p>
|
|
3723
3723
|
</colgroup>
|
3724
3724
|
<tbody>
|
3725
3725
|
<tr>
|
3726
|
-
<td class="struct_member_name"><p><a href="../glib
|
3726
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GInputVector.buffer"></a>buffer</code></em>;</p></td>
|
3727
3727
|
<td class="struct_member_description"><p>Pointer to a buffer where data will be written.</p></td>
|
3728
3728
|
<td class="struct_member_annotations"> </td>
|
3729
3729
|
</tr>
|
3730
3730
|
<tr>
|
3731
|
-
<td class="struct_member_name"><p><a href="../glib
|
3731
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> <em class="structfield"><code><a name="GInputVector.size"></a>size</code></em>;</p></td>
|
3732
3732
|
<td class="struct_member_description"><p>the available size in <em class="parameter"><code>buffer</code></em>
|
3733
3733
|
.</p></td>
|
3734
3734
|
<td class="struct_member_annotations"> </td>
|
@@ -3763,10 +3763,10 @@ received across all <a href="GSocket.html#GInputVector"><span class="type">GInpu
|
|
3763
3763
|
<p>This structure closely mirrors <code class="literal">struct mmsghdr</code> and <code class="literal">struct msghdr</code> from
|
3764
3764
|
the POSIX sockets API (see <code class="literal">man 2 recvmmsg</code>).</p>
|
3765
3765
|
<p>If <em class="parameter"><code>address</code></em>
|
3766
|
-
is non-<a href="../glib
|
3766
|
+
is non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is set to the source address the message
|
3767
3767
|
was received from, and the caller must free it afterwards.</p>
|
3768
3768
|
<p>If <em class="parameter"><code>control_messages</code></em>
|
3769
|
-
is non-<a href="../glib
|
3769
|
+
is non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is set to an array of control
|
3770
3770
|
messages received with the message (if any), and the caller must free it
|
3771
3771
|
afterwards. <em class="parameter"><code>num_control_messages</code></em>
|
3772
3772
|
is set to the number of elements in
|
@@ -3775,7 +3775,7 @@ this array, which may be zero.</p>
|
|
3775
3775
|
. For example,
|
3776
3776
|
<code class="literal">MSG_EOR</code> or <code class="literal">MSG_TRUNC</code>.</p>
|
3777
3777
|
<div class="refsect3">
|
3778
|
-
<a name="
|
3778
|
+
<a name="GInputMessage.members"></a><h4>Members</h4>
|
3779
3779
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3780
3780
|
<colgroup>
|
3781
3781
|
<col width="300px" class="struct_members_name">
|
@@ -3786,7 +3786,7 @@ this array, which may be zero.</p>
|
|
3786
3786
|
<tr>
|
3787
3787
|
<td class="struct_member_name"><p><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> **<em class="structfield"><code><a name="GInputMessage.address"></a>address</code></em>;</p></td>
|
3788
3788
|
<td class="struct_member_description"><p> return location
|
3789
|
-
for a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib
|
3789
|
+
for a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
3790
3790
|
<td class="struct_member_annotations"><span class="annotation">[<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
|
3791
3791
|
</tr>
|
3792
3792
|
<tr>
|
@@ -3796,19 +3796,19 @@ array of input vectors. </p></td>
|
|
3796
3796
|
<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_vectors][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
3797
3797
|
</tr>
|
3798
3798
|
<tr>
|
3799
|
-
<td class="struct_member_name"><p><a href="../glib
|
3799
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GInputMessage.num-vectors"></a>num_vectors</code></em>;</p></td>
|
3800
3800
|
<td class="struct_member_description"><p>the number of input vectors pointed to by <em class="parameter"><code>vectors</code></em>
|
3801
3801
|
</p></td>
|
3802
3802
|
<td class="struct_member_annotations"> </td>
|
3803
3803
|
</tr>
|
3804
3804
|
<tr>
|
3805
|
-
<td class="struct_member_name"><p><a href="../glib
|
3805
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> <em class="structfield"><code><a name="GInputMessage.bytes-received"></a>bytes_received</code></em>;</p></td>
|
3806
3806
|
<td class="struct_member_description"><p> will be set to the number of bytes that have been
|
3807
3807
|
received. </p></td>
|
3808
3808
|
<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
3809
3809
|
</tr>
|
3810
3810
|
<tr>
|
3811
|
-
<td class="struct_member_name"><p><a href="../glib
|
3811
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GInputMessage.flags"></a>flags</code></em>;</p></td>
|
3812
3812
|
<td class="struct_member_description"><p> collection of <a class="link" href="GSocket.html#GSocketMsgFlags" title="enum GSocketMsgFlags"><span class="type">GSocketMsgFlags</span></a> for the received message,
|
3813
3813
|
outputted by the call. </p></td>
|
3814
3814
|
<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
@@ -3817,11 +3817,11 @@ outputted by the call. </p></td>
|
|
3817
3817
|
<td class="struct_member_name"><p><a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> ***<em class="structfield"><code><a name="GInputMessage.control-messages"></a>control_messages</code></em>;</p></td>
|
3818
3818
|
<td class="struct_member_description"><p>(array length=num_control_messages) (optional)
|
3819
3819
|
(out) (transfer full): return location for a
|
3820
|
-
caller-allocated array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib
|
3820
|
+
caller-allocated array of <a href="GSocketControlMessage.html#GSocketControlMessage-struct"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
3821
3821
|
<td class="struct_member_annotations"> </td>
|
3822
3822
|
</tr>
|
3823
3823
|
<tr>
|
3824
|
-
<td class="struct_member_name"><p><a href="../glib
|
3824
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> *<em class="structfield"><code><a name="GInputMessage.num-control-messages"></a>num_control_messages</code></em>;</p></td>
|
3825
3825
|
<td class="struct_member_description"><p> return location for the number of
|
3826
3826
|
elements in <em class="parameter"><code>control_messages</code></em>
|
3827
3827
|
. </p></td>
|
@@ -3845,7 +3845,7 @@ You generally pass in an array of <a href="GSocket.html#GOutputVector"><span cla
|
|
3845
3845
|
and the operation will use all the buffers as if they were
|
3846
3846
|
one buffer.</p>
|
3847
3847
|
<div class="refsect3">
|
3848
|
-
<a name="
|
3848
|
+
<a name="GOutputVector.members"></a><h4>Members</h4>
|
3849
3849
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3850
3850
|
<colgroup>
|
3851
3851
|
<col width="300px" class="struct_members_name">
|
@@ -3854,12 +3854,12 @@ one buffer.</p>
|
|
3854
3854
|
</colgroup>
|
3855
3855
|
<tbody>
|
3856
3856
|
<tr>
|
3857
|
-
<td class="struct_member_name"><p><a href="../glib
|
3857
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> <em class="structfield"><code><a name="GOutputVector.buffer"></a>buffer</code></em>;</p></td>
|
3858
3858
|
<td class="struct_member_description"><p>Pointer to a buffer of data to read.</p></td>
|
3859
3859
|
<td class="struct_member_annotations"> </td>
|
3860
3860
|
</tr>
|
3861
3861
|
<tr>
|
3862
|
-
<td class="struct_member_name"><p><a href="../glib
|
3862
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> <em class="structfield"><code><a name="GOutputVector.size"></a>size</code></em>;</p></td>
|
3863
3863
|
<td class="struct_member_description"><p>the size of <em class="parameter"><code>buffer</code></em>
|
3864
3864
|
.</p></td>
|
3865
3865
|
<td class="struct_member_annotations"> </td>
|
@@ -3889,10 +3889,10 @@ messages or packets in one go. You generally pass in an array of
|
|
3889
3889
|
<a href="GSocket.html#GOutputVector"><span class="type">GOutputVectors</span></a> and the operation will use all the buffers as if they
|
3890
3890
|
were one buffer.</p>
|
3891
3891
|
<p>If <em class="parameter"><code>address</code></em>
|
3892
|
-
is <a href="../glib
|
3892
|
+
is <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the message is sent to the default receiver
|
3893
3893
|
(as previously set by <a class="link" href="GSocket.html#g-socket-connect" title="g_socket_connect ()"><code class="function">g_socket_connect()</code></a>).</p>
|
3894
3894
|
<div class="refsect3">
|
3895
|
-
<a name="
|
3895
|
+
<a name="GOutputMessage.members"></a><h4>Members</h4>
|
3896
3896
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
3897
3897
|
<colgroup>
|
3898
3898
|
<col width="300px" class="struct_members_name">
|
@@ -3902,7 +3902,7 @@ were one buffer.</p>
|
|
3902
3902
|
<tbody>
|
3903
3903
|
<tr>
|
3904
3904
|
<td class="struct_member_name"><p><a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *<em class="structfield"><code><a name="GOutputMessage.address"></a>address</code></em>;</p></td>
|
3905
|
-
<td class="struct_member_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib
|
3905
|
+
<td class="struct_member_description"><p> a <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
3906
3906
|
<td class="struct_member_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
3907
3907
|
</tr>
|
3908
3908
|
<tr>
|
@@ -3911,13 +3911,13 @@ were one buffer.</p>
|
|
3911
3911
|
<td class="struct_member_annotations"> </td>
|
3912
3912
|
</tr>
|
3913
3913
|
<tr>
|
3914
|
-
<td class="struct_member_name"><p><a href="../glib
|
3914
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GOutputMessage.num-vectors"></a>num_vectors</code></em>;</p></td>
|
3915
3915
|
<td class="struct_member_description"><p>the number of output vectors pointed to by <em class="parameter"><code>vectors</code></em>
|
3916
3916
|
.</p></td>
|
3917
3917
|
<td class="struct_member_annotations"> </td>
|
3918
3918
|
</tr>
|
3919
3919
|
<tr>
|
3920
|
-
<td class="struct_member_name"><p><a href="../glib
|
3920
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GOutputMessage.bytes-sent"></a>bytes_sent</code></em>;</p></td>
|
3921
3921
|
<td class="struct_member_description"><p>initialize to 0. Will be set to the number of bytes
|
3922
3922
|
that have been sent</p></td>
|
3923
3923
|
<td class="struct_member_annotations"> </td>
|
@@ -3925,11 +3925,11 @@ that have been sent</p></td>
|
|
3925
3925
|
<tr>
|
3926
3926
|
<td class="struct_member_name"><p><a class="link" href="GSocketControlMessage.html" title="GSocketControlMessage"><span class="type">GSocketControlMessage</span></a> **<em class="structfield"><code><a name="GOutputMessage.control-messages"></a>control_messages</code></em>;</p></td>
|
3927
3927
|
<td class="struct_member_description"><p> a pointer
|
3928
|
-
to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib
|
3928
|
+
to an array of <a href="GSocketControlMessage.html#GSocketControlMessage-struct"><span class="type">GSocketControlMessages</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
3929
3929
|
<td class="struct_member_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_control_messages][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
3930
3930
|
</tr>
|
3931
3931
|
<tr>
|
3932
|
-
<td class="struct_member_name"><p><a href="../glib
|
3932
|
+
<td class="struct_member_name"><p><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GOutputMessage.num-control-messages"></a>num_control_messages</code></em>;</p></td>
|
3933
3933
|
<td class="struct_member_description"><p>number of elements in <em class="parameter"><code>control_messages</code></em>
|
3934
3934
|
.</p></td>
|
3935
3935
|
<td class="struct_member_annotations"> </td>
|
@@ -3944,7 +3944,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
3944
3944
|
<a name="GSocket.property-details"></a><h2>Property Details</h2>
|
3945
3945
|
<div class="refsect2">
|
3946
3946
|
<a name="GSocket--blocking"></a><h3>The <code class="literal">“blocking”</code> property</h3>
|
3947
|
-
<pre class="programlisting"> “blocking” <a href="../glib
|
3947
|
+
<pre class="programlisting"> “blocking” <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
3948
3948
|
<p>Whether or not I/O on this socket is blocking.</p>
|
3949
3949
|
<p>Flags: Read / Write</p>
|
3950
3950
|
<p>Default value: TRUE</p>
|
@@ -3952,7 +3952,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
3952
3952
|
<hr>
|
3953
3953
|
<div class="refsect2">
|
3954
3954
|
<a name="GSocket--broadcast"></a><h3>The <code class="literal">“broadcast”</code> property</h3>
|
3955
|
-
<pre class="programlisting"> “broadcast” <a href="../glib
|
3955
|
+
<pre class="programlisting"> “broadcast” <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
3956
3956
|
<p>Whether the socket should allow sending to broadcast addresses.</p>
|
3957
3957
|
<p>Flags: Read / Write</p>
|
3958
3958
|
<p>Default value: FALSE</p>
|
@@ -3969,7 +3969,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
3969
3969
|
<hr>
|
3970
3970
|
<div class="refsect2">
|
3971
3971
|
<a name="GSocket--fd"></a><h3>The <code class="literal">“fd”</code> property</h3>
|
3972
|
-
<pre class="programlisting"> “fd” <a href="../glib
|
3972
|
+
<pre class="programlisting"> “fd” <a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
|
3973
3973
|
<p>The sockets file descriptor.</p>
|
3974
3974
|
<p>Flags: Read / Write / Construct Only</p>
|
3975
3975
|
<p>Default value: -1</p>
|
@@ -3977,7 +3977,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
3977
3977
|
<hr>
|
3978
3978
|
<div class="refsect2">
|
3979
3979
|
<a name="GSocket--keepalive"></a><h3>The <code class="literal">“keepalive”</code> property</h3>
|
3980
|
-
<pre class="programlisting"> “keepalive” <a href="../glib
|
3980
|
+
<pre class="programlisting"> “keepalive” <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
3981
3981
|
<p>Keep connection alive by sending periodic pings.</p>
|
3982
3982
|
<p>Flags: Read / Write</p>
|
3983
3983
|
<p>Default value: FALSE</p>
|
@@ -3985,7 +3985,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
3985
3985
|
<hr>
|
3986
3986
|
<div class="refsect2">
|
3987
3987
|
<a name="GSocket--listen-backlog"></a><h3>The <code class="literal">“listen-backlog”</code> property</h3>
|
3988
|
-
<pre class="programlisting"> “listen-backlog” <a href="../glib
|
3988
|
+
<pre class="programlisting"> “listen-backlog” <a href="../glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
|
3989
3989
|
<p>Outstanding connections in the listen queue.</p>
|
3990
3990
|
<p>Flags: Read / Write</p>
|
3991
3991
|
<p>Allowed values: [0,128]</p>
|
@@ -4001,7 +4001,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
4001
4001
|
<hr>
|
4002
4002
|
<div class="refsect2">
|
4003
4003
|
<a name="GSocket--multicast-loopback"></a><h3>The <code class="literal">“multicast-loopback”</code> property</h3>
|
4004
|
-
<pre class="programlisting"> “multicast-loopback” <a href="../glib
|
4004
|
+
<pre class="programlisting"> “multicast-loopback” <a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
4005
4005
|
<p>Whether outgoing multicast packets loop back to the local host.</p>
|
4006
4006
|
<p>Flags: Read / Write</p>
|
4007
4007
|
<p>Default value: TRUE</p>
|
@@ -4010,7 +4010,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
4010
4010
|
<hr>
|
4011
4011
|
<div class="refsect2">
|
4012
4012
|
<a name="GSocket--multicast-ttl"></a><h3>The <code class="literal">“multicast-ttl”</code> property</h3>
|
4013
|
-
<pre class="programlisting"> “multicast-ttl” <a href="../glib
|
4013
|
+
<pre class="programlisting"> “multicast-ttl” <a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
|
4014
4014
|
<p>Time-to-live out outgoing multicast packets</p>
|
4015
4015
|
<p>Flags: Read / Write</p>
|
4016
4016
|
<p>Default value: 1</p>
|
@@ -4034,7 +4034,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
4034
4034
|
<hr>
|
4035
4035
|
<div class="refsect2">
|
4036
4036
|
<a name="GSocket--timeout"></a><h3>The <code class="literal">“timeout”</code> property</h3>
|
4037
|
-
<pre class="programlisting"> “timeout” <a href="../glib
|
4037
|
+
<pre class="programlisting"> “timeout” <a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
|
4038
4038
|
<p>The timeout in seconds on socket I/O</p>
|
4039
4039
|
<p>Flags: Read / Write</p>
|
4040
4040
|
<p>Default value: 0</p>
|
@@ -4043,7 +4043,7 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
4043
4043
|
<hr>
|
4044
4044
|
<div class="refsect2">
|
4045
4045
|
<a name="GSocket--ttl"></a><h3>The <code class="literal">“ttl”</code> property</h3>
|
4046
|
-
<pre class="programlisting"> “ttl” <a href="../glib
|
4046
|
+
<pre class="programlisting"> “ttl” <a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
|
4047
4047
|
<p>Time-to-live for outgoing unicast packets</p>
|
4048
4048
|
<p>Flags: Read / Write</p>
|
4049
4049
|
<p>Default value: 0</p>
|
@@ -4064,6 +4064,6 @@ to an array of <a href="GSocketControlMessage.html"><span class="type">GSocketCo
|
|
4064
4064
|
</div>
|
4065
4065
|
</div>
|
4066
4066
|
<div class="footer">
|
4067
|
-
<hr>Generated by GTK-Doc V1.
|
4067
|
+
<hr>Generated by GTK-Doc V1.25.1</div>
|
4068
4068
|
</body>
|
4069
4069
|
</html>
|