[glibmm] Regenerate the docs.
- From: José Alburquerque <jaalburqu src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Regenerate the docs.
- Date: Tue, 17 Aug 2010 04:53:27 +0000 (UTC)
commit 2242670a81bb1d1f367086220513aedbc04af21e
Author: José Alburquerque <jaalburqu svn gnome org>
Date: Fri Aug 13 17:03:16 2010 -0400
Regenerate the docs.
* gio/src/gio_docs.xml:
* glib/src/glib_docs.xml: Regenerate the docs so that documentation is
generated for methods that wrap newly added API.
ChangeLog | 8 +
gio/src/gio_docs.xml | 9769 ++++++++++++++++++++++++++++++++++++++++--------
glib/src/glib_docs.xml | 1877 ++++++++--
3 files changed, 9784 insertions(+), 1870 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index edf027f..cb35798 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2010-08-13 José Alburquerque <jaalburqu svn gnome org>
+
+ Regenerate the docs.
+
+ * gio/src/gio_docs.xml:
+ * glib/src/glib_docs.xml: Regenerate the docs so that documentation is
+ generated for methods that wrap newly added API.
+
2010-08-10 José Alburquerque <jaalburqu svn gnome org>
giomm: Use ifdef in _WRAP_METHOD()s surrounded by #ifdefs.
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 6cdca96..cd72d2d 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -68,35 +68,26 @@ Otherwise a cached result will be used if available
<return></return>
</function>
-<function name="g_output_stream_flush_async">
+<function name="g_memory_input_stream_add_data">
<description>
-Flushes a stream asynchronously.
-For behaviour details see g_output_stream_flush().
-
-When the operation is finished @callback will be
-called. You can then call g_output_stream_flush_finish() to get the
-result of the operation.
+Appends @data to data that can be read from the input stream
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request.
+<parameter_description> a #GMemoryInputStream
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="data">
+<parameter_description> input data
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="len">
+<parameter_description> length of the data, may be -1 if @data is a nul-terminated string
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="destroy">
+<parameter_description> function that is called to free @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -117,19 +108,32 @@ Clears the pending flag on @stream.
<return></return>
</function>
-<function name="g_file_attribute_info_list_ref">
+<function name="g_dbus_proxy_get_cached_property">
<description>
-References a file attribute info list.
+Looks up the value for a property from the cache. This call does no
+blocking IO.
+
+If @proxy has an expected interface (see
+#GDBusProxy:g-interface-info), then @property_name (for existence)
+is checked against it.
+Since: 2.26
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList to reference.
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> Property name.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileAttributeInfoList or %NULL on error.
+<return> A reference to the #GVariant instance that holds the value
+for @property_name or %NULL if the value is not in the cache. The
+returned reference must be freed with g_variant_unref().
+
</return>
</function>
@@ -201,27 +205,27 @@ Deprecated: 2.22: Use g_mount_eject_with_operation() instead.
<return></return>
</function>
-<function name="g_file_info_set_attribute_string">
+<function name="g_dbus_error_get_remote_error">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Gets the D-Bus error name used for @error, if any.
+
+This function is guaranteed to return a D-Bus error name for all
+#GError<!-- -->s returned from functions handling remote method
+calls (e.g. g_dbus_connection_call_finish()) unless
+g_dbus_error_strip_remote_error() has been used on @error.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-<parameter name="attr_value">
-<parameter_description> a string.
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> An allocated string or %NULL if the D-Bus error name could not be found. Free with g_free().
+
+</return>
</function>
<function name="g_io_extension_get_type">
@@ -240,6 +244,54 @@ Gets the type associated with @extension.
</return>
</function>
+<function name="g_settings_backend_keys_changed">
+<description>
+Signals that a list of keys have possibly changed. Backend
+implementations should call this if keys have possibly changed their
+values.
+
+ path must be a valid path (ie: starting and ending with a slash and
+not containing '//'). Each string in @items must form a valid key
+name when @path is prefixed to it (ie: each item must not start or
+end with '/' and must not contain '//').
+
+The meaning of this signal is that any of the key names resulting
+from the contatenation of @path with each item in @items may have
+changed.
+
+The same rules for when notifications must occur apply as per
+g_settings_backend_changed(). These two calls can be used
+interchangeably if exactly one item has changed (although in that
+case g_settings_backend_changed() is definitely preferred).
+
+For efficiency reasons, the implementation should strive for @path to
+be as long as possible (ie: the longest common prefix of all of the
+keys that were changed) but this is not strictly required.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path containing the changes
+</parameter_description>
+</parameter>
+<parameter name="items">
+<parameter_description> the %NULL-terminated list of changed keys
+</parameter_description>
+</parameter>
+<parameter name="origin_tag">
+<parameter_description> the origin tag
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_drive_is_media_check_automatic">
<description>
Checks if @drive is capabable of automatically detecting media changes.
@@ -257,36 +309,103 @@ media changes, %FALSE otherwise.
</return>
</function>
-<function name="g_volume_should_automount">
+<function name="g_dbus_proxy_set_default_timeout">
<description>
-Returns whether the volume should be automatically mounted.
+Sets the timeout to use if -1 (specifying default timeout) is
+passed as @timeout_msec in the g_dbus_proxy_call() and
+g_dbus_proxy_call_sync() functions.
+
+See the #GDBusProxy:g-default-timeout property for more details.
+Since: 2.26
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> Timeout in milliseconds.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the volume should be automatically mounted.
-</return>
+<return></return>
</function>
-<function name="g_cancellable_reset">
+<function name="g_async_initable_new_async">
<description>
-Resets @cancellable to its uncancelled state.
+Helper function for constructing #GAsyncInitiable object. This is
+similar to g_object_new() but also initializes the object asynchronously.
+
+When the initialization is finished, @callback will be called. You can
+then call g_async_initable_new_finish() to get the new object and check
+for any errors.
+
+Since: 2.22
</description>
<parameters>
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GAsyncInitable.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the operation.
+</parameter_description>
+</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable object.
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the initialization is
+finished
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of the first property, or %NULL if no
+properties
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the value of the first property, followed by other property
+value pairs, and ended by %NULL.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="g_dbus_interface_info_lookup_method">
+<description>
+Looks up information about a method.
+
+This cost of this function is O(n) in number of methods.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A D-Bus method name (typically in CamelCase)
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
+
+</return>
+</function>
+
<function name="g_socket_client_connect_to_service_async">
<description>
This is the asynchronous version of
@@ -324,19 +443,81 @@ Since: 2.22
<return></return>
</function>
-<function name="g_unix_mount_monitor_new">
+<function name="g_application_add_action">
<description>
-Gets a new #GUnixMountMonitor. The default rate limit for which the
-monitor will report consecutive changes for the mount and mount
-point entry files is the default for a #GFileMonitor. Use
-g_unix_mount_monitor_set_rate_limit() to change this.
+Adds an action @name to the list of exported actions of @application.
+
+It is an error to call this function if @application is a proxy for
+a remote application.
+
+You can invoke an action using g_application_invoke_action().
+
+The newly added action is enabled by default; you can call
+g_application_set_action_enabled() to disable it.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the action name
+</parameter_description>
+</parameter>
+<parameter name="description">
+<parameter_description> the action description; can be a translatable
+string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_message_set_header">
+<description>
+Sets a header field on @message.
+If @value is floating, @message assumes ownership of @value.
+
+Since: 2.26
</description>
<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="header_field">
+<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> A #GVariant to set the header field or %NULL to clear the header field.
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GUnixMountMonitor.
-</return>
+<return></return>
+</function>
+
+<function name="g_dbus_node_info_unref">
+<description>
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
<function name="g_app_info_delete">
@@ -423,6 +604,49 @@ Gets the file's size.
</return>
</function>
+<function name="g_dbus_annotation_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The same @info.
+
+</return>
+</function>
+
+<function name="g_dbus_interface_info_lookup_signal">
+<description>
+Looks up information about a signal.
+
+This cost of this function is O(n) in number of signals.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A D-Bus signal name (typically in CamelCase)
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
+
+</return>
+</function>
+
<function name="g_resolver_lookup_by_address_async">
<description>
Begins asynchronously reverse-resolving @address to determine its
@@ -457,6 +681,35 @@ Since: 2.22
<return></return>
</function>
+<function name="g_dbus_connection_flush_sync">
+<description>
+Synchronously flushes @connection. The calling thread is blocked
+until this is done. See g_dbus_connection_flush() for the
+asynchronous version of this method and more details about what it
+does.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</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 operation succeeded, %FALSE if @error is set.
+
+</return>
+</function>
+
<function name="g_socket_control_message_get_level">
<description>
Returns the "level" (i.e. the originating protocol) of the control message.
@@ -520,6 +773,29 @@ Sets the @attribute to contain the given value, if possible.
<return></return>
</function>
+<function name="g_application_remove_action">
+<description>
+Removes the action @name from the list of exported actions of @application.
+
+It is an error to call this function if @application is a proxy for
+a remote application.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the action to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_async_initable_new_finish">
<description>
Finishes the async construction for the various g_async_initable_new calls,
@@ -549,45 +825,48 @@ g_object_unref().
</return>
</function>
-<function name="g_zlib_compressor_new">
+<function name="g_dbus_node_info_lookup_interface">
<description>
-Creates a new #GZlibCompressor.
+Looks up information about an interface.
-Since: 2.24
+This cost of this function is O(n) in number of interfaces.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="format">
-<parameter_description> The format to use for the compressed data
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo.
</parameter_description>
</parameter>
-<parameter name="level">
-<parameter_description> compression level (0-9), -1 for default
+<parameter name="name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GZlibCompressor
+<return> A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.
</return>
</function>
<function name="g_file_make_symbolic_link">
<description>
-Creates a symbolic link.
+Creates a symbolic link named @file which contains the string
+ symlink_value
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.
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</description>
<parameters>
<parameter name="file">
-<parameter_description> input #GFile.
+<parameter_description> a #GFile with the name of the symlink to create
</parameter_description>
</parameter>
<parameter name="symlink_value">
-<parameter_description> a string with the value of the new symlink.
+<parameter_description> a string with the path for the target of the new symlink
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -595,7 +874,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
@@ -742,6 +1021,24 @@ Sets the mount operation's domain.
<return></return>
</function>
+<function name="g_dbus_annotation_info_unref">
+<description>
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusAnnotationInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_set_sort_order">
<description>
Sets the sort order attribute in the file info structure. See
@@ -863,6 +1160,44 @@ Since: 2.22
</return>
</function>
+<function name="g_bus_watch_name_with_closures">
+<description>
+Version of g_bus_watch_name() using closures instead of callbacks for
+easier binding in other languages.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> The type of bus to watch a name on.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to not exist or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
+
+</return>
+</function>
+
<function name="g_unix_mount_point_is_loopback">
<description>
Checks if a unix mount point is a loopback device.
@@ -879,6 +1214,29 @@ Checks if a unix mount point is a loopback device.
</return>
</function>
+<function name="g_dbus_connection_set_exit_on_close">
+<description>
+Sets whether the process should be terminated when @connection is
+closed by the remote peer. See #GDBusConnection:exit-on-close for
+more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="exit_on_close">
+<parameter_description> Whether the process should be terminated
+when @connection is closed by the remote peer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mount_operation_get_password">
<description>
Gets a password from the mount operation.
@@ -914,6 +1272,45 @@ g_object_ref()'d if it will be stored
</return>
</function>
+<function name="g_permission_acquire">
+<description>
+Attempts to acquire the permission represented by @permission.
+
+The precise method by which this happens depends on the permission
+and the underlying authentication mechanism. A simple example is
+that a dialog may appear asking the user to enter their password.
+
+You should check with g_permission_get_can_acquire() before calling
+this function.
+
+If the permission is acquired then %TRUE is returned. Otherwise,
+%FALSE is returned and @error is set appropriately.
+
+This call is blocking, likely for a very long time (in the case that
+user interaction is required). See g_permission_acquire_async() for
+the non-blocking version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully acquired
+</return>
+</function>
+
<function name="g_file_enumerator_next_files_async">
<description>
Request information for a number of files from the enumerator asynchronously.
@@ -1011,6 +1408,27 @@ of the request.
<return></return>
</function>
+<function name="g_unix_mount_compare">
+<description>
+Compares two unix mounts.
+
+
+</description>
+<parameters>
+<parameter name="mount1">
+<parameter_description> first #GUnixMountEntry to compare.
+</parameter_description>
+</parameter>
+<parameter name="mount2">
+<parameter_description> second #GUnixMountEntry to compare.
+</parameter_description>
+</parameter>
+</parameters>
+<return> 1, 0 or -1 if @mount1 is greater than, equal to,
+or less than @mount2, respectively.
+</return>
+</function>
+
<function name="g_mount_operation_get_username">
<description>
Get the user name from the mount operation.
@@ -1027,45 +1445,23 @@ Get the user name from the mount operation.
</return>
</function>
-<function name="g_file_output_stream_query_info_async">
+<function name="g_volume_monitor_get_connected_drives">
<description>
-Asynchronously queries the @stream for a #GFileInfo. When completed,
- callback will be called with a #GAsyncResult which can be used to
-finish the operation with g_file_output_stream_query_info_finish().
+Gets a list of drives connected to the system.
-For the synchronous version of this function, see
-g_file_output_stream_query_info().
+The returned list should be freed with g_list_free(), after
+its elements have been unreffed with g_object_unref().
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="gio-GIOScheduler">I/O priority</link>
-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 name="volume_monitor">
+<parameter_description> a #GVolumeMonitor.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GList of connected #GDrive objects.
+</return>
</function>
<function name="g_file_info_set_file_type">
@@ -1092,7 +1488,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_TYPE.
Reads a 16-bit/2-byte value from @stream.
In order to get the correct byte order for this read operation,
-see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
</description>
@@ -1115,18 +1511,47 @@ an error occurred.
</return>
</function>
-<function name="g_file_attribute_info_list_new">
+<function name="g_win32_output_stream_get_handle">
<description>
-Creates a new file attribute info list.
+Return the Windows handle that the stream writes to.
+Since: 2.26
</description>
<parameters>
+<parameter name="stream">
+<parameter_description> a #GWin32OutputStream
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GFileAttributeInfoList.
+<return> The handle descriptor of @stream
+
</return>
</function>
+<function name="g_file_info_set_attribute_string">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_async_result_get_user_data">
<description>
Gets the user data from a #GAsyncResult.
@@ -1161,6 +1586,54 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_interface_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The same @info.
+
+</return>
+</function>
+
+<function name="g_credentials_set_native">
+<description>
+Copies the native credentials of type @native_type from @native
+into @credentials.
+
+It is a programming error (which will cause an warning to be
+logged) to use this method if there is no #GCredentials support for
+the OS or if @native_type isn't supported by the OS.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="native_type">
+<parameter_description> The type of native credentials to set.
+</parameter_description>
+</parameter>
+<parameter name="native">
+<parameter_description> A pointer to native credentials.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_poll_mountable">
<description>
Polls a file of type G_FILE_TYPE_MOUNTABLE.
@@ -1196,6 +1669,69 @@ Since: 2.22
<return></return>
</function>
+<function name="g_dbus_connection_remove_filter">
+<description>
+Removes a filter.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
+</parameter_description>
+</parameter>
+<parameter name="filter_id">
+<parameter_description> an identifier obtained from g_dbus_connection_add_filter()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_connection_flush">
+<description>
+Asynchronously flushes @connection, that is, writes all queued
+outgoing message to the transport and then flushes the transport
+(using g_output_stream_flush_async()). This is useful in programs
+that wants to emit a D-Bus signal and then exit
+immediately. Without flushing the connection, there is no guarantee
+that the message has been sent to the networking buffers in the OS
+kernel.
+
+This is an asynchronous method. 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 g_dbus_connection_flush_finish() to get the result of the
+operation. See g_dbus_connection_flush_sync() for the synchronous
+version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</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 if you don't
+care about the result.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_check_connect_result">
<description>
Checks and resets the pending connect error for the socket.
@@ -1289,6 +1825,28 @@ done with it. (You can use g_resolver_free_addresses() to do this.)
</return>
</function>
+<function name="g_dbus_connection_unregister_object">
+<description>
+Unregisters an object.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="registration_id">
+<parameter_description> A registration id obtained from g_dbus_connection_register_object().
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the object was unregistered, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_socket_listener_accept_async">
<description>
This is the asynchronous version of g_socket_listener_accept().
@@ -1321,6 +1879,77 @@ Since: 2.22
<return></return>
</function>
+<function name="g_bus_watch_name">
+<description>
+Starts watching @name on the bus specified by @bus_type and calls
+ name_appeared_handler and @name_vanished_handler when the name is
+known to have a owner respectively known to lose its
+owner. Callbacks 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 function from.
+
+You are guaranteed that one of the handlers will be invoked after
+calling this function. When you are done watching the name, just
+call g_bus_unwatch_name() with the watcher id this function
+returns.
+
+If the name vanishes or appears (for example the application owning
+the name could restart), the handlers are also invoked. If the
+#GDBusConnection that is used for watching the name disconnects, then
+ name_vanished_handler is invoked since it is no longer
+possible to access the name.
+
+Another guarantee is that invocations of @name_appeared_handler
+and @name_vanished_handler are guaranteed to alternate; that
+is, if @name_appeared_handler is invoked then you are
+guaranteed that the next time one of the handlers is invoked, it
+will be @name_vanished_handler. The reverse is also true.
+
+This behavior makes it very simple to write applications that wants
+to take action when a certain name exists, see <xref
+linkend="gdbus-watching-names"/>. Basically, the application
+should create object proxies in @name_appeared_handler and destroy
+them again (if any) in @name_vanished_handler.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> The type of bus to watch a name on.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_handler">
+<parameter_description> Handler to invoke when @name is known to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_handler">
+<parameter_description> Handler to invoke when @name is known to not exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
+
+</return>
+</function>
+
<function name="g_file_info_clear_status">
<description>
Clears the status information from @info.
@@ -1411,34 +2040,20 @@ Deprecated: 2.22: Use g_file_eject_mountable_with_operation() instead.
<return></return>
</function>
-<function name="g_resolver_lookup_by_name_finish">
+<function name="g_dbus_message_get_member">
<description>
-Retrieves the result of a call to
-g_resolver_lookup_by_name_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.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
-Since: 2.22
+Since: 2.26
</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 name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GInetAddress, or %NULL on error. See
-g_resolver_lookup_by_name() for more details.
+<return> The value.
</return>
</function>
@@ -1468,6 +2083,58 @@ ignore.
</return>
</function>
+<function name="g_dbus_connection_close">
+<description>
+Closes @connection. Note that this never causes the process to
+exit (this might only happen if the other end of a shared message
+bus connection disconnects, see #GDBusConnection:exit-on-close).
+
+Once the connection is closed, operations such as sending a message
+will return with the error %G_IO_ERROR_CLOSED. Closing a connection
+will not automatically flush the connection so queued messages may
+be lost. Use g_dbus_connection_flush() if you need such guarantees.
+
+If @connection is already closed, this method fails with
+%G_IO_ERROR_CLOSED.
+
+When @connection has been closed, the #GDBusConnection::closed
+signal is emitted in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread that @connection was constructed in.
+
+This is an asynchronous method. 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 g_dbus_connection_close_finish() to get the result of the
+operation. See g_dbus_connection_close_sync() for the synchronous
+version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</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 if you don't
+care about the result.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_get_is_backup">
<description>
Checks if a file is a backup file.
@@ -1484,29 +2151,118 @@ Checks if a file is a backup file.
</return>
</function>
-<function name="g_settings_new_with_context_and_path">
+<function name="g_credentials_new">
<description>
-Creates a new #GSettings object with a given schema, context and
-path.
+Creates a new #GCredentials object with credentials matching the
+the current process.
-This is a mix of g_settings_new_with_context() and
-g_settings_new_with_path().
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> A #GCredentials. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_dbus_connection_call">
+<description>
+Asynchronously invokes the @method_name method on the
+ interface_name D-Bus interface on the remote object at
+ object_path owned by @bus_name.
+
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
+fail with %G_IO_ERROR_CANCELLED. If @parameters contains a value
+not compatible with the D-Bus protocol, the operation fails with
+%G_IO_ERROR_INVALID_ARGUMENT.
+
+If @reply_type is non-%NULL then the reply will be checked for having this type and an
+error will be raised if it does not match. Said another way, if you give a @reply_type
+then any non-%NULL return value will be of this type.
+
+If the @parameters #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_connection_call (connection,
+"org.freedesktop.StringThings",
+"/org/freedesktop/StringThings",
+"org.freedesktop.StringThings",
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+NULL,
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+(GAsyncReadyCallback) two_strings_done,
+NULL);
+]|
+
+This is an asynchronous method. 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
+g_dbus_connection_call_finish() to get the result of the operation.
+See g_dbus_connection_call_sync() for the synchronous version of this
+function.
Since: 2.26
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path to use
+<parameter name="bus_name">
+<parameter_description> A unique or well-known bus name or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to invoke method on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the method or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="reply_type">
+<parameter_description> The expected type of the reply, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds or -1 to use the default timeout.
+</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 if you don't
+care about the result of the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
-</return>
+<return></return>
</function>
<function name="g_unix_fd_message_get_fd_list">
@@ -1601,6 +2357,55 @@ This is different from the file's content type, see g_file_info_get_content_type
</return>
</function>
+<function name="g_dbus_node_info_generate_xml">
+<description>
+Appends an XML representation of @info (and its children) to @string_builder.
+
+This function is typically used for generating introspection XML documents at run-time for
+handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo.
+</parameter_description>
+</parameter>
+<parameter name="indent">
+<parameter_description> Indentation level.
+</parameter_description>
+</parameter>
+<parameter name="string_builder">
+<parameter_description> A #GString to to append XML data to.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_proxy_new_for_bus_finish">
+<description>
+Finishes creating a #GDBusProxy.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_file_info_dup">
<description>
Duplicates a file info structure.
@@ -1635,20 +2440,20 @@ Checks if a file is a symlink.
<function name="g_unix_mounts_get">
<description>
-Gets a #GList of strings containing the unix mounts.
-If @time_read is set, it will be filled with the mount
-timestamp, allowing for checking if the mounts have changed
+Gets a #GList of #GUnixMountEntry containing the unix mounts.
+If @time_read is set, it will be filled with the mount
+timestamp, allowing for checking if the mounts have changed
with g_unix_mounts_changed_since().
</description>
<parameters>
<parameter name="time_read">
-<parameter_description> guint64 to contain a timestamp.
+<parameter_description> guint64 to contain a timestamp, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of the UNIX mounts.
+<return> a #GList of the UNIX mounts.
</return>
</function>
@@ -1740,27 +2545,87 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_socket_set_blocking">
+<function name="g_simple_permission_new">
<description>
-Sets the blocking mode of the socket. In blocking mode
-all operations block until they succeed or there is an error. In
-non-blocking mode all functions return results immediately or
-with a %G_IO_ERROR_WOULD_BLOCK error.
+Creates a new #GPermission instance that represents an action that is
+either always or never allowed.
-All sockets are created in blocking mode. However, note that the
-platform level socket is always non-blocking, and blocking mode
-is a GSocket level feature.
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="allowed">
+<parameter_description> %TRUE if the action is allowed
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GSimplePermission, as a #GPermission
+</return>
+</function>
+
+<function name="g_dbus_message_new_method_error">
+<description>
+Creates a new #GDBusMessage that is an error reply to @method_call_message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
+</parameter_description>
+</parameter>
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="error_message_format">
+<parameter_description> The D-Bus error message in a printf() format.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> Arguments for @error_message_format.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_volume_eject_with_operation">
+<description>
+Ejects a volume. This is an asynchronous operation, and is
+finished by calling g_volume_eject_with_operation_finish() with the @volume
+and #GAsyncResult data returned in the @callback.
Since: 2.22
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="volume">
+<parameter_description> a #GVolume.
</parameter_description>
</parameter>
-<parameter name="blocking">
-<parameter_description> Whether to use blocking I/O or not.
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for eject
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
</parameter_description>
</parameter>
</parameters>
@@ -1844,6 +2709,38 @@ Since: 2.26
<return></return>
</function>
+<function name="g_settings_get_enum">
+<description>
+Gets the value that is stored in @settings for @key and converts it
+to the enum value that it represents.
+
+In order to use this function the type of the value must be a string
+and it must be marked in the schema file as an enumerated type.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as an enumerated type.
+
+If the value stored in the configuration database is not a valid
+value for the enumerated type then this function will return the
+default value.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> the enum value
+</return>
+</function>
+
<function name="g_data_output_stream_put_int16">
<description>
Puts a signed 16-bit integer into the output stream.
@@ -1912,6 +2809,21 @@ Since: 2.22
<return></return>
</function>
+<function name="g_unix_mount_monitor_new">
+<description>
+Gets a new #GUnixMountMonitor. The default rate limit for which the
+monitor will report consecutive changes for the mount and mount
+point entry files is the default for a #GFileMonitor. Use
+g_unix_mount_monitor_set_rate_limit() to change this.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GUnixMountMonitor.
+</return>
+</function>
+
<function name="g_settings_backend_changed_tree">
<description>
This call is a convenience wrapper. It gets the list of changes from
@@ -1976,6 +2888,68 @@ Since: 2.22
</return>
</function>
+<function name="g_bus_watch_name_on_connection">
+<description>
+Like g_bus_watch_name() but takes a #GDBusConnection instead of a
+#GBusType.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_handler">
+<parameter_description> Handler to invoke when @name is known to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_handler">
+<parameter_description> Handler to invoke when @name is known to not exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
+
+</return>
+</function>
+
+<function name="g_dbus_method_invocation_get_user_data">
+<description>
+Gets the @user_data #gpointer passed to g_dbus_connection_register_object().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #gpointer.
+
+</return>
+</function>
+
<function name="g_data_input_stream_get_newline_type">
<description>
Gets the current newline type for the @stream.
@@ -2008,20 +2982,23 @@ Guesses the icon of a Unix mount point.
</return>
</function>
-<function name="g_io_extension_point_get_required_type">
+<function name="g_credentials_to_string">
<description>
-Gets the required type for @extension_point.
+Creates a human-readable textual representation of @credentials
+that can be used in logging and debug messages. The format of the
+returned string may change in future GLib release.
+Since: 2.26
</description>
<parameters>
-<parameter name="extension_point">
-<parameter_description> a #GIOExtensionPoint
+<parameter name="credentials">
+<parameter_description> A #GCredentials object.
</parameter_description>
</parameter>
</parameters>
-<return> the #GType that all implementations must have,
-or #G_TYPE_INVALID if the extension point has no required type
+<return> A string that should be freed with g_free().
+
</return>
</function>
@@ -2032,9 +3009,9 @@ Gets the value that is stored at @key in @settings.
A convenience function that combines g_settings_get_value() with
g_variant_get().
-It is a programmer error to pass a @key that isn't valid for
- settings or a @format_string that doesn't match the type of @key according
-to the schema of @settings.
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or for the #GVariantType of @format to mismatch
+the type given in the schema.
Since: 2.26
@@ -2166,41 +3143,84 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_drive_can_start_degraded">
+<function name="g_application_new">
<description>
-Checks if a drive can be started degraded.
+Create a new #GApplication. This uses a platform-specific
+mechanism to ensure the current process is the unique owner of the
+application (as defined by the @appid). If successful, the
+#GApplication:is-remote property will be %FALSE, and it is safe to
+continue creating other resources such as graphics windows.
-Since: 2.22
+If the given @appid is already running in another process, the the
+GApplication::activate_with_data signal will be emitted in the
+remote process, with the data from @argv and other
+platform-specific data available. Subsequently the
+#GApplication:default-quit property will be evaluated. If it's
+%TRUE, then the current process will terminate. If %FALSE, then
+the application remains in the #GApplication:is-remote state, and
+you can e.g. call g_application_invoke_action(). Note that proxy
+instances should not call g_application_add_action().
+
+This function may do synchronous I/O to obtain unique ownership
+of the application id, and will block the calling thread in this
+case.
+
+If the environment does not support the basic functionality of
+#GApplication, this function will invoke g_error(), which by
+default is a fatal operation. This may arise for example on
+UNIX systems using D-Bus when the session bus is not available.
+
+As a convenience, this function is defined to call g_type_init() as
+its very first action.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="appid">
+<parameter_description> System-dependent application identifier
+</parameter_description>
+</parameter>
+<parameter name="argc">
+<parameter_description> Number of arguments in @argv
+</parameter_description>
+</parameter>
+<parameter name="argv">
+<parameter_description> Argument vector, usually from the <parameter>argv</parameter> parameter of main()
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @drive can be started degraded, %FALSE otherwise.
+<return> An application instance
</return>
</function>
-<function name="g_settings_revert">
+<function name="g_settings_new_with_path">
<description>
-Reverts all non-applied changes to the settings. This function
-does nothing unless @settings is in 'delay-apply' mode; see
-g_settings_set_delay_apply(). In the normal case settings are
-always applied immediately.
+Creates a new #GSettings object with a given schema and path.
-Change notifications will be emitted for affected keys.
+You only need to do this if you want to directly create a settings
+object with a schema that doesn't have a specified path of its own.
+That's quite rare.
+
+It is a programmer error to call this function for a schema that
+has an explicitly specified path.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings instance
+<parameter name="schema">
+<parameter_description> the name of the schema
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path to use
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #GSettings object
+</return>
</function>
<function name="g_file_info_set_edit_name">
@@ -2258,7 +3278,8 @@ is set.
<function name="g_app_launch_context_get_startup_notify_id">
<description>
Initiates startup notification for the application and returns the
-DESKTOP_STARTUP_ID for the launched operation, if supported.
+<envvar>DESKTOP_STARTUP_ID</envvar> for the launched operation,
+if supported.
Startup notification IDs are defined in the <ulink
url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">
@@ -2280,11 +3301,45 @@ FreeDesktop.Org Startup Notifications standard</ulink>.
</parameter_description>
</parameter>
</parameters>
-<return> a startup notification ID for the application, or %NULL if
+<return> a startup notification ID for the application, or %NULL if
not supported.
</return>
</function>
+<function name="g_dbus_error_set_dbus_error">
+<description>
+Does nothing if @error is %NULL. Otherwise sets * error to
+a new #GError created with g_dbus_error_new_for_dbus_error()
+with @dbus_error_message prepend with @format (unless %NULL).
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> A pointer to a #GError or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_name">
+<parameter_description> D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_message">
+<parameter_description> D-Bus error message.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format to prepend to @dbus_error_message or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> Arguments for @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_query_info_finish">
<description>
Finishes an asynchronous file info query.
@@ -2311,6 +3366,38 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_resolver_lookup_service_finish">
+<description>
+Retrieves the result of a previous call to
+g_resolver_lookup_service_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.22
+
+</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 #GSrvTarget, or %NULL on error. See
+g_resolver_lookup_service() for more details.
+
+</return>
+</function>
+
<function name="g_file_find_enclosing_mount_finish">
<description>
Finishes an asynchronous find mount request.
@@ -2358,37 +3445,33 @@ Since: 2.20
<return></return>
</function>
-<function name="g_file_enumerator_close_finish">
+<function name="g_application_quit_with_data">
<description>
-Finishes closing a file enumerator, started from g_file_enumerator_close_async().
+Request that the application quits.
-If the file enumerator was already closed when g_file_enumerator_close_async()
-was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
-return %FALSE. If the file enumerator had pending operation when the close
-operation was started, then this function will report %G_IO_ERROR_PENDING, and
-return %FALSE. If @cancellable was not %NULL, then the operation may have been
-cancelled by triggering the cancellable object from another thread. If the operation
-was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
-returned.
+This function has different behavior depending on whether @application
+is acting as a proxy for another process. In the normal case where
+the current process is hosting the application, the default
+implementation will quit the main loop created by g_application_run().
+If @application is a proxy, then the remote process will be asked
+to quit.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="platform_data">
+<parameter_description> platform-specific data
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the close operation has finished successfully.
+<return> %TRUE if the application accepted the request, %FALSE otherwise
+
</return>
</function>
@@ -2451,6 +3534,24 @@ Since: 2.22
</return>
</function>
+<function name="g_emblemed_icon_get_emblems">
+<description>
+Gets the list of emblems for the @icon.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblemed">
+<parameter_description> a #GEmblemedIcon
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GEmblem <!-- -->s that is owned by @emblemed
+
+</return>
+</function>
+
<function name="g_filter_input_stream_get_close_base_stream">
<description>
Returns whether the base stream will be closed when @stream is
@@ -2504,6 +3605,36 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_cancellable_reset">
+<description>
+Resets @cancellable to its uncancelled state.
+
+</description>
+<parameters>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_bus_unwatch_name">
+<description>
+Stops watching a name.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="watcher_id">
+<parameter_description> An identifier obtained from g_bus_watch_name()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_copy_async">
<description>
Copies the file @source to the location specified by @destination
@@ -2559,6 +3690,24 @@ of the request.
<return></return>
</function>
+<function name="g_dbus_method_invocation_get_interface_name">
+<description>
+Gets the name of the D-Bus interface the method was invoked on.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A string. Do not free, it is owned by @invocation.
+
+</return>
+</function>
+
<function name="g_memory_input_stream_new">
<description>
Creates a new empty #GMemoryInputStream.
@@ -2681,108 +3830,83 @@ return %FALSE and set @error appropriately if present.
</return>
</function>
-<function name="g_drive_enumerate_identifiers">
+<function name="g_io_stream_clear_pending">
<description>
-Gets the kinds of identifiers that @drive has.
-Use g_drive_get_identifer() to obtain the identifiers
-themselves.
+Clears the pending flag on @stream.
+Since: 2.22
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive
+<parameter name="stream">
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
</parameters>
-<return> a %NULL-terminated array of strings containing
-kinds of identifiers. Use g_strfreev() to free.
-</return>
+<return></return>
</function>
-<function name="g_volume_monitor_get_volumes">
+<function name="g_drive_enumerate_identifiers">
<description>
-Gets a list of the volumes on the system.
-
-The returned list should be freed with g_list_free(), after
-its elements have been unreffed with g_object_unref().
+Gets the kinds of identifiers that @drive has.
+Use g_drive_get_identifer() to obtain the identifiers
+themselves.
</description>
<parameters>
-<parameter name="volume_monitor">
-<parameter_description> a #GVolumeMonitor.
+<parameter name="drive">
+<parameter_description> a #GDrive
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GVolume objects.
+<return> a %NULL-terminated array of strings containing
+kinds of identifiers. Use g_strfreev() to free.
</return>
</function>
-<function name="g_io_extension_ref_class">
+<function name="g_dbus_method_invocation_get_method_name">
<description>
-Gets a reference to the class for the type that is
-associated with @extension.
+Gets the name of the method that was invoked.
+Since: 2.26
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the #GTypeClass for the type of @extension
+<return> A string. Do not free, it is owned by @invocation.
+
</return>
</function>
-<function name="g_settings_bind_writable">
+<function name="g_dbus_message_new_signal">
<description>
-Create a binding between the writability of @key in the
- settings object and the property @property of @object.
-The property must be boolean; "sensitive" or "visible"
-properties of widgets are the most likely candidates.
-
-Writable bindings are always uni-directional; changes of the
-writability of the setting will be propagated to the object
-property, not the other way.
-
-When the @inverted argument is %TRUE, the binding inverts the
-value as it passes from the setting to the object, i.e. @property
-will be set to %TRUE if the key is <emphasis>not</emphasis>
-writable.
-
-Note that the lifecycle of the binding is tied to the object,
-and that you can have only one binding per object property.
-If you bind the same property twice on the same object, the second
-binding overrides the first one.
+Creates a new #GDBusMessage for a signal emission.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the key to bind
-</parameter_description>
-</parameter>
-<parameter name="object">
-<parameter_description> a #GObject
+<parameter name="path">
+<parameter_description> A valid object path.
</parameter_description>
</parameter>
-<parameter name="property">
-<parameter_description> the name of a boolean property to bind
+<parameter name="interface_">
+<parameter_description> A valid D-Bus interface name.
</parameter_description>
</parameter>
-<parameter name="inverted">
-<parameter_description> whether to 'invert' the value
+<parameter name="signal">
+<parameter_description> A valid signal name.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
</function>
<function name="g_memory_input_stream_new_from_data">
@@ -2827,9 +3951,11 @@ Since: 2.18
</return>
</function>
-<function name="g_file_info_get_is_hidden">
+<function name="g_file_info_get_attribute_uint32">
<description>
-Checks if a file is hidden.
+Gets an unsigned 32-bit integer contained within the attribute. If the
+attribute does not contain an unsigned 32-bit integer, or is invalid,
+0 will be returned.
</description>
@@ -2838,11 +3964,48 @@ Checks if a file is hidden.
<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
</parameters>
-<return> %TRUE if the file is a hidden file, %FALSE otherwise.
+<return> an unsigned 32-bit integer from the attribute.
+</return>
+</function>
+
+<function name="g_content_type_get_mime_type">
+<description>
+Gets the mime type for the content type, if one is registered.
+
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> a content type string
+</parameter_description>
+</parameter>
+</parameters>
+<return> the registered mime type for the given @type,
+or %NULL if unknown.
</return>
</function>
+<function name="g_dbus_server_start">
+<description>
+Starts @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_connection_get_socket">
<description>
Gets the underlying #GSocket object of the connection.
@@ -2895,14 +4058,106 @@ Checks if an input stream is closed.
</return>
</function>
+<function name="g_dbus_connection_close_sync">
+<description>
+Synchronously closees @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.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</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 operation succeeded, %FALSE if @error is set.
+
+</return>
+</function>
+
+<function name="g_credentials_get_native">
+<description>
+Gets a pointer to native credentials of type @native_type from
+ credentials
+
+It is a programming error (which will cause an warning to be
+logged) to use this method if there is no #GCredentials support for
+the OS or if @native_type isn't supported by the OS.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="native_type">
+<parameter_description> The type of native credentials to get.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The pointer to native credentials or %NULL if the
+operation there is no #GCredentials support for the OS or if
+ native_type isn't supported by the OS. Do not free the returned
+data, it is owned by @credentials.
+
+</return>
+</function>
+
+<function name="g_settings_set_flags">
+<description>
+Looks up the flags type nicks for the bits specified by @value, puts
+them in an array of strings and writes the array to @key, withing
+ settings
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as a flags type, or for @value
+to contain any bits that are not value for the named type.
+
+After performing the write, accessing @key directly with
+g_settings_get_strv() will return an array of 'nicks'; one for each
+bit in @value.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a key, within @settings
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a flags value
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if the set succeeds
+</return>
+</function>
+
<function name="g_settings_get_double">
<description>
Gets the value that is stored at @key in @settings.
A convenience variant of g_settings_get() for doubles.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type double.
+It is a programmer error to give a @key that isn't specified as
+having a 'double' type in the schema for @settings.
Since: 2.26
@@ -2962,7 +4217,7 @@ Checks if two #GAppInfo<!-- -->s are equal.
</description>
<parameters>
<parameter name="appinfo1">
-<parameter_description> the first #GAppInfo.
+<parameter_description> the first #GAppInfo.
</parameter_description>
</parameter>
<parameter name="appinfo2">
@@ -3065,19 +4320,25 @@ array can be gotten with g_inet_address_get_native_size().
</return>
</function>
-<function name="g_file_attribute_info_list_unref">
+<function name="g_cancellable_set_error_if_cancelled">
<description>
-Removes a reference from the given @list. If the reference count
-falls to zero, the @list is deleted.
+If the @cancellable is cancelled, sets the error to notify
+that the operation was cancelled.
+
</description>
<parameters>
-<parameter name="list">
-<parameter_description> The #GFileAttributeInfoList to unreference.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError to append error state to.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @cancellable was cancelled, %FALSE if it was not.
+</return>
</function>
<function name="g_file_get_path">
@@ -3140,37 +4401,50 @@ of the request.
<return></return>
</function>
-<function name="g_file_input_stream_query_info">
+<function name="g_settings_list_items">
<description>
-Queries a file input stream the given @attributes. This function blocks
-while querying the stream. For the asynchronous (non-blocking) version
-of this function, see g_file_input_stream_query_info_async(). While the
-stream is blocked, the stream will set the pending flag internally, and
-any other operations on the stream will fail with %G_IO_ERROR_PENDING.
+Introspects the list of keys and children on @settings.
+
+The list that is returned is a mix of the keys and children. The
+names of the children are suffixed with '/'. The names of the keys
+are not.
+You should probably not be calling this function from "normal" code
+(since you should already know what keys are in your schema). This
+function is intended for introspection reasons.
+
+You should free the return value with g_free() when you are done with
+it.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileInputStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
+<parameter name="settings">
+<parameter_description> a #GSettings object
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameters>
+<return> a list of the keys on @settings
+</return>
+</function>
+
+<function name="g_dbus_message_set_signature">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInfo, or %NULL on error.
-</return>
+<return></return>
</function>
<function name="g_volume_can_mount">
@@ -3189,6 +4463,31 @@ Checks if a volume can be mounted.
</return>
</function>
+<function name="g_application_get_action_description">
+<description>
+Gets the description of the action @name.
+
+It is an error to call this function if @application is a proxy for
+a remote application.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> Action name
+</parameter_description>
+</parameter>
+</parameters>
+<return> Description for the given action named @name
+
+</return>
+</function>
+
<function name="g_simple_async_result_get_source_tag">
<description>
Gets the source tag for the #GSimpleAsyncResult.
@@ -3360,11 +4659,11 @@ the stream or filling the buffer.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> a #gsize to get the number of bytes available in the buffer.
+<parameter_description> a #gsize to get the number of bytes available in the buffer
</parameter_description>
</parameter>
</parameters>
@@ -3398,26 +4697,6 @@ appropriately if present.
</return>
</function>
-<function name="g_threaded_socket_service_new">
-<description>
-Creates a new #GThreadedSocketService with no listeners. Listeners
-must be added with g_socket_service_add_listeners().
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="max_threads">
-<parameter_description> the maximal number of threads to execute concurrently
-handling incoming clients, -1 means no limit
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GSocketService.
-
-</return>
-</function>
-
<function name="g_input_stream_set_pending">
<description>
Sets @stream to have actions pending. If the pending flag is
@@ -3491,8 +4770,8 @@ of the request.
<description>
Applies any changes that have been made to the settings. This
function does nothing unless @settings is in 'delay-apply' mode;
-see g_settings_set_delay_apply(). In the normal case settings are
-always applied immediately.
+see g_settings_delay(). In the normal case settings are always
+applied immediately.
</description>
<parameters>
@@ -3504,57 +4783,81 @@ always applied immediately.
<return></return>
</function>
-<function name="g_socket_address_enumerator_next">
+<function name="g_file_query_file_type">
<description>
-Retrieves the next #GSocketAddress from @enumerator. Note that this
-may block for some amount of time. (Eg, a #GNetworkAddress may need
-to do a DNS lookup before it can return an address.) Use
-g_socket_address_enumerator_next_async() if you need to avoid
-blocking.
+Utility function to inspect the #GFileType of a file. This is
+implemented using g_file_query_info() and as such does blocking I/O.
-If @enumerator is expected to yield addresses, but for some reason
-is unable to (eg, because of a DNS error), then the first call to
-g_socket_address_enumerator_next() will return an appropriate error
-in * error However, if the first call to
-g_socket_address_enumerator_next() succeeds, then any further
-internal errors (other than @cancellable being triggered) will be
-ignored.
+The primary use case of this method is to check if a file is a regular file,
+directory, or symlink.
+Since: 2.18
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GSocketAddressEnumerator
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags passed to g_file_query_info().
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress (owned by the caller), or %NULL on
-error (in which case * error will be set) or if there are no
-more addresses.
+<return> The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file
+does not exist
+
</return>
</function>
-<function name="g_file_monitor_cancel">
+<function name="g_dbus_error_new_for_dbus_error">
<description>
-Cancels a file monitor.
+Creates a #GError based on the contents of @dbus_error_name and
+ dbus_error_message
+
+Errors registered with g_dbus_error_register_error() will be looked
+up using @dbus_error_name and if a match is found, the error domain
+and code is used. Applications can use g_dbus_error_get_remote_error()
+to recover @dbus_error_name.
+If a match against a registered error is not found and the D-Bus
+error name is in a form as returned by g_dbus_error_encode_gerror()
+the error domain and code encoded in the name is used to
+create the #GError. Also, @dbus_error_name is added to the error message
+such that it can be recovered with g_dbus_error_get_remote_error().
+
+Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
+in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is
+added to the error message such that it can be recovered with
+g_dbus_error_get_remote_error().
+
+In all three cases, @dbus_error_name can always be recovered from the
+returned #GError using the g_dbus_error_get_remote_error() function
+(unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).
+
+This function is typically only used in object mappings to prepare
+#GError instances for applications. Regular applications should not use
+it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="monitor">
-<parameter_description> a #GFileMonitor.
+<parameter name="dbus_error_name">
+<parameter_description> D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_message">
+<parameter_description> D-Bus error message.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if monitor was cancelled.
+<return> An allocated #GError. Free with g_error_free().
+
</return>
</function>
@@ -3592,6 +4895,47 @@ g_object_unref() when no longer needed.
</return>
</function>
+<function name="g_dbus_proxy_get_cached_property_names">
+<description>
+Gets the names of all cached properties on @proxy.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A %NULL-terminated array of strings or %NULL if @proxy has
+no cached properties. Free the returned array with g_strfreev().
+
+</return>
+</function>
+
+<function name="g_dbus_connection_get_unique_name">
+<description>
+Gets the unique name of @connection as assigned by the message
+bus. This can also be used to figure out if @connection is a
+message bus connection.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The unique name or %NULL if @connection is not a message
+bus connection. Do not free this string, it is owned by
+ connection
+
+</return>
+</function>
+
<function name="g_cancellable_make_pollfd">
<description>
Creates a #GPollFD corresponding to @cancellable; this can be passed
@@ -3671,28 +5015,21 @@ when the stream is closed.
</return>
</function>
-<function name="g_file_input_stream_query_info_finish">
+<function name="g_dbus_message_get_body">
<description>
-Finishes an asynchronous info query operation.
+Gets the body of a message.
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring,
-or %NULL to ignore.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInfo.
+<return> A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message.
+
</return>
</function>
@@ -3806,26 +5143,46 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
-<function name="g_socket_listener_set_backlog">
+<function name="g_io_extension_ref_class">
<description>
-Sets the listen backlog on the sockets in the listener.
+Gets a reference to the class for the type that is
+associated with @extension.
-See g_socket_set_listen_backlog() for details
-Since: 2.22
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GTypeClass for the type of @extension
+</return>
+</function>
+
+<function name="g_file_input_stream_query_info_finish">
+<description>
+Finishes an asynchronous info query operation.
+
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
</parameter_description>
</parameter>
-<parameter name="listen_backlog">
-<parameter_description> an integer
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring,
+or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> #GFileInfo.
+</return>
</function>
<function name="g_seekable_seek">
@@ -3922,48 +5279,102 @@ Since: 2.22
</return>
</function>
-<function name="g_resolver_lookup_service_async">
+<function name="g_dbus_server_stop">
<description>
-Begins asynchronously performing a DNS SRV lookup for the given
- service and @protocol in the given @domain, and eventually calls
- callback, which must call g_resolver_lookup_service_finish() to
-get the final result. See g_resolver_lookup_service() for more
-details.
+Stops @server.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
+<parameter name="server">
+<parameter_description> A #GDBusServer.
</parameter_description>
</parameter>
-<parameter name="service">
-<parameter_description> the service type to look up (eg, "ldap")
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> the networking protocol to use for @service (eg, "tcp")
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_message_print">
+<description>
+Produces a human-readable multi-line description of @message.
+
+The contents of the description has no ABI guarantees, the contents
+and formatting is subject to change at any time. Typical output
+looks something like this:
+<programlisting>
+Type: method-call
+Flags: none
+Version: 0
+Serial: 4
+Headers:
+path -> objectpath '/org/gtk/GDBus/TestObject'
+interface -> 'org.gtk.GDBus.TestInterface'
+member -> 'GimmeStdout'
+destination -> ':1.146'
+Body: ()
+UNIX File Descriptors:
+(none)
+</programlisting>
+or
+<programlisting>
+Type: method-return
+Flags: no-reply-expected
+Version: 0
+Serial: 477
+Headers:
+reply-serial -> uint32 4
+destination -> ':1.159'
+sender -> ':1.146'
+num-unix-fds -> uint32 1
+Body: ()
+UNIX File Descriptors:
+fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
+</programlisting>
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="domain">
-<parameter_description> the DNS domain to look up the service in
+<parameter name="indent">
+<parameter_description> Indentation level.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+</parameters>
+<return> A string that should be freed with g_free().
+
+</return>
+</function>
+
+<function name="g_dbus_proxy_call_finish">
+<description>
+Finishes an operation started with g_dbus_proxy_call().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call().
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
+
+</return>
</function>
<function name="g_volume_eject_with_operation_finish">
@@ -4067,6 +5478,27 @@ Checks if a drive can be polled for media changes.
</return>
</function>
+<function name="g_win32_output_stream_set_close_handle">
+<description>
+Sets whether the handle of @stream shall be closed when the stream
+is closed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GWin32OutputStream
+</parameter_description>
+</parameter>
+<parameter name="close_handle">
+<parameter_description> %TRUE to close the handle when done
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_output_stream_write_finish">
<description>
Finishes a stream write operation.
@@ -4174,19 +5606,69 @@ g_socket_address_get_native_size().
</return>
</function>
-<function name="g_volume_can_eject">
+<function name="g_dbus_error_register_error_domain">
<description>
-Checks if a volume can be ejected.
+Helper function for associating a #GError error domain with D-Bus error names.
+Since: 2.26
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume.
+<parameter name="error_domain_quark_name">
+<parameter_description> The error domain name.
+</parameter_description>
+</parameter>
+<parameter name="quark_volatile">
+<parameter_description> A pointer where to store the #GQuark.
+</parameter_description>
+</parameter>
+<parameter name="entries">
+<parameter_description> A pointer to @num_entries #GDBusErrorEntry struct items.
+</parameter_description>
+</parameter>
+<parameter name="num_entries">
+<parameter_description> Number of items to register.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @volume can be ejected. %FALSE otherwise.
+<return></return>
+</function>
+
+<function name="g_bus_own_name_on_connection_with_closures">
+<description>
+Version of g_bus_own_name_on_connection() using closures instead of callbacks for
+easier binding in other languages.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_closure">
+<parameter_description> #GClosure to invoke when @name is
+acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_closure">
+<parameter_description> #GClosure to invoke when @name is lost or
+%NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
+
</return>
</function>
@@ -4402,6 +5884,43 @@ if an error occurred.
</return>
</function>
+<function name="g_permission_get_can_acquire">
+<description>
+Gets the value of the 'can-acquire' property. This property is %TRUE
+if it is generally possible to acquire the permission by calling
+g_permission_acquire().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the 'can-acquire' property
+</return>
+</function>
+
+<function name="g_dbus_message_get_message_type">
+<description>
+Gets the type of @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
+
+</return>
+</function>
+
<function name="g_desktop_app_info_new">
<description>
Creates a new #GDesktopAppInfo based on a desktop file id.
@@ -4658,7 +6177,7 @@ if possible.
Reads an unsigned 16-bit/2-byte value from @stream.
In order to get the correct byte order for this read operation,
-see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
</description>
@@ -4681,6 +6200,18 @@ an error occurred.
</return>
</function>
+<function name="fen_add">
+<description>
+Won't hold a ref, we have a timout callback to clean unused node_t.
+If there is no value for a key, add it and return it; else return the old
+one.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_settings_get_has_unapplied">
<description>
Returns whether the #GSettings object has any unapplied
@@ -4699,22 +6230,21 @@ Since: 2.26
</return>
</function>
-<function name="g_volume_monitor_get_connected_drives">
+<function name="g_unix_credentials_message_get_credentials">
<description>
-Gets a list of drives connected to the system.
-
-The returned list should be freed with g_list_free(), after
-its elements have been unreffed with g_object_unref().
+Gets the credentials stored in @message.
+Since: 2.26
</description>
<parameters>
-<parameter name="volume_monitor">
-<parameter_description> a #GVolumeMonitor.
+<parameter name="message">
+<parameter_description> A #GUnixCredentialsMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of connected #GDrive objects.
+<return> A #GCredentials instance. Do not free, it is owned by @message.
+
</return>
</function>
@@ -4760,6 +6290,24 @@ Gets the icon for a file.
</return>
</function>
+<function name="g_dbus_is_name">
+<description>
+Checks if @string is a valid D-Bus bus name (either unique or well-known).
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> The string to check.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if valid, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_file_new_for_commandline_arg">
<description>
Creates a #GFile with the given argument from the command line. The value of
@@ -4780,6 +6328,26 @@ I/O operation if @arg points to a malformed path.
</return>
</function>
+<function name="g_settings_sync">
+<description>
+Ensures that all pending operations for the given are complete for
+the default backend.
+
+Writes made to a #GSettings are handled asynchronously. For this
+reason, it is very unlikely that the changes have it to disk by the
+time g_settings_set() returns.
+
+This call will block until all of the writes have made it to the
+backend. Since the mainloop is not running, no change notifications
+will be dispatched during this call (but some may be queued by the
+time the call is done).
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_io_error_quark">
<description>
Gets the GIO Error Quark.
@@ -4792,52 +6360,42 @@ Gets the GIO Error Quark.
</return>
</function>
-<function name="g_settings_backend_keys_changed">
+<function name="g_unix_connection_send_credentials">
<description>
-Signals that a list of keys have possibly changed. Backend
-implementations should call this if keys have possibly changed their
-values.
-
- path must be a valid path (ie: starting and ending with a slash and
-not containing '//'). Each string in @items must form a valid key
-name when @path is prefixed to it (ie: each item must not start or
-end with '/' and must not contain '//').
+Passes the credentials of the current user the receiving side
+of the connection. The recieving end has to call
+g_unix_connection_receive_credentials() (or similar) to accept the
+credentials.
-The meaning of this signal is that any of the key names resulting
-from the contatenation of @path with each item in @items may have
-changed.
+As well as sending the credentials this also writes a single NUL
+byte to the stream, as this is required for credentials passing to
+work on some implementations.
-The same rules for when notifications must occur apply as per
-g_settings_backend_changed(). These two calls can be used
-interchangeably if exactly one item has changed (although in that
-case g_settings_backend_changed() is definitely preferred).
+Other ways to exchange credentials with a foreign peer includes the
+#GUnixCredentialsMessage type and g_socket_get_credentials() function.
-For efficiency reasons, the implementation should strive for @path to
-be as long as possible (ie: the longest common prefix of all of the
-keys that were changed) but this is not strictly required.
+Note that this function only works on Linux, currently.
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
-</parameter_description>
-</parameter>
-<parameter name="path">
-<parameter_description> the path containing the changes
+<parameter name="connection">
+<parameter_description> A #GUnixConnection.
</parameter_description>
</parameter>
-<parameter name="items">
-<parameter_description> the %NULL-terminated list of changed keys
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on success, %FALSE if @error is set.
+
+</return>
</function>
<function name="g_file_query_settable_attributes">
@@ -4871,8 +6429,8 @@ Gets the value that is stored at @key in @settings.
A convenience variant of g_settings_get() for string arrays.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type 'string array'.
+It is a programmer error to give a @key that isn't specified as
+having an array of strings type in the schema for @settings.
Since: 2.26
@@ -4891,6 +6449,22 @@ Since: 2.26
</return>
</function>
+<function name="g_volume_should_automount">
+<description>
+Returns whether the volume should be automatically mounted.
+
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> a #GVolume
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the volume should be automatically mounted.
+</return>
+</function>
+
<function name="g_converter_reset">
<description>
Resets all internal state in the converter, making it behave
@@ -5116,8 +6690,8 @@ Sets @key in @settings to @value.
A convenience variant of g_settings_set() for 32-bit integers.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type int32.
+It is a programmer error to give a @key that isn't specified as
+having a int32 type in the schema for @settings.
Since: 2.26
@@ -5216,6 +6790,26 @@ ignore.
</return>
</function>
+<function name="g_dbus_message_set_interface">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_charset_converter_new">
<description>
Creates a new #GCharsetConverter.
@@ -5242,6 +6836,31 @@ Since: 2.24
</return>
</function>
+<function name="g_dbus_method_invocation_get_message">
+<description>
+Gets the #GDBusMessage for the method invocation. This is useful if
+you need to use low-level protocol features, such as UNIX file
+descriptor passing, that cannot be properly expressed in the
+#GVariant API.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage. Do not free, it is owned by @invocation.
+
+</return>
+</function>
+
<function name="g_data_input_stream_new">
<description>
Creates a new data input stream for the @base_stream.
@@ -5314,8 +6933,8 @@ Gets the value that is stored at @key in @settings.
A convenience variant of g_settings_get() for 32-bit integers.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type int32.
+It is a programmer error to give a @key that isn't specified as
+having a int32 type in the schema for @settings.
Since: 2.26
@@ -5399,30 +7018,30 @@ Since: 2.22
<function name="g_buffered_input_stream_peek">
<description>
-Peeks in the buffer, copying data of size @count into @buffer,
+Peeks in the buffer, copying data of size @count into @buffer,
offset @offset bytes.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a pointer to an allocated chunk of memory.
+<parameter_description> a pointer to an allocated chunk of memory
</parameter_description>
</parameter>
<parameter name="offset">
-<parameter_description> a #gsize.
+<parameter_description> a #gsize
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> a #gsize.
+<parameter_description> a #gsize
</parameter_description>
</parameter>
</parameters>
-<return> a #gsize of the number of bytes peeked, or %-1 on error.
+<return> a #gsize of the number of bytes peeked, or -1 on error.
</return>
</function>
@@ -5531,6 +7150,58 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_connection_new">
+<description>
+Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
+with the end represented by @stream.
+
+If @observer is not %NULL it may be used to control the
+authentication process.
+
+When the operation is finished, @callback will be invoked. You can
+then call g_dbus_connection_new_finish() to get the result of the
+operation.
+
+This is a asynchronous failable constructor. See
+g_dbus_connection_new_sync() for the synchronous
+version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GIOStream.
+</parameter_description>
+</parameter>
+<parameter name="guid">
+<parameter_description> The GUID to use if a authenticating as a server or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver 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.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_initable_new">
<description>
Helper function for constructing #GInitiable object. This is
@@ -5638,6 +7309,24 @@ if possible.
<return></return>
</function>
+<function name="g_drive_can_start_degraded">
+<description>
+Checks if a drive can be started degraded.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive can be started degraded, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_volume_get_name">
<description>
Gets the name of @volume.
@@ -5694,28 +7383,31 @@ is needed to complete the call.
<return></return>
</function>
-<function name="g_output_stream_flush_finish">
+<function name="g_dbus_address_get_for_bus_sync">
<description>
-Finishes flushing an output stream.
+Synchronously looks up the D-Bus address for the well-known message
+bus instance specified by @bus_type. This may involve using various
+platform specific mechanisms.
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a GAsyncResult.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if flush operation suceeded, %FALSE otherwise.
+<return> A valid D-Bus address string for @bus_type or %NULL if @error is set.
+
</return>
</function>
@@ -5870,6 +7562,29 @@ if the operation's result was %FALSE.
</return>
</function>
+<function name="g_dbus_node_info_new_for_xml">
+<description>
+Parses @xml_data and returns a #GDBusNodeInfo representing the data.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="xml_data">
+<parameter_description> Valid D-Bus introspection XML.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusNodeInfo structure or %NULL if @error is set. Free
+with g_dbus_node_info_unref().
+
+</return>
+</function>
+
<function name="g_simple_async_result_set_op_res_gssize">
<description>
Sets the operation result within the asynchronous result to
@@ -5946,6 +7661,23 @@ Reload the mime information for the @dir.
<return></return>
</function>
+<function name="g_application_get_instance">
+<description>
+In the normal case where there is exactly one #GApplication instance
+in this process, return that instance. If there are multiple, the
+first one created will be returned. Otherwise, return %NULL.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> The primary instance of #GApplication,
+or %NULL if none is set
+
+</return>
+</function>
+
<function name="g_loadable_icon_load_finish">
<description>
Finishes an asynchronous icon load started in g_loadable_icon_load_async().
@@ -6011,16 +7743,36 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_connection_signal_unsubscribe">
+<description>
+Unsubscribes from signals.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="subscription_id">
+<parameter_description> A subscription id obtained from g_dbus_connection_signal_subscribe().
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_query_info">
<description>
Gets the requested information about specified @file. The result
is a #GFileInfo object that contains key-value attributes (such as
the type or size of the file).
-The @attribute value is a string that specifies the file attributes that
+The @attributes value is a string that specifies the file attributes that
should be gathered. It is not an error if it's not possible to read a particular
-requested attribute from a file - it just won't be set. @attribute should
-be a comma-separated list of attribute or attribute wildcards. The wildcard "*"
+requested attribute from a file - it just won't be set. @attributes should
+be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
means all attributes, and a wildcard like "standard::*" means all attributes in the standard
namespace. An example attribute query be "standard::*,owner::user".
The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
@@ -6108,6 +7860,25 @@ its elements have been unreffed with g_object_unref().
</return>
</function>
+<function name="g_dbus_connection_start_message_processing">
+<description>
+If @connection was created with
+%G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method
+starts processing messages. Does nothing on if @connection wasn't
+created with this flag or if the method has already been called.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_desktop_app_info_set_desktop_env">
<description>
Sets the name of the desktop that the application is running in.
@@ -6192,12 +7963,12 @@ things like text files can be executables (i.e. scripts and batch files).
</description>
<parameters>
<parameter name="type">
-<parameter_description> a content type string.
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
<return> %TRUE if the file type corresponds to a type that
-can be executable, %FALSE otherwise.
+can be executable, %FALSE otherwise.
</return>
</function>
@@ -6252,6 +8023,26 @@ ignore.
</return>
</function>
+<function name="g_dbus_message_set_serial">
+<description>
+Sets the serial for @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="serial">
+<parameter_description> A #guint32.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_get_attribute_status">
<description>
Gets the attribute status for an attribute key.
@@ -6352,6 +8143,47 @@ partial result will be returned, without an error.
</return>
</function>
+<function name="g_file_output_stream_query_info_async">
+<description>
+Asynchronously queries the @stream for a #GFileInfo. When completed,
+ callback will be called with a #GAsyncResult which can be used to
+finish the operation with g_file_output_stream_query_info_finish().
+
+For the synchronous version of this function, see
+g_file_output_stream_query_info().
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="gio-GIOScheduler">I/O priority</link>
+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_mount_operation_set_password_save">
<description>
Sets the state of saving passwords for the mount operation.
@@ -6371,9 +8203,44 @@ Sets the state of saving passwords for the mount operation.
<return></return>
</function>
+<function name="g_data_input_stream_read_line">
+<description>
+Reads a line from the data input stream.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string with the line that was read in (without the newlines).
+Set @length to a #gsize to get the length of the read line.
+On an error, it will return %NULL and @error will be set. If there's no
+content to read, it will still return %NULL, but @error won't be set.
+</return>
+</function>
+
<function name="g_app_info_launch_default_for_uri">
<description>
-Utility function that launches the default application
+Utility function that launches the default application
registered to handle the specified uri. Synchronous I/O
is done on the uri to detect the type of the file if
required.
@@ -6398,43 +8265,62 @@ required.
</return>
</function>
-<function name="g_io_modules_load_all_in_directory">
+<function name="g_application_unregistered_try_new">
<description>
-Loads all the modules in the specified directory.
-
-If don't require all modules to be initialized (and thus registering
-all gtypes) then you can use g_io_modules_scan_all_in_directory()
-which allows delayed/lazy loading of modules.
+This function is similar to g_application_try_new(), but also
+sets the GApplication:register property to %FALSE. You can later
+call g_application_register() to complete initialization.
+Since: 2.26
</description>
<parameters>
-<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to load.
+<parameter name="appid">
+<parameter_description> System-dependent application identifier
+</parameter_description>
+</parameter>
+<parameter name="argc">
+<parameter_description> Number of arguments in @argv
+</parameter_description>
+</parameter>
+<parameter name="argv">
+<parameter_description> Argument vector, usually from the <parameter>argv</parameter> parameter of main()
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> a list of #GIOModules loaded from the directory,
-All the modules are loaded into memory, if you want to
-unload them (enabling on-demand loading) you must call
-g_type_module_unuse() on all the modules. Free the list
-with g_list_free().
+<return> An application instance
+
</return>
</function>
-<function name="g_io_extension_get_priority">
+<function name="g_credentials_get_unix_user">
<description>
-Gets the priority with which @extension was registered.
+Tries to get the UNIX user identifier from @credentials. This
+method is only available on UNIX platforms.
+This operation can fail if #GCredentials is not supported on the
+OS or if the native credentials type does not contain information
+about the UNIX user.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="credentials">
+<parameter_description> A #GCredentials
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the priority of @extension
+<return> The UNIX user identifier or -1 if @error is set.
+
</return>
</function>
@@ -6456,32 +8342,25 @@ Sets the file enumerator as having pending operations.
<return></return>
</function>
-<function name="g_cancellable_get_fd">
+<function name="g_dbus_proxy_get_default_timeout">
<description>
-Gets the file descriptor for a cancellable job. This can be used to
-implement cancellable operations on Unix systems. The returned fd will
-turn readable when @cancellable is cancelled.
-
-You are not supposed to read from the fd yourself, just check for
-readable status. Reading to unset the readable status is done
-with g_cancellable_reset().
-
-After a successful return from this function, you should use
-g_cancellable_release_fd() to free up resources allocated for
-the returned file descriptor.
+Gets the timeout to use if -1 (specifying default timeout) is
+passed as @timeout_msec in the g_dbus_proxy_call() and
+g_dbus_proxy_call_sync() functions.
-See also g_cancellable_make_pollfd().
+See the #GDBusProxy:g-default-timeout property for more details.
+Since: 2.26
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable.
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return> A valid file descriptor. %-1 if the file descriptor
-is not supported, or on errors.
+<return> Timeout to use for @proxy.
+
</return>
</function>
@@ -6505,26 +8384,6 @@ Creates a new converter output stream for the @base_stream.
</return>
</function>
-<function name="g_app_info_get_display_name">
-<description>
-Gets the display name of the application. The display name is often more
-descriptive to the user than the name itself.
-
-Since: 2.24
-
-</description>
-<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
-</parameter_description>
-</parameter>
-</parameters>
-<return> the display name of the application for @appinfo, or the name if
-no display name is available.
-
-</return>
-</function>
-
<function name="g_io_error_from_errno">
<description>
Converts errno.h error codes into GIO error codes.
@@ -6577,6 +8436,43 @@ Emits the #GMountOperation::reply signal.
<return></return>
</function>
+<function name="g_dbus_message_get_path">
+<description>
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value.
+
+</return>
+</function>
+
+<function name="g_dbus_property_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusPropertyInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The same @info.
+
+</return>
+</function>
+
<function name="g_file_attribute_matcher_matches_only">
<description>
Checks if a attribute matcher only matches a given attribute. Always
@@ -6638,24 +8534,6 @@ otherwise %NULL.
</return>
</function>
-<function name="g_file_enumerator_get_container">
-<description>
-Get the #GFile container which is being enumerated.
-
-Since: 2.18
-
-</description>
-<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator
-</parameter_description>
-</parameter>
-</parameters>
-<return> the #GFile which is being enumerated.
-
-</return>
-</function>
-
<function name="g_buffered_input_stream_fill_async">
<description>
Reads data into @stream's buffer asynchronously, up to @count size.
@@ -6668,16 +8546,16 @@ of bytes that are required to fill the buffer.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream.
+<parameter_description> the number of bytes that will be read from the stream
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -6685,11 +8563,11 @@ of the request.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
+<parameter_description> a #GAsyncReadyCallback
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> a #gpointer.
+<parameter_description> a #gpointer
</parameter_description>
</parameter>
</parameters>
@@ -6766,25 +8644,34 @@ Since: 2.22
</return>
</function>
-<function name="g_cancellable_push_current">
+<function name="g_file_attribute_info_list_new">
<description>
-Pushes @cancellable onto the cancellable stack. The current
-cancllable can then be recieved using g_cancellable_get_current().
+Creates a new file attribute info list.
-This is useful when implementing cancellable operations in
-code that does not allow you to pass down the cancellable object.
-This is typically called automatically by e.g. #GFile operations,
-so you rarely have to call this yourself.
+</description>
+<parameters>
+</parameters>
+<return> a #GFileAttributeInfoList.
+</return>
+</function>
+
+<function name="g_dbus_message_get_interface">
+<description>
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
<function name="g_output_stream_write_async">
@@ -6988,13 +8875,17 @@ Since: 2.22
<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_foreach(list, g_free, NULL) and @g_list_free(list)
+known to the system. The list and its data should be freed using
+<programlisting>
+g_list_foreach (list, g_free, NULL);
+g_list_free (list);
+</programlisting>
+
</description>
<parameters>
</parameters>
-<return> #GList of the registered content types.
+<return> #GList of the registered content types
</return>
</function>
@@ -7018,6 +8909,33 @@ Since: 2.18
<return></return>
</function>
+<function name="g_dbus_connection_get_peer_credentials">
+<description>
+Gets the credentials of the authenticated peer. This will always
+return %NULL unless @connection acted as a server
+(e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed)
+when set up and the client passed credentials as part of the
+authentication process.
+
+In a message bus setup, the message bus is always the server and
+each application is a client. So this method will always return
+%NULL for message bus clients.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GCredentials or %NULL if not available. Do not free
+this object, it is owned by @connection.
+
+</return>
+</function>
+
<function name="g_socket_condition_wait">
<description>
Waits for @condition to become true on @socket. When the condition
@@ -7055,38 +8973,50 @@ Since: 2.22
</return>
</function>
-<function name="g_emblem_get_icon">
+<function name="g_dbus_message_to_gerror">
<description>
-Gives back the icon from @emblem.
+If @message is not of type %G_DBUS_MESSAGE_TYPE_ERROR does
+nothing and returns %FALSE.
-Since: 2.18
+Otherwise this method encodes the error in @message as a #GError
+using g_dbus_error_set_dbus_error() using the information in the
+%G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as
+well as the first string item in @message's body.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="emblem">
-<parameter_description> a #GEmblem from which the icon should be extracted.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> The #GError to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GIcon. The returned object belongs to the emblem
-and should not be modified or freed.
+<return> %TRUE if @error was set, %FALSE otherwise.
</return>
</function>
-<function name="g_unix_mount_point_is_readonly">
+<function name="g_emblem_get_icon">
<description>
-Checks if a unix mount point is read only.
+Gives back the icon from @emblem.
+Since: 2.18
</description>
<parameters>
-<parameter name="mount_point">
-<parameter_description> a #GUnixMountPoint.
+<parameter name="emblem">
+<parameter_description> a #GEmblem from which the icon should be extracted.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a mount point is read only.
+<return> a #GIcon. The returned object belongs to the emblem
+and should not be modified or freed.
+
</return>
</function>
@@ -7147,6 +9077,61 @@ Since: 2.26
</return>
</function>
+<function name="g_dbus_connection_new_for_address">
+<description>
+Asynchronously connects and sets up a D-Bus client connection for
+exchanging D-Bus messages with an endpoint specified by @address
+which must be in the D-Bus address format.
+
+This constructor can only be used to initiate client-side
+connections - use g_dbus_connection_new() if you need to act as the
+server. In particular, @flags cannot contain the
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
+
+When the operation is finished, @callback will be invoked. You can
+then call g_dbus_connection_new_finish() to get the result of the
+operation.
+
+If @observer is not %NULL it may be used to control the
+authentication process.
+
+This is a asynchronous failable constructor. See
+g_dbus_connection_new_for_address_sync() for the synchronous
+version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> A D-Bus address.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver 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.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_get_display_name">
<description>
Gets a display name for a file.
@@ -7163,6 +9148,26 @@ Gets a display name for a file.
</return>
</function>
+<function name="g_dbus_server_get_client_address">
+<description>
+Gets a D-Bus address string that can be used by clients to connect
+to @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A D-Bus address string. Do not free, the string is owned
+by @server.
+
+</return>
+</function>
+
<function name="g_socket_client_connect_to_service">
<description>
Attempts to create a TCP connection to a service.
@@ -7235,6 +9240,41 @@ g_socket_address_enumerator_next_finish() to get the result.
<return></return>
</function>
+<function name="g_output_stream_flush_async">
+<description>
+Flushes a stream asynchronously.
+For behaviour details see g_output_stream_flush().
+
+When the operation is finished @callback will be
+called. You can then call g_output_stream_flush_finish() to get the
+result of the operation.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io 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> a #GAsyncReadyCallback 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_socket_speaks_ipv4">
<description>
Checks if a socket is capable of speaking IPv4.
@@ -7286,29 +9326,24 @@ Since: 2.26
</return>
</function>
-<function name="g_io_stream_set_pending">
+<function name="g_dbus_message_set_message_type">
<description>
-Sets @stream to have actions pending. If the pending flag is
-already set or @stream is closed, it will return %FALSE and set
- error
+Sets @message to be of @type.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore
+<parameter name="type">
+<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if pending was previously unset and is now set.
-
-</return>
+<return></return>
</function>
<function name="g_unix_fd_list_steal_fds">
@@ -7350,6 +9385,22 @@ Since: 2.24
</return>
</function>
+<function name="g_file_monitor_cancel">
+<description>
+Cancels a file monitor.
+
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if monitor was cancelled.
+</return>
+</function>
+
<function name="g_mount_operation_get_choice">
<description>
Gets a choice from the mount operation.
@@ -7427,6 +9478,38 @@ when no longer needed.
</return>
</function>
+<function name="g_application_try_new">
+<description>
+This function is similar to g_application_new(), but allows for
+more graceful fallback if the environment doesn't support the
+basic #GApplication functionality.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="appid">
+<parameter_description> System-dependent application identifier
+</parameter_description>
+</parameter>
+<parameter name="argc">
+<parameter_description> Number of arguments in @argv
+</parameter_description>
+</parameter>
+<parameter name="argv">
+<parameter_description> Argument vector, usually from the <parameter>argv</parameter> parameter of main()
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> An application instance
+
+</return>
+</function>
+
<function name="g_file_has_prefix">
<description>
Checks whether @file has the prefix specified by @prefix. In other word,
@@ -7625,6 +9708,102 @@ Since: 2.22
</return>
</function>
+<function name="g_bus_own_name">
+<description>
+Starts acquiring @name on the bus specified by @bus_type and calls
+ name_acquired_handler and @name_lost_handler when the name is
+acquired respectively lost. Callbacks 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 function from.
+
+You are guaranteed that one of the @name_acquired_handler and @name_lost_handler
+callbacks will be invoked after calling this function - there are three
+possible cases:
+<itemizedlist>
+<listitem><para>
+ name_lost_handler with a %NULL connection (if a connection to the bus can't be made).
+</para></listitem>
+<listitem><para>
+ bus_acquired_handler then @name_lost_handler (if the name can't be obtained)
+</para></listitem>
+<listitem><para>
+ bus_acquired_handler then @name_acquired_handler (if the name was obtained).
+</para></listitem>
+</itemizedlist>
+When you are done owning the name, just call g_bus_unown_name()
+with the owner id this function returns.
+
+If the name is acquired or lost (for example another application
+could acquire the name if you allow replacement or the application
+currently owning the name exits), the handlers are also invoked. If the
+#GDBusConnection that is used for attempting to own the name
+closes, then @name_lost_handler is invoked since it is no
+longer possible for other processes to access the process.
+
+You cannot use g_bus_own_name() several times for the same name (unless
+interleaved with calls to g_bus_unown_name()) - only the first call
+will work.
+
+Another guarantee is that invocations of @name_acquired_handler
+and @name_lost_handler are guaranteed to alternate; that
+is, if @name_acquired_handler is invoked then you are
+guaranteed that the next time one of the handlers is invoked, it
+will be @name_lost_handler. The reverse is also true.
+
+If you plan on exporting objects (using e.g.
+g_dbus_connection_register_object()), note that it is generally too late
+to export the objects in @name_acquired_handler. Instead, you can do this
+in @bus_acquired_handler since you are guaranteed that this will run
+before @name is requested from the bus.
+
+This behavior makes it very simple to write applications that wants
+to own names and export objects, see <xref linkend="gdbus-owning-names"/>.
+Simply register objects to be exported in @bus_acquired_handler and
+unregister the objects (if any) in @name_lost_handler.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> The type of bus to own a name on.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="bus_acquired_handler">
+<parameter_description> Handler to invoke when connected to the bus of type @bus_type or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_handler">
+<parameter_description> Handler to invoke when @name is acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_handler">
+<parameter_description> Handler to invoke when @name is lost or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
+
+</return>
+</function>
+
<function name="g_file_equal">
<description>
Checks equality of two given #GFile<!-- -->s. Note that two
@@ -7651,6 +9830,24 @@ This call does no blocking i/o.
</return>
</function>
+<function name="g_dbus_proxy_get_flags">
+<description>
+Gets the flags that @proxy was constructed with.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Flags from the #GDBusProxyFlags enumeration.
+
+</return>
+</function>
+
<function name="g_themed_icon_new">
<description>
Creates a new themed icon for @iconname.
@@ -7667,6 +9864,22 @@ Creates a new themed icon for @iconname.
</return>
</function>
+<function name="g_file_info_get_is_hidden">
+<description>
+Checks if a file is hidden.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file is a hidden file, %FALSE otherwise.
+</return>
+</function>
+
<function name="g_file_set_attributes_async">
<description>
Asynchronously sets the attributes of @file with @info.
@@ -7848,22 +10061,6 @@ or less than @mount2, respectively.
</return>
</function>
-<function name="g_io_stream_clear_pending">
-<description>
-Clears the pending flag on @stream.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_monitor_set_rate_limit">
<description>
Sets the rate limit to which the @monitor will report
@@ -7885,24 +10082,21 @@ poll for changes.
<return></return>
</function>
-<function name="g_cancellable_set_error_if_cancelled">
+<function name="g_dbus_method_invocation_get_parameters">
<description>
-If the @cancellable is cancelled, sets the error to notify
-that the operation was cancelled.
+Gets the parameters of the method invocation.
+Since: 2.26
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError to append error state to.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @cancellable was cancelled, %FALSE if it was not.
+<return> A #GVariant. Do not free, it is owned by @invocation.
+
</return>
</function>
@@ -8046,12 +10240,12 @@ classes. However, if you override one you must override all.
<function name="g_app_info_launch">
<description>
-Launches the application. Passes @files to the launched application
+Launches the application. Passes @files to the launched application
as arguments, using the optional @launch_context to get information
about the details of the launcher (like what screen it is on).
On error, @error will be set accordingly.
-To lauch the application without arguments pass a %NULL @files list.
+To launch the application without arguments pass a %NULL @files list.
Note that even if the launch is successful the application launched
can fail to start if it runs into problems during startup. There is
@@ -8062,6 +10256,15 @@ unsupported uris with strange formats like mailto:), so if you have
a textual uri you want to pass in as argument, consider using
g_app_info_launch_uris() instead.
+On UNIX, this function sets the <envvar>GIO_LAUNCHED_DESKTOP_FILE</envvar>
+environment variable with the path of the launched desktop file and
+<envvar>GIO_LAUNCHED_DESKTOP_FILE_PID</envvar> to the process
+id of the launched process. This can be used to ignore
+<envvar>GIO_LAUNCHED_DESKTOP_FILE</envvar>, should it be inherited
+by further processes. The <envvar>DISPLAY</envvar> and
+<envvar>DESKTOP_STARTUP_ID</envvar> environment variables are also
+set, based on information provided in @launch_context.
+
</description>
<parameters>
@@ -8082,7 +10285,39 @@ g_app_info_launch_uris() instead.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful launch, %FALSE otherwise.
+<return> %TRUE on successful launch, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_dbus_message_to_blob">
+<description>
+Serializes @message to a blob. The byte order returned by
+g_dbus_message_get_byte_order() will be used.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="out_size">
+<parameter_description> Return location for size of generated blob.
+</parameter_description>
+</parameter>
+<parameter name="capabilities">
+<parameter_description> A #GDBusCapabilityFlags describing what protocol features are supported.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A pointer to a valid binary D-Bus message of @out_size bytes
+generated by @message or %NULL if @error is set. Free with g_free().
+
</return>
</function>
@@ -8108,14 +10343,14 @@ Since: 2.22
<function name="g_buffered_input_stream_new">
<description>
-Creates a new #GInputStream from the given @base_stream, with
+Creates a new #GInputStream from the given @base_stream, with
a buffer set to the default size (4 kilobytes).
</description>
<parameters>
<parameter name="base_stream">
-<parameter_description> a #GInputStream.
+<parameter_description> a #GInputStream
</parameter_description>
</parameter>
</parameters>
@@ -8123,27 +10358,27 @@ a buffer set to the default size (4 kilobytes).
</return>
</function>
-<function name="g_content_type_from_mime_type">
+<function name="g_dbus_connection_get_stream">
<description>
-Tries to find a content type based on the mime type name.
+Gets the underlying stream used for IO.
-Since: 2.18
+Since: 2.26
</description>
<parameters>
-<parameter name="mime_type">
-<parameter_description> a mime type string.
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
</parameters>
-<return> Newly allocated string with content type or NULL when does not know.
+<return> the stream used for IO
</return>
</function>
<function name="g_content_type_guess">
<description>
-Guesses the content type based on example data. If the function is
+Guesses the content type based on example data. If the function is
uncertain, @result_uncertain will be set to %TRUE. Either @filename
or @data may be %NULL, in which case the guess will be based solely
on the other argument.
@@ -8164,12 +10399,13 @@ on the other argument.
</parameter_description>
</parameter>
<parameter name="result_uncertain">
-<parameter_description> a flag indicating the certainty of the result
+<parameter_description> return location for the certainty
+of the result, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a string indicating a guessed content type for the
-given data.
+<return> a string indicating a guessed content type for the
+given data. Free with g_free()
</return>
</function>
@@ -8393,6 +10629,115 @@ content to read, it will still return %NULL, but @error won't be set.
</return>
</function>
+<function name="g_dbus_connection_add_filter">
+<description>
+Adds a message filter. Filters are handlers that are run on all
+incoming and outgoing messages, prior to standard dispatch. Filters
+are run in the order that they were added. The same handler can be
+added as a filter more than once, in which case it will be run more
+than once. Filters added during a filter callback won't be run on
+the message being processed.
+
+Note that filters are run in a dedicated message handling thread so
+they can't block and, generally, can't do anything but signal a
+worker thread. Also note that filters are rarely needed - use API
+such as g_dbus_connection_send_message_with_reply(),
+g_dbus_connection_signal_subscribe() or
+g_dbus_connection_call() instead.
+
+If a filter consumes an incoming message (by returning %TRUE), 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 will not be sent to the other peer.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="filter_function">
+<parameter_description> A filter function.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @filter_function.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to free @user_data with when filter
+is removed or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A filter identifier that can be used with
+g_dbus_connection_remove_filter().
+
+</return>
+</function>
+
+<function name="g_dbus_proxy_set_cached_property">
+<description>
+If @value is not %NULL, sets the cached value for the property with
+name @property_name to the value in @value.
+
+If @value is %NULL, then the cached value is removed from the
+property cache.
+
+If @proxy has an expected interface (see
+#GDBusProxy:g-interface-info), then @property_name (for existence)
+and @value (for the type) is checked against it.
+
+If the @value #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.
+|[
+g_dbus_proxy_set_cached_property (proxy,
+"SomeProperty",
+g_variant_new ("(si)",
+"A String",
+42));
+]|
+
+Normally you will not need to use this method since @proxy is
+tracking changes using the
+<literal>org.freedesktop.DBus.Properties.PropertiesChanged</literal>
+D-Bus signal. However, for performance reasons an object may decide
+to not use this signal for some properties and instead use a
+proprietary out-of-band mechanism to transmit changes.
+
+As a concrete example, consider an object with a property
+<literal>ChatroomParticipants</literal> which is an array of
+strings. Instead of transmitting the same (long) array every time
+the property changes, it is more efficient to only transmit the
+delta using e.g. signals <literal>ChatroomParticipantJoined(String
+name)</literal> and <literal>ChatroomParticipantParted(String
+name)</literal>.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> Property name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> Value for the property or %NULL to remove it from the cache.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_content_type_get_icon">
<description>
Gets the icon for a content type.
@@ -8401,11 +10746,54 @@ Gets the icon for a content type.
</description>
<parameters>
<parameter name="type">
-<parameter_description> a content type string.
+<parameter_description> a content type string
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GIcon corresponding to the content type. Free the returned
+object with g_object_unref()
+</return>
+</function>
+
+<function name="g_permission_get_allowed">
+<description>
+Gets the value of the 'allowed' property. This property is %TRUE if
+the caller currently has permission to perform the action that
+ permission represents the permission to perform.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the 'allowed' property
+</return>
+</function>
+
+<function name="g_dbus_message_get_header">
+<description>
+Gets a header field on @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="header_field">
+<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
</parameter_description>
</parameter>
</parameters>
-<return> #GIcon corresponding to the content type.
+<return> A #GVariant with the value if the header was found, %NULL
+otherwise. Do not free, it is owned by @message.
+
</return>
</function>
@@ -8466,6 +10854,37 @@ Since: 2.24
</return>
</function>
+<function name="g_dbus_message_new_method_error_valist">
+<description>
+Like g_dbus_message_new_method_error() but intended for language bindings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
+</parameter_description>
+</parameter>
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="error_message_format">
+<parameter_description> The D-Bus error message in a printf() format.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> Arguments for @error_message_format.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_socket_set_listen_backlog">
<description>
Sets the maximum number of outstanding connections allowed
@@ -8492,6 +10911,60 @@ Since: 2.22
<return></return>
</function>
+<function name="g_settings_get_mapped">
+<description>
+Gets the value that is stored at @key in @settings, subject to
+application-level validation/mapping.
+
+You should use this function when the application needs to perform
+some processing on the value of the key (for example, parsing). The
+ mapping function performs that processing. If the function
+indicates that the processing was unsuccessful (due to a parse error,
+for example) then the mapping is tried again with another value.
+
+This allows a robust 'fall back to defaults' behaviour to be
+implemented somewhat automatically.
+
+The first value that is tried is the user's setting for the key. If
+the mapping function fails to map this value, other values may be
+tried in an unspecified order (system or site defaults, translated
+schema default values, untranslated schema default values, etc).
+
+If the mapping function fails for all possible values, one additional
+attempt is made: the mapping function is called with a %NULL value.
+If the mapping function still indicates failure at this point then
+the application will be aborted.
+
+The result parameter for the @mapping function is pointed to a
+#gpointer which is initially set to %NULL. The same pointer is given
+to each invocation of @mapping. The final value of that #gpointer is
+what is returned by this function. %NULL is valid; it is returned
+just as any other value would be.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+<parameter name="mapping">
+<parameter_description> the function to map the value in the settings database to
+the value used by the application
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for @mapping
+</parameter_description>
+</parameter>
+</parameters>
+<return> the result, which may be %NULL
+</return>
+</function>
+
<function name="g_srv_target_get_priority">
<description>
Gets @target's priority. You should not need to look at this;
@@ -8559,6 +11032,86 @@ require it.
</return>
</function>
+<function name="g_socket_listener_add_address">
+<description>
+Creates a socket of type @type and protocol @protocol, binds
+it to @address and adds it to the set of sockets we're accepting
+sockets from.
+
+Note that adding an IPv6 address, depending on the platform,
+may or may not result in a listener that also accepts IPv4
+connections. For more determinstic behaviour, see
+g_socket_listener_add_inet_port().
+
+ source_object will be passed out in the various calls
+to accept to identify this particular source, which is
+useful if you're listening on multiple addresses and do
+different things depending on what address is connected to.
+
+If successful and @effective_address is non-%NULL then it will
+be set to the address that the binding actually occured at. This
+is helpful for determining the port number that was used for when
+requesting a binding to port 0 (ie: "any port"). This address, if
+requested, belongs to the caller and must be freed.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSocketType
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> a #GSocketProtocol
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="effective_address">
+<parameter_description> location to store the address that was bound to, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_dbus_message_get_header_fields">
+<description>
+Gets an array of all header fields on @message that are set.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An array of header fields terminated by
+%G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element is a
+#guchar. Free with g_free().
+
+</return>
+</function>
+
<function name="g_io_scheduler_cancel_all_jobs">
<description>
Cancels all cancellable I/O jobs.
@@ -8755,26 +11308,29 @@ Sets whether to handle cancellation within the asynchronous operation.
<return></return>
</function>
-<function name="g_file_get_parent">
+<function name="g_dbus_method_invocation_return_value">
<description>
-Gets the parent directory for the @file.
-If the @file represents the root directory of the
-file system, then %NULL will be returned.
+Finishes handling a D-Bus method call by returning @parameters.
+If the @parameters GVariant is floating, it is consumed.
-This call does no blocking i/o.
+It is an error if @parameters is not of the right format.
+
+This method will free @invocation, you cannot use it afterwards.
+Since: 2.26
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile structure to the parent of the given
-#GFile or %NULL if there is no parent.
-Free the returned object with g_object_unref().
-</return>
+<return></return>
</function>
<function name="g_file_set_attribute_byte_string">
@@ -8836,6 +11392,37 @@ Returns whether the monitor is canceled.
</return>
</function>
+<function name="g_bus_get_finish">
+<description>
+Finishes an operation started with g_bus_get().
+
+The returned object is a singleton, that is, shared with other
+callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
+event that you need a private message bus connection, use
+g_dbus_address_get_for_bus() and
+g_dbus_connection_new_for_address().
+
+Note that the returned #GDBusConnection object will (usually) have
+the #GDBusConnection:exit-on-close property set to %TRUE.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_bus_get().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_file_set_attributes_from_info">
<description>
Tries to set all attributes in the #GFileInfo on the target values,
@@ -9185,6 +11772,123 @@ otherwise.
</return>
</function>
+<function name="g_file_get_parent">
+<description>
+Gets the parent directory for the @file.
+If the @file represents the root directory of the
+file system, then %NULL will be returned.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile structure to the parent of the given
+#GFile or %NULL if there is no parent.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_dbus_proxy_new_sync">
+<description>
+Creates a proxy for accessing @interface_name on the remote object
+at @object_path owned by @name at @connection and synchronously
+loads D-Bus properties unless the
+#G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used.
+
+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 @name is a well-known name and the
+#G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
+owner currently exists, the message bus will be requested to launch
+a name owner for the name.
+
+This is a synchronous failable constructor. See g_dbus_proxy_new()
+and g_dbus_proxy_new_finish() for the asynchronous version.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
+</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="interface_name">
+<parameter_description> A D-Bus interface name.
+</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> A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_name_finish">
+<description>
+Retrieves the result of a call to
+g_resolver_lookup_by_name_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.22
+
+</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_file_info_set_attribute_status">
<description>
Sets the attribute status for an attribute key. This is only
@@ -9322,6 +12026,44 @@ Gets the icon for the application.
</return>
</function>
+<function name="g_bus_watch_name_on_connection_with_closures">
+<description>
+Version of g_bus_watch_name_on_connection() using closures instead of callbacks for
+easier binding in other languages.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to not exist or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
+
+</return>
+</function>
+
<function name="g_file_parse_name">
<description>
Constructs a #GFile with the given @parse_name (i.e. something given by g_file_get_parse_name()).
@@ -9408,6 +12150,52 @@ Increases the reference count on @file.
</return>
</function>
+<function name="g_dbus_connection_close_finish">
+<description>
+Finishes an operation started with g_dbus_connection_close().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_close().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation succeeded, %FALSE if @error is set.
+
+</return>
+</function>
+
+<function name="g_dbus_message_set_destination">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_eject_mountable_finish">
<description>
Finishes an asynchronous eject operation started by
@@ -9436,6 +12224,49 @@ otherwise.
</return>
</function>
+<function name="g_socket_listener_accept_socket">
+<description>
+Blocks waiting for a client to connect to any of the sockets added
+to the listener. Returns the #GSocket that was accepted.
+
+If you want to accept the high-level #GSocketConnection, not a #GSocket,
+which is often the case, then you should use g_socket_listener_accept()
+instead.
+
+If @source_object is not %NULL it will be filled out with the source
+object specified when the corresponding socket or address was added
+to the listener.
+
+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.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> location where #GObject pointer will be stored, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocket on success, %NULL on error.
+
+</return>
+</function>
+
<function name="g_settings_backend_flatten_tree">
<description>
Calculate the longest common prefix of all keys in a tree and write
@@ -9470,6 +12301,56 @@ Since: 2.26
<return></return>
</function>
+<function name="g_dbus_proxy_new_for_bus">
+<description>
+Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
+</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="interface_name">
+<parameter_description> A D-Bus interface name.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> Callback function to invoke when the proxy is ready.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_volume_eject">
<description>
Ejects a volume. This is an asynchronous operation, and is
@@ -9590,24 +12471,29 @@ Gets the base stream for the filter stream.
</return>
</function>
-<function name="g_unix_mount_compare">
+<function name="g_dbus_error_unregister_error">
<description>
-Compares two unix mounts.
+Destroys an association previously set up with g_dbus_error_register_error().
+Since: 2.26
</description>
<parameters>
-<parameter name="mount1">
-<parameter_description> first #GUnixMountEntry to compare.
+<parameter name="error_domain">
+<parameter_description> A #GQuark for a error domain.
</parameter_description>
</parameter>
-<parameter name="mount2">
-<parameter_description> second #GUnixMountEntry to compare.
+<parameter name="error_code">
+<parameter_description> An error code.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_name">
+<parameter_description> A D-Bus error name.
</parameter_description>
</parameter>
</parameters>
-<return> 1, 0 or -1 if @mount1 is greater than, equal to,
-or less than @mount2, respectively.
+<return> %TRUE if the association was destroyed, %FALSE if it wasn't found.
+
</return>
</function>
@@ -9627,23 +12513,36 @@ Guesses the icon of a Unix mount.
</return>
</function>
-<function name="g_resolver_free_addresses">
+<function name="g_dbus_message_new">
<description>
-Frees @addresses (which should be the return value from
-g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
-(This is a convenience method; you can also simply free the results
-by hand.)
+Creates a new empty #GDBusMessage.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="addresses">
-<parameter_description> a #GList of #GInetAddress
+</parameters>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_dbus_message_get_error_name">
+<description>
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
<function name="g_vfs_get_local">
@@ -9658,6 +12557,106 @@ Gets the local #GVfs for the system.
</return>
</function>
+<function name="g_dbus_property_info_unref">
+<description>
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusPropertyInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_async_initable_init_async">
+<description>
+Starts asynchronous initialization of the object implementing the
+interface. This must be done before any real use of the object after
+initial construction. If the object also implements #GInitable you can
+optionally call g_initable_init() instead.
+
+When the initialization is finished, @callback will be called. You can
+then call g_async_initable_init_finish() to get the result of the
+initialization.
+
+Implementations may also support cancellation. If @cancellable is not
+%NULL, then initialization 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 @cancellable is not %NULL, and
+the object doesn't support cancellable initialization, the error
+%G_IO_ERROR_NOT_SUPPORTED will be returned.
+
+If this function is not called, or returns with an error, then all
+operations on the object should fail, generally returning the
+error %G_IO_ERROR_NOT_INITIALIZED.
+
+Implementations of this method must be idempotent: i.e. multiple calls
+to this function with the same argument should return the same results.
+Only the first call initializes the object; further calls return the result
+of the first call. This is so that it's safe to implement the singleton
+pattern in the GObject constructor function.
+
+For classes that also support the #GInitable interface, the default
+implementation of this method will run the g_initable_init() function
+in a thread, so if you want to support asynchronous initialization via
+threads, just implement the #GAsyncInitable interface without overriding
+any interface methods.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="initable">
+<parameter_description> a #GAsyncInitable.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the operation.
+</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 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_dbus_message_get_arg0">
+<description>
+Convenience to get the first item in the body of @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The string item or %NULL if the first item in the body of
+ message is not a string.
+
+</return>
+</function>
+
<function name="g_filter_output_stream_get_close_base_stream">
<description>
Returns whether the base stream will be closed when @stream is
@@ -9702,37 +12701,6 @@ This call does no blocking i/o.
</return>
</function>
-<function name="g_settings_backend_setup">
-<description>
-Sets up @backend for use with #GSettings.
-
-If you create a #GSettings with its context property set to @context
-then it will use the backend given to this function. See
-g_settings_new_with_context().
-
-The backend must be set up before any settings objects are created
-for the named context.
-
-It is not possible to specify a backend for the default context.
-
-This function takes a reference on @backend and never releases it.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="context">
-<parameter_description> a context string (not %NULL or "")
-</parameter_description>
-</parameter>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_set_attribute_uint64">
<description>
Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value.
@@ -9852,6 +12820,35 @@ Since: 2.26
</return>
</function>
+<function name="g_dbus_message_bytes_needed">
+<description>
+Utility function to calculate how many bytes are needed to
+completely deserialize the D-Bus message stored at @blob.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="blob">
+<parameter_description> A blob represent a binary D-Bus message.
+</parameter_description>
+</parameter>
+<parameter name="blob_len">
+<parameter_description> The length of @blob (must be at least 16).
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes needed or -1 if @error is set (e.g. if
+ blob contains invalid data or not enough data is available to
+determine the size).
+
+</return>
+</function>
+
<function name="g_file_enumerator_next_file">
<description>
Returns information for the next file in the enumerated object.
@@ -9902,21 +12899,142 @@ Since: 2.24
</return>
</function>
-<function name="g_win32_output_stream_set_close_handle">
+<function name="g_permission_acquire_async">
<description>
-Sets whether the handle of @stream shall be closed when the stream
-is closed.
+Attempts to acquire the permission represented by @permission.
+
+This is the first half of the asynchronous version of
+g_permission_acquire().
Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GWin32OutputStream
+<parameter name="permission">
+<parameter_description> a #GPermission instance
</parameter_description>
</parameter>
-<parameter name="close_handle">
-<parameter_description> %TRUE to close the handle when done
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> the #GAsyncReadyCallback to call when done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_connection_register_subtree">
+<description>
+Registers a whole subtree of <quote>dynamic</quote> objects.
+
+The @enumerate and @introspection functions in @vtable are used to
+convey, to remote callers, what nodes exist in the subtree rooted
+by @object_path.
+
+When handling remote calls into any node in the subtree, first the
+ enumerate function is used to check if the node exists. If the node exists
+or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
+the @introspection function is used to check if the node supports the
+requested method. If so, the @dispatch function is used to determine
+where to dispatch the call. The collected #GDBusInterfaceVTable and
+#gpointer will be used to call into the interface vtable for processing
+the request.
+
+All calls into user-provided code 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.
+
+If an existing subtree is already registered at @object_path or
+then @error is set to #G_IO_ERROR_EXISTS.
+
+Note that it is valid to register regular objects (using
+g_dbus_connection_register_object()) in a subtree registered with
+g_dbus_connection_register_subtree() - if so, the subtree handler
+is tried as the last resort. One way to think about a subtree
+handler is to consider it a <quote>fallback handler</quote>
+for object paths not registered via g_dbus_connection_register_object()
+or other bindings.
+
+Note that @vtable will be copied so you cannot change it after
+registration.
+
+See <xref linkend="gdbus-subtree-server"/> for an example of how to use this method.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> The object path to register the subtree at.
+</parameter_description>
+</parameter>
+<parameter name="vtable">
+<parameter_description> A #GDBusSubtreeVTable to enumerate, introspect and dispatch nodes in the subtree.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags used to fine tune the behavior of the subtree.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> Data to pass to functions in @vtable.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to call when the subtree is unregistered.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> 0 if @error is set, otherwise a subtree registration id (never 0)
+that can be used with g_dbus_connection_unregister_subtree() .
+
+</return>
+</function>
+
+<function name="g_application_invoke_action">
+<description>
+Invokes the action @name of the passed #GApplication.
+
+This function has different behavior depending on whether @application
+is acting as a proxy for another process. In the normal case where
+the current process is hosting the application, and the specified
+action exists and is enabled, the #GApplication::action signal will
+be emitted.
+
+If @application is a proxy, then the specified action will be invoked
+in the remote process. It is not necessary to call
+g_application_add_action() in the current process in order to invoke
+one remotely.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the action to invoke
+</parameter_description>
+</parameter>
+<parameter name="platform_data">
+<parameter_description> platform-specific event data
</parameter_description>
</parameter>
</parameters>
@@ -10221,34 +13339,39 @@ Since: 2.22
</return>
</function>
-<function name="g_output_stream_flush">
+<function name="g_dbus_generate_guid">
<description>
-Flushed any outstanding buffers in the stream. Will block during
-the operation. Closing the stream will implicitly cause a flush.
+Generate a D-Bus GUID that can be used with
+e.g. g_dbus_connection_new().
-This function is optional for inherited classes.
+See the D-Bus specification regarding what strings are valid D-Bus
+GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
-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.
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> A valid D-Bus GUID. Free with g_free().
+
+</return>
+</function>
+<function name="g_dbus_is_interface_name">
+<description>
+Checks if @string is a valid D-Bus interface name.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional cancellable object
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="string">
+<parameter_description> The string to check.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error
+<return> %TRUE if valid, %FALSE otherwise.
+
</return>
</function>
@@ -10500,15 +13623,15 @@ On error -1 is returned and @error is set accordingly.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore.
+<parameter_description> location to store the error occuring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
@@ -10569,7 +13692,7 @@ Gets the size of the input buffer.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
</parameters>
@@ -10653,6 +13776,28 @@ of the request.
<return></return>
</function>
+<function name="g_dbus_connection_new_finish">
+<description>
+Finishes an operation started with g_dbus_connection_new().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_file_info_has_namespace">
<description>
Checks if a file info structure has an attribute in the
@@ -10734,6 +13879,50 @@ Since: 2.22
<return></return>
</function>
+<function name="g_resolver_lookup_service_async">
+<description>
+Begins asynchronously performing a DNS SRV lookup for the given
+ service and @protocol in the given @domain, and eventually calls
+ callback, which must call g_resolver_lookup_service_finish() to
+get the final result. See g_resolver_lookup_service() for more
+details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="service">
+<parameter_description> the service type to look up (eg, "ldap")
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> the networking protocol to use for @service (eg, "tcp")
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> the DNS domain to look up the service in
+</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="gvdb_table_has_value">
<description>
Checks for a value named @key in @file.
@@ -10856,10 +14045,44 @@ Creates a new icon for a file.
</return>
</function>
+<function name="g_dbus_interface_info_generate_xml">
+<description>
+Appends an XML representation of @info (and its children) to @string_builder.
+
+This function is typically used for generating introspection XML
+documents at run-time for handling the
+<literal>org.freedesktop.DBus.Introspectable.Introspect</literal>
+method.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo
+</parameter_description>
+</parameter>
+<parameter name="indent">
+<parameter_description> Indentation level.
+</parameter_description>
+</parameter>
+<parameter name="string_builder">
+<parameter_description> A #GString to to append XML data to.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_settings_new">
<description>
Creates a new #GSettings object with a given schema.
+Signals on the newly created #GSettings object will be dispatched
+via the thread-default #GMainContext in effect at the time of the
+call to g_settings_new(). The new #GSettings will hold a reference
+on the context. See g_main_context_push_thread_default().
+
Since: 2.26
</description>
@@ -11093,6 +14316,47 @@ Since: 2.22
</return>
</function>
+<function name="g_bus_get_sync">
+<description>
+Synchronously connects to the message bus specified by @bus_type.
+Note that the returned object may shared with other callers,
+e.g. if two separate parts of a process calls this function with
+the same @bus_type, they will share the same object.
+
+This is a synchronous failable function. See g_bus_get() and
+g_bus_get_finish() for the asynchronous version.
+
+The returned object is a singleton, that is, shared with other
+callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
+event that you need a private message bus connection, use
+g_dbus_address_get_for_bus_sync() and
+g_dbus_connection_new_for_address().
+
+Note that the returned #GDBusConnection object will (usually) have
+the #GDBusConnection:exit-on-close property set to %TRUE.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</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> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_async_initable_new_valist_async">
<description>
Helper function for constructing #GAsyncInitiable object. This is
@@ -11217,38 +14481,79 @@ Since: 2.22
</return>
</function>
-<function name="g_volume_eject_with_operation">
+<function name="g_dbus_proxy_call">
<description>
-Ejects a volume. This is an asynchronous operation, and is
-finished by calling g_volume_eject_with_operation_finish() with the @volume
-and #GAsyncResult data returned in the @callback.
+Asynchronously invokes the @method_name method on @proxy.
-Since: 2.22
+If @method_name contains any dots, then @name is split into interface and
+method name parts. This allows using @proxy for invoking methods on
+other interfaces.
+
+If the #GDBusConnection associated with @proxy is closed then
+the operation will fail with %G_IO_ERROR_CLOSED. If
+ cancellable is canceled, the operation will fail with
+%G_IO_ERROR_CANCELLED. If @parameters contains a value not
+compatible with the D-Bus protocol, the operation fails with
+%G_IO_ERROR_INVALID_ARGUMENT.
+
+If the @parameters #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_proxy_call (proxy,
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+(GAsyncReadyCallback) two_strings_done,
+&data);
+]|
+
+This is an asynchronous method. 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 g_dbus_proxy_call_finish() to get the result of
+the operation. See g_dbus_proxy_call_sync() for the synchronous
+version of this method.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume.
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> Name of method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for eject
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds or -1 to use the proxy default timeout.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
+care about the result of the method invocation.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
@@ -11319,6 +14624,29 @@ Since: 2.26
</return>
</function>
+<function name="g_application_list_actions">
+<description>
+Retrieves the list of action names currently exported by @application.
+
+It is an error to call this function if @application is a proxy for
+a remote application.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocation, %NULL-terminated array
+of strings containing action names; use g_strfreev() to free the
+resources used by the returned array
+
+</return>
+</function>
+
<function name="g_unix_mount_point_guess_name">
<description>
Guesses the name of a Unix mount point.
@@ -11337,6 +14665,28 @@ be freed with g_free()
</return>
</function>
+<function name="g_dbus_proxy_new_finish">
+<description>
+Finishes creating a #GDBusProxy.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_socket_client_set_local_address">
<description>
Sets the local address of the socket client.
@@ -11456,6 +14806,25 @@ Frees a unix mount.
<return></return>
</function>
+<function name="g_dbus_method_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusMethodInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The same @info.
+
+</return>
+</function>
+
<function name="g_filename_completer_new">
<description>
Creates a new filename completer.
@@ -11484,6 +14853,92 @@ Checks if an input stream has pending actions.
</return>
</function>
+<function name="g_dbus_connection_signal_subscribe">
+<description>
+Subscribes to signals on @connection and invokes @callback with a
+whenever the signal is received. Note that @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.
+
+If @connection is not a message bus connection, @sender must be
+%NULL.
+
+If @sender is a well-known name note that @callback is invoked with
+the unique name for the owner of @sender, not the well-known name
+as one would expect. This is because the message bus rewrites the
+name. As such, to avoid certain race conditions, users should be
+tracking the name owner of the well-known name and use that when
+processing the received signal.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="sender">
+<parameter_description> Sender name to match on (unique or well-known name) or %NULL to listen from all senders.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface name to match on or %NULL to match on all interfaces.
+</parameter_description>
+</parameter>
+<parameter name="member">
+<parameter_description> D-Bus signal name to match on or %NULL to match on all signals.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Object path to match on or %NULL to match on all object paths.
+</parameter_description>
+</parameter>
+<parameter name="arg0">
+<parameter_description> Contents of first string argument to match on or %NULL to match on all kinds of arguments.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to subscribe to the signal (currently unused).
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> Callback to invoke when there is a signal matching the requested data.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to free @user_data with when subscription is removed or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A subscription identifier that can be used with g_dbus_connection_signal_unsubscribe().
+
+</return>
+</function>
+
+<function name="g_dbus_is_unique_name">
+<description>
+Checks if @string is a valid D-Bus unique bus name.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> The string to check.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if valid, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_inet_address_new_any">
<description>
Creates a #GInetAddress for the "any" address (unassigned/"don't
@@ -11541,6 +14996,72 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_connection_send_message_with_reply_sync">
+<description>
+Synchronously sends @message to the peer represented by @connection
+and blocks the calling thread until a reply is received or the
+timeout is reached. See g_dbus_connection_send_message_with_reply()
+for the asynchronous version of this method.
+
+Unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+will be assigned by @connection and set on @message via
+g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
+serial number used will be written to this location prior to
+submitting the message to the underlying transport.
+
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
+fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
+the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+
+Note that @error is only set if a local in-process error
+occured. That is to say that the returned #GDBusMessage object may
+be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
+g_dbus_message_to_gerror() to transcode this to a #GError.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags affecting how the message is sent.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds or -1 to use the default timeout.
+</parameter_description>
+</parameter>
+<parameter name="out_serial">
+<parameter_description> Return location for serial number assigned to @message when sending it 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> A #GDBusMessage that is the reply to @message or %NULL if @error is set.
+
+</return>
+</function>
+
<function name="g_file_info_get_attribute_byte_string">
<description>
Gets the value of a byte string attribute. If the attribute does
@@ -11568,7 +15089,7 @@ not contain a byte string, %NULL will be returned.
Reads an unsigned 64-bit/8-byte value from @stream.
In order to get the correct byte order for this read operation,
-see g_data_stream_get_byte_order().
+see g_data_input_stream_get_byte_order().
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
@@ -11595,21 +15116,55 @@ an error occurred.
</return>
</function>
-<function name="g_emblemed_icon_get_emblems">
+<function name="g_socket_get_credentials">
<description>
-Gets the list of emblems for the @icon.
+Returns the credentials of the foreign process connected to this
+socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX
+sockets).
-Since: 2.18
+If this operation isn't supported on the OS, the method fails with
+the %G_IO_ERROR_NOT_SUPPORTED error. On Linux this is implemented
+by reading the %SO_PEERCRED option on the underlying socket.
+
+Other ways to obtain credentials from a foreign peer includes the
+#GUnixCredentialsMessage type and
+g_unix_connection_send_credentials() /
+g_unix_connection_receive_credentials() functions.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="emblemed">
-<parameter_description> a #GEmblemedIcon
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GEmblem <!-- -->s that is owned by @emblemed
+<return> %NULL if @error is set, otherwise a #GCredentials object
+that must be freed with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_output_stream_get_etag">
+<description>
+Gets the entity tag for the file when it has been written.
+This must be called after the stream has been written
+and closed, as the etag can change while writing.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the entity tag for the stream.
</return>
</function>
@@ -11887,6 +15442,25 @@ Puts a signed 32-bit integer into the output stream.
</return>
</function>
+<function name="g_volume_monitor_get_volumes">
+<description>
+Gets a list of the volumes on the system.
+
+The returned list should be freed with g_list_free(), after
+its elements have been unreffed with g_object_unref().
+
+
+</description>
+<parameters>
+<parameter name="volume_monitor">
+<parameter_description> a #GVolumeMonitor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GVolume objects.
+</return>
+</function>
+
<function name="g_data_input_stream_get_byte_order">
<description>
Gets the byte order for the data input stream.
@@ -11903,6 +15477,24 @@ Gets the byte order for the data input stream.
</return>
</function>
+<function name="g_content_type_is_unknown">
+<description>
+Checks if the content type is the generic "unknown" type.
+On UNIX this is the "application/octet-stream" mimetype,
+while on win32 it is "*".
+
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> a content type string
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the type is the unknown type.
+</return>
+</function>
+
<function name="g_file_set_attribute_int64">
<description>
Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value.
@@ -12106,6 +15698,43 @@ Since: 2.24
</return>
</function>
+<function name="g_dbus_proxy_get_connection">
+<description>
+Gets the connection @proxy is for.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusConnection owned by @proxy. Do not free.
+
+</return>
+</function>
+
+<function name="g_permission_get_can_release">
+<description>
+Gets the value of the 'can-release' property. This property is %TRUE
+if it is generally possible to release the permission by calling
+g_permission_release().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the 'can-release' property
+</return>
+</function>
+
<function name="g_volume_get_activation_root">
<description>
Gets the activation root for a #GVolume if it is known ahead of
@@ -12200,6 +15829,35 @@ g_memory_output_stream_get_data_size().
</return>
</function>
+<function name="g_content_type_guess_for_tree">
+<description>
+Tries to guess the type of the tree with root @root, by
+looking at the files it contains. The result is an array
+of content types, with the best guess coming first.
+
+The types returned all have the form x-content/foo, e.g.
+x-content/audio-cdda (for audio CDs) or x-content/image-dcf
+(for a camera memory card). See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
+specification for more on x-content types.
+
+This function is useful in the implementation of
+g_mount_guess_content_type().
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="root">
+<parameter_description> the root of the tree to guess a type for
+</parameter_description>
+</parameter>
+</parameters>
+<return> an %NULL-terminated array of zero or more content types,
+or %NULL. Free with g_strfreev()
+
+</return>
+</function>
+
<function name="g_unix_mount_is_system_internal">
<description>
Checks if a unix mount is a system path.
@@ -12216,26 +15874,38 @@ Checks if a unix mount is a system path.
</return>
</function>
-<function name="g_vfs_get_default">
+<function name="g_application_run">
<description>
-Gets the default #GVfs for the system.
+Starts the application.
+The default implementation of this virtual function will simply run
+a main loop.
+
+It is an error to call this function if @application is a proxy for
+a remote application.
+
+Since: 2.26
</description>
<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GVfs.
-</return>
+<return></return>
</function>
-<function name="missing_add">
+<function name="g_vfs_get_default">
<description>
-Unsafe, need lock fen_lock.
+Gets the default #GVfs for the system.
+
</description>
<parameters>
</parameters>
-<return></return>
+<return> a #GVfs.
+</return>
</function>
<function name="g_socket_service_new">
@@ -12402,6 +16072,26 @@ Sets an error within the asynchronous result without a #GError.
<return></return>
</function>
+<function name="g_dbus_connection_get_guid">
+<description>
+The GUID of the peer performing the role of server when
+authenticating. See #GDBusConnection:guid for more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The GUID. Do not free this string, it is owned by
+ connection
+
+</return>
+</function>
+
<function name="g_socket_connection_factory_register_type">
<description>
Looks up the #GType to be used when creating socket connections on
@@ -12433,6 +16123,42 @@ Since: 2.22
<return></return>
</function>
+<function name="g_volume_mount">
+<description>
+Mounts a volume. This is an asynchronous operation, and is
+finished by calling g_volume_mount_finish() with the @volume
+and #GAsyncResult returned in the @callback.
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> a #GVolume.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data that gets passed to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_control_message_deserialize">
<description>
Tries to deserialize a socket control message of a given
@@ -12638,9 +16364,9 @@ Sets @key in @settings to @value.
A convenience function that combines g_settings_set_value() with
g_variant_new().
-It is a programmer error to pass a @key that isn't valid for
- settings or a @format that doesn't match the type of @key according
-to the schema of @settings.
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or for the #GVariantType of @format to mismatch
+the type given in the schema.
Since: 2.26
@@ -12668,113 +16394,68 @@ Since: 2.26
</return>
</function>
-<function name="g_settings_get_value">
+<function name="g_dbus_proxy_get_object_path">
<description>
-Gets the value that is stored in @settings for @key.
-
-It is a programmer error to give a @key that isn't valid for
- settings
+Gets the object path @proxy is for.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GVariant
+<return> A string owned by @proxy. Do not free.
+
</return>
</function>
-<function name="g_socket_listener_accept">
+<function name="g_settings_get_value">
<description>
-Blocks waiting for a client to connect to any of the sockets added
-to the listener. Returns a #GSocketConnection for the socket that was
-accepted.
-
-If @source_object is not %NULL it will be filled out with the source
-object specified when the corresponding socket or address was added
-to the listener.
+Gets the value that is stored in @settings for @key.
-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.
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="source_object">
-<parameter_description> location where #GObject pointer will be stored, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="settings">
+<parameter_description> a #GSettings object
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="key">
+<parameter_description> the key to get the value for
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
+<return> a new #GVariant
</return>
</function>
-<function name="g_async_initable_new_async">
+<function name="g_dbus_method_invocation_return_dbus_error">
<description>
-Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_new() but also initializes the object asynchronously.
+Finishes handling a D-Bus method call by returning an error.
-When the initialization is finished, @callback will be called. You can
-then call g_async_initable_new_finish() to get the new object and check
-for any errors.
+This method will free @invocation, you cannot use it afterwards.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GAsyncInitable.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the operation.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</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 initialization is
-finished
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
-</parameter_description>
-</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of the first property, or %NULL if no
-properties
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> the value of the first property, followed by other property
-value pairs, and ended by %NULL.
+<parameter name="error_message">
+<parameter_description> A valid D-Bus error message.
</parameter_description>
</parameter>
</parameters>
@@ -12854,11 +16535,11 @@ Compares two content types for equality.
</description>
<parameters>
<parameter name="type1">
-<parameter_description> a content type string.
+<parameter_description> a content type string
</parameter_description>
</parameter>
<parameter name="type2">
-<parameter_description> a content type string.
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
@@ -12956,9 +16637,9 @@ Free the returned object with g_object_unref().
<description>
Sets @key in @settings to @value.
-It is a programmer error to give a @key that isn't valid for
- settings It is a programmer error to give a @value of the
-incorrect type.
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or for @value to have the incorrect type, per
+the schema.
If @value is floating then this function consumes the reference.
@@ -13049,6 +16730,26 @@ Since: 2.22
</return>
</function>
+<function name="g_threaded_socket_service_new">
+<description>
+Creates a new #GThreadedSocketService with no listeners. Listeners
+must be added with g_socket_service_add_listeners().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="max_threads">
+<parameter_description> the maximal number of threads to execute concurrently
+handling incoming clients, -1 means no limit
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSocketService.
+
+</return>
+</function>
+
<function name="g_socket_set_timeout">
<description>
Sets the time in seconds after which I/O operations on @socket will
@@ -13275,8 +16976,8 @@ Sets @key in @settings to @value.
A convenience variant of g_settings_set() for doubles.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type double.
+It is a programmer error to give a @key that isn't specified as
+having a 'double' type in the schema for @settings.
Since: 2.26
@@ -13300,21 +17001,34 @@ Since: 2.26
</return>
</function>
-<function name="g_content_type_is_unknown">
+<function name="g_dbus_error_register_error">
<description>
-Checks if the content type is the generic "unknown" type.
-On unix this is the "application/octet-stream" mimetype,
-while on win32 it is "*".
+Creates an association to map between @dbus_error_name and
+#GError<!-- -->s specified by @error_domain and @error_code.
+This is typically done in the routine that returns the #GQuark for
+an error domain.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string.
+<parameter name="error_domain">
+<parameter_description> A #GQuark for a error domain.
+</parameter_description>
+</parameter>
+<parameter name="error_code">
+<parameter_description> An error code.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_name">
+<parameter_description> A D-Bus error name.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the type is the unknown type.
+<return> %TRUE if the association was created, %FALSE if it already
+exists.
+
</return>
</function>
@@ -13372,6 +17086,51 @@ or %NULL if there is none.
</return>
</function>
+<function name="g_permission_release_async">
+<description>
+Attempts to release the permission represented by @permission.
+
+This is the first half of the asynchronous version of
+g_permission_release().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> the #GAsyncReadyCallback to call when done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_clear_pending">
+<description>
+Clears the pending flag on @stream.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> output stream
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_replace_async">
<description>
Asynchronously overwrites the file, replacing the contents, possibly
@@ -13423,6 +17182,34 @@ of the request.
<return></return>
</function>
+<function name="g_tcp_connection_set_graceful_disconnect">
+<description>
+This enabled graceful disconnects on close. A graceful disconnect
+means that we signal the recieving end that the connection is terminated
+and wait for it to close the connection before closing the connection.
+
+A graceful disconnect means that we can be sure that we successfully sent
+all the outstanding data to the other end, or get an error reported.
+However, it also means we have to wait for all the data to reach the
+other side and for it to acknowledge this by closing the socket, which may
+take a while. For this reason it is disabled by default.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GTcpConnection
+</parameter_description>
+</parameter>
+<parameter name="graceful_disconnect">
+<parameter_description> Whether to do graceful disconnects or not
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_data_output_stream_set_byte_order">
<description>
Sets the byte order of the data output stream to @order.
@@ -13488,14 +17275,41 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_connection_flush_finish">
+<description>
+Finishes an operation started with g_dbus_connection_flush().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_flush().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation succeeded, %FALSE if @error is set.
+
+</return>
+</function>
+
<function name="g_settings_set_strv">
<description>
Sets @key in @settings to @value.
-A convenience variant of g_settings_set() for string arrays.
+A convenience variant of g_settings_set() for string arrays. If
+ value is %NULL, then @key is set to be the empty array.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type 'string array'.
+It is a programmer error to give a @key that isn't specified as
+having an array of strings type in the schema for @settings.
Since: 2.26
@@ -13510,7 +17324,7 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> the value to set it to
+<parameter_description> the value to set it to, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -13519,6 +17333,41 @@ Since: 2.26
</return>
</function>
+<function name="g_dbus_method_invocation_return_error_valist">
+<description>
+Like g_dbus_method_invocation_return_error() but intended for
+language bindings.
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> A #GQuark for the #GError error domain.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> The error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> #va_list of parameters for @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_list_attributes">
<description>
Lists the file info structure's attributes.
@@ -13559,6 +17408,22 @@ Sets a default choice for the mount operation.
<return></return>
</function>
+<function name="g_unix_mount_point_is_readonly">
+<description>
+Checks if a unix mount point is read only.
+
+
+</description>
+<parameters>
+<parameter name="mount_point">
+<parameter_description> a #GUnixMountPoint.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if a mount point is read only.
+</return>
+</function>
+
<function name="g_mount_operation_get_anonymous">
<description>
Check to see whether the mount operation is being used
@@ -13592,6 +17457,16 @@ Gets the mount path for a unix mount point.
</return>
</function>
+<function name="fen_init">
+<description>
+FEN subsystem initializing.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mount_get_uuid">
<description>
Gets the UUID for the @mount. The reference is typically based on
@@ -13613,29 +17488,23 @@ when no longer needed.
</return>
</function>
-<function name="g_file_output_stream_query_info_finish">
+<function name="g_settings_revert">
<description>
-Finalizes the asynchronous query started
-by g_file_output_stream_query_info_async().
+Reverts all non-applied changes to the settings. This function
+does nothing unless @settings is in 'delay-apply' mode; see
+g_settings_delay(). In the normal case settings are always applied
+immediately.
+Change notifications will be emitted for affected keys.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="settings">
+<parameter_description> a #GSettings instance
</parameter_description>
</parameter>
</parameters>
-<return> A #GFileInfo for the finished query.
-</return>
+<return></return>
</function>
<function name="g_socket_is_connected">
@@ -13744,7 +17613,7 @@ Free the returned object with g_object_unref().
<function name="g_buffered_input_stream_fill">
<description>
-Tries to read @count bytes from the stream into the buffer.
+Tries to read @count bytes from the stream into the buffer.
Will block during this read.
If @count is zero, returns zero and does nothing. A value of @count
@@ -13766,30 +17635,30 @@ partial result will be returned, without an error.
On error -1 is returned and @error is set accordingly.
-For the asynchronous, non-blocking, version of this function, see
+For the asynchronous, non-blocking, version of this function, see
g_buffered_input_stream_fill_async().
</description>
<parameters>
<parameter name="stream">
-<parameter_description> #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream.
+<parameter_description> the number of bytes that will be read from the stream
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore.
+<parameter_description> location to store the error occuring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes read into @stream's buffer, up to @count,
+<return> the number of bytes read into @stream's buffer, up to @count,
or -1 on error.
</return>
</function>
@@ -13817,6 +17686,76 @@ Since: 2.26
<return></return>
</function>
+<function name="g_dbus_proxy_new">
+<description>
+Creates a proxy for accessing @interface_name on the remote object
+at @object_path owned by @name at @connection and asynchronously
+loads D-Bus properties unless the
+#G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to
+the #GDBusProxy::g-properties-changed signal to get notified about
+property changes.
+
+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 @name is a well-known name and the
+#G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
+owner currently exists, the message bus will be requested to launch
+a name owner for the name.
+
+This is a failable asynchronous constructor - when the proxy is
+ready, @callback will be invoked and you can use
+g_dbus_proxy_new_finish() to get the result.
+
+See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
+</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="interface_name">
+<parameter_description> A D-Bus interface name.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> Callback function to invoke when the proxy is ready.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_unix_mount_point_free">
<description>
Frees a unix mount point.
@@ -13831,6 +17770,80 @@ Frees a unix mount point.
<return></return>
</function>
+<function name="g_dbus_error_set_dbus_error_valist">
+<description>
+Like g_dbus_error_set_dbus_error() but intended for language bindings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> A pointer to a #GError or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_name">
+<parameter_description> D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_message">
+<parameter_description> D-Bus error message.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format to prepend to @dbus_error_message or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> Arguments for @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_attribute_info_list_lookup">
+<description>
+Gets the file attribute with the name @name from @list.
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the attribute to lookup.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeInfo for the @name, or %NULL if an
+attribute isn't found.
+</return>
+</function>
+
+<function name="g_dbus_connection_get_exit_on_close">
+<description>
+Gets whether the process is terminated when @connection is
+closed by the remote peer. See
+#GDBusConnection:exit-on-close for more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Whether the process is terminated when @connection is
+closed by the remote peer.
+
+</return>
+</function>
+
<function name="g_drive_start">
<description>
Asynchronously starts a drive.
@@ -13871,22 +17884,21 @@ Since: 2.22
<return></return>
</function>
-<function name="g_io_extension_get_name">
+<function name="g_unix_credentials_message_new_with_credentials">
<description>
-Gets the name under which @extension was registered.
-
-Note that the same type may be registered as extension
-for multiple extension points, under different names.
+Creates a new #GUnixCredentialsMessage holding @credentials.
+Since: 2.26
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="credentials">
+<parameter_description> A #GCredentials object.
</parameter_description>
</parameter>
</parameters>
-<return> the name of @extension.
+<return> a new #GUnixCredentialsMessage
+
</return>
</function>
@@ -13941,62 +17953,110 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_socket_listener_add_address">
+<function name="g_file_read_async">
<description>
-Creates a socket of type @type and protocol @protocol, binds
-it to @address and adds it to the set of sockets we're accepting
-sockets from.
-
-Note that adding an IPv6 address, depending on the platform,
-may or may not result in a listener that also accepts IPv4
-connections. For more determinstic behaviour, see
-g_socket_listener_add_inet_port().
-
- source_object will be passed out in the various calls
-to accept to identify this particular source, which is
-useful if you're listening on multiple addresses and do
-different things depending on what address is connected to.
+Asynchronously opens @file for reading.
-If successful and @effective_address is non-%NULL then it will
-be set to the address that the binding actually occured at. This
-is helpful for determining the port number that was used for when
-requesting a binding to port 0 (ie: "any port"). This address, if
-requested, belongs to the caller and must be freed.
+For more details, see g_file_read() which is
+the synchronous version of this call.
-Since: 2.22
+When the operation is finished, @callback will be called. You can then call
+g_file_read_finish() to get the result of the operation.
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="file">
+<parameter_description> input #GFile
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddress
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> a #GSocketType
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="protocol">
-<parameter_description> a #GSocketProtocol
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
-<parameter name="effective_address">
-<parameter_description> location to store the address that was bound to, or %NULL.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_method_invocation_get_object_path">
+<description>
+Gets the object path the method was invoked on.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A string. Do not free, it is owned by @invocation.
+
+</return>
+</function>
+
+<function name="g_dbus_message_new_from_blob">
+<description>
+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().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="blob">
+<parameter_description> A blob represent a binary D-Bus message.
+</parameter_description>
+</parameter>
+<parameter name="blob_len">
+<parameter_description> The length of @blob.
+</parameter_description>
+</parameter>
+<parameter name="capabilities">
+<parameter_description> A #GDBusCapabilityFlags describing what protocol features are supported.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> A new #GDBusMessage or %NULL if @error is set. Free with
+g_object_unref().
+
+</return>
+</function>
+
+<function name="g_io_stream_get_output_stream">
+<description>
+Gets the output stream for this object. This is used for
+writing.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GOutputStream, owned by the #GIOStream.
+Do not free.
</return>
</function>
@@ -14006,7 +18066,7 @@ Since: 2.22
Reads a signed 32-bit/4-byte value from @stream.
In order to get the correct byte order for this read operation,
-see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
@@ -14096,46 +18156,49 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_file_mount_enclosing_volume">
+<function name="g_socket_receive_from">
<description>
-Starts a @mount_operation, mounting the volume that contains the file @location.
+Receive data (up to @size bytes) from a socket.
-When this operation has completed, @callback will be called with
- user_user data, and the operation can be finalized with
-g_file_mount_enclosing_volume_finish().
+If @address is non-%NULL then @address will be set equal to the
+source address of the received packet.
+ address is owned by the caller.
-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.
+See g_socket_receive() for additional information.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="location">
-<parameter_description> input #GFile.
+<parameter name="socket">
+<parameter_description> a #GSocket
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter name="address">
+<parameter_description> a pointer to a #GSocketAddress pointer, or %NULL
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="size">
+<parameter_description> the number of bytes you want to read from the socket
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> Number of bytes read, or -1 on error
+
+</return>
</function>
<function name="g_seekable_can_seek">
@@ -14201,6 +18264,51 @@ if possible.
<return></return>
</function>
+<function name="g_dbus_message_get_flags">
+<description>
+Gets the flags for @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).
+
+</return>
+</function>
+
+<function name="g_volume_eject_finish">
+<description>
+Finishes ejecting a volume. If any errors occured during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+Deprecated: 2.22: Use g_volume_eject_with_operation_finish() instead.
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> pointer to a #GVolume.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store an error, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, %FALSE if operation failed.
+
+</return>
+</function>
+
<function name="g_file_replace">
<description>
Returns an output stream for overwriting the file, possibly
@@ -14279,6 +18387,24 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_dbus_arg_info_unref">
+<description>
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusArgInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gvdb_table_new">
<description>
Creates a new #GvdbTable from the contents of the file found at
@@ -14370,6 +18496,73 @@ all keys in the unix namespace.</entry></row>
</return>
</function>
+<function name="g_dbus_connection_new_for_address_sync">
+<description>
+Synchronously connects and sets up a D-Bus client connection for
+exchanging D-Bus messages with an endpoint specified by @address
+which must be in the D-Bus address format.
+
+This constructor can only be used to initiate client-side
+connections - use g_dbus_connection_new_sync() if you need to act
+as the server. In particular, @flags cannot contain the
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
+
+This is a synchronous failable constructor. See
+g_dbus_connection_new_for_address() for the asynchronous version.
+
+If @observer is not %NULL it may be used to control the
+authentication process.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> A D-Bus address.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver 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> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_resolver_free_addresses">
+<description>
+Frees @addresses (which should be the return value from
+g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
+(This is a convenience method; you can also simply free the results
+by hand.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="addresses">
+<parameter_description> a #GList of #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_condition_check">
<description>
Checks on the readiness of @socket to perform operations.
@@ -14377,6 +18570,14 @@ The operations specified in @condition are checked for and masked
against the currently-satisfied conditions on @socket. The result
is returned.
+Note that on Windows, it is possible for an operation to return
+%G_IO_ERROR_WOULD_BLOCK even immediately after
+g_socket_condition_check() has claimed that the socket is ready for
+writing. Rather than calling g_socket_condition_check() and then
+writing to the socket if it succeeds, it is generally better to
+simply try writing to the socket right away, and try again later if
+the initial attempt returns %G_IO_ERROR_WOULD_BLOCK.
+
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
these conditions will always be set in the output if they are true.
@@ -14400,6 +18601,165 @@ Since: 2.22
</return>
</function>
+<function name="g_file_output_stream_query_info_finish">
+<description>
+Finalizes the asynchronous query started
+by g_file_output_stream_query_info_async().
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GFileInfo for the finished query.
+</return>
+</function>
+
+<function name="g_bus_unown_name">
+<description>
+Stops owning a name.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="owner_id">
+<parameter_description> An identifier obtained from g_bus_own_name()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_connection_new_for_address_finish">
+<description>
+Finishes an operation started with g_dbus_connection_new_for_address().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_dbus_proxy_get_interface_info">
+<description>
+Returns the #GDBusInterfaceInfo, if any, specifying the minimal
+interface that @proxy conforms to.
+
+See the #GDBusProxy:g-interface-info property for more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusInterfaceInfo or %NULL. Do not unref the returned
+object, it is owned by @proxy.
+
+</return>
+</function>
+
+<function name="g_unix_connection_receive_credentials">
+<description>
+Receives credentials from the sending end of the connection. The
+sending end has to call g_unix_connection_send_credentials() (or
+similar) for this to work.
+
+As well as reading the credentials this also reads (and discards) a
+single byte from the stream, as this is required for credentials
+passing to work on some implementations.
+
+Other ways to exchange credentials with a foreign peer includes the
+#GUnixCredentialsMessage type and g_socket_get_credentials() function.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GUnixConnection.
+</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> Received credentials on success (free with
+g_object_unref()), %NULL if @error is set.
+
+</return>
+</function>
+
+<function name="g_dbus_method_invocation_get_connection">
+<description>
+Gets the #GDBusConnection the method was invoked on.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusConnection. Do not free, it is owned by @invocation.
+
+</return>
+</function>
+
+<function name="g_dbus_message_set_error_name">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_srv_target_get_hostname">
<description>
Gets @target's hostname (in ASCII form; if you are going to present
@@ -14434,45 +18794,30 @@ The list is sorted by priority, beginning with the highest priority.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GIOExtension<!-- -->s. The list is owned by
-GIO and should not be modified
+<return> a #GList of
+#GIOExtension<!-- -->s. The list is owned by GIO and should not be
+modified.
</return>
</function>
-<function name="g_volume_mount">
+<function name="g_dbus_error_is_remote_error">
<description>
-Mounts a volume. This is an asynchronous operation, and is
-finished by calling g_volume_mount_finish() with the @volume
-and #GAsyncResult returned in the @callback.
+Checks if @error represents an error received via D-Bus from a remote peer. If so,
+use g_dbus_error_get_remote_error() to get the name of the error.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data that gets passed to @callback
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @error represents an error from a remote peer,
+%FALSE otherwise.
+
+</return>
</function>
<function name="g_io_extension_point_implement">
@@ -14524,6 +18869,78 @@ no more attribute exist.
</return>
</function>
+<function name="g_dbus_proxy_set_interface_info">
+<description>
+Ensure that interactions with @proxy conform to the given
+interface. For example, when completing a method call, if the type
+signature of the message isn't what's expected, the given #GError
+is set. Signals that have a type signature mismatch are simply
+dropped.
+
+See the #GDBusProxy:g-interface-info property for more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> Minimum interface this proxy conforms to or %NULL to unset.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_method_invocation_return_error">
+<description>
+Finishes handling a D-Bus method call by returning an error.
+
+See g_dbus_error_encode_gerror() for details about what error name
+will be returned on the wire. In a nutshell, if the given error is
+registered using g_dbus_error_register_error() the name given
+during registration is used. Otherwise, a name of the form
+<literal>org.gtk.GDBus.UnmappedGError.Quark...</literal> is
+used. This provides transparent mapping of #GError between
+applications using GDBus.
+
+If you are writing an application intended to be portable,
+<emphasis>always</emphasis> register errors with g_dbus_error_register_error()
+or use g_dbus_method_invocation_return_dbus_error().
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> A #GQuark for the #GError error domain.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> The error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> Parameters for @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_inet_address_new_from_string">
<description>
Parses @string as an IP address and creates a new #GInetAddress.
@@ -14564,27 +18981,6 @@ Gets the attribute type for an attribute key.
</return>
</function>
-<function name="g_file_attribute_info_list_lookup">
-<description>
-Gets the file attribute with the name @name from @list.
-
-
-</description>
-<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the attribute to lookup.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GFileAttributeInfo for the @name, or %NULL if an
-attribute isn't found.
-</return>
-</function>
-
<function name="g_app_info_get_id">
<description>
Gets the ID of an application. An id is a string that
@@ -14607,6 +19003,24 @@ the @appinfo has been constructed.
</return>
</function>
+<function name="g_dbus_message_get_destination">
+<description>
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value.
+
+</return>
+</function>
+
<function name="g_socket_client_connect_async">
<description>
This is the asynchronous version of g_socket_client_connect().
@@ -14729,95 +19143,94 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_settings_new_with_context">
+<function name="g_dbus_message_set_body">
<description>
-Creates a new #GSettings object with a given schema and context.
+Sets the body @message. As a side-effect the
+%G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the
+type string of @body (or cleared if @body is %NULL).
-Creating settings objects with a context allow accessing settings
-from a database other than the usual one. For example, it may make
-sense to specify "defaults" in order to get a settings object that
-modifies the system default settings instead of the settings for this
-user.
-
-It is a programmer error to call this function for an unsupported
-context. Use g_settings_supports_context() to determine if a context
-is supported if you are unsure.
+If @body is floating, @message assumes ownership of @body.
Since: 2.26
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="context">
-<parameter_description> the context to use
+<parameter name="body">
+<parameter_description> Either %NULL or a #GVariant that is a tuple.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
-</return>
+<return></return>
</function>
-<function name="g_memory_input_stream_add_data">
+<function name="g_application_is_remote">
<description>
-Appends @data to data that can be read from the input stream
+Returns whether the object represents a proxy for a remote application.
+
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GMemoryInputStream
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> input data
-</parameter_description>
-</parameter>
-<parameter name="len">
-<parameter_description> length of the data, may be -1 if @data is a nul-terminated string
-</parameter_description>
-</parameter>
-<parameter name="destroy">
-<parameter_description> function that is called to free @data, or %NULL
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if this object represents a proxy for a remote application.
+</return>
</function>
-<function name="g_io_stream_get_output_stream">
+<function name="g_content_type_get_description">
<description>
-Gets the output stream for this object. This is used for
-writing.
+Gets the human readable description of the content type.
-Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return> a #GOutputStream, owned by the #GIOStream. Do not free.
-
+<return> a short description of the content type @type. Free the
+returned string with g_free()
</return>
</function>
-<function name="g_content_type_get_description">
+<function name="g_file_enumerator_close_finish">
<description>
-Gets the human readable description of the content type.
+Finishes closing a file enumerator, started from g_file_enumerator_close_async().
+
+If the file enumerator was already closed when g_file_enumerator_close_async()
+was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
+return %FALSE. If the file enumerator had pending operation when the close
+operation was started, then this function will report %G_IO_ERROR_PENDING, and
+return %FALSE. If @cancellable was not %NULL, then the operation may have been
+cancelled by triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
+returned.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string.
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a short description of the content type @type.
+<return> %TRUE if the close operation has finished successfully.
</return>
</function>
@@ -14913,6 +19326,35 @@ Puts a signed 64-bit integer into the stream.
</return>
</function>
+<function name="g_permission_release_finish">
+<description>
+Collects the result of attempting to release the permission
+represented by @permission.
+
+This is the second half of the asynchronous version of
+g_permission_release().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult given to the #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully released
+</return>
+</function>
+
<function name="g_output_stream_close">
<description>
Closes the stream, releasing resources related to it.
@@ -15030,20 +19472,20 @@ appropriately if present.
</return>
</function>
-<function name="g_win32_output_stream_get_handle">
+<function name="g_dbus_message_get_num_unix_fds">
<description>
-Return the Windows handle that the stream writes to.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GWin32OutputStream
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> The handle descriptor of @stream
+<return> The value.
</return>
</function>
@@ -15090,8 +19532,8 @@ Gets the value that is stored at @key in @settings.
A convenience variant of g_settings_get() for strings.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type string.
+It is a programmer error to give a @key that isn't specified as
+having a string type in the schema for @settings.
Since: 2.26
@@ -15110,6 +19552,24 @@ Since: 2.26
</return>
</function>
+<function name="g_dbus_message_set_byte_order">
+<description>
+Sets the byte order of @message.
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="byte_order">
+<parameter_description> The byte order.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_volume_monitor_get_volume_for_uuid">
<description>
Finds a #GVolume object by its UUID (see g_volume_get_uuid())
@@ -15131,9 +19591,41 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_settings_set_enum">
+<description>
+Looks up the enumerated type nick for @value and writes it to @key,
+within @settings.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as an enumerated type, or for
+ value not to be a valid value for the named type.
+
+After performing the write, accessing @key directly with
+g_settings_get_string() will return the 'nick' associated with
+ value
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a key, within @settings
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> an enumerated value
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if the set succeeds
+</return>
+</function>
+
<function name="g_app_info_launch_uris">
<description>
-Launches the application. Passes @uris to the launched application
+Launches the application. Passes @uris to the launched application
as arguments, using the optional @launch_context to get information
about the details of the launcher (like what screen it is on).
On error, @error will be set accordingly.
@@ -15152,7 +19644,7 @@ no way to detect this.
</parameter_description>
</parameter>
<parameter name="uris">
-<parameter_description> a #GList containing URIs to launch.
+<parameter_description> a #GList containing URIs to launch.
</parameter_description>
</parameter>
<parameter name="launch_context">
@@ -15164,7 +19656,7 @@ no way to detect this.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful launch, %FALSE otherwise.
+<return> %TRUE on successful launch, %FALSE otherwise.
</return>
</function>
@@ -15299,8 +19791,8 @@ Gets the value that is stored at @key in @settings.
A convenience variant of g_settings_get() for booleans.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type boolean.
+It is a programmer error to give a @key that isn't specified as
+having a boolean type in the schema for @settings.
Since: 2.26
@@ -15319,46 +19811,54 @@ Since: 2.26
</return>
</function>
-<function name="g_socket_listener_accept_socket">
+<function name="g_settings_list_schemas">
<description>
-Blocks waiting for a client to connect to any of the sockets added
-to the listener. Returns the #GSocket that was accepted.
+Returns a list of GSettings schemas that are available. The list
+must not be modified or freed.
-If you want to accept the high-level #GSocketConnection, not a #GSocket,
-which is often the case, then you should use g_socket_listener_accept()
-instead.
+</description>
+<parameters>
+</parameters>
+<return> a list of the schemas installed on the system
+</return>
+</function>
-If @source_object is not %NULL it will be filled out with the source
-object specified when the corresponding socket or address was added
-to the listener.
+<function name="g_permission_release">
+<description>
+Attempts to release the permission represented by @permission.
-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.
+The precise method by which this happens depends on the permission
+and the underlying authentication mechanism. In most cases the
+permission will be dropped immediately without further action.
-Since: 2.22
+You should check with g_permission_get_can_release() before calling
+this function.
+
+If the permission is released then %TRUE is returned. Otherwise,
+%FALSE is returned and @error is set appropriately.
+
+This call is blocking, likely for a very long time (in the case that
+user interaction is required). See g_permission_release_async() for
+the non-blocking version.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="source_object">
-<parameter_description> location where #GObject pointer will be stored, or %NULL
+<parameter name="permission">
+<parameter_description> a #GPermission instance
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> a #GCancellable, or %NULL
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> a pointer to a %NULL #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocket on success, %NULL on error.
-
+<return> %TRUE if the permission was successfully released
</return>
</function>
@@ -15378,6 +19878,34 @@ the @matcher is automatically freed.
<return></return>
</function>
+<function name="g_dbus_error_encode_gerror">
+<description>
+Creates a D-Bus error name to use for @error. If @error matches
+a registered error (cf. g_dbus_error_register_error()), the corresponding
+D-Bus error name will be returned.
+
+Otherwise the a name of the form
+<literal>org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE</literal>
+will be used. This allows other GDBus applications to map the error
+on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
+
+This function is typically only used in object mappings to put a
+#GError on the wire. Regular applications should not use it.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> A #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A D-Bus error name (never %NULL). Free with g_free().
+
+</return>
+</function>
+
<function name="g_file_set_attribute_int32">
<description>
Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
@@ -15420,6 +19948,51 @@ in the @file, %FALSE otherwise.
</return>
</function>
+<function name="g_dbus_connection_new_sync">
+<description>
+Synchronously sets up a D-Bus connection for exchanging D-Bus messages
+with the end represented by @stream.
+
+If @observer is not %NULL it may be used to control the
+authentication process.
+
+This is a synchronous failable constructor. See
+g_dbus_connection_new() for the asynchronous version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GIOStream.
+</parameter_description>
+</parameter>
+<parameter name="guid">
+<parameter_description> The GUID to use if a authenticating as a server or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver 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> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_unix_mount_at">
<description>
Gets a #GUnixMountEntry for a given mount path. If @time_read
@@ -15458,6 +20031,98 @@ Gets a gssize from the asynchronous result.
</return>
</function>
+<function name="g_credentials_set_unix_user">
+<description>
+Tries to set the UNIX user identifier on @credentials. This method
+is only available on UNIX platforms.
+
+This operation can fail if #GCredentials is not supported on the
+OS or if the native credentials type does not contain information
+about the UNIX user.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="uid">
+<parameter_description> The UNIX user identifier to set.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @uid was set, %FALSE if error is set.
+
+</return>
+</function>
+
+<function name="g_drive_stop">
+<description>
+Asynchronously stops a drive.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_stop_finish() to obtain the
+result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for stopping.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, 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="g_dbus_message_set_flags">
+<description>
+Sets the flags to set on @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags for @message that are set (typically values from the #GDBusMessageFlags
+enumeration bitwise ORed together).
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_append_to_async">
<description>
Asynchronously opens @file for appending.
@@ -15570,6 +20235,22 @@ when no longer needed.
</return>
</function>
+<function name="g_dbus_message_get_byte_order">
+<description>
+Gets the byte order of @message.
+
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The byte order.
+</return>
+</function>
+
<function name="g_file_mount_mountable_finish">
<description>
Finishes a mount operation. See g_file_mount_mountable() for details.
@@ -15598,6 +20279,66 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_dbus_connection_emit_signal">
+<description>
+Emits a signal.
+
+If the parameters GVariant is floating, it is consumed.
+
+This can only fail if @parameters is not compatible with the D-Bus protocol.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="destination_bus_name">
+<parameter_description> The unique bus name for the destination for the signal or %NULL to emit to all listeners.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to emit a signal on.
+</parameter_description>
+</parameter>
+<parameter name="signal_name">
+<parameter_description> The name of the signal to emit.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE unless @error is set.
+
+</return>
+</function>
+
+<function name="g_resolver_error_quark">
+<description>
+Gets the #GResolver Error Quark.
+
+Since: 2.22
+
+</description>
+<parameters>
+</parameters>
+<return> a #GQuark.
+
+</return>
+</function>
+
<function name="g_drive_poll_for_media_finish">
<description>
Finishes an operation started with g_drive_poll_for_media() on a drive.
@@ -15623,6 +20364,62 @@ Finishes an operation started with g_drive_poll_for_media() on a drive.
</return>
</function>
+<function name="g_dbus_message_set_reply_serial">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_attribute_info_list_ref">
+<description>
+References a file attribute info list.
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList to reference.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileAttributeInfoList or %NULL on error.
+</return>
+</function>
+
+<function name="g_dbus_message_set_sender">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_monitor_emit_event">
<description>
Emits the #GFileMonitor::changed signal if a change
@@ -15655,6 +20452,78 @@ context</link>).
<return></return>
</function>
+<function name="g_dbus_proxy_call_sync">
+<description>
+Synchronously invokes the @method_name method on @proxy.
+
+If @method_name contains any dots, then @name is split into interface and
+method name parts. This allows using @proxy for invoking methods on
+other interfaces.
+
+If the #GDBusConnection associated with @proxy is disconnected then
+the operation will fail with %G_IO_ERROR_CLOSED. If
+ cancellable is canceled, the operation will fail with
+%G_IO_ERROR_CANCELLED. If @parameters contains a value not
+compatible with the D-Bus protocol, the operation fails with
+%G_IO_ERROR_INVALID_ARGUMENT.
+
+If the @parameters #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_proxy_call_sync (proxy,
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+&error);
+]|
+
+The calling thread is blocked until a reply is received. See
+g_dbus_proxy_call() for the asynchronous version of this
+method.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> Name of method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds or -1 to use the proxy default timeout.
+</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> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
+
+</return>
+</function>
+
<function name="g_volume_get_identifier">
<description>
Gets the identifier of the given kind for @volume.
@@ -15693,7 +20562,8 @@ Since: 2.22
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream, owned by the #GIOStream. Do not free.
+<return> a #GInputStream, owned by the #GIOStream.
+Do not free.
</return>
</function>
@@ -15737,6 +20607,24 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_message_get_signature">
+<description>
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value.
+
+</return>
+</function>
+
<function name="g_socket_listener_close">
<description>
Closes all the sockets in the listener.
@@ -15753,38 +20641,40 @@ Since: 2.22
<return></return>
</function>
-<function name="g_data_input_stream_read_line">
+<function name="g_application_get_id">
<description>
-Reads a line from the data input stream.
-
-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.
+Retrieves the platform-specific identifier for the #GApplication.
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in.
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting.
+</parameters>
+<return> The platform-specific identifier. The returned string
+is owned by the #GApplication instance and it should never be
+modified or freed
+
+</return>
+</function>
+
+<function name="g_io_extension_point_get_required_type">
+<description>
+Gets the required type for @extension_point.
+
+
+</description>
+<parameters>
+<parameter name="extension_point">
+<parameter_description> a #GIOExtensionPoint
</parameter_description>
</parameter>
</parameters>
-<return> a string with the line that was read in (without the newlines).
-Set @length to a #gsize to get the length of the read line.
-On an error, it will return %NULL and @error will be set. If there's no
-content to read, it will still return %NULL, but @error won't be set.
+<return> the #GType that all implementations must have,
+or #G_TYPE_INVALID if the extension point has no required type
</return>
</function>
@@ -15836,6 +20726,48 @@ Since: 2.22
<return></return>
</function>
+<function name="g_io_modules_load_all_in_directory">
+<description>
+Loads all the modules in the specified directory.
+
+If don't require all modules to be initialized (and thus registering
+all gtypes) then you can use g_io_modules_scan_all_in_directory()
+which allows delayed/lazy loading of modules.
+
+
+</description>
+<parameters>
+<parameter name="dirname">
+<parameter_description> pathname for a directory containing modules to load.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a list of #GIOModules loaded from the directory,
+All the modules are loaded into memory, if you want to
+unload them (enabling on-demand loading) you must call
+g_type_module_unuse() on all the modules. Free the list
+with g_list_free().
+</return>
+</function>
+
+<function name="g_dbus_connection_is_closed">
+<description>
+Gets whether @connection is closed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the connection is closed, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_file_info_set_attribute_mask">
<description>
Sets @mask on @info to match specific attribute types.
@@ -15888,6 +20820,24 @@ Deprecated: 2.22: Use g_mount_unmount_with_operation() instead.
<return></return>
</function>
+<function name="g_dbus_is_member_name">
+<description>
+Checks if @string is a valid D-Bus member (e.g. signal or method) name.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> The string to check.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if valid, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_file_query_default_handler">
<description>
Returns the #GAppInfo that is registered as the default
@@ -15985,19 +20935,19 @@ See %G_FILE_ATTRIBUTE_STANDARD_ICON.
<return></return>
</function>
-<function name="g_file_attribute_info_list_dup">
+<function name="g_io_extension_get_priority">
<description>
-Makes a duplicate of a file attribute info list.
+Gets the priority with which @extension was registered.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList to duplicate.
+<parameter name="extension">
+<parameter_description> a #GIOExtension
</parameter_description>
</parameter>
</parameters>
-<return> a copy of the given @list.
+<return> the priority of @extension
</return>
</function>
@@ -16100,35 +21050,18 @@ Tells the current position within the stream.
</return>
</function>
-<function name="g_settings_backend_setup_keyfile">
+<function name="g_dbus_interface_info_unref">
<description>
-Sets up a keyfile for use with #GSettings.
-
-If you create a #GSettings with its context property set to @context
-then the settings will be stored in the keyfile at @filename. See
-g_settings_new_with_context().
-
-The keyfile must be setup before any settings objects are created
-for the named context.
-
-It is not possible to specify a keyfile for the default context.
-
-If the path leading up to @filename does not exist, it will be
-recursively created with user-only permissions. If the keyfile is
-not writable, any #GSettings objects created using @context will
-return %FALSE for any calls to g_settings_is_writable() and any
-attempts to write will fail.
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
Since: 2.26
</description>
<parameters>
-<parameter name="context">
-<parameter_description> a context string (not %NULL or "")
-</parameter_description>
-</parameter>
-<parameter name="filename">
-<parameter_description> a filename
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
</parameter_description>
</parameter>
</parameters>
@@ -16173,6 +21106,35 @@ the application startup notification started in g_app_launch_context_get_startup
<return></return>
</function>
+<function name="g_cancellable_get_fd">
+<description>
+Gets the file descriptor for a cancellable job. This can be used to
+implement cancellable operations on Unix systems. The returned fd will
+turn readable when @cancellable is cancelled.
+
+You are not supposed to read from the fd yourself, just check for
+readable status. Reading to unset the readable status is done
+with g_cancellable_reset().
+
+After a successful return from this function, you should use
+g_cancellable_release_fd() to free up resources allocated for
+the returned file descriptor.
+
+See also g_cancellable_make_pollfd().
+
+
+</description>
+<parameters>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A valid file descriptor. %-1 if the file descriptor
+is not supported, or on errors.
+</return>
+</function>
+
<function name="g_cancellable_connect">
<description>
Convenience function to connect to the #GCancellable::cancelled
@@ -16253,23 +21215,53 @@ Since: 2.22
</return>
</function>
-<function name="g_io_extension_point_set_required_type">
+<function name="g_output_stream_flush_finish">
<description>
-Sets the required type for @extension_point to @type.
-All implementations must henceforth have this type.
+Finishes flushing an output stream.
+
</description>
<parameters>
-<parameter name="extension_point">
-<parameter_description> a #GIOExtensionPoint
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> the #GType to require
+<parameter name="result">
+<parameter_description> a GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if flush operation suceeded, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_dbus_interface_info_lookup_property">
+<description>
+Looks up information about a property.
+
+This cost of this function is O(n) in number of properties.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A D-Bus property name (typically in CamelCase).
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
+
+</return>
</function>
<function name="g_network_address_new">
@@ -16330,20 +21322,40 @@ Sets the operation result within the asynchronous result to a pointer.
<return></return>
</function>
+<function name="g_dbus_message_set_member">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_buffered_input_stream_set_buffer_size">
<description>
-Sets the size of the internal buffer of @stream to @size, or to the
-size of the contents of the buffer. The buffer can never be resized
+Sets the size of the internal buffer of @stream to @size, or to the
+size of the contents of the buffer. The buffer can never be resized
smaller than its current contents.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a #gsize.
+<parameter_description> a #gsize
</parameter_description>
</parameter>
</parameters>
@@ -16390,6 +21402,26 @@ Gets the device path for a unix mount.
</return>
</function>
+<function name="g_app_info_get_display_name">
+<description>
+Gets the display name of the application. The display name is often more
+descriptive to the user than the name itself.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the display name of the application for @appinfo, or the name if
+no display name is available.
+
+</return>
+</function>
+
<function name="g_file_info_set_is_hidden">
<description>
Sets the "is_hidden" attribute in a #GFileInfo according to @is_symlink.
@@ -16506,18 +21538,18 @@ Creates a new themed icon for @iconnames.
<function name="g_buffered_input_stream_new_sized">
<description>
-Creates a new #GBufferedInputStream from the given @base_stream,
+Creates a new #GBufferedInputStream from the given @base_stream,
with a buffer set to @size.
</description>
<parameters>
<parameter name="base_stream">
-<parameter_description> a #GInputStream.
+<parameter_description> a #GInputStream
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a #gsize.
+<parameter_description> a #gsize
</parameter_description>
</parameter>
</parameters>
@@ -16525,6 +21557,28 @@ with a buffer set to @size.
</return>
</function>
+<function name="g_socket_listener_set_backlog">
+<description>
+Sets the listen backlog on the sockets in the listener.
+
+See g_socket_set_listen_backlog() for details
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="listen_backlog">
+<parameter_description> an integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_buffered_input_stream_fill_finish">
<description>
Finishes an asynchronous read.
@@ -16533,63 +21587,78 @@ Finishes an asynchronous read.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GBufferedInputStream.
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter_description> a #GAsyncResult
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize of the read stream, or %-1 on an error.
+<return> a #gssize of the read stream, or %-1 on an error.
</return>
</function>
-<function name="g_socket_receive_from">
+<function name="g_file_mount_enclosing_volume">
<description>
-Receive data (up to @size bytes) from a socket.
-
-If @address is non-%NULL then @address will be set equal to the
-source address of the received packet.
- address is owned by the caller.
+Starts a @mount_operation, mounting the volume that contains the file @location.
-See g_socket_receive() for additional information.
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_mount_enclosing_volume_finish().
-Since: 2.22
+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.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="location">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a pointer to a #GSocketAddress pointer, or %NULL
+<parameter name="flags">
+<parameter_description> flags affecting the operation
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
-bytes long).
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes you want to read from the socket
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return></return>
+</function>
+
+<function name="g_dbus_server_get_flags">
+<description>
+Gets the flags for @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A set of flags from the #GDBusServerFlags enumeration.
</return>
</function>
@@ -16641,10 +21710,10 @@ Gets the requested information about the files in a directory. The result
is a #GFileEnumerator object that will give out #GFileInfo objects for
all the files in the directory.
-The @attribute value is a string that specifies the file attributes that
+The @attributes value is a string that specifies the file attributes that
should be gathered. It is not an error if it's not possible to read a particular
-requested attribute from a file - it just won't be set. @attribute should
-be a comma-separated list of attribute or attribute wildcards. The wildcard "*"
+requested attribute from a file - it just won't be set. @attributes should
+be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
means all attributes, and a wildcard like "standard::*" means all attributes in the standard
namespace. An example attribute query be "standard::*,owner::user".
The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
@@ -16735,18 +21804,22 @@ Since: 2.20
<return></return>
</function>
-<function name="g_output_stream_clear_pending">
+<function name="g_dbus_proxy_get_name">
<description>
-Clears the pending flag on @stream.
+Gets the name that @proxy was constructed for.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> output stream
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A string owned by @proxy. Do not free.
+
+</return>
</function>
<function name="g_file_info_get_name">
@@ -16770,7 +21843,7 @@ Gets the name for a file.
Reads a 64-bit/8-byte value from @stream.
In order to get the correct byte order for this read operation,
-see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
@@ -16883,6 +21956,25 @@ poll for changes.
<return></return>
</function>
+<function name="g_io_extension_get_name">
+<description>
+Gets the name under which @extension was registered.
+
+Note that the same type may be registered as extension
+for multiple extension points, under different names.
+
+
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of @extension.
+</return>
+</function>
+
<function name="g_socket_get_remote_address">
<description>
Try to get the remove address of a connected socket. This is only
@@ -16953,12 +22045,90 @@ Gets the filesystem type for the unix mount.
</return>
</function>
+<function name="g_dbus_message_new_method_reply">
+<description>
+Creates a new #GDBusMessage that is a reply to @method_call_message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_settings_get_flags">
+<description>
+Gets the value that is stored in @settings for @key and converts it
+to the flags value that it represents.
+
+In order to use this function the type of the value must be an array
+of strings and it must be marked in the schema file as an flags type.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as a flags type.
+
+If the value stored in the configuration database is not a valid
+value for the flags type then this function will return the default
+value.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> the flags value
+</return>
+</function>
+
+<function name="g_application_register">
+<description>
+By default, #GApplication ensures process uniqueness when
+initialized, but this behavior is controlled by the
+GApplication:register property. If it was given as %FALSE at
+construction time, this function allows you to later attempt
+to ensure uniqueness. Note that the GApplication:default-quit
+property no longer applies at this point; if this function returns
+%FALSE, platform activation will occur, but the current process
+will not be terminated.
+
+It is an error to call this function more than once. It is
+also an error to call this function if the GApplication:register
+property was %TRUE at construction time.
+
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if registration was successful
+</return>
+</function>
+
<function name="g_data_input_stream_read_uint32">
<description>
Reads an unsigned 32-bit/4-byte value from @stream.
In order to get the correct byte order for this read operation,
-see g_data_stream_get_byte_order() and g_data_stream_set_byte_order().
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
@@ -17089,34 +22259,44 @@ or %NULL.
</return>
</function>
-<function name="g_content_type_get_mime_type">
+<function name="g_dbus_is_address">
<description>
-Gets the mime-type for the content type. If one is registered
+Checks if @string is a D-Bus address.
+
+This doesn't check if @string is actually supported by #GDBusServer
+or #GDBusConnection - use g_dbus_is_supported_address() to do more
+checks.
+Since: 2.26
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string.
+<parameter name="string">
+<parameter_description> A string.
</parameter_description>
</parameter>
</parameters>
-<return> the registered mime-type for the given @type, or NULL if unknown.
+<return> %TRUE if @string is a valid D-Bus address, %FALSE otherwise.
+
</return>
</function>
-<function name="g_resolver_error_quark">
+<function name="g_dbus_method_info_unref">
<description>
-Gets the #GResolver Error Quark.
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusMethodInfo.
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GQuark.
-
-</return>
+<return></return>
</function>
<function name="g_file_find_enclosing_mount_async">
@@ -17181,6 +22361,55 @@ g_file_copy_async().
</return>
</function>
+<function name="g_settings_bind_writable">
+<description>
+Create a binding between the writability of @key in the
+ settings object and the property @property of @object.
+The property must be boolean; "sensitive" or "visible"
+properties of widgets are the most likely candidates.
+
+Writable bindings are always uni-directional; changes of the
+writability of the setting will be propagated to the object
+property, not the other way.
+
+When the @inverted argument is %TRUE, the binding inverts the
+value as it passes from the setting to the object, i.e. @property
+will be set to %TRUE if the key is <emphasis>not</emphasis>
+writable.
+
+Note that the lifecycle of the binding is tied to the object,
+and that you can have only one binding per object property.
+If you bind the same property twice on the same object, the second
+binding overrides the first one.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to bind
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> the name of a boolean property to bind
+</parameter_description>
+</parameter>
+<parameter name="inverted">
+<parameter_description> whether to 'invert' the value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_charset_converter_set_use_fallback">
<description>
Sets the #GCharsetConverter:use-fallback property.
@@ -17201,6 +22430,24 @@ Since: 2.24
<return></return>
</function>
+<function name="g_dbus_proxy_get_interface_name">
+<description>
+Gets the D-Bus interface name @proxy is for.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A string owned by @proxy. Do not free.
+
+</return>
+</function>
+
<function name="g_file_open_readwrite_async">
<description>
Asynchronously opens @file for reading and writing.
@@ -17332,6 +22579,26 @@ if possible.
<return></return>
</function>
+<function name="g_dbus_message_set_num_unix_fds">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_set_name">
<description>
Sets the name attribute for the current #GFileInfo.
@@ -17402,8 +22669,8 @@ Sets @key in @settings to @value.
A convenience variant of g_settings_set() for booleans.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type boolean.
+It is a programmer error to give a @key that isn't specified as
+having a boolean type in the schema for @settings.
Since: 2.26
@@ -17427,31 +22694,51 @@ Since: 2.26
</return>
</function>
-<function name="g_settings_new_with_path">
+<function name="g_application_get_action_enabled">
<description>
-Creates a new #GSettings object with a given schema and path.
+Retrieves whether the action @name is enabled or not.
-You only need to do this if you want to directly create a settings
-object with a schema that doesn't have a specified path of its own.
-That's quite rare.
+See g_application_set_action_enabled().
-It is a programmer error to call this function for a schema that
-has an explicitly specified path.
+It is an error to call this function if @application is a proxy for
+a remote application.
Since: 2.26
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path to use
+<parameter name="name">
+<parameter_description> the name of the action
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
+<return> %TRUE if the action was enabled, and %FALSE otherwise
+
+</return>
+</function>
+
+<function name="g_dbus_is_guid">
+<description>
+Checks if @string is a D-Bus GUID.
+
+See the D-Bus specification regarding what strings are valid D-Bus
+GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> The string to check.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @string is a guid, %FALSE otherwise.
+
</return>
</function>
@@ -17575,6 +22862,24 @@ freed with g_free() when no longer needed.
</return>
</function>
+<function name="g_dbus_server_get_guid">
+<description>
+Gets the GUID for @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A D-Bus GUID. Do not free this string, it is owned by @server.
+
+</return>
+</function>
+
<function name="g_desktop_app_info_lookup_get_default_for_uri_scheme">
<description>
Gets the default application for launching applications
@@ -17740,34 +23045,39 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_resolver_lookup_service_finish">
+<function name="g_dbus_method_invocation_get_sender">
<description>
-Retrieves the result of a previous call to
-g_resolver_lookup_service_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.
+Gets the bus name that invoked the method.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> the result passed to your #GAsyncReadyCallback
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+</parameters>
+<return> A string. Do not free, it is owned by @invocation.
+
+</return>
+</function>
+
+<function name="g_dbus_arg_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusArgInfo
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GSrvTarget, or %NULL on error. See
-g_resolver_lookup_service() for more details.
+<return> The same @info.
</return>
</function>
@@ -17826,6 +23136,36 @@ Since: 2.22
</return>
</function>
+<function name="g_credentials_is_same_user">
+<description>
+Checks if @credentials and @other_credentials is the same user.
+
+This operation can fail if #GCredentials is not supported on the
+the OS.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="other_credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @credentials and @other_credentials has the same
+user, %FALSE otherwise or if @error is set.
+
+</return>
+</function>
+
<function name="g_volume_get_drive">
<description>
Gets the drive for the @volume.
@@ -17844,6 +23184,42 @@ when no longer needed.
</return>
</function>
+<function name="g_dbus_connection_get_capabilities">
+<description>
+Gets the capabilities negotiated with the remote peer
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Zero or more flags from the #GDBusCapabilityFlags enumeration.
+
+</return>
+</function>
+
+<function name="g_dbus_server_is_active">
+<description>
+Gets whether @server is active.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if server is active, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_converter_input_stream_get_converter">
<description>
Gets the #GConverter that is used by @converter_stream.
@@ -17882,6 +23258,56 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_connection_send_message">
+<description>
+Asynchronously sends @message to the peer represented by @connection.
+
+Unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+will be assigned by @connection and set on @message via
+g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
+serial number used will be written to this location prior to
+submitting the message to the underlying transport.
+
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @message is not well-formed,
+the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> A #GDBusMessage
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags affecting how the message is sent.
+</parameter_description>
+</parameter>
+<parameter name="out_serial">
+<parameter_description> Return location for serial number assigned to @message when sending it or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the message was well-formed and queued for
+transmission, %FALSE if @error is set.
+
+</return>
+</function>
+
<function name="g_file_info_set_attribute_stringv">
<description>
Sets the @attribute to contain the given @attr_value,
@@ -17989,56 +23415,87 @@ g_file_mount_mountable_finish() to get the result of the operation.
<return></return>
</function>
-<function name="g_volume_monitor_adopt_orphan_mount">
+<function name="g_dbus_message_set_unix_fd_list">
<description>
-This function should be called by any #GVolumeMonitor
-implementation when a new #GMount object is created that is not
-associated with a #GVolume object. It must be called just before
-emitting the @mount_added signal.
-
-If the return value is not %NULL, the caller must associate the
-returned #GVolume object with the #GMount. This involves returning
-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
+Sets the UNIX file descriptors associated with @message. As a
+side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header
+field is set to the number of fds in @fd_list (or cleared if
+ fd_list is %NULL).
-Similary, 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
-reference upon handling that signal.
+This method is only available on UNIX.
-There are two main use cases for this function.
+Since: 2.26
-One is when implementing a user space file system driver that reads
-blocks of a block device that is already represented by the native
-volume monitor (for example a CD Audio file system driver). Such
-a driver will generate its own #GMount object that needs to be
-assoicated with the #GVolume object that represents the volume.
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-The other is for implementing a #GVolumeMonitor whose sole purpose
-is to return #GVolume objects representing entries in the users
-"favorite servers" list or similar.
+<function name="g_zlib_compressor_new">
+<description>
+Creates a new #GZlibCompressor.
-Deprecated: 2.20: Instead of using this function, #GVolumeMonitor
-implementations should instead create shadow mounts with the URI of
-the mount they intend to adopt. See the proxy volume monitor in
-gvfs for an example of this. Also see g_mount_is_shadowed(),
-g_mount_shadow() and g_mount_unshadow() functions.
+Since: 2.24
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount object to find a parent for
+<parameter name="format">
+<parameter_description> The format to use for the compressed data
+</parameter_description>
+</parameter>
+<parameter name="level">
+<parameter_description> compression level (0-9), -1 for default
</parameter_description>
</parameter>
</parameters>
-<return> the #GVolume object that is the parent for @mount or %NULL
-if no wants to adopt the #GMount.
+<return> a new #GZlibCompressor
</return>
</function>
+<function name="g_bus_get">
+<description>
+Asynchronously connects to the message bus specified by @bus_type.
+
+When the operation is finished, @callback will be invoked. You can
+then call g_bus_get_finish() to get the result of the operation.
+
+This is a asynchronous failable function. See g_bus_get_sync() for
+the synchronous version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</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> The data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_enumerator_close">
<description>
Releases all resources used by this enumerator, making the
@@ -18241,6 +23698,28 @@ Since: 2.22
</return>
</function>
+<function name="g_dbus_connection_unregister_subtree">
+<description>
+Unregisters a subtree.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="registration_id">
+<parameter_description> A subtree registration id obtained from g_dbus_connection_register_subtree().
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the subtree was unregistered, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_initable_new_valist">
<description>
Helper function for constructing #GInitiable object. This is
@@ -18332,52 +23811,103 @@ Gets the mount path for a unix mount.
</return>
</function>
-<function name="g_socket_listener_accept_socket_finish">
+<function name="g_app_info_get_all_for_type">
<description>
-Finishes an async accept operation. See g_socket_listener_accept_socket_async()
+Gets a list of all #GAppInfo<!-- -->s for a given content type.
-Since: 2.22
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="content_type">
+<parameter_description> the content type to find a #GAppInfo for
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+</parameters>
+<return> #GList of #GAppInfo<!-- -->s for given @content_type
+or %NULL on error.
+</return>
+</function>
+
+<function name="g_file_attribute_info_list_unref">
+<description>
+Removes a reference from the given @list. If the reference count
+falls to zero, the @list is deleted.
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> The #GFileAttributeInfoList to unreference.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocket on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_app_info_get_all_for_type">
+<function name="g_dbus_connection_send_message_with_reply">
<description>
-Gets a list of all #GAppInfo<!-- -->s for a given content type.
+Asynchronously sends @message to the peer represented by @connection.
+
+Unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+will be assigned by @connection and set on @message via
+g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
+serial number used will be written to this location prior to
+submitting the message to the underlying transport.
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
+fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
+the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+
+This is an asynchronous method. 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
+g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
+See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="content_type">
-<parameter_description> the content type to find a #GAppInfo for
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags affecting how the message is sent.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds or -1 to use the default timeout.
+</parameter_description>
+</parameter>
+<parameter name="out_serial">
+<parameter_description> Return location for serial number assigned to @message when sending it 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 if you don't
+care about the result.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> #GList of #GAppInfo<!-- -->s for given @content_type
-or %NULL on error.
-</return>
+<return></return>
</function>
<function name="g_win32_input_stream_get_handle">
@@ -18398,43 +23928,78 @@ Since: 2.26
</return>
</function>
-<function name="g_file_read_async">
+<function name="g_dbus_connection_call_finish">
<description>
-Asynchronously opens @file for reading.
+Finishes an operation started with g_dbus_connection_call().
-For more details, see g_file_read() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_read_finish() to get the result of the operation.
+Since: 2.26
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call().
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameters>
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
+
+</return>
+</function>
+
+<function name="g_socket_set_blocking">
+<description>
+Sets the blocking mode of the socket. In blocking mode
+all operations block until they succeed or there is an error. In
+non-blocking mode all functions return results immediately or
+with a %G_IO_ERROR_WOULD_BLOCK error.
+
+All sockets are created in blocking mode. However, note that the
+platform level socket is always non-blocking, and blocking mode
+is a GSocket level feature.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="blocking">
+<parameter_description> Whether to use blocking I/O or not.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="g_dbus_method_invocation_get_method_info">
+<description>
+Gets information about the method call, if any.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.
+
+</return>
+</function>
+
<function name="g_socket_client_connect_to_host">
<description>
This is a helper function for g_socket_client_connect().
@@ -18540,11 +24105,46 @@ Since: 2.26
</return>
</function>
+<function name="g_dbus_connection_send_message_with_reply_finish">
+<description>
+Finishes an operation started with g_dbus_connection_send_message_with_reply().
+
+Note that @error is only set if a local in-process error
+occured. That is to say that the returned #GDBusMessage object may
+be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
+g_dbus_message_to_gerror() to transcode this to a #GError.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_send_message_with_reply().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage or %NULL if @error is set.
+
+</return>
+</function>
+
<function name="g_unix_mount_points_get">
<description>
-Gets a #GList of strings containing the unix mount points.
+Gets a #GList of #GUnixMountPoint containing the unix mount points.
If @time_read is set, it will be filled with the mount timestamp,
-allowing for checking if the mounts have changed with
+allowing for checking if the mounts have changed with
g_unix_mounts_points_changed_since().
@@ -18555,7 +24155,7 @@ g_unix_mounts_points_changed_since().
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of the UNIX mountpoints.
+<return> a #GList of the UNIX mountpoints.
</return>
</function>
@@ -18660,69 +24260,52 @@ will return %FALSE and set @error appropriately if present.
</return>
</function>
-<function name="g_async_initable_init_async">
+<function name="g_permission_impl_update">
<description>
-Starts asynchronous initialization of the object implementing the
-interface. This must be done before any real use of the object after
-initial construction. If the object also implements #GInitable you can
-optionally call g_initable_init() instead.
-
-When the initialization is finished, @callback will be called. You can
-then call g_async_initable_init_finish() to get the result of the
-initialization.
-
-Implementations may also support cancellation. If @cancellable is not
-%NULL, then initialization 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 @cancellable is not %NULL, and
-the object doesn't support cancellable initialization, the error
-%G_IO_ERROR_NOT_SUPPORTED will be returned.
+This function is called by the #GPermission implementation to update
+the properties of the permission. You should never call this
+function except from a #GPermission implementation.
-If this function is not called, or returns with an error, then all
-operations on the object should fail, generally returning the
-error %G_IO_ERROR_NOT_INITIALIZED.
-
-Implementations of this method must be idempotent: i.e. multiple calls
-to this function with the same argument should return the same results.
-Only the first call initializes the object; further calls return the result
-of the first call. This is so that it's safe to implement the singleton
-pattern in the GObject constructor function.
-
-For classes that also support the #GInitable interface, the default
-implementation of this method will run the g_initable_init() function
-in a thread, so if you want to support asynchronous initialization via
-threads, just implement the #GAsyncInitable interface without overriding
-any interface methods.
+GObject notify signals are generated, as appropriate.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="initable">
-<parameter_description> a #GAsyncInitable.
+<parameter name="permission">
+<parameter_description> a #GPermission instance
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the operation.
+<parameter name="allowed">
+<parameter_description> the new value for the 'allowed' property
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="can_acquire">
+<parameter_description> the new value for the 'can-acquire' property
</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> the data to pass to callback function
+<parameter name="can_release">
+<parameter_description> the new value for the 'can-release' property
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
+<function name="g_unix_credentials_message_new">
+<description>
+Creates a new #GUnixCredentialsMessage with credentials matching the current processes.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GUnixCredentialsMessage
+
+</return>
+</function>
+
<function name="g_mount_guess_content_type_finish">
<description>
Finishes guessing content types of @mount. If any errors occured
@@ -18773,6 +24356,73 @@ operation if @path is malformed.
</return>
</function>
+<function name="g_cancellable_push_current">
+<description>
+Pushes @cancellable onto the cancellable stack. The current
+cancllable can then be recieved using g_cancellable_get_current().
+
+This is useful when implementing cancellable operations in
+code that does not allow you to pass down the cancellable object.
+
+This is typically called automatically by e.g. #GFile operations,
+so you rarely have to call this yourself.
+
+</description>
+<parameters>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_method_invocation_return_gerror">
+<description>
+Like g_dbus_method_invocation_return_error() but takes a #GError
+instead of the error domain, error code and message.
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> A #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_error_strip_remote_error">
+<description>
+Looks for extra information in the error message used to recover
+the D-Bus error name and strips it if found. If stripped, the
+message field in @error will correspond exactly to what was
+received on the wire.
+
+This is typically used when presenting errors to the end user.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> A #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if information was stripped, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_file_copy_attributes">
<description>
Copies the file attributes from @source to @destination.
@@ -18871,6 +24521,76 @@ Since: 2.22
</return>
</function>
+<function name="g_bus_own_name_on_connection">
+<description>
+Like g_bus_own_name() but takes a #GDBusConnection instead of a
+#GBusType.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_handler">
+<parameter_description> Handler to invoke when @name is acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_handler">
+<parameter_description> Handler to invoke when @name is lost or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
+
+</return>
+</function>
+
+<function name="g_dbus_address_get_stream_finish">
+<description>
+Finishes an operation started with g_dbus_address_get_stream().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().
+</parameter_description>
+</parameter>
+<parameter name="out_guid">
+<parameter_description> %NULL or return location to store the GUID extracted from @address, if any.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GIOStream or %NULL if @error is set.
+
+</return>
+</function>
+
<function name="g_unix_socket_address_get_path">
<description>
Gets @address's path, or for abstract sockets the "name".
@@ -18915,6 +24635,61 @@ Since: 2.20
<return></return>
</function>
+<function name="g_dbus_server_new_sync">
+<description>
+Creates a new D-Bus server that listens on the first address in
+ address that works.
+
+Once constructed, you can use g_dbus_server_get_client_address() to
+get a D-Bus address string that clients can use to connect.
+
+Connect to the #GDBusServer::new-connection signal to handle
+incoming connections.
+
+The returned #GDBusServer isn't active - you have to start it with
+g_dbus_server_start().
+
+See <xref linkend="gdbus-peer-to-peer"/> for how #GDBusServer can
+be used.
+
+This is a synchronous failable constructor. See
+g_dbus_server_new() for the asynchronous version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> A D-Bus address.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusServerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="guid">
+<parameter_description> A D-Bus GUID.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver 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 server or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusServer or %NULL if @error is set. Free with
+g_object_unref().
+
+</return>
+</function>
+
<function name="g_app_info_get_default_for_type">
<description>
Gets the #GAppInfo that corresponds to a given content type.
@@ -18943,10 +24718,10 @@ about the filesystem the @file is on, rather than the file itself.
For instance the amount of space available and the type of
the filesystem.
-The @attribute value is a string that specifies the file attributes that
+The @attributes value is a string that specifies the file attributes that
should be gathered. It is not an error if it's not possible to read a particular
-requested attribute from a file - it just won't be set. @attribute should
-be a comma-separated list of attribute or attribute wildcards. The wildcard "*"
+requested attribute from a file - it just won't be set. @attributes should
+be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
means all attributes, and a wildcard like "fs:*" means all attributes in the fs
namespace. The standard namespace for filesystem attributes is "fs".
Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE
@@ -18985,6 +24760,25 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_io_extension_point_set_required_type">
+<description>
+Sets the required type for @extension_point to @type.
+All implementations must henceforth have this type.
+
+</description>
+<parameters>
+<parameter name="extension_point">
+<parameter_description> a #GIOExtensionPoint
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> the #GType to require
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_control_message_serialize">
<description>
Converts the data in the message to bytes placed in the
@@ -19077,6 +24871,39 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_file_input_stream_query_info">
+<description>
+Queries a file input stream the given @attributes. This function blocks
+while querying the stream. For the asynchronous (non-blocking) version
+of this function, see g_file_input_stream_query_info_async(). While the
+stream is blocked, the stream will set the pending flag internally, and
+any other operations on the stream will fail with %G_IO_ERROR_PENDING.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInfo, or %NULL on error.
+</return>
+</function>
+
<function name="g_file_info_get_symlink_target">
<description>
Gets the symlink target for a given #GFileInfo.
@@ -19230,6 +25057,140 @@ On error -1 is returned and @error is set accordingly.
</return>
</function>
+<function name="g_socket_listener_accept">
+<description>
+Blocks waiting for a client to connect to any of the sockets added
+to the listener. Returns a #GSocketConnection for the socket that was
+accepted.
+
+If @source_object is not %NULL it will be filled out with the source
+object specified when the corresponding socket or address was added
+to the listener.
+
+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.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> location where #GObject pointer will be stored, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_dbus_connection_call_sync">
+<description>
+Synchronously invokes the @method_name method on the
+ interface_name D-Bus interface on the remote object at
+ object_path owned by @bus_name.
+
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the
+operation will fail with %G_IO_ERROR_CANCELLED. If @parameters
+contains a value not compatible with the D-Bus protocol, the operation
+fails with %G_IO_ERROR_INVALID_ARGUMENT.
+
+If @reply_type is non-%NULL then the reply will be checked for having
+this type and an error will be raised if it does not match. Said
+another way, if you give a @reply_type then any non-%NULL return
+value will be of this type.
+
+If the @parameters #GVariant is floating, it is consumed.
+This allows convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_connection_call_sync (connection,
+"org.freedesktop.StringThings",
+"/org/freedesktop/StringThings",
+"org.freedesktop.StringThings",
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+NULL,
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+&error);
+]|
+
+The calling thread is blocked until a reply is received. See
+g_dbus_connection_call() for the asynchronous version of
+this method.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="bus_name">
+<parameter_description> A unique or well-known bus name.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to invoke method on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the method or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="reply_type">
+<parameter_description> The expected type of the reply, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds or -1 to use the default timeout.
+</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> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
+
+</return>
+</function>
+
<function name="g_vfs_get_supported_uri_schemes">
<description>
Gets a list of URI schemes supported by @vfs.
@@ -19282,21 +25243,30 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_file_output_stream_get_etag">
+<function name="g_settings_new_with_backend">
<description>
-Gets the entity tag for the file when it has been written.
-This must be called after the stream has been written
-and closed, as the etag can change while writing.
+Creates a new #GSettings object with a given schema and backend.
+
+Creating settings objects with an different backend allows accessing settings
+from a database other than the usual one. For example, it may make
+sense to pass a backend corresponding to the "defaults" settings database on
+the system to get a settings object that modifies the system default
+settings instead of the settings for this user.
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
+<parameter name="schema">
+<parameter_description> the name of the schema
+</parameter_description>
+</parameter>
+<parameter name="backend">
+<parameter_description> the #GSettingsBackend to use
</parameter_description>
</parameter>
</parameters>
-<return> the entity tag for the stream.
+<return> a new #GSettings object
</return>
</function>
@@ -19493,6 +25463,43 @@ Gets the edit name for a file.
</return>
</function>
+<function name="g_dbus_address_get_stream">
+<description>
+Asynchronously connects to an endpoint specified by @address and
+sets up the connection so it is in a state to run the client-side
+of the D-Bus authentication conversation.
+
+When the operation is finished, @callback will be invoked. You can
+then call g_dbus_address_get_stream_finish() to get the result of
+the operation.
+
+This is an asynchronous failable function. See
+g_dbus_address_get_stream_sync() for the synchronous version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> A valid D-Bus address.
+</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> Data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mount_operation_set_username">
<description>
Sets the user name within @op to @username.
@@ -19636,6 +25643,31 @@ ignore.
</return>
</function>
+<function name="g_input_stream_read_finish">
+<description>
+Finishes an asynchronous stream read operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> number of bytes read in, or -1 on error.
+</return>
+</function>
+
<function name="g_file_read">
<description>
Opens a file for reading. The result is a #GFileInputStream that
@@ -19829,6 +25861,25 @@ Since: 2.22
</return>
</function>
+<function name="g_content_type_from_mime_type">
+<description>
+Tries to find a content type based on the mime type name.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="mime_type">
+<parameter_description> a mime type string
+</parameter_description>
+</parameter>
+</parameters>
+<return> Newly allocated string with content type
+or %NULL. Free with g_free()
+
+</return>
+</function>
+
<function name="g_simple_async_result_propagate_error">
<description>
Propagates an error from within the simple asynchronous result to
@@ -19878,11 +25929,58 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_permission_acquire_finish">
+<description>
+Collects the result of attempting to acquire the permission
+represented by @permission.
+
+This is the second half of the asynchronous version of
+g_permission_acquire().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult given to the #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully acquired
+</return>
+</function>
+
+<function name="g_dbus_message_get_reply_serial">
+<description>
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value.
+
+</return>
+</function>
+
<function name="g_app_launch_context_get_display">
<description>
-Gets the display string for the display. This is used to ensure new
-applications are started on the same display as the launching
-application.
+Gets the display string for the @context. This is used to ensure new
+applications are started on the same display as the launching
+application, by setting the <envvar>DISPLAY</envvar> environment variable.
</description>
@@ -19986,6 +26084,37 @@ Since: 2.22
<return></return>
</function>
+<function name="g_application_set_action_enabled">
+<description>
+Sets whether the action @name inside @application should be enabled
+or disabled.
+
+It is an error to call this function if @application is a proxy for
+a remote application.
+
+Invoking a disabled action will not result in the #GApplication::action
+signal being emitted.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the application
+</parameter_description>
+</parameter>
+<parameter name="enabled">
+<parameter_description> whether to enable or disable the action @name
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_eject_mountable_with_operation_finish">
<description>
Finishes an asynchronous eject operation started by
@@ -20014,6 +26143,78 @@ otherwise.
</return>
</function>
+<function name="g_settings_new_with_backend_and_path">
+<description>
+Creates a new #GSettings object with a given schema, backend and
+path.
+
+This is a mix of g_settings_new_with_backend() and
+g_settings_new_with_path().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> the name of the schema
+</parameter_description>
+</parameter>
+<parameter name="backend">
+<parameter_description> the #GSettingsBackend to use
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path to use
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+</return>
+</function>
+
+<function name="g_bus_own_name_with_closures">
+<description>
+Version of g_bus_own_name() using closures instead of callbacks for
+easier binding in other languages.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> The type of bus to own a name on.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="bus_acquired_closure">
+<parameter_description> #GClosure to invoke when connected to
+the bus of type @bus_type or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_closure">
+<parameter_description> #GClosure to invoke when @name is
+acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_closure">
+<parameter_description> #GClosure to invoke when @name is lost or
+%NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
+
+</return>
+</function>
+
<function name="g_data_output_stream_put_string">
<description>
Puts a string into the output stream.
@@ -20130,28 +26331,6 @@ on error
</return>
</function>
-<function name="g_file_info_get_attribute_uint32">
-<description>
-Gets an unsigned 32-bit integer contained within the attribute. If the
-attribute does not contain an unsigned 32-bit integer, or is invalid,
-0 will be returned.
-
-
-</description>
-<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-</parameters>
-<return> an unsigned 32-bit integer from the attribute.
-</return>
-</function>
-
<function name="g_vfs_parse_name">
<description>
This operation never fails, but the returned object might
@@ -20191,6 +26370,148 @@ Checks if the VFS is active.
</return>
</function>
+<function name="g_dbus_proxy_new_for_bus_sync">
+<description>
+Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
+</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="interface_name">
+<parameter_description> A D-Bus interface name.
+</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> A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_dbus_auth_observer_new">
+<description>
+Creates a new #GDBusAuthObserver object.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusAuthObserver. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_dbus_connection_register_object">
+<description>
+Registers callbacks for exported objects at @object_path with the
+D-Bus interface that is described in @interface_info.
+
+Calls to functions in @vtable (and @user_data_free_func) will
+happen in the <link linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this method from.
+
+Note that all #GVariant values passed to functions in @vtable will match
+the signature given in @interface_info - if a remote caller passes
+incorrect values, the <literal>org.freedesktop.DBus.Error.InvalidArgs</literal>
+is returned to the remote caller.
+
+Additionally, if the remote caller attempts to invoke methods or
+access properties not mentioned in @interface_info the
+<literal>org.freedesktop.DBus.Error.UnknownMethod</literal> resp.
+<literal>org.freedesktop.DBus.Error.InvalidArgs</literal> errors
+are returned to the caller.
+
+It is considered a programming error if the
+#GDBusInterfaceGetPropertyFunc function in @vtable returns a
+#GVariant of incorrect type.
+
+If an existing callback is already registered at @object_path and
+ interface_name, then @error is set to #G_IO_ERROR_EXISTS.
+
+GDBus automatically implements the standard D-Bus interfaces
+org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
+and org.freedesktop.Peer, so you don't have to implement those for
+the objects you export. You <emphasis>can</emphasis> implement
+org.freedesktop.DBus.Properties yourself, e.g. to handle getting
+and setting of properties asynchronously.
+
+Note that the reference count on @interface_info will be
+incremented by 1 (unless allocated statically, e.g. if the
+reference count is -1, see g_dbus_interface_info_ref()) for as long
+as the object is exported. Also note that @vtable will be copied.
+
+See <xref linkend="gdbus-server"/> for an example of how to use this method.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> The object path to register at.
+</parameter_description>
+</parameter>
+<parameter name="interface_info">
+<parameter_description> Introspection data for the interface.
+</parameter_description>
+</parameter>
+<parameter name="vtable">
+<parameter_description> A #GDBusInterfaceVTable to call into or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> Data to pass to functions in @vtable.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to call when the object path is unregistered.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> 0 if @error is set, otherwise a registration id (never 0)
+that can be used with g_dbus_connection_unregister_object() .
+
+</return>
+</function>
+
<function name="g_srv_target_free">
<description>
Frees @target
@@ -20315,31 +26636,53 @@ Checks if a unix mount is mounted read only.
</return>
</function>
-<function name="g_content_type_guess_for_tree">
+<function name="g_dbus_node_info_ref">
<description>
-Tries to guess the type of the tree with root @root, by
-looking at the files it contains. The result is an array
-of content types, with the best guess coming first.
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
-The types returned all have the form x-content/foo, e.g.
-x-content/audio-cdda (for audio CDs) or x-content/image-dcf
-(for a camera memory card). See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
-specification for more on x-content types.
+Since: 2.26
-This function is useful in the implementation of g_mount_guess_content_type().
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The same @info.
+
+</return>
+</function>
+
+<function name="g_output_stream_flush">
+<description>
+Flushed any outstanding buffers in the stream. Will block during
+the operation. Closing the stream will implicitly cause a flush.
+
+This function is optional for inherited classes.
+
+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.
-Since: 2.18
</description>
<parameters>
-<parameter name="root">
-<parameter_description> the root of the tree to guess a type for
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occuring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> an %NULL-terminated array of zero or more content types, or %NULL.
-Free with g_strfreev()
-
+<return> %TRUE on success, %FALSE on error
</return>
</function>
@@ -20527,28 +26870,59 @@ present, it will be set appropriately.
</return>
</function>
-<function name="g_input_stream_read_finish">
+<function name="g_dbus_message_get_unix_fd_list">
<description>
-Finishes an asynchronous stream read operation.
+Gets the UNIX file descriptors associated with @message, if any.
+This method is only available on UNIX.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+</parameters>
+<return> A #GUnixFDList or %NULL if no file descriptors are
+associated. Do not free, this object is owned by @message.
+
+</return>
+</function>
+
+<function name="g_dbus_address_get_stream_sync">
+<description>
+Synchronously connects to an endpoint specified by @address and
+sets up the connection so it is in a state to run the client-side
+of the D-Bus authentication conversation.
+
+This is a synchronous failable function. See
+g_dbus_address_get_stream() for the asynchronous version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> A valid D-Bus address.
+</parameter_description>
+</parameter>
+<parameter name="out_guid">
+<parameter_description> %NULL or return location to store the GUID extracted from @address, if any.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> number of bytes read in, or -1 on error.
+<return> A #GIOStream or %NULL if @error is set.
+
</return>
</function>
@@ -20610,20 +26984,32 @@ Gets the size of the available data within the stream.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> #GBufferedInputStream.
+<parameter_description> #GBufferedInputStream
</parameter_description>
</parameter>
</parameters>
-<return> size of the available stream.
+<return> size of the available stream.
</return>
</function>
-<function name="missing_remove">
+<function name="g_settings_reset">
<description>
-Unsafe, need lock fen_lock.
+Resets @key to its default value.
+
+This call resets the key, as much as possible, to its default value.
+That might the value specified in the schema or the one set by the
+administrator.
</description>
<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of a key
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -20731,30 +27117,70 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_volume_eject_finish">
+<function name="g_keyfile_settings_backend_new">
<description>
-Finishes ejecting a volume. If any errors occured during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Creates a keyfile-backed #GSettingsBackend.
-Deprecated: 2.22: Use g_volume_eject_with_operation_finish() instead.
+The filename of the keyfile to use is given by @filename.
+
+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 "/".
+
+If @root_group is non-%NULL then it specifies the name of the keyfile
+group used for keys that are written directly below @root_path. For
+example, if @root_path is "/apps/example/" and @root_group is
+"toplevel", then settings the key "/apps/example/enabled" to a value
+of %TRUE will cause the following to appear in the keyfile:
+
+|[
+[toplevel]
+enabled=true
+]|
+
+If @root_group is %NULL then it is not permitted to store keys
+directly below the @root_path.
+
+For keys not stored directly below @root_path (ie: in a sub-path),
+the name of the subpath (with the final slash stripped) is used as
+the name of the keyfile group. To continue the example, if
+"/apps/example/profiles/default/font-size" were set to
+12 then the following would appear in the keyfile:
+
+|[
+[profiles/default]
+font-size=12
+]|
+
+The backend will refuse writes (and return writability as being
+%FALSE) for keys outside of @root_path and, in the event that
+ root_group is %NULL, also for keys directly under @root_path.
+Writes will also be refused if the backend detects that it has the
+inability to rewrite the keyfile (ie: the containing directory is not
+writable).
+
+There is no checking done for your key namespace clashing with the
+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.
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> pointer to a #GVolume.
+<parameter name="filename">
+<parameter_description> the filename of the keyfile
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="root_path">
+<parameter_description> the path under which all settings keys appear
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store an error, or %NULL to ignore
+<parameter name="root_group">
+<parameter_description> the group name corresponding to
+ root_path, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE, %FALSE if operation failed.
-
+<return> a keyfile-backed #GSettingsBackend
</return>
</function>
@@ -20818,8 +27244,8 @@ Sets @key in @settings to @value.
A convenience variant of g_settings_set() for strings.
-It is a programmer error to pass a @key that isn't valid for
- settings or is not of type string.
+It is a programmer error to give a @key that isn't specified as
+having a string type in the schema for @settings.
Since: 2.26
@@ -20902,34 +27328,41 @@ make a backup of @file.
<return></return>
</function>
-<function name="g_file_query_file_type">
+<function name="g_socket_address_enumerator_next">
<description>
-Utility function to inspect the #GFileType of a file. This is
-implemented using g_file_query_info() and as such does blocking I/O.
+Retrieves the next #GSocketAddress from @enumerator. Note that this
+may block for some amount of time. (Eg, a #GNetworkAddress may need
+to do a DNS lookup before it can return an address.) Use
+g_socket_address_enumerator_next_async() if you need to avoid
+blocking.
-The primary use case of this method is to check if a file is a regular file,
-directory, or symlink.
+If @enumerator is expected to yield addresses, but for some reason
+is unable to (eg, because of a DNS error), then the first call to
+g_socket_address_enumerator_next() will return an appropriate error
+in * error However, if the first call to
+g_socket_address_enumerator_next() succeeds, then any further
+internal errors (other than @cancellable being triggered) will be
+ignored.
-Since: 2.18
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags passed to g_file_query_info().
+<parameter name="enumerator">
+<parameter_description> a #GSocketAddressEnumerator
</parameter_description>
</parameter>
<parameter name="cancellable">
<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
</parameters>
-<return> The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file
-does not exist
-
+<return> a #GSocketAddress (owned by the caller), or %NULL on
+error (in which case * error will be set) or if there are no
+more addresses.
</return>
</function>
@@ -20999,44 +27432,20 @@ attribute does not contain a signed 32-bit integer, or is invalid,
</return>
</function>
-<function name="g_drive_stop">
+<function name="g_file_attribute_info_list_dup">
<description>
-Asynchronously stops a drive.
-
-When the operation is finished, @callback will be called.
-You can then call g_drive_stop_finish() to obtain the
-result of the operation.
+Makes a duplicate of a file attribute info list.
-Since: 2.22
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for stopping.
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to @callback
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList to duplicate.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a copy of the given @list.
+</return>
</function>
<function name="g_icon_hash">
@@ -21104,6 +27513,63 @@ not contain a #GObject, %NULL will be returned.
</return>
</function>
+<function name="g_socket_listener_accept_socket_finish">
+<description>
+Finishes an async accept operation. See g_socket_listener_accept_socket_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocket on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_dbus_auth_observer_authorize_authenticated_peer">
+<description>
+Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver.
+</parameter_description>
+</parameter>
+<parameter name="stream">
+<parameter_description> A #GIOStream for the #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="credentials">
+<parameter_description> Credentials received from the peer or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the peer is authorized, %FALSE if not.
+
+</return>
+</function>
+
<function name="g_memory_output_stream_get_data_size">
<description>
Returns the number of bytes from the start up
@@ -21124,6 +27590,104 @@ Since: 2.18
</return>
</function>
+<function name="g_dbus_method_invocation_return_error_literal">
+<description>
+Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> A #GQuark for the #GError error domain.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> The error code.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> The error message.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_message_get_serial">
+<description>
+Gets the serial for @message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #guint32.
+
+</return>
+</function>
+
+<function name="g_dbus_method_invocation_new">
+<description>
+Creates a new #GDBusMethodInvocation object.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="sender">
+<parameter_description> The bus name that invoked the method or %NULL if @connection is not a bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> The object path the method was invoked on.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> The name of the D-Bus interface the method was invoked on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method that was invoked.
+</parameter_description>
+</parameter>
+<parameter name="method_info">
+<parameter_description> Information about the method call or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="connection">
+<parameter_description> The #GDBusConnection the method was invoked on.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> The D-Bus message as a #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> The parameters as a #GVariant tuple.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The @user_data #gpointer passed to g_dbus_connection_register_object().
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMethodInvocation. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_file_attribute_matcher_ref">
<description>
References a file attribute matcher.
@@ -21229,6 +27793,31 @@ case that @parent is %NULL).
</return>
</function>
+<function name="g_dbus_is_supported_address">
+<description>
+Like g_dbus_is_address() but also checks if the library suppors the
+transports in @string and that key/value pairs for each transport
+are valid.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> A string.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @string is a valid D-Bus address that is
+supported by this library, %FALSE if @error is set.
+
+</return>
+</function>
+
<function name="g_file_info_new">
<description>
Creates a new file info structure.
@@ -21264,6 +27853,51 @@ the output stream is destroyed.
</return>
</function>
+<function name="g_dbus_message_set_path">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_stream_set_pending">
+<description>
+Sets @stream to have actions pending. If the pending flag is
+already set or @stream is closed, it will return %FALSE and set
+ error
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if pending was previously unset and is now set.
+
+</return>
+</function>
+
<function name="g_socket_connection_get_remote_address">
<description>
Try to get the remote address of a socket connection.
@@ -21335,6 +27969,104 @@ Puts an unsigned 16-bit integer into the output stream.
</return>
</function>
+<function name="g_volume_monitor_adopt_orphan_mount">
+<description>
+This function should be called by any #GVolumeMonitor
+implementation when a new #GMount object is created that is not
+associated with a #GVolume object. It must be called just before
+emitting the @mount_added signal.
+
+If the return value is not %NULL, the caller must associate the
+returned #GVolume object with the #GMount. This involves returning
+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(),
+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
+reference upon handling that signal.
+
+There are two main use cases for this function.
+
+One is when implementing a user space file system driver that reads
+blocks of a block device that is already represented by the native
+volume monitor (for example a CD Audio file system driver). Such
+a driver will generate its own #GMount object that needs to be
+assoicated with the #GVolume object that represents the volume.
+
+The other is for implementing a #GVolumeMonitor whose sole purpose
+is to return #GVolume objects representing entries in the users
+"favorite servers" list or similar.
+
+Deprecated: 2.20: Instead of using this function, #GVolumeMonitor
+implementations should instead create shadow mounts with the URI of
+the mount they intend to adopt. See the proxy volume monitor in
+gvfs for an example of this. Also see g_mount_is_shadowed(),
+g_mount_shadow() and g_mount_unshadow() functions.
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount object to find a parent for
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GVolume object that is the parent for @mount or %NULL
+if no wants to adopt the #GMount.
+
+</return>
+</function>
+
+<function name="g_dbus_message_new_method_call">
+<description>
+Creates a new #GDBusMessage for a method call.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> A valid D-Bus name or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> A valid object path.
+</parameter_description>
+</parameter>
+<parameter name="interface_">
+<parameter_description> A valid D-Bus interface name or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="method">
+<parameter_description> A valid method name.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_enumerator_get_container">
+<description>
+Get the #GFile container which is being enumerated.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GFile which is being enumerated.
+
+</return>
+</function>
+
<function name="g_simple_async_result_new_error">
<description>
Creates a new #GSimpleAsyncResult with a set error.
@@ -21375,6 +28107,30 @@ Creates a new #GSimpleAsyncResult with a set error.
</return>
</function>
+<function name="g_dbus_annotation_info_lookup">
+<description>
+Looks up the value of an annotation.
+
+This cost of this function is O(n) in number of annotations.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="annotations">
+<parameter_description> A %NULL-terminated array of annotations or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name of the annotation to look up.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value or %NULL if not found. Do not free, it is owned by @annotations.
+
+</return>
+</function>
+
<function name="g_socket_accept">
<description>
Accept incoming connections on a connection-based socket. This removes
@@ -21452,6 +28208,33 @@ of the request.
<return></return>
</function>
+<function name="g_dbus_message_new_method_error_literal">
+<description>
+Creates a new #GDBusMessage that is an error reply to @method_call_message.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
+</parameter_description>
+</parameter>
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="error_message">
+<parameter_description> The D-Bus error message.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
+</function>
+
<function name="g_file_unmount_mountable_finish">
<description>
Finishes an unmount operation, see g_file_unmount_mountable() for details.
@@ -21631,6 +28414,24 @@ Since: 2.22
<return></return>
</function>
+<function name="g_dbus_signal_info_unref">
+<description>
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusSignalInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_io_stream_close">
<description>
Closes the stream, releasing resources related to it. This will also
@@ -21704,32 +28505,22 @@ Since: 2.22
</return>
</function>
-<function name="g_tcp_connection_set_graceful_disconnect">
+<function name="g_dbus_message_get_sender">
<description>
-This enabled graceful disconnects on close. A graceful disconnect
-means that we signal the recieving end that the connection is terminated
-and wait for it to close the connection before closing the connection.
-
-A graceful disconnect means that we can be sure that we successfully sent
-all the outstanding data to the other end, or get an error reported.
-However, it also means we have to wait for all the data to reach the
-other side and for it to acknowledge this by closing the socket, which may
-take a while. For this reason it is disabled by default.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GTcpConnection
-</parameter_description>
-</parameter>
-<parameter name="graceful_disconnect">
-<parameter_description> Whether to do graceful disconnects or not
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
<function name="g_app_info_can_remove_supports_type">
@@ -21787,6 +28578,27 @@ The returned string should be freed with g_free() when no longer needed.
</return>
</function>
+<function name="g_dbus_proxy_get_name_owner">
+<description>
+The unique name that owns the name that @proxy is for or %NULL if
+no-one currently owns that name. You may connect to the
+#GObject::notify signal to track changes to the
+#GDBusProxy:g-name-owner property.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The name owner or %NULL if no name owner exists. Free with g_free().
+
+</return>
+</function>
+
<function name="gvdb_table_get_value">
<description>
Looks up a value named @key in @file.
@@ -21795,10 +28607,6 @@ If the value is not found then %NULL is returned. Otherwise, a new
#GVariant instance is returned. The #GVariant does not depend on the
continued existence of @file.
-If @options is non-%NULL then it will be set either to %NULL in the
-case of no options or a #GVariant containing a dictionary mapping
-strings to variants.
-
You should call g_variant_unref() on the return result when you no
longer require it.
@@ -21812,12 +28620,24 @@ longer require it.
<parameter_description> a string
</parameter_description>
</parameter>
-<parameter name="options">
-<parameter_description> a pointer to a #GVariant, or %NULL
+</parameters>
+<return> a #GVariant, or %NULL
+</return>
+</function>
+
+<function name="g_volume_can_eject">
+<description>
+Checks if a volume can be ejected.
+
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> a #GVolume.
</parameter_description>
</parameter>
</parameters>
-<return> a #GVariant, or %NULL
+<return> %TRUE if the @volume can be ejected. %FALSE otherwise.
</return>
</function>
@@ -21868,6 +28688,20 @@ Guesses whether a Unix mount can be ejected.
</return>
</function>
+<function name="g_unix_credentials_message_is_supported">
+<description>
+Checks if passing a #GCredential on a #GSocket is supported on this platform.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if supported, %FALSE otherwise
+
+</return>
+</function>
+
<function name="g_resolver_lookup_by_name_async">
<description>
Begins asynchronously resolving @hostname to determine its
@@ -21905,22 +28739,41 @@ Since: 2.22
<function name="g_content_type_is_a">
<description>
-Determines if @type is a subset of @supertype.
+Determines if @type is a subset of @supertype.
</description>
<parameters>
<parameter name="type">
-<parameter_description> a content type string.
+<parameter_description> a content type string
</parameter_description>
</parameter>
<parameter name="supertype">
-<parameter_description> a string.
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
<return> %TRUE if @type is a kind of @supertype,
-%FALSE otherwise.
+%FALSE otherwise.
+</return>
+</function>
+
+<function name="g_dbus_signal_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusSignalInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The same @info.
+
</return>
</function>
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index 76dac2b..5d91b10 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -152,6 +152,25 @@ Use g_strfreev() to free it.
</return>
</function>
+<function name="g_atomic_pointer_get">
+<description>
+Reads the value of the pointer pointed to by @atomic.
+Also acts as a memory barrier.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to a #gpointer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value to add to * atomic
+
+</return>
+</function>
+
<function name="g_variant_equal">
<description>
Checks if @one and @two have the same type and value.
@@ -1124,7 +1143,11 @@ as icons that is customized for a particular user.
On UNIX platforms this is determined using the mechanisms described in
the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>
+XDG Base Directory Specification</ulink>.
+In this case the directory retrieved will be XDG_DATA_HOME.
+
+On Windows is the virtual folder that represents the My Documents
+desktop item. See documentation for CSIDL_PERSONAL.
Since: 2.6
@@ -1138,12 +1161,38 @@ or freed.
<function name="g_dgettext">
<description>
-This is a variant of g_dgettext() that allows specifying a locale
-category instead of always using %LC_MESSAGES. See g_dgettext() for
-more information about how this functions differs from calling
-dcgettext() directly.
+This function is a wrapper of dgettext() which does not translate
+the message if the default domain as set with textdomain() has no
+translations for the current locale.
-Since: 2.26
+The advantage of using this function over dgettext() proper is that
+libraries using this function (like GTK+) will not use translations
+if the application using the library does not have translations for
+the current locale. This results in a consistent English-only
+interface instead of one having partial translations. For this
+feature to work, the call to textdomain() and setlocale() should
+precede any g_dgettext() invocations. For GTK+, it means calling
+textdomain() before gtk_init or its variants.
+
+This function disables translations if and only if upon its first
+call all the following conditions hold:
+<itemizedlist>
+<listitem>@domain is not %NULL</listitem>
+<listitem>textdomain() has been called to set a default text domain</listitem>
+<listitem>there is no translations available for the default text domain
+and the current locale</listitem>
+<listitem>current locale is not "C" or any English locales (those
+starting with "en_")</listitem>
+</itemizedlist>
+
+Note that this behavior may not be desired for example if an application
+has its untranslated messages in a language other than English. In those
+cases the application should call textdomain() after initializing GTK+.
+
+Applications should normally not use this function directly,
+but use the _() macro for translations.
+
+Since: 2.18
</description>
<parameters>
@@ -1156,12 +1205,8 @@ the domain set with textdomain()
<parameter_description> message to translate
</parameter_description>
</parameter>
-<parameter name="category">
-<parameter_description> a locale category
-</parameter_description>
-</parameter>
</parameters>
-<return> the translated string for the given locale category
+<return> The translated string
</return>
</function>
@@ -1479,6 +1524,27 @@ g_hash_table_lookup_extended().
</return>
</function>
+<function name="g_path_get_basename">
+<description>
+Gets the last component of the filename. If @file_name ends with a
+directory separator it gets the component before the last slash. If
+ file_name consists only of directory separators (and on Windows,
+possibly a drive letter), a single separator is returned. If
+ file_name is empty, it gets ".".
+
+
+</description>
+<parameters>
+<parameter name="file_name">
+<parameter_description> the name of the file.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string containing the last component of
+the filename.
+</return>
+</function>
+
<function name="g_dataset_id_remove_no_notify">
<description>
Removes an element, without calling its destroy notification
@@ -2068,51 +2134,33 @@ Since: 2.14
<return></return>
</function>
-<function name="g_signal_handlers_unblock_matched">
+<function name="g_variant_dup_bytestring_array">
<description>
-Unblocks all handlers on an instance that match a certain selection
-criteria. The criteria mask is passed as an OR-ed combination of
-#GSignalMatchType flags, and the criteria values are passed as arguments.
-Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC
-or %G_SIGNAL_MATCH_DATA match flags is required for successful matches.
-If no handlers were found, 0 is returned, the number of unblocked handlers
-otherwise. The match criteria should not apply to any handlers that are
-not currently blocked.
+Gets the contents of an array of array of bytes #GVariant. This call
+makes a deep copy; the return result should be released with
+g_strfreev().
+
+If @length is non-%NULL then the number of elements in the result is
+stored there. In any case, the resulting array will be
+%NULL-terminated.
+
+For an empty array, @length will be set to 0 and a pointer to a
+%NULL pointer will be returned.
+Since: 2.26
</description>
<parameters>
-<parameter name="instance">
-<parameter_description> The instance to unblock handlers from.
-</parameter_description>
-</parameter>
-<parameter name="mask">
-<parameter_description> Mask indicating which of @signal_id, @detail, @closure, @func
-and/or @data the handlers have to match.
-</parameter_description>
-</parameter>
-<parameter name="signal_id">
-<parameter_description> Signal the handlers have to be connected to.
-</parameter_description>
-</parameter>
-<parameter name="detail">
-<parameter_description> Signal detail the handlers have to be connected to.
-</parameter_description>
-</parameter>
-<parameter name="closure">
-<parameter_description> The closure the handlers will invoke.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> The C closure callback of the handlers (useless for non-C closures).
+<parameter name="value">
+<parameter_description> an array of array of bytes #GVariant ('aay')
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> The closure data of the handlers' closures.
+<parameter name="length">
+<parameter_description> the length of the result, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> The number of handlers that matched.
+<return> an array of strings
</return>
</function>
@@ -2167,6 +2215,7 @@ system-wide application data.
On UNIX platforms this is determined using the mechanisms described in
the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
XDG Base Directory Specification</ulink>
+In this case the list of directories retrieved will be XDG_DATA_DIRS.
On Windows the first elements in the list are the Application Data
and Documents folders for All Users. (These can be determined only
@@ -2616,7 +2665,8 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> an array of constant strings
+<return> an array of constant
+strings
</return>
</function>
@@ -2810,6 +2860,8 @@ items are UTF-8 strings.
Since: 2.4
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -3169,6 +3221,8 @@ or %NULL if the #GList has no elements
Deletes any records from a #GRelation that have the given key value
in the given field.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -3792,9 +3846,9 @@ Replaces all occurrences of the pattern in @regex with the
replacement text. @replacement is replaced literally, to
include backreferences use g_regex_replace().
-Setting @start_position differs from just passing over a
-shortened string and setting #G_REGEX_MATCH_NOTBOL in the
-case of a pattern that begins with any kind of lookbehind
+Setting @start_position differs from just passing over a
+shortened string and setting #G_REGEX_MATCH_NOTBOL in the
+case of a pattern that begins with any kind of lookbehind
assertion, such as "\b".
Since: 2.14
@@ -3941,6 +3995,30 @@ Since: 2.24
</return>
</function>
+<function name="g_variant_new_bytestring_array">
+<description>
+Constructs an array of bytestring #GVariant from the given array of
+strings.
+
+If @length is -1 then @strv is %NULL-terminated.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="strv">
+<parameter_description> an array of strings
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @strv, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new floating #GVariant instance
+</return>
+</function>
+
<function name="g_byte_array_sort_with_data">
<description>
Like g_byte_array_sort(), but the comparison function takes an extra
@@ -4542,6 +4620,34 @@ A convenience macro to get the next element in a #GSList.
</return>
</function>
+<function name="g_atomic_pointer_compare_and_exchange">
+<description>
+Compares @oldval with the pointer pointed to by @atomic and
+if they are equal, atomically exchanges * atomic with @newval.
+Also acts as a memory barrier.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to a #gpointer
+</parameter_description>
+</parameter>
+<parameter name="oldval">
+<parameter_description> the assumed old value of * atomic
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value of * atomic
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if * atomic was equal @oldval. %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_strndup">
<description>
Duplicates the first @n bytes of a string, returning a newly-allocated
@@ -4600,6 +4706,8 @@ required to update user data pointers with a destroy notifier.
Creates an index on the given field. Note that this must be called
before any records are added to the #GRelation.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -4693,41 +4801,41 @@ Since: 2.4
<function name="g_regex_match_all_full">
<description>
-Using the standard algorithm for regular expression matching only
-the longest match in the string is retrieved, it is not possibile
+Using the standard algorithm for regular expression matching only
+the longest match in the string is retrieved, it is not possibile
to obtain all the available matches. For instance matching
-"<a> <b> <c>" against the pattern "<.*>"
+"<a> <b> <c>" against the pattern "<.*>"
you get "<a> <b> <c>".
This function uses a different algorithm (called DFA, i.e. deterministic
finite automaton), so it can retrieve all the possible matches, all
starting at the same point in the string. For instance matching
-"<a> <b> <c>" against the pattern "<.*>"
+"<a> <b> <c>" against the pattern "<.*>"
you would obtain three matches: "<a> <b> <c>",
"<a> <b>" and "<a>".
The number of matched strings is retrieved using
-g_match_info_get_match_count(). To obtain the matched strings and
-their position you can use, respectively, g_match_info_fetch() and
-g_match_info_fetch_pos(). Note that the strings are returned in
-reverse order of length; that is, the longest matching string is
+g_match_info_get_match_count(). To obtain the matched strings and
+their position you can use, respectively, g_match_info_fetch() and
+g_match_info_fetch_pos(). Note that the strings are returned in
+reverse order of length; that is, the longest matching string is
given first.
-Note that the DFA algorithm is slower than the standard one and it
+Note that the DFA algorithm is slower than the standard one and it
is not able to capture substrings, so backreferences do not work.
-Setting @start_position differs from just passing over a shortened
-string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
+Setting @start_position differs from just passing over a shortened
+string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
that begins with any kind of lookbehind assertion, such as "\b".
-A #GMatchInfo structure, used to get information on the match, is
-stored in @match_info if not %NULL. Note that if @match_info is
-not %NULL then it is created even if the function returns %FALSE,
-i.e. you must free it regardless if regular expression actually
+A #GMatchInfo structure, used to get information on the match, is
+stored in @match_info if not %NULL. Note that if @match_info is
+not %NULL then it is created even if the function returns %FALSE,
+i.e. you must free it regardless if regular expression actually
matched.
- string is not copied and is used in #GMatchInfo internally. If
-you use any #GMatchInfo method (except g_match_info_free()) after
+ string is not copied and is used in #GMatchInfo internally. If
+you use any #GMatchInfo method (except g_match_info_free()) after
freeing or modifying @string then the behaviour is undefined.
Since: 2.14
@@ -4755,8 +4863,8 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="match_info">
-<parameter_description> pointer to location where to store the #GMatchInfo,
-or %NULL if you do not need it
+<parameter_description> pointer to location where to store
+the #GMatchInfo, or %NULL if you do not need it
</parameter_description>
</parameter>
<parameter name="error">
@@ -4853,6 +4961,25 @@ For the children of the root node the depth is 2. And so on.
</return>
</function>
+<function name="g_value_dup_variant">
+<description>
+Get the contents of a variant #GValue, increasing its refcount.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a valid #GValue of type %G_TYPE_VARIANT
+</parameter_description>
+</parameter>
+</parameters>
+<return> variant contents of @value, should be unrefed using
+g_variant_unref() when no longer needed
+
+</return>
+</function>
+
<function name="g_value_get_long">
<description>
Get the contents of a %G_TYPE_LONG #GValue.
@@ -4967,6 +5094,44 @@ Get the contents of a %G_TYPE_BOOLEAN #GValue.
</return>
</function>
+<function name="g_cclosure_marshal_VOID__VARIANT">
+<description>
+A marshaller for a #GCClosure with a callback of type
+<literal>void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)</literal>.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="closure">
+<parameter_description> the #GClosure to which the marshaller belongs
+</parameter_description>
+</parameter>
+<parameter name="return_value">
+<parameter_description> ignored
+</parameter_description>
+</parameter>
+<parameter name="n_param_values">
+<parameter_description> 2
+</parameter_description>
+</parameter>
+<parameter name="param_values">
+<parameter_description> a #GValue array holding the instance and the #GVariant* parameter
+</parameter_description>
+</parameter>
+<parameter name="invocation_hint">
+<parameter_description> the invocation hint given as the last argument
+to g_closure_invoke()
+</parameter_description>
+</parameter>
+<parameter name="marshal_data">
+<parameter_description> additional data specified when registering the marshaller
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_key_file_free">
<description>
Frees a #GKeyFile.
@@ -5060,7 +5225,9 @@ containing 0.
<function name="g_value_array_prepend">
<description>
-Insert a copy of @value as first element of @value_array.
+Insert a copy of @value as first element of @value_array. If @value is
+%NULL, an uninitialized value is prepended.
+
</description>
@@ -5070,7 +5237,7 @@ Insert a copy of @value as first element of @value_array.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> #GValue to copy into #GValueArray
+<parameter_description> #GValue to copy into #GValueArray, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -5430,39 +5597,6 @@ Since: 2.24
</return>
</function>
-<function name="g_variant_get_byte_array">
-<description>
-Gets the contents of an array of bytes #GVariant.
-
-If @length is non-%NULL then it points to a location at which to
-store the length of the array and nul bytes contained within the
-array have no special meaning.
-
-If @length is %NULL then the caller has no way to determine what the
-length of the returned data might be. In this case, the function
-ensures that the last byte of the array is a nul byte and, if it is
-not, returns %NULL instead. In this way, the caller is assured that
-any non-%NULL pointer that is returned will be nul-terminated.
-
-The return value remains valid as long as @value exists.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="value">
-<parameter_description> an array of bytes #GVariant
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> the length of the result, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> a pointer to the byte data, or %NULL
-</return>
-</function>
-
<function name="g_cclosure_marshal_VOID__ENUM">
<description>
A marshaller for a #GCClosure with a callback of type
@@ -6020,22 +6154,22 @@ event = &g_array_index (events, EDayViewEvent, 3);
</return>
</function>
-<function name="g_value_set_flags">
+<function name="g_value_get_variant">
<description>
-Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags.
+Get the contents of a variant #GValue.
+
+Since: 2.26
</description>
<parameters>
<parameter name="value">
-<parameter_description> a valid #GValue whose type is derived from %G_TYPE_FLAGS
-</parameter_description>
-</parameter>
-<parameter name="v_flags">
-<parameter_description> flags value to be set
+<parameter_description> a valid #GValue of type %G_TYPE_VARIANT
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> variant contents of @value
+
+</return>
</function>
<function name="g_checksum_get_string">
@@ -6118,7 +6252,8 @@ Since: 2.24
</parameter_description>
</parameter>
<parameter name="children">
-<parameter_description> an array of #GVariant pointers, the children
+<parameter_description> an array of
+#GVariant pointers, the children
</parameter_description>
</parameter>
<parameter name="n_children">
@@ -6204,8 +6339,11 @@ for it.
Concatenates all of the given strings into one long string.
The returned string should be freed with g_free() when no longer needed.
+Note that this function is usually not the right function to use to
+assemble a translated message from pieces, since proper translation
+often requires the pieces to be reordered.
-<warning><para>The variable argument list <emphasis>must</emphasis> end
+<warning><para>The variable argument list <emphasis>must</emphasis> end
with %NULL. If you forget the %NULL, g_strconcat() will start appending
random memory junk to your string.</para></warning>
@@ -6415,17 +6553,17 @@ Since: 2.12
<function name="g_regex_match">
<description>
-Scans for a match in string for the pattern in @regex.
-The @match_options are combined with the match options specified
-when the @regex structure was created, letting you have more
+Scans for a match in string for the pattern in @regex.
+The @match_options are combined with the match options specified
+when the @regex structure was created, letting you have more
flexibility in reusing #GRegex structures.
-A #GMatchInfo structure, used to get information on the match,
-is stored in @match_info if not %NULL. Note that if @match_info
-is not %NULL then it is created even if the function returns %FALSE,
+A #GMatchInfo structure, used to get information on the match,
+is stored in @match_info if not %NULL. Note that if @match_info
+is not %NULL then it is created even if the function returns %FALSE,
i.e. you must free it regardless if regular expression actually matched.
-To retrieve all the non-overlapping matches of the pattern in
+To retrieve all the non-overlapping matches of the pattern in
string you can use g_match_info_next().
|[
@@ -6450,8 +6588,8 @@ g_regex_unref (regex);
}
]|
- string is not copied and is used in #GMatchInfo internally. If
-you use any #GMatchInfo method (except g_match_info_free()) after
+ string is not copied and is used in #GMatchInfo internally. If
+you use any #GMatchInfo method (except g_match_info_free()) after
freeing or modifying @string then the behaviour is undefined.
Since: 2.14
@@ -6471,8 +6609,8 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="match_info">
-<parameter_description> pointer to location where to store the #GMatchInfo,
-or %NULL if you do not need it
+<parameter_description> pointer to location where to store
+the #GMatchInfo, or %NULL if you do not need it
</parameter_description>
</parameter>
</parameters>
@@ -6662,10 +6800,64 @@ g_utf8_get_char().
</return>
</function>
+<function name="g_object_bind_property_with_closures">
+<description>
+Creates a binding between @source_property on @source and @target_property
+on @target, allowing you to set the transformation functions to be used by
+the binding.
+
+This function is the language bindings friendly version of
+g_object_bind_property_full(), using #GClosure<!-- -->s instead of
+function pointers.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> the source #GObject
+</parameter_description>
+</parameter>
+<parameter name="source_property">
+<parameter_description> the property on @source to bind
+</parameter_description>
+</parameter>
+<parameter name="target">
+<parameter_description> the target #GObject
+</parameter_description>
+</parameter>
+<parameter name="target_property">
+<parameter_description> the property on @target to bind
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to #GBinding
+</parameter_description>
+</parameter>
+<parameter name="transform_to">
+<parameter_description> a #GClosure wrapping the transformation function
+from the @source to the @target, or %NULL to use the default
+</parameter_description>
+</parameter>
+<parameter name="transform_from">
+<parameter_description> a #GClosure wrapping the transformation function
+from the @target to the @source, or %NULL to use the default
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GBinding instance representing the
+binding between the two #GObject instances. The binding is released
+whenever the #GBinding reference count reaches zero.
+
+</return>
+</function>
+
<function name="g_completion_add_items">
<description>
Adds items to the #GCompletion.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -7263,6 +7455,81 @@ a user data argument.
</return>
</function>
+<function name="g_object_bind_property">
+<description>
+Creates a binding between @source_property on @source and @target_property
+on @target. Whenever the @source_property is changed the @target_property is
+updated using the same value. For instance:
+
+|[
+g_object_bind_property (action, "active", widget, "sensitive", 0);
+]|
+
+Will result in the "sensitive" property of the widget #GObject instance to be
+updated with the same value of the "active" property of the action #GObject
+instance.
+
+If @flags contains %G_BINDING_BIDIRECTIONAL then the binding will be mutual:
+if @target_property on @target changes then the @source_property on @source
+will be updated as well.
+
+The binding will automatically be removed when either the @source or the
+ target instances are finalized. To remove the binding without affecting the
+ source and the @target you can just call g_object_unref() on the returned
+#GBinding instance.
+
+A #GObject can have multiple bindings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> the source #GObject
+</parameter_description>
+</parameter>
+<parameter name="source_property">
+<parameter_description> the property on @source to bind
+</parameter_description>
+</parameter>
+<parameter name="target">
+<parameter_description> the target #GObject
+</parameter_description>
+</parameter>
+<parameter name="target_property">
+<parameter_description> the property on @target to bind
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to #GBinding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GBinding instance representing the
+binding between the two #GObject instances. The binding is released
+whenever the #GBinding reference count reaches zero.
+
+</return>
+</function>
+
+<function name="g_binding_get_source">
+<description>
+Retrieves the #GObject instance used as the source of the binding
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="binding">
+<parameter_description> a #GBinding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the source #GObject
+
+</return>
+</function>
+
<function name="g_key_file_to_data">
<description>
This function outputs @key_file as a string.
@@ -7307,7 +7574,7 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the previous match operation succeeded,
+<return> %TRUE if the previous match operation succeeded,
%FALSE otherwise
</return>
@@ -7788,6 +8055,8 @@ or has no lowercase equivalent @c is returned unchanged.
<description>
Frees all memory used by the #GCompletion.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -7841,24 +8110,6 @@ a negative offset in this case.
</return>
</function>
-<function name="g_unichar_xdigit_value">
-<description>
-Determines the numeric value of a character as a hexidecimal
-digit.
-
-
-</description>
-<parameters>
-<parameter name="c">
-<parameter_description> a Unicode character
-</parameter_description>
-</parameter>
-</parameters>
-<return> If @c is a hex digit (according to
-g_unichar_isxdigit()), its numeric value. Otherwise, -1.
-</return>
-</function>
-
<function name="g_spawn_sync">
<description>
Executes a child synchronously (waits for the child to exit before returning).
@@ -8127,7 +8378,8 @@ Since: 2.24
</parameter_description>
</parameter>
<parameter name="length">
-<parameter_description> a pointer to a #gsize, to store the length
+<parameter_description> a pointer to a #gsize,
+to store the length
</parameter_description>
</parameter>
</parameters>
@@ -8568,7 +8820,7 @@ hold the string
<function name="g_variant_is_signature">
<description>
Determines if a given string is a valid DBus type signature. You
-should ensure that a string is a valid DBus object path before
+should ensure that a string is a valid DBus type signature before
passing it to g_variant_new_signature().
DBus type signatures consist of zero or more definite #GVariantType
@@ -8762,6 +9014,10 @@ the first '|' character is returned.
<description>
Emits a "notify" signal for the property @property_name on @object.
+When possible, eg. when signaling a property change from within the class
+that registered the property, you should use g_object_notify_by_pspec()
+instead.
+
</description>
<parameters>
<parameter name="object">
@@ -9114,7 +9370,8 @@ Makes a copy of @error.
<function name="g_value_array_append">
<description>
-Insert a copy of @value as last element of @value_array.
+Insert a copy of @value as last element of @value_array. If @value is
+%NULL, an uninitialized value is appended.
</description>
@@ -9124,7 +9381,7 @@ Insert a copy of @value as last element of @value_array.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> #GValue to copy into #GValueArray
+<parameter_description> #GValue to copy into #GValueArray, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -9835,26 +10092,26 @@ Since: 2.12
<function name="g_regex_match_full">
<description>
-Scans for a match in string for the pattern in @regex.
-The @match_options are combined with the match options specified
-when the @regex structure was created, letting you have more
+Scans for a match in string for the pattern in @regex.
+The @match_options are combined with the match options specified
+when the @regex structure was created, letting you have more
flexibility in reusing #GRegex structures.
-Setting @start_position differs from just passing over a shortened
-string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
+Setting @start_position differs from just passing over a shortened
+string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
that begins with any kind of lookbehind assertion, such as "\b".
-A #GMatchInfo structure, used to get information on the match, is
-stored in @match_info if not %NULL. Note that if @match_info is
-not %NULL then it is created even if the function returns %FALSE,
-i.e. you must free it regardless if regular expression actually
+A #GMatchInfo structure, used to get information on the match, is
+stored in @match_info if not %NULL. Note that if @match_info is
+not %NULL then it is created even if the function returns %FALSE,
+i.e. you must free it regardless if regular expression actually
matched.
- string is not copied and is used in #GMatchInfo internally. If
-you use any #GMatchInfo method (except g_match_info_free()) after
+ string is not copied and is used in #GMatchInfo internally. If
+you use any #GMatchInfo method (except g_match_info_free()) after
freeing or modifying @string then the behaviour is undefined.
-To retrieve all the non-overlapping matches of the pattern in
+To retrieve all the non-overlapping matches of the pattern in
string you can use g_match_info_next().
|[
@@ -9910,8 +10167,8 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="match_info">
-<parameter_description> pointer to location where to store the #GMatchInfo,
-or %NULL if you do not need it
+<parameter_description> pointer to location where to store
+the #GMatchInfo, or %NULL if you do not need it
</parameter_description>
</parameter>
<parameter name="error">
@@ -10174,6 +10431,27 @@ without freeing it.
</return>
</function>
+<function name="g_value_set_variant">
+<description>
+Set the contents of a variant #GValue to @variant.
+If the variant is floating, it is consumed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a valid #GValue of type %G_TYPE_VARIANT
+</parameter_description>
+</parameter>
+<parameter name="variant">
+<parameter_description> a #GVariant, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_strsplit">
<description>
Splits a string into a maximum of @max_tokens pieces, using the given
@@ -11034,6 +11312,54 @@ will return the first entry again.
<return></return>
</function>
+<function name="g_signal_handlers_unblock_matched">
+<description>
+Unblocks all handlers on an instance that match a certain selection
+criteria. The criteria mask is passed as an OR-ed combination of
+#GSignalMatchType flags, and the criteria values are passed as arguments.
+Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC
+or %G_SIGNAL_MATCH_DATA match flags is required for successful matches.
+If no handlers were found, 0 is returned, the number of unblocked handlers
+otherwise. The match criteria should not apply to any handlers that are
+not currently blocked.
+
+
+</description>
+<parameters>
+<parameter name="instance">
+<parameter_description> The instance to unblock handlers from.
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> Mask indicating which of @signal_id, @detail, @closure, @func
+and/or @data the handlers have to match.
+</parameter_description>
+</parameter>
+<parameter name="signal_id">
+<parameter_description> Signal the handlers have to be connected to.
+</parameter_description>
+</parameter>
+<parameter name="detail">
+<parameter_description> Signal detail the handlers have to be connected to.
+</parameter_description>
+</parameter>
+<parameter name="closure">
+<parameter_description> The closure the handlers will invoke.
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> The C closure callback of the handlers (useless for non-C closures).
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> The closure data of the handlers' closures.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The number of handlers that matched.
+</return>
+</function>
+
<function name="g_key_file_has_key">
<description>
Looks whether the key file has the key @key in the group
@@ -11255,9 +11581,9 @@ inside @dest)
</parameter_description>
</parameter>
</parameters>
-<return>size of attempted result, which is
-MIN (dest_size, strlen (original dest)) + strlen (src),
-so if retval >= dest_size, truncation occurred.
+<return> size of attempted result, which is MIN (dest_size, strlen
+(original dest)) + strlen (src), so if retval >= dest_size,
+truncation occurred.
</return>
</function>
@@ -11462,6 +11788,8 @@ Gets a field from the records returned by g_relation_select(). It
returns the given field of the record at the given index. The
returned value should not be changed.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="tuples">
@@ -11567,24 +11895,26 @@ function.
</return>
</function>
-<function name="g_list_nth">
+<function name="g_signal_type_cclosure_new">
<description>
-Gets the element at the given position in a #GList.
+Creates a new closure which invokes the function found at the offset
+ struct_offset in the class structure of the interface or classed type
+identified by @itype.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GList
+<parameter name="itype">
+<parameter_description> the #GType identifier of an interface or classed type
</parameter_description>
</parameter>
-<parameter name="n">
-<parameter_description> the position of the element, counting from 0
+<parameter name="struct_offset">
+<parameter_description> the offset of the member function of @itype's class
+structure which is to be invoked by the new closure
</parameter_description>
</parameter>
</parameters>
-<return> the element, or %NULL if the position is off
-the end of the #GList
+<return> a new #GCClosure
</return>
</function>
@@ -11654,6 +11984,50 @@ Since: 2.12
</return>
</function>
+<function name="g_param_spec_variant">
+<description>
+Creates a new #GParamSpecVariant instance specifying a #GVariant
+property.
+
+If @default_value is floating, it is consumed.
+
+See g_param_spec_internal() for details on property names.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> canonical name of the property specified
+</parameter_description>
+</parameter>
+<parameter name="nick">
+<parameter_description> nick name for the property specified
+</parameter_description>
+</parameter>
+<parameter name="blurb">
+<parameter_description> description of the property specified
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GVariantType
+</parameter_description>
+</parameter>
+<parameter name="default_value">
+<parameter_description> a #GVariant of type @type to use as the
+default value, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags for the property specified
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #GParamSpec
+
+</return>
+</function>
+
<function name="g_source_unref">
<description>
Decreases the reference count of a source by one. If the
@@ -11674,6 +12048,8 @@ memory will be destroyed.
<description>
Inserts a record into a #GRelation.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -11690,6 +12066,27 @@ or #gconstpointer.
<return></return>
</function>
+<function name="g_atomic_int_add">
+<description>
+Atomically adds @val to the integer pointed to by @atomic.
+Also acts as a memory barrier.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to an integer
+</parameter_description>
+</parameter>
+<parameter name="val">
+<parameter_description> the value to add to * atomic
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_ptr_array_remove_index">
<description>
Removes the pointer at the given index from the pointer array. The
@@ -12206,6 +12603,9 @@ string constant must be used each time. Mixing calls to this
function and g_variant_iter_next() or g_variant_iter_next_value() on
the same iterator is not recommended.
+See the section on <link linkend='gvariant-format-strings'>GVariant
+Format Strings</link>.
+
<example>
<title>Memory management with g_variant_iter_loop()</title>
<programlisting>
@@ -12839,6 +13239,31 @@ See g_param_spec_internal() for details on property names.
</return>
</function>
+<function name="g_variant_dup_bytestring">
+<description>
+Similar to g_variant_get_bytestring() except that instead of
+returning a constant string, the string is duplicated.
+
+The return value must be freed using g_free().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> an array-of-bytes #GVariant instance
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a pointer to a #gsize, to store
+the length (not including the nul terminator)
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string
+</return>
+</function>
+
<function name="g_value_set_long">
<description>
Set the contents of a %G_TYPE_LONG #GValue to @v_long.
@@ -12992,6 +13417,36 @@ and unwanted results.</para></note>
<return></return>
</function>
+<function name="g_dcgettext">
+<description>
+This is a variant of g_dgettext() that allows specifying a locale
+category instead of always using %LC_MESSAGES. See g_dgettext() for
+more information about how this functions differs from calling
+dcgettext() directly.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> the translation domain to use, or %NULL to use
+the domain set with textdomain()
+</parameter_description>
+</parameter>
+<parameter name="msgid">
+<parameter_description> message to translate
+</parameter_description>
+</parameter>
+<parameter name="category">
+<parameter_description> a locale category
+</parameter_description>
+</parameter>
+</parameters>
+<return> the translated string for the given locale category
+
+</return>
+</function>
+
<function name="g_strstr_len">
<description>
Searches the string @haystack for the first occurrence
@@ -13575,6 +14030,24 @@ to a #GOptionContext or freed with g_option_group_free().
</return>
</function>
+<function name="g_binding_get_target">
+<description>
+Retrieves the #GObject instance used as the target of the binding
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="binding">
+<parameter_description> a #GBinding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the target #GObject
+
+</return>
+</function>
+
<function name="g_thread_pool_get_max_unused_threads">
<description>
Returns the maximal allowed number of unused threads.
@@ -13924,6 +14397,25 @@ Since: 2.12
</return>
</function>
+<function name="g_binding_get_source_property">
+<description>
+Retrieves the name of the property of #GBinding:source used as the source
+of the binding
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="binding">
+<parameter_description> a #GBinding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the source property
+
+</return>
+</function>
+
<function name="g_queue_pop_nth_link">
<description>
Removes and returns the link at the given position.
@@ -14014,7 +14506,7 @@ Inserts a byte into a #GString, expanding it if necessary.
<description>
Parses @format and returns the result.
- format must be a text format #GVariant with one extention: at any
+ format must be a text format #GVariant with one extension: at any
point that a value may appear in the text, a '%' character followed
by a GVariant format string (as per g_variant_new()) may appear. In
that case, the same arguments are collected from the argument list as
@@ -14585,6 +15077,8 @@ Returns %TRUE if a record with the given values exists in a
#GRelation. Note that the values are compared directly, so that, for
example, two copies of the same string will not match.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -14996,7 +15490,8 @@ the range [ begin @end-1].
<function name="g_value_array_insert">
<description>
-Insert a copy of @value at specified position into @value_array.
+Insert a copy of @value at specified position into @value_array. If @value
+is %NULL, an uninitialized value is inserted.
</description>
@@ -15010,7 +15505,7 @@ Insert a copy of @value at specified position into @value_array.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> #GValue to copy into #GValueArray
+<parameter_description> #GValue to copy into #GValueArray, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -15388,8 +15883,7 @@ be used as the #GCompletion items.
Constructs an array of strings #GVariant from the given array of
strings.
-If @length is not -1 then it gives the maximum length of @strv. In
-any case, a %NULL pointer in @strv is taken as a terminator.
+If @length is -1 then @strv is %NULL-terminated.
Since: 2.24
@@ -16018,7 +16512,13 @@ configuration information such as user preferences and settings.
On UNIX platforms this is determined using the mechanisms described in
the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>
+XDG Base Directory Specification</ulink>.
+In this case the directory retrieved will be XDG_CONFIG_HOME.
+
+On Windows is the directory that serves as a common repository for
+application-specific data. A typical path is
+C:\Documents and Settings\username\Application. See documentation for
+CSIDL_APPDATA.
Since: 2.6
@@ -16532,6 +17032,36 @@ Since: 2.4
<return></return>
</function>
+<function name="g_variant_get_bytestring_array">
+<description>
+Gets the contents of an array of array of bytes #GVariant. This call
+makes a shallow copy; the return result should be released with
+g_free(), but the individual strings must not be modified.
+
+If @length is non-%NULL then the number of elements in the result is
+stored there. In any case, the resulting array will be
+%NULL-terminated.
+
+For an empty array, @length will be set to 0 and a pointer to a
+%NULL pointer will be returned.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> an array of array of bytes #GVariant ('aay')
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the result, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> an array of constant strings
+</return>
+</function>
+
<function name="g_io_add_watch">
<description>
Adds the #GIOChannel into the default main loop context
@@ -16561,6 +17091,28 @@ with the default priority.
</return>
</function>
+<function name="g_variant_new_bytestring">
+<description>
+Creates an array-of-bytes #GVariant with the contents of @string.
+This function is just like g_variant_new_string() except that the
+string need not be valid utf8.
+
+The nul terminator character at the end of the string is stored in
+the array.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a normal nul-terminated string in no particular encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new bytestring #GVariant instance
+</return>
+</function>
+
<function name="g_list_foreach">
<description>
Calls a function for each element of a #GList.
@@ -16725,6 +17277,8 @@ Returns all of the tuples which have the given key in the given
field. Use g_tuples_index() to access the returned records. The
returned records should be freed with g_tuples_destroy().
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -17308,15 +17862,15 @@ g_match_info_is_partial_match().
When using partial matching you cannot use g_match_info_fetch*().
-Because of the way certain internal optimizations are implemented
-the partial matching algorithm cannot be used with all patterns.
-So repeated single characters such as "a{2,4}" and repeated single
-meta-sequences such as "\d+" are not permitted if the maximum number
-of occurrences is greater than one. Optional items such as "\d?"
-(where the maximum is one) are permitted. Quantifiers with any values
-are permitted after parentheses, so the invalid examples above can be
-coded thus "(a){2,4}" and "(\d)+". If #G_REGEX_MATCH_PARTIAL is set
-for a pattern that does not conform to the restrictions, matching
+Because of the way certain internal optimizations are implemented
+the partial matching algorithm cannot be used with all patterns.
+So repeated single characters such as "a{2,4}" and repeated single
+meta-sequences such as "\d+" are not permitted if the maximum number
+of occurrences is greater than one. Optional items such as "\d?"
+(where the maximum is one) are permitted. Quantifiers with any values
+are permitted after parentheses, so the invalid examples above can be
+coded thus "(a){2,4}" and "(\d)+". If #G_REGEX_MATCH_PARTIAL is set
+for a pattern that does not conform to the restrictions, matching
functions return an error.
Since: 2.14
@@ -17376,9 +17930,9 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a %NULL-terminated array of gchar * pointers. It must be
-freed using g_strfreev(). If the previous match failed %NULL is
-returned
+<return> a %NULL-terminated array of gchar * pointers.
+It must be freed using g_strfreev(). If the previous match failed
+%NULL is returned
</return>
</function>
@@ -17481,6 +18035,30 @@ return value can be used exactly like the return value from open().
</return>
</function>
+<function name="g_variant_is_floating">
+<description>
+Checks whether @value has a floating reference count.
+
+This function should only ever be used to assert that a given variant
+is or is not floating, or for debug purposes. To acquire a reference
+to a variant that might be floating, always use g_variant_ref_sink().
+
+See g_variant_ref_sink() for more information about floating reference
+counts.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GVariant
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @value is floating
+</return>
+</function>
+
<function name="g_ascii_toupper">
<description>
Convert a character to ASCII upper case.
@@ -18667,6 +19245,8 @@ Since: 2.6
Sets the function to use for string comparisons. The default string
comparison function is strncmp().
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -18807,6 +19387,8 @@ Sets the value of a date from a #GTimeVal value. Note that the
@tv_usec member is ignored, because #GDate can't make use of the
additional precision.
+The time to date conversion is done using the user's current timezone.
+
Since: 2.10
</description>
@@ -18835,6 +19417,9 @@ function are assumed to point at uninitialised memory. It is the
responsibility of the caller to free all of the values returned by
the unpacking process.
+See the section on <link linkend='gvariant-format-strings'>GVariant
+Format Strings</link>.
+
<example>
<title>Memory management with g_variant_iter_next()</title>
<programlisting>
@@ -18916,6 +19501,8 @@ Destroys the #GRelation, freeing all memory allocated. However, it
does not free memory allocated for the tuple data, so you should
free that first if appropriate.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -18928,14 +19515,14 @@ free that first if appropriate.
<function name="g_regex_check_replacement">
<description>
-Checks whether @replacement is a valid replacement string
-(see g_regex_replace()), i.e. that all escape sequences in
+Checks whether @replacement is a valid replacement string
+(see g_regex_replace()), i.e. that all escape sequences in
it are valid.
-If @has_references is not %NULL then @replacement is checked
+If @has_references is not %NULL then @replacement is checked
for pattern references. For instance, replacement text 'foo\n'
does not contain references and may be evaluated without information
-about actual match, but '\0\1' (whole match followed by first
+about actual match, but '\0\1' (whole match followed by first
subpattern) requires valid #GMatchInfo object.
Since: 2.14
@@ -19448,6 +20035,25 @@ Since: 2.6
</return>
</function>
+<function name="g_atomic_int_get">
+<description>
+Reads the value of the integer pointed to by @atomic.
+Also acts as a memory barrier.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to an integer
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of * atomic
+
+</return>
+</function>
+
<function name="g_main_context_pending">
<description>
Checks if any sources have pending events for the given context.
@@ -19877,6 +20483,7 @@ without a return value.
<description>
Compares @str1 and @str2 like strcmp(). Handles %NULL
gracefully by sorting it before non-%NULL strings.
+Comparing two %NULL pointers returns 0.
Since: 2.16
@@ -20117,12 +20724,12 @@ or %NULL if the #GList has no elements
<function name="g_regex_escape_string">
<description>
-Escapes the special characters used for regular expressions
-in @string, for instance "a.b*c" becomes "a\.b\*c". This
+Escapes the special characters used for regular expressions
+in @string, for instance "a.b*c" becomes "a\.b\*c". This
function is useful to dynamically generate regular expressions.
- string can contain nul characters that are replaced with "\0",
-in this case remember to specify the correct length of @string
+ string can contain nul characters that are replaced with "\0",
+in this case remember to specify the correct length of @string
in @length.
Since: 2.14
@@ -20544,7 +21151,8 @@ Since: 2.24
</parameter_description>
</parameter>
<parameter name="endptr">
-<parameter_description> location to store the end pointer, or %NULL
+<parameter_description> location to store the end pointer,
+or %NULL
</parameter_description>
</parameter>
<parameter name="app">
@@ -20560,6 +21168,8 @@ Since: 2.24
<description>
Removes items from a #GCompletion.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -20664,21 +21274,21 @@ Since: 2.22
<function name="g_snprintf">
<description>
A safer form of the standard sprintf() function. The output is guaranteed
-to not exceed @n characters (including the terminating nul character), so
+to not exceed @n characters (including the terminating nul character), so
it is easy to ensure that a buffer overflow cannot occur.
See also g_strdup_printf().
-In versions of GLib prior to 1.2.3, this function may return -1 if the
-output was truncated, and the truncated string may not be nul-terminated.
-In versions prior to 1.3.12, this function returns the length of the output
+In versions of GLib prior to 1.2.3, this function may return -1 if the
+output was truncated, and the truncated string may not be nul-terminated.
+In versions prior to 1.3.12, this function returns the length of the output
string.
The return value of g_snprintf() conforms to the snprintf()
-function as standardized in ISO C99. Note that this is different from
+function as standardized in ISO C99. Note that this is different from
traditional snprintf(), which returns the length of the output string.
-The format string may contain positional parameters, as specified in
+The format string may contain positional parameters, as specified in
the Single Unix Specification.
@@ -20689,12 +21299,12 @@ the Single Unix Specification.
</parameter_description>
</parameter>
<parameter name="n">
-<parameter_description> the maximum number of bytes to produce (including the
+<parameter_description> the maximum number of bytes to produce (including the
terminating nul character).
</parameter_description>
</parameter>
<parameter name="format">
-<parameter_description> a standard printf() format string, but notice
+<parameter_description> a standard printf() format string, but notice
<link linkend="string-precision">string precision pitfalls</link>.
</parameter_description>
</parameter>
@@ -20831,7 +21441,15 @@ system-wide configuration information.
On UNIX platforms this is determined using the mechanisms described in
the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>
+XDG Base Directory Specification</ulink>.
+In this case the list of directories retrieved will be XDG_CONFIG_DIRS.
+
+On Windows is the directory that contains application data for all users.
+A typical path is C:\Documents and Settings\All Users\Application Data.
+This folder is used for application data that is not user specific.
+For example, an application can store a spell-check dictionary, a database
+of clip art, or a log file in the CSIDL_COMMON_APPDATA folder.
+This information will not roam and is available to anyone using the computer.
Since: 2.6
@@ -20934,7 +21552,8 @@ Since: 2.24
</parameter_description>
</parameter>
<parameter name="endptr">
-<parameter_description> location to store the end pointer, or %NULL
+<parameter_description> location to store the end pointer,
+or %NULL
</parameter_description>
</parameter>
<parameter name="app">
@@ -21002,6 +21621,17 @@ the pool.
</return>
</function>
+<function name="g_variant_get_gtype">
+<description>
+Since: 2.24
+Deprecated: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_key_file_get_integer_list">
<description>
Returns the values associated with @key under @group_name as
@@ -21442,6 +22072,34 @@ Set the contents of a %G_TYPE_INT64 #GValue to @v_int64.
<return></return>
</function>
+<function name="g_atomic_int_compare_and_exchange">
+<description>
+Compares @oldval with the integer pointed to by @atomic and
+if they are equal, atomically exchanges * atomic with @newval.
+Also acts as a memory barrier.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to an integer
+</parameter_description>
+</parameter>
+<parameter name="oldval">
+<parameter_description> the assumed old value of * atomic
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value of * atomic
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if * atomic was equal @oldval. %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_unichar_validate">
<description>
Checks whether @ch is a valid Unicode character. Some possible
@@ -21527,7 +22185,7 @@ See g_param_spec_internal() for details on property names.
<function name="g_cclosure_marshal_VOID__OBJECT">
<description>
A marshaller for a #GCClosure with a callback of type
-<literal>void (*callback) (gpointer instance, GOBject *arg1, gpointer user_data)</literal>.
+<literal>void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)</literal>.
</description>
<parameters>
@@ -22105,11 +22763,11 @@ freed, you should also free the #GStaticPrivate.
<function name="g_regex_replace">
<description>
Replaces all occurrences of the pattern in @regex with the
-replacement text. Backreferences of the form '\number' or
-'\g<number>' in the replacement text are interpolated by the
-number-th captured subexpression of the match, '\g<name>' refers
-to the captured subexpression with the given name. '\0' refers to the
-complete match, but '\0' followed by a number is the octal representation
+replacement text. Backreferences of the form '\number' or
+'\g<number>' in the replacement text are interpolated by the
+number-th captured subexpression of the match, '\g<name>' refers
+to the captured subexpression with the given name. '\0' refers to the
+complete match, but '\0' followed by a number is the octal representation
of a character. To include a literal '\' in the replacement, write '\\'.
There are also escapes that changes the case of the following text:
@@ -22147,8 +22805,8 @@ The @replacement string must be UTF-8 encoded even if #G_REGEX_RAW was
passed to g_regex_new(). If you want to use not UTF-8 encoded stings
you can use g_regex_replace_literal().
-Setting @start_position differs from just passing over a shortened
-string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that
+Setting @start_position differs from just passing over a shortened
+string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that
begins with any kind of lookbehind assertion, such as "\b".
Since: 2.14
@@ -22366,8 +23024,8 @@ characters wherever it matches the empty string between characters.
For example splitting "ab c" using as a separator "\s*", you will get
"a", "b" and "c".
-Setting @start_position differs from just passing over a shortened
-string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
+Setting @start_position differs from just passing over a shortened
+string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
that begins with any kind of lookbehind assertion, such as "\b".
Since: 2.14
@@ -22395,7 +23053,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="max_tokens">
-<parameter_description> the maximum number of tokens to split @string into.
+<parameter_description> the maximum number of tokens to split @string into.
If this is less than 1, the string is split completely
</parameter_description>
</parameter>
@@ -22484,8 +23142,8 @@ Since: 2.8
<description>
Retrieves the text matching the capturing parentheses named @name.
-If @name is a valid sub pattern name but it didn't match anything
-(e.g. sub pattern "X", matching "b" against "(?P<X>a)?b")
+If @name is a valid sub pattern name but it didn't match anything
+(e.g. sub pattern "X", matching "b" against "(?P<X>a)?b")
then an empty string is returned.
The string is fetched from the string passed to the match function,
@@ -22504,8 +23162,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> The matched substring, or %NULL if an error occurred.
-You have to free the string yourself
+<return> The matched substring, or %NULL if an error
+occurred. You have to free the string yourself
</return>
</function>
@@ -22851,11 +23509,11 @@ converted to lowercase.
<function name="g_match_info_get_match_count">
<description>
-Retrieves the number of matched substrings (including substring 0,
-that is the whole matched text), so 1 is returned if the pattern
+Retrieves the number of matched substrings (including substring 0,
+that is the whole matched text), so 1 is returned if the pattern
has no substrings in it and 0 is returned if the match failed.
-If the last match was obtained using the DFA algorithm, that is
+If the last match was obtained using the DFA algorithm, that is
using g_regex_match_all() or g_regex_match_all_full(), the retrieved
count is not that of the number of capturing parentheses but that of
the number of matched substrings.
@@ -23076,7 +23734,7 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> an array of constant strings
+<return> an array of strings
</return>
</function>
@@ -23274,6 +23932,27 @@ more than one element.
<return></return>
</function>
+<function name="g_atomic_int_set">
+<description>
+Sets the value of the integer pointed to by @atomic.
+Also acts as a memory barrier.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to an integer
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_variant_get_uint32">
<description>
Returns the 32-bit unsigned integer value of @value.
@@ -24109,6 +24788,8 @@ Gets the number of nodes in a tree.
Returns the number of tuples in a #GRelation that have the given
value in the given field.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -24244,19 +24925,20 @@ Since: 2.10
<function name="g_variant_new_maybe">
<description>
-Depending on if @value is %NULL, either wraps @value inside of a
+Depending on if @child is %NULL, either wraps @child inside of a
maybe container or creates a Nothing instance for the given @type.
-At least one of @type and @value must be non-%NULL. If @type is
-non-%NULL then it must be a definite type. If they are both
-non-%NULL then @type must be the type of @value.
+At least one of @child_type and @child must be non-%NULL.
+If @child_type is non-%NULL then it must be a definite type.
+If they are both non-%NULL then @child_type must be the type
+of @child.
Since: 2.24
</description>
<parameters>
<parameter name="child_type">
-<parameter_description> the #GVariantType of the child
+<parameter_description> the #GVariantType of the child, or %NULL
</parameter_description>
</parameter>
<parameter name="child">
@@ -24413,40 +25095,28 @@ the last character used in the conversion.
</return>
</function>
-<function name="g_cclosure_marshal_VOID__INT">
+<function name="g_utf8_strlen">
<description>
-A marshaller for a #GCClosure with a callback of type
-<literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal>.
+Computes the length of the string in characters, not including
+the terminating nul character.
+
</description>
<parameters>
-<parameter name="closure">
-<parameter_description> the #GClosure to which the marshaller belongs
-</parameter_description>
-</parameter>
-<parameter name="return_value">
-<parameter_description> ignored
-</parameter_description>
-</parameter>
-<parameter name="n_param_values">
-<parameter_description> 2
-</parameter_description>
-</parameter>
-<parameter name="param_values">
-<parameter_description> a #GValue array holding the instance and the #gint parameter
-</parameter_description>
-</parameter>
-<parameter name="invocation_hint">
-<parameter_description> the invocation hint given as the last argument
-to g_closure_invoke()
+<parameter name="p">
+<parameter_description> pointer to the start of a UTF-8 encoded string
</parameter_description>
</parameter>
-<parameter name="marshal_data">
-<parameter_description> additional data specified when registering the marshaller
+<parameter name="max">
+<parameter_description> the maximum number of bytes to examine. If @max
+is less than 0, then the string is assumed to be
+nul-terminated. If @max is 0, @p will not be examined and
+may be %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the length of the string in characters
+</return>
</function>
<function name="g_tuples_destroy">
@@ -24456,6 +25126,8 @@ should always be called after g_relation_select() when you are
finished with the records. The records are not removed from the
#GRelation.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="tuples">
@@ -24483,32 +25155,21 @@ Since: 2.22
<return></return>
</function>
-<function name="g_uri_unescape_string">
+<function name="g_unichar_xdigit_value">
<description>
-Unescapes a whole escaped string.
-
-If any of the characters in @illegal_characters or the character zero appears
-as an escaped character in @escaped_string then that is an error and %NULL
-will be returned. This is useful it you want to avoid for instance having a
-slash being expanded in an escaped path element, which might confuse pathname
-handling.
+Determines the numeric value of a character as a hexidecimal
+digit.
-Since: 2.16
</description>
<parameters>
-<parameter name="escaped_string">
-<parameter_description> an escaped string to be unescaped.
-</parameter_description>
-</parameter>
-<parameter name="illegal_characters">
-<parameter_description> an optional string of illegal characters not to be allowed.
+<parameter name="c">
+<parameter_description> a Unicode character
</parameter_description>
</parameter>
</parameters>
-<return> an unescaped version of @escaped_string. The returned string
-should be freed when no longer needed.
-
+<return> If @c is a hex digit (according to
+g_unichar_isxdigit()), its numeric value. Otherwise, -1.
</return>
</function>
@@ -24708,32 +25369,32 @@ name/value pairs, followed by %NULL
<function name="g_regex_split_simple">
<description>
-Breaks the string on the pattern, and returns an array of
-the tokens. If the pattern contains capturing parentheses,
-then the text for each of the substrings will also be returned.
-If the pattern does not match anywhere in the string, then the
+Breaks the string on the pattern, and returns an array of
+the tokens. If the pattern contains capturing parentheses,
+then the text for each of the substrings will also be returned.
+If the pattern does not match anywhere in the string, then the
whole string is returned as the first token.
-This function is equivalent to g_regex_split() but it does
-not require to compile the pattern with g_regex_new(), avoiding
-some lines of code when you need just to do a split without
+This function is equivalent to g_regex_split() but it does
+not require to compile the pattern with g_regex_new(), avoiding
+some lines of code when you need just to do a split without
extracting substrings, capture counts, and so on.
If this function is to be called on the same @pattern more than
once, it's more efficient to compile the pattern once with
g_regex_new() and then use g_regex_split().
-As a special case, the result of splitting the empty string ""
-is an empty vector, not a vector containing a single string.
-The reason for this special case is that being able to represent
-a empty vector is typically more useful than consistent handling
-of empty elements. If you do need to represent empty elements,
-you'll need to check for the empty string before calling this
+As a special case, the result of splitting the empty string ""
+is an empty vector, not a vector containing a single string.
+The reason for this special case is that being able to represent
+a empty vector is typically more useful than consistent handling
+of empty elements. If you do need to represent empty elements,
+you'll need to check for the empty string before calling this
function.
-A pattern that can match empty strings splits @string into
-separate characters wherever it matches the empty string between
-characters. For example splitting "ab c" using as a separator
+A pattern that can match empty strings splits @string into
+separate characters wherever it matches the empty string between
+characters. For example splitting "ab c" using as a separator
"\s*", you will get "a", "b" and "c".
Since: 2.14
@@ -25944,6 +26605,8 @@ arrays of this property, may be %NULL
Attempts to complete the string @prefix using the #GCompletion
target items.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -26088,6 +26751,84 @@ Free a #GValueArray including its contents.
<return></return>
</function>
+<function name="g_object_bind_property_full">
+<description>
+Complete version of g_object_bind_property().
+
+Creates a binding between @source_property on @source and @target_property
+on @target, allowing you to set the transformation functions to be used by
+the binding.
+
+If @flags contains %G_BINDING_BIDIRECTIONAL then the binding will be mutual:
+if @target_property on @target changes then the @source_property on @source
+will be updated as well. The @transform_from function is only used in case
+of bidirectional bindings, otherwise it will be ignored
+
+The binding will automatically be removed when either the @source or the
+ target instances are finalized. To remove the binding without affecting the
+ source and the @target you can just call g_object_unref() on the returned
+#GBinding instance.
+
+A #GObject can have multiple bindings.
+
+<note>The same @user_data parameter will be used for both @transform_to
+and @transform_from transformation functions; the @notify function will
+be called once, when the binding is removed. If you need different data
+for each transformation function, please use
+g_object_bind_property_with_closures() instead.</note>
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> the source #GObject
+</parameter_description>
+</parameter>
+<parameter name="source_property">
+<parameter_description> the property on @source to bind
+</parameter_description>
+</parameter>
+<parameter name="target">
+<parameter_description> the target #GObject
+</parameter_description>
+</parameter>
+<parameter name="target_property">
+<parameter_description> the property on @target to bind
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags to pass to #GBinding
+</parameter_description>
+</parameter>
+<parameter name="transform_to">
+<parameter_description> the transformation function
+from the @source to the @target, or %NULL to use the default
+</parameter_description>
+</parameter>
+<parameter name="transform_from">
+<parameter_description> the transformation function
+from the @target to the @source, or %NULL to use the default
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> custom data to be passed to the transformation functions,
+or %NULL
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to be called when disposing the binding, to free the
+resources used by the transformation functions
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GBinding instance representing the
+binding between the two #GObject instances. The binding is released
+whenever the #GBinding reference count reaches zero.
+
+</return>
+</function>
+
<function name="g_object_get_data">
<description>
Gets a named field from the objects table of associations (see g_object_set_data()).
@@ -26443,7 +27184,13 @@ data specific to particular user.
On UNIX platforms this is determined using the mechanisms described in
the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>
+XDG Base Directory Specification</ulink>.
+In this case the directory retrieved will be XDG_CACHE_HOME.
+
+On Windows is the directory that serves as a common repository for
+temporary Internet files. A typical path is
+C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
+See documentation for CSIDL_INTERNET_CACHE.
Since: 2.6
@@ -27005,28 +27752,40 @@ Since: 2.8
</return>
</function>
-<function name="g_utf8_strlen">
+<function name="g_cclosure_marshal_VOID__INT">
<description>
-Computes the length of the string in characters, not including
-the terminating nul character.
-
+A marshaller for a #GCClosure with a callback of type
+<literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal>.
</description>
<parameters>
-<parameter name="p">
-<parameter_description> pointer to the start of a UTF-8 encoded string
+<parameter name="closure">
+<parameter_description> the #GClosure to which the marshaller belongs
</parameter_description>
</parameter>
-<parameter name="max">
-<parameter_description> the maximum number of bytes to examine. If @max
-is less than 0, then the string is assumed to be
-nul-terminated. If @max is 0, @p will not be examined and
-may be %NULL.
+<parameter name="return_value">
+<parameter_description> ignored
+</parameter_description>
+</parameter>
+<parameter name="n_param_values">
+<parameter_description> 2
+</parameter_description>
+</parameter>
+<parameter name="param_values">
+<parameter_description> a #GValue array holding the instance and the #gint parameter
+</parameter_description>
+</parameter>
+<parameter name="invocation_hint">
+<parameter_description> the invocation hint given as the last argument
+to g_closure_invoke()
+</parameter_description>
+</parameter>
+<parameter name="marshal_data">
+<parameter_description> additional data specified when registering the marshaller
</parameter_description>
</parameter>
</parameters>
-<return> the length of the string in characters
-</return>
+<return></return>
</function>
<function name="g_source_remove_by_funcs_user_data">
@@ -28567,7 +29326,7 @@ g_ascii_isdigit()), its numeric value. Otherwise, -1.
<function name="g_regex_get_pattern">
<description>
-Gets the pattern string associated with @regex, i.e. a copy of
+Gets the pattern string associated with @regex, i.e. a copy of
the string passed to g_regex_new().
Since: 2.14
@@ -28605,8 +29364,8 @@ Since 2.24
<function name="g_regex_new">
<description>
-Compiles the regular expression to an internal form, and does
-the initial setup of the #GRegex structure.
+Compiles the regular expression to an internal form, and does
+the initial setup of the #GRegex structure.
Since: 2.14
@@ -28617,7 +29376,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="compile_options">
-<parameter_description> compile options for the regular expression, or 0
+<parameter_description> compile options for the regular expression, or 0
</parameter_description>
</parameter>
<parameter name="match_options">
@@ -28629,32 +29388,30 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> a #GRegex structure. Call g_regex_unref() when you
+<return> a #GRegex structure. Call g_regex_unref() when you
are done with it
</return>
</function>
-<function name="g_signal_type_cclosure_new">
+<function name="g_list_nth">
<description>
-Creates a new closure which invokes the function found at the offset
- struct_offset in the class structure of the interface or classed type
-identified by @itype.
+Gets the element at the given position in a #GList.
</description>
<parameters>
-<parameter name="itype">
-<parameter_description> the #GType identifier of an interface or classed type
+<parameter name="list">
+<parameter_description> a #GList
</parameter_description>
</parameter>
-<parameter name="struct_offset">
-<parameter_description> the offset of the member function of @itype's class
-structure which is to be invoked by the new closure
+<parameter name="n">
+<parameter_description> the position of the element, counting from 0
</parameter_description>
</parameter>
</parameters>
-<return> a new #GCClosure
+<return> the element, or %NULL if the position is off
+the end of the #GList
</return>
</function>
@@ -29458,21 +30215,26 @@ be redirected, or %NULL if none.
<function name="g_sprintf">
<description>
-An implementation of the standard sprintf() function which supports
+An implementation of the standard sprintf() function which supports
positional parameters, as specified in the Single Unix Specification.
+Note that it is usually better to use g_snprintf(), to avoid the
+risk of buffer overflow.
+
+See also g_strdup_printf().
+
Since: 2.2
</description>
<parameters>
<parameter name="string">
-<parameter_description> A pointer to a memory buffer to contain the resulting string. It
-is up to the caller to ensure that the allocated buffer is large
+<parameter_description> A pointer to a memory buffer to contain the resulting string. It
+is up to the caller to ensure that the allocated buffer is large
enough to hold the formatted result
</parameter_description>
</parameter>
<parameter name="format">
-<parameter_description> a standard printf() format string, but notice
+<parameter_description> a standard printf() format string, but notice
<link linkend="string-precision">string precision pitfalls</link>.
</parameter_description>
</parameter>
@@ -29576,6 +30338,27 @@ Since: 2.6
</return>
</function>
+<function name="g_atomic_pointer_set">
+<description>
+Sets the value of the pointer pointed to by @atomic.
+Also acts as a memory barrier.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to a #gpointer
+</parameter_description>
+</parameter>
+<parameter name="newval">
+<parameter_description> the new value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mutex_unlock">
<description>
Unlocks @mutex. If another thread is blocked in a g_mutex_lock()
@@ -29681,6 +30464,8 @@ Works like g_mutex_trylock(), but for a #GStaticMutex.
<description>
Removes all items from the #GCompletion.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="cmp">
@@ -29740,12 +30525,11 @@ Note that this function doesn't protect whitespace and line endings
from being processed according to the XML rules for normalization
of line endings and attribute values.
-Note also that if given a string containing them, this function
-will produce character references in the range of &#x1; ..
-&#x1f; for all control sequences except for tabstop, newline
-and carriage return. The character references in this range are
-not valid XML 1.0, but they are valid XML 1.1 and will be accepted
-by the GMarkup parser.
+Note also that this function will produce character references in
+the range of &#x1; ... &#x1f; for all control sequences
+except for tabstop, newline and carriage return. The character
+references in this range are not valid XML 1.0, but they are
+valid XML 1.1 and will be accepted by the GMarkup parser.
</description>
@@ -30384,6 +31168,51 @@ GLib and should not be modified or freed.
</return>
</function>
+<function name="g_variant_builder_add_parsed">
+<description>
+Adds to a #GVariantBuilder.
+
+This call is a convenience wrapper that is exactly equivalent to
+calling g_variant_new_parsed() followed by
+g_variant_builder_add_value().
+
+This function might be used as follows:
+
+<programlisting>
+GVariant *
+make_pointless_dictionary (void)
+{
+GVariantBuilder *builder;
+int i;
+
+builder = g_variant_builder_new (G_VARIANT_TYPE_ARRAY);
+g_variant_builder_add_parsed (builder, "{'width', <%i>}", 600);
+g_variant_builder_add_parsed (builder, "{'title', <%s>}", "foo");
+g_variant_builder_add_parsed (builder, "{'transparency', <0.5>}");
+return g_variant_builder_end (builder);
+}
+</programlisting>
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GVariantBuilder
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a text format #GVariant
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> arguments as per @format
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_strcasecmp">
<description>
A case-insensitive string comparison, corresponding to the standard
@@ -30681,18 +31510,18 @@ before threading system intialization.
<function name="g_match_info_fetch">
<description>
-Retrieves the text matching the @match_num<!-- -->'th capturing
-parentheses. 0 is the full text of the match, 1 is the first paren
+Retrieves the text matching the @match_num<!-- -->'th capturing
+parentheses. 0 is the full text of the match, 1 is the first paren
set, 2 the second, and so on.
-If @match_num is a valid sub pattern but it didn't match anything
-(e.g. sub pattern 1, matching "b" against "(a)?b") then an empty
+If @match_num is a valid sub pattern but it didn't match anything
+(e.g. sub pattern 1, matching "b" against "(a)?b") then an empty
string is returned.
If the match was obtained using the DFA algorithm, that is using
g_regex_match_all() or g_regex_match_all_full(), the retrieved
string is not that of a set of parentheses but that of a matched
-substring. Substrings are matched in reverse order of length, so
+substring. Substrings are matched in reverse order of length, so
0 is the longest match.
The string is fetched from the string passed to the match function,
@@ -30711,8 +31540,8 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> The matched substring, or %NULL if an error occurred.
-You have to free the string yourself
+<return> The matched substring, or %NULL if an error
+occurred. You have to free the string yourself
</return>
</function>
@@ -31899,6 +32728,24 @@ Adds a new element at the tail of the queue.
<return></return>
</function>
+<function name="g_binding_get_flags">
+<description>
+Retrieves the flags passed when constructing the #GBinding
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="binding">
+<parameter_description> a #GBinding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GBindingFlags used by the #GBinding
+
+</return>
+</function>
+
<function name="g_access">
<description>
A wrapper for the POSIX access() function. This function is used to
@@ -32450,6 +33297,25 @@ to the string.
</return>
</function>
+<function name="g_binding_get_target_property">
+<description>
+Retrieves the name of the property of #GBinding:target used as the target
+of the binding
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="binding">
+<parameter_description> a #GBinding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the target property
+
+</return>
+</function>
+
<function name="g_param_spec_uint64">
<description>
Creates a new #GParamSpecUInt64 instance specifying a %G_TYPE_UINT64
@@ -32811,6 +33677,8 @@ is empty.
Outputs information about all records in a #GRelation, as well as
the indexes. It is for debugging.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="relation">
@@ -32968,6 +33836,39 @@ positive and NUL is met before @max_len bytes have been read.
</return>
</function>
+<function name="g_value_take_variant">
+<description>
+Set the contents of a variant #GValue to @variant, and takes over
+the ownership of the caller's reference to @variant;
+the caller doesn't have to unref it any more (i.e. the reference
+count of the variant is not increased).
+
+It is a programmer error to pass a floating variant to this function.
+In particular this means that callbacks in closures, and signal handlers
+for signals of return type %G_TYPE_VARIANT, must never return floating
+variants.
+
+If you want the #GValue to hold its own reference to @variant, use
+g_value_set_variant() instead.
+
+This is an internal function introduced mainly for C marshallers.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a valid #GValue of type %G_TYPE_VARIANT
+</parameter_description>
+</parameter>
+<parameter name="variant">
+<parameter_description> a #GVariant, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_utf8_collate_key">
<description>
Converts a string into a collation key that can be compared
@@ -33800,6 +34701,24 @@ without a return value
</return>
</function>
+<function name="g_value_set_flags">
+<description>
+Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags.
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a valid #GValue whose type is derived from %G_TYPE_FLAGS
+</parameter_description>
+</parameter>
+<parameter name="v_flags">
+<parameter_description> flags value to be set
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_io_channel_set_close_on_unref">
<description>
Setting this flag to %TRUE for a channel you have already closed
@@ -35405,8 +36324,8 @@ corresponding #GMutex for @mutex.
<description>
Retrieves the position in bytes of the capturing parentheses named @name.
-If @name is a valid sub pattern name but it didn't match anything
-(e.g. sub pattern "X", matching "b" against "(?P<X>a)?b")
+If @name is a valid sub pattern name but it didn't match anything
+(e.g. sub pattern "X", matching "b" against "(?P<X>a)?b")
then @start_pos and @end_pos are set to -1 and %TRUE is returned.
Since: 2.14
@@ -35422,21 +36341,54 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="start_pos">
-<parameter_description> pointer to location where to store the start position
+<parameter_description> pointer to location where to store
+the start position, or %NULL
</parameter_description>
</parameter>
<parameter name="end_pos">
-<parameter_description> pointer to location where to store the end position
+<parameter_description> pointer to location where to store
+the end position, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the position was fetched, %FALSE otherwise. If
-the position cannot be fetched, @start_pos and @end_pos are left
-unchanged
+<return> %TRUE if the position was fetched, %FALSE otherwise.
+If the position cannot be fetched, @start_pos and @end_pos
+are left unchanged.
</return>
</function>
+<function name="g_variant_get_bytestring">
+<description>
+Returns the string value of a #GVariant instance with an
+array-of-bytes type. The string has no particular encoding.
+
+If the array does not end with a nul terminator character, the empty
+string is returned. For this reason, you can always trust that a
+non-%NULL nul-terminated string will be returned by this function.
+
+If the array contains a nul terminator character somewhere other than
+the last byte then the returned string is the string, up to the first
+such nul character.
+
+It is an error to call this function with a @value that is not an
+array of bytes.
+
+The return value remains valid as long as @value exists.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> an array-of-bytes #GVariant instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the constant string
+</return>
+</function>
+
<function name="g_regex_split">
<description>
Breaks the string on the pattern, and returns an array of the tokens.
@@ -35719,18 +36671,18 @@ Since: 2.24
<function name="g_regex_replace_eval">
<description>
-Replaces occurrences of the pattern in regex with the output of
+Replaces occurrences of the pattern in regex with the output of
@eval for that occurrence.
-Setting @start_position differs from just passing over a shortened
-string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
+Setting @start_position differs from just passing over a shortened
+string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern
that begins with any kind of lookbehind assertion, such as "\b".
The following example uses g_regex_replace_eval() to replace multiple
strings at once:
|[
-static gboolean
-eval_cb (const GMatchInfo *info,
+static gboolean
+eval_cb (const GMatchInfo *info,
GString *res,
gpointer data)
{
@@ -35771,10 +36723,7 @@ Since: 2.14
<parameters>
<parameter name="regex">
<parameter_description> a #GRegex structure from g_regex_new()
-</parameter_description>
-</parameter>
-<parameter name="string">
-<parameter_description> string to perform matches against
+ string (array length=string_len): string to perform matches against
</parameter_description>
</parameter>
<parameter name="string_len">
@@ -35873,33 +36822,6 @@ URI cannot be found.
</return>
</function>
-<function name="g_variant_new_byte_array">
-<description>
-Constructs an array of bytes #GVariant from the given array of bytes.
-
-If @length is -1 then @array is taken to be a normal C string (in the
-sense that it is terminated by a nul character). The nul character
-is included in the array. If length is not -1 then it gives the
-length of @array which may then contain nul chracters with no special
-meaning.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="array">
-<parameter_description> a pointer to an array of bytes
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> the length of @array, or -1
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new floating #GVariant instance
-</return>
-</function>
-
<function name="g_strrstr_len">
<description>
Searches the string @haystack for the last occurrence
@@ -36106,18 +37028,18 @@ is undefined.
<function name="g_match_info_fetch_pos">
<description>
-Retrieves the position in bytes of the @match_num<!-- -->'th capturing
-parentheses. 0 is the full text of the match, 1 is the first
+Retrieves the position in bytes of the @match_num<!-- -->'th capturing
+parentheses. 0 is the full text of the match, 1 is the first
paren set, 2 the second, and so on.
-If @match_num is a valid sub pattern but it didn't match anything
-(e.g. sub pattern 1, matching "b" against "(a)?b") then @start_pos
+If @match_num is a valid sub pattern but it didn't match anything
+(e.g. sub pattern 1, matching "b" against "(a)?b") then @start_pos
and @end_pos are set to -1 and %TRUE is returned.
If the match was obtained using the DFA algorithm, that is using
g_regex_match_all() or g_regex_match_all_full(), the retrieved
position is not that of a set of parentheses but that of a matched
-substring. Substrings are matched in reverse order of length, so
+substring. Substrings are matched in reverse order of length, so
0 is the longest match.
Since: 2.14
@@ -36133,16 +37055,18 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="start_pos">
-<parameter_description> pointer to location where to store the start position
+<parameter_description> pointer to location where to store
+the start position, or %NULL
</parameter_description>
</parameter>
<parameter name="end_pos">
-<parameter_description> pointer to location where to store the end position
+<parameter_description> pointer to location where to store
+the end position, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the position was fetched, %FALSE otherwise. If
-the position cannot be fetched, @start_pos and @end_pos are left
+<return> %TRUE if the position was fetched, %FALSE otherwise. If
+the position cannot be fetched, @start_pos and @end_pos are left
unchanged
</return>
@@ -36341,6 +37265,63 @@ g_array_remove_index().
</return>
</function>
+<function name="g_object_notify_by_pspec">
+<description>
+Emits a "notify" signal for the property specified by @pspec on @object.
+
+This function omits the property name lookup, hence it is faster than
+g_object_notify().
+
+One way to avoid using g_object_notify() from within the
+class that registered the properties, and using g_object_notify_by_pspec()
+instead, is to store the GParamSpec used with
+g_object_class_install_property() inside a static array, e.g.:
+
+|[
+enum
+{
+PROP_0,
+PROP_FOO,
+PROP_LAST
+};
+
+static GParamSpec *properties[PROP_LAST];
+
+static void
+my_object_class_init (MyObjectClass *klass)
+{
+properties[PROP_FOO] = g_param_spec_int ("foo", "Foo", "The foo",
+0, 100,
+50,
+G_PARAM_READWRITE);
+g_object_class_install_property (gobject_class,
+PROP_FOO,
+properties[PROP_FOO]);
+}
+]|
+
+and then notify a change on the "foo" property with:
+
+|[
+g_object_notify_by_pspec (self, properties[PROP_FOO]);
+]|
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="pspec">
+<parameter_description> the #GParamSpec of a property installed on the class of @object.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_test_rand_int_range">
<description>
Get a reproducible random integer number out of a specified range,
@@ -37053,24 +38034,32 @@ Since: 2.14
</return>
</function>
-<function name="g_path_get_basename">
+<function name="g_uri_unescape_string">
<description>
-Gets the last component of the filename. If @file_name ends with a
-directory separator it gets the component before the last slash. If
- file_name consists only of directory separators (and on Windows,
-possibly a drive letter), a single separator is returned. If
- file_name is empty, it gets ".".
+Unescapes a whole escaped string.
+If any of the characters in @illegal_characters or the character zero appears
+as an escaped character in @escaped_string then that is an error and %NULL
+will be returned. This is useful it you want to avoid for instance having a
+slash being expanded in an escaped path element, which might confuse pathname
+handling.
+
+Since: 2.16
</description>
<parameters>
-<parameter name="file_name">
-<parameter_description> the name of the file.
+<parameter name="escaped_string">
+<parameter_description> an escaped string to be unescaped.
+</parameter_description>
+</parameter>
+<parameter name="illegal_characters">
+<parameter_description> an optional string of illegal characters not to be allowed.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string containing the last component of
-the filename.
+<return> an unescaped version of @escaped_string. The returned string
+should be freed when no longer needed.
+
</return>
</function>
@@ -37361,6 +38350,30 @@ g_object_set_qdata_full().
</return>
</function>
+<function name="g_atomic_int_exchange_and_add">
+<description>
+Atomically adds @val to the integer pointed to by @atomic.
+It returns the value of * atomic just before the addition
+took place. Also acts as a memory barrier.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="atomic">
+<parameter_description> a pointer to an integer
+</parameter_description>
+</parameter>
+<parameter name="val">
+<parameter_description> the value to add to * atomic
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of * atomic before the addition.
+
+</return>
+</function>
+
<function name="g_object_new_valist">
<description>
Creates a new instance of a #GObject subtype and sets its properties.
@@ -37936,6 +38949,8 @@ if the call was interrupted.
Creates a new #GRelation with the given number of fields. Note that
currently the number of fields must be 2.
+Deprecated: 2.26: Rarely used API
+
</description>
<parameters>
<parameter name="fields">
@@ -38407,6 +39422,44 @@ when registering @notify_func
<return></return>
</function>
+<function name="g_cclosure_marshal_BOOLEAN__OBJECT_BOXED_BOXED">
+<description>
+A marshaller for a #GCClosure with a callback of type
+<literal>gboolean (*callback) (gpointer instance, GBoxed *arg1, GBoxed *arg2, gpointer user_data)</literal>.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="closure">
+<parameter_description> the #GClosure to which the marshaller belongs
+</parameter_description>
+</parameter>
+<parameter name="return_value">
+<parameter_description> a #GValue, which can store the returned string
+</parameter_description>
+</parameter>
+<parameter name="n_param_values">
+<parameter_description> 3
+</parameter_description>
+</parameter>
+<parameter name="param_values">
+<parameter_description> a #GValue array holding instance, arg1 and arg2
+</parameter_description>
+</parameter>
+<parameter name="invocation_hint">
+<parameter_description> the invocation hint given as the last argument
+to g_closure_invoke()
+</parameter_description>
+</parameter>
+<parameter name="marshal_data">
+<parameter_description> additional data specified when registering the marshaller
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_signal_override_class_closure">
<description>
Overrides the class closure (i.e. the default handler) for the given signal
@@ -39005,7 +40058,7 @@ Since: 2.14
</parameter_description>
</parameter>
</parameters>
-<return> The number of the subexpression or -1 if @name
+<return> The number of the subexpression or -1 if @name
does not exists
</return>
@@ -39443,19 +40496,19 @@ Since: 2.12
<function name="g_regex_match_all">
<description>
-Using the standard algorithm for regular expression matching only
-the longest match in the string is retrieved. This function uses
+Using the standard algorithm for regular expression matching only
+the longest match in the string is retrieved. This function uses
a different algorithm so it can retrieve all the possible matches.
For more documentation see g_regex_match_all_full().
-A #GMatchInfo structure, used to get information on the match, is
-stored in @match_info if not %NULL. Note that if @match_info is
-not %NULL then it is created even if the function returns %FALSE,
-i.e. you must free it regardless if regular expression actually
+A #GMatchInfo structure, used to get information on the match, is
+stored in @match_info if not %NULL. Note that if @match_info is
+not %NULL then it is created even if the function returns %FALSE,
+i.e. you must free it regardless if regular expression actually
matched.
- string is not copied and is used in #GMatchInfo internally. If
-you use any #GMatchInfo method (except g_match_info_free()) after
+ string is not copied and is used in #GMatchInfo internally. If
+you use any #GMatchInfo method (except g_match_info_free()) after
freeing or modifying @string then the behaviour is undefined.
Since: 2.14
@@ -39475,8 +40528,8 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="match_info">
-<parameter_description> pointer to location where to store the #GMatchInfo,
-or %NULL if you do not need it
+<parameter_description> pointer to location where to store
+the #GMatchInfo, or %NULL if you do not need it
</parameter_description>
</parameter>
</parameters>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
