diff options
Diffstat (limited to 'gio/src/gio_docs.xml')
-rw-r--r-- | gio/src/gio_docs.xml | 5160 |
1 files changed, 1629 insertions, 3531 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. </return> </signal> +<signal name="GApplication::name-lost"> +<description> +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 + +</description> +<parameters> +<parameter name="application"> +<parameter_description> the application +</parameter_description> +</parameter> +</parameters> +<return> %TRUE if the signal has been handled + +</return> +</signal> + <signal name="GApplication::open"> <description> 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 </parameter_description> </parameter> +<parameter name="G_APPLICATION_ALLOW_REPLACEMENT"> +<parameter_description> Allow another instance to take over +the bus name. Since: 2.60 +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_REPLACE"> +<parameter_description> Take over from another instance. This flag is +usually set by passing `--gapplication-replace` on the commandline. +Since: 2.60 +</parameter_description> +</parameter> </parameters> </enum> @@ -495,6 +528,10 @@ situation. <parameter_description> operation supports anonymous users. </parameter_description> </parameter> +<parameter name="G_ASK_PASSWORD_TCRYPT"> +<parameter_description> operation takes TCRYPT parameters (Since: 2.58) +</parameter_description> +</parameter> </parameters> </enum> @@ -1660,7 +1697,7 @@ Since: 2.30 </parameter_description> </parameter> <parameter name="changed_properties"> -<parameter_description> A #GVariant containing the properties that changed. +<parameter_description> A #GVariant containing the properties that changed (type: `a{sv}`). </parameter_description> </parameter> <parameter name="invalidated_properties"> @@ -1949,7 +1986,7 @@ Since: 2.26 </parameter_description> </parameter> <parameter name="changed_properties"> -<parameter_description> A #GVariant containing the properties that changed +<parameter_description> A #GVariant containing the properties that changed (type: `a{sv}`) </parameter_description> </parameter> <parameter name="invalidated_properties"> @@ -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. </return> </signal> +<property name="GDtlsConnection:advertised-protocols"> +<description> +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 + +</description> +</property> + <property name="GDtlsConnection:base-socket"> <description> The #GDatagramBased that the connection wraps. Note that this may be any @@ -2690,6 +2738,16 @@ Since: 2.48 </description> </property> +<property name="GDtlsConnection:negotiated-protocol"> +<description> +The application-layer protocol negotiated during the TLS +handshake. See g_dtls_connection_get_negotiated_protocol(). + +Since: 2.60 + +</description> +</property> + <property name="GDtlsConnection:peer-certificate"> <description> 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. + </description> </property> @@ -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. + </description> <parameters> <parameter name="G_IO_ERROR_FAILED"> @@ -3603,6 +3668,45 @@ Since: 2.32 </description> </property> +<property name="GKeyfileSettingsBackend:default-dir"> +<description> +The directory where the system defaults and locks are located. + +Defaults to `/etc/glib-2.0/settings`. + +</description> +</property> + +<property name="GKeyfileSettingsBackend:filename"> +<description> +The location where the settings are stored on disk. + +Defaults to `$XDG_CONFIG_HOME/glib-2.0/settings/keyfile`. + +</description> +</property> + +<property name="GKeyfileSettingsBackend:root-group"> +<description> +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. + +</description> +</property> + +<property name="GKeyfileSettingsBackend:root-path"> +<description> +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 "/". + +</description> +</property> + <signal name="GListModel::items-changed"> <description> This signal is emitted whenever items were added or removed to @@ -4000,6 +4104,29 @@ The domain to use for the mount operation. </description> </property> +<property name="GMountOperation:is-tcrypt-hidden-volume"> +<description> +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 + +</description> +</property> + +<property name="GMountOperation:is-tcrypt-system-volume"> +<description> +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 + +</description> +</property> + <property name="GMountOperation:password"> <description> The password that is used for authentication when carrying out @@ -4015,6 +4142,16 @@ Determines if and how the password information should be saved. </description> </property> +<property name="GMountOperation:pim"> +<description> +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 + +</description> +</property> + <property name="GMountOperation:username"> <description> The user name that is used for authentication when carrying out @@ -4286,6 +4423,37 @@ g_permission_release(). </description> </property> +<enum name="GPollableReturn"> +<description> +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 + +</description> +<parameters> +<parameter name="G_POLLABLE_RETURN_FAILED"> +<parameter_description> Generic error condition for when an operation fails. +</parameter_description> +</parameter> +<parameter name="G_POLLABLE_RETURN_OK"> +<parameter_description> The operation was successfully finished. +</parameter_description> +</parameter> +<parameter name="G_POLLABLE_RETURN_WOULD_BLOCK"> +<parameter_description> The operation would block. +</parameter_description> +</parameter> +</parameters> +</enum> + <property name="GPropertyAction:enabled"> <description> If @action is currently enabled. @@ -4450,6 +4618,29 @@ be looked up due to a network error or similar problem </parameters> </enum> +<enum name="GResolverNameLookupFlags"> +<description> +Flags to modify lookup behavior. + +Since: 2.60 + +</description> +<parameters> +<parameter name="G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT"> +<parameter_description> default behavior (same as g_resolver_lookup_by_name()) +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY"> +<parameter_description> only resolve ipv4 addresses +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY"> +<parameter_description> only resolve ipv6 addresses +</parameter_description> +</parameter> +</parameters> +</enum> + <enum name="GResolverRecordType"> <description> 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(). <description> 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 </parameter_description> </parameter> <parameter name="parameter"> -<parameter_description> the parameter to the activation +<parameter_description> the parameter to the activation, or %NULL if it has +no parameter </parameter_description> </parameter> </parameters> @@ -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 <description> 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. </return> </signal> +<property name="GTlsConnection:advertised-protocols"> +<description> +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 + +</description> +</property> + <property name="GTlsConnection:base-io-stream"> <description> The #GIOStream that the connection wraps. The connection holds a reference @@ -5926,6 +6125,16 @@ Since: 2.30 </description> </property> +<property name="GTlsConnection:negotiated-protocol"> +<description> +The application-layer protocol negotiated during the TLS +handshake. See g_tls_connection_get_negotiated_protocol(). + +Since: 2.60 + +</description> +</property> + <property name="GTlsConnection:peer-certificate"> <description> The connection's peer's certificate, after the TLS handshake has @@ -6041,7 +6250,8 @@ Since: 2.28 </parameter_description> </parameter> <parameter name="G_TLS_ERROR_BAD_CERTIFICATE"> -<parameter_description> A certificate could not be parsed +<parameter_description> The certificate presented could not +be parsed or failed validation. </parameter_description> </parameter> <parameter name="G_TLS_ERROR_NOT_TLS"> @@ -6066,6 +6276,12 @@ notice, which may indicate an attack. See g_tls_connection_set_require_close_notify(). </parameter_description> </parameter> +<parameter name="G_TLS_ERROR_INAPPROPRIATE_FALLBACK"> +<parameter_description> The TLS handshake failed +because the client sent the fallback SCSV, indicating a protocol +downgrade attack. Since: 2.60 +</parameter_description> +</parameter> </parameters> </enum> @@ -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. + </description> <parameters> <parameter name="G_TLS_REHANDSHAKE_NEVER"> @@ -6660,485 +6880,6 @@ Since: 2.46 </description> </property> -<signal name="GXdpDocuments::handle-add"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="arg_o_path_fd"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_reuse_existing"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_persistent"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-add-full"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="arg_o_path_fds"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_flags"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-add-named"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="arg_o_path_parent_fd"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_filename"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_reuse_existing"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_persistent"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-delete"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-get-mount-point"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-grant-permissions"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-info"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-list"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-lookup"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_filename"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpDocuments::handle-revoke-permissions"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<property name="GXdpDocuments:version"> -<description> -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. - -</description> -</property> - -<signal name="GXdpNetworkMonitor::changed"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -<parameter name="arg_available"> -<parameter_description> Argument. -</parameter_description> -</parameter> -</parameters> -<return></return> -</signal> - -<property name="GXdpNetworkMonitor:available"> -<description> -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. - -</description> -</property> - -<property name="GXdpNetworkMonitor:connectivity"> -<description> -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. - -</description> -</property> - -<property name="GXdpNetworkMonitor:metered"> -<description> -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. - -</description> -</property> - -<signal name="GXdpOpenURI::handle-open-file"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpOpenURI. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="arg_parent_window"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_fd"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_options"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<signal name="GXdpOpenURI::handle-open-uri"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpOpenURI. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_parent_window"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_uri"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -<parameter name="arg_options"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - -<property name="GXdpOpenURI:version"> -<description> -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. - -</description> -</property> - -<signal name="GXdpProxyResolver::handle-lookup"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpProxyResolver. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="arg_uri"> -<parameter_description> Argument passed by remote caller. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run. -</return> -</signal> - <property name="GZlibCompressor:file-info"> <description> 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. + </description> <parameters> @@ -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 </description> @@ -8616,7 +8365,7 @@ Since: 2.50 </parameter_description> </parameter> <parameter name="callback"> -<parameter_description> a #GASyncReadyCallback to call when the request is done +<parameter_description> a #GAsyncReadyCallback to call when the request is done </parameter_description> </parameter> <parameter name="user_data"> @@ -8686,6 +8435,73 @@ no way to detect this. </return> </function> +<function name="g_app_info_launch_uris_async"> +<description> +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 + +</description> +<parameters> +<parameter name="appinfo"> +<parameter_description> a #GAppInfo +</parameter_description> +</parameter> +<parameter name="uris"> +<parameter_description> a #GList containing URIs to launch. +</parameter_description> +</parameter> +<parameter name="context"> +<parameter_description> a #GAppLaunchContext or %NULL +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> a #GCancellable +</parameter_description> +</parameter> +<parameter name="callback"> +<parameter_description> a #GAsyncReadyCallback to call when the request is done +</parameter_description> +</parameter> +<parameter name="user_data"> +<parameter_description> data to pass to @callback +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_app_info_launch_uris_finish"> +<description> +Finishes a g_app_info_launch_uris_async() operation. + +Since: 2.60 + +</description> +<parameters> +<parameter name="appinfo"> +<parameter_description> a #GAppInfo +</parameter_description> +</parameter> +<parameter name="result"> +<parameter_description> a #GAsyncResult +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> a #GError +</parameter_description> +</parameter> +</parameters> +<return> %TRUE on successful launch, %FALSE otherwise. + +</return> +</function> + <function name="g_app_info_monitor_get"> <description> Gets the #GAppInfoMonitor for the current thread-default main @@ -12093,7 +11909,7 @@ See also g_cancellable_make_pollfd(). </parameter_description> </parameter> </parameters> -<return> A valid file descriptor. %-1 if the file descriptor +<return> A valid file descriptor. `-1` if the file descriptor is not supported, or on errors. </return> </function> @@ -12502,6 +12318,22 @@ object with g_object_unref() </return> </function> +<function name="g_content_type_get_mime_dirs"> +<description> +Get the list of directories which MIME data is loaded from. See +g_content_type_set_mime_dirs() for details. + +Since: 2.60 + +</description> +<parameters> +</parameters> +<return> %NULL-terminated list of +directories to load MIME data from, including any `mime/` subdirectory, +and with the first directory to try listed first +</return> +</function> + <function name="g_content_type_get_mime_type"> <description> 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. </parameter_description> </parameter> </parameters> -<return> the registered mime type for the given @type, -or %NULL if unknown. +<return> the registered mime type for the +given @type, or %NULL if unknown; free with g_free(). </return> </function> @@ -12665,11 +12497,51 @@ or octet-stream. </return> </function> +<function name="g_content_type_set_mime_dirs"> +<description> +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 + +</description> +<parameters> +<parameter name="dirs"> +<parameter_description> %NULL-terminated list of +directories to load MIME data from, including any `mime/` subdirectory, +and with the first directory to try listed first +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_content_types_get_registered"> <description> 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)`. </description> @@ -13185,7 +13057,7 @@ Reads an unsigned 8-bit/1-byte value from @stream. </parameter_description> </parameter> </parameters> -<return> an unsigned 8-bit/1-byte value read from the @stream or %0 +<return> an unsigned 8-bit/1-byte value read from the @stream or `0` if an error occurred. </return> </function> @@ -13213,7 +13085,7 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( </parameter_description> </parameter> </parameters> -<return> a signed 16-bit/2-byte value read from @stream or %0 if +<return> a signed 16-bit/2-byte value read from @stream or `0` if an error occurred. </return> </function> @@ -13245,7 +13117,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. </parameter_description> </parameter> </parameters> -<return> a signed 32-bit/4-byte value read from the @stream or %0 if +<return> a signed 32-bit/4-byte value read from the @stream or `0` if an error occurred. </return> </function> @@ -13277,7 +13149,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. </parameter_description> </parameter> </parameters> -<return> a signed 64-bit/8-byte value read from @stream or %0 if +<return> a signed 64-bit/8-byte value read from @stream or `0` if an error occurred. </return> </function> @@ -13495,7 +13367,7 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( </parameter_description> </parameter> </parameters> -<return> an unsigned 16-bit/2-byte value read from the @stream or %0 if +<return> an unsigned 16-bit/2-byte value read from the @stream or `0` if an error occurred. </return> </function> @@ -13527,7 +13399,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. </parameter_description> </parameter> </parameters> -<return> an unsigned 32-bit/4-byte value read from the @stream or %0 if +<return> an unsigned 32-bit/4-byte value read from the @stream or `0` if an error occurred. </return> </function> @@ -13559,7 +13431,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. </parameter_description> </parameter> </parameters> -<return> an unsigned 64-bit/8-byte read from @stream or %0 if +<return> an unsigned 64-bit/8-byte read from @stream or `0` if an error occurred. </return> </function> @@ -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() <function name="g_dbus_connection_close_sync"> <description> -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 </return> </function> +<function name="g_dbus_connection_get_flags"> +<description> +Gets the flags used to construct this connection + +Since: 2.60 + +</description> +<parameters> +<parameter name="connection"> +<parameter_description> a #GDBusConnection +</parameter_description> +</parameter> +</parameters> +<return> zero or more flags from the #GDBusConnectionFlags enumeration + +</return> +</function> + <function name="g_dbus_connection_get_guid"> <description> 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 </description> @@ -17930,7 +17825,7 @@ Since: 2.26 </description> <parameters> <parameter name="blob"> -<parameter_description> A blob represent a binary D-Bus message. +<parameter_description> A blob representing a binary D-Bus message. </parameter_description> </parameter> <parameter name="blob_len"> @@ -18089,6 +17984,9 @@ Since: 2.26 <description> 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 </description> @@ -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 </description> <parameters> <parameter name="blob"> -<parameter_description> A blob represent a binary D-Bus message. +<parameter_description> A blob representing a binary D-Bus message. </parameter_description> </parameter> <parameter name="blob_len"> @@ -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 </return> </function> +<function name="g_desktop_app_info_get_string_list"> +<description> +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 + +</description> +<parameters> +<parameter name="info"> +<parameter_description> a #GDesktopAppInfo +</parameter_description> +</parameter> +<parameter name="key"> +<parameter_description> the key to look up +</parameter_description> +</parameter> +<parameter name="length"> +<parameter_description> return location for the number of returned strings, or %NULL +</parameter_description> +</parameter> +</parameters> +<return> +a %NULL-terminated string array or %NULL if the specified +key cannot be found. The array should be freed with g_strfreev(). + +</return> +</function> + <function name="g_desktop_app_info_has_key"> <description> 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. </return> </function> +<function name="g_desktop_app_info_launch_uris_as_manager_with_fds"> +<description> +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 + +</description> +<parameters> +<parameter name="appinfo"> +<parameter_description> a #GDesktopAppInfo +</parameter_description> +</parameter> +<parameter name="uris"> +<parameter_description> List of URIs +</parameter_description> +</parameter> +<parameter name="launch_context"> +<parameter_description> a #GAppLaunchContext +</parameter_description> +</parameter> +<parameter name="spawn_flags"> +<parameter_description> #GSpawnFlags, used for each process +</parameter_description> +</parameter> +<parameter name="user_setup"> +<parameter_description> a #GSpawnChildSetupFunc, used once +for each process. +</parameter_description> +</parameter> +<parameter name="user_setup_data"> +<parameter_description> User data for @user_setup +</parameter_description> +</parameter> +<parameter name="pid_callback"> +<parameter_description> Callback for child processes +</parameter_description> +</parameter> +<parameter name="pid_callback_data"> +<parameter_description> User data for @callback +</parameter_description> +</parameter> +<parameter name="stdin_fd"> +<parameter_description> file descriptor to use for child's stdin, or -1 +</parameter_description> +</parameter> +<parameter name="stdout_fd"> +<parameter_description> file descriptor to use for child's stdout, or -1 +</parameter_description> +</parameter> +<parameter name="stderr_fd"> +<parameter_description> file descriptor to use for child's stderr, or -1 +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> return location for a #GError, or %NULL +</parameter_description> +</parameter> +</parameters> +<return> %TRUE on successful launch, %FALSE otherwise. + +</return> +</function> + <function name="g_desktop_app_info_list_actions"> <description> Returns the list of "additional application actions" supported on the @@ -22130,7 +22138,8 @@ prefix-to-subdirectory mapping that is described in the </parameter_description> </parameter> </parameters> -<return> a new #GDesktopAppInfo, or %NULL if no desktop file with that id +<return> a new #GDesktopAppInfo, or %NULL if no desktop +file with that id exists. </return> </function> @@ -22473,7 +22482,9 @@ Free the returned object with g_object_unref(). <function name="g_drive_get_identifier"> <description> -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. </description> @@ -22488,7 +22499,7 @@ Gets the identifier of the given kind for @drive. </parameter> </parameters> <return> 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. </return> </function> @@ -23189,6 +23200,30 @@ Since: 2.48 </return> </function> +<function name="g_dtls_connection_get_negotiated_protocol"> +<description> +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 + +</description> +<parameters> +<parameter name="conn"> +<parameter_description> a #GDtlsConnection +</parameter_description> +</parameter> +</parameters> +<return> the negotiated protocol, or %NULL + +</return> +</function> + <function name="g_dtls_connection_get_peer_certificate"> <description> 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. </return> </function> +<function name="g_dtls_connection_set_advertised_protocols"> +<description> +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 + +</description> +<parameters> +<parameter name="conn"> +<parameter_description> a #GDtlsConnection +</parameter_description> +</parameter> +<parameter name="protocols"> +<parameter_description> a %NULL-terminated +array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_dtls_connection_set_certificate"> <description> 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. + </description> <parameters> <parameter name="conn"> @@ -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. <function name="g_file_info_set_attribute"> <description> 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. </description> <parameters> @@ -27015,7 +27096,8 @@ Sinze: 2.22 </parameter_description> </parameter> <parameter name="attr_value"> -<parameter_description> a %NULL terminated array of UTF-8 strings. +<parameter_description> a %NULL +terminated array of UTF-8 strings. </parameter_description> </parameter> </parameters> @@ -27573,7 +27655,7 @@ Since: 2.22 <description> 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() </return> </function> +<function name="g_file_query_default_handler_async"> +<description> +Async version of g_file_query_default_handler(). + +Since: 2.60 + +</description> +<parameters> +<parameter name="file"> +<parameter_description> a #GFile to open +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> optional #GCancellable object, %NULL to ignore +</parameter_description> +</parameter> +<parameter name="callback"> +<parameter_description> a #GAsyncReadyCallback to call when the request is done +</parameter_description> +</parameter> +<parameter name="user_data"> +<parameter_description> data to pass to @callback +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_file_query_default_handler_finish"> +<description> +Finishes a g_file_query_default_handler_async() operation. + +Since: 2.60 + +</description> +<parameters> +<parameter name="file"> +<parameter_description> a #GFile to open +</parameter_description> +</parameter> +<parameter name="result"> +<parameter_description> a #GAsyncResult +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> a #GError +</parameter_description> +</parameter> +</parameters> +<return> a #GAppInfo if the handle was found, +%NULL if there were errors. +When you are done with it, release it with g_object_unref() + +</return> +</function> + <function name="g_file_query_exists"> <description> 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. + </description> <parameters> @@ -36647,7 +36790,8 @@ using that object to get the #GDrive. </parameter_description> </parameter> </parameters> -<return> a #GDrive or %NULL if @mount is not associated with a volume or a drive. +<return> 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. </return> @@ -36760,7 +36904,8 @@ available. </parameter_description> </parameter> </parameters> -<return> the UUID for @mount or %NULL if no UUID can be computed. +<return> 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. </return> @@ -36778,7 +36923,8 @@ Gets the volume for the @mount. </parameter_description> </parameter> </parameters> -<return> a #GVolume or %NULL if @mount is not associated with a volume. +<return> 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. </return> @@ -36990,6 +37136,44 @@ Gets the domain of the mount operation. </return> </function> +<function name="g_mount_operation_get_is_tcrypt_hidden_volume"> +<description> +Check to see whether the mount operation is being used +for a TCRYPT hidden volume. + +Since: 2.58 + +</description> +<parameters> +<parameter name="op"> +<parameter_description> a #GMountOperation. +</parameter_description> +</parameter> +</parameters> +<return> %TRUE if mount operation is for hidden volume. + +</return> +</function> + +<function name="g_mount_operation_get_is_tcrypt_system_volume"> +<description> +Check to see whether the mount operation is being used +for a TCRYPT system volume. + +Since: 2.58 + +</description> +<parameters> +<parameter name="op"> +<parameter_description> a #GMountOperation. +</parameter_description> +</parameter> +</parameters> +<return> %TRUE if mount operation is for system volume. + +</return> +</function> + <function name="g_mount_operation_get_password"> <description> Gets a password from the mount operation. @@ -37022,6 +37206,24 @@ Gets the state of saving passwords for the mount operation. </return> </function> +<function name="g_mount_operation_get_pim"> +<description> +Gets a PIM from the mount operation. + +Since: 2.58 + +</description> +<parameters> +<parameter name="op"> +<parameter_description> a #GMountOperation. +</parameter_description> +</parameter> +</parameters> +<return> The VeraCrypt PIM within @op. + +</return> +</function> + <function name="g_mount_operation_get_username"> <description> Get the user name from the mount operation. @@ -37122,6 +37324,46 @@ Sets the mount operation's domain. <return></return> </function> +<function name="g_mount_operation_set_is_tcrypt_hidden_volume"> +<description> +Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE. + +Since: 2.58 + +</description> +<parameters> +<parameter name="op"> +<parameter_description> a #GMountOperation. +</parameter_description> +</parameter> +<parameter name="hidden_volume"> +<parameter_description> boolean value. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_mount_operation_set_is_tcrypt_system_volume"> +<description> +Sets the mount operation to use a system volume if @system_volume is %TRUE. + +Since: 2.58 + +</description> +<parameters> +<parameter name="op"> +<parameter_description> a #GMountOperation. +</parameter_description> +</parameter> +<parameter name="system_volume"> +<parameter_description> boolean value. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_mount_operation_set_password"> <description> Sets the mount operation's password to @password. @@ -37160,6 +37402,26 @@ Sets the state of saving passwords for the mount operation. <return></return> </function> +<function name="g_mount_operation_set_pim"> +<description> +Sets the mount operation's PIM to @pim. + +Since: 2.58 + +</description> +<parameters> +<parameter name="op"> +<parameter_description> a #GMountOperation. +</parameter_description> +</parameter> +<parameter name="pim"> +<parameter_description> an unsigned integer. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_mount_operation_set_username"> <description> Sets the user name within @op to @username. @@ -39286,6 +39548,323 @@ ignore. </return> </function> +<function name="g_output_stream_writev"> +<description> +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 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> a #GOutputStream. +</parameter_description> +</parameter> +<parameter name="vectors"> +<parameter_description> the buffer containing the #GOutputVectors to write. +</parameter_description> +</parameter> +<parameter name="n_vectors"> +<parameter_description> the number of vectors to write +</parameter_description> +</parameter> +<parameter name="bytes_written"> +<parameter_description> location to store the number of bytes that were +written to the stream +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> optional cancellable object +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> location to store the error occurring, or %NULL to ignore +</parameter_description> +</parameter> +</parameters> +<return> %TRUE on success, %FALSE if there was an error + +</return> +</function> + +<function name="g_output_stream_writev_all"> +<description> +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 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> a #GOutputStream. +</parameter_description> +</parameter> +<parameter name="vectors"> +<parameter_description> the buffer containing the #GOutputVectors to write. +</parameter_description> +</parameter> +<parameter name="n_vectors"> +<parameter_description> the number of vectors to write +</parameter_description> +</parameter> +<parameter name="bytes_written"> +<parameter_description> location to store the number of bytes that were +written to the stream +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> optional #GCancellable object, %NULL to ignore. +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> location to store the error occurring, or %NULL to ignore +</parameter_description> +</parameter> +</parameters> +<return> %TRUE on success, %FALSE if there was an error + +</return> +</function> + +<function name="g_output_stream_writev_all_async"> +<description> +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 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> A #GOutputStream +</parameter_description> +</parameter> +<parameter name="vectors"> +<parameter_description> the buffer containing the #GOutputVectors to write. +</parameter_description> +</parameter> +<parameter name="n_vectors"> +<parameter_description> the number of vectors to write +</parameter_description> +</parameter> +<parameter name="io_priority"> +<parameter_description> the I/O priority of the request +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> optional #GCancellable object, %NULL to ignore +</parameter_description> +</parameter> +<parameter name="callback"> +<parameter_description> callback to call when the request is satisfied +</parameter_description> +</parameter> +<parameter name="user_data"> +<parameter_description> the data to pass to callback function +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_output_stream_writev_all_finish"> +<description> +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 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> a #GOutputStream +</parameter_description> +</parameter> +<parameter name="result"> +<parameter_description> a #GAsyncResult +</parameter_description> +</parameter> +<parameter name="bytes_written"> +<parameter_description> location to store the number of bytes that were written to the stream +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> a #GError location to store the error occurring, or %NULL to ignore. +</parameter_description> +</parameter> +</parameters> +<return> %TRUE on success, %FALSE if there was an error + +</return> +</function> + +<function name="g_output_stream_writev_async"> +<description> +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 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> A #GOutputStream. +</parameter_description> +</parameter> +<parameter name="vectors"> +<parameter_description> the buffer containing the #GOutputVectors to write. +</parameter_description> +</parameter> +<parameter name="n_vectors"> +<parameter_description> the number of vectors to write +</parameter_description> +</parameter> +<parameter name="io_priority"> +<parameter_description> the I/O priority of the request. +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> optional #GCancellable object, %NULL to ignore. +</parameter_description> +</parameter> +<parameter name="callback"> +<parameter_description> callback to call when the request is satisfied +</parameter_description> +</parameter> +<parameter name="user_data"> +<parameter_description> the data to pass to callback function +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_output_stream_writev_finish"> +<description> +Finishes a stream writev operation. + +Since: 2.60 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> a #GOutputStream. +</parameter_description> +</parameter> +<parameter name="result"> +<parameter_description> a #GAsyncResult. +</parameter_description> +</parameter> +<parameter name="bytes_written"> +<parameter_description> location to store the number of bytes that were written to the stream +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> a #GError location to store the error occurring, or %NULL to +ignore. +</parameter_description> +</parameter> +</parameters> +<return> %TRUE on success, %FALSE if there was an error + +</return> +</function> + <function name="g_permission_acquire"> <description> 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 </return> </function> +<function name="g_pollable_output_stream_writev_nonblocking"> +<description> +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 + +</description> +<parameters> +<parameter name="stream"> +<parameter_description> a #GPollableOutputStream +</parameter_description> +</parameter> +<parameter name="vectors"> +<parameter_description> the buffer containing the #GOutputVectors to write. +</parameter_description> +</parameter> +<parameter name="n_vectors"> +<parameter_description> the number of vectors to write +</parameter_description> +</parameter> +<parameter name="bytes_written"> +<parameter_description> location to store the number of bytes that were +written to the stream +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> a #GCancellable, or %NULL +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> #GError for error reporting, or %NULL to ignore. +</parameter_description> +</parameter> +</parameters> +<return> %@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. + +</return> +</function> + <function name="g_pollable_source_new"> <description> Utility method for #GPollableInputStream and #GPollableOutputStream @@ -40913,6 +41552,117 @@ for more details. </return> </function> +<function name="g_resolver_lookup_by_name_with_flags"> +<description> +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 + +</description> +<parameters> +<parameter name="resolver"> +<parameter_description> a #GResolver +</parameter_description> +</parameter> +<parameter name="hostname"> +<parameter_description> the hostname to look up +</parameter_description> +</parameter> +<parameter name="flags"> +<parameter_description> extra #GResolverNameLookupFlags for the lookup +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> a #GCancellable, or %NULL +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> return location for a #GError, or %NULL +</parameter_description> +</parameter> +</parameters> +<return> 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.) + +</return> +</function> + +<function name="g_resolver_lookup_by_name_with_flags_async"> +<description> +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 + +</description> +<parameters> +<parameter name="resolver"> +<parameter_description> a #GResolver +</parameter_description> +</parameter> +<parameter name="hostname"> +<parameter_description> the hostname to look up the address of +</parameter_description> +</parameter> +<parameter name="flags"> +<parameter_description> extra #GResolverNameLookupFlags for the lookup +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> a #GCancellable, or %NULL +</parameter_description> +</parameter> +<parameter name="callback"> +<parameter_description> callback to call after resolution completes +</parameter_description> +</parameter> +<parameter name="user_data"> +<parameter_description> data for @callback +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_resolver_lookup_by_name_with_flags_finish"> +<description> +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 + +</description> +<parameters> +<parameter name="resolver"> +<parameter_description> a #GResolver +</parameter_description> +</parameter> +<parameter name="result"> +<parameter_description> the result passed to your #GAsyncReadyCallback +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> return location for a #GError, or %NULL +</parameter_description> +</parameter> +</parameters> +<return> a #GList +of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() +for more details. + +</return> +</function> + <function name="g_resolver_lookup_records"> <description> 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 </description> @@ -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 </description> @@ -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() <description> 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 </parameter_description> </parameter> <parameter name="parameter_type"> -<parameter_description> the type of parameter to the activate function +<parameter_description> the type of parameter that will be passed to +handlers for the #GSimpleAction::activate signal, or %NULL for no parameter </parameter_description> </parameter> </parameters> @@ -44347,10 +45101,10 @@ Since: 2.28 <description> 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 </parameter_description> </parameter> <parameter name="parameter_type"> -<parameter_description> the type of the parameter to the activate function +<parameter_description> the type of the parameter that will be passed to +handlers for the #GSimpleAction::activate signal, or %NULL for no parameter </parameter_description> </parameter> <parameter name="state"> @@ -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. + </description> <parameters> <parameter name="enumerator"> @@ -46633,21 +47390,21 @@ Since: 2.22 <function name="g_socket_condition_timed_wait"> <description> -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 <parameter_description> a #GIOCondition mask to wait for </parameter_description> </parameter> -<parameter name="timeout"> +<parameter name="timeout_us"> <parameter_description> the maximum time (in microseconds) to wait, or -1 </parameter_description> </parameter> @@ -48907,6 +49664,73 @@ on error </return> </function> +<function name="g_socket_send_message_with_timeout"> +<description> +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 + +</description> +<parameters> +<parameter name="socket"> +<parameter_description> a #GSocket +</parameter_description> +</parameter> +<parameter name="address"> +<parameter_description> a #GSocketAddress, or %NULL +</parameter_description> +</parameter> +<parameter name="vectors"> +<parameter_description> an array of #GOutputVector structs +</parameter_description> +</parameter> +<parameter name="num_vectors"> +<parameter_description> the number of elements in @vectors, or -1 +</parameter_description> +</parameter> +<parameter name="messages"> +<parameter_description> a pointer to an +array of #GSocketControlMessages, or %NULL. +</parameter_description> +</parameter> +<parameter name="num_messages"> +<parameter_description> number of elements in @messages, or -1. +</parameter_description> +</parameter> +<parameter name="flags"> +<parameter_description> an int containing #GSocketMsgFlags flags +</parameter_description> +</parameter> +<parameter name="timeout_us"> +<parameter_description> the maximum time (in microseconds) to wait, or -1 +</parameter_description> +</parameter> +<parameter name="bytes_written"> +<parameter_description> location to store the number of bytes that were written to the socket +</parameter_description> +</parameter> +<parameter name="cancellable"> +<parameter_description> a %GCancellable or %NULL +</parameter_description> +</parameter> +<parameter name="error"> +<parameter_description> #GError for error reporting, or %NULL to ignore. +</parameter_description> +</parameter> +</parameters> +<return> %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. + +</return> +</function> + <function name="g_socket_send_messages"> <description> 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. + </description> <parameters> <parameter name="subprocess"> @@ -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 </return> </function> +<function name="g_task_get_name"> +<description> +Gets @task’s name. See g_task_set_name(). + +Since: 2.60 + +</description> +<parameters> +<parameter name="task"> +<parameter_description> a #GTask +</parameter_description> +</parameter> +</parameters> +<return> @task’s name, or %NULL +</return> +</function> + <function name="g_task_get_priority"> <description> Gets @task's priority @@ -51736,6 +52583,34 @@ its #GCancellable for you. <return></return> </function> +<function name="g_task_set_name"> +<description> +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 + +</description> +<parameters> +<parameter name="task"> +<parameter_description> a #GTask +</parameter_description> +</parameter> +<parameter name="name"> +<parameter_description> a human readable name for the task, or %NULL to unset it +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_task_set_priority"> <description> Sets @task's priority. If you do not call this, it will default to @@ -52217,6 +53092,40 @@ Since: 2.18 <return></return> </function> +<function name="g_themed_icon_update_names"> +<description> +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" ] + + +</description> +<parameters> +<parameter name="themed"> +<parameter_description> a #GThemedIcon. +</parameter_description> +</parameter> +</parameters> +<return> a new #GThemedIcon +</return> +</function> + <function name="g_threaded_socket_service_new"> <description> Creates a new #GThreadedSocketService with no listeners. Listeners @@ -52383,6 +53292,33 @@ implementation. </return> </function> +<function name="g_tls_backend_set_default_database"> +<description> +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 + +</description> +<parameters> +<parameter name="backend"> +<parameter_description> the #GTlsBackend +</parameter_description> +</parameter> +<parameter name="database"> +<parameter_description> the #GTlsDatabase +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_tls_backend_supports_dtls"> <description> Checks if DTLS is supported. DTLS support may not be available even if TLS @@ -52823,14 +53759,19 @@ Since: 2.28 <function name="g_tls_client_connection_set_use_ssl3"> <description> -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 </return> </function> +<function name="g_tls_connection_get_negotiated_protocol"> +<description> +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 + +</description> +<parameters> +<parameter name="conn"> +<parameter_description> a #GTlsConnection +</parameter_description> +</parameter> +</parameters> +<return> the negotiated protocol, or %NULL + +</return> +</function> + <function name="g_tls_connection_get_peer_certificate"> <description> 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. + </description> <parameters> <parameter name="conn"> @@ -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. </return> </function> +<function name="g_tls_connection_set_advertised_protocols"> +<description> +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 + +</description> +<parameters> +<parameter name="conn"> +<parameter_description> a #GTlsConnection +</parameter_description> +</parameter> +<parameter name="protocols"> +<parameter_description> a %NULL-terminated +array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_tls_connection_set_certificate"> <description> This sets the certificate that @conn will present to its peer @@ -53257,7 +54263,8 @@ Since: 2.30 <function name="g_tls_connection_set_rehandshake_mode"> <description> -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. + </description> <parameters> <parameter name="conn"> @@ -53522,7 +54533,7 @@ Use g_object_unref() to release the certificate. <description> 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. </return> </function> +<function name="g_unix_mount_get_options"> +<description> +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 + +</description> +<parameters> +<parameter name="mount_entry"> +<parameter_description> a #GUnixMountEntry. +</parameter_description> +</parameter> +</parameters> +<return> a string containing the options, or %NULL if not +available. + +</return> +</function> + +<function name="g_unix_mount_get_root_path"> +<description> +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 + +</description> +<parameters> +<parameter name="mount_entry"> +<parameter_description> a #GUnixMountEntry. +</parameter_description> +</parameter> +</parameters> +<return> a string containing the root, or %NULL if not supported. + +</return> +</function> + <function name="g_unix_mount_guess_can_eject"> <description> Guesses whether a Unix mount can be ejected. @@ -56835,7 +57892,7 @@ information about volume identifiers. </parameter> </parameters> <return> 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 </return> </function> @@ -56928,7 +57985,8 @@ available. </parameter_description> </parameter> </parameters> -<return> the UUID for @volume or %NULL if no UUID can be computed. +<return> 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. </return> @@ -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. </return> </function> -<function name="gxdp_documents_call_add"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_o_path_fd"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_reuse_existing"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_persistent"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_add_finish"> -<description> -Finishes an operation started with gxdp_documents_call_add(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_doc_id"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_add_full"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_o_path_fds"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_flags"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_add_full_finish"> -<description> -Finishes an operation started with gxdp_documents_call_add_full(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_doc_ids"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_extra_out"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add_full(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_add_full_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_o_path_fds"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_flags"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="out_doc_ids"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_extra_out"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_add_named"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_o_path_parent_fd"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_filename"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_reuse_existing"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_persistent"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_add_named_finish"> -<description> -Finishes an operation started with gxdp_documents_call_add_named(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_doc_id"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add_named(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_add_named_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_o_path_parent_fd"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_filename"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_reuse_existing"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_persistent"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="out_doc_id"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_add_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_o_path_fd"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_reuse_existing"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_persistent"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="out_doc_id"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_delete"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_delete_finish"> -<description> -Finishes an operation started with gxdp_documents_call_delete(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_delete(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_delete_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_get_mount_point"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_get_mount_point_finish"> -<description> -Finishes an operation started with gxdp_documents_call_get_mount_point(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_path"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_get_mount_point(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_get_mount_point_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_path"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_grant_permissions"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_grant_permissions_finish"> -<description> -Finishes an operation started with gxdp_documents_call_grant_permissions(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_grant_permissions(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_grant_permissions_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_info"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_info_finish"> -<description> -Finishes an operation started with gxdp_documents_call_info(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_path"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_apps"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_info(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_info_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="out_path"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_apps"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_list"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_list_finish"> -<description> -Finishes an operation started with gxdp_documents_call_list(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_docs"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_list(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_list_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="out_docs"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_lookup"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_filename"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_lookup_finish"> -<description> -Finishes an operation started with gxdp_documents_call_lookup(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="out_doc_id"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_lookup(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_lookup_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_filename"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="out_doc_id"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_revoke_permissions"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_call_revoke_permissions_finish"> -<description> -Finishes an operation started with gxdp_documents_call_revoke_permissions(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_revoke_permissions(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_call_revoke_permissions_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpDocumentsProxy. -</parameter_description> -</parameter> -<parameter name="arg_doc_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_app_id"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_permissions"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_documents_complete_add"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="doc_id"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_add_full"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="doc_ids"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -<parameter name="extra_out"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_add_named"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="doc_id"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_delete"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_get_mount_point"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="path"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_grant_permissions"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_info"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="path"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -<parameter name="apps"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_list"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="docs"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_lookup"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="doc_id"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_complete_revoke_permissions"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_get_version"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -</parameters> -<return> The property value. -</return> -</function> - -<function name="gxdp_documents_interface_info"> -<description> -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. - - -</description> -<parameters> -</parameters> -<return> A #GDBusInterfaceInfo. Do not free. -</return> -</function> - -<function name="gxdp_documents_override_properties"> -<description> -Overrides all #GObject properties in the #GXdpDocuments interface for a concrete class. -The properties are overridden in the order they are defined. - - -</description> -<parameters> -<parameter name="klass"> -<parameter_description> The class structure for a #GObject<!-- -->-derived class. -</parameter_description> -</parameter> -<parameter name="property_id_begin"> -<parameter_description> The property id to assign to the first overridden property. -</parameter_description> -</parameter> -</parameters> -<return> The last property id. -</return> -</function> - -<function name="gxdp_documents_proxy_new"> -<description> -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. - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_proxy_new_finish"> -<description> -Finishes an operation started with gxdp_documents_proxy_new(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_proxy_new(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_documents_proxy_new_for_bus"> -<description> -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. - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_proxy_new_for_bus_finish"> -<description> -Finishes an operation started with gxdp_documents_proxy_new_for_bus(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_proxy_new_for_bus(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_documents_proxy_new_for_bus_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_documents_proxy_new_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_documents_set_version"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpDocuments. -</parameter_description> -</parameter> -<parameter name="value"> -<parameter_description> The value to set. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_documents_skeleton_new"> -<description> -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>. - - -</description> -<parameters> -</parameters> -<return> The skeleton object. -</return> -</function> - -<function name="gxdp_network_monitor_emit_changed"> -<description> -Emits the <link linkend="gdbus-signal-org-freedesktop-portal-NetworkMonitor.changed">"changed"</link> D-Bus signal. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -<parameter name="arg_available"> -<parameter_description> Argument to pass with the signal. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_network_monitor_get_available"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -</parameters> -<return> The property value. -</return> -</function> - -<function name="gxdp_network_monitor_get_connectivity"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -</parameters> -<return> The property value. -</return> -</function> - -<function name="gxdp_network_monitor_get_metered"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -</parameters> -<return> The property value. -</return> -</function> - -<function name="gxdp_network_monitor_interface_info"> -<description> -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. - - -</description> -<parameters> -</parameters> -<return> A #GDBusInterfaceInfo. Do not free. -</return> -</function> - -<function name="gxdp_network_monitor_override_properties"> -<description> -Overrides all #GObject properties in the #GXdpNetworkMonitor interface for a concrete class. -The properties are overridden in the order they are defined. - - -</description> -<parameters> -<parameter name="klass"> -<parameter_description> The class structure for a #GObject<!-- -->-derived class. -</parameter_description> -</parameter> -<parameter name="property_id_begin"> -<parameter_description> The property id to assign to the first overridden property. -</parameter_description> -</parameter> -</parameters> -<return> The last property id. -</return> -</function> - -<function name="gxdp_network_monitor_proxy_new"> -<description> -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. - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_network_monitor_proxy_new_finish"> -<description> -Finishes an operation started with gxdp_network_monitor_proxy_new(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_network_monitor_proxy_new(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_network_monitor_proxy_new_for_bus"> -<description> -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. - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_network_monitor_proxy_new_for_bus_finish"> -<description> -Finishes an operation started with gxdp_network_monitor_proxy_new_for_bus(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_network_monitor_proxy_new_for_bus(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_network_monitor_proxy_new_for_bus_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_network_monitor_proxy_new_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_network_monitor_set_available"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -<parameter name="value"> -<parameter_description> The value to set. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_network_monitor_set_connectivity"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -<parameter name="value"> -<parameter_description> The value to set. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_network_monitor_set_metered"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpNetworkMonitor. -</parameter_description> -</parameter> -<parameter name="value"> -<parameter_description> The value to set. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_network_monitor_skeleton_new"> -<description> -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>. - - -</description> -<parameters> -</parameters> -<return> The skeleton object. -</return> -</function> - -<function name="gxdp_open_uri_call_open_file"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpOpenURIProxy. -</parameter_description> -</parameter> -<parameter name="arg_parent_window"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_fd"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_options"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_call_open_file_finish"> -<description> -Finishes an operation started with gxdp_open_uri_call_open_file(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpOpenURIProxy. -</parameter_description> -</parameter> -<parameter name="out_handle"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_call_open_file(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_call_open_file_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpOpenURIProxy. -</parameter_description> -</parameter> -<parameter name="arg_parent_window"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_fd"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_options"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="out_handle"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="out_fd_list"> -<parameter_description> Return location for a #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_call_open_uri"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpOpenURIProxy. -</parameter_description> -</parameter> -<parameter name="arg_parent_window"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_uri"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_options"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_call_open_uri_finish"> -<description> -Finishes an operation started with gxdp_open_uri_call_open_uri(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpOpenURIProxy. -</parameter_description> -</parameter> -<parameter name="out_handle"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_call_open_uri(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_call_open_uri_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpOpenURIProxy. -</parameter_description> -</parameter> -<parameter name="arg_parent_window"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_uri"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="arg_options"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="out_handle"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_complete_open_file"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpOpenURI. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="fd_list"> -<parameter_description> A #GUnixFDList or %NULL. -</parameter_description> -</parameter> -<parameter name="handle"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_complete_open_uri"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpOpenURI. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="handle"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_get_version"> -<description> -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. - - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpOpenURI. -</parameter_description> -</parameter> -</parameters> -<return> The property value. -</return> -</function> - -<function name="gxdp_open_uri_interface_info"> -<description> -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. - - -</description> -<parameters> -</parameters> -<return> A #GDBusInterfaceInfo. Do not free. -</return> -</function> - -<function name="gxdp_open_uri_override_properties"> -<description> -Overrides all #GObject properties in the #GXdpOpenURI interface for a concrete class. -The properties are overridden in the order they are defined. - - -</description> -<parameters> -<parameter name="klass"> -<parameter_description> The class structure for a #GObject<!-- -->-derived class. -</parameter_description> -</parameter> -<parameter name="property_id_begin"> -<parameter_description> The property id to assign to the first overridden property. -</parameter_description> -</parameter> -</parameters> -<return> The last property id. -</return> -</function> - -<function name="gxdp_open_uri_proxy_new"> -<description> -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. - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_proxy_new_finish"> -<description> -Finishes an operation started with gxdp_open_uri_proxy_new(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_proxy_new(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_proxy_new_for_bus"> -<description> -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. - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_proxy_new_for_bus_finish"> -<description> -Finishes an operation started with gxdp_open_uri_proxy_new_for_bus(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_open_uri_proxy_new_for_bus(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_proxy_new_for_bus_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_proxy_new_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_open_uri_set_version"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpOpenURI. -</parameter_description> -</parameter> -<parameter name="value"> -<parameter_description> The value to set. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_open_uri_skeleton_new"> -<description> -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>. - - -</description> -<parameters> -</parameters> -<return> The skeleton object. -</return> -</function> - -<function name="gxdp_proxy_resolver_call_lookup"> -<description> -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. - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpProxyResolverProxy. -</parameter_description> -</parameter> -<parameter name="arg_uri"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_proxy_resolver_call_lookup_finish"> -<description> -Finishes an operation started with gxdp_proxy_resolver_call_lookup(). - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpProxyResolverProxy. -</parameter_description> -</parameter> -<parameter name="out_proxies"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_call_lookup(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_proxy_resolver_call_lookup_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="proxy"> -<parameter_description> A #GXdpProxyResolverProxy. -</parameter_description> -</parameter> -<parameter name="arg_uri"> -<parameter_description> Argument to pass with the method invocation. -</parameter_description> -</parameter> -<parameter name="out_proxies"> -<parameter_description> Return location for return parameter or %NULL to ignore. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL. -</parameter_description> -</parameter> -</parameters> -<return> %TRUE if the call succeded, %FALSE if @error is set. -</return> -</function> - -<function name="gxdp_proxy_resolver_complete_lookup"> -<description> -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. - -</description> -<parameters> -<parameter name="object"> -<parameter_description> A #GXdpProxyResolver. -</parameter_description> -</parameter> -<parameter name="invocation"> -<parameter_description> A #GDBusMethodInvocation. -</parameter_description> -</parameter> -<parameter name="proxies"> -<parameter_description> Parameter to return. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_proxy_resolver_interface_info"> -<description> -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. - - -</description> -<parameters> -</parameters> -<return> A #GDBusInterfaceInfo. Do not free. -</return> -</function> - -<function name="gxdp_proxy_resolver_override_properties"> -<description> -Overrides all #GObject properties in the #GXdpProxyResolver interface for a concrete class. -The properties are overridden in the order they are defined. - - -</description> -<parameters> -<parameter name="klass"> -<parameter_description> The class structure for a #GObject<!-- -->-derived class. -</parameter_description> -</parameter> -<parameter name="property_id_begin"> -<parameter_description> The property id to assign to the first overridden property. -</parameter_description> -</parameter> -</parameters> -<return> The last property id. -</return> -</function> - -<function name="gxdp_proxy_resolver_proxy_new"> -<description> -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. - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_proxy_resolver_proxy_new_finish"> -<description> -Finishes an operation started with gxdp_proxy_resolver_proxy_new(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_proxy_new(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_proxy_resolver_proxy_new_for_bus"> -<description> -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. - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="callback"> -<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied. -</parameter_description> -</parameter> -<parameter name="user_data"> -<parameter_description> User data to pass to @callback. -</parameter_description> -</parameter> -</parameters> -<return></return> -</function> - -<function name="gxdp_proxy_resolver_proxy_new_for_bus_finish"> -<description> -Finishes an operation started with gxdp_proxy_resolver_proxy_new_for_bus(). - - -</description> -<parameters> -<parameter name="res"> -<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_proxy_new_for_bus(). -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_proxy_resolver_proxy_new_for_bus_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="bus_type"> -<parameter_description> A #GBusType. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique). -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_proxy_resolver_proxy_new_sync"> -<description> -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. - - -</description> -<parameters> -<parameter name="connection"> -<parameter_description> A #GDBusConnection. -</parameter_description> -</parameter> -<parameter name="flags"> -<parameter_description> Flags from the #GDBusProxyFlags enumeration. -</parameter_description> -</parameter> -<parameter name="name"> -<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. -</parameter_description> -</parameter> -<parameter name="object_path"> -<parameter_description> An object path. -</parameter_description> -</parameter> -<parameter name="cancellable"> -<parameter_description> A #GCancellable or %NULL. -</parameter_description> -</parameter> -<parameter name="error"> -<parameter_description> Return location for error or %NULL -</parameter_description> -</parameter> -</parameters> -<return> The constructed proxy object or %NULL if @error is set. -</return> -</function> - -<function name="gxdp_proxy_resolver_skeleton_new"> -<description> -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>. - - -</description> -<parameters> -</parameters> -<return> The skeleton object. -</return> -</function> - </root> |