From 1715aae46953e1e7571258f1fb7a95416e509845 Mon Sep 17 00:00:00 2001 From: Kjell Ahlstedt Date: Mon, 18 Mar 2019 12:48:01 +0100 Subject: Glib, Gio: Regenerate docs.xml and .defs files --- gio/src/gio_docs.xml | 5160 ++++++++++++--------------------------- gio/src/gio_enums.defs | 57 +- gio/src/gio_methods.defs | 2147 ++++++---------- gio/src/gio_signals.defs | 58 +- glib/src/glib_docs.xml | 2487 +++++++++++++++---- glib/src/glib_enums.defs | 18 +- glib/src/glib_functions.defs | 398 ++- glib/src/gmodule_functions.defs | 8 +- glib/src/gobject_functions.defs | 50 +- 9 files changed, 4850 insertions(+), 5533 deletions(-) diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml index b55b91b8..37cc29a5 100644 --- a/gio/src/gio_docs.xml +++ b/gio/src/gio_docs.xml @@ -333,6 +333,28 @@ the default option processing continue. + + +The ::name-lost signal is emitted only on the registered primary instance +when a new instance has taken over. This can only happen if the application +is using the %G_APPLICATION_ALLOW_REPLACEMENT flag. + +The default handler for this signal calls g_application_quit(). + +Since: 2.60 + + + + + the application + + + + %TRUE if the signal has been handled + + + + The ::open signal is emitted on the primary instance when there are @@ -464,6 +486,17 @@ application ID from the command line with `--gapplication-app-id`. Since: 2.48 + + Allow another instance to take over +the bus name. Since: 2.60 + + + + Take over from another instance. This flag is +usually set by passing `--gapplication-replace` on the commandline. +Since: 2.60 + + @@ -495,6 +528,10 @@ situation. operation supports anonymous users. + + operation takes TCRYPT parameters (Since: 2.58) + + @@ -1660,7 +1697,7 @@ Since: 2.30 - A #GVariant containing the properties that changed. + A #GVariant containing the properties that changed (type: `a{sv}`). @@ -1949,7 +1986,7 @@ Since: 2.26 - A #GVariant containing the properties that changed + A #GVariant containing the properties that changed (type: `a{sv}`) @@ -2614,8 +2651,8 @@ the user before returning from the signal handler. If you want to let the user decide whether or not to accept the certificate, you would have to return %FALSE from the signal handler on the first attempt, and then after the connection attempt returns a -%G_TLS_ERROR_HANDSHAKE, you can interact with the user, and if -the user decides to accept the certificate, remember that fact, +%G_TLS_ERROR_BAD_CERTIFICATE, you can interact with the user, and +if the user decides to accept the certificate, remember that fact, create a new connection, and return %TRUE from the signal handler the next time. @@ -2648,6 +2685,17 @@ no one else overrides it. + + +The list of application-layer protocols that the connection +advertises that it is willing to speak. See +g_dtls_connection_set_advertised_protocols(). + +Since: 2.60 + + + + The #GDatagramBased that the connection wraps. Note that this may be any @@ -2690,6 +2738,16 @@ Since: 2.48 + + +The application-layer protocol negotiated during the TLS +handshake. See g_dtls_connection_get_negotiated_protocol(). + +Since: 2.60 + + + + The connection's peer's certificate, after the TLS handshake has @@ -2726,6 +2784,10 @@ g_dtls_connection_set_rehandshake_mode(). Since: 2.48 +Deprecated: 2.60. Changing the rehandshake mode is no longer +required for compatibility. Also, rehandshaking has been removed +from the TLS protocol in TLS 1.3. + @@ -3233,6 +3295,9 @@ if (g_error_matches (error, G_IO_ERROR, G_IO_ERROR_FAILED)) but should instead treat all unrecognized error codes the same as #G_IO_ERROR_FAILED. +See also #GPollableReturn for a cheaper way of returning +%G_IO_ERROR_WOULD_BLOCK to callers without allocating a #GError. + @@ -3603,6 +3668,45 @@ Since: 2.32 + + +The directory where the system defaults and locks are located. + +Defaults to `/etc/glib-2.0/settings`. + + + + + + +The location where the settings are stored on disk. + +Defaults to `$XDG_CONFIG_HOME/glib-2.0/settings/keyfile`. + + + + + + +If @root_group is non-%NULL then it specifies the name of the keyfile +group used for keys that are written directly below the root path. + +Defaults to NULL. + + + + + + +All settings read to or written from the backend must fall under the +path given in @root_path (which must start and end with a slash and +not contain two consecutive slashes). @root_path may be "/". + +Defaults to "/". + + + + This signal is emitted whenever items were added or removed to @@ -4000,6 +4104,29 @@ The domain to use for the mount operation. + + +Whether the device to be unlocked is a TCRYPT hidden volume. +See [the VeraCrypt documentation](https://www.veracrypt.fr/en/Hidden%20Volume.html). + +Since: 2.58 + + + + + + +Whether the device to be unlocked is a TCRYPT system volume. +In this context, a system volume is a volume with a bootloader +and operating system installed. This is only supported for Windows +operating systems. For further documentation, see +[the VeraCrypt documentation](https://www.veracrypt.fr/en/System%20Encryption.html). + +Since: 2.58 + + + + The password that is used for authentication when carrying out @@ -4015,6 +4142,16 @@ Determines if and how the password information should be saved. + + +The VeraCrypt PIM value, when unlocking a VeraCrypt volume. See +[the VeraCrypt documentation](https://www.veracrypt.fr/en/Personal%20Iterations%20Multiplier%20(PIM).html). + +Since: 2.58 + + + + The user name that is used for authentication when carrying out @@ -4286,6 +4423,37 @@ g_permission_release(). + + +Return value for various IO operations that signal errors via the +return value and not necessarily via a #GError. + +This enum exists to be able to return errors to callers without having to +allocate a #GError. Allocating #GErrors can be quite expensive for +regularly happening errors like %G_IO_ERROR_WOULD_BLOCK. + +In case of %G_POLLABLE_RETURN_FAILED a #GError should be set for the +operation to give details about the error that happened. + +Since: 2.60 + + + + + Generic error condition for when an operation fails. + + + + The operation was successfully finished. + + + + The operation would block. + + + + + If @action is currently enabled. @@ -4450,6 +4618,29 @@ be looked up due to a network error or similar problem + + +Flags to modify lookup behavior. + +Since: 2.60 + + + + + default behavior (same as g_resolver_lookup_by_name()) + + + + only resolve ipv4 addresses + + + + only resolve ipv6 addresses + + + + + The type of record that g_resolver_lookup_records() or @@ -4803,8 +4994,9 @@ be booleans. You cannot pass this flag to g_settings_bind_with_mapping(). Indicates that the action was just activated. -@parameter will always be of the expected type. In the event that -an incorrect type was given, no signal will be emitted. +@parameter will always be of the expected type, i.e. the parameter type +specified when the action was created. If an incorrect type is given when +activating the action, this signal is not emitted. Since GLib 2.40, if no handler is connected to this signal then the default behaviour for boolean-stated actions with a %NULL parameter @@ -4823,7 +5015,8 @@ Since: 2.28 - the parameter to the activation + the parameter to the activation, or %NULL if it has +no parameter @@ -4835,8 +5028,10 @@ Since: 2.28 Indicates that the action just received a request to change its state. -@value will always be of the correct state type. In the event that -an incorrect type was given, no signal will be emitted. +@value will always be of the correct state type, i.e. the type of the +initial state passed to g_simple_action_new_stateful(). If an incorrect +type is given when requesting to change the state, this signal is not +emitted. If no handler is connected to this signal then the default behaviour is to call g_simple_action_set_state() to set the state @@ -5791,14 +5986,7 @@ Since: 2.28 If %TRUE, forces the connection to use a fallback version of TLS or SSL, rather than trying to negotiate the best version of TLS -to use. This can be used when talking to servers that don't -implement version negotiation correctly and therefore refuse to -handshake at all with a modern TLS handshake. - -Despite the property name, the fallback version is usually not -SSL 3.0, because SSL 3.0 is generally disabled by the #GTlsBackend. -#GTlsClientConnection will use the next-highest available version -as the fallback version. +to use. See g_tls_client_connection_set_use_ssl3(). Since: 2.28 @@ -5847,8 +6035,8 @@ the user before returning from the signal handler. If you want to let the user decide whether or not to accept the certificate, you would have to return %FALSE from the signal handler on the first attempt, and then after the connection attempt returns a -%G_TLS_ERROR_HANDSHAKE, you can interact with the user, and if -the user decides to accept the certificate, remember that fact, +%G_TLS_ERROR_BAD_CERTIFICATE, you can interact with the user, and +if the user decides to accept the certificate, remember that fact, create a new connection, and return %TRUE from the signal handler the next time. @@ -5881,6 +6069,17 @@ no one else overrides it. + + +The list of application-layer protocols that the connection +advertises that it is willing to speak. See +g_tls_connection_set_advertised_protocols(). + +Since: 2.60 + + + + The #GIOStream that the connection wraps. The connection holds a reference @@ -5926,6 +6125,16 @@ Since: 2.30 + + +The application-layer protocol negotiated during the TLS +handshake. See g_tls_connection_get_negotiated_protocol(). + +Since: 2.60 + + + + The connection's peer's certificate, after the TLS handshake has @@ -6041,7 +6250,8 @@ Since: 2.28 - A certificate could not be parsed + The certificate presented could not +be parsed or failed validation. @@ -6066,6 +6276,12 @@ notice, which may indicate an attack. See g_tls_connection_set_require_close_notify(). + + The TLS handshake failed +because the client sent the fallback SCSV, indicating a protocol +downgrade attack. Since: 2.60 + + @@ -6144,6 +6360,10 @@ g_tls_connection_set_rehandshake_mode(). Since: 2.28 +Deprecated: 2.60. Changing the rehandshake mode is no longer +required for compatibility. Also, rehandshaking has been removed +from the TLS protocol in TLS 1.3. + @@ -6660,485 +6880,6 @@ Since: 2.46 - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_add() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddFull">AddFull()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_add_full() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_add_named() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_delete() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_get_mount_point() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_grant_permissions() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_info() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_list() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_lookup() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_documents_complete_revoke_permissions() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-Documents.version">"version"</link>. - -Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. - - - - - - -On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-freedesktop-portal-NetworkMonitor.changed">"changed"</link> is received. - -On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal. - - - - - A #GXdpNetworkMonitor. - - - - Argument. - - - - - - - - -Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.available">"available"</link>. - -Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. - - - - - - -Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.connectivity">"connectivity"</link>. - -Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. - - - - - - -Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.metered">"metered"</link>. - -Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. - - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenFile">OpenFile()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_open_uri_complete_open_file() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpOpenURI. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenURI">OpenURI()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_open_uri_complete_open_uri() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpOpenURI. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - - - -Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-OpenURI.version">"version"</link>. - -Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side. - - - - - - -Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</link> D-Bus method. - -If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call gxdp_proxy_resolver_complete_lookup() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned. - - - - - - A #GXdpProxyResolver. - - - - A #GDBusMethodInvocation. - - - - Argument passed by remote caller. - - - - %TRUE if the invocation was handled, %FALSE to let other signal handlers run. - - - If set to a non-%NULL #GFileInfo object, and #GZlibCompressor:format is @@ -8570,6 +8311,10 @@ registered to handle the specified uri. Synchronous I/O is done on the uri to detect the type of the file if required. +The D-Bus–activated applications don't have to be started if your application +terminates too soon after this function. To prevent this, use +g_app_info_launch_default_for_uri() instead. + @@ -8599,6 +8344,10 @@ error information in the case where the application is sandboxed and the portal may present an application chooser dialog to the user. +This is also useful if you want to be sure that the D-Bus–activated +applications are really started before termination and if you are interested +in receiving error information from their activation. + Since: 2.50 @@ -8616,7 +8365,7 @@ Since: 2.50 - a #GASyncReadyCallback to call when the request is done + a #GAsyncReadyCallback to call when the request is done @@ -8686,6 +8435,73 @@ no way to detect this. + + +Async version of g_app_info_launch_uris(). + +The @callback is invoked immediately after the application launch, but it +waits for activation in case of D-Bus–activated applications and also provides +extended error information for sandboxed applications, see notes for +g_app_info_launch_default_for_uri_async(). + +Since: 2.60 + + + + + a #GAppInfo + + + + a #GList containing URIs to launch. + + + + a #GAppLaunchContext or %NULL + + + + a #GCancellable + + + + a #GAsyncReadyCallback to call when the request is done + + + + data to pass to @callback + + + + + + + + +Finishes a g_app_info_launch_uris_async() operation. + +Since: 2.60 + + + + + a #GAppInfo + + + + a #GAsyncResult + + + + a #GError + + + + %TRUE on successful launch, %FALSE otherwise. + + + + Gets the #GAppInfoMonitor for the current thread-default main @@ -12093,7 +11909,7 @@ See also g_cancellable_make_pollfd(). - A valid file descriptor. %-1 if the file descriptor + A valid file descriptor. `-1` if the file descriptor is not supported, or on errors. @@ -12502,6 +12318,22 @@ object with g_object_unref() + + +Get the list of directories which MIME data is loaded from. See +g_content_type_set_mime_dirs() for details. + +Since: 2.60 + + + + + %NULL-terminated list of +directories to load MIME data from, including any `mime/` subdirectory, +and with the first directory to try listed first + + + Gets the mime type for the content type, if one is registered. @@ -12514,8 +12346,8 @@ Gets the mime type for the content type, if one is registered. - the registered mime type for the given @type, -or %NULL if unknown. + the registered mime type for the +given @type, or %NULL if unknown; free with g_free(). @@ -12665,11 +12497,51 @@ or octet-stream. + + +Set the list of directories used by GIO to load the MIME database. +If @dirs is %NULL, the directories used are the default: + +- the `mime` subdirectory of the directory in `$XDG_DATA_HOME` +- the `mime` subdirectory of every directory in `$XDG_DATA_DIRS` + +This function is intended to be used when writing tests that depend on +information stored in the MIME database, in order to control the data. + +Typically, in case your tests use %G_TEST_OPTION_ISOLATE_DIRS, but they +depend on the system’s MIME database, you should call this function +with @dirs set to %NULL before calling g_test_init(), for instance: + +|[<!-- language="C" --> +// Load MIME data from the system +g_content_type_set_mime_dirs (NULL); +// Isolate the environment +g_test_init (&argc, &argv, G_TEST_OPTION_ISOLATE_DIRS, NULL); + +… + +return g_test_run (); +]| + +Since: 2.60 + + + + + %NULL-terminated list of +directories to load MIME data from, including any `mime/` subdirectory, +and with the first directory to try listed first + + + + + + Gets a list of strings containing all the registered content types known to the system. The list and its data should be freed using -g_list_free_full (list, g_free). +`g_list_free_full (list, g_free)`. @@ -13185,7 +13057,7 @@ Reads an unsigned 8-bit/1-byte value from @stream. - an unsigned 8-bit/1-byte value read from the @stream or %0 + an unsigned 8-bit/1-byte value read from the @stream or `0` if an error occurred. @@ -13213,7 +13085,7 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( - a signed 16-bit/2-byte value read from @stream or %0 if + a signed 16-bit/2-byte value read from @stream or `0` if an error occurred. @@ -13245,7 +13117,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a signed 32-bit/4-byte value read from the @stream or %0 if + a signed 32-bit/4-byte value read from the @stream or `0` if an error occurred. @@ -13277,7 +13149,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a signed 64-bit/8-byte value read from @stream or %0 if + a signed 64-bit/8-byte value read from @stream or `0` if an error occurred. @@ -13495,7 +13367,7 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( - an unsigned 16-bit/2-byte value read from the @stream or %0 if + an unsigned 16-bit/2-byte value read from the @stream or `0` if an error occurred. @@ -13527,7 +13399,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - an unsigned 32-bit/4-byte value read from the @stream or %0 if + an unsigned 32-bit/4-byte value read from the @stream or `0` if an error occurred. @@ -13559,7 +13431,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - an unsigned 64-bit/8-byte read from @stream or %0 if + an unsigned 64-bit/8-byte read from @stream or `0` if an error occurred. @@ -14858,7 +14730,7 @@ If a filter consumes an incoming message the message is not dispatched anywhere else - not even the standard dispatch machinery (that API such as g_dbus_connection_signal_subscribe() and g_dbus_connection_send_message_with_reply() relies on) will see the -message. Similary, if a filter consumes an outgoing message, the +message. Similarly, if a filter consumes an outgoing message, the message will not be sent to the other peer. If @user_data_free_func is non-%NULL, it will be called (in the @@ -15386,7 +15258,7 @@ to g_dbus_connection_close() -Synchronously closees @connection. The calling thread is blocked +Synchronously closes @connection. The calling thread is blocked until this is done. See g_dbus_connection_close() for the asynchronous version of this method and more details about what it does. @@ -15691,6 +15563,24 @@ closed by the remote peer + + +Gets the flags used to construct this connection + +Since: 2.60 + + + + + a #GDBusConnection + + + + zero or more flags from the #GDBusConnectionFlags enumeration + + + + The GUID of the peer performing the role of server when @@ -16610,6 +16500,11 @@ needed. (It is not guaranteed to be called synchronously when the signal is unsubscribed from, and may be called after @connection has been destroyed.) +The returned subscription identifier is an opaque value which is guaranteed +to never be zero. + +This function can never fail. + Since: 2.26 @@ -17930,7 +17825,7 @@ Since: 2.26 - A blob represent a binary D-Bus message. + A blob representing a binary D-Bus message. @@ -18089,6 +17984,9 @@ Since: 2.26 Gets a header field on @message. +The caller is responsible for checking the type of the returned #GVariant +matches what is expected. + Since: 2.26 @@ -18367,12 +18265,15 @@ Creates a new #GDBusMessage from the data stored at @blob. The byte order that the message was in can be retrieved using g_dbus_message_get_byte_order(). +If the @blob cannot be parsed, contains invalid fields, or contains invalid +headers, %G_IO_ERROR_INVALID_ARGUMENT will be returned. + Since: 2.26 - A blob represent a binary D-Bus message. + A blob representing a binary D-Bus message. @@ -21077,6 +20978,10 @@ If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up match rules for signals. Connect to the #GDBusProxy::g-signal signal to handle signals from the remote object. +If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and +%G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is +guaranteed to complete immediately without blocking. + If @name is a well-known name and the %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION flags aren't set and no name owner currently exists, the message bus @@ -21291,6 +21196,10 @@ If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up match rules for signals. Connect to the #GDBusProxy::g-signal signal to handle signals from the remote object. +If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and +%G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is +guaranteed to return immediately without blocking. + If @name is a well-known name and the %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION flags aren't set and no name owner currently exists, the message bus @@ -21933,6 +21842,36 @@ is not found + + +Looks up a string list value in the keyfile backing @info. + +The @key is looked up in the "Desktop Entry" group. + +Since: 2.60.0 + + + + + a #GDesktopAppInfo + + + + the key to look up + + + + return location for the number of returned strings, or %NULL + + + + +a %NULL-terminated string array or %NULL if the specified +key cannot be found. The array should be freed with g_strfreev(). + + + + Returns whether @key exists in the "Desktop Entry" group @@ -22002,11 +21941,12 @@ but is intended primarily for operating system components that launch applications. Ordinary applications should use g_app_info_launch_uris(). -If the application is launched via traditional UNIX fork()/exec() -then @spawn_flags, @user_setup and @user_setup_data are used for the -call to g_spawn_async(). Additionally, @pid_callback (with -@pid_callback_data) will be called to inform about the PID of the -created process. +If the application is launched via GSpawn, then @spawn_flags, @user_setup +and @user_setup_data are used for the call to g_spawn_async(). +Additionally, @pid_callback (with @pid_callback_data) will be called to +inform about the PID of the created process. See g_spawn_async_with_pipes() +for information on certain parameter conditions that can enable an +optimized posix_spawn() codepath to be used. If application launching occurs via some other mechanism (eg: D-Bus activation) then @spawn_flags, @user_setup, @user_setup_data, @@ -22057,6 +21997,74 @@ for each process. + + +Equivalent to g_desktop_app_info_launch_uris_as_manager() but allows +you to pass in file descriptors for the stdin, stdout and stderr streams +of the launched process. + +If application launching occurs via some non-spawn mechanism (e.g. D-Bus +activation) then @stdin_fd, @stdout_fd and @stderr_fd are ignored. + +Since: 2.58 + + + + + a #GDesktopAppInfo + + + + List of URIs + + + + a #GAppLaunchContext + + + + #GSpawnFlags, used for each process + + + + a #GSpawnChildSetupFunc, used once +for each process. + + + + User data for @user_setup + + + + Callback for child processes + + + + User data for @callback + + + + file descriptor to use for child's stdin, or -1 + + + + file descriptor to use for child's stdout, or -1 + + + + file descriptor to use for child's stderr, or -1 + + + + return location for a #GError, or %NULL + + + + %TRUE on successful launch, %FALSE otherwise. + + + + Returns the list of "additional application actions" supported on the @@ -22130,7 +22138,8 @@ prefix-to-subdirectory mapping that is described in the - a new #GDesktopAppInfo, or %NULL if no desktop file with that id + a new #GDesktopAppInfo, or %NULL if no desktop +file with that id exists. @@ -22473,7 +22482,9 @@ Free the returned object with g_object_unref(). -Gets the identifier of the given kind for @drive. +Gets the identifier of the given kind for @drive. The only +identifier currently available is +#G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. @@ -22488,7 +22499,7 @@ Gets the identifier of the given kind for @drive. a newly allocated string containing the -requested identfier, or %NULL if the #GDrive +requested identifier, or %NULL if the #GDrive doesn't have this kind of identifier. @@ -23189,6 +23200,30 @@ Since: 2.48 + + +Gets the name of the application-layer protocol negotiated during +the handshake. + +If the peer did not use the ALPN extension, or did not advertise a +protocol that matched one of @conn's protocols, or the TLS backend +does not support ALPN, then this will be %NULL. See +g_dtls_connection_set_advertised_protocols(). + +Since: 2.60 + + + + + a #GDtlsConnection + + + + the negotiated protocol, or %NULL + + + + Gets @conn's peer's certificate after the handshake has completed. @@ -23287,8 +23322,15 @@ before or after completing the handshake). Likewise, on the server side, although a handshake is necessary at the beginning of the communication, you do not need to call this function explicitly unless you want clearer error reporting. -However, you may call g_dtls_connection_handshake() later on to -renegotiate parameters (encryption methods, etc) with the client. + +If TLS 1.2 or older is in use, you may call +g_dtls_connection_handshake() after the initial handshake to +rehandshake; however, this usage is deprecated because rehandshaking +is no longer part of the TLS protocol in TLS 1.3. Accordingly, the +behavior of calling this function after the initial handshake is now +undefined, except it is guaranteed to be reasonable and +nondestructive so as to preserve compatibility with code written for +older versions of GLib. #GDtlsConnection::accept_certificate may be emitted during the handshake. @@ -23376,6 +23418,36 @@ case @error will be set. + + +Sets the list of application-layer protocols to advertise that the +caller is willing to speak on this connection. The +Application-Layer Protocol Negotiation (ALPN) extension will be +used to negotiate a compatible protocol with the peer; use +g_dtls_connection_get_negotiated_protocol() to find the negotiated +protocol after the handshake. Specifying %NULL for the the value +of @protocols will disable ALPN negotiation. + +See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) +for a list of registered protocol IDs. + +Since: 2.60 + + + + + a #GDtlsConnection + + + + a %NULL-terminated +array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL + + + + + + This sets the certificate that @conn will present to its peer @@ -23490,6 +23562,10 @@ software. Since: 2.48 +Deprecated: 2.60. Changing the rehandshake mode is no longer +required for compatibility. Also, rehandshaking has been removed +from the TLS protocol in TLS 1.3. + @@ -24893,6 +24969,11 @@ Duplicates a #GFile handle. This operation does not duplicate the actual file or directory represented by the #GFile; see g_file_copy() if attempting to copy a file. +g_file_dup() is useful when a second handle is needed to the same underlying +file, for use in a separate thread (#GFile is not thread-safe). For use +within the same thread, use g_object_ref() to increment the existing object’s +reference count. + This call does no blocking I/O. @@ -26785,7 +26866,7 @@ Removes all cases of @attribute from @info if it exists. Sets the @attribute to contain the given value, if possible. To unset the -attribute, use %G_ATTRIBUTE_TYPE_INVALID for @type. +attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type. @@ -27015,7 +27096,8 @@ Sinze: 2.22 - a %NULL terminated array of UTF-8 strings. + a %NULL +terminated array of UTF-8 strings. @@ -27573,7 +27655,7 @@ Since: 2.22 Checks to see if a file is native to the platform. -A native file s one expressed in the platform-native filename format, +A native file is one expressed in the platform-native filename format, e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local, as it might be on a locally mounted remote filesystem. @@ -29236,6 +29318,62 @@ When you are done with it, release it with g_object_unref() + + +Async version of g_file_query_default_handler(). + +Since: 2.60 + + + + + a #GFile to open + + + + optional #GCancellable object, %NULL to ignore + + + + a #GAsyncReadyCallback to call when the request is done + + + + data to pass to @callback + + + + + + + + +Finishes a g_file_query_default_handler_async() operation. + +Since: 2.60 + + + + + a #GFile to open + + + + a #GAsyncResult + + + + a #GError + + + + a #GAppInfo if the handle was found, +%NULL if there were errors. +When you are done with it, release it with g_object_unref() + + + + Utility function to check if a particular file exists. This is @@ -31523,8 +31661,8 @@ if the #GFile for @icon is a native file. If the file is not native, the returned string is the result of g_file_get_uri() (such as `sftp://path/to/my%20icon.png`). -- If @icon is a #GThemedIcon with exactly one name, the encoding is -simply the name (such as `network-server`). +- If @icon is a #GThemedIcon with exactly one name and no fallbacks, +the encoding is simply the name (such as `network-server`). Virtual: to_tokens Since: 2.20 @@ -34152,6 +34290,11 @@ syntax of the key file format. For example, if you have '[' or ']' characters in your path names or '=' in your key names you may be in trouble. +The backend reads default values from a keyfile called `defaults` in +the directory specified by the #GKeyfileSettingsBackend:defaults-dir property, +and a list of locked keys from a text file with the name `locks` in +the same location. + @@ -36647,7 +36790,8 @@ using that object to get the #GDrive. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. + a #GDrive or %NULL if @mount is not +associated with a volume or a drive. The returned object should be unreffed with g_object_unref() when no longer needed. @@ -36760,7 +36904,8 @@ available. - the UUID for @mount or %NULL if no UUID can be computed. + the UUID for @mount or %NULL if no UUID +can be computed. The returned string should be freed with g_free() when no longer needed. @@ -36778,7 +36923,8 @@ Gets the volume for the @mount. - a #GVolume or %NULL if @mount is not associated with a volume. + a #GVolume or %NULL if @mount is not +associated with a volume. The returned object should be unreffed with g_object_unref() when no longer needed. @@ -36990,6 +37136,44 @@ Gets the domain of the mount operation. + + +Check to see whether the mount operation is being used +for a TCRYPT hidden volume. + +Since: 2.58 + + + + + a #GMountOperation. + + + + %TRUE if mount operation is for hidden volume. + + + + + + +Check to see whether the mount operation is being used +for a TCRYPT system volume. + +Since: 2.58 + + + + + a #GMountOperation. + + + + %TRUE if mount operation is for system volume. + + + + Gets a password from the mount operation. @@ -37022,6 +37206,24 @@ Gets the state of saving passwords for the mount operation. + + +Gets a PIM from the mount operation. + +Since: 2.58 + + + + + a #GMountOperation. + + + + The VeraCrypt PIM within @op. + + + + Get the user name from the mount operation. @@ -37122,6 +37324,46 @@ Sets the mount operation's domain. + + +Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE. + +Since: 2.58 + + + + + a #GMountOperation. + + + + boolean value. + + + + + + + + +Sets the mount operation to use a system volume if @system_volume is %TRUE. + +Since: 2.58 + + + + + a #GMountOperation. + + + + boolean value. + + + + + + Sets the mount operation's password to @password. @@ -37160,6 +37402,26 @@ Sets the state of saving passwords for the mount operation. + + +Sets the mount operation's PIM to @pim. + +Since: 2.58 + + + + + a #GMountOperation. + + + + an unsigned integer. + + + + + + Sets the user name within @op to @username. @@ -39286,6 +39548,323 @@ ignore. + + +Tries to write the bytes contained in the @n_vectors @vectors into the +stream. Will block during the operation. + +If @n_vectors is 0 or the sum of all bytes in @vectors is 0, returns 0 and +does nothing. + +On success, the number of bytes written to the stream is returned. +It is not an error if this is not the same as the requested size, as it +can happen e.g. on a partial I/O error, or if there is not enough +storage in the stream. All writes block until at least one byte +is written or an error occurs; 0 is never returned (unless +@n_vectors is 0 or the sum of all bytes in @vectors is 0). + +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. + +Some implementations of g_output_stream_writev() may have limitations on the +aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these +are exceeded. For example, when writing to a local file on UNIX platforms, +the aggregate buffer size must not exceed %G_MAXSSIZE bytes. + +Virtual: writev_fn + +Since: 2.60 + + + + + a #GOutputStream. + + + + the buffer containing the #GOutputVectors to write. + + + + the number of vectors to write + + + + location to store the number of bytes that were +written to the stream + + + + optional cancellable object + + + + location to store the error occurring, or %NULL to ignore + + + + %TRUE on success, %FALSE if there was an error + + + + + + +Tries to write the bytes contained in the @n_vectors @vectors into the +stream. Will block during the operation. + +This function is similar to g_output_stream_writev(), except it tries to +write as many bytes as requested, only stopping on an error. + +On a successful write of all @n_vectors vectors, %TRUE is returned, and +@bytes_written is set to the sum of all the sizes of @vectors. + +If there is an error during the operation %FALSE is returned and @error +is set to indicate the error status. + +As a special exception to the normal conventions for functions that +use #GError, if this function returns %FALSE (and sets @error) then +@bytes_written will be set to the number of bytes that were +successfully written before the error was encountered. This +functionality is only available from C. If you need it from another +language then you must write your own loop around +g_output_stream_write(). + +The content of the individual elements of @vectors might be changed by this +function. + +Since: 2.60 + + + + + a #GOutputStream. + + + + the buffer containing the #GOutputVectors to write. + + + + the number of vectors to write + + + + location to store the number of bytes that were +written to the stream + + + + optional #GCancellable object, %NULL to ignore. + + + + location to store the error occurring, or %NULL to ignore + + + + %TRUE on success, %FALSE if there was an error + + + + + + +Request an asynchronous write of the bytes contained in the @n_vectors @vectors into +the stream. When the operation is finished @callback will be called. +You can then call g_output_stream_writev_all_finish() to get the result of the +operation. + +This is the asynchronous version of g_output_stream_writev_all(). + +Call g_output_stream_writev_all_finish() to collect the result. + +Any outstanding I/O request with higher priority (lower numerical +value) will be executed before an outstanding request with lower +priority. Default priority is %G_PRIORITY_DEFAULT. + +Note that no copy of @vectors will be made, so it must stay valid +until @callback is called. The content of the individual elements +of @vectors might be changed by this function. + +Since: 2.60 + + + + + A #GOutputStream + + + + the buffer containing the #GOutputVectors to write. + + + + the number of vectors to write + + + + the I/O priority of the request + + + + optional #GCancellable object, %NULL to ignore + + + + callback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + + + +Finishes an asynchronous stream write operation started with +g_output_stream_writev_all_async(). + +As a special exception to the normal conventions for functions that +use #GError, if this function returns %FALSE (and sets @error) then +@bytes_written will be set to the number of bytes that were +successfully written before the error was encountered. This +functionality is only available from C. If you need it from another +language then you must write your own loop around +g_output_stream_writev_async(). + +Since: 2.60 + + + + + a #GOutputStream + + + + a #GAsyncResult + + + + location to store the number of bytes that were written to the stream + + + + a #GError location to store the error occurring, or %NULL to ignore. + + + + %TRUE on success, %FALSE if there was an error + + + + + + +Request an asynchronous write of the bytes contained in @n_vectors @vectors into +the stream. When the operation is finished @callback will be called. +You can then call g_output_stream_writev_finish() to get the result of the +operation. + +During an async request no other sync and async calls are allowed, +and will result in %G_IO_ERROR_PENDING errors. + +On success, the number of bytes written will be passed to the +@callback. It is not an error if this is not the same as the +requested size, as it can happen e.g. on a partial I/O error, +but generally we try to write as many bytes as requested. + +You are guaranteed that this method will never fail with +%G_IO_ERROR_WOULD_BLOCK — if @stream can't accept more data, the +method will just wait until this changes. + +Any outstanding I/O request with higher priority (lower numerical +value) will be executed before an outstanding request with lower +priority. Default priority is %G_PRIORITY_DEFAULT. + +The asynchronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. + +For the synchronous, blocking version of this function, see +g_output_stream_writev(). + +Note that no copy of @vectors will be made, so it must stay valid +until @callback is called. + +Since: 2.60 + + + + + A #GOutputStream. + + + + the buffer containing the #GOutputVectors to write. + + + + the number of vectors to write + + + + the I/O priority of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + callback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + + + +Finishes a stream writev operation. + +Since: 2.60 + + + + + a #GOutputStream. + + + + a #GAsyncResult. + + + + location to store the number of bytes that were written to the stream + + + + a #GError location to store the error occurring, or %NULL to +ignore. + + + + %TRUE on success, %FALSE if there was an error + + + + Attempts to acquire the permission represented by @permission. @@ -39802,7 +40381,8 @@ may happen if you call this method after a source triggers due to having been cancelled. Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying -transports like D/TLS require that you send the same @buffer and @count. +transports like D/TLS require that you re-send the same @buffer and +@count in the next write call. Virtual: write_nonblocking @@ -39835,6 +40415,65 @@ data from + + +Attempts to write the bytes contained in the @n_vectors @vectors to @stream, +as with g_output_stream_writev(). If @stream is not currently writable, +this will immediately return %@G_POLLABLE_RETURN_WOULD_BLOCK, and you can +use g_pollable_output_stream_create_source() to create a #GSource +that will be triggered when @stream is writable. @error will *not* be +set in that case. + +Note that since this method never blocks, you cannot actually +use @cancellable to cancel it. However, it will return an error +if @cancellable has already been cancelled when you call, which +may happen if you call this method after a source triggers due +to having been cancelled. + +Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying +transports like D/TLS require that you re-send the same @vectors and +@n_vectors in the next write call. + +Virtual: writev_nonblocking + +Since: 2.60 + + + + + a #GPollableOutputStream + + + + the buffer containing the #GOutputVectors to write. + + + + the number of vectors to write + + + + location to store the number of bytes that were +written to the stream + + + + a #GCancellable, or %NULL + + + + #GError for error reporting, or %NULL to ignore. + + + + %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK +if the stream is not currently writable (and @error is *not* set), or +%G_POLLABLE_RETURN_FAILED if there was an error in which case @error will +be set. + + + + Utility method for #GPollableInputStream and #GPollableOutputStream @@ -40913,6 +41552,117 @@ for more details. + + +This differs from g_resolver_lookup_by_name() in that you can modify +the lookup behavior with @flags. For example this can be used to limit +results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY. + +Since: 2.60 + + + + + a #GResolver + + + + the hostname to look up + + + + extra #GResolverNameLookupFlags for the lookup + + + + a #GCancellable, or %NULL + + + + return location for a #GError, or %NULL + + + + a non-empty #GList +of #GInetAddress, or %NULL on error. You +must unref each of the addresses and free the list when you are +done with it. (You can use g_resolver_free_addresses() to do this.) + + + + + + +Begins asynchronously resolving @hostname to determine its +associated IP address(es), and eventually calls @callback, which +must call g_resolver_lookup_by_name_with_flags_finish() to get the result. +See g_resolver_lookup_by_name() for more details. + +Since: 2.60 + + + + + a #GResolver + + + + the hostname to look up the address of + + + + extra #GResolverNameLookupFlags for the lookup + + + + a #GCancellable, or %NULL + + + + callback to call after resolution completes + + + + data for @callback + + + + + + + + +Retrieves the result of a call to +g_resolver_lookup_by_name_with_flags_async(). + +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +@error will be set to %G_IO_ERROR_CANCELLED. + +Since: 2.60 + + + + + a #GResolver + + + + the result passed to your #GAsyncReadyCallback + + + + return location for a #GError, or %NULL + + + + a #GList +of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() +for more details. + + + + Synchronously performs a DNS record lookup for the given @rrname and returns @@ -41298,6 +42048,11 @@ you to query it for data. If you want to use this resource in the global resource namespace you need to register it with g_resources_register(). +If @filename is empty or the data in it is corrupt, +%G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or +there is an error in reading it, an error from g_mapped_file_new() will be +returned. + Since: 2.32 @@ -41373,6 +42128,8 @@ Note: @data must be backed by memory that is at least pointer aligned. Otherwise this function will internally create a copy of the memory since GLib 2.56, or in older versions fail and exit the process. +If @data is empty or corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. + Since: 2.32 @@ -42843,17 +43600,9 @@ Gets the list of children on @settings. The list is exactly the list of strings for which it is not an error to call g_settings_get_child(). -For GSettings objects that are lists, this value can change at any -time and you should connect to the "children-changed" signal to watch -for those changes. Note that there is a race condition here: you may -request a child after listing it only for it to have been destroyed -in the meantime. For this reason, g_settings_get_child() may return -%NULL even for a child that was listed by this function. - -For GSettings objects that are not lists, you should probably not be -calling this function from "normal" code (since you should already -know what children are in your schema). This function may still be -useful there for introspection reasons, however. +There is little reason to call this function from "normal" code, since +you should already know what children are in your schema. This function +may still be useful there for introspection reasons, however. You should free the return value with g_strfreev() when you are done with it. @@ -43668,6 +44417,9 @@ in crashes or inconsistent behaviour in the case of a corrupted file. Generally, you should set @trusted to %TRUE for files installed by the system and to %FALSE for files in the home directory. +In either case, an empty file or some types of corruption in the file will +result in %G_FILE_ERROR_INVAL being returned. + If @parent is non-%NULL then there are two effects. First, if g_settings_schema_source_lookup() is called with the @@ -44323,7 +45075,8 @@ Deprecated: 2.38: Use g_action_map_remove_action() Creates a new action. -The created action is stateless. See g_simple_action_new_stateful(). +The created action is stateless. See g_simple_action_new_stateful() to create +an action that has state. Since: 2.28 @@ -44334,7 +45087,8 @@ Since: 2.28 - the type of parameter to the activate function + the type of parameter that will be passed to +handlers for the #GSimpleAction::activate signal, or %NULL for no parameter @@ -44347,10 +45101,10 @@ Since: 2.28 Creates a new stateful action. -@state is the initial state of the action. All future state values -must have the same #GVariantType as the initial state. +All future state values must have the same #GVariantType as the initial +@state. -If the @state GVariant is floating, it is consumed. +If the @state #GVariant is floating, it is consumed. Since: 2.28 @@ -44361,7 +45115,8 @@ Since: 2.28 - the type of the parameter to the activate function + the type of the parameter that will be passed to +handlers for the #GSimpleAction::activate signal, or %NULL for no parameter @@ -45379,6 +46134,8 @@ Asynchronously retrieves the next #GSocketAddress from @enumerator and then calls @callback, which must call g_socket_address_enumerator_next_finish() to get the result. +It is an error to call this multiple times before the previous callback has finished. + @@ -46633,21 +47390,21 @@ Since: 2.22 -Waits for up to @timeout microseconds for @condition to become true +Waits for up to @timeout_us microseconds for @condition to become true on @socket. If the condition is met, %TRUE is returned. If @cancellable is cancelled before the condition is met, or if -@timeout (or the socket's #GSocket:timeout) is reached before the +@timeout_us (or the socket's #GSocket:timeout) is reached before the condition is met, then %FALSE is returned and @error, if non-%NULL, is set to the appropriate value (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). If you don't want a timeout, use g_socket_condition_wait(). -(Alternatively, you can pass -1 for @timeout.) +(Alternatively, you can pass -1 for @timeout_us.) -Note that although @timeout is in microseconds for consistency with +Note that although @timeout_us is in microseconds for consistency with other GLib APIs, this function actually only has millisecond -resolution, and the behavior is undefined if @timeout is not an +resolution, and the behavior is undefined if @timeout_us is not an exact number of milliseconds. Since: 2.32 @@ -46662,7 +47419,7 @@ Since: 2.32 a #GIOCondition mask to wait for - + the maximum time (in microseconds) to wait, or -1 @@ -48907,6 +49664,73 @@ on error + + +This behaves exactly the same as g_socket_send_message(), except that +the choice of timeout behavior is determined by the @timeout_us argument +rather than by @socket's properties. + +On error %G_POLLABLE_RETURN_FAILED is returned and @error is set accordingly, or +if the socket is currently not writable %G_POLLABLE_RETURN_WOULD_BLOCK is +returned. @bytes_written will contain 0 in both cases. + +Since: 2.60 + + + + + a #GSocket + + + + a #GSocketAddress, or %NULL + + + + an array of #GOutputVector structs + + + + the number of elements in @vectors, or -1 + + + + a pointer to an +array of #GSocketControlMessages, or %NULL. + + + + number of elements in @messages, or -1. + + + + an int containing #GSocketMsgFlags flags + + + + the maximum time (in microseconds) to wait, or -1 + + + + location to store the number of bytes that were written to the socket + + + + a %GCancellable or %NULL + + + + #GError for error reporting, or %NULL to ignore. + + + + %G_POLLABLE_RETURN_OK if all data was successfully written, +%G_POLLABLE_RETURN_WOULD_BLOCK if the socket is currently not writable, or +%G_POLLABLE_RETURN_FAILED if an error happened and @error is set. + + + + Send multiple data messages from @socket in one go. This is the most @@ -49859,6 +50683,9 @@ Complete an invocation of g_subprocess_communicate_async(). Like g_subprocess_communicate(), but validates the output of the process as UTF-8, and returns it as a regular NUL terminated string. +On error, @stdout_buf and @stderr_buf will be set to undefined values and +should not be used. + @@ -51003,6 +51830,9 @@ to wait for a #GSource to trigger. Attaches @source to @task's #GMainContext with @task's [priority][io-priority], and sets @source's callback to @callback, with @task as the callback's `user_data`. +It will set the @source’s name to the task’s name (as set with +g_task_set_name()), if one has been set. + This takes a reference on @task until @source is destroyed. Since: 2.36 @@ -51104,6 +51934,23 @@ Since: 2.36 + + +Gets @task’s name. See g_task_set_name(). + +Since: 2.60 + + + + + a #GTask + + + + @task’s name, or %NULL + + + Gets @task's priority @@ -51736,6 +52583,34 @@ its #GCancellable for you. + + +Sets @task’s name, used in debugging and profiling. The name defaults to +%NULL. + +The task name should describe in a human readable way what the task does. +For example, ‘Open file’ or ‘Connect to network host’. It is used to set the +name of the #GSource used for idle completion of the task. + +This function may only be called before the @task is first used in a thread +other than the one it was constructed in. + +Since: 2.60 + + + + + a #GTask + + + + a human readable name for the task, or %NULL to unset it + + + + + + Sets @task's priority. If you do not call this, it will default to @@ -52217,6 +53092,40 @@ Since: 2.18 + + +Update the actual icon name list, based on the requested names (from +construction, or later added with g_themed_icon_prepend_name() and +g_themed_icon_append_name()). +The order of the list matters, indicating priority: +- The first requested icon is first in priority. +- If "use-default-fallbacks" is #TRUE, then it is followed by all its +fallbacks (starting from top to lower context levels). +- Then next requested icons, and optionally their fallbacks, follow. +- Finally all the style variants (symbolic or regular, opposite to whatever +is the requested style) follow in the same order. + +An icon is not added twice in the list if it was previously added. + +For instance, if requested names are: +[ "some-icon-symbolic", "some-other-icon" ] +and use-default-fallbacks is TRUE, the final name list shall be: +[ "some-icon-symbolic", "some-symbolic", "some-other-icon", +"some-other", "some", "some-icon", "some-other-icon-symbolic", +"some-other-symbolic" ] + + + + + + a #GThemedIcon. + + + + a new #GThemedIcon + + + Creates a new #GThreadedSocketService with no listeners. Listeners @@ -52383,6 +53292,33 @@ implementation. + + +Set the default #GTlsDatabase used to verify TLS connections + +Any subsequent call to g_tls_backend_get_default_database() will return +the database set in this call. Existing databases and connections are not +modified. + +Setting a %NULL default database will reset to using the system default +database as if g_tls_backend_set_default_database() had never been called. + +Since: 2.60 + + + + + the #GTlsBackend + + + + the #GTlsDatabase + + + + + + Checks if DTLS is supported. DTLS support may not be available even if TLS @@ -52823,14 +53759,19 @@ Since: 2.28 -If @use_ssl3 is %TRUE, this forces @conn to use the lowest-supported -TLS protocol version rather than trying to properly negotiate the -highest mutually-supported protocol version with the peer. This can -be used when talking to broken TLS servers that exhibit protocol -version intolerance. +Since 2.42.1, if @use_ssl3 is %TRUE, this forces @conn to use the +lowest-supported TLS protocol version rather than trying to properly +negotiate the highest mutually-supported protocol version with the +peer. Be aware that SSL 3.0 is generally disabled by the +#GTlsBackend, so the lowest-supported protocol version is probably +not SSL 3.0. -Be aware that SSL 3.0 is generally disabled by the #GTlsBackend, so -the lowest-supported protocol version is probably not SSL 3.0. +Since 2.58, this may additionally cause an RFC 7507 fallback SCSV to +be sent to the server, causing modern TLS servers to immediately +terminate the connection. You should generally only use this function +if you need to connect to broken servers that exhibit TLS protocol +version intolerance, and when an initial attempt to connect to a +server normally has already failed. Since: 2.28 @@ -52959,6 +53900,30 @@ Since: 2.30 + + +Gets the name of the application-layer protocol negotiated during +the handshake. + +If the peer did not use the ALPN extension, or did not advertise a +protocol that matched one of @conn's protocols, or the TLS backend +does not support ALPN, then this will be %NULL. See +g_tls_connection_set_advertised_protocols(). + +Since: 2.60 + + + + + a #GTlsConnection + + + + the negotiated protocol, or %NULL + + + + Gets @conn's peer's certificate after the handshake has completed. @@ -53006,6 +53971,10 @@ g_tls_connection_set_rehandshake_mode() for details. Since: 2.28 +Deprecated: 2.60. Changing the rehandshake mode is no longer +required for compatibility. Also, rehandshaking has been removed +from the TLS protocol in TLS 1.3. + @@ -53077,8 +54046,15 @@ before or after completing the handshake). Likewise, on the server side, although a handshake is necessary at the beginning of the communication, you do not need to call this function explicitly unless you want clearer error reporting. -However, you may call g_tls_connection_handshake() later on to -renegotiate parameters (encryption methods, etc) with the client. + +If TLS 1.2 or older is in use, you may call +g_tls_connection_handshake() after the initial handshake to +rehandshake; however, this usage is deprecated because rehandshaking +is no longer part of the TLS protocol in TLS 1.3. Accordingly, the +behavior of calling this function after the initial handshake is now +undefined, except it is guaranteed to be reasonable and +nondestructive so as to preserve compatibility with code written for +older versions of GLib. #GTlsConnection::accept_certificate may be emitted during the handshake. @@ -53166,6 +54142,36 @@ case @error will be set. + + +Sets the list of application-layer protocols to advertise that the +caller is willing to speak on this connection. The +Application-Layer Protocol Negotiation (ALPN) extension will be +used to negotiate a compatible protocol with the peer; use +g_tls_connection_get_negotiated_protocol() to find the negotiated +protocol after the handshake. Specifying %NULL for the the value +of @protocols will disable ALPN negotiation. + +See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) +for a list of registered protocol IDs. + +Since: 2.60 + + + + + a #GTlsConnection + + + + a %NULL-terminated +array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL + + + + + + This sets the certificate that @conn will present to its peer @@ -53257,7 +54263,8 @@ Since: 2.30 -Sets how @conn behaves with respect to rehandshaking requests. +Sets how @conn behaves with respect to rehandshaking requests, when +TLS 1.2 or older is in use. %G_TLS_REHANDSHAKE_NEVER means that it will never agree to rehandshake after the initial handshake is complete. (For a client, @@ -53280,6 +54287,10 @@ software. Since: 2.28 +Deprecated: 2.60. Changing the rehandshake mode is no longer +required for compatibility. Also, rehandshaking has been removed +from the TLS protocol in TLS 1.3. + @@ -53522,7 +54533,7 @@ Use g_object_unref() to release the certificate. Lookup the issuer of @certificate in the database. -The %issuer property +The #GTlsCertificate:issuer property of @certificate is not modified, and the two certificates are not hooked into a chain. @@ -55529,6 +56540,52 @@ Gets the mount path for a unix mount. + + +Gets a comma-separated list of mount options for the unix mount. For example, +`rw,relatime,seclabel,data=ordered`. + +This is similar to g_unix_mount_point_get_options(), but it takes +a #GUnixMountEntry as an argument. + +Since: 2.58 + + + + + a #GUnixMountEntry. + + + + a string containing the options, or %NULL if not +available. + + + + + + +Gets the root of the mount within the filesystem. This is useful e.g. for +mounts created by bind operation, or btrfs subvolumes. + +For example, the root path is equal to "/" for mount created by +"mount /dev/sda1 /mnt/foo" and "/bar" for +"mount --bind /mnt/foo/bar /mnt/bar". + +Since: 2.60 + + + + + a #GUnixMountEntry. + + + + a string containing the root, or %NULL if not supported. + + + + Guesses whether a Unix mount can be ejected. @@ -56835,7 +57892,7 @@ information about volume identifiers. a newly allocated string containing the -requested identfier, or %NULL if the #GVolume +requested identifier, or %NULL if the #GVolume doesn't have this kind of identifier @@ -56928,7 +57985,8 @@ available. - the UUID for @volume or %NULL if no UUID can be computed. + the UUID for @volume or %NULL if no UUID +can be computed. The returned string should be freed with g_free() when no longer needed. @@ -56947,7 +58005,7 @@ it in its g_mount_get_volume() implementation. The caller must also listen for the "removed" signal on the returned object and give up its reference when handling that signal -Similary, if implementing g_volume_monitor_adopt_orphan_mount(), +Similarly, if implementing g_volume_monitor_adopt_orphan_mount(), the implementor must take a reference to @mount and return it in its g_volume_get_mount() implemented. Also, the implementor must listen for the "unmounted" signal on @mount and give up its @@ -58438,2964 +59496,4 @@ GetLogicalDrives() is returned. - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_add_finish() to get the result of the operation. - -See gxdp_documents_call_add_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_add(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddFull">AddFull()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_add_full_finish() to get the result of the operation. - -See gxdp_documents_call_add_full_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_add_full(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add_full(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddFull">AddFull()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_add_full() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_add_named_finish() to get the result of the operation. - -See gxdp_documents_call_add_named_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_add_named(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add_named(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_add_named() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_add() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_delete_finish() to get the result of the operation. - -See gxdp_documents_call_delete_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_delete(). - - - - - - A #GXdpDocumentsProxy. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_delete(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_delete() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_get_mount_point_finish() to get the result of the operation. - -See gxdp_documents_call_get_mount_point_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_get_mount_point(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_get_mount_point(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_get_mount_point() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_grant_permissions_finish() to get the result of the operation. - -See gxdp_documents_call_grant_permissions_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_grant_permissions(). - - - - - - A #GXdpDocumentsProxy. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_grant_permissions(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_grant_permissions() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_info_finish() to get the result of the operation. - -See gxdp_documents_call_info_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_info(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for return parameter or %NULL to ignore. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_info(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_info() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for return parameter or %NULL to ignore. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_list_finish() to get the result of the operation. - -See gxdp_documents_call_list_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_list(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_list(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_list() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Return location for return parameter or %NULL to ignore. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_lookup_finish() to get the result of the operation. - -See gxdp_documents_call_lookup_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_lookup(). - - - - - - A #GXdpDocumentsProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_lookup(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_lookup() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Return location for return parameter or %NULL to ignore. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_call_revoke_permissions_finish() to get the result of the operation. - -See gxdp_documents_call_revoke_permissions_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_call_revoke_permissions(). - - - - - - A #GXdpDocumentsProxy. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_revoke_permissions(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_documents_call_revoke_permissions() for the asynchronous version of this method. - - - - - - A #GXdpDocumentsProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddFull">AddFull()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Parameter to return. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Parameter to return. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpDocuments. - - - - A #GDBusMethodInvocation. - - - - - - - - -Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-Documents.version">"version"</link> D-Bus property. - -Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. - - - - - - A #GXdpDocuments. - - - - The property value. - - - - - -Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link> D-Bus interface. - - - - - - A #GDBusInterfaceInfo. Do not free. - - - - - -Overrides all #GObject properties in the #GXdpDocuments interface for a concrete class. -The properties are overridden in the order they are defined. - - - - - - The class structure for a #GObject<!-- -->-derived class. - - - - The property id to assign to the first overridden property. - - - - The last property id. - - - - - -Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link>. See g_dbus_proxy_new() for more details. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_proxy_new_finish() to get the result of the operation. - -See gxdp_documents_proxy_new_sync() for the synchronous, blocking version of this constructor. - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_proxy_new(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_proxy_new(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_documents_proxy_new() but takes a #GBusType instead of a #GDBusConnection. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_documents_proxy_new_for_bus_finish() to get the result of the operation. - -See gxdp_documents_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_documents_proxy_new_for_bus(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_proxy_new_for_bus(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_documents_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. - -The calling thread is blocked until a reply is received. - -See gxdp_documents_proxy_new_for_bus() for the asynchronous version of this constructor. - - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link>. See g_dbus_proxy_new_sync() for more details. - -The calling thread is blocked until a reply is received. - -See gxdp_documents_proxy_new() for the asynchronous version of this constructor. - - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Sets the <link linkend="gdbus-property-org-freedesktop-portal-Documents.version">"version"</link> D-Bus property to @value. - -Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. - - - - - A #GXdpDocuments. - - - - The value to set. - - - - - - - - -Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link>. - - - - - - The skeleton object. - - - - - -Emits the <link linkend="gdbus-signal-org-freedesktop-portal-NetworkMonitor.changed">"changed"</link> D-Bus signal. - - - - - A #GXdpNetworkMonitor. - - - - Argument to pass with the signal. - - - - - - - - -Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.available">"available"</link> D-Bus property. - -Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. - - - - - - A #GXdpNetworkMonitor. - - - - The property value. - - - - - -Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.connectivity">"connectivity"</link> D-Bus property. - -Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. - - - - - - A #GXdpNetworkMonitor. - - - - The property value. - - - - - -Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.metered">"metered"</link> D-Bus property. - -Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. - - - - - - A #GXdpNetworkMonitor. - - - - The property value. - - - - - -Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link> D-Bus interface. - - - - - - A #GDBusInterfaceInfo. Do not free. - - - - - -Overrides all #GObject properties in the #GXdpNetworkMonitor interface for a concrete class. -The properties are overridden in the order they are defined. - - - - - - The class structure for a #GObject<!-- -->-derived class. - - - - The property id to assign to the first overridden property. - - - - The last property id. - - - - - -Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link>. See g_dbus_proxy_new() for more details. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_network_monitor_proxy_new_finish() to get the result of the operation. - -See gxdp_network_monitor_proxy_new_sync() for the synchronous, blocking version of this constructor. - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_network_monitor_proxy_new(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_network_monitor_proxy_new(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_network_monitor_proxy_new() but takes a #GBusType instead of a #GDBusConnection. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_network_monitor_proxy_new_for_bus_finish() to get the result of the operation. - -See gxdp_network_monitor_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_network_monitor_proxy_new_for_bus(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_network_monitor_proxy_new_for_bus(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_network_monitor_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. - -The calling thread is blocked until a reply is received. - -See gxdp_network_monitor_proxy_new_for_bus() for the asynchronous version of this constructor. - - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link>. See g_dbus_proxy_new_sync() for more details. - -The calling thread is blocked until a reply is received. - -See gxdp_network_monitor_proxy_new() for the asynchronous version of this constructor. - - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Sets the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.available">"available"</link> D-Bus property to @value. - -Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. - - - - - A #GXdpNetworkMonitor. - - - - The value to set. - - - - - - - - -Sets the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.connectivity">"connectivity"</link> D-Bus property to @value. - -Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. - - - - - A #GXdpNetworkMonitor. - - - - The value to set. - - - - - - - - -Sets the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.metered">"metered"</link> D-Bus property to @value. - -Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. - - - - - A #GXdpNetworkMonitor. - - - - The value to set. - - - - - - - - -Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link>. - - - - - - The skeleton object. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenFile">OpenFile()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_open_uri_call_open_file_finish() to get the result of the operation. - -See gxdp_open_uri_call_open_file_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpOpenURIProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_open_uri_call_open_file(). - - - - - - A #GXdpOpenURIProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_call_open_file(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenFile">OpenFile()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_open_uri_call_open_file() for the asynchronous version of this method. - - - - - - A #GXdpOpenURIProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GUnixFDList or %NULL. - - - - Return location for return parameter or %NULL to ignore. - - - - Return location for a #GUnixFDList or %NULL. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenURI">OpenURI()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_open_uri_call_open_uri_finish() to get the result of the operation. - -See gxdp_open_uri_call_open_uri_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpOpenURIProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_open_uri_call_open_uri(). - - - - - - A #GXdpOpenURIProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_call_open_uri(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenURI">OpenURI()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_open_uri_call_open_uri() for the asynchronous version of this method. - - - - - - A #GXdpOpenURIProxy. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Argument to pass with the method invocation. - - - - Return location for return parameter or %NULL to ignore. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenFile">OpenFile()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpOpenURI. - - - - A #GDBusMethodInvocation. - - - - A #GUnixFDList or %NULL. - - - - Parameter to return. - - - - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-OpenURI.OpenURI">OpenURI()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpOpenURI. - - - - A #GDBusMethodInvocation. - - - - Parameter to return. - - - - - - - - -Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-OpenURI.version">"version"</link> D-Bus property. - -Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. - - - - - - A #GXdpOpenURI. - - - - The property value. - - - - - -Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-OpenURI.top_of_page">org.freedesktop.portal.OpenURI</link> D-Bus interface. - - - - - - A #GDBusInterfaceInfo. Do not free. - - - - - -Overrides all #GObject properties in the #GXdpOpenURI interface for a concrete class. -The properties are overridden in the order they are defined. - - - - - - The class structure for a #GObject<!-- -->-derived class. - - - - The property id to assign to the first overridden property. - - - - The last property id. - - - - - -Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-OpenURI.top_of_page">org.freedesktop.portal.OpenURI</link>. See g_dbus_proxy_new() for more details. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_open_uri_proxy_new_finish() to get the result of the operation. - -See gxdp_open_uri_proxy_new_sync() for the synchronous, blocking version of this constructor. - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_open_uri_proxy_new(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_proxy_new(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_open_uri_proxy_new() but takes a #GBusType instead of a #GDBusConnection. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_open_uri_proxy_new_for_bus_finish() to get the result of the operation. - -See gxdp_open_uri_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_open_uri_proxy_new_for_bus(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_proxy_new_for_bus(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_open_uri_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. - -The calling thread is blocked until a reply is received. - -See gxdp_open_uri_proxy_new_for_bus() for the asynchronous version of this constructor. - - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-OpenURI.top_of_page">org.freedesktop.portal.OpenURI</link>. See g_dbus_proxy_new_sync() for more details. - -The calling thread is blocked until a reply is received. - -See gxdp_open_uri_proxy_new() for the asynchronous version of this constructor. - - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Sets the <link linkend="gdbus-property-org-freedesktop-portal-OpenURI.version">"version"</link> D-Bus property to @value. - -Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. - - - - - A #GXdpOpenURI. - - - - The value to set. - - - - - - - - -Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-OpenURI.top_of_page">org.freedesktop.portal.OpenURI</link>. - - - - - - The skeleton object. - - - - - -Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</link> D-Bus method on @proxy. -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_proxy_resolver_call_lookup_finish() to get the result of the operation. - -See gxdp_proxy_resolver_call_lookup_sync() for the synchronous, blocking version of this method. - - - - - A #GXdpProxyResolverProxy. - - - - Argument to pass with the method invocation. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied or %NULL. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_proxy_resolver_call_lookup(). - - - - - - A #GXdpProxyResolverProxy. - - - - Return location for return parameter or %NULL to ignore. - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_call_lookup(). - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received. - -See gxdp_proxy_resolver_call_lookup() for the asynchronous version of this method. - - - - - - A #GXdpProxyResolverProxy. - - - - Argument to pass with the method invocation. - - - - Return location for return parameter or %NULL to ignore. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL. - - - - %TRUE if the call succeded, %FALSE if @error is set. - - - - - -Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. - -This method will free @invocation, you cannot use it afterwards. - - - - - A #GXdpProxyResolver. - - - - A #GDBusMethodInvocation. - - - - Parameter to return. - - - - - - - - -Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link> D-Bus interface. - - - - - - A #GDBusInterfaceInfo. Do not free. - - - - - -Overrides all #GObject properties in the #GXdpProxyResolver interface for a concrete class. -The properties are overridden in the order they are defined. - - - - - - The class structure for a #GObject<!-- -->-derived class. - - - - The property id to assign to the first overridden property. - - - - The last property id. - - - - - -Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link>. See g_dbus_proxy_new() for more details. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_proxy_resolver_proxy_new_finish() to get the result of the operation. - -See gxdp_proxy_resolver_proxy_new_sync() for the synchronous, blocking version of this constructor. - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_proxy_resolver_proxy_new(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_proxy_new(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_proxy_resolver_proxy_new() but takes a #GBusType instead of a #GDBusConnection. - -When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. -You can then call gxdp_proxy_resolver_proxy_new_for_bus_finish() to get the result of the operation. - -See gxdp_proxy_resolver_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - A #GAsyncReadyCallback to call when the request is satisfied. - - - - User data to pass to @callback. - - - - - - - - -Finishes an operation started with gxdp_proxy_resolver_proxy_new_for_bus(). - - - - - - The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_proxy_new_for_bus(). - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Like gxdp_proxy_resolver_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. - -The calling thread is blocked until a reply is received. - -See gxdp_proxy_resolver_proxy_new_for_bus() for the asynchronous version of this constructor. - - - - - - A #GBusType. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique). - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link>. See g_dbus_proxy_new_sync() for more details. - -The calling thread is blocked until a reply is received. - -See gxdp_proxy_resolver_proxy_new() for the asynchronous version of this constructor. - - - - - - A #GDBusConnection. - - - - Flags from the #GDBusProxyFlags enumeration. - - - - A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. - - - - An object path. - - - - A #GCancellable or %NULL. - - - - Return location for error or %NULL - - - - The constructed proxy object or %NULL if @error is set. - - - - - -Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link>. - - - - - - The skeleton object. - - - diff --git a/gio/src/gio_enums.defs b/gio/src/gio_enums.defs index 7b75b8b9..aca5af3c 100644 --- a/gio/src/gio_enums.defs +++ b/gio/src/gio_enums.defs @@ -523,11 +523,12 @@ ;; Original typedef: ;; typedef enum { -;; G_ASK_PASSWORD_NEED_PASSWORD = (1 << 0), -;; G_ASK_PASSWORD_NEED_USERNAME = (1 << 1), -;; G_ASK_PASSWORD_NEED_DOMAIN = (1 << 2), -;; G_ASK_PASSWORD_SAVING_SUPPORTED = (1 << 3), -;; G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = (1 << 4) +;; G_ASK_PASSWORD_NEED_PASSWORD = (1 << 0), +;; G_ASK_PASSWORD_NEED_USERNAME = (1 << 1), +;; G_ASK_PASSWORD_NEED_DOMAIN = (1 << 2), +;; G_ASK_PASSWORD_SAVING_SUPPORTED = (1 << 3), +;; G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = (1 << 4), +;; G_ASK_PASSWORD_TCRYPT = (1 << 5), ;; } GAskPasswordFlags; (define-flags-extended AskPasswordFlags @@ -539,6 +540,7 @@ '("need-domain" "G_ASK_PASSWORD_NEED_DOMAIN" "(1 << 2)") '("saving-supported" "G_ASK_PASSWORD_SAVING_SUPPORTED" "(1 << 3)") '("anonymous-supported" "G_ASK_PASSWORD_ANONYMOUS_SUPPORTED" "(1 << 4)") + '("tcrypt" "G_ASK_PASSWORD_TCRYPT" "(1 << 5)") ) ) @@ -1280,7 +1282,9 @@ ;; ;; G_APPLICATION_NON_UNIQUE = (1 << 5), ;; -;; G_APPLICATION_CAN_OVERRIDE_APP_ID = (1 << 6) +;; G_APPLICATION_CAN_OVERRIDE_APP_ID = (1 << 6), +;; G_APPLICATION_ALLOW_REPLACEMENT = (1 << 7), +;; G_APPLICATION_REPLACE = (1 << 8) ;; } GApplicationFlags; (define-flags-extended ApplicationFlags @@ -1295,6 +1299,8 @@ '("send-environment" "G_APPLICATION_SEND_ENVIRONMENT" "(1 << 4)") '("non-unique" "G_APPLICATION_NON_UNIQUE" "(1 << 5)") '("can-override-app-id" "G_APPLICATION_CAN_OVERRIDE_APP_ID" "(1 << 6)") + '("allow-replacement" "G_APPLICATION_ALLOW_REPLACEMENT" "(1 << 7)") + '("replace" "G_APPLICATION_REPLACE" "(1 << 8)") ) ) @@ -1306,7 +1312,8 @@ ;; G_TLS_ERROR_NOT_TLS, ;; G_TLS_ERROR_HANDSHAKE, ;; G_TLS_ERROR_CERTIFICATE_REQUIRED, -;; G_TLS_ERROR_EOF +;; G_TLS_ERROR_EOF, +;; G_TLS_ERROR_INAPPROPRIATE_FALLBACK ;; } GTlsError; (define-enum-extended TlsError @@ -1320,6 +1327,7 @@ '("handshake" "G_TLS_ERROR_HANDSHAKE" "4") '("certificate-required" "G_TLS_ERROR_CERTIFICATE_REQUIRED" "5") '("eof" "G_TLS_ERROR_EOF" "6") + '("inappropriate-fallback" "G_TLS_ERROR_INAPPROPRIATE_FALLBACK" "7") ) ) @@ -1638,6 +1646,41 @@ ) ) +;; Original typedef: +;; typedef enum { +;; G_POLLABLE_RETURN_FAILED = 0, +;; G_POLLABLE_RETURN_OK = 1, +;; G_POLLABLE_RETURN_WOULD_BLOCK = -G_IO_ERROR_WOULD_BLOCK +;; } GPollableReturn; + +(define-enum-extended PollableReturn + (in-module "G") + (c-name "GPollableReturn") + (values + '("failed" "G_POLLABLE_RETURN_FAILED" "0") + '("ok" "G_POLLABLE_RETURN_OK" "1") + ) +) + +;; From gresolver.h + +;; Original typedef: +;; typedef enum { +;; G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT = 0, +;; G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY = 1 << 0, +;; G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY = 1 << 1, +;; } GResolverNameLookupFlags; + +(define-flags-extended ResolverNameLookupFlags + (in-module "G") + (c-name "GResolverNameLookupFlags") + (values + '("default" "G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT" "0x0") + '("ipv4-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY" "1 << 0") + '("ipv6-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY" "1 << 1") + ) +) + ;; From gsettings.h ;; Original typedef: diff --git a/gio/src/gio_methods.defs b/gio/src/gio_methods.defs index 06924b02..c8570555 100644 --- a/gio/src/gio_methods.defs +++ b/gio/src/gio_methods.defs @@ -780,86 +780,6 @@ (gtype-id "G_TYPE_WIN32_REGISTRY_KEY") ) -(define-object Documents - (in-module "GXdp") - (c-name "GXdpDocuments") - (gtype-id "G_TYPE_XDP_DOCUMENTS") -) - -(define-object DocumentsProxy - (in-module "GXdp") - (parent "GDBusProxy") - (c-name "GXdpDocumentsProxy") - (gtype-id "G_TYPE_XDP_DOCUMENTS_PROXY") -) - -(define-object DocumentsSkeleton - (in-module "GXdp") - (parent "GDBusInterfaceSkeleton") - (c-name "GXdpDocumentsSkeleton") - (gtype-id "G_TYPE_XDP_DOCUMENTS_SKELETON") -) - -(define-object NetworkMonitor - (in-module "GXdp") - (c-name "GXdpNetworkMonitor") - (gtype-id "G_TYPE_XDP_NETWORK_MONITOR") -) - -(define-object NetworkMonitorProxy - (in-module "GXdp") - (parent "GDBusProxy") - (c-name "GXdpNetworkMonitorProxy") - (gtype-id "G_TYPE_XDP_NETWORK_MONITOR_PROXY") -) - -(define-object NetworkMonitorSkeleton - (in-module "GXdp") - (parent "GDBusInterfaceSkeleton") - (c-name "GXdpNetworkMonitorSkeleton") - (gtype-id "G_TYPE_XDP_NETWORK_MONITOR_SKELETON") -) - -(define-object OpenURI - (in-module "GXdp") - (c-name "GXdpOpenURI") - (gtype-id "G_TYPE_XDP_OPEN_URI") -) - -(define-object OpenURIProxy - (in-module "GXdp") - (parent "GDBusProxy") - (c-name "GXdpOpenURIProxy") - (gtype-id "G_TYPE_XDP_OPEN_URI_PROXY") -) - -(define-object OpenURISkeleton - (in-module "GXdp") - (parent "GDBusInterfaceSkeleton") - (c-name "GXdpOpenURISkeleton") - (gtype-id "G_TYPE_XDP_OPEN_URI_SKELETON") -) - -(define-object ProxyResolver - (in-module "GXdp") - (c-name "GXdpProxyResolver") - (gtype-id "G_TYPE_XDP_PROXY_RESOLVER") -) - -(define-object ProxyResolverProxy - (in-module "GXdp") - (parent "GDBusProxy") - (c-name "GXdpProxyResolverProxy") - (gtype-id "G_TYPE_XDP_PROXY_RESOLVER_PROXY") -) - -(define-object ProxyResolverSkeleton - (in-module "GXdp") - (parent "GDBusInterfaceSkeleton") - (c-name "GXdpProxyResolverSkeleton") - (gtype-id "G_TYPE_XDP_PROXY_RESOLVER_SKELETON") -) - ;; Enumerations and flags ... (define-enum AuthMechanismState @@ -1186,6 +1106,7 @@ '("need-domain" "G_ASK_PASSWORD_NEED_DOMAIN") '("saving-supported" "G_ASK_PASSWORD_SAVING_SUPPORTED") '("anonymous-supported" "G_ASK_PASSWORD_ANONYMOUS_SUPPORTED") + '("tcrypt" "G_ASK_PASSWORD_TCRYPT") ) ) @@ -1642,6 +1563,8 @@ '("send-environment" "G_APPLICATION_SEND_ENVIRONMENT") '("non-unique" "G_APPLICATION_NON_UNIQUE") '("can-override-app-id" "G_APPLICATION_CAN_OVERRIDE_APP_ID") + '("allow-replacement" "G_APPLICATION_ALLOW_REPLACEMENT") + '("replace" "G_APPLICATION_REPLACE") ) ) @@ -1657,6 +1580,7 @@ '("handshake" "G_TLS_ERROR_HANDSHAKE") '("certificate-required" "G_TLS_ERROR_CERTIFICATE_REQUIRED") '("eof" "G_TLS_ERROR_EOF") + '("inappropriate-fallback" "G_TLS_ERROR_INAPPROPRIATE_FALLBACK") ) ) @@ -1846,6 +1770,28 @@ ) ) +(define-enum Return + (in-module "GPollable") + (c-name "GPollableReturn") + (gtype-id "G_TYPE_POLLABLE_RETURN") + (values + '("failed" "G_POLLABLE_RETURN_FAILED") + '("ok" "G_POLLABLE_RETURN_OK") + '("would-block" "G_POLLABLE_RETURN_WOULD_BLOCK") + ) +) + +(define-flags NameLookupFlags + (in-module "GResolver") + (c-name "GResolverNameLookupFlags") + (gtype-id "G_TYPE_RESOLVER_NAME_LOOKUP_FLAGS") + (values + '("default" "G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT") + '("ipv4-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY") + '("ipv6-only" "G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY") + ) +) + (define-flags BindFlags (in-module "GSettings") (c-name "GSettingsBindFlags") @@ -2273,6 +2219,29 @@ ) ) +(define-method launch_uris_async + (of-object "GAppInfo") + (c-name "g_app_info_launch_uris_async") + (return-type "none") + (parameters + '("GList*" "uris") + '("GAppLaunchContext*" "context") + '("GCancellable*" "cancellable") + '("GAsyncReadyCallback" "callback") + '("gpointer" "user_data") + ) +) + +(define-method launch_uris_finish + (of-object "GAppInfo") + (c-name "g_app_info_launch_uris_finish") + (return-type "gboolean") + (parameters + '("GAsyncResult*" "result") + '("GError**" "error") + ) +) + (define-method should_show (of-object "GAppInfo") (c-name "g_app_info_should_show") @@ -3468,10 +3437,6 @@ -;; From gconstructor_as_data.h - - - ;; From gcontenttype.h (define-function g_content_type_equals @@ -3589,6 +3554,19 @@ (return-type "GList*") ) +(define-function g_content_type_get_mime_dirs + (c-name "g_content_type_get_mime_dirs") + (return-type "const-gchar*-const*") +) + +(define-function g_content_type_set_mime_dirs + (c-name "g_content_type_set_mime_dirs") + (return-type "none") + (parameters + '("const-gchar*-const*" "dirs") + ) +) + ;; From gcontextspecificgroup.h @@ -4536,6 +4514,12 @@ (return-type "GDBusCapabilityFlags") ) +(define-method get_flags + (of-object "GDBusConnection") + (c-name "g_dbus_connection_get_flags") + (return-type "GDBusConnectionFlags") +) + (define-method close (of-object "GDBusConnection") (c-name "g_dbus_connection_close") @@ -4869,10 +4853,6 @@ -;; From gdbus-daemon-generated.h - - - ;; From gdbusdaemon.h @@ -6922,6 +6902,16 @@ ) ) +(define-method get_string_list + (of-object "GDesktopAppInfo") + (c-name "g_desktop_app_info_get_string_list") + (return-type "gchar**") + (parameters + '("const-char*" "key") + '("gsize*" "length") + ) +) + (define-method list_actions (of-object "GDesktopAppInfo") (c-name "g_desktop_app_info_list_actions") @@ -6977,6 +6967,25 @@ ) ) +(define-method launch_uris_as_manager_with_fds + (of-object "GDesktopAppInfo") + (c-name "g_desktop_app_info_launch_uris_as_manager_with_fds") + (return-type "gboolean") + (parameters + '("GList*" "uris") + '("GAppLaunchContext*" "launch_context") + '("GSpawnFlags" "spawn_flags") + '("GSpawnChildSetupFunc" "user_setup") + '("gpointer" "user_setup_data") + '("GDesktopAppLaunchCallback" "pid_callback") + '("gpointer" "pid_callback_data") + '("gint" "stdin_fd") + '("gint" "stdout_fd") + '("gint" "stderr_fd") + '("GError**" "error") + ) +) + (define-function g_desktop_app_info_search (c-name "g_desktop_app_info_search") (return-type "gchar***") @@ -6997,15 +7006,6 @@ ;; From gdocumentportal.h -(define-function g_document_portal_add_document - (c-name "g_document_portal_add_document") - (return-type "char*") - (parameters - '("GFile*" "file") - '("GError**" "error") - ) -) - (define-function g_document_portal_add_documents (c-name "g_document_portal_add_documents") (return-type "GList*") @@ -7510,6 +7510,21 @@ ) ) +(define-method set_advertised_protocols + (of-object "GDtlsConnection") + (c-name "g_dtls_connection_set_advertised_protocols") + (return-type "none") + (parameters + '("const-gchar*-const*" "protocols") + ) +) + +(define-method get_negotiated_protocol + (of-object "GDtlsConnection") + (c-name "g_dtls_connection_get_negotiated_protocol") + (return-type "const-gchar*") +) + ;; From gdtlsserverconnection.h @@ -9080,6 +9095,28 @@ ) ) +(define-method query_default_handler_async + (of-object "GFile") + (c-name "g_file_query_default_handler_async") + (return-type "none") + (parameters + '("int" "io_priority") + '("GCancellable*" "cancellable") + '("GAsyncReadyCallback" "callback") + '("gpointer" "user_data") + ) +) + +(define-method query_default_handler_finish + (of-object "GFile") + (c-name "g_file_query_default_handler_finish") + (return-type "GAppInfo*") + (parameters + '("GAsyncResult*" "result") + '("GError**" "error") + ) +) + (define-method load_contents (of-object "GFile") (c-name "g_file_load_contents") @@ -10747,482 +10784,98 @@ -;; From gioenumtypes.h - -(define-function g_app_info_create_flags_get_type - (c-name "g_app_info_create_flags_get_type") - (return-type "GType") -) +;; From gioerror.h -(define-function g_converter_flags_get_type - (c-name "g_converter_flags_get_type") - (return-type "GType") +(define-function g_io_error_quark + (c-name "g_io_error_quark") + (return-type "GQuark") ) -(define-function g_converter_result_get_type - (c-name "g_converter_result_get_type") - (return-type "GType") +(define-function g_io_error_from_errno + (c-name "g_io_error_from_errno") + (return-type "GIOErrorEnum") + (parameters + '("gint" "err_no") + ) ) -(define-function g_data_stream_byte_order_get_type - (c-name "g_data_stream_byte_order_get_type") - (return-type "GType") +(define-function g_io_error_from_win32_error + (c-name "g_io_error_from_win32_error") + (return-type "GIOErrorEnum") + (parameters + '("gint" "error_code") + ) ) -(define-function g_data_stream_newline_type_get_type - (c-name "g_data_stream_newline_type_get_type") - (return-type "GType") -) -(define-function g_file_attribute_type_get_type - (c-name "g_file_attribute_type_get_type") - (return-type "GType") -) -(define-function g_file_attribute_info_flags_get_type - (c-name "g_file_attribute_info_flags_get_type") - (return-type "GType") -) +;; From gio.h -(define-function g_file_attribute_status_get_type - (c-name "g_file_attribute_status_get_type") - (return-type "GType") -) -(define-function g_file_query_info_flags_get_type - (c-name "g_file_query_info_flags_get_type") - (return-type "GType") -) -(define-function g_file_create_flags_get_type - (c-name "g_file_create_flags_get_type") - (return-type "GType") -) +;; From giomodule.h -(define-function g_file_measure_flags_get_type - (c-name "g_file_measure_flags_get_type") - (return-type "GType") +(define-function g_io_module_scope_new + (c-name "g_io_module_scope_new") + (is-constructor-of "GIoModuleScope") + (return-type "GIOModuleScope*") + (parameters + '("GIOModuleScopeFlags" "flags") + ) ) -(define-function g_mount_mount_flags_get_type - (c-name "g_mount_mount_flags_get_type") - (return-type "GType") +(define-method free + (of-object "GIOModuleScope") + (c-name "g_io_module_scope_free") + (return-type "none") ) -(define-function g_mount_unmount_flags_get_type - (c-name "g_mount_unmount_flags_get_type") - (return-type "GType") +(define-method block + (of-object "GIOModuleScope") + (c-name "g_io_module_scope_block") + (return-type "none") + (parameters + '("const-gchar*" "basename") + ) ) -(define-function g_drive_start_flags_get_type - (c-name "g_drive_start_flags_get_type") +(define-function g_io_module_get_type + (c-name "g_io_module_get_type") (return-type "GType") ) -(define-function g_drive_start_stop_type_get_type - (c-name "g_drive_start_stop_type_get_type") - (return-type "GType") +(define-function g_io_module_new + (c-name "g_io_module_new") + (is-constructor-of "GIoModule") + (return-type "GIOModule*") + (parameters + '("const-gchar*" "filename") + ) ) -(define-function g_file_copy_flags_get_type - (c-name "g_file_copy_flags_get_type") - (return-type "GType") +(define-function g_io_modules_scan_all_in_directory + (c-name "g_io_modules_scan_all_in_directory") + (return-type "none") + (parameters + '("const-char*" "dirname") + ) ) -(define-function g_file_monitor_flags_get_type - (c-name "g_file_monitor_flags_get_type") - (return-type "GType") +(define-function g_io_modules_load_all_in_directory + (c-name "g_io_modules_load_all_in_directory") + (return-type "GList*") + (parameters + '("const-gchar*" "dirname") + ) ) -(define-function g_file_type_get_type - (c-name "g_file_type_get_type") - (return-type "GType") -) - -(define-function g_filesystem_preview_type_get_type - (c-name "g_filesystem_preview_type_get_type") - (return-type "GType") -) - -(define-function g_file_monitor_event_get_type - (c-name "g_file_monitor_event_get_type") - (return-type "GType") -) - -(define-function g_io_error_enum_get_type - (c-name "g_io_error_enum_get_type") - (return-type "GType") -) - -(define-function g_ask_password_flags_get_type - (c-name "g_ask_password_flags_get_type") - (return-type "GType") -) - -(define-function g_password_save_get_type - (c-name "g_password_save_get_type") - (return-type "GType") -) - -(define-function g_mount_operation_result_get_type - (c-name "g_mount_operation_result_get_type") - (return-type "GType") -) - -(define-function g_output_stream_splice_flags_get_type - (c-name "g_output_stream_splice_flags_get_type") - (return-type "GType") -) - -(define-function g_io_stream_splice_flags_get_type - (c-name "g_io_stream_splice_flags_get_type") - (return-type "GType") -) - -(define-function g_emblem_origin_get_type - (c-name "g_emblem_origin_get_type") - (return-type "GType") -) - -(define-function g_resolver_error_get_type - (c-name "g_resolver_error_get_type") - (return-type "GType") -) - -(define-function g_resolver_record_type_get_type - (c-name "g_resolver_record_type_get_type") - (return-type "GType") -) - -(define-function g_resource_error_get_type - (c-name "g_resource_error_get_type") - (return-type "GType") -) - -(define-function g_resource_flags_get_type - (c-name "g_resource_flags_get_type") - (return-type "GType") -) - -(define-function g_resource_lookup_flags_get_type - (c-name "g_resource_lookup_flags_get_type") - (return-type "GType") -) - -(define-function g_socket_family_get_type - (c-name "g_socket_family_get_type") - (return-type "GType") -) - -(define-function g_socket_type_get_type - (c-name "g_socket_type_get_type") - (return-type "GType") -) - -(define-function g_socket_msg_flags_get_type - (c-name "g_socket_msg_flags_get_type") - (return-type "GType") -) - -(define-function g_socket_protocol_get_type - (c-name "g_socket_protocol_get_type") - (return-type "GType") -) - -(define-function g_zlib_compressor_format_get_type - (c-name "g_zlib_compressor_format_get_type") - (return-type "GType") -) - -(define-function g_unix_socket_address_type_get_type - (c-name "g_unix_socket_address_type_get_type") - (return-type "GType") -) - -(define-function g_bus_type_get_type - (c-name "g_bus_type_get_type") - (return-type "GType") -) - -(define-function g_bus_name_owner_flags_get_type - (c-name "g_bus_name_owner_flags_get_type") - (return-type "GType") -) - -(define-function g_bus_name_watcher_flags_get_type - (c-name "g_bus_name_watcher_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_proxy_flags_get_type - (c-name "g_dbus_proxy_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_error_get_type - (c-name "g_dbus_error_get_type") - (return-type "GType") -) - -(define-function g_dbus_connection_flags_get_type - (c-name "g_dbus_connection_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_capability_flags_get_type - (c-name "g_dbus_capability_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_call_flags_get_type - (c-name "g_dbus_call_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_message_type_get_type - (c-name "g_dbus_message_type_get_type") - (return-type "GType") -) - -(define-function g_dbus_message_flags_get_type - (c-name "g_dbus_message_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_message_header_field_get_type - (c-name "g_dbus_message_header_field_get_type") - (return-type "GType") -) - -(define-function g_dbus_property_info_flags_get_type - (c-name "g_dbus_property_info_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_subtree_flags_get_type - (c-name "g_dbus_subtree_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_server_flags_get_type - (c-name "g_dbus_server_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_signal_flags_get_type - (c-name "g_dbus_signal_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_send_message_flags_get_type - (c-name "g_dbus_send_message_flags_get_type") - (return-type "GType") -) - -(define-function g_credentials_type_get_type - (c-name "g_credentials_type_get_type") - (return-type "GType") -) - -(define-function g_dbus_message_byte_order_get_type - (c-name "g_dbus_message_byte_order_get_type") - (return-type "GType") -) - -(define-function g_application_flags_get_type - (c-name "g_application_flags_get_type") - (return-type "GType") -) - -(define-function g_tls_error_get_type - (c-name "g_tls_error_get_type") - (return-type "GType") -) - -(define-function g_tls_certificate_flags_get_type - (c-name "g_tls_certificate_flags_get_type") - (return-type "GType") -) - -(define-function g_tls_authentication_mode_get_type - (c-name "g_tls_authentication_mode_get_type") - (return-type "GType") -) - -(define-function g_tls_rehandshake_mode_get_type - (c-name "g_tls_rehandshake_mode_get_type") - (return-type "GType") -) - -(define-function g_tls_password_flags_get_type - (c-name "g_tls_password_flags_get_type") - (return-type "GType") -) - -(define-function g_tls_interaction_result_get_type - (c-name "g_tls_interaction_result_get_type") - (return-type "GType") -) - -(define-function g_dbus_interface_skeleton_flags_get_type - (c-name "g_dbus_interface_skeleton_flags_get_type") - (return-type "GType") -) - -(define-function g_dbus_object_manager_client_flags_get_type - (c-name "g_dbus_object_manager_client_flags_get_type") - (return-type "GType") -) - -(define-function g_tls_database_verify_flags_get_type - (c-name "g_tls_database_verify_flags_get_type") - (return-type "GType") -) - -(define-function g_tls_database_lookup_flags_get_type - (c-name "g_tls_database_lookup_flags_get_type") - (return-type "GType") -) - -(define-function g_tls_certificate_request_flags_get_type - (c-name "g_tls_certificate_request_flags_get_type") - (return-type "GType") -) - -(define-function g_io_module_scope_flags_get_type - (c-name "g_io_module_scope_flags_get_type") - (return-type "GType") -) - -(define-function g_socket_client_event_get_type - (c-name "g_socket_client_event_get_type") - (return-type "GType") -) - -(define-function g_socket_listener_event_get_type - (c-name "g_socket_listener_event_get_type") - (return-type "GType") -) - -(define-function g_test_dbus_flags_get_type - (c-name "g_test_dbus_flags_get_type") - (return-type "GType") -) - -(define-function g_subprocess_flags_get_type - (c-name "g_subprocess_flags_get_type") - (return-type "GType") -) - -(define-function g_notification_priority_get_type - (c-name "g_notification_priority_get_type") - (return-type "GType") -) - -(define-function g_network_connectivity_get_type - (c-name "g_network_connectivity_get_type") - (return-type "GType") -) - -(define-function g_settings_bind_flags_get_type - (c-name "g_settings_bind_flags_get_type") - (return-type "GType") -) - - - -;; From gioerror.h - -(define-function g_io_error_quark - (c-name "g_io_error_quark") - (return-type "GQuark") -) - -(define-function g_io_error_from_errno - (c-name "g_io_error_from_errno") - (return-type "GIOErrorEnum") - (parameters - '("gint" "err_no") - ) -) - -(define-function g_io_error_from_win32_error - (c-name "g_io_error_from_win32_error") - (return-type "GIOErrorEnum") - (parameters - '("gint" "error_code") - ) -) - - - -;; From gio.h - - - -;; From giomodule.h - -(define-function g_io_module_scope_new - (c-name "g_io_module_scope_new") - (is-constructor-of "GIoModuleScope") - (return-type "GIOModuleScope*") - (parameters - '("GIOModuleScopeFlags" "flags") - ) -) - -(define-method free - (of-object "GIOModuleScope") - (c-name "g_io_module_scope_free") - (return-type "none") -) - -(define-method block - (of-object "GIOModuleScope") - (c-name "g_io_module_scope_block") - (return-type "none") - (parameters - '("const-gchar*" "basename") - ) -) - -(define-function g_io_module_get_type - (c-name "g_io_module_get_type") - (return-type "GType") -) - -(define-function g_io_module_new - (c-name "g_io_module_new") - (is-constructor-of "GIoModule") - (return-type "GIOModule*") - (parameters - '("const-gchar*" "filename") - ) -) - -(define-function g_io_modules_scan_all_in_directory - (c-name "g_io_modules_scan_all_in_directory") - (return-type "none") - (parameters - '("const-char*" "dirname") - ) -) - -(define-function g_io_modules_load_all_in_directory - (c-name "g_io_modules_load_all_in_directory") - (return-type "GList*") - (parameters - '("const-gchar*" "dirname") - ) -) - -(define-function g_io_modules_scan_all_in_directory_with_scope - (c-name "g_io_modules_scan_all_in_directory_with_scope") - (return-type "none") - (parameters - '("const-gchar*" "dirname") - '("GIOModuleScope*" "scope") - ) +(define-function g_io_modules_scan_all_in_directory_with_scope + (c-name "g_io_modules_scan_all_in_directory_with_scope") + (return-type "none") + (parameters + '("const-gchar*" "dirname") + '("GIOModuleScope*" "scope") + ) ) (define-function g_io_modules_load_all_in_directory_with_scope @@ -12955,6 +12608,51 @@ ) ) +(define-method get_is_tcrypt_hidden_volume + (of-object "GMountOperation") + (c-name "g_mount_operation_get_is_tcrypt_hidden_volume") + (return-type "gboolean") +) + +(define-method set_is_tcrypt_hidden_volume + (of-object "GMountOperation") + (c-name "g_mount_operation_set_is_tcrypt_hidden_volume") + (return-type "none") + (parameters + '("gboolean" "hidden_volume") + ) +) + +(define-method get_is_tcrypt_system_volume + (of-object "GMountOperation") + (c-name "g_mount_operation_get_is_tcrypt_system_volume") + (return-type "gboolean") +) + +(define-method set_is_tcrypt_system_volume + (of-object "GMountOperation") + (c-name "g_mount_operation_set_is_tcrypt_system_volume") + (return-type "none") + (parameters + '("gboolean" "system_volume") + ) +) + +(define-method get_pim + (of-object "GMountOperation") + (c-name "g_mount_operation_get_pim") + (return-type "guint") +) + +(define-method set_pim + (of-object "GMountOperation") + (c-name "g_mount_operation_set_pim") + (return-type "none") + (parameters + '("guint" "pim") + ) +) + ;; From gnativesocketaddress.h @@ -13050,15 +12748,6 @@ -;; From gnetworking.h - -(define-function g_networking_init - (c-name "g_networking_init") - (return-type "none") -) - - - ;; From gnetworkmonitorbase.h (define-function g_network_monitor_base_get_type @@ -13483,6 +13172,32 @@ ) ) +(define-method writev + (of-object "GOutputStream") + (c-name "g_output_stream_writev") + (return-type "gboolean") + (parameters + '("const-GOutputVector*" "vectors") + '("gsize" "n_vectors") + '("gsize*" "bytes_written") + '("GCancellable*" "cancellable") + '("GError**" "error") + ) +) + +(define-method writev_all + (of-object "GOutputStream") + (c-name "g_output_stream_writev_all") + (return-type "gboolean") + (parameters + '("GOutputVector*" "vectors") + '("gsize" "n_vectors") + '("gsize*" "bytes_written") + '("GCancellable*" "cancellable") + '("GError**" "error") + ) +) + (define-method printf (of-object "GOutputStream") (c-name "g_output_stream_printf") @@ -13601,6 +13316,56 @@ ) ) +(define-method writev_async + (of-object "GOutputStream") + (c-name "g_output_stream_writev_async") + (return-type "none") + (parameters + '("const-GOutputVector*" "vectors") + '("gsize" "n_vectors") + '("int" "io_priority") + '("GCancellable*" "cancellable") + '("GAsyncReadyCallback" "callback") + '("gpointer" "user_data") + ) +) + +(define-method writev_finish + (of-object "GOutputStream") + (c-name "g_output_stream_writev_finish") + (return-type "gboolean") + (parameters + '("GAsyncResult*" "result") + '("gsize*" "bytes_written") + '("GError**" "error") + ) +) + +(define-method writev_all_async + (of-object "GOutputStream") + (c-name "g_output_stream_writev_all_async") + (return-type "none") + (parameters + '("GOutputVector*" "vectors") + '("gsize" "n_vectors") + '("int" "io_priority") + '("GCancellable*" "cancellable") + '("GAsyncReadyCallback" "callback") + '("gpointer" "user_data") + ) +) + +(define-method writev_all_finish + (of-object "GOutputStream") + (c-name "g_output_stream_writev_all_finish") + (return-type "gboolean") + (parameters + '("GAsyncResult*" "result") + '("gsize*" "bytes_written") + '("GError**" "error") + ) +) + (define-method write_bytes_async (of-object "GOutputStream") (c-name "g_output_stream_write_bytes_async") @@ -13909,6 +13674,19 @@ ) ) +(define-method writev_nonblocking + (of-object "GPollableOutputStream") + (c-name "g_pollable_output_stream_writev_nonblocking") + (return-type "GPollableReturn") + (parameters + '("const-GOutputVector*" "vectors") + '("gsize" "n_vectors") + '("gsize*" "bytes_written") + '("GCancellable*" "cancellable") + '("GError**" "error") + ) +) + ;; From gpollableutils.h @@ -14298,6 +14076,41 @@ ) ) +(define-method lookup_by_name_with_flags_async + (of-object "GResolver") + (c-name "g_resolver_lookup_by_name_with_flags_async") + (return-type "none") + (parameters + '("const-gchar*" "hostname") + '("GResolverNameLookupFlags" "flags") + '("GCancellable*" "cancellable") + '("GAsyncReadyCallback" "callback") + '("gpointer" "user_data") + ) +) + +(define-method lookup_by_name_with_flags_finish + (of-object "GResolver") + (c-name "g_resolver_lookup_by_name_with_flags_finish") + (return-type "GList*") + (parameters + '("GAsyncResult*" "result") + '("GError**" "error") + ) +) + +(define-method lookup_by_name_with_flags + (of-object "GResolver") + (c-name "g_resolver_lookup_by_name_with_flags") + (return-type "GList*") + (parameters + '("const-gchar*" "hostname") + '("GResolverNameLookupFlags" "flags") + '("GCancellable*" "cancellable") + '("GError**" "error") + ) +) + (define-function g_resolver_free_addresses (c-name "g_resolver_free_addresses") (return-type "none") @@ -14879,6 +14692,11 @@ (return-type "GType") ) +(define-function g_keyfile_settings_backend_get_type + (c-name "g_keyfile_settings_backend_get_type") + (return-type "GType") +) + (define-function g_nextstep_settings_backend_get_type (c-name "g_nextstep_settings_backend_get_type") (return-type "GType") @@ -15644,6 +15462,12 @@ (return-type "GVariant*") ) +(define-method get_per_desktop_default + (of-object "GSettingsSchemaKey") + (c-name "g_settings_schema_key_get_per_desktop_default") + (return-type "GVariant*") +) + (define-method to_enum (of-object "GSettingsSchemaKey") (c-name "g_settings_schema_key_to_enum") @@ -16980,7 +16804,7 @@ (return-type "gboolean") (parameters '("GIOCondition" "condition") - '("gint64" "timeout") + '("gint64" "timeout_us") '("GCancellable*" "cancellable") '("GError**" "error") ) @@ -17190,6 +17014,24 @@ ) ) +(define-method send_message_with_timeout + (of-object "GSocket") + (c-name "g_socket_send_message_with_timeout") + (return-type "GPollableReturn") + (parameters + '("GSocketAddress*" "address") + '("const-GOutputVector*" "vectors") + '("gint" "num_vectors") + '("GSocketControlMessage**" "messages") + '("gint" "num_messages") + '("gint" "flags") + '("gint64" "timeout_us") + '("gsize*" "bytes_written") + '("GCancellable*" "cancellable") + '("GError**" "error") + ) +) + (define-method get_option (of-object "GSocket") (c-name "g_socket_get_option") @@ -17971,6 +17813,15 @@ ) ) +(define-method set_name + (of-object "GTask") + (c-name "g_task_set_name") + (return-type "none") + (parameters + '("const-gchar*" "name") + ) +) + (define-method get_source_object (of-object "GTask") (c-name "g_task_get_source_object") @@ -18009,8 +17860,14 @@ (define-method get_source_tag (of-object "GTask") - (c-name "g_task_get_source_tag") - (return-type "gpointer") + (c-name "g_task_get_source_tag") + (return-type "gpointer") +) + +(define-method get_name + (of-object "GTask") + (c-name "g_task_get_name") + (return-type "const-gchar*") ) (define-function g_task_is_valid @@ -18376,6 +18233,15 @@ (return-type "GTlsDatabase*") ) +(define-method set_default_database + (of-object "GTlsBackend") + (c-name "g_tls_backend_set_default_database") + (return-type "none") + (parameters + '("GTlsDatabase*" "database") + ) +) + (define-method supports_tls (of-object "GTlsBackend") (c-name "g_tls_backend_supports_tls") @@ -18687,6 +18553,21 @@ (return-type "GTlsRehandshakeMode") ) +(define-method set_advertised_protocols + (of-object "GTlsConnection") + (c-name "g_tls_connection_set_advertised_protocols") + (return-type "none") + (parameters + '("const-gchar*-const*" "protocols") + ) +) + +(define-method get_negotiated_protocol + (of-object "GTlsConnection") + (c-name "g_tls_connection_get_negotiated_protocol") + (return-type "const-gchar*") +) + (define-method handshake (of-object "GTlsConnection") (c-name "g_tls_connection_handshake") @@ -19139,6 +19020,19 @@ +;; From gtrashportal.h + +(define-function g_trash_portal_trash_file + (c-name "g_trash_portal_trash_file") + (return-type "gboolean") + (parameters + '("GFile*" "file") + '("GError**" "error") + ) +) + + + ;; From gunionvolumemonitor.h @@ -19486,6 +19380,14 @@ ) ) +(define-function g_unix_mount_get_root_path + (c-name "g_unix_mount_get_root_path") + (return-type "const-char*") + (parameters + '("GUnixMountEntry*" "mount_entry") + ) +) + (define-function g_unix_mount_get_fs_type (c-name "g_unix_mount_get_fs_type") (return-type "const-char*") @@ -19494,6 +19396,14 @@ ) ) +(define-function g_unix_mount_get_options + (c-name "g_unix_mount_get_options") + (return-type "const-char*") + (parameters + '("GUnixMountEntry*" "mount_entry") + ) +) + (define-function g_unix_mount_is_readonly (c-name "g_unix_mount_is_readonly") (return-type "gboolean") @@ -20613,1070 +20523,413 @@ -;; From xdp-dbus.h - -(define-function gxdp_documents_get_type - (c-name "gxdp_documents_get_type") - (return-type "GType") -) - -(define-function gxdp_documents_interface_info - (c-name "gxdp_documents_interface_info") - (return-type "GDBusInterfaceInfo*") -) - -(define-function gxdp_documents_override_properties - (c-name "gxdp_documents_override_properties") - (return-type "guint") - (parameters - '("GObjectClass*" "klass") - '("guint" "property_id_begin") - ) -) - -(define-method complete_get_mount_point - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_get_mount_point") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("const-gchar*" "path") - ) -) - -(define-method complete_add - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_add") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("GUnixFDList*" "fd_list") - '("const-gchar*" "doc_id") - ) -) - -(define-method complete_add_named - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_add_named") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("GUnixFDList*" "fd_list") - '("const-gchar*" "doc_id") - ) -) - -(define-method complete_add_full - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_add_full") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("GUnixFDList*" "fd_list") - '("const-gchar*-const*" "doc_ids") - '("GVariant*" "extra_out") - ) -) - -(define-method complete_grant_permissions - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_grant_permissions") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - ) -) - -(define-method complete_revoke_permissions - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_revoke_permissions") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - ) -) - -(define-method complete_delete - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_delete") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - ) -) - -(define-method complete_lookup - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_lookup") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("const-gchar*" "doc_id") - ) -) - -(define-method complete_info - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_info") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("const-gchar*" "path") - '("GVariant*" "apps") - ) -) - -(define-method complete_list - (of-object "GXdpDocuments") - (c-name "gxdp_documents_complete_list") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("GVariant*" "docs") - ) -) - -(define-method call_get_mount_point - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_get_mount_point") - (return-type "none") - (parameters - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) -) - -(define-method call_get_mount_point_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_get_mount_point_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_path") - '("GAsyncResult*" "res") - '("GError**" "error") - ) -) - -(define-method call_get_mount_point_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_get_mount_point_sync") - (return-type "gboolean") - (parameters - '("gchar**" "out_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) -) - -(define-method call_add - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add") - (return-type "none") - (parameters - '("GVariant*" "arg_o_path_fd") - '("gboolean" "arg_reuse_existing") - '("gboolean" "arg_persistent") - '("GUnixFDList*" "fd_list") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) -) +;; From gconstructor_as_data.h -(define-method call_add_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_doc_id") - '("GUnixFDList**" "out_fd_list") - '("GAsyncResult*" "res") - '("GError**" "error") - ) -) -(define-method call_add_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_sync") - (return-type "gboolean") - (parameters - '("GVariant*" "arg_o_path_fd") - '("gboolean" "arg_reuse_existing") - '("gboolean" "arg_persistent") - '("GUnixFDList*" "fd_list") - '("gchar**" "out_doc_id") - '("GUnixFDList**" "out_fd_list") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) -) -(define-method call_add_named - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_named") - (return-type "none") - (parameters - '("GVariant*" "arg_o_path_parent_fd") - '("const-gchar*" "arg_filename") - '("gboolean" "arg_reuse_existing") - '("gboolean" "arg_persistent") - '("GUnixFDList*" "fd_list") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) -) +;; From gdbus-daemon-generated.h -(define-method call_add_named_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_named_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_doc_id") - '("GUnixFDList**" "out_fd_list") - '("GAsyncResult*" "res") - '("GError**" "error") - ) -) -(define-method call_add_named_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_named_sync") - (return-type "gboolean") - (parameters - '("GVariant*" "arg_o_path_parent_fd") - '("const-gchar*" "arg_filename") - '("gboolean" "arg_reuse_existing") - '("gboolean" "arg_persistent") - '("GUnixFDList*" "fd_list") - '("gchar**" "out_doc_id") - '("GUnixFDList**" "out_fd_list") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) -) -(define-method call_add_full - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_full") - (return-type "none") - (parameters - '("GVariant*" "arg_o_path_fds") - '("guint" "arg_flags") - '("const-gchar*" "arg_app_id") - '("const-gchar*-const*" "arg_permissions") - '("GUnixFDList*" "fd_list") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) -) +;; From gioenumtypes.h -(define-method call_add_full_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_full_finish") - (return-type "gboolean") - (parameters - '("gchar***" "out_doc_ids") - '("GVariant**" "out_extra_out") - '("GUnixFDList**" "out_fd_list") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_app_info_create_flags_get_type + (c-name "g_app_info_create_flags_get_type") + (return-type "GType") ) -(define-method call_add_full_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_add_full_sync") - (return-type "gboolean") - (parameters - '("GVariant*" "arg_o_path_fds") - '("guint" "arg_flags") - '("const-gchar*" "arg_app_id") - '("const-gchar*-const*" "arg_permissions") - '("GUnixFDList*" "fd_list") - '("gchar***" "out_doc_ids") - '("GVariant**" "out_extra_out") - '("GUnixFDList**" "out_fd_list") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_converter_flags_get_type + (c-name "g_converter_flags_get_type") + (return-type "GType") ) -(define-method call_grant_permissions - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_grant_permissions") - (return-type "none") - (parameters - '("const-gchar*" "arg_doc_id") - '("const-gchar*" "arg_app_id") - '("const-gchar*-const*" "arg_permissions") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_converter_result_get_type + (c-name "g_converter_result_get_type") + (return-type "GType") ) -(define-method call_grant_permissions_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_grant_permissions_finish") - (return-type "gboolean") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_data_stream_byte_order_get_type + (c-name "g_data_stream_byte_order_get_type") + (return-type "GType") ) -(define-method call_grant_permissions_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_grant_permissions_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_doc_id") - '("const-gchar*" "arg_app_id") - '("const-gchar*-const*" "arg_permissions") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_data_stream_newline_type_get_type + (c-name "g_data_stream_newline_type_get_type") + (return-type "GType") ) -(define-method call_revoke_permissions - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_revoke_permissions") - (return-type "none") - (parameters - '("const-gchar*" "arg_doc_id") - '("const-gchar*" "arg_app_id") - '("const-gchar*-const*" "arg_permissions") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_file_attribute_type_get_type + (c-name "g_file_attribute_type_get_type") + (return-type "GType") ) -(define-method call_revoke_permissions_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_revoke_permissions_finish") - (return-type "gboolean") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_file_attribute_info_flags_get_type + (c-name "g_file_attribute_info_flags_get_type") + (return-type "GType") ) -(define-method call_revoke_permissions_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_revoke_permissions_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_doc_id") - '("const-gchar*" "arg_app_id") - '("const-gchar*-const*" "arg_permissions") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_file_attribute_status_get_type + (c-name "g_file_attribute_status_get_type") + (return-type "GType") ) -(define-method call_delete - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_delete") - (return-type "none") - (parameters - '("const-gchar*" "arg_doc_id") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_file_query_info_flags_get_type + (c-name "g_file_query_info_flags_get_type") + (return-type "GType") ) -(define-method call_delete_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_delete_finish") - (return-type "gboolean") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_file_create_flags_get_type + (c-name "g_file_create_flags_get_type") + (return-type "GType") ) -(define-method call_delete_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_delete_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_doc_id") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_file_measure_flags_get_type + (c-name "g_file_measure_flags_get_type") + (return-type "GType") ) -(define-method call_lookup - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_lookup") - (return-type "none") - (parameters - '("const-gchar*" "arg_filename") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_mount_mount_flags_get_type + (c-name "g_mount_mount_flags_get_type") + (return-type "GType") ) -(define-method call_lookup_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_lookup_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_doc_id") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_mount_unmount_flags_get_type + (c-name "g_mount_unmount_flags_get_type") + (return-type "GType") ) -(define-method call_lookup_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_lookup_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_filename") - '("gchar**" "out_doc_id") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_drive_start_flags_get_type + (c-name "g_drive_start_flags_get_type") + (return-type "GType") ) -(define-method call_info - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_info") - (return-type "none") - (parameters - '("const-gchar*" "arg_doc_id") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_drive_start_stop_type_get_type + (c-name "g_drive_start_stop_type_get_type") + (return-type "GType") ) -(define-method call_info_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_info_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_path") - '("GVariant**" "out_apps") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_file_copy_flags_get_type + (c-name "g_file_copy_flags_get_type") + (return-type "GType") ) -(define-method call_info_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_info_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_doc_id") - '("gchar**" "out_path") - '("GVariant**" "out_apps") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_file_monitor_flags_get_type + (c-name "g_file_monitor_flags_get_type") + (return-type "GType") ) -(define-method call_list - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_list") - (return-type "none") - (parameters - '("const-gchar*" "arg_app_id") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_file_type_get_type + (c-name "g_file_type_get_type") + (return-type "GType") ) -(define-method call_list_finish - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_list_finish") - (return-type "gboolean") - (parameters - '("GVariant**" "out_docs") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_filesystem_preview_type_get_type + (c-name "g_filesystem_preview_type_get_type") + (return-type "GType") ) -(define-method call_list_sync - (of-object "GXdpDocuments") - (c-name "gxdp_documents_call_list_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_app_id") - '("GVariant**" "out_docs") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_file_monitor_event_get_type + (c-name "g_file_monitor_event_get_type") + (return-type "GType") ) -(define-method get_version - (of-object "GXdpDocuments") - (c-name "gxdp_documents_get_version") - (return-type "guint") +(define-function g_io_error_enum_get_type + (c-name "g_io_error_enum_get_type") + (return-type "GType") ) -(define-method set_version - (of-object "GXdpDocuments") - (c-name "gxdp_documents_set_version") - (return-type "none") - (parameters - '("guint" "value") - ) +(define-function g_ask_password_flags_get_type + (c-name "g_ask_password_flags_get_type") + (return-type "GType") ) -(define-function gxdp_documents_proxy_get_type - (c-name "gxdp_documents_proxy_get_type") +(define-function g_password_save_get_type + (c-name "g_password_save_get_type") (return-type "GType") ) -(define-function gxdp_documents_proxy_new_finish - (c-name "gxdp_documents_proxy_new_finish") - (return-type "GXdpDocuments*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_mount_operation_result_get_type + (c-name "g_mount_operation_result_get_type") + (return-type "GType") ) -(define-function gxdp_documents_proxy_new_sync - (c-name "gxdp_documents_proxy_new_sync") - (return-type "GXdpDocuments*") - (parameters - '("GDBusConnection*" "connection") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_output_stream_splice_flags_get_type + (c-name "g_output_stream_splice_flags_get_type") + (return-type "GType") ) -(define-function gxdp_documents_proxy_new_for_bus - (c-name "gxdp_documents_proxy_new_for_bus") - (return-type "none") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_io_stream_splice_flags_get_type + (c-name "g_io_stream_splice_flags_get_type") + (return-type "GType") ) -(define-function gxdp_documents_proxy_new_for_bus_finish - (c-name "gxdp_documents_proxy_new_for_bus_finish") - (return-type "GXdpDocuments*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_emblem_origin_get_type + (c-name "g_emblem_origin_get_type") + (return-type "GType") ) -(define-function gxdp_documents_proxy_new_for_bus_sync - (c-name "gxdp_documents_proxy_new_for_bus_sync") - (return-type "GXdpDocuments*") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_resolver_error_get_type + (c-name "g_resolver_error_get_type") + (return-type "GType") ) -(define-function gxdp_documents_skeleton_get_type - (c-name "gxdp_documents_skeleton_get_type") +(define-function g_resolver_record_type_get_type + (c-name "g_resolver_record_type_get_type") (return-type "GType") ) -(define-function gxdp_open_uri_get_type - (c-name "gxdp_open_uri_get_type") +(define-function g_resource_error_get_type + (c-name "g_resource_error_get_type") (return-type "GType") ) -(define-function gxdp_open_uri_interface_info - (c-name "gxdp_open_uri_interface_info") - (return-type "GDBusInterfaceInfo*") +(define-function g_resource_flags_get_type + (c-name "g_resource_flags_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_override_properties - (c-name "gxdp_open_uri_override_properties") - (return-type "guint") - (parameters - '("GObjectClass*" "klass") - '("guint" "property_id_begin") - ) +(define-function g_resource_lookup_flags_get_type + (c-name "g_resource_lookup_flags_get_type") + (return-type "GType") ) -(define-method complete_open_uri - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_complete_open_uri") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("const-gchar*" "handle") - ) +(define-function g_socket_family_get_type + (c-name "g_socket_family_get_type") + (return-type "GType") ) -(define-method complete_open_file - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_complete_open_file") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("GUnixFDList*" "fd_list") - '("const-gchar*" "handle") - ) +(define-function g_socket_type_get_type + (c-name "g_socket_type_get_type") + (return-type "GType") ) -(define-method call_open_uri - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_call_open_uri") - (return-type "none") - (parameters - '("const-gchar*" "arg_parent_window") - '("const-gchar*" "arg_uri") - '("GVariant*" "arg_options") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_socket_msg_flags_get_type + (c-name "g_socket_msg_flags_get_type") + (return-type "GType") ) -(define-method call_open_uri_finish - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_call_open_uri_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_handle") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_socket_protocol_get_type + (c-name "g_socket_protocol_get_type") + (return-type "GType") ) -(define-method call_open_uri_sync - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_call_open_uri_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_parent_window") - '("const-gchar*" "arg_uri") - '("GVariant*" "arg_options") - '("gchar**" "out_handle") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_zlib_compressor_format_get_type + (c-name "g_zlib_compressor_format_get_type") + (return-type "GType") ) -(define-method call_open_file - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_call_open_file") - (return-type "none") - (parameters - '("const-gchar*" "arg_parent_window") - '("GVariant*" "arg_fd") - '("GVariant*" "arg_options") - '("GUnixFDList*" "fd_list") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_unix_socket_address_type_get_type + (c-name "g_unix_socket_address_type_get_type") + (return-type "GType") ) -(define-method call_open_file_finish - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_call_open_file_finish") - (return-type "gboolean") - (parameters - '("gchar**" "out_handle") - '("GUnixFDList**" "out_fd_list") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_bus_type_get_type + (c-name "g_bus_type_get_type") + (return-type "GType") ) -(define-method call_open_file_sync - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_call_open_file_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_parent_window") - '("GVariant*" "arg_fd") - '("GVariant*" "arg_options") - '("GUnixFDList*" "fd_list") - '("gchar**" "out_handle") - '("GUnixFDList**" "out_fd_list") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_bus_name_owner_flags_get_type + (c-name "g_bus_name_owner_flags_get_type") + (return-type "GType") ) -(define-method get_version - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_get_version") - (return-type "guint") +(define-function g_bus_name_watcher_flags_get_type + (c-name "g_bus_name_watcher_flags_get_type") + (return-type "GType") ) -(define-method set_version - (of-object "GXdpOpenURI") - (c-name "gxdp_open_uri_set_version") - (return-type "none") - (parameters - '("guint" "value") - ) +(define-function g_dbus_proxy_flags_get_type + (c-name "g_dbus_proxy_flags_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_proxy_get_type - (c-name "gxdp_open_uri_proxy_get_type") +(define-function g_dbus_error_get_type + (c-name "g_dbus_error_get_type") (return-type "GType") ) -(define-function gxdp_open_uri_proxy_new_finish - (c-name "gxdp_open_uri_proxy_new_finish") - (return-type "GXdpOpenURI*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_dbus_connection_flags_get_type + (c-name "g_dbus_connection_flags_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_proxy_new_sync - (c-name "gxdp_open_uri_proxy_new_sync") - (return-type "GXdpOpenURI*") - (parameters - '("GDBusConnection*" "connection") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_dbus_capability_flags_get_type + (c-name "g_dbus_capability_flags_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_proxy_new_for_bus - (c-name "gxdp_open_uri_proxy_new_for_bus") - (return-type "none") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_dbus_call_flags_get_type + (c-name "g_dbus_call_flags_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_proxy_new_for_bus_finish - (c-name "gxdp_open_uri_proxy_new_for_bus_finish") - (return-type "GXdpOpenURI*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_dbus_message_type_get_type + (c-name "g_dbus_message_type_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_proxy_new_for_bus_sync - (c-name "gxdp_open_uri_proxy_new_for_bus_sync") - (return-type "GXdpOpenURI*") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_dbus_message_flags_get_type + (c-name "g_dbus_message_flags_get_type") + (return-type "GType") ) -(define-function gxdp_open_uri_skeleton_get_type - (c-name "gxdp_open_uri_skeleton_get_type") +(define-function g_dbus_message_header_field_get_type + (c-name "g_dbus_message_header_field_get_type") (return-type "GType") ) -(define-function gxdp_network_monitor_get_type - (c-name "gxdp_network_monitor_get_type") +(define-function g_dbus_property_info_flags_get_type + (c-name "g_dbus_property_info_flags_get_type") (return-type "GType") ) -(define-function gxdp_network_monitor_interface_info - (c-name "gxdp_network_monitor_interface_info") - (return-type "GDBusInterfaceInfo*") +(define-function g_dbus_subtree_flags_get_type + (c-name "g_dbus_subtree_flags_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_override_properties - (c-name "gxdp_network_monitor_override_properties") - (return-type "guint") - (parameters - '("GObjectClass*" "klass") - '("guint" "property_id_begin") - ) +(define-function g_dbus_server_flags_get_type + (c-name "g_dbus_server_flags_get_type") + (return-type "GType") ) -(define-method emit_changed - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_emit_changed") - (return-type "none") - (parameters - '("gboolean" "arg_available") - ) +(define-function g_dbus_signal_flags_get_type + (c-name "g_dbus_signal_flags_get_type") + (return-type "GType") ) -(define-method get_available - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_get_available") - (return-type "gboolean") +(define-function g_dbus_send_message_flags_get_type + (c-name "g_dbus_send_message_flags_get_type") + (return-type "GType") ) -(define-method set_available - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_set_available") - (return-type "none") - (parameters - '("gboolean" "value") - ) +(define-function g_credentials_type_get_type + (c-name "g_credentials_type_get_type") + (return-type "GType") ) -(define-method get_metered - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_get_metered") - (return-type "gboolean") +(define-function g_dbus_message_byte_order_get_type + (c-name "g_dbus_message_byte_order_get_type") + (return-type "GType") ) -(define-method set_metered - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_set_metered") - (return-type "none") - (parameters - '("gboolean" "value") - ) +(define-function g_application_flags_get_type + (c-name "g_application_flags_get_type") + (return-type "GType") ) -(define-method get_connectivity - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_get_connectivity") - (return-type "guint") +(define-function g_tls_error_get_type + (c-name "g_tls_error_get_type") + (return-type "GType") ) -(define-method set_connectivity - (of-object "GXdpNetworkMonitor") - (c-name "gxdp_network_monitor_set_connectivity") - (return-type "none") - (parameters - '("guint" "value") - ) +(define-function g_tls_certificate_flags_get_type + (c-name "g_tls_certificate_flags_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_proxy_get_type - (c-name "gxdp_network_monitor_proxy_get_type") +(define-function g_tls_authentication_mode_get_type + (c-name "g_tls_authentication_mode_get_type") (return-type "GType") ) -(define-function gxdp_network_monitor_proxy_new_finish - (c-name "gxdp_network_monitor_proxy_new_finish") - (return-type "GXdpNetworkMonitor*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_tls_rehandshake_mode_get_type + (c-name "g_tls_rehandshake_mode_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_proxy_new_sync - (c-name "gxdp_network_monitor_proxy_new_sync") - (return-type "GXdpNetworkMonitor*") - (parameters - '("GDBusConnection*" "connection") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_tls_password_flags_get_type + (c-name "g_tls_password_flags_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_proxy_new_for_bus - (c-name "gxdp_network_monitor_proxy_new_for_bus") - (return-type "none") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_tls_interaction_result_get_type + (c-name "g_tls_interaction_result_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_proxy_new_for_bus_finish - (c-name "gxdp_network_monitor_proxy_new_for_bus_finish") - (return-type "GXdpNetworkMonitor*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_dbus_interface_skeleton_flags_get_type + (c-name "g_dbus_interface_skeleton_flags_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_proxy_new_for_bus_sync - (c-name "gxdp_network_monitor_proxy_new_for_bus_sync") - (return-type "GXdpNetworkMonitor*") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_dbus_object_manager_client_flags_get_type + (c-name "g_dbus_object_manager_client_flags_get_type") + (return-type "GType") ) -(define-function gxdp_network_monitor_skeleton_get_type - (c-name "gxdp_network_monitor_skeleton_get_type") +(define-function g_tls_database_verify_flags_get_type + (c-name "g_tls_database_verify_flags_get_type") (return-type "GType") ) -(define-function gxdp_proxy_resolver_get_type - (c-name "gxdp_proxy_resolver_get_type") +(define-function g_tls_database_lookup_flags_get_type + (c-name "g_tls_database_lookup_flags_get_type") (return-type "GType") ) -(define-function gxdp_proxy_resolver_interface_info - (c-name "gxdp_proxy_resolver_interface_info") - (return-type "GDBusInterfaceInfo*") +(define-function g_tls_certificate_request_flags_get_type + (c-name "g_tls_certificate_request_flags_get_type") + (return-type "GType") ) -(define-function gxdp_proxy_resolver_override_properties - (c-name "gxdp_proxy_resolver_override_properties") - (return-type "guint") - (parameters - '("GObjectClass*" "klass") - '("guint" "property_id_begin") - ) +(define-function g_io_module_scope_flags_get_type + (c-name "g_io_module_scope_flags_get_type") + (return-type "GType") ) -(define-method complete_lookup - (of-object "GXdpProxyResolver") - (c-name "gxdp_proxy_resolver_complete_lookup") - (return-type "none") - (parameters - '("GDBusMethodInvocation*" "invocation") - '("const-gchar*-const*" "proxies") - ) +(define-function g_socket_client_event_get_type + (c-name "g_socket_client_event_get_type") + (return-type "GType") ) -(define-method call_lookup - (of-object "GXdpProxyResolver") - (c-name "gxdp_proxy_resolver_call_lookup") - (return-type "none") - (parameters - '("const-gchar*" "arg_uri") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_socket_listener_event_get_type + (c-name "g_socket_listener_event_get_type") + (return-type "GType") ) -(define-method call_lookup_finish - (of-object "GXdpProxyResolver") - (c-name "gxdp_proxy_resolver_call_lookup_finish") - (return-type "gboolean") - (parameters - '("gchar***" "out_proxies") - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_test_dbus_flags_get_type + (c-name "g_test_dbus_flags_get_type") + (return-type "GType") ) -(define-method call_lookup_sync - (of-object "GXdpProxyResolver") - (c-name "gxdp_proxy_resolver_call_lookup_sync") - (return-type "gboolean") - (parameters - '("const-gchar*" "arg_uri") - '("gchar***" "out_proxies") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_subprocess_flags_get_type + (c-name "g_subprocess_flags_get_type") + (return-type "GType") ) -(define-function gxdp_proxy_resolver_proxy_get_type - (c-name "gxdp_proxy_resolver_proxy_get_type") +(define-function g_notification_priority_get_type + (c-name "g_notification_priority_get_type") (return-type "GType") ) -(define-function gxdp_proxy_resolver_proxy_new_finish - (c-name "gxdp_proxy_resolver_proxy_new_finish") - (return-type "GXdpProxyResolver*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_network_connectivity_get_type + (c-name "g_network_connectivity_get_type") + (return-type "GType") ) -(define-function gxdp_proxy_resolver_proxy_new_sync - (c-name "gxdp_proxy_resolver_proxy_new_sync") - (return-type "GXdpProxyResolver*") - (parameters - '("GDBusConnection*" "connection") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) +(define-function g_pollable_return_get_type + (c-name "g_pollable_return_get_type") + (return-type "GType") ) -(define-function gxdp_proxy_resolver_proxy_new_for_bus - (c-name "gxdp_proxy_resolver_proxy_new_for_bus") - (return-type "none") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GAsyncReadyCallback" "callback") - '("gpointer" "user_data") - ) +(define-function g_resolver_name_lookup_flags_get_type + (c-name "g_resolver_name_lookup_flags_get_type") + (return-type "GType") ) -(define-function gxdp_proxy_resolver_proxy_new_for_bus_finish - (c-name "gxdp_proxy_resolver_proxy_new_for_bus_finish") - (return-type "GXdpProxyResolver*") - (parameters - '("GAsyncResult*" "res") - '("GError**" "error") - ) +(define-function g_settings_bind_flags_get_type + (c-name "g_settings_bind_flags_get_type") + (return-type "GType") ) -(define-function gxdp_proxy_resolver_proxy_new_for_bus_sync - (c-name "gxdp_proxy_resolver_proxy_new_for_bus_sync") - (return-type "GXdpProxyResolver*") - (parameters - '("GBusType" "bus_type") - '("GDBusProxyFlags" "flags") - '("const-gchar*" "name") - '("const-gchar*" "object_path") - '("GCancellable*" "cancellable") - '("GError**" "error") - ) -) -(define-function gxdp_proxy_resolver_skeleton_get_type - (c-name "gxdp_proxy_resolver_skeleton_get_type") - (return-type "GType") + +;; From gnetworking.h + +(define-function g_networking_init + (c-name "g_networking_init") + (return-type "none") ) diff --git a/gio/src/gio_signals.defs b/gio/src/gio_signals.defs index c0eae3c9..ac668062 100644 --- a/gio/src/gio_signals.defs +++ b/gio/src/gio_signals.defs @@ -142,6 +142,12 @@ ) ) +(define-signal name-lost + (of-object "GApplication") + (return-type "gboolean") + (flags "Run Last") +) + (define-property application-id (of-object "GApplication") (prop-type "GParamString") @@ -842,6 +848,36 @@ (default-value "0") ) +(define-property is-tcrypt-hidden-volume + (of-object "GMountOperation") + (prop-type "GParamBoolean") + (docs "Whether to unlock a TCRYPT hidden volume. See https://www.veracrypt.fr/en/Hidden%20Volume.html.") + (readable #t) + (writable #t) + (construct-only #f) + (default-value "FALSE") +) + +(define-property is-tcrypt-system-volume + (of-object "GMountOperation") + (prop-type "GParamBoolean") + (docs "Whether to unlock a TCRYPT system volume. Only supported for unlocking Windows system volumes. See https://www.veracrypt.fr/en/System%20Encryption.html.") + (readable #t) + (writable #t) + (construct-only #f) + (default-value "FALSE") +) + +(define-property pim + (of-object "GMountOperation") + (prop-type "GParamUInt") + (docs "The VeraCrypt PIM value") + (readable #t) + (writable #t) + (construct-only #f) + (default-value "0") +) + ;; From GNotification ;; From GPermission @@ -2339,6 +2375,7 @@ (readable #t) (writable #t) (construct-only #f) + (deprecated #t) (default-value "G_TLS_REHANDSHAKE_SAFELY") ) @@ -2399,6 +2436,25 @@ (default-value "0") ) +(define-property advertised-protocols + (of-object "GTlsConnection") + (prop-type "GParamBoxed") + (docs "Application-layer protocols available on this connection") + (readable #t) + (writable #t) + (construct-only #f) +) + +(define-property negotiated-protocol + (of-object "GTlsConnection") + (prop-type "GParamString") + (docs "Application-layer protocol negotiated for this connection") + (readable #t) + (writable #f) + (construct-only #f) + (default-value "") +) + ;; From GTlsDatabase ;; From GTlsFileDatabase @@ -2583,7 +2639,7 @@ (of-object "GDBusConnection") (prop-type "GParamFlags") (docs "Flags") - (readable #f) + (readable #t) (writable #t) (construct-only #t) (default-value "G_DBUS_CONNECTION_FLAGS_NONE") diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml index de2fe402..2358f9db 100644 --- a/glib/src/glib_docs.xml +++ b/glib/src/glib_docs.xml @@ -1199,11 +1199,17 @@ Since: 2.54 -The notify signal is emitted on an object when one of its -properties has been changed. Note that getting this signal -doesn't guarantee that the value of the property has actually -changed, it may also be emitted when the setter for the property -is called to reinstate the previous value. +The notify signal is emitted on an object when one of its properties has +its value set through g_object_set_property(), g_object_set(), et al. + +Note that getting this signal doesn’t itself guarantee that the value of +the property has actually changed. When it is emitted is determined by the +derived GObject class. If the implementor did not create the property with +%G_PARAM_EXPLICIT_NOTIFY, then any call to g_object_set_property() results +in ::notify being emitted, even if the new value is the same as the old. +If they did pass %G_PARAM_EXPLICIT_NOTIFY, then this signal is emitted only +when they explicitly call g_object_notify() or g_object_notify_by_pspec(), +and common practice is to do that only when the value has actually changed. This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the @@ -1214,7 +1220,7 @@ G_CALLBACK (gtk_text_view_target_list_notify), text_view) ]| It is important to note that you must use -[canonical][canonical-parameter-name] parameter names as +[canonical parameter names][canonical-parameter-names] as detail strings for the notify signal. @@ -3502,6 +3508,34 @@ Old South Arabian. Since 2.26 Zanabazar Square. Since: 2.54 + + Dogra. Since: 2.58 + + + + Gunjala Gondi. Since: 2.58 + + + + Hanifi Rohingya. Since: 2.58 + + + + Makasar. Since: 2.58 + + + + Medefaidrin. Since: 2.58 + + + + Old Sogdian. Since: 2.58 + + + + Sogdian. Since: 2.58 + + @@ -4024,15 +4058,15 @@ Adds @len elements onto the end of the array. Frees the memory allocated for the #GArray. If @free_segment is -%TRUE it frees the memory block holding the elements as well and -also each element if @array has a @element_free_func set. Pass +%TRUE it frees the memory block holding the elements as well. Pass %FALSE if you want to free the #GArray wrapper but preserve the -underlying array for use elsewhere. If the reference count of @array -is greater than one, the #GArray wrapper is preserved but the size -of @array will be set to zero. +underlying array for use elsewhere. If the reference count of +@array is greater than one, the #GArray wrapper is preserved but +the size of @array will be set to zero. -If array elements contain dynamically-allocated memory, they should -be freed separately. +If array contents point to dynamically-allocated memory, they should +be freed separately if @free_seg is %TRUE and no @clear_func +function has been set for @array. This function is not thread-safe. If using a #GArray from multiple threads, use only the atomic g_array_ref() and g_array_unref() @@ -4138,6 +4172,14 @@ such as "27". You must use variables. Inserts @len elements into a #GArray at the given index. +If @index_ is greater than the array’s current length, the array is expanded. +The elements between the old end of the array and the newly inserted elements +will be initialised to zero if the array was configured to clear elements; +otherwise their values will be undefined. + +@data may be %NULL if (and only if) @len is zero. If @len is zero, this +function is a no-op. + @@ -4221,6 +4263,9 @@ such as "27". You must use variables. Adds @len elements onto the start of the array. +@data may be %NULL if (and only if) @len is zero. If @len is zero, this +function is a no-op. + This operation is slower than g_array_append_vals() since the existing elements in the array have to be moved to make space for the new elements. @@ -4237,7 +4282,7 @@ the new elements. - the number of elements to prepend + the number of elements to prepend, which may be zero @@ -4948,7 +4993,8 @@ This function assumes that @str contains only a number of the given @base that is within inclusive bounds limited by @min and @max. If this is true, then the converted number is stored in @out_num. An empty string is not a valid input. A string with leading or -trailing whitespace is also an invalid input. +trailing whitespace is also an invalid input. A string with a leading sign +(`-` or `+`) is not a valid input for the unsigned parser. @base can be between 2 and 36 inclusive. Hexadecimal numbers must not be prefixed with "0x" or "0X". Such a problem does not exist @@ -5126,6 +5172,11 @@ does in the C locale. It does this without actually changing the current locale, since that would not be thread-safe. +Note that input with a leading minus sign (`-`) is accepted, and will return +the negation of the parsed number, unless that would overflow a #guint64. +Critically, this means you cannot assume that a short fixed length input will +never result in a low return value, as the input could have a leading `-`. + This function is typically used when reading configuration files or other non-user input that should be locale independent. To handle input from the user you should normally use the @@ -5262,7 +5313,10 @@ an error message is logged and the application is terminated. The macro can be turned off in final releases of code by defining `G_DISABLE_ASSERT` when compiling the application, so code must -not depend on any side effects from @expr. +not depend on any side effects from @expr. Similarly, it must not be used +in unit tests, otherwise the unit tests will be ineffective if compiled with +`G_DISABLE_ASSERT`. Use g_assert_true() and related macros in unit tests +instead. @@ -5293,13 +5347,43 @@ Since: 2.16 The comparison operator to use. -One of ==, !=, <, >, <=, >=. +One of `==`, `!=`, `<`, `>`, `<=`, `>=`. + + + + another floating point number + + + + + + + + +Debugging macro to compare two floating point numbers within an epsilon. + +The effect of `g_assert_cmpfloat_with_epsilon (n1, n2, epsilon)` is +the same as `g_assert_true (abs (n1 - n2) < epsilon)`. The advantage +of this macro is that it can produce a message that includes the +actual values of @n1 and @n2. + +Since: 2.58 + + + + + an floating point number another floating point number + + a numeric value that expresses the expected tolerance +between @n1 and @n2 + + @@ -5321,7 +5405,7 @@ Since: 2.16 The comparison operator to use. -One of ==, !=, <, >, <=, >=. +One of `==`, `!=`, `<`, `>`, `<=`, `>=`. @@ -5351,7 +5435,7 @@ Since: 2.16 The comparison operator to use. -One of ==, !=, <, >, <=, >=. +One of `==`, `!=`, `<`, `>`, `<=`, `>=`. @@ -5427,7 +5511,7 @@ Since: 2.16 The comparison operator to use. -One of ==, !=, <, >, <=, >=. +One of `==`, `!=`, `<`, `>`, `<=`, `>=`. @@ -5457,7 +5541,7 @@ Since: 2.16 The comparison operator to use. -One of ==, !=, <, >, <=, >=. +One of `==`, `!=`, `<`, `>`, `<=`, `>=`. @@ -5468,6 +5552,33 @@ One of ==, !=, <, >, <=, >=. + + +Debugging macro to compare two #GVariants. If the comparison fails, +an error message is logged and the application is either terminated +or the testcase marked as failed. The variants are compared using +g_variant_equal(). + +The effect of `g_assert_cmpvariant (v1, v2)` is the same as +`g_assert_true (g_variant_equal (v1, v2))`. The advantage of this macro is +that it can produce a message that includes the actual values of @v1 and @v2. + +Since: 2.60 + + + + + pointer to a #GVariant + + + + pointer to another #GVariant + + + + + + Debugging macro to check that a method has returned @@ -5481,7 +5592,7 @@ error message and code. This can only be used to test for a specific error. If you want to test that @err is set, but don't care what it's set to, just use -`g_assert (err != NULL)` +`g_assert_nonnull (err)`. Since: 2.20 @@ -5511,6 +5622,10 @@ If the assertion fails (i.e. the expression is not false), an error message is logged and the application is either terminated or the testcase marked as failed. +Note that unlike g_assert(), this macro is unaffected by whether +`G_DISABLE_ASSERT` is defined. Hence it should only be used in tests and, +conversely, g_assert() should not be used in tests. + See g_test_set_nonfatal_assertions(). Since: 2.38 @@ -5554,6 +5669,10 @@ If the assertion fails (i.e. the expression is %NULL), an error message is logged and the application is either terminated or the testcase marked as failed. +Note that unlike g_assert(), this macro is unaffected by whether +`G_DISABLE_ASSERT` is defined. Hence it should only be used in tests and, +conversely, g_assert() should not be used in tests. + See g_test_set_nonfatal_assertions(). Since: 2.40 @@ -5575,7 +5694,8 @@ reached. If it is reached, an error message is logged and the application is terminated. The macro can be turned off in final releases of code by defining -`G_DISABLE_ASSERT` when compiling the application. +`G_DISABLE_ASSERT` when compiling the application. Hence, it should not be +used in unit tests, where assertions should always be effective. @@ -5591,6 +5711,10 @@ If the assertion fails (i.e. the expression is not %NULL), an error message is logged and the application is either terminated or the testcase marked as failed. +Note that unlike g_assert(), this macro is unaffected by whether +`G_DISABLE_ASSERT` is defined. Hence it should only be used in tests and, +conversely, g_assert() should not be used in tests. + See g_test_set_nonfatal_assertions(). Since: 2.38 @@ -5613,6 +5737,10 @@ If the assertion fails (i.e. the expression is not true), an error message is logged and the application is either terminated or the testcase marked as failed. +Note that unlike g_assert(), this macro is unaffected by whether +`G_DISABLE_ASSERT` is defined. Hence it should only be used in tests and, +conversely, g_assert() should not be used in tests. + See g_test_set_nonfatal_assertions(). Since: 2.38 @@ -5629,27 +5757,29 @@ Since: 2.38 +Internal function used to print messages from the public g_assert() and +g_assert_not_reached() macros. - + log domain - + file containing the assertion - + line number of the assertion - + function containing the assertion - + expression which failed @@ -6816,6 +6946,285 @@ Since: 2.30 + + +Atomically acquires a reference on the data pointed by @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + a pointer to the data, +with its reference count increased + + + + + + +Allocates @block_size bytes of memory, and adds atomic +reference counting semantics to it. + +The data will be freed when its reference count drops to +zero. + +The allocated data is guaranteed to be suitably aligned for any +built-in type. + +Since: 2.58 + + + + + the size of the allocation, must be greater than 0 + + + + a pointer to the allocated memory + + + + + + +Allocates @block_size bytes of memory, and adds atomic +referenc counting semantics to it. + +The contents of the returned data is set to zero. + +The data will be freed when its reference count drops to +zero. + +The allocated data is guaranteed to be suitably aligned for any +built-in type. + +Since: 2.58 + + + + + the size of the allocation, must be greater than 0 + + + + a pointer to the allocated memory + + + + + + +Allocates a new block of data with atomit reference counting +semantics, and copies @block_size bytes of @mem_block +into it. + +Since: 2.58 + + + + + the number of bytes to copy, must be greater than 0 + + + + the memory to copy + + + + a pointer to the allocated +memory + + + + + + +Retrieves the size of the reference counted data pointed by @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + the size of the data, in bytes + + + + + + +A convenience macro to allocate atomically reference counted +data with the size of the given @type. + +This macro calls g_atomic_rc_box_alloc() with `sizeof (@type)` and +casts the returned pointer to a pointer of the given @type, +avoiding a type cast in the source code. + +Since: 2.58 + + + + + the type to allocate, typically a structure name + + + + a pointer to the allocated +memory, cast to a pointer for the given @type + + + + + + +A convenience macro to allocate atomically reference counted +data with the size of the given @type, and set its contents +to zero. + +This macro calls g_atomic_rc_box_alloc0() with `sizeof (@type)` and +casts the returned pointer to a pointer of the given @type, +avoiding a type cast in the source code. + +Since: 2.58 + + + + + the type to allocate, typically a structure name + + + + a pointer to the allocated +memory, cast to a pointer for the given @type + + + + + + +Atomically releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will free the +resources allocated for @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + + + + + +Atomically releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will call @clear_func +to clear the contents of @mem_block, and then will free the +resources allocated for @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + a function to call when clearing the data + + + + + + + + +Atomically compares the current value of @arc with @val. + +Since: 2.58 + + + + + the address of an atomic reference count variable + + + + the value to compare + + + + %TRUE if the reference count is the same +as the given value + + + + + + +Atomically decreases the reference count. + +Since: 2.58 + + + + + the address of an atomic reference count variable + + + + %TRUE if the reference count reached 0, and %FALSE otherwise + + + + + + +Atomically increases the reference count. + +Since: 2.58 + + + + + the address of an atomic reference count variable + + + + + + + + +Initializes a reference count variable. + +Since: 2.58 + + + + + the address of an atomic reference count variable + + + + + + Helper to declare a variable with automatic cleanup. @@ -7680,8 +8089,8 @@ Since: 2.12 -Gets the registration informations of @app_name for the bookmark for -@uri. See g_bookmark_file_set_app_info() for more informations about +Gets the registration information of @app_name for the bookmark for +@uri. See g_bookmark_file_set_app_info() for more information about the returned data. The string returned in @app_exec must be freed. @@ -8194,9 +8603,9 @@ loaded in memory This function looks for a desktop bookmark file named @file in the -paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), -loads the file into @bookmark and returns the file's full path in -@full_path. If the file could not be loaded then an %error is +paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), +loads the file into @bookmark and returns the file's full path in +@full_path. If the file could not be loaded then @error is set to either a #GFileError or #GBookmarkFileError. Since: 2.12 @@ -8713,7 +9122,7 @@ Sets the time the bookmark for @uri was last visited. If no bookmark for @uri is found then it is created. -The "visited" time should only be set if the bookmark was launched, +The "visited" time should only be set if the bookmark was launched, either using the command line retrieved by g_bookmark_file_get_app_info() or by the default application for the bookmark's MIME type, retrieved using g_bookmark_file_get_mime_type(). Changing the "visited" time @@ -9352,7 +9761,13 @@ Since: 2.22 Compares the two #GBytes values. -This function can be used to sort GBytes instances in lexographical order. +This function can be used to sort GBytes instances in lexicographical order. + +If @bytes1 and @bytes2 have different length but the shorter one is a +prefix of the longer one then the shorter one is considered to be less than +the longer one. Otherwise the first byte where both differ is used for +comparison. If @bytes1 has a smaller value at that position it is +considered less, otherwise greater than @bytes2. Since: 2.32 @@ -9367,8 +9782,10 @@ Since: 2.32 - a negative value if bytes2 is lesser, a positive value if bytes2 is -greater, and zero if bytes2 is equal to bytes1 + a negative value if @bytes1 is less than @bytes2, a positive value +if @bytes1 is greater than @bytes2, and zero if @bytes1 is equal to +@bytes2 + @@ -9894,212 +10311,48 @@ data structures to @func; use g_cache_key_foreach() instead - - -A #GClosureMarshal function for use with signals with handlers that -take two boxed pointers as arguments and return a boolean. If you -have such a signal, you will probably also need to use an -accumulator, such as g_signal_accumulator_true_handled(). - - - - - A #GClosure. - - - - A #GValue to store the return value. May be %NULL -if the callback of closure doesn't return a value. - - - - The length of the @param_values array. - - - - An array of #GValues holding the arguments -on which to invoke the callback of closure. - - - - The invocation hint given as the last argument to -g_closure_invoke(). - - - - Additional data specified when registering the -marshaller, see g_closure_set_marshal() and -g_closure_set_meta_marshal() - - - - - - - - -The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). - - - - - the #GClosure to which the marshaller belongs - - - - a #GValue to store the return -value. May be %NULL if the callback of @closure doesn't return a -value. - - - - the instance on which the closure is invoked. - - - - va_list of arguments to be passed to the closure. - - - - additional data specified when -registering the marshaller, see g_closure_set_marshal() and -g_closure_set_meta_marshal() - - - - the length of the @param_types array - - - - the #GType of each argument from -@args. - - - - - - - + -A marshaller for a #GCClosure with a callback of type -`gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter -denotes a flags type. +Gets the canonical file name from @filename. All triple slashes are turned into +single slashes, and all `..` and `.`s resolved against @relative_to. - - - - the #GClosure to which the marshaller belongs - - - - a #GValue which can store the returned #gboolean - - - - 2 - - - - a #GValue array holding instance and arg1 - - - - the invocation hint given as the last argument -to g_closure_invoke() - - - - additional data specified when registering the marshaller - - - - - +Symlinks are not followed, and the returned path is guaranteed to be absolute. - - -The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__FLAGS(). +If @filename is an absolute path, @relative_to is ignored. Otherwise, +@relative_to will be prepended to @filename to make it absolute. @relative_to +must be an absolute path, or %NULL. If @relative_to is %NULL, it'll fallback +to g_get_current_dir(). - - - - the #GClosure to which the marshaller belongs - - - - a #GValue to store the return -value. May be %NULL if the callback of @closure doesn't return a -value. - - - - the instance on which the closure is invoked. - - - - va_list of arguments to be passed to the closure. - - - - additional data specified when -registering the marshaller, see g_closure_set_marshal() and -g_closure_set_meta_marshal() - - - - the length of the @param_types array - - - - the #GType of each argument from -@args. - - - - - +This function never fails, and will canonicalize file paths even if they don't +exist. - - -A marshaller for a #GCClosure with a callback of type -`gboolean (*callback) (gpointer instance, GBoxed *arg1, GBoxed *arg2, gpointer user_data)`. +No file system I/O is done. -Since: 2.26 +Since: 2.58 - - the #GClosure to which the marshaller belongs - - - - a #GValue, which can store the returned string - - - - 3 - - - - a #GValue array holding instance, arg1 and arg2 - - - - the invocation hint given as the last argument -to g_closure_invoke() + + the name of the file - - additional data specified when registering the marshaller + + the relative directory, or %NULL +to use the current working directory - + a newly allocated string with the +canonical file path + - + -An old alias for g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). +A #GClosureMarshal function for use with signals with handlers that +take two boxed pointers as arguments and return a boolean. If you +have such a signal, you will probably also need to use an +accumulator, such as g_signal_accumulator_true_handled(). @@ -10136,55 +10389,9 @@ g_closure_set_meta_marshal() - - -Another name for g_cclosure_marshal_BOOLEAN__FLAGS(). - - - - - - - - - -A marshaller for a #GCClosure with a callback of type -`gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`. - - - - - the #GClosure to which the marshaller belongs - - - - a #GValue, which can store the returned string - - - - 3 - - - - a #GValue array holding instance, arg1 and arg2 - - - - the invocation hint given as the last argument -to g_closure_invoke() - - - - additional data specified when registering the marshaller - - - - - - - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_STRING__OBJECT_POINTER(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). @@ -10225,10 +10432,11 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. +`gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter +denotes a flags type. @@ -10237,7 +10445,7 @@ A marshaller for a #GCClosure with a callback of type - ignored + a #GValue which can store the returned #gboolean @@ -10245,7 +10453,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #gboolean parameter + a #GValue array holding instance and arg1 @@ -10261,9 +10469,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOOLEAN(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__FLAGS(). @@ -10304,10 +10512,12 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. +`gboolean (*callback) (gpointer instance, GBoxed *arg1, GBoxed *arg2, gpointer user_data)`. + +Since: 2.26 @@ -10316,15 +10526,15 @@ A marshaller for a #GCClosure with a callback of type - ignored + a #GValue, which can store the returned string - 2 + 3 - a #GValue array holding the instance and the #GBoxed* parameter + a #GValue array holding instance, arg1 and arg2 @@ -10340,53 +10550,59 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOXED(). +An old alias for g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). - the #GClosure to which the marshaller belongs + A #GClosure. - a #GValue to store the return -value. May be %NULL if the callback of @closure doesn't return a -value. - - - - the instance on which the closure is invoked. + A #GValue to store the return value. May be %NULL +if the callback of closure doesn't return a value. - - va_list of arguments to be passed to the closure. + + The length of the @param_values array. - - additional data specified when -registering the marshaller, see g_closure_set_marshal() and -g_closure_set_meta_marshal() + + An array of #GValues holding the arguments +on which to invoke the callback of closure. - - the length of the @param_types array + + The invocation hint given as the last argument to +g_closure_invoke(). - - the #GType of each argument from -@args. + + Additional data specified when registering the +marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() - + + +Another name for g_cclosure_marshal_BOOLEAN__FLAGS(). + + + + + + + + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. +`gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`. @@ -10395,15 +10611,15 @@ A marshaller for a #GCClosure with a callback of type - ignored + a #GValue, which can store the returned string - 2 + 3 - a #GValue array holding the instance and the #gchar parameter + a #GValue array holding instance, arg1 and arg2 @@ -10419,9 +10635,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__CHAR(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_STRING__OBJECT_POINTER(). @@ -10462,10 +10678,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. @@ -10482,7 +10698,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #gdouble parameter + a #GValue array holding the instance and the #gboolean parameter @@ -10498,9 +10714,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__DOUBLE(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOOLEAN(). @@ -10541,10 +10757,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type.. +`void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. @@ -10561,7 +10777,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the enumeration parameter + a #GValue array holding the instance and the #GBoxed* parameter @@ -10577,9 +10793,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ENUM(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOXED(). @@ -10620,10 +10836,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. +`void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. @@ -10640,7 +10856,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the flags parameter + a #GValue array holding the instance and the #gchar parameter @@ -10656,9 +10872,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLAGS(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__CHAR(). @@ -10699,10 +10915,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. @@ -10719,7 +10935,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #gfloat parameter + a #GValue array holding the instance and the #gdouble parameter @@ -10735,9 +10951,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLOAT(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__DOUBLE(). @@ -10778,10 +10994,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type.. @@ -10798,7 +11014,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #gint parameter + a #GValue array holding the instance and the enumeration parameter @@ -10814,9 +11030,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__INT(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ENUM(). @@ -10857,10 +11073,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. @@ -10877,7 +11093,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #glong parameter + a #GValue array holding the instance and the flags parameter @@ -10893,9 +11109,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__LONG(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLAGS(). @@ -10936,10 +11152,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. @@ -10956,7 +11172,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #GObject* parameter + a #GValue array holding the instance and the #gfloat parameter @@ -10972,9 +11188,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__OBJECT(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLOAT(). @@ -11015,10 +11231,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. @@ -11035,7 +11251,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #GParamSpec* parameter + a #GValue array holding the instance and the #gint parameter @@ -11051,9 +11267,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__PARAM(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__INT(). @@ -11094,10 +11310,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. @@ -11114,7 +11330,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #gpointer parameter + a #GValue array holding the instance and the #glong parameter @@ -11130,9 +11346,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__POINTER(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__LONG(). @@ -11173,10 +11389,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. @@ -11193,7 +11409,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #gchar* parameter + a #GValue array holding the instance and the #GObject* parameter @@ -11209,9 +11425,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__STRING(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__OBJECT(). @@ -11252,10 +11468,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. @@ -11272,7 +11488,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #guchar parameter + a #GValue array holding the instance and the #GParamSpec* parameter @@ -11288,9 +11504,9 @@ to g_closure_invoke() - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UCHAR(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__PARAM(). @@ -11331,10 +11547,10 @@ g_closure_set_meta_marshal() - + A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. +`void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. @@ -11351,7 +11567,7 @@ A marshaller for a #GCClosure with a callback of type - a #GValue array holding the instance and the #guint parameter + a #GValue array holding the instance and the #gpointer parameter @@ -11367,10 +11583,9 @@ to g_closure_invoke() - + -A marshaller for a #GCClosure with a callback of type -`void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__POINTER(). @@ -11379,33 +11594,42 @@ A marshaller for a #GCClosure with a callback of type - ignored + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. - - 3 + + the instance on which the closure is invoked. - - a #GValue array holding instance, arg1 and arg2 + + va_list of arguments to be passed to the closure. - - the invocation hint given as the last argument -to g_closure_invoke() + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() - - additional data specified when registering the marshaller + + the length of the @param_types array + + + + the #GType of each argument from +@args. - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER(). +A marshaller for a #GCClosure with a callback of type +`void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. @@ -11414,41 +11638,270 @@ The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER(). - a #GValue to store the return -value. May be %NULL if the callback of @closure doesn't return a -value. - - - - the instance on which the closure is invoked. + ignored - - va_list of arguments to be passed to the closure. + + 2 - - additional data specified when -registering the marshaller, see g_closure_set_marshal() and -g_closure_set_meta_marshal() + + a #GValue array holding the instance and the #gchar* parameter - - the length of the @param_types array + + the invocation hint given as the last argument +to g_closure_invoke() - - the #GType of each argument from -@args. + + additional data specified when registering the marshaller - + -The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT(). +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__STRING(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + + + +A marshaller for a #GCClosure with a callback of type +`void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #guchar parameter + + + + the invocation hint given as the last argument +to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UCHAR(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + + + +A marshaller for a #GCClosure with a callback of type +`void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #guint parameter + + + + the invocation hint given as the last argument +to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + + + +A marshaller for a #GCClosure with a callback of type +`void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 3 + + + + a #GValue array holding instance, arg1 and arg2 + + + + the invocation hint given as the last argument +to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER(). + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue to store the return +value. May be %NULL if the callback of @closure doesn't return a +value. + + + + the instance on which the closure is invoked. + + + + va_list of arguments to be passed to the closure. + + + + additional data specified when +registering the marshaller, see g_closure_set_marshal() and +g_closure_set_meta_marshal() + + + + the length of the @param_types array + + + + the #GType of each argument from +@args. + + + + + + + + +The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT(). @@ -11825,6 +12278,8 @@ g_closure_set_meta_marshal() Creates a new closure which invokes @callback_func with @user_data as the last parameter. +@destroy_data will be called as a finalize notifier on the #GClosure. + @@ -11898,6 +12353,8 @@ after the object is is freed. Creates a new closure which invokes @callback_func with @user_data as the first parameter. +@destroy_data will be called as a finalize notifier on the #GClosure. + @@ -12391,7 +12848,11 @@ Otherwise, the variable is destroyed using @destroy and the pointer is set to %NULL. A macro is also included that allows this function to be used without -pointer casts. +pointer casts. This will mask any warnings about incompatible function types +or calling conventions, so you must ensure that your @destroy function is +compatible with being called as `GDestroyNotify` using the standard calling +convention for the platform that GLib was compiled for; otherwise the program +will experience undefined behaviour. Since: 2.34 @@ -12570,7 +13031,7 @@ been invalidated before). - GClosure to invalidate + #GClosure to invalidate @@ -13788,13 +14249,16 @@ from creat(). Logs a "critical warning" (#G_LOG_LEVEL_CRITICAL). -It's more or less application-defined what constitutes -a critical vs. a regular warning. You could call -g_log_set_always_fatal() to make critical warnings exit -the program, then use g_critical() for fatal errors, for -example. -You can also make critical warnings fatal at runtime by +Critical warnings are intended to be used in the event of an error +that originated in the current process (a programmer error). +Logging of a critical error is by definition an indication of a bug +somewhere in the current program (or its libraries). + +g_return_if_fail(), g_return_val_if_fail(), g_return_if_reached() and +g_return_val_if_reached() log at %G_LOG_LEVEL_CRITICAL. + +You can make critical warnings fatal at runtime by setting the `G_DEBUG` environment variable (see [Running GLib Applications](glib-running.html)): @@ -13802,6 +14266,8 @@ setting the `G_DEBUG` environment variable (see G_DEBUG=fatal-warnings gdb ./my-program ]| +You can also use g_log_set_always_fatal(). + Any unrelated failures can be skipped over in [gdb](https://www.gnu.org/software/gdb/) using the `continue` command. @@ -15243,7 +15709,10 @@ the user's current timezone. To set the value of a date to the current day, you could write: |[<!-- language="C" --> -g_date_set_time_t (date, time (NULL)); +time_t now = time (NULL); +if (now == (time_t) -1) +// handle the error +g_date_set_time_t (date, now); ]| Since: 2.10 @@ -16011,6 +16480,23 @@ Since: 2.26 + + +Get the time zone for this @datetime. + +Since: 2.58 + + + + + a #GDateTime + + + + the time zone + + + Determines the time zone abbreviation to be used at the time and in @@ -17651,8 +18137,8 @@ This is not intended for end user error reporting. Use of #GError is preferred for that instead, as it allows calling functions to perform actions conditional on the type of error. -Error messages are always fatal, resulting in a call to -abort() to terminate the application. This function will +Error messages are always fatal, resulting in a call to G_BREAKPOINT() +to terminate the application. This function will result in a core dump; don't use it for errors you expect. Using this function indicates a bug in your program, i.e. an assertion failure. @@ -17969,6 +18455,17 @@ Also since the file is recreated, existing permissions, access control lists, metadata etc. may be lost. If @filename is a symbolic link, the link itself will be replaced, not the linked file. +- On UNIX, if @filename already exists and is non-empty, and if the system +supports it (via a journalling filesystem or equivalent), the fsync() +call (or equivalent) will be used to ensure atomic replacement: @filename +will contain either its old contents or @contents, even in the face of +system power loss, the disk being unsafely removed, etc. + +- On UNIX, if @filename does not already exist or is empty, there is a +possibility that system power loss etc. after calling this function will +leave @filename empty or full of NUL bytes, depending on the underlying +filesystem. + - On Windows renaming a file will not remove an existing file with the new name, so on Windows there is a race condition between the existing file being removed and the temporary file being renamed. @@ -18519,7 +19016,9 @@ an error occurred Formats a size (for example the size of a file) into a human readable string. Sizes are rounded to the nearest size prefix (kB, MB, GB) and are displayed rounded to the nearest tenth. E.g. the file size -3292528 bytes will be converted into the string "3.2 MB". +3292528 bytes will be converted into the string "3.2 MB". The returned string +is UTF-8, and may use a non-breaking space to separate the number and units, +to ensure they aren’t separated when line wrapped. The prefix units base is 1000 (i.e. 1 kB is 1000 bytes). @@ -18954,8 +19453,9 @@ Since: 2.58 - a %NULL-terminated array of strings owned by GLib -that must not be modified or freed. + a %NULL-terminated array of strings owned by +the thread g_get_language_names_with_category was called from. +It must not be modified or freed. It must be copied if planned to be used in another thread. @@ -20153,6 +20653,46 @@ Since: 2.12 + + +Looks up a key in the #GHashTable, stealing the original key and the +associated value and returning %TRUE if the key was found. If the key was +not found, %FALSE is returned. + +If found, the stolen key and value are removed from the hash table without +calling the key and value destroy functions, and ownership is transferred to +the caller of this method; as with g_hash_table_steal(). + +You can pass %NULL for @lookup_key, provided the hash and equal functions +of @hash_table are %NULL-safe. + +Since: 2.58 + + + + + a #GHashTable + + + + the key to look up + + + + return location for the +original key + + + + return location +for the value associated with the key + + + + %TRUE if the key was found in the #GHashTable + + + This function is deprecated and will be removed in the next major @@ -22603,7 +23143,9 @@ If @key is %NULL then @comment will be read from above @group_name. If both @key and @group_name are %NULL, then @comment will be read from above the first group in the file. -Note that the returned string includes the '#' comment markers. +Note that the returned string does not include the '#' comment markers, +but does include any whitespace after them (on each line). It includes +the line breaks between lines, but does not include the final line break. Since: 2.6 @@ -24236,8 +24778,10 @@ a copy of each list element, in addition to copying the list container itself. @func, as a #GCopyFunc, takes two arguments, the data to be copied -and a @user_data pointer. It's safe to pass %NULL as user_data, -if the copy function takes only one argument. +and a @user_data pointer. On common processor architectures, it's safe to +pass %NULL as @user_data if the copy function takes only one argument. You +may get compiler warnings from this though if compiling with GCC’s +`-Wcast-function-type` warning. For instance, if @list holds a list of GObjects, you can do: |[<!-- language="C" --> @@ -25082,8 +25626,9 @@ errors. Any of the errors in #GConvertError may occur. Logs an error or debugging message. -If the log level has been set as fatal, the abort() -function is called to terminate the program. +If the log level has been set as fatal, G_BREAKPOINT() is called +to terminate the program. See the documentation for G_BREAKPOINT() for +details of the debugging options this provides. If g_log_default_handler() is used as the log handler function, a new-line character will automatically be appended to @..., and need not be entered @@ -25122,7 +25667,7 @@ The default log handler set up by GLib; g_log_set_default_handler() allows to install an alternate default log handler. This is used if no log handler has been set for the particular log domain and log level combination. It outputs the message to stderr -or stdout and if the log level is fatal it calls abort(). It automatically +or stdout and if the log level is fatal it calls G_BREAKPOINT(). It automatically prints a new-line character after the message, so one does not need to be manually included in @message. @@ -25260,6 +25805,11 @@ messages, programs must install a custom log writer function using g_log_set_writer_func(). See [Using Structured Logging][using-structured-logging]. +This function is mostly intended to be used with +%G_LOG_LEVEL_CRITICAL. You should typically not set +%G_LOG_LEVEL_WARNING, %G_LOG_LEVEL_MESSAGE, %G_LOG_LEVEL_INFO or +%G_LOG_LEVEL_DEBUG as fatal except inside of test programs. + @@ -25416,7 +25966,7 @@ finished with, if non-%NULL Log a message with structured data. The message will be passed through to the log writer set by the application using g_log_set_writer_func(). If the message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will -be aborted at the end of this function. If the log writer returns +be aborted by calling G_BREAKPOINT() at the end of this function. If the log writer returns %G_LOG_WRITER_UNHANDLED (failure), no other fallback writers will be tried. See the documentation for #GLogWriterFunc for information on chaining writers. @@ -25803,8 +26353,9 @@ Since: 2.50 Logs an error or debugging message. -If the log level has been set as fatal, the abort() -function is called to terminate the program. +If the log level has been set as fatal, G_BREAKPOINT() is called +to terminate the program. See the documentation for G_BREAKPOINT() for +details of the debugging options this provides. If g_log_default_handler() is used as the log handler function, a new-line character will automatically be appended to @..., and need not be entered @@ -26517,10 +27068,11 @@ the result is zero, free the context and free all associated memory. Tries to become the owner of the specified context, as with g_main_context_acquire(). But if another thread -is the owner, atomically drop @mutex and wait on @cond until +is the owner, atomically drop @mutex and wait on @cond until that owner releases ownership or until @cond is signaled, then try again (once) to become the owner. +Deprecated: 2.58: Use g_main_context_is_owner() and separate locking instead. @@ -29998,9 +30550,11 @@ will be updated as well. The @transform_from function is only used in case of bidirectional bindings, otherwise it will be ignored The binding will automatically be removed when either the @source or the -@target instances are finalized. To remove the binding without affecting the -@source and the @target you can just call g_object_unref() on the returned -#GBinding instance. +@target instances are finalized. This will release the reference that is +being held on the #GBinding instance; if you want to hold on to the +#GBinding instance, you will need to hold a reference to it. + +To remove the binding, call g_binding_unbind(). A #GObject can have multiple bindings. @@ -31590,11 +32144,11 @@ use this @object as closure data. - GObject restricting lifetime of @closure + #GObject restricting lifetime of @closure - GClosure to watch + #GClosure to watch @@ -32561,7 +33115,7 @@ Since: 2.44 - a #GoptionGroup + a #GOptionGroup @@ -34258,7 +34812,9 @@ component of the filename -Gets the directory components of a file name. +Gets the directory components of a file name. For example, the directory +component of `/usr/bin/test` is `/usr/bin`. The directory component of `/` +is `/`. If the file name has no directory components "." is returned. The returned string should be freed when no longer needed. @@ -35221,7 +35777,8 @@ pointer was not found. Removes the pointer at the given index from the pointer array. The following elements are moved down one place. If @array has a non-%NULL #GDestroyNotify function it is called for the removed -element. +element. If so, the return value from this function will potentially point +to freed memory (depending on the #GDestroyNotify implementation). @@ -35245,7 +35802,9 @@ Removes the pointer at the given index from the pointer array. The last element in the array is used to fill in the space, so this function does not preserve the order of the array. But it is faster than g_ptr_array_remove_index(). If @array has a non-%NULL -#GDestroyNotify function it is called for the removed element. +#GDestroyNotify function it is called for the removed element. If so, the +return value from this function will potentially point to freed memory +(depending on the #GDestroyNotify implementation). @@ -35411,6 +35970,56 @@ This is guaranteed to be a stable sort since version 2.32. + + +Removes the pointer at the given index from the pointer array. +The following elements are moved down one place. The #GDestroyNotify for +@array is *not* called on the removed element; ownership is transferred to +the caller of this function. + +Since: 2.58 + + + + + a #GPtrArray + + + + the index of the pointer to steal + + + + the pointer which was removed + + + + + +Removes the pointer at the given index from the pointer array. +The last element in the array is used to fill in the space, so +this function does not preserve the order of the array. But it +is faster than g_ptr_array_steal_index(). The #GDestroyNotify for @array is +*not* called on the removed element; ownership is transferred to the caller +of this function. + +Since: 2.58 + + + + + a #GPtrArray + + + + the index of the pointer to steal + + + + the pointer which was removed + + + Atomically decrements the reference count of @array by one. If the @@ -35562,6 +36171,27 @@ Since: 2.14 + + +Convenience method, which frees all the memory used by a #GQueue, +and calls the provided @free_func on each item in the #GQueue. + +Since: 2.60 + + + + + a pointer to a #GQueue + + + + the function to be called to free memory allocated + + + + + + Copies a @queue. Note that is a shallow copy. If the elements in the @@ -36720,6 +37350,211 @@ by the g_random_* functions, to @seed. + + +Acquires a reference on the data pointed by @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + a pointer to the data, +with its reference count increased + + + + + + +Allocates @block_size bytes of memory, and adds reference +counting semantics to it. + +The data will be freed when its reference count drops to +zero. + +The allocated data is guaranteed to be suitably aligned for any +built-in type. + +Since: 2.58 + + + + + the size of the allocation, must be greater than 0 + + + + a pointer to the allocated memory + + + + + + +Allocates @block_size bytes of memory, and adds reference +counting semantics to it. + +The contents of the returned data is set to zero. + +The data will be freed when its reference count drops to +zero. + +The allocated data is guaranteed to be suitably aligned for any +built-in type. + +Since: 2.58 + + + + + the size of the allocation, must be greater than 0 + + + + a pointer to the allocated memory + + + + + + +Allocates a new block of data with reference counting +semantics, and copies @block_size bytes of @mem_block +into it. + +Since: 2.58 + + + + + the number of bytes to copy, must be greater than 0 + + + + the memory to copy + + + + a pointer to the allocated +memory + + + + + + +Retrieves the size of the reference counted data pointed by @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + the size of the data, in bytes + + + + + + +A convenience macro to allocate reference counted data with +the size of the given @type. + +This macro calls g_rc_box_alloc() with `sizeof (@type)` and +casts the returned pointer to a pointer of the given @type, +avoiding a type cast in the source code. + +Since: 2.58 + + + + + the type to allocate, typically a structure name + + + + a pointer to the +allocated memory, cast to a pointer for the given @type + + + + + + +A convenience macro to allocate reference counted data with +the size of the given @type, and set its contents to zero. + +This macro calls g_rc_box_alloc0() with `sizeof (@type)` and +casts the returned pointer to a pointer of the given @type, +avoiding a type cast in the source code. + +Since: 2.58 + + + + + the type to allocate, typically a structure name + + + + a pointer to the +allocated memory, cast to a pointer for the given @type + + + + + + +Releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will free the +resources allocated for @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + + + + + +Releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will call @clear_func +to clear the contents of @mem_block, and then will free the +resources allocated for @mem_block. + +Since: 2.58 + + + + + a pointer to reference counted data + + + + a function to call when clearing the data + + + + + + Reallocates the memory pointed to by @mem, so that it now has space for @@ -36855,6 +37690,70 @@ Since: 2.32 + + +Unlock @locker's recursive mutex. See g_rec_mutex_locker_new() for details. + +Since: 2.60 + + + + + a GRecMutexLocker + + + + + + + + +Lock @rec_mutex and return a new #GRecMutexLocker. Unlock with +g_rec_mutex_locker_free(). Using g_rec_mutex_unlock() on @rec_mutex +while a #GRecMutexLocker exists can lead to undefined behaviour. + +This is intended to be used with g_autoptr(). Note that g_autoptr() +is only available when using GCC or clang, so the following example +will only work with those compilers: +|[ +typedef struct +{ +... +GRecMutex rec_mutex; +... +} MyObject; + +static void +my_object_do_stuff (MyObject *self) +{ +g_autoptr(GRecMutexLocker) locker = g_rec_mutex_locker_new (&self->rec_mutex); + +// Code with rec_mutex locked here + +if (cond) +// No need to unlock +return; + +// Optionally early unlock +g_clear_pointer (&locker, g_rec_mutex_locker_free); + +// Code with rec_mutex unlocked here +} +]| + +Since: 2.60 + + + + + a recursive mutex to lock + + + + a #GRecMutexLocker + + + Tries to lock @rec_mutex. If @rec_mutex is already locked @@ -36896,6 +37795,201 @@ Since: 2.32 + + +Compares the current value of @rc with @val. + +Since: 2.58 + + + + + the address of a reference count variable + + + + the value to compare + + + + %TRUE if the reference count is the same +as the given value + + + + + + +Decreases the reference count. + +Since: 2.58 + + + + + the address of a reference count variable + + + + %TRUE if the reference count reached 0, and %FALSE otherwise + + + + + + +Increases the reference count. + +Since: 2.58 + + + + + the address of a reference count variable + + + + + + + + +Initializes a reference count variable. + +Since: 2.58 + + + + + the address of a reference count variable + + + + + + + + +Acquires a reference on a string. + +Since: 2.58 + + + + + a reference counted string + + + + the given string, with its reference count increased + + + + + + +Retrieves the length of @str. + +Since: 2.58 + + + + + a reference counted string + + + + the length of the given string, in bytes + + + + + + +Creates a new reference counted string and copies the contents of @str +into it. + +Since: 2.58 + + + + + a NUL-terminated string + + + + the newly created reference counted string + + + + + + +Creates a new reference counted string and copies the content of @str +into it. + +If you call this function multiple times with the same @str, or with +the same contents of @str, it will return a new reference, instead of +creating a new string. + +Since: 2.58 + + + + + a NUL-terminated string + + + + the newly created reference +counted string, or a new reference to an existing string + + + + + + +Creates a new reference counted string and copies the contents of @str +into it, up to @len bytes. + +Since this function does not stop at nul bytes, it is the caller's +responsibility to ensure that @str has at least @len addressable bytes. + +Since: 2.58 + + + + + a string + + + + length of @str to use, or -1 if @str is nul-terminated + + + + the newly created reference counted string + + + + + + +Releases a reference on a string; if it was the last reference, the +resources allocated by the string are freed as well. + +Since: 2.58 + + + + + a reference counted string + + + + + + Checks whether @replacement is a valid replacement string @@ -36976,7 +38070,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -37145,11 +38239,13 @@ does not exists -Scans for a match in string for the pattern in @regex. +Scans for a match in @string for the pattern in @regex. The @match_options are combined with the match options specified when the @regex structure was created, letting you have more flexibility in reusing #GRegex structures. +Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. + A #GMatchInfo structure, used to get information on the match, is stored in @match_info if not %NULL. Note that if @match_info is not %NULL then it is created even if the function returns %FALSE, @@ -37258,7 +38354,7 @@ the #GMatchInfo, or %NULL if you do not need it Using the standard algorithm for regular expression matching only -the longest match in the string is retrieved, it is not possible +the longest match in the @string is retrieved, it is not possible to obtain all the available matches. For instance matching "<a> <b> <c>" against the pattern "<.*>" you get "<a> <b> <c>". @@ -37284,6 +38380,8 @@ Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". +Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. + A #GMatchInfo structure, used to get information on the match, is stored in @match_info if not %NULL. Note that if @match_info is not %NULL then it is created even if the function returns %FALSE, @@ -37307,7 +38405,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -37335,7 +38433,7 @@ the #GMatchInfo, or %NULL if you do not need it -Scans for a match in string for the pattern in @regex. +Scans for a match in @string for the pattern in @regex. The @match_options are combined with the match options specified when the @regex structure was created, letting you have more flexibility in reusing #GRegex structures. @@ -37344,6 +38442,8 @@ Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". +Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. + A #GMatchInfo structure, used to get information on the match, is stored in @match_info if not %NULL. Note that if @match_info is not %NULL then it is created even if the function returns %FALSE, @@ -37398,7 +38498,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -37555,7 +38655,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -37641,7 +38741,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -37694,7 +38794,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -37799,7 +38899,7 @@ Since: 2.14 - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -38118,7 +39218,7 @@ Resets the cache used for g_get_user_special_dir(), so that the latest on-disk version is used. Call this only if you just changed the data on disk yourself. -Due to threadsafety issues this may cause leaking of strings +Due to thread safety issues this may cause leaking of strings that were previously returned from g_get_user_special_dir() that can't be freed. We ensure to only leak the data for the directories that actually changed value though. @@ -38262,19 +39362,21 @@ Any unrelated failures can be skipped over in +Internal function used to print messages from the public g_return_if_fail() +and g_return_val_if_fail() macros. - + log domain - + function containing the assertion - + expression which failed @@ -39333,14 +40435,14 @@ Since: 2.14 -Inserts @data into @sequence using @func to determine the new +Inserts @data into @seq using @cmp_func to determine the new position. The sequence must already be sorted according to @cmp_func; otherwise the new position of @data is undefined. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value -if the second item comes before the first. +if the second item comes before the first. Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call @@ -39383,11 +40485,6 @@ It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. -It is called with two iterators pointing into @seq. It should -return 0 if the iterators are equal, a negative value if the -first iterator comes before the second, and a positive value -if the second iterator comes before the first. - Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call g_sequence_sort() or g_sequence_sort_iter(). @@ -39409,7 +40506,7 @@ Since: 2.14 - user data passed to @cmp_func + user data passed to @iter_cmp @@ -39611,7 +40708,7 @@ item is equal, it is not guaranteed that it is the first which is returned. In that case, you can use g_sequence_iter_next() and g_sequence_iter_prev() to get others. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. @@ -39682,7 +40779,7 @@ Since: 2.28 an #GSequenceIter pointing to the position of -the first item found equal to @data according to @cmp_func +the first item found equal to @data according to @iter_cmp and @cmp_data, or %NULL if no such item exists @@ -39714,13 +40811,13 @@ the item is moved -Inserts the (@begin, @end) range at the destination pointed to by ptr. +Inserts the (@begin, @end) range at the destination pointed to by @dest. The @begin and @end iters must point into the same sequence. It is allowed for @dest to point to a different sequence than the one pointed into by @begin and @end. -If @dest is NULL, the range indicated by @begin and @end is -removed from the sequence. If @dest iter points to a place within +If @dest is %NULL, the range indicated by @begin and @end is +removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. Since: 2.14 @@ -39861,7 +40958,7 @@ Since: 2.14 Returns an iterator pointing to the position where @data would be inserted according to @cmp_func and @cmp_data. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. @@ -39996,12 +41093,13 @@ Since: 2.14 -Moves the data pointed to a new position as indicated by @cmp_func. This +Moves the data pointed to by @iter to a new position as indicated by +@cmp_func. This function should be called for items in a sequence already sorted according to @cmp_func whenever some aspect of an item changes so that @cmp_func may return different values for that item. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. @@ -40032,7 +41130,8 @@ Like g_sequence_sort_changed(), but uses a #GSequenceIterCompareFunc instead of a #GCompareDataFunc as the compare function. -@iter_cmp is called with two iterators pointing into @seq. It should +@iter_cmp is called with two iterators pointing into the #GSequence that +@iter points into. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. @@ -40060,7 +41159,7 @@ Since: 2.14 Like g_sequence_sort(), but uses a #GSequenceIterCompareFunc instead -of a GCompareDataFunc as the compare function +of a #GCompareDataFunc as the compare function @cmp_func is called with two iterators pointing into @seq. It should return 0 if the iterators are equal, a negative value if the first @@ -41640,7 +42739,7 @@ without a return value. Creates a new signal. (This is usually done in the class initializer.) This is a variant of g_signal_new() that takes a C callback instead -off a class offset for the signal's class handler. This function +of a class offset for the signal's class handler. This function doesn't need a function pointer exposed in the class structure of an object definition, instead the function pointer is passed directly and can be overriden by derived classes with @@ -42530,9 +43629,11 @@ Makes a full (deep) copy of a #GSList. In contrast with g_slist_copy(), this function uses @func to make a copy of each list element, in addition to copying the list container itself. -@func, as a #GCopyFunc, takes two arguments, the data to be copied and a user -pointer. It's safe to pass #NULL as user_data, if the copy function takes only -one argument. +@func, as a #GCopyFunc, takes two arguments, the data to be copied +and a @user_data pointer. On common processor architectures, it's safe to +pass %NULL as @user_data if the copy function takes only one argument. You +may get compiler warnings from this though if compiling with GCC’s +`-Wcast-function-type` warning. For instance, if @list holds a list of GObjects, you can do: |[<!-- language="C" --> @@ -42561,7 +43662,7 @@ Since: 2.34 - a full copy of @list, use #g_slist_free_full to free it + a full copy of @list, use g_slist_free_full() to free it @@ -43424,6 +44525,11 @@ is a positive integer which is unique within a particular main loop context. The reverse mapping from ID to source is done by g_main_context_find_source_by_id(). +You can only call this function while the source is associated to a +#GMainContext instance; calling this function before g_source_attach() +or after g_source_destroy() yields undefined behavior. The ID returned +is unique within the #GMainContext instance passed to g_source_attach(). + @@ -43863,13 +44969,18 @@ called from the source's dispatch function. The exact type of @func depends on the type of source; ie. you should not count on @func being called with @data as its first -parameter. +parameter. Cast @func with G_SOURCE_FUNC() to avoid warnings about +incompatible function types. See [memory management of sources][mainloop-memory-management] for details on how to handle memory management of @data. Typically, you won't use this function. Instead use functions specific -to the type of source you are using. +to the type of source you are using, such as g_idle_add() or g_timeout_add(). + +It is safe to call this function multiple times on a source which has already +been attached to a context. The changes will take effect for the next time +the source is dispatched after this call returns. @@ -43902,6 +45013,10 @@ an initial reference count on @callback_data, and thus @callback_funcs->unref will eventually be called once more than @callback_funcs->ref. +It is safe to call this function multiple times on a source which has already +been attached to a context. The changes will take effect for the next time +the source is dispatched after this call returns. + @@ -44243,6 +45358,81 @@ child's environment, or %NULL to inherit parent's + + +Identical to g_spawn_async_with_pipes() but instead of +creating pipes for the stdin/stdout/stderr, you can pass existing +file descriptors into this function through the @stdin_fd, +@stdout_fd and @stderr_fd parameters. The following @flags +also have their behaviour slightly tweaked as a result: + +%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output +will be discarded, instead of going to the same location as the parent's +standard output. If you use this flag, @standard_output must be -1. +%G_SPAWN_STDERR_TO_DEV_NULL means that the child's standard error +will be discarded, instead of going to the same location as the parent's +standard error. If you use this flag, @standard_error must be -1. +%G_SPAWN_CHILD_INHERITS_STDIN means that the child will inherit the parent's +standard input (by default, the child's standard input is attached to +/dev/null). If you use this flag, @standard_input must be -1. + +It is valid to pass the same fd in multiple parameters (e.g. you can pass +a single fd for both stdout and stderr). + +Since: 2.58 + + + + + child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding + + + + child's argument vector, in the GLib file name encoding + + + + child's environment, or %NULL to inherit parent's, in the GLib file name encoding + + + + flags from #GSpawnFlags + + + + function to run in the child just before exec() + + + + user data for @child_setup + + + + return location for child process ID, or %NULL + + + + file descriptor to use for child's stdin, or -1 + + + + file descriptor to use for child's stdout, or -1 + + + + file descriptor to use for child's stderr, or -1 + + + + return location for error + + + + %TRUE on success, %FALSE if an error was set + + + + Executes a child program asynchronously (your program will not @@ -44285,7 +45475,7 @@ eventually calls) paste the argument vector elements together into a command line, and the C runtime startup code does a corresponding reconstruction of an argument vector from the command line, to be passed to main(). Complications arise when you have argument vector -elements that contain spaces of double quotes. The spawn*() functions +elements that contain spaces or double quotes. The `spawn*()` functions don't do any quoting or escaping, but on the other hand the startup code does do unquoting and unescaping in order to enable receiving arguments with embedded spaces or double quotes. To work around this @@ -44313,10 +45503,11 @@ the %SIGCHLD signal manually. On Windows, calling g_spawn_close_pid() is equivalent to calling CloseHandle() on the process handle returned in @child_pid). See g_child_watch_add(). -%G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that the parent's open file -descriptors will be inherited by the child; otherwise all descriptors -except stdin/stdout/stderr will be closed before calling exec() in -the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an +Open UNIX file descriptors marked as `FD_CLOEXEC` will be automatically +closed in the child process. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that +other open file descriptors will be inherited by the child; otherwise all +descriptors except stdin/stdout/stderr will be closed before calling exec() +in the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an absolute path, it will be looked for in the `PATH` environment variable. %G_SPAWN_SEARCH_PATH_FROM_ENVP means need not be an absolute path, it will be looked for in the `PATH` variable from @@ -44391,6 +45582,21 @@ and @standard_error will not be filled with valid values. If @child_pid is not %NULL and an error does not occur then the returned process reference must be closed using g_spawn_close_pid(). +On modern UNIX platforms, GLib can use an efficient process launching +codepath driven internally by posix_spawn(). This has the advantage of +avoiding the fork-time performance costs of cloning the parent process +address space, and avoiding associated memory overcommit checks that are +not relevant in the context of immediately executing a distinct process. +This optimized codepath will be used provided that the following conditions +are met: + +1. %G_SPAWN_DO_NOT_REAP_CHILD is set +2. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN is set +3. %G_SPAWN_SEARCH_PATH_FROM_ENVP is not set +4. @working_directory is %NULL +5. @child_setup is %NULL +6. The program is of a recognised binary format, or has a shebang. Otherwise, GLib will have to execute the program through the shell, which is not done using the optimized codepath. + If you are writing a GTK+ application, and the program you are spawning is a graphical application too, then to ensure that the spawned program opens its windows on the right screen, you may want to use #GdkAppLaunchContext, @@ -45366,9 +46572,9 @@ if they are equal. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL strings as keys in a #GHashTable. -Note that this function is primarily meant as a hash table comparison -function. For a general-purpose, %NULL-safe string comparison function, -see g_strcmp0(). +This function is typically used for hash table comparisons, but can be used +for general purpose comparisons of non-%NULL strings. For a %NULL-safe string +comparison function, see g_strcmp0(). @@ -45538,12 +46744,12 @@ change by version or even by runtime environment. If the source language of @str is known, it can used to improve the accuracy of the translation by passing it as @from_locale. It should be a valid POSIX locale string (of the form -"language[_territory][.codeset][@modifier]"). +`language[_territory][.codeset][@modifier]`). If @from_locale is %NULL then the current locale is used. If you want to do translation for no specific locale, and you want it -to be done independently of the currently locale, specify "C" for +to be done independently of the currently locale, specify `"C"` for @from_locale. Since: 2.40 @@ -46064,13 +47270,15 @@ it if necessary. -Appends @len bytes of @val to @string. Because @len is -provided, @val may contain embedded nuls and need not -be nul-terminated. +Appends @len bytes of @val to @string. + +If @len is positive, @val may contain embedded nuls and need +not be nul-terminated. It is the caller's responsibility to +ensure that @val has at least @len addressable bytes. -Since this function does not stop at nul bytes, it is -the caller's responsibility to ensure that @val has at -least @len addressable bytes. +If @len is negative, @val must be nul-terminated and @len +is considered to request the entire string length. This +makes g_string_append_len() equivalent to g_string_append(). @@ -46084,7 +47292,7 @@ least @len addressable bytes. - number of bytes of @val to use + number of bytes of @val to use, or -1 for all of @val @@ -46592,13 +47800,15 @@ Inserts a byte into a #GString, expanding it if necessary. Inserts @len bytes of @val into @string at @pos. -Because @len is provided, @val may contain embedded -nuls and need not be nul-terminated. If @pos is -1, -bytes are inserted at the end of the string. -Since this function does not stop at nul bytes, it is -the caller's responsibility to ensure that @val has at -least @len addressable bytes. +If @len is positive, @val may contain embedded nuls and need +not be nul-terminated. It is the caller's responsibility to +ensure that @val has at least @len addressable bytes. + +If @len is negative, @val must be nul-terminated and @len +is considered to request the entire string length. + +If @pos is -1, bytes are inserted at the end of the string. @@ -46617,7 +47827,7 @@ happen, or -1 for at the end - number of bytes of @val to insert + number of bytes of @val to insert, or -1 for all of @val @@ -46796,12 +48006,14 @@ expanding it if necessary. Prepends @len bytes of @val to @string. -Because @len is provided, @val may contain -embedded nuls and need not be nul-terminated. -Since this function does not stop at nul bytes, -it is the caller's responsibility to ensure that -@val has at least @len addressable bytes. +If @len is positive, @val may contain embedded nuls and need +not be nul-terminated. It is the caller's responsibility to +ensure that @val has at least @len addressable bytes. + +If @len is negative, @val must be nul-terminated and @len +is considered to request the entire string length. This +makes g_string_prepend_len() equivalent to g_string_prepend(). @@ -46815,7 +48027,7 @@ it is the caller's responsibility to ensure that - number of bytes in @val to prepend + number of bytes in @val to prepend, or -1 for all of @val @@ -47577,10 +48789,36 @@ Since: 2.44 + + +Checks if @strv1 and @strv2 contain exactly the same elements in exactly the +same order. Elements are compared using g_str_equal(). To match independently +of order, sort the arrays first (using g_qsort_with_data() or similar). + +Two empty arrays are considered equal. Neither @strv1 not @strv2 may be +%NULL. + +Since: 2.60 + + + + + a %NULL-terminated array of strings + + + + another %NULL-terminated array of strings + + + + %TRUE if @strv1 and @strv2 are equal + + + Returns the length of the given %NULL-terminated -string array @str_array. +string array @str_array. @str_array must not be %NULL. Since: 2.6 @@ -47650,6 +48888,10 @@ If @testpath includes the component "subprocess" anywhere in it, the test will be skipped by default, and only run if explicitly required via the `-p` command-line option or g_test_trap_subprocess(). +No component of @testpath may start with a dot (`.`) if the +%G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to +do so even if it isn’t. + Since: 2.16 @@ -47710,6 +48952,10 @@ If @testpath includes the component "subprocess" anywhere in it, the test will be skipped by default, and only run if explicitly required via the `-p` command-line option or g_test_trap_subprocess(). +No component of @testpath may start with a dot (`.`) if the +%G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to +do so even if it isn’t. + Since: 2.16 @@ -48143,6 +49389,20 @@ that appropriate assertions or warnings are given (the default). - `--debug-log`: Debug test logging output. +Options which can be passed to @... are: + +- `"no_g_set_prgname"`: Causes g_test_init() to not call g_set_prgname(). +- %G_TEST_OPTION_ISOLATE_DIRS: Creates a unique temporary directory for each +unit test and uses g_set_user_dirs() to set XDG directories to point into +that temporary directory for the duration of the unit test. See the +documentation for %G_TEST_OPTION_ISOLATE_DIRS. + +Since 2.58, if tests are compiled with `G_DISABLE_ASSERT` defined, +g_test_init() will print an error and exit. This is to prevent no-op tests +from being executed, as g_assert() is commonly (erroneously) used in unit +tests, and is a no-op when compiled with `G_DISABLE_ASSERT`. Ensure your +tests are compiled without `G_DISABLE_ASSERT` defined. + Since: 2.16 @@ -48158,9 +49418,7 @@ Any parameters understood by g_test_init() stripped before return. - %NULL-terminated list of special options. Currently the only -defined option is `"no_g_set_prgname"`, which -will cause g_test_init() to not call g_set_prgname(). + %NULL-terminated list of special options, documented below. @@ -48584,8 +49842,9 @@ on the order that tests are run in. If you need to ensure that some particular code runs before or after a given test case, use g_test_add(), which lets you specify setup and teardown functions. -If all tests are skipped, this function will return 0 if -producing TAP output, or 77 (treated as "skip test" by Automake) otherwise. +If all tests are skipped or marked as incomplete (expected failures), +this function will return 0 if producing TAP output, or 77 (treated +as "skip test" by Automake) otherwise. Since: 2.16 @@ -48593,7 +49852,8 @@ Since: 2.16 0 on success, 1 on failure (assuming it returns at all), -0 or 77 if all tests were skipped with g_test_skip() +0 or 77 if all tests were skipped with g_test_skip() and/or +g_test_incomplete() @@ -49931,6 +51191,8 @@ seconds. It can optionally include fractions of a second and a time zone indicator. (In the absence of any time zone indication, the timestamp is assumed to be in local time.) +Any leading or trailing space in @iso_date is ignored. + Since: 2.12 @@ -49973,10 +51235,12 @@ Use g_date_time_format() or g_strdup_printf() if a different variation of ISO 8601 format is required. If @time_ represents a date which is too large to fit into a `struct tm`, -%NULL will be returned. This is platform dependent, but it is safe to assume -years up to 3000 are supported. The return value of g_time_val_to_iso8601() -has been nullable since GLib 2.54; before then, GLib would crash under the -same conditions. +%NULL will be returned. This is platform dependent. Note also that since +`GTimeVal` stores the number of seconds as a `glong`, on 32-bit systems it +is subject to the year 2038 problem. + +The return value of g_time_val_to_iso8601() has been nullable since GLib +2.54; before then, GLib would crash under the same conditions. Since: 2.12 @@ -50104,6 +51368,30 @@ Since: 2.26 + + +Get the identifier of this #GTimeZone, as passed to g_time_zone_new(). +If the identifier passed at construction time was not recognised, `UTC` will +be returned. If it was %NULL, the identifier of the local timezone at +construction time will be returned. + +The identifier will be returned in the same format as provided at +construction time: if provided as a time offset, that will be returned by +this function. + +Since: 2.58 + + + + + a #GTimeZone + + + + identifier for this timezone + + + Determines the offset to UTC in effect during a particular @interval @@ -50257,6 +51545,27 @@ Since: 2.26 + + +Creates a #GTimeZone corresponding to the given constant offset from UTC, +in seconds. + +This is equivalent to calling g_time_zone_new() with a string in the form +`[+|-]hh[:mm[:ss]]`. + +Since: 2.58 + + + + + offset to UTC, in seconds + + + + a timezone at the given offset from UTC + + + Creates a #GTimeZone corresponding to UTC. @@ -50387,7 +51696,7 @@ the callback will be invoked in whichever thread is running that main context. You can do these steps manually if you need greater control or to use a custom main context. -The interval given in terms of monotonic time, not wall clock time. +The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). @@ -50568,7 +51877,7 @@ executed. The scheduling granularity/accuracy of this timeout source will be in seconds. -The interval given in terms of monotonic time, not wall clock time. +The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). Since: 2.14 @@ -51703,6 +53012,8 @@ return priv->some_field; ]| Since: 2.4 +Deprecated: 2.58: Use the G_ADD_PRIVATE() macro with the `G_DEFINE_*` +family of macros to add instance private data to a type @@ -55391,6 +56702,34 @@ positive and any of the @max_len bytes are nul. + + +Validates UTF-8 encoded text. + +As with g_utf8_validate(), but @max_len must be set, and hence this function +will always return %FALSE if any of the bytes of @str are nul. + +Since: 2.60 + + + + + a pointer to character data + + + + max bytes to validate + + + + return location for end of valid data + + + + %TRUE if the text was valid UTF-8 + + + A wrapper for the POSIX utime() function. The utime() function @@ -58104,7 +59443,7 @@ Since: 2.24 - a #guchar + a #guint8 @@ -58225,6 +59564,11 @@ in the container. See g_variant_n_children(). The returned value is never floating. You should free it with g_variant_unref() when you're done with it. +There may be implementation specific restrictions on deeply nested values, +which would result in the unit tuple being returned as the child value, +instead of further nested children. #GVariant is guaranteed to handle +nesting up to at least 64 levels. + This function is O(1). Since: 2.24 @@ -58346,7 +59690,7 @@ as an array of the given C type, with @element_size set to the size the appropriate type: - %G_VARIANT_TYPE_INT16 (etc.): #gint16 (etc.) - %G_VARIANT_TYPE_BOOLEAN: #guchar (not #gboolean!) -- %G_VARIANT_TYPE_BYTE: #guchar +- %G_VARIANT_TYPE_BYTE: #guint8 - %G_VARIANT_TYPE_HANDLE: #guint32 - %G_VARIANT_TYPE_DOUBLE: #gdouble @@ -58912,6 +60256,9 @@ If @value is found to be in normal form then it will be marked as being trusted. If the value was already marked as being trusted then this function will immediately return %TRUE. +There may be implementation specific restrictions on deeply nested values. +GVariant is guaranteed to handle nesting up to at least 64 levels. + Since: 2.24 @@ -58932,10 +60279,10 @@ Determines if a given string is a valid D-Bus object path. You should ensure that a string is a valid D-Bus object path before passing it to g_variant_new_object_path(). -A valid object path starts with '/' followed by zero or more -sequences of characters separated by '/' characters. Each sequence -must contain only the characters "[A-Z][a-z][0-9]_". No sequence -(including the one following the final '/' character) may be empty. +A valid object path starts with `/` followed by zero or more +sequences of characters separated by `/` characters. Each sequence +must contain only the characters `[A-Z][a-z][0-9]_`. No sequence +(including the one following the final `/` character) may be empty. Since: 2.24 @@ -59368,7 +60715,7 @@ In the event that @dictionary has the type a{sv}, the @expected_type string specifies what type of value is expected to be inside of the variant. If the value inside the variant has a different type then %NULL is returned. In the event that @dictionary has a value type other -than v then @expected_type must directly match the key type and it is +than v then @expected_type must directly match the value type and it is used to unpack the value directly or an error occurs. In either case, if @key is not found in @dictionary, %NULL is returned. @@ -59699,6 +61046,10 @@ called from various functions in gvariant.c. A reference is taken on @bytes. +The data in @bytes must be aligned appropriately for the @type being loaded. +Otherwise this function will internally create a copy of the memory (since +GLib 2.60) or (in older versions) fail and exit the process. + Since: 2.36 @@ -59748,6 +61099,11 @@ endianness. g_variant_byteswap() can be used to recover the original values. needed. The exact time of this call is unspecified and might even be before this function returns. +Note: @data must be backed by memory that is aligned appropriately for the +@type being loaded. Otherwise this function will internally create a copy of +the memory (since GLib 2.60) or (in older versions) fail and exit the +process. + Since: 2.24 @@ -61639,27 +62995,29 @@ Since: 2.16 +Internal function used to print messages from the public g_warn_if_reached() +and g_warn_if_fail() macros. - + log domain - + file containing the warning - + line number of the warning - + function containing the warning - + expression which failed @@ -61675,6 +63033,16 @@ This is not intended for end user error reporting. Use of #GError is preferred for that instead, as it allows calling functions to perform actions conditional on the type of error. +Warning messages are intended to be used in the event of unexpected +external conditions (system misconfiguration, missing files, +other trusted programs violating protocol, invalid contents in +trusted files, etc.) + +If attempting to deal with programmer errors (for example, incorrect function +parameters) then you should use %G_LOG_LEVEL_CRITICAL instead. + +g_warn_if_reached() and g_warn_if_fail() log at %G_LOG_LEVEL_WARNING. + You can make warnings fatal at runtime by setting the `G_DEBUG` environment variable (see [Running GLib Applications](glib-running.html)): @@ -62130,12 +63498,41 @@ failure and lack of short names. + + +A type for implementing atomic reference count semantics. + +Use g_atomic_ref_count_init() to initialize it; g_atomic_ref_count_inc() +to increase the counter, and g_atomic_ref_count_dec() to decrease it. + +It is safe to use #gatomicrefcount if you're expecting to operate on the +reference counter from multiple threads. + +See also: #grefcount + +Since: 2.58 + + + + + + + A standard boolean type. Variables of this type should only contain the value %TRUE or %FALSE. +Never directly compare the contents of a #gboolean variable with the values +%TRUE or %FALSE. Use `if (condition)` to check a #gboolean is "true", instead +of `if (condition == TRUE)`. Likewise use `if (!condition)` to check a +#gboolean is "false". + +There is no validation when assigning to a #gboolean variable and so it could +contain any value represented by a #gint. This is why the use of `if +(condition)` is recommended. All non-zero values in C evaluate to "true". + @@ -62506,6 +63903,28 @@ An untyped pointer. + + +A type for implementing non-atomic reference count semantics. + +Use g_ref_count_init() to initialize it; g_ref_count_inc() to +increase the counter, and g_ref_count_dec() to decrease it. + +It is safe to use #grefcount only if you're expecting to operate +on the reference counter from a single thread. It is entirely up +to you to ensure that all reference count changes happen in the +same thread. + +See also: #gatomicrefcount + +Since: 2.58 + + + + + + + Corresponds to the standard C short type. diff --git a/glib/src/glib_enums.defs b/glib/src/glib_enums.defs index 1ff200d7..a967468b 100644 --- a/glib/src/glib_enums.defs +++ b/glib/src/glib_enums.defs @@ -1752,7 +1752,16 @@ ;; G_UNICODE_SCRIPT_MASARAM_GONDI, /* Gonm */ ;; G_UNICODE_SCRIPT_NUSHU, /* Nshu */ ;; G_UNICODE_SCRIPT_SOYOMBO, /* Soyo */ -;; G_UNICODE_SCRIPT_ZANABAZAR_SQUARE /* Zanb */ +;; G_UNICODE_SCRIPT_ZANABAZAR_SQUARE, /* Zanb */ +;; +;; /* Unicode 11.0 additions */ +;; G_UNICODE_SCRIPT_DOGRA, /* Dogr */ +;; G_UNICODE_SCRIPT_GUNJALA_GONDI, /* Gong */ +;; G_UNICODE_SCRIPT_HANIFI_ROHINGYA, /* Rohg */ +;; G_UNICODE_SCRIPT_MAKASAR, /* Maka */ +;; G_UNICODE_SCRIPT_MEDEFAIDRIN, /* Medf */ +;; G_UNICODE_SCRIPT_OLD_SOGDIAN, /* Sogo */ +;; G_UNICODE_SCRIPT_SOGDIAN /* Sogd */ ;; } GUnicodeScript; (define-enum-extended UnicodeScript @@ -1902,6 +1911,13 @@ '("nushu" "G_UNICODE_SCRIPT_NUSHU" "139") '("soyombo" "G_UNICODE_SCRIPT_SOYOMBO" "140") '("zanabazar-square" "G_UNICODE_SCRIPT_ZANABAZAR_SQUARE" "141") + '("dogra" "G_UNICODE_SCRIPT_DOGRA" "142") + '("gunjala-gondi" "G_UNICODE_SCRIPT_GUNJALA_GONDI" "143") + '("hanifi-rohingya" "G_UNICODE_SCRIPT_HANIFI_ROHINGYA" "144") + '("makasar" "G_UNICODE_SCRIPT_MAKASAR" "145") + '("medefaidrin" "G_UNICODE_SCRIPT_MEDEFAIDRIN" "146") + '("old-sogdian" "G_UNICODE_SCRIPT_OLD_SOGDIAN" "147") + '("sogdian" "G_UNICODE_SCRIPT_SOGDIAN" "148") ) ) diff --git a/glib/src/glib_functions.defs b/glib/src/glib_functions.defs index f8d3e058..22f9c2a1 100644 --- a/glib/src/glib_functions.defs +++ b/glib/src/glib_functions.defs @@ -971,6 +971,13 @@ '("nushu" "G_UNICODE_SCRIPT_NUSHU") '("soyombo" "G_UNICODE_SCRIPT_SOYOMBO") '("zanabazar-square" "G_UNICODE_SCRIPT_ZANABAZAR_SQUARE") + '("dogra" "G_UNICODE_SCRIPT_DOGRA") + '("gunjala-gondi" "G_UNICODE_SCRIPT_GUNJALA_GONDI") + '("hanifi-rohingya" "G_UNICODE_SCRIPT_HANIFI_ROHINGYA") + '("makasar" "G_UNICODE_SCRIPT_MAKASAR") + '("medefaidrin" "G_UNICODE_SCRIPT_MEDEFAIDRIN") + '("old-sogdian" "G_UNICODE_SCRIPT_OLD_SOGDIAN") + '("sogdian" "G_UNICODE_SCRIPT_SOGDIAN") ) ) @@ -1332,6 +1339,24 @@ ) ) +(define-method steal_index + (of-object "GPtrArray") + (c-name "g_ptr_array_steal_index") + (return-type "gpointer") + (parameters + '("guint" "index_") + ) +) + +(define-method steal_index_fast + (of-object "GPtrArray") + (c-name "g_ptr_array_steal_index_fast") + (return-type "gpointer") + (parameters + '("guint" "index_") + ) +) + (define-method remove (of-object "GPtrArray") (c-name "g_ptr_array_remove") @@ -2990,7 +3015,7 @@ (c-name "g_get_filename_charsets") (return-type "gboolean") (parameters - '("const-gchar***" "charsets") + '("const-gchar***" "filename_charsets") ) ) @@ -3914,6 +3939,12 @@ (return-type "GTimeSpan") ) +(define-method get_timezone + (of-object "GDateTime") + (c-name "g_date_time_get_timezone") + (return-type "GTimeZone*") +) + (define-method get_timezone_abbreviation (of-object "GDateTime") (c-name "g_date_time_get_timezone_abbreviation") @@ -4387,6 +4418,15 @@ ) ) +(define-function g_canonicalize_filename + (c-name "g_canonicalize_filename") + (return-type "gchar*") + (parameters + '("const-gchar*" "filename") + '("const-gchar*" "relative_to") + ) +) + ;; From ggettext.h @@ -4534,6 +4574,17 @@ ) ) +(define-method steal_extended + (of-object "GHashTable") + (c-name "g_hash_table_steal_extended") + (return-type "gboolean") + (parameters + '("gconstpointer" "lookup_key") + '("gpointer*" "stolen_key") + '("gpointer*" "stolen_value") + ) +) + (define-method steal_all (of-object "GHashTable") (c-name "g_hash_table_steal_all") @@ -6107,10 +6158,6 @@ -;; From glibconfig.h - - - ;; From glib.h @@ -6142,6 +6189,11 @@ (return-type "none") ) +(define-function g_console_win32_init + (c-name "g_console_win32_init") + (return-type "none") +) + (define-function g_clock_win32_init (c-name "g_clock_win32_init") (return-type "none") @@ -8693,6 +8745,15 @@ (return-type "gboolean") ) +(define-method clear_full + (of-object "GQueue") + (c-name "g_queue_clear_full") + (return-type "none") + (parameters + '("GDestroyNotify" "free_func") + ) +) + (define-method get_length (of-object "GQueue") (c-name "g_queue_get_length") @@ -9103,6 +9164,238 @@ +;; From grcbox.h + +(define-function g_rc_box_alloc + (c-name "g_rc_box_alloc") + (return-type "gpointer") + (parameters + '("gsize" "block_size") + ) +) + +(define-function g_rc_box_alloc0 + (c-name "g_rc_box_alloc0") + (return-type "gpointer") + (parameters + '("gsize" "block_size") + ) +) + +(define-function g_rc_box_dup + (c-name "g_rc_box_dup") + (return-type "gpointer") + (parameters + '("gsize" "block_size") + '("gconstpointer" "mem_block") + ) +) + +(define-function g_rc_box_acquire + (c-name "g_rc_box_acquire") + (return-type "gpointer") + (parameters + '("gpointer" "mem_block") + ) +) + +(define-function g_rc_box_release + (c-name "g_rc_box_release") + (return-type "none") + (parameters + '("gpointer" "mem_block") + ) +) + +(define-function g_rc_box_release_full + (c-name "g_rc_box_release_full") + (return-type "none") + (parameters + '("gpointer" "mem_block") + '("GDestroyNotify" "clear_func") + ) +) + +(define-function g_rc_box_get_size + (c-name "g_rc_box_get_size") + (return-type "gsize") + (parameters + '("gpointer" "mem_block") + ) +) + +(define-function g_atomic_rc_box_alloc + (c-name "g_atomic_rc_box_alloc") + (return-type "gpointer") + (parameters + '("gsize" "block_size") + ) +) + +(define-function g_atomic_rc_box_alloc0 + (c-name "g_atomic_rc_box_alloc0") + (return-type "gpointer") + (parameters + '("gsize" "block_size") + ) +) + +(define-function g_atomic_rc_box_dup + (c-name "g_atomic_rc_box_dup") + (return-type "gpointer") + (parameters + '("gsize" "block_size") + '("gconstpointer" "mem_block") + ) +) + +(define-function g_atomic_rc_box_acquire + (c-name "g_atomic_rc_box_acquire") + (return-type "gpointer") + (parameters + '("gpointer" "mem_block") + ) +) + +(define-function g_atomic_rc_box_release + (c-name "g_atomic_rc_box_release") + (return-type "none") + (parameters + '("gpointer" "mem_block") + ) +) + +(define-function g_atomic_rc_box_release_full + (c-name "g_atomic_rc_box_release_full") + (return-type "none") + (parameters + '("gpointer" "mem_block") + '("GDestroyNotify" "clear_func") + ) +) + +(define-function g_atomic_rc_box_get_size + (c-name "g_atomic_rc_box_get_size") + (return-type "gsize") + (parameters + '("gpointer" "mem_block") + ) +) + + + +;; From grefcount.h + +(define-method init + (of-object "grefcount") + (c-name "g_ref_count_init") + (return-type "none") +) + +(define-method inc + (of-object "grefcount") + (c-name "g_ref_count_inc") + (return-type "none") +) + +(define-method dec + (of-object "grefcount") + (c-name "g_ref_count_dec") + (return-type "gboolean") +) + +(define-method compare + (of-object "grefcount") + (c-name "g_ref_count_compare") + (return-type "gboolean") + (parameters + '("gint" "val") + ) +) + +(define-method init + (of-object "gatomicrefcount") + (c-name "g_atomic_ref_count_init") + (return-type "none") +) + +(define-method inc + (of-object "gatomicrefcount") + (c-name "g_atomic_ref_count_inc") + (return-type "none") +) + +(define-method dec + (of-object "gatomicrefcount") + (c-name "g_atomic_ref_count_dec") + (return-type "gboolean") +) + +(define-method compare + (of-object "gatomicrefcount") + (c-name "g_atomic_ref_count_compare") + (return-type "gboolean") + (parameters + '("gint" "val") + ) +) + + + +;; From grefstring.h + +(define-function g_ref_string_new + (c-name "g_ref_string_new") + (is-constructor-of "GRefString") + (return-type "char*") + (parameters + '("const-char*" "str") + ) +) + +(define-function g_ref_string_new_len + (c-name "g_ref_string_new_len") + (return-type "char*") + (parameters + '("const-char*" "str") + '("gssize" "len") + ) +) + +(define-function g_ref_string_new_intern + (c-name "g_ref_string_new_intern") + (return-type "char*") + (parameters + '("const-char*" "str") + ) +) + +(define-function g_ref_string_acquire + (c-name "g_ref_string_acquire") + (return-type "char*") + (parameters + '("char*" "str") + ) +) + +(define-function g_ref_string_release + (c-name "g_ref_string_release") + (return-type "none") + (parameters + '("char*" "str") + ) +) + +(define-function g_ref_string_length + (c-name "g_ref_string_length") + (return-type "gsize") + (parameters + '("char*" "str") + ) +) + + + ;; From gregex.h (define-function g_regex_error_quark @@ -10396,6 +10689,24 @@ ) ) +(define-function g_spawn_async_with_fds + (c-name "g_spawn_async_with_fds") + (return-type "gboolean") + (parameters + '("const-gchar*" "working_directory") + '("gchar**" "argv") + '("gchar**" "envp") + '("GSpawnFlags" "flags") + '("GSpawnChildSetupFunc" "child_setup") + '("gpointer" "user_data") + '("GPid*" "child_pid") + '("gint" "stdin_fd") + '("gint" "stdout_fd") + '("gint" "stderr_fd") + '("GError**" "error") + ) +) + (define-function g_spawn_sync (c-name "g_spawn_sync") (return-type "gboolean") @@ -11087,6 +11398,15 @@ ) ) +(define-function g_strv_equal + (c-name "g_strv_equal") + (return-type "gboolean") + (parameters + '("const-gchar*-const*" "strv1") + '("const-gchar*-const*" "strv2") + ) +) + (define-function g_number_parser_error_quark (c-name "g_number_parser_error_quark") (return-type "GQuark") @@ -12241,6 +12561,18 @@ (return-type "none") ) +(define-method locker_new + (of-object "GRecMutex") + (c-name "g_rec_mutex_locker_new") + (return-type "GRecMutexLocker*") +) + +(define-method free + (of-object "GRecMutexLocker") + (c-name "g_rec_mutex_locker_free") + (return-type "none") +) + ;; From gthreadpool.h @@ -12465,6 +12797,14 @@ (return-type "GTimeZone*") ) +(define-function g_time_zone_new_offset + (c-name "g_time_zone_new_offset") + (return-type "GTimeZone*") + (parameters + '("gint32" "seconds") + ) +) + (define-method ref (of-object "GTimeZone") (c-name "g_time_zone_ref") @@ -12524,6 +12864,12 @@ ) ) +(define-method get_identifier + (of-object "GTimeZone") + (c-name "g_time_zone_get_identifier") + (return-type "const-gchar*") +) + ;; From gtranslit-data.h @@ -13187,6 +13533,16 @@ ) ) +(define-function g_utf8_validate_len + (c-name "g_utf8_validate_len") + (return-type "gboolean") + (parameters + '("const-gchar*" "str") + '("gsize" "max_len") + '("const-gchar**" "end") + ) +) + (define-function g_utf8_strup (c-name "g_utf8_strup") (return-type "gchar*") @@ -13545,6 +13901,10 @@ +;; From gvalgrind.h + + + ;; From gvariant-core.h (define-function g_variant_new_from_children @@ -13649,7 +14009,7 @@ (c-name "g_variant_new_byte") (return-type "GVariant*") (parameters - '("guchar" "value") + '("guint8" "value") ) ) @@ -13835,7 +14195,7 @@ (define-method get_byte (of-object "GVariant") (c-name "g_variant_get_byte") - (return-type "guchar") + (return-type "guint8") ) (define-method get_int16 @@ -14601,6 +14961,12 @@ ) ) +(define-method check + (of-object "GVariantSerialised") + (c-name "g_variant_serialised_check") + (return-type "gboolean") +) + (define-method is_normal (of-object "GVariantSerialised") (c-name "g_variant_serialised_is_normal") @@ -14849,6 +15215,14 @@ ) ) +(define-function g_variant_type_string_get_depth_ + (c-name "g_variant_type_string_get_depth_") + (return-type "gsize") + (parameters + '("const-gchar*" "type_string") + ) +) + ;; From gvarianttypeinfo.h @@ -14869,6 +15243,12 @@ ) ) +(define-method query_depth + (of-object "GVariantTypeInfo") + (c-name "g_variant_type_info_query_depth") + (return-type "gsize") +) + (define-method element (of-object "GVariantTypeInfo") (c-name "g_variant_type_info_element") @@ -15714,3 +16094,7 @@ ) + +;; From glibconfig.h + + diff --git a/glib/src/gmodule_functions.defs b/glib/src/gmodule_functions.defs index 29b48355..831b300f 100644 --- a/glib/src/gmodule_functions.defs +++ b/glib/src/gmodule_functions.defs @@ -14,10 +14,6 @@ ) -;; From gmoduleconf.h - - - ;; From gmodule.h (define-function g_module_supported @@ -77,3 +73,7 @@ ) + +;; From gmoduleconf.h + + diff --git a/glib/src/gobject_functions.defs b/glib/src/gobject_functions.defs index 93ad8d2d..154968e0 100644 --- a/glib/src/gobject_functions.defs +++ b/glib/src/gobject_functions.defs @@ -1971,7 +1971,7 @@ (c-name "g_clear_object") (return-type "none") (parameters - '("volatile-GObject**" "object_ptr") + '("GObject**" "object_ptr") ) ) @@ -4193,3 +4193,51 @@ ) + +;; From glib-enumtypes.h + +(define-function g_unicode_type_get_type + (c-name "g_unicode_type_get_type") + (return-type "GType") +) + +(define-function g_unicode_break_type_get_type + (c-name "g_unicode_break_type_get_type") + (return-type "GType") +) + +(define-function g_unicode_script_get_type + (c-name "g_unicode_script_get_type") + (return-type "GType") +) + +(define-function g_normalize_mode_get_type + (c-name "g_normalize_mode_get_type") + (return-type "GType") +) + + + +;; From gobjectenumtypes.h + +(define-function g_unicode_type_get_type + (c-name "g_unicode_type_get_type") + (return-type "GType") +) + +(define-function g_unicode_break_type_get_type + (c-name "g_unicode_break_type_get_type") + (return-type "GType") +) + +(define-function g_unicode_script_get_type + (c-name "g_unicode_script_get_type") + (return-type "GType") +) + +(define-function g_normalize_mode_get_type + (c-name "g_normalize_mode_get_type") + (return-type "GType") +) + + -- cgit v1.2.1