[glibmm] gio_docs.xml: Regenerate with the new doc extraction tool.
- From: José Alburquerque <jaalburqu src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] gio_docs.xml: Regenerate with the new doc extraction tool.
- Date: Thu, 29 Apr 2010 19:54:47 +0000 (UTC)
commit b62f53d438b00cab9f963458b4c649bfccfa9b25
Author: José Alburquerque <jaalburqu svn gnome org>
Date: Thu Apr 29 15:52:06 2010 -0400
gio_docs.xml: Regenerate with the new doc extraction tool.
* gio/src/gio_docs.xml: Regenerate docs with the latest
docextract_to_xml.py in pygobject to get better docs in general.
ChangeLog | 7 +
gio/src/gio_docs.xml | 8314 ++++++++++++++++++++++++--------------------------
2 files changed, 4031 insertions(+), 4290 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index b35c6ec..366571c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2010-04-29 José Alburquerque <jaalburqu svn gnome org>
+
+ gio_docs.xml: Regenerate with the new doc extraction tool.
+
+ * gio/src/gio_docs.xml: Regenerate docs with the latest
+ docextract_to_xml.py in pygobject to get better docs in general.
+
2010-04-27 David King <davidk openismus com>
Further changes to main page documentation
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 34868fd..6cdca96 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -103,6 +103,20 @@ result of the operation.
<return></return>
</function>
+<function name="g_input_stream_clear_pending">
+<description>
+Clears the pending flag on @stream.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> input stream
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_attribute_info_list_ref">
<description>
References a file attribute info list.
@@ -135,37 +149,21 @@ Checks if the file enumerator has been closed.
</return>
</function>
-<function name="g_loadable_icon_load">
+<function name="g_srv_target_get_port">
<description>
-Loads a loadable icon. For the asynchronous version of this function,
-see g_loadable_icon_load_async().
+Gets @target's port
+Since: 2.22
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GLoadableIcon.
-</parameter_description>
-</parameter>
-<parameter name="size">
-<parameter_description> an integer.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a location to store the type of the loaded icon, %NULL to ignore.
-</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 name="target">
+<parameter_description> a #GSrvTarget
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream to read the icon from.
+<return> @target's port
+
</return>
</function>
@@ -226,6 +224,22 @@ if possible.
<return></return>
</function>
+<function name="g_io_extension_get_type">
+<description>
+Gets the type associated with @extension.
+
+
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of @extension
+</return>
+</function>
+
<function name="g_drive_is_media_check_automatic">
<description>
Checks if @drive is capabable of automatically detecting media changes.
@@ -243,6 +257,22 @@ media changes, %FALSE otherwise.
</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_cancellable_reset">
<description>
Resets @cancellable to its uncancelled state.
@@ -257,6 +287,43 @@ Resets @cancellable to its uncancelled state.
<return></return>
</function>
+<function name="g_socket_client_connect_to_service_async">
+<description>
+This is the asynchronous version of
+g_socket_client_connect_to_service().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a domain name
+</parameter_description>
+</parameter>
+<parameter name="service">
+<parameter_description> the name of the service to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_unix_mount_monitor_new">
<description>
Gets a new #GUnixMountMonitor. The default rate limit for which the
@@ -272,32 +339,25 @@ g_unix_mount_monitor_set_rate_limit() to change this.
</return>
</function>
-<function name="g_unix_fd_list_new_from_array">
+<function name="g_app_info_delete">
<description>
-Creates a new #GUnixFDList containing the file descriptors given in
- fds The file descriptors become the property of the new list and
-may no longer be used by the caller. The array itself is owned by
-the caller.
-
-Each file descriptor in the array should be set to close-on-exec.
+Tries to delete a #GAppInfo.
-If @n_fds is -1 then @fds must be terminated with -1.
+On some platforms, there may be a difference between user-defined
+#GAppInfo<!-- -->s which can be deleted, and system-wide ones which
+cannot. See g_app_info_can_delete().
+Since: 2.20
</description>
<parameters>
-<parameter name="fds">
-<parameter_description> the initial list of file descriptors
-</parameter_description>
-</parameter>
-<parameter name="n_fds">
-<parameter_description> the length of #fds, or -1
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
</parameters>
-<return> a new #GUnixFDList
+<return> %TRUE if @appinfo has been deleted
-Since: 2.24
</return>
</function>
@@ -308,6 +368,7 @@ service will accept new clients that connect, while
a non-active service will let connecting clients queue
up until the service is started.
+Since: 2.22
</description>
<parameters>
@@ -318,7 +379,6 @@ up until the service is started.
</parameters>
<return> %TRUE if the service is active, %FALSE otherwise
-Since: 2.22
</return>
</function>
@@ -363,9 +423,46 @@ Gets the file's size.
</return>
</function>
+<function name="g_resolver_lookup_by_address_async">
+<description>
+Begins asynchronously reverse-resolving @address to determine its
+associated hostname, and eventually calls @callback, which must
+call g_resolver_lookup_by_address_finish() to get the final result.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> the address to reverse-resolve
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_control_message_get_level">
<description>
-Returns: an integer describing the level
+Returns the "level" (i.e. the originating protocol) of the control message.
+This is often SOL_SOCKET.
+
+Since: 2.22
</description>
<parameters>
@@ -376,24 +473,25 @@ Returns: an integer describing the level
</parameters>
<return> an integer describing the level
-Since: 2.22
</return>
</function>
-<function name="g_unix_mount_point_guess_can_eject">
+<function name="g_filter_input_stream_set_close_base_stream">
<description>
-Guesses whether a Unix mount point can be ejected.
-
+Sets whether the base stream will be closed when @stream is closed.
</description>
<parameters>
-<parameter name="mount_point">
-<parameter_description> a #GUnixMountPoint
+<parameter name="stream">
+<parameter_description> a #GFilterInputStream.
+</parameter_description>
+</parameter>
+<parameter name="close_base">
+<parameter_description> %TRUE to close the base stream.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @mount_point is deemed to be ejectable.
-</return>
+<return></return>
</function>
<function name="g_file_info_set_attribute">
@@ -422,10 +520,40 @@ Sets the @attribute to contain the given value, if possible.
<return></return>
</function>
+<function name="g_async_initable_new_finish">
+<description>
+Finishes the async construction for the various g_async_initable_new calls,
+returning the created object or %NULL on error.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="initable">
+<parameter_description> the #GAsyncInitable from the callback
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> the #GAsyncResult.from the callback
+</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 newly created #GObject, or %NULL on error. Free with
+g_object_unref().
+
+</return>
+</function>
+
<function name="g_zlib_compressor_new">
<description>
Creates a new #GZlibCompressor.
+Since: 2.24
</description>
<parameters>
@@ -440,7 +568,6 @@ Creates a new #GZlibCompressor.
</parameters>
<return> a new #GZlibCompressor
-Since: 2.24
</return>
</function>
@@ -480,6 +607,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<description>
Checks if a stream has pending actions.
+Since: 2.22
</description>
<parameters>
@@ -490,7 +618,6 @@ Checks if a stream has pending actions.
</parameters>
<return> %TRUE if @stream has pending actions.
-Since: 2.22
</return>
</function>
@@ -615,104 +742,80 @@ Sets the mount operation's domain.
<return></return>
</function>
-<function name="g_content_type_from_mime_type">
+<function name="g_file_info_set_sort_order">
<description>
-Tries to find a content type based on the mime type name.
-
+Sets the sort order attribute in the file info structure. See
+%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
</description>
<parameters>
-<parameter name="mime_type">
-<parameter_description> a mime type string.
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
-</parameters>
-<return> Newly allocated string with content type or NULL when does not know.
-
-Since: 2.18
-</return>
-</function>
-
-<function name="GUnixMountMonitor">
-<description>
-Emitted when the unix mount points have changed.
-
-</description>
-<parameters>
-<parameter name="monitor">
-<parameter_description> the object on which the signal is emitted
+<parameter name="sort_order">
+<parameter_description> a sort order integer.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_listener_new">
-<description>
-Creates a new #GSocketListener with no sockets to listen for.
-New listeners can be added with e.g. g_socket_listener_add_address()
-or g_socket_listener_add_inet_port().
-
-
-</description>
-<parameters>
-</parameters>
-<return> a new #GSocketListener.
-
-Since: 2.22
-</return>
-</function>
-
-<function name="g_resolver_lookup_by_address_async">
+<function name="g_loadable_icon_load">
<description>
-Begins asynchronously reverse-resolving @address to determine its
-associated hostname, and eventually calls @callback, which must
-call g_resolver_lookup_by_address_finish() to get the final result.
+Loads a loadable icon. For the asynchronous version of this function,
+see g_loadable_icon_load_async().
-Since: 2.22
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
+<parameter name="icon">
+<parameter_description> a #GLoadableIcon.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> the address to reverse-resolve
+<parameter name="size">
+<parameter_description> an integer.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="type">
+<parameter_description> a location to store the type of the loaded icon, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GInputStream to read the icon from.
+</return>
</function>
-<function name="g_volume_enumerate_identifiers">
+<function name="g_inet_address_new_from_bytes">
<description>
-Gets the kinds of <link linkend="volume-identifier">identifiers</link>
-that @volume has. Use g_volume_get_identifer() to obtain
-the identifiers themselves.
+Creates a new #GInetAddress from the given @family and @bytes.
+ bytes should be 4 bytes for %G_INET_ADDRESS_IPV4 and 16 bytes for
+%G_INET_ADDRESS_IPV6.
+Since: 2.22
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume
+<parameter name="bytes">
+<parameter_description> raw address data
+</parameter_description>
+</parameter>
+<parameter name="family">
+<parameter_description> the address family of @bytes
</parameter_description>
</parameter>
</parameters>
-<return> a %NULL-terminated array of strings containing
-kinds of identifiers. Use g_strfreev() to free.
+<return> a new #GInetAddress corresponding to @family and @bytes.
+
</return>
</function>
@@ -723,7 +826,7 @@ for the availibility of the specified @condition on the socket.
The callback on the source is of the #GSocketSourceFunc type.
-It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
+It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition;
these conditions will always be reported output if they are true.
@cancellable if not %NULL can be used to cancel the source, which will
@@ -732,6 +835,13 @@ is likely 0 unless cancellation happened at the same time as a
condition change). You can check for this in the callback using
g_cancellable_is_cancelled().
+If @socket has a timeout set, and it is reached before @condition
+occurs, the source will then trigger anyway, reporting %G_IO_IN or
+%G_IO_OUT depending on @condition. However, @socket will have been
+marked as having had a timeout, and so the next #GSocket I/O method
+you call will then fail with a %G_IO_ERROR_TIMED_OUT.
+
+Since: 2.22
</description>
<parameters>
@@ -750,26 +860,6 @@ g_cancellable_is_cancelled().
</parameters>
<return> a newly allocated %GSource, free with g_source_unref().
-Since: 2.22
-</return>
-</function>
-
-<function name="g_inet_address_new_loopback">
-<description>
-Creates a #GInetAddress for the loopback address for @family.
-
-
-</description>
-<parameters>
-<parameter name="family">
-<parameter_description> the address family
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GInetAddress corresponding to the loopback address
-for @family.
-
-Since: 2.22
</return>
</function>
@@ -805,55 +895,22 @@ Gets a password from the mount operation.
</return>
</function>
-<function name="g_output_stream_close">
+<function name="g_inet_socket_address_get_address">
<description>
-Closes the stream, releasing resources related to it.
-
-Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
-Closing a stream multiple times will not return an error.
-
-Closing a stream will automatically flush any outstanding buffers in the
-stream.
-
-Streams will be automatically closed when the last reference
-is dropped, but you might want to call this function to make sure
-resources are released as early as possible.
-
-Some streams might keep the backing store of the stream (e.g. a file descriptor)
-open after the stream is closed. See the documentation for the individual
-stream for details.
-
-On failure the first error that happened will be reported, but the close
-operation will finish as much as possible. A stream that failed to
-close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
-is important to check and report the error to the user, otherwise
-there might be a loss of data as all data might not be written.
-
-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.
-Cancelling a close will still leave the stream closed, but there some streams
-can use a faster close that doesn't block to e.g. check errors. On
-cancellation (as with any error) there is no guarantee that all written
-data will reach the target.
+Gets @address's #GInetAddress.
+Since: 2.22
</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="address">
+<parameter_description> a #GInetSocketAddress
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure
+<return> the #GInetAddress for @address, which must be
+g_object_ref()'d if it will be stored
+
</return>
</function>
@@ -1070,22 +1127,6 @@ Creates a new file attribute info list.
</return>
</function>
-<function name="g_unix_mount_guess_should_display">
-<description>
-Guesses whether a Unix mount should be displayed in the UI.
-
-
-</description>
-<parameters>
-<parameter name="mount_entry">
-<parameter_description> a #GUnixMountEntry
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if @mount_entry is deemed to be displayable.
-</return>
-</function>
-
<function name="g_async_result_get_user_data">
<description>
Gets the user data from a #GAsyncResult.
@@ -1106,6 +1147,7 @@ Gets the user data from a #GAsyncResult.
<description>
Sorts @targets in place according to the algorithm in RFC 2782.
+Since: 2.22
</description>
<parameters>
@@ -1116,7 +1158,6 @@ Sorts @targets in place according to the algorithm in RFC 2782.
</parameters>
<return> the head of the sorted list.
-Since: 2.22
</return>
</function>
@@ -1155,31 +1196,13 @@ Since: 2.22
<return></return>
</function>
-<function name="g_simple_async_result_set_handle_cancellation">
-<description>
-Sets whether to handle cancellation within the asynchronous operation.
-
-
-</description>
-<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="handle_cancellation">
-<parameter_description> a #gboolean.
-</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.
This is used to check for errors when g_socket_connect() is
used in non-blocking mode.
+Since: 2.22
</description>
<parameters>
@@ -1194,7 +1217,6 @@ used in non-blocking mode.
</parameters>
<return> %TRUE if no error, %FALSE otherwise, setting @error to the error
-Since: 2.22
</return>
</function>
@@ -1239,6 +1261,7 @@ If you are planning to connect to a socket on the resolved IP
address, it may be easier to create a #GNetworkAddress and use its
#GSocketConnectable interface.
+Since: 2.22
</description>
<parameters>
@@ -1263,7 +1286,6 @@ address, it may be easier to create a #GNetworkAddress and use its
must unref each of the addresses and free the list when you are
done with it. (You can use g_resolver_free_addresses() to do this.)
-Since: 2.22
</return>
</function>
@@ -1299,49 +1321,6 @@ Since: 2.22
<return></return>
</function>
-<function name="g_file_unmount_mountable_with_operation">
-<description>
-Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
-
-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.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_unmount_mountable_finish() to get the result of the operation.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</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 to call when the request is satisfied, or %NULL.
-</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_file_info_clear_status">
<description>
Clears the status information from @info.
@@ -1360,6 +1339,7 @@ Clears the status information from @info.
<description>
Gets @srv's service name (eg, "ldap").
+Since: 2.22
</description>
<parameters>
@@ -1370,7 +1350,6 @@ Gets @srv's service name (eg, "ldap").
</parameters>
<return> @srv's service name
-Since: 2.22
</return>
</function>
@@ -1441,6 +1420,7 @@ 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>
@@ -1460,7 +1440,6 @@ a value from #GResolverError. If the operation was cancelled,
<return> a #GList of #GInetAddress, or %NULL on error. See
g_resolver_lookup_by_name() for more details.
-Since: 2.22
</return>
</function>
@@ -1505,43 +1484,6 @@ Checks if a file is a backup file.
</return>
</function>
-<function name="g_file_find_enclosing_mount_async">
-<description>
-Asynchronously gets the mount for the file.
-
-For more details, see g_file_find_enclosing_mount() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_find_enclosing_mount_finish() to get the result of the operation.
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> a #GFile
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">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> 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_settings_new_with_context_and_path">
<description>
Creates a new #GSettings object with a given schema, context and
@@ -1573,6 +1515,7 @@ Gets the #GUnixFDList contained in @message. This function does not
return a reference to the caller, but the returned list is valid for
the lifetime of @message.
+Since: 2.24
</description>
<parameters>
@@ -1583,7 +1526,6 @@ the lifetime of @message.
</parameters>
<return> the #GUnixFDList from @message
-Since: 2.24
</return>
</function>
@@ -1599,6 +1541,7 @@ If @cancellable is non-%NULL, it can be used to cancel the
operation, in which case @error (if non-%NULL) will be set to
%G_IO_ERROR_CANCELLED.
+Since: 2.22
</description>
<parameters>
@@ -1622,46 +1565,23 @@ operation, in which case @error (if non-%NULL) will be set to
<return> a hostname (either ASCII-only, or in ASCII-encoded
form), or %NULL on error.
-Since: 2.22
</return>
</function>
-<function name="g_file_load_contents_async">
+<function name="g_filter_input_stream_get_base_stream">
<description>
-Starts an asynchronous load of the @file's contents.
-
-For more details, see g_file_load_contents() which is
-the synchronous version of this call.
-
-When the load operation has completed, @callback will be called
-with @user data. To finish the operation, call
-g_file_load_contents_finish() with the #GAsyncResult returned by
-the @callback.
+Gets the base stream for the filter 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="file">
-<parameter_description> input #GFile.
-</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 name="stream">
+<parameter_description> a #GFilterInputStream.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GInputStream.
+</return>
</function>
<function name="g_file_info_get_file_type">
@@ -1681,32 +1601,6 @@ This is different from the file's content type, see g_file_info_get_content_type
</return>
</function>
-<function name="GFileMonitor">
-<description>
-Emitted when a file has been changed.
-
-</description>
-<parameters>
-<parameter name="monitor">
-<parameter_description> a #GFileMonitor.
-</parameter_description>
-</parameter>
-<parameter name="file">
-<parameter_description> a #GFile.
-</parameter_description>
-</parameter>
-<parameter name="other_file">
-<parameter_description> a #GFile.
-</parameter_description>
-</parameter>
-<parameter name="event_type">
-<parameter_description> a #GFileMonitorEvent.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_info_dup">
<description>
Duplicates a file info structure.
@@ -1739,26 +1633,48 @@ Checks if a file is a symlink.
</return>
</function>
-<function name="g_inet_address_new_any">
+<function name="g_unix_mounts_get">
<description>
-Creates a #GInetAddress for the "any" address (unassigned/"don't
-care") for @family.
+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
+with g_unix_mounts_changed_since().
</description>
<parameters>
-<parameter name="family">
-<parameter_description> the address family
+<parameter name="time_read">
+<parameter_description> guint64 to contain a timestamp.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetAddress corresponding to the "any" address
-for @family.
-
-Since: 2.22
+<return> a #GList of the UNIX mounts.
</return>
</function>
+<function name="g_themed_icon_append_name">
+<description>
+Append a name to the list of icons from within @icon.
+
+<note><para>
+Note that doing so invalidates the hash computed by prior calls
+to g_icon_hash().
+</para></note>
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GThemedIcon
+</parameter_description>
+</parameter>
+<parameter name="iconname">
+<parameter_description> name of icon to append to list of icons from within @icon.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mount_can_unmount">
<description>
Checks if @mount can be mounted.
@@ -1777,7 +1693,18 @@ Checks if @mount can be mounted.
<function name="g_file_replace_readwrite">
<description>
-Returns: a #GFileIOStream or %NULL on error.
+Returns an output stream for overwriting the file in readwrite mode,
+possibly creating a backup copy of the file first. If the file doesn't
+exist, it will be created.
+
+For details about the behaviour, see g_file_replace() which does the same
+thing but returns an output stream only.
+
+Note that in many non-local file cases read and write streams are not
+supported, so make sure you really need to do read and write streaming,
+rather than just opening for reading or writing.
+
+Since: 2.22
</description>
<parameters>
@@ -1810,74 +1737,36 @@ current #GFile, or #NULL to ignore
<return> a #GFileIOStream or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
-<function name="g_volume_eject_with_operation">
+<function name="g_socket_set_blocking">
<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.
+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="volume">
-<parameter_description> a #GVolume.
-</parameter_description>
-</parameter>
-<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 name="socket">
+<parameter_description> a #GSocket.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="blocking">
+<parameter_description> Whether to use blocking I/O or not.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_settings_get_child">
-<description>
-Creates a 'child' settings object which has a base path of
-<replaceable>base-path</replaceable>/@name", where
-<replaceable>base-path</replaceable> is the base path of @settings.
-
-The schema for the child settings object must have been declared
-in the schema of @settings using a <tag class="starttag">child</tag> element.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the 'child' schema
-</parameter_description>
-</parameter>
-</parameters>
-<return> a 'child' settings object
-</return>
-</function>
-
<function name="g_file_query_filesystem_info_finish">
<description>
Finishes an asynchronous filesystem info query. See
@@ -1912,9 +1801,9 @@ and the property @property of @object.
The binding uses the default GIO mapping functions to map
between the settings and property values. These functions
handle booleans, numeric types and string types in a
-straightforward way. Use g_settings_bind_with_mapping()
-if you need a custom mapping, or map between types that
-are not supported by the default mapping functions.
+straightforward way. Use g_settings_bind_with_mapping() if
+you need a custom mapping, or map between types that are not
+supported by the default mapping functions.
Unless the @flags include %G_SETTINGS_BIND_NO_SENSITIVITY, this
function also establishes a binding between the writability of
@@ -1983,45 +1872,70 @@ Puts a signed 16-bit integer into the output stream.
</return>
</function>
-<function name="g_io_extension_point_lookup">
+<function name="g_socket_client_connect_to_host_async">
<description>
-Looks up an existing extension point.
+This is the asynchronous version of g_socket_client_connect_to_host().
+When the operation is finished @callback will be
+called. You can then call g_socket_client_connect_to_host_finish() to get
+the result of the operation.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="name">
-<parameter_description> the name of the extension point
+<parameter name="client">
+<parameter_description> a #GTcpClient
+</parameter_description>
+</parameter>
+<parameter name="host_and_port">
+<parameter_description> the name and optionally the port of the host to connect to
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> the default port to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
</parameter_description>
</parameter>
</parameters>
-<return> the #GIOExtensionPoint, or %NULL if there is no
-registered extension point with the given name
-</return>
+<return></return>
</function>
-<function name="g_volume_get_identifier">
+<function name="g_settings_backend_changed_tree">
<description>
-Gets the identifier of the given kind for @volume.
-See the <link linkend="volume-identifier">introduction</link>
-for more information about volume identifiers.
+This call is a convenience wrapper. It gets the list of changes from
+ tree, computes the longest common prefix and calls
+g_settings_backend_changed().
+Since: 2.26
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
</parameter_description>
</parameter>
-<parameter name="kind">
-<parameter_description> the kind of identifier to return
+<parameter name="tree">
+<parameter_description> a #GTree containing the changes
+</parameter_description>
+</parameter>
+<parameter name="origin_tag">
+<parameter_description> the origin tag
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string containing the
-requested identfier, or %NULL if the #GVolume
-doesn't have this kind of identifier
-</return>
+<return></return>
</function>
<function name="g_file_info_set_content_type">
@@ -2048,6 +1962,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.
Checks if graceful disconnects are used. See
g_tcp_connection_set_graceful_disconnect().
+Since: 2.22
</description>
<parameters>
@@ -2058,38 +1973,22 @@ g_tcp_connection_set_graceful_disconnect().
</parameters>
<return> %TRUE if graceful disconnect is used on close, %FALSE otherwise
-Since: 2.22
</return>
</function>
-<function name="GDesktopAppInfo">
-<description>
-Information about an installed application from a desktop file.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_output_stream_is_closing">
+<function name="g_data_input_stream_get_newline_type">
<description>
-Checks if an output stream is being closed. This can be
-used inside e.g. a flush implementation to see if the
-flush (or other i/o operation) is called from within
-the closing operation.
+Gets the current newline type for the @stream.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is being closed. %FALSE otherwise.
-
-Since: 2.24
+<return> #GDataStreamNewlineType for the given @stream.
</return>
</function>
@@ -2161,25 +2060,32 @@ Since: 2.26
<return></return>
</function>
-<function name="g_app_info_delete">
+<function name="g_unix_fd_list_new_from_array">
<description>
-Tries to delete a #GAppInfo.
+Creates a new #GUnixFDList containing the file descriptors given in
+ fds The file descriptors become the property of the new list and
+may no longer be used by the caller. The array itself is owned by
+the caller.
-On some platforms, there may be a difference between user-defined
-#GAppInfo<!-- -->s which can be deleted, and system-wide ones which
-cannot. See g_app_info_can_delete().
+Each file descriptor in the array should be set to close-on-exec.
+If @n_fds is -1 then @fds must be terminated with -1.
+
+Since: 2.24
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<parameter name="fds">
+<parameter_description> the initial list of file descriptors
+</parameter_description>
+</parameter>
+<parameter name="n_fds">
+<parameter_description> the length of #fds, or -1
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @appinfo has been deleted
+<return> a new #GUnixFDList
-Since: 2.20
</return>
</function>
@@ -2215,24 +2121,23 @@ version of this function, see g_loadable_icon_load().
<return></return>
</function>
-<function name="g_data_input_stream_set_byte_order">
+<function name="g_socket_control_message_get_size">
<description>
-This function sets the byte order for the given @stream. All subsequent
-reads from the @stream will be read in the given @order.
+Returns the space required for the control message, not including
+headers or alignment.
+Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
-</parameter_description>
-</parameter>
-<parameter name="order">
-<parameter_description> a #GDataStreamByteOrder to set.
+<parameter name="message">
+<parameter_description> a #GSocketControlMessage
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The number of bytes required.
+
+</return>
</function>
<function name="g_file_set_display_name_finish">
@@ -2261,6 +2166,24 @@ Free the returned object with g_object_unref().
</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_settings_revert">
<description>
Reverts all non-applied changes to the settings. This function
@@ -2303,6 +2226,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.
<description>
Checks if a drive can be started.
+Since: 2.22
</description>
<parameters>
@@ -2313,44 +2237,52 @@ Checks if a drive can be started.
</parameters>
<return> %TRUE if the @drive can be started, %FALSE otherwise.
-Since: 2.22
</return>
</function>
-<function name="g_emblem_get_origin">
+<function name="g_file_info_unset_attribute_mask">
<description>
-Gets the origin of the emblem.
-
+Unsets a mask set by g_file_info_set_attribute_mask(), if one
+is set.
</description>
<parameters>
-<parameter name="emblem">
-<parameter_description> a #GEmblem
+<parameter name="info">
+<parameter_description> #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return> the origin of the emblem
-
-Since: 2.18
-</return>
+<return></return>
</function>
-<function name="g_filter_input_stream_set_close_base_stream">
+<function name="g_app_launch_context_get_startup_notify_id">
<description>
-Sets whether the base stream will be closed when @stream is closed.
+Initiates startup notification for the application and returns the
+DESKTOP_STARTUP_ID 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">
+FreeDesktop.Org Startup Notifications standard</ulink>.
+
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterInputStream.
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext
</parameter_description>
</parameter>
-<parameter name="close_base">
-<parameter_description> %TRUE to close the base stream.
+<parameter name="info">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="files">
+<parameter_description> a #GList of of #GFile objects
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a startup notification ID for the application, or %NULL if
+not supported.
+</return>
</function>
<function name="g_file_query_info_finish">
@@ -2379,27 +2311,53 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_file_attribute_info_list_lookup">
+<function name="g_file_find_enclosing_mount_finish">
<description>
-Gets the file attribute with the name @name from @list.
+Finishes an asynchronous find mount request.
+See g_file_find_enclosing_mount_async().
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList.
+<parameter name="file">
+<parameter_description> a #GFile
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name of the attribute to lookup.
+<parameter name="res">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeInfo for the @name, or %NULL if an
-attribute isn't found.
+<return> #GMount for given @file or %NULL on error.
+Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_unix_output_stream_set_close_fd">
+<description>
+Sets whether the file descriptor of @stream shall be closed
+when the stream is closed.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GUnixOutputStream
+</parameter_description>
+</parameter>
+<parameter name="close_fd">
+<parameter_description> %TRUE to close the file descriptor when done
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_enumerator_close_finish">
<description>
Finishes closing a file enumerator, started from g_file_enumerator_close_async().
@@ -2441,6 +2399,7 @@ Tests whether @address is a site-local address such as 10.0.0.1
not be reached directly from the Internet, but which may have
outgoing Internet connectivity via a NAT or firewall).
+Since: 2.22
</description>
<parameters>
@@ -2451,7 +2410,6 @@ outgoing Internet connectivity via a NAT or firewall).
</parameters>
<return> %TRUE if @address is a site-local address.
-Since: 2.22
</return>
</function>
@@ -2483,85 +2441,21 @@ Sets the application as the default handler for a given type.
<description>
Checks if abstract unix domain socket names are supported.
+Since: 2.22
</description>
<parameters>
</parameters>
<return> %TRUE if supported, %FALSE otherwise
-Since: 2.22
</return>
</function>
-<function name="GCancellable">
-<description>
-Emitted when the operation has been cancelled.
-
-Can be used by implementations of cancellable operations. If the
-operation is cancelled from another thread, the signal will be
-emitted in the thread that cancelled the operation, not the
-thread that is running the operation.
-
-Note that disconnecting from this signal (or any signal) in a
-multi-threaded program is prone to race conditions. For instance
-it is possible that a signal handler may be invoked even
-<emphasis>after</emphasis> a call to
-g_signal_handler_disconnect() for that handler has already
-returned.
-
-There is also a problem when cancellation happen
-right before connecting to the signal. If this happens the
-signal will unexpectedly not be emitted, and checking before
-connecting to the signal leaves a race condition where this is
-still happening.
-
-In order to make it safe and easy to connect handlers there
-are two helper functions: g_cancellable_connect() and
-g_cancellable_disconnect() which protect against problems
-like this.
-
-An example of how to us this:
-|[
-/<!-- -->* Make sure we don't do any unnecessary work if already cancelled *<!-- -->/
-if (g_cancellable_set_error_if_cancelled (cancellable))
-return;
-
-/<!-- -->* Set up all the data needed to be able to
-* handle cancellation of the operation *<!-- -->/
-my_data = my_data_new (...);
-
-id = 0;
-if (cancellable)
-id = g_cancellable_connect (cancellable,
-G_CALLBACK (cancelled_handler)
-data, NULL);
-
-/<!-- -->* cancellable operation here... *<!-- -->/
-
-g_cancellable_disconnect (cancellable, id);
-
-/<!-- -->* cancelled_handler is never called after this, it
-* is now safe to free the data *<!-- -->/
-my_data_free (my_data);
-]|
-
-Note that the cancelled signal is emitted in the thread that
-the user cancelled from, which may be the main thread. So, the
-cancellable signal should not do something that can block.
-
-</description>
-<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_filter_input_stream_get_close_base_stream">
<description>
-Return value: %TRUE if the base stream will be closed.
+Returns whether the base stream will be closed when @stream is
+closed.
+
</description>
<parameters>
@@ -2574,21 +2468,39 @@ Return value: %TRUE if the base stream will be closed.
</return>
</function>
-<function name="g_converter_output_stream_get_converter">
+<function name="g_file_monitor">
<description>
-Gets the #GConverter that is used by @converter_stream.
+Obtains a file or directory monitor for the given file, depending
+on the type of the file.
+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="converter_stream">
-<parameter_description> a #GConverterOutputStream
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileMonitorFlags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the converter of the converter output stream
+<return> a #GFileMonitor for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
-Since: 2.24
</return>
</function>
@@ -2647,48 +2559,16 @@ of the request.
<return></return>
</function>
-<function name="g_file_create_readwrite_async">
+<function name="g_memory_input_stream_new">
<description>
-Asynchronously creates a new file and returns a stream for reading and
-writing to it. The file must not already exist.
-
-For more details, see g_file_create_readwrite() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then
-call g_file_create_readwrite_finish() to get the result of the operation.
+Creates a new empty #GMemoryInputStream.
-Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">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> 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>
+<return> a new #GInputStream
+</return>
</function>
<function name="g_resolver_free_targets">
@@ -2719,6 +2599,7 @@ If your application or library provides one or more #GIcon
implementations you need to ensure that each #GType is registered
with the type system prior to calling g_icon_new_for_string().
+Since: 2.20
</description>
<parameters>
@@ -2734,7 +2615,6 @@ with the type system prior to calling g_icon_new_for_string().
<return> An object implementing the #GIcon interface or %NULL if
@error is set.
-Since: 2.20
</return>
</function>
@@ -2777,6 +2657,7 @@ Only the first call initializes the object, further calls return the result
of the first call. This is so that its safe to implement the singleton
pattern in the GObject constructor function.
+Since: 2.22
</description>
<parameters>
@@ -2797,7 +2678,6 @@ ignore.
<return> %TRUE if successful. If an error has occurred, this function will
return %FALSE and set @error appropriately if present.
-Since: 2.22
</return>
</function>
@@ -2839,6 +2719,23 @@ its elements have been unreffed with g_object_unref().
</return>
</function>
+<function name="g_io_extension_ref_class">
+<description>
+Gets a reference to the class for the type that is
+associated with @extension.
+
+
+</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_settings_bind_writable">
<description>
Create a binding between the writability of @key in the
@@ -2916,6 +2813,7 @@ Creates a new #GMemoryInputStream with data in memory of a given size.
<description>
Creates a new #GDesktopAppInfo.
+Since: 2.18
</description>
<parameters>
@@ -2926,7 +2824,6 @@ Creates a new #GDesktopAppInfo.
</parameters>
<return> a new #GDesktopAppInfo or %NULL on error.
-Since: 2.18
</return>
</function>
@@ -2952,6 +2849,7 @@ Gets the underlying #GSocket object of the connection.
This can be useful if you want to do something unusual on it
not supported by the #GSocketConnection APIs.
+Since: 2.22
</description>
<parameters>
@@ -2962,7 +2860,6 @@ not supported by the #GSocketConnection APIs.
</parameters>
<return> a #GSocketAddress or %NULL on error.
-Since: 2.22
</return>
</function>
@@ -3077,6 +2974,19 @@ Checks if two #GAppInfo<!-- -->s are equal.
</return>
</function>
+<function name="g_cancellable_get_current">
+<description>
+Gets the top cancellable from the stack.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GCancellable from the top of the stack, or %NULL
+if the stack is empty.
+</return>
+</function>
+
<function name="g_mount_remount">
<description>
Remounts a mount. This is an asynchronous operation, and is
@@ -3135,81 +3045,58 @@ Checks if an output stream has already been closed.
</return>
</function>
-<function name="g_socket_listener_add_address">
+<function name="g_inet_address_to_bytes">
<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.
+Gets the raw binary address data from @address.
+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> a #GInetAddress
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> a pointer to an internal array of the bytes in @address,
+which should not be modified, stored, or freed. The size of this
+array can be gotten with g_inet_address_get_native_size().
-Since: 2.22
</return>
</function>
-<function name="g_vfs_get_supported_uri_schemes">
+<function name="g_file_attribute_info_list_unref">
<description>
-Gets a list of URI schemes supported by @vfs.
+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></return>
+</function>
+
+<function name="g_file_get_path">
+<description>
+Gets the local pathname for #GFile, if one exists.
+
+This call does no blocking i/o.
</description>
<parameters>
-<parameter name="vfs">
-<parameter_description> a #GVfs.
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
</parameters>
-<return> a %NULL-terminated array of strings.
-The returned array belongs to GIO and must
-not be freed or modified.
+<return> string containing the #GFile's path, or %NULL if
+no such path exists. The returned string should be
+freed with g_free() when no longer needed.
</return>
</function>
@@ -3322,6 +3209,7 @@ Gets the source tag for the #GSimpleAsyncResult.
<description>
Gets the underlying file descriptor.
+Since: 2.24
</description>
<parameters>
@@ -3332,7 +3220,6 @@ Gets the underlying file descriptor.
</parameters>
<return> The file descriptor
-Since: 2.24
</return>
</function>
@@ -3440,6 +3327,7 @@ 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>
@@ -3459,13 +3347,15 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<return> %TRUE if all directories have been successfully created, %FALSE
otherwise.
-Since: 2.18
</return>
</function>
<function name="g_buffered_input_stream_peek_buffer">
<description>
-Returns: read-only buffer
+Returns the buffer with the currently available bytes. The returned
+buffer must not be modified and will become invalid when reading from
+the stream or filling the buffer.
+
</description>
<parameters>
@@ -3482,23 +3372,6 @@ Returns: read-only buffer
</return>
</function>
-<function name="GDrive">
-<description>
-Emitted when the physical stop button (if any) of a drive has
-been pressed.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_mount_enclosing_volume_finish">
<description>
Finishes a mount operation started by g_file_mount_enclosing_volume().
@@ -3530,6 +3403,7 @@ appropriately if present.
Creates a new #GThreadedSocketService with no listeners. Listeners
must be added with g_socket_service_add_listeners().
+Since: 2.22
</description>
<parameters>
@@ -3541,7 +3415,6 @@ handling incoming clients, -1 means no limit
</parameters>
<return> a new #GSocketService.
-Since: 2.22
</return>
</function>
@@ -3568,44 +3441,63 @@ ignore.
</return>
</function>
-<function name="g_resolver_lookup_service_async">
+<function name="g_data_input_stream_read_until_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.
+The asynchronous version of g_data_input_stream_read_until().
+It is an error to have two outstanding calls to this function.
-Since: 2.22
+Note that, in contrast to g_data_input_stream_read_until(),
+this function does not consume the stop character that it finds. You
+must read it for yourself.
+
+When the operation is finished, @callback will be called. You
+can then call g_data_input_stream_read_until_finish() to get
+the result of the operation.
+
+Since: 2.20
</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 name="stream">
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="protocol">
-<parameter_description> the networking protocol to use for @service (eg, "tcp")
+<parameter name="stop_chars">
+<parameter_description> characters to terminate the read.
</parameter_description>
</parameter>
-<parameter name="domain">
-<parameter_description> the DNS domain to look up the service in
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter_description> callback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter_description> the data to pass to callback function.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_apply">
+<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.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings instance
</parameter_description>
</parameter>
</parameters>
@@ -3650,40 +3542,6 @@ more addresses.
</return>
</function>
-<function name="g_io_scheduler_job_send_to_mainloop_async">
-<description>
-Used from an I/O job to send a callback to be run asynchronously in
-the thread that the job was started from. The callback will be run
-when the main loop is available, but at that time the I/O job might
-have finished. The return value from the callback is ignored.
-
-Note that if you are passing the @user_data from g_io_scheduler_push_job()
-on to this function you have to ensure that it is not freed before
- func is called, either by passing %NULL as @notify to
-g_io_scheduler_push_job() or by using refcounting for @user_data.
-
-</description>
-<parameters>
-<parameter name="job">
-<parameter_description> a #GIOSchedulerJob
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #GSourceFunc callback that will be called in the original thread
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> data to pass to @func
-</parameter_description>
-</parameter>
-<parameter name="notify">
-<parameter_description> a #GDestroyNotify for @user_data, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_monitor_cancel">
<description>
Cancels a file monitor.
@@ -3755,6 +3613,7 @@ 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().
+Since: 2.22
</description>
<parameters>
@@ -3770,7 +3629,6 @@ with g_cancellable_reset().
<return> %TRUE if @pollfd was successfully initialized, %FALSE on
failure to prepare the cancellable.
-Since: 2.22
</return>
</function>
@@ -3790,48 +3648,51 @@ Gets the #GFile associated with the given @icon.
</return>
</function>
-<function name="g_file_info_get_symlink_target">
+<function name="g_unix_input_stream_new">
<description>
-Gets the symlink target for a given #GFileInfo.
+Creates a new #GUnixInputStream for the given @fd.
+
+If @close_fd is %TRUE, the file descriptor will be closed
+when the stream is closed.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="fd">
+<parameter_description> a UNIX file descriptor
+</parameter_description>
+</parameter>
+<parameter name="close_fd">
+<parameter_description> %TRUE to close the file descriptor when done
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the symlink target.
+<return> a new #GUnixInputStream
</return>
</function>
-<function name="GSocketService">
+<function name="g_file_input_stream_query_info_finish">
<description>
-The ::incoming signal is emitted when a new incoming connection
-to @service needs to be handled. The handler must initiate the
-handling of @connection, but may not block; in essence,
-asynchronous operations must be used.
+Finishes an asynchronous info query operation.
</description>
<parameters>
-<parameter name="service">
-<parameter_description> the #GSocketService.
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
</parameter_description>
</parameter>
-<parameter name="connection">
-<parameter_description> a new #GSocketConnection object.
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> the source_object passed to g_socket_listener_add_address().
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring,
+or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE to stop other handlers from being called
-
-Since: 2.22
+<return> #GFileInfo.
</return>
</function>
@@ -3840,6 +3701,7 @@ Since: 2.22
Finishes unmounting a mount. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
+Since: 2.22
</description>
<parameters>
@@ -3859,49 +3721,22 @@ ignore.
</parameters>
<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
-Since: 2.22
</return>
</function>
-<function name="g_app_info_launch">
+<function name="g_mount_operation_get_password_save">
<description>
-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.
-
-Note that even if the launch is successful the application launched
-can fail to start if it runs into problems during startup. There is
-no way to detect this.
-
-Some URIs can be changed when passed through a GFile (for instance
-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.
+Gets the state of saving passwords for the mount operation.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
-</parameter_description>
-</parameter>
-<parameter name="files">
-<parameter_description> a #GList of #GFile objects
-</parameter_description>
-</parameter>
-<parameter name="launch_context">
-<parameter_description> a #GAppLaunchContext or %NULL
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful launch, %FALSE otherwise.
+<return> a #GPasswordSave flag.
</return>
</function>
@@ -3942,67 +3777,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
-<function name="g_simple_async_result_get_op_res_gssize">
-<description>
-Gets a gssize from the asynchronous result.
-
-
-</description>
-<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a gssize returned from the asynchronous function.
-</return>
-</function>
-
-<function name="g_file_set_attributes_async">
-<description>
-Asynchronously sets the attributes of @file with @info.
-
-For more details, see g_file_set_attributes_from_info() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_set_attributes_finish() to get the result of the operation.
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">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> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> a #gpointer.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_delete">
<description>
Deletes a file. If the @file is a directory, it will only be deleted if it
@@ -4032,29 +3806,26 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
-<function name="g_file_input_stream_query_info_finish">
+<function name="g_socket_listener_set_backlog">
<description>
-Finishes an asynchronous info query operation.
+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="stream">
-<parameter_description> a #GFileInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="listener">
+<parameter_description> a #GSocketListener
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring,
-or %NULL to ignore.
+<parameter name="listen_backlog">
+<parameter_description> an integer
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInfo.
-</return>
+<return></return>
</function>
<function name="g_seekable_seek">
@@ -4133,27 +3904,74 @@ given name, or %NULL if there is no extension with that name
</return>
</function>
-<function name="g_data_input_stream_get_newline_type">
+<function name="g_inet_address_get_family">
<description>
-Gets the current newline type for the @stream.
+Gets @address's family
+Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="address">
+<parameter_description> a #GInetAddress
</parameter_description>
</parameter>
</parameters>
-<return> #GDataStreamNewlineType for the given @stream.
+<return> @address's family
+
</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="g_volume_eject_with_operation_finish">
<description>
Finishes ejecting a volume. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
+Since: 2.22
</description>
<parameters>
@@ -4173,7 +3991,24 @@ ignore.
</parameters>
<return> %TRUE if the volume was successfully ejected. %FALSE otherwise.
-Since: 2.22
+</return>
+</function>
+
+<function name="g_converter_output_stream_get_converter">
+<description>
+Gets the #GConverter that is used by @converter_stream.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="converter_stream">
+<parameter_description> a #GConverterOutputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the converter of the converter output stream
+
</return>
</function>
@@ -4257,16 +4092,48 @@ ignore.
</return>
</function>
-<function name="g_memory_input_stream_new">
+<function name="g_file_create_readwrite_async">
<description>
-Creates a new empty #GMemoryInputStream.
+Asynchronously creates a new file and returns a stream for reading and
+writing to it. The file must not already exist.
+For more details, see g_file_create_readwrite() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then
+call g_file_create_readwrite_finish() to get the result of the operation.
+
+Since: 2.22
</description>
<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">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> 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> a new #GInputStream
-</return>
+<return></return>
</function>
<function name="g_socket_address_to_native">
@@ -4279,6 +4146,7 @@ If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is
returned. If the address type is not known on the system
then a %G_IO_ERROR_NOT_SUPPORTED error is returned.
+Since: 2.22
</description>
<parameters>
@@ -4303,7 +4171,6 @@ g_socket_address_get_native_size().
</parameters>
<return> %TRUE if @dest was filled in, %FALSE on error
-Since: 2.22
</return>
</function>
@@ -4344,6 +4211,7 @@ g_socket_client_set_socket_type().
If a local address is specified with g_socket_client_set_local_address() the
socket will be bound to this address before connecting.
+Since: 2.22
</description>
<parameters>
@@ -4366,7 +4234,6 @@ socket will be bound to this address before connecting.
</parameters>
<return> a #GSocketConnection on success, %NULL on error.
-Since: 2.22
</return>
</function>
@@ -4404,6 +4271,7 @@ Gets the protocol name type of the socket client.
See g_socket_client_set_protocol() for details.
+Since: 2.22
</description>
<parameters>
@@ -4414,7 +4282,22 @@ See g_socket_client_set_protocol() for details.
</parameters>
<return> a #GSocketProtocol
-Since: 2.22
+</return>
+</function>
+
+<function name="g_unix_mount_point_guess_can_eject">
+<description>
+Guesses whether a Unix mount point can be ejected.
+
+
+</description>
+<parameters>
+<parameter name="mount_point">
+<parameter_description> a #GUnixMountPoint
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @mount_point is deemed to be ejectable.
</return>
</function>
@@ -4472,6 +4355,7 @@ Creates a new #GNetworkService representing the given @service,
@protocol, and @domain. This will initially be unresolved; use the
#GSocketConnectable interface to resolve it.
+Since: 2.22
</description>
<parameters>
@@ -4490,35 +4374,31 @@ Creates a new #GNetworkService representing the given @service,
</parameters>
<return> a new #GNetworkService
-Since: 2.22
</return>
</function>
-<function name="GZlibDecompressor">
-<description>
-Zlib decompression
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_inet_address_get_family">
+<function name="g_data_input_stream_read_byte">
<description>
-Gets @address's family
+Reads an unsigned 8-bit/1-byte value from @stream.
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</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> @address's family
-
-Since: 2.22
+<return> an unsigned 8-bit/1-byte value read from the @stream or %0
+if an error occurred.
</return>
</function>
@@ -4552,6 +4432,7 @@ described in the <ulink url="http://standards.freedesktop.org/menu-spec/
<description>
Finishes an async connect operation. See g_socket_client_connect_to_host_async()
+Since: 2.22
</description>
<parameters>
@@ -4571,17 +4452,39 @@ ignore.
</parameters>
<return> a #GSocketConnection on success, %NULL on error.
-Since: 2.22
</return>
</function>
-<function name="GNetworkAddress">
+<function name="g_io_scheduler_job_send_to_mainloop_async">
<description>
-A #GSocketConnectable for resolving a hostname and connecting to
-that host.
+Used from an I/O job to send a callback to be run asynchronously in
+the thread that the job was started from. The callback will be run
+when the main loop is available, but at that time the I/O job might
+have finished. The return value from the callback is ignored.
+
+Note that if you are passing the @user_data from g_io_scheduler_push_job()
+on to this function you have to ensure that it is not freed before
+ func is called, either by passing %NULL as @notify to
+g_io_scheduler_push_job() or by using refcounting for @user_data.
</description>
<parameters>
+<parameter name="job">
+<parameter_description> a #GIOSchedulerJob
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #GSourceFunc callback that will be called in the original thread
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @func
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -4607,60 +4510,65 @@ This array must be freed by g_strfreev() when finished.
</return>
</function>
-<function name="g_mount_is_shadowed">
+<function name="g_file_load_partial_contents_finish">
<description>
-Determines if @mount is shadowed. Applications or libraries should
-avoid displaying @mount in the user interface if it is shadowed.
-
-A mount is said to be shadowed if there exists one or more user
-visible objects (currently #GMount objects) with a root that is
-inside the root of @mount.
-
-One application of shadow mounts is when exposing a single file
-system that is used to address several logical volumes. In this
-situation, a #GVolumeMonitor implementation would create two
-#GVolume objects (for example, one for the camera functionality of
-the device and one for a SD card reader on the device) with
-activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal>
-and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the
-underlying mount (with root
-<literal>gphoto2://[usb:001,002]/</literal>) is mounted, said
-#GVolumeMonitor implementation would create two #GMount objects
-(each with their root matching the corresponding volume activation
-root) that would shadow the original mount.
-
-The proxy monitor in GVfs 2.26 and later, automatically creates and
-manage shadow mounts (and shadows the underlying mount) if the
-activation root on a #GVolume is set.
+Finishes an asynchronous partial load operation that was started
+with g_file_load_partial_contents_async(). The data is always
+zero-terminated, but this is not included in the resultant @length.
+The returned @content should be freed with g_free() when no longer
+needed.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> A #GMount.
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> a location to place the contents of the file.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a location to place the length of the contents of the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="etag_out">
+<parameter_description> a location to place the current entity tag for the file,
+or %NULL if the entity tag is not needed
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @mount is shadowed.
-
-Since: 2.20
+<return> %TRUE if the load was successful. If %FALSE and @error is
+present, it will be set appropriately.
</return>
</function>
-<function name="g_file_info_get_icon">
+<function name="g_simple_async_result_set_from_error">
<description>
-Gets the icon for a file.
-
+Sets the result from a #GError.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError.
</parameter_description>
</parameter>
</parameters>
-<return> #GIcon for the given @info.
-</return>
+<return></return>
</function>
<function name="g_filter_output_stream_set_close_base_stream">
@@ -4681,46 +4589,43 @@ Sets whether the base stream will be closed when @stream is closed.
<return></return>
</function>
-<function name="g_file_set_display_name">
+<function name="g_mount_is_shadowed">
<description>
-Renames @file to the specified display name.
-
-The display name is converted from UTF8 to the correct encoding for the target
-filesystem if possible and the @file is renamed to this.
+Determines if @mount is shadowed. Applications or libraries should
+avoid displaying @mount in the user interface if it is shadowed.
-If you want to implement a rename operation in the user interface the edit name
-(#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename
-widget, and then the result after editing should be passed to g_file_set_display_name().
+A mount is said to be shadowed if there exists one or more user
+visible objects (currently #GMount objects) with a root that is
+inside the root of @mount.
-On success the resulting converted filename is returned.
+One application of shadow mounts is when exposing a single file
+system that is used to address several logical volumes. In this
+situation, a #GVolumeMonitor implementation would create two
+#GVolume objects (for example, one for the camera functionality of
+the device and one for a SD card reader on the device) with
+activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal>
+and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the
+underlying mount (with root
+<literal>gphoto2://[usb:001,002]/</literal>) is mounted, said
+#GVolumeMonitor implementation would create two #GMount objects
+(each with their root matching the corresponding volume activation
+root) that would shadow the original mount.
-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 proxy monitor in GVfs 2.26 and later, automatically creates and
+manage shadow mounts (and shadows the underlying mount) if the
+activation root on a #GVolume is set.
+Since: 2.20
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="display_name">
-<parameter_description> a 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, or %NULL
+<parameter name="mount">
+<parameter_description> A #GMount.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile specifying what @file was renamed to, or %NULL
-if there was an error.
-Free the returned object with g_object_unref().
+<return> %TRUE if @mount is shadowed.
+
</return>
</function>
@@ -4776,58 +4681,12 @@ an error occurred.
</return>
</function>
-<function name="g_output_stream_write">
-<description>
-Tries to write @count bytes from @buffer into the stream. Will block
-during the operation.
-
-If count is zero returns zero and does nothing. A value of @count
-larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
-
-On success, the number of bytes written to the stream is returned.
-It is not an error if this is not the same as the requested size, as it
-can happen e.g. on a partial i/o error, or if there is not enough
-storage in the stream. All writes either block until at least one byte
-is written, so zero is never returned (unless @count is zero).
-
-If @cancellable is not NULL, then the operation can be cancelled by
-triggering the cancellable object from another thread. If the operation
-was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
-
-On error -1 is returned and @error is set accordingly.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to write.
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes to write
-</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> Number of bytes written, or -1 on error
-</return>
-</function>
-
<function name="g_settings_get_has_unapplied">
<description>
+Returns whether the #GSettings object has any unapplied
+changes. This can only be the case if it is in 'delayed-apply' mode.
+
+Since: 2.26
</description>
<parameters>
@@ -4837,40 +4696,25 @@ On error -1 is returned and @error is set accordingly.
</parameter>
</parameters>
<return> %TRUE if @settings has unapplied changes
-whether the #GSettings object has any unapplied
-changes. This can only be the case if it is in 'delayed-apply' mode.
-
-Since: 2.26
</return>
</function>
-<function name="g_file_poll_mountable_finish">
+<function name="g_volume_monitor_get_connected_drives">
<description>
-Finishes a poll operation. See g_file_poll_mountable() for details.
+Gets a list of drives connected to the system.
-Finish an asynchronous poll operation that was polled
-with g_file_poll_mountable().
+The returned list should be freed with g_list_free(), after
+its elements have been unreffed with g_object_unref().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="volume_monitor">
+<parameter_description> a #GVolumeMonitor.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
-
-Since: 2.22
+<return> a #GList of connected #GDrive objects.
</return>
</function>
@@ -4900,22 +4744,20 @@ ignore.
</return>
</function>
-<function name="g_simple_async_result_set_from_error">
+<function name="g_file_info_get_icon">
<description>
-Sets the result from a #GError.
+Gets the icon for a file.
+
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError.
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> #GIcon for the given @info.
+</return>
</function>
<function name="g_file_new_for_commandline_arg">
@@ -4938,52 +4780,6 @@ I/O operation if @arg points to a malformed path.
</return>
</function>
-<function name="g_data_input_stream_read_until_async">
-<description>
-The asynchronous version of g_data_input_stream_read_until().
-It is an error to have two outstanding calls to this function.
-
-Note that, in contrast to g_data_input_stream_read_until(),
-this function does not consume the stop character that it finds. You
-must read it for yourself.
-
-When the operation is finished, @callback will be called. You
-can then call g_data_input_stream_read_until_finish() to get
-the result of the operation.
-
-Since: 2.20
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
-</parameter_description>
-</parameter>
-<parameter name="stop_chars">
-<parameter_description> characters to terminate the read.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">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_io_error_quark">
<description>
Gets the GIO Error Quark.
@@ -4996,82 +4792,77 @@ Gets the GIO Error Quark.
</return>
</function>
-<function name="g_io_extension_point_set_required_type">
+<function name="g_settings_backend_keys_changed">
<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>
+Signals that a list of keys have possibly changed. Backend
+implementations should call this if keys have possibly changed their
+values.
-<function name="GSettingsBackend">
-<description>
-The "context" property gives a hint to the backend as to
-what storage to use. It is up to the implementation to make
-use of this information.
+ 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 '//').
-E.g. DConf supports "user", "system", "defaults" and "login"
-contexts.
+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.
-If your backend supports different contexts, you should also
-provide an implementation of the supports_context() class
-function in #GSettingsBackendClass.
+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).
-</description>
-<parameters>
-</parameters>
-<return></return>
-</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.
-<function name="GVolume">
-<description>
-This signal is emitted when the #GVolume have been removed. If
-the recipient is holding references to the object they should
-release them so the object can be finalized.
+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_socket_address_enumerator_next_async">
+<function name="g_file_query_settable_attributes">
<description>
-Asynchronously retrieves the next #GSocketAddress from @enumerator
-and then calls @callback, which must call
-g_socket_address_enumerator_next_finish() to get the result.
+Obtain the list of settable attributes for the file.
+
</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_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="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GFileAttributeInfoList describing the settable attributes.
+When you are done with it, release it with g_file_attribute_info_list_unref()
+</return>
</function>
<function name="g_settings_get_strv">
@@ -5118,22 +4909,23 @@ Since: 2.24
<return></return>
</function>
-<function name="g_volume_monitor_get_mounts">
+<function name="g_buffered_output_stream_new_sized">
<description>
-Gets a list of the mounts on the system.
-
-The returned list should be freed with g_list_free(), after
-its elements have been unreffed with g_object_unref().
+Creates a new buffered output stream with a given buffer size.
</description>
<parameters>
-<parameter name="volume_monitor">
-<parameter_description> a #GVolumeMonitor.
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a #gsize.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GMount objects.
+<return> a #GOutputStream with an internal buffer set to @size.
</return>
</function>
@@ -5142,6 +4934,7 @@ its elements have been unreffed with g_object_unref().
Gets the socket protocol id the socket was created with.
In case the protocol is unknown, -1 is returned.
+Since: 2.22
</description>
<parameters>
@@ -5152,7 +4945,6 @@ In case the protocol is unknown, -1 is returned.
</parameters>
<return> a protocol id, or -1 if unknown
-Since: 2.22
</return>
</function>
@@ -5203,12 +4995,22 @@ of the request.
<return></return>
</function>
-<function name="g_file_mount_mountable_finish">
+<function name="g_file_set_display_name">
<description>
-Finishes a mount operation. See g_file_mount_mountable() for details.
+Renames @file to the specified display name.
-Finish an asynchronous mount operation that was started
-with g_file_mount_mountable().
+The display name is converted from UTF8 to the correct encoding for the target
+filesystem if possible and the @file is renamed to this.
+
+If you want to implement a rename operation in the user interface the edit name
+(#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename
+widget, and then the result after editing should be passed to g_file_set_display_name().
+
+On success the resulting converted filename is returned.
+
+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>
@@ -5217,8 +5019,12 @@ with g_file_mount_mountable().
<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="display_name">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
@@ -5226,7 +5032,8 @@ with g_file_mount_mountable().
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile or %NULL on error.
+<return> a #GFile specifying what @file was renamed to, or %NULL
+if there was an error.
Free the returned object with g_object_unref().
</return>
</function>
@@ -5255,45 +5062,83 @@ Removes a supported type from an application, if possible.
</return>
</function>
-<function name="g_file_info_set_sort_order">
+<function name="g_output_stream_write_all">
<description>
-Sets the sort order attribute in the file info structure. See
-%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+Tries to write @count bytes from @buffer into the stream. Will block
+during the operation.
+
+This function is similar to g_output_stream_write(), except it tries to
+write as many bytes as requested, only stopping on an error.
+
+On a successful write of @count bytes, %TRUE is returned, and @bytes_written
+is set to @count.
+
+If there is an error during the operation FALSE is returned and @error
+is set to indicate the error status, @bytes_written is updated to contain
+the number of bytes written into the stream before the error occurred.
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
</parameter_description>
</parameter>
-<parameter name="sort_order">
-<parameter_description> a sort order integer.
+<parameter name="buffer">
+<parameter_description> the buffer containing the data to write.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to write
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that was
+written to the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occuring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on success, %FALSE if there was an error
+</return>
</function>
-<function name="g_socket_listener_set_backlog">
+<function name="g_settings_set_int">
<description>
-Sets the listen backlog on the sockets in the listener.
+Sets @key in @settings to @value.
-See g_socket_set_listen_backlog() for details
+A convenience variant of g_settings_set() for 32-bit integers.
-Since: 2.22
+It is a programmer error to pass a @key that isn't valid for
+ settings or is not of type int32.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="settings">
+<parameter_description> a #GSettings object
</parameter_description>
</parameter>
-<parameter name="listen_backlog">
-<parameter_description> an integer
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+</return>
</function>
<function name="g_io_scheduler_push_job">
@@ -5340,6 +5185,7 @@ Helper function for constructing #GInitiable object. This is
similar to g_object_newv() but also initializes the object
and returns %NULL, setting an error on failure.
+Since: 2.22
</description>
<parameters>
@@ -5367,7 +5213,6 @@ ignore.
</parameters>
<return> a newly allocated #GObject, or %NULL on error
-Since: 2.22
</return>
</function>
@@ -5375,6 +5220,7 @@ Since: 2.22
<description>
Creates a new #GCharsetConverter.
+Since: 2.24
</description>
<parameters>
@@ -5393,7 +5239,6 @@ Creates a new #GCharsetConverter.
</parameters>
<return> a new #GCharsetConverter or %NULL on error.
-Since: 2.24
</return>
</function>
@@ -5413,9 +5258,43 @@ Creates a new data input stream for the @base_stream.
</return>
</function>
+<function name="g_socket_listener_accept_finish">
+<description>
+Finishes an async accept operation. See g_socket_listener_accept_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 #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
<function name="g_unix_output_stream_get_close_fd">
<description>
-Return value: %TRUE if the file descriptor is closed when done
+Returns whether the file descriptor of @stream will be
+closed when the stream is closed.
+
+Since: 2.20
</description>
<parameters>
@@ -5426,7 +5305,6 @@ Return value: %TRUE if the file descriptor is closed when done
</parameters>
<return> %TRUE if the file descriptor is closed when done
-Since: 2.20
</return>
</function>
@@ -5501,6 +5379,7 @@ Sets the operation result to a boolean within the asynchronous result.
<description>
Creates a new #GInetSocketAddress for @address and @port.
+Since: 2.22
</description>
<parameters>
@@ -5515,7 +5394,6 @@ Creates a new #GInetSocketAddress for @address and @port.
</parameters>
<return> a new #GInetSocketAddress
-Since: 2.22
</return>
</function>
@@ -5548,35 +5426,24 @@ offset @offset bytes.
</return>
</function>
-<function name="g_settings_backend_setup">
+<function name="g_srv_target_get_weight">
<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.
+Gets @target's weight. You should not need to look at this;
+#GResolver already sorts the targets according to the algorithm in
+RFC 2782.
-Since: 2.26
+Since: 2.22
</description>
<parameters>
-<parameter name="context">
-<parameter_description> a context string (not %NULL or "")
-</parameter_description>
-</parameter>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend
+<parameter name="target">
+<parameter_description> a #GSrvTarget
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> @target's weight
+
+</return>
</function>
<function name="g_unix_fd_list_get">
@@ -5594,6 +5461,7 @@ when you are done.
A possible cause of failure is exceeding the per-process or
system-wide file descriptor limit.
+Since: 2.24
</description>
<parameters>
@@ -5612,7 +5480,6 @@ system-wide file descriptor limit.
</parameters>
<return> the file descriptor, or -1 in case of error
-Since: 2.24
</return>
</function>
@@ -5646,6 +5513,7 @@ g_socket_bind().
To set the maximum amount of outstanding clients, use
g_socket_set_listen_backlog().
+Since: 2.22
</description>
<parameters>
@@ -5660,7 +5528,6 @@ g_socket_set_listen_backlog().
</parameters>
<return> %TRUE on success, %FALSE on error.
-Since: 2.22
</return>
</function>
@@ -5670,6 +5537,7 @@ Helper function for constructing #GInitiable object. This is
similar to g_object_new() but also initializes the object
and returns %NULL, setting an error on failure.
+Since: 2.22
</description>
<parameters>
@@ -5699,7 +5567,6 @@ value pairs, and ended by %NULL.
</parameters>
<return> a newly allocated #GObject, or %NULL on error
-Since: 2.22
</return>
</function>
@@ -5771,18 +5638,6 @@ if possible.
<return></return>
</function>
-<function name="GMemoryOutputStream">
-<description>
-Function called with the buffer as argument when the stream is destroyed.
-
-Since: 2.24
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_volume_get_name">
<description>
Gets the name of @volume.
@@ -5864,40 +5719,27 @@ ignore.
</return>
</function>
-<function name="g_socket_listener_add_any_inet_port">
+<function name="g_file_info_set_attribute_byte_string">
<description>
-Listens for TCP connections on any available port number for both
-IPv6 and IPv4 (if each are available).
-
-This is useful if you need to have a socket for incoming connections
-but don't care about the specific port number.
-
- 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.
-
+Sets the @attribute to contain the given @attr_value,
+if possible.
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="attribute">
+<parameter_description> a file attribute key.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="attr_value">
+<parameter_description> a byte string.
</parameter_description>
</parameter>
</parameters>
-<return> the port number, or 0 in case of failure.
-
-Since: 2.24
-</return>
+<return></return>
</function>
<function name="g_inet_address_get_is_link_local">
@@ -5906,6 +5748,7 @@ Tests whether @address is a link-local address (that is, if it
identifies a host on a local network that is not connected to the
Internet).
+Since: 2.22
</description>
<parameters>
@@ -5916,36 +5759,28 @@ Internet).
</parameters>
<return> %TRUE if @address is a link-local address.
-Since: 2.22
</return>
</function>
-<function name="g_async_initable_new_finish">
+<function name="g_emblem_new_with_origin">
<description>
-Finishes the async construction for the various g_async_initable_new calls,
-returning the created object or %NULL on error.
+Creates a new emblem for @icon.
+Since: 2.18
</description>
<parameters>
-<parameter name="initable">
-<parameter_description> the #GAsyncInitable from the callback
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> the #GAsyncResult.from the callback
+<parameter name="icon">
+<parameter_description> a GIcon containing the icon.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="origin">
+<parameter_description> a GEmblemOrigin enum defining the emblem's origin
</parameter_description>
</parameter>
</parameters>
-<return> a newly created #GObject, or %NULL on error. Free with
-g_object_unref().
+<return> a new #GEmblem.
-Since: 2.22
</return>
</function>
@@ -6060,6 +5895,7 @@ Try to get the local address of a bound socket. This is only
useful if the socket has been bound to a local address,
either explicitly or implicitly when connecting.
+Since: 2.22
</description>
<parameters>
@@ -6075,7 +5911,6 @@ either explicitly or implicitly when connecting.
<return> a #GSocketAddress or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -6083,6 +5918,7 @@ Since: 2.22
<description>
Return the UNIX file descriptor that the stream writes to.
+Since: 2.20
</description>
<parameters>
@@ -6093,7 +5929,6 @@ Return the UNIX file descriptor that the stream writes to.
</parameters>
<return> The file descriptor of @stream
-Since: 2.20
</return>
</function>
@@ -6111,34 +5946,32 @@ Reload the mime information for the @dir.
<return></return>
</function>
-<function name="g_settings_new_with_context">
+<function name="g_loadable_icon_load_finish">
<description>
-Creates a new #GSettings object with a given schema and context.
-
-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.
+Finishes an asynchronous icon load started in g_loadable_icon_load_async().
-Since: 2.26
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="icon">
+<parameter_description> a #GLoadableIcon.
</parameter_description>
</parameter>
-<parameter name="context">
-<parameter_description> the context to use
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a location to store the type of the loaded icon, %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 new #GSettings object
+<return> a #GInputStream to read the icon from.
</return>
</function>
@@ -6147,6 +5980,7 @@ Since: 2.26
Gets the size of the native raw binary address for @address. This
is the size of the data that you get from g_inet_address_to_bytes().
+Since: 2.22
</description>
<parameters>
@@ -6157,7 +5991,6 @@ is the size of the data that you get from g_inet_address_to_bytes().
</parameters>
<return> the number of bytes used for the native version of @address.
-Since: 2.22
</return>
</function>
@@ -6168,13 +6001,13 @@ with it. #GResolver may use its reference count as a hint about how
many threads/processes, etc it should allocate for concurrent DNS
resolutions.
+Since: 2.22
</description>
<parameters>
</parameters>
<return> the default #GResolver.
-Since: 2.22
</return>
</function>
@@ -6324,6 +6157,7 @@ triggering the cancellable object from another thread. If the operation
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
be returned.
+Since: 2.22
</description>
<parameters>
@@ -6346,27 +6180,9 @@ be returned.
</parameters>
<return> a #GFileInfo for the @stream, or %NULL on error.
-Since: 2.22
</return>
</function>
-<function name="GMount">
-<description>
-This signal is emitted when the #GMount is about to be
-unmounted.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="mount">
-<parameter_description> the object on which the signal is emitted
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_content_type_can_be_executable">
<description>
Checks if a content type can be executable. Note that for instance
@@ -6390,6 +6206,7 @@ can be executable, %FALSE otherwise.
Finishes ejecting a mount. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
+Deprecated: 2.22: Use g_mount_eject_with_operation_finish() instead.
</description>
<parameters>
@@ -6409,21 +6226,9 @@ ignore.
</parameters>
<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
-Deprecated: 2.22: Use g_mount_eject_with_operation_finish() instead.
</return>
</function>
-<function name="GUnixSocketAddress">
-<description>
-A UNIX-domain (local) socket address, corresponding to a
-<type>struct sockaddr_un</type>.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_output_stream_set_pending">
<description>
Sets @stream to have actions pending. If the pending flag is
@@ -6488,6 +6293,24 @@ operations, but not in multiple concurrent operations.
</return>
</function>
+<function name="g_mount_operation_set_anonymous">
+<description>
+Sets the mount operation to use an anonymous user if @anonymous is %TRUE.
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="anonymous">
+<parameter_description> boolean value.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_input_stream_skip">
<description>
Tries to skip @count bytes from the stream. Will block during the operation.
@@ -6575,22 +6398,28 @@ required.
</return>
</function>
-<function name="g_data_output_stream_set_byte_order">
+<function name="g_io_modules_load_all_in_directory">
<description>
-Sets the byte order of the data output stream to @order.
+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="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="order">
-<parameter_description> a %GDataStreamByteOrder.
+<parameter name="dirname">
+<parameter_description> pathname for a directory containing modules to load.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<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_io_extension_get_priority">
@@ -6681,6 +6510,7 @@ Creates a new converter output stream for the @base_stream.
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>
@@ -6692,31 +6522,22 @@ descriptive to the user than the name itself.
<return> the display name of the application for @appinfo, or the name if
no display name is available.
-Since: 2.24
</return>
</function>
-<function name="g_buffered_input_stream_fill_finish">
+<function name="g_io_error_from_errno">
<description>
-Finishes an asynchronous read.
+Converts errno.h error codes into GIO error codes.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="err_no">
+<parameter_description> Error number as defined in errno.h.
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize of the read stream, or %-1 on an error.
+<return> #GIOErrorEnum value for the given errno.h error number.
</return>
</function>
@@ -6756,40 +6577,11 @@ Emits the #GMountOperation::reply signal.
<return></return>
</function>
-<function name="g_themed_icon_new_with_default_fallbacks">
-<description>
-Creates a new themed icon for @iconname, and all the names
-that can be created by shortening @iconname at '-' characters.
-
-In the following example, @icon1 and @icon2 are equivalent:
-|[
-const char *names[] = {
-"gnome-dev-cdrom-audio",
-"gnome-dev-cdrom",
-"gnome-dev",
-"gnome"
-};
-
-icon1 = g_themed_icon_new_from_names (names, 4);
-icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
-]|
-
-
-</description>
-<parameters>
-<parameter name="iconname">
-<parameter_description> a string containing an icon name
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GThemedIcon.
-</return>
-</function>
-
<function name="g_file_attribute_matcher_matches_only">
<description>
Checks if a attribute matcher only matches a given attribute. Always
-Returns: %TRUE if the matcher only matches @attribute. %FALSE otherwise.
+returns %FALSE if "*" was used when creating the matcher.
+
</description>
<parameters>
@@ -6827,6 +6619,7 @@ Checks if a drive can be ejected.
Creates a #GSocketAddress subclass corresponding to the native
<type>struct sockaddr</type> @native.
+Since: 2.22
</description>
<parameters>
@@ -6842,25 +6635,14 @@ Creates a #GSocketAddress subclass corresponding to the native
<return> a new #GSocketAddress if @native could successfully be converted,
otherwise %NULL.
-Since: 2.22
</return>
</function>
-<function name="GDataOutputStream">
-<description>
-Determines the byte ordering that is used when writing
-multi-byte entities (such as integers) to the stream.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_enumerator_get_container">
<description>
Get the #GFile container which is being enumerated.
+Since: 2.18
</description>
<parameters>
@@ -6871,7 +6653,6 @@ Get the #GFile container which is being enumerated.
</parameters>
<return> the #GFile which is being enumerated.
-Since: 2.18
</return>
</function>
@@ -6944,6 +6725,7 @@ ignore.
<description>
Tests whether @address is a node-local multicast address.
+Since: 2.22
</description>
<parameters>
@@ -6954,7 +6736,6 @@ Tests whether @address is a node-local multicast address.
</parameters>
<return> %TRUE if @address is a node-local multicast address.
-Since: 2.22
</return>
</function>
@@ -6962,6 +6743,7 @@ Since: 2.22
<description>
Finishes starting a drive.
+Since: 2.22
</description>
<parameters>
@@ -6981,42 +6763,9 @@ Finishes starting a drive.
<return> %TRUE if the drive has been started successfully,
%FALSE otherwise.
-Since: 2.22
</return>
</function>
-<function name="g_socket_listener_accept_socket_async">
-<description>
-This is the asynchronous version of g_socket_listener_accept_socket().
-
-When the operation is finished @callback will be
-called. You can then call g_socket_listener_accept_socket_finish()
-to get the result of the operation.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_cancellable_push_current">
<description>
Pushes @cancellable onto the cancellable stack. The current
@@ -7103,7 +6852,13 @@ g_output_stream_write().
<function name="get_all_desktop_entries_for_mime_type">
<description>
-Return value: a #GList containing the desktop ids which claim
+Returns all the desktop ids for @mime_type. The desktop files
+are listed in an order so that default applications are listed before
+non-default ones, and handlers for inherited mimetypes are listed
+after the base ones.
+
+Optionally doesn't list the desktop ids given in the @except
+
</description>
<parameters>
@@ -7121,6 +6876,24 @@ to handle @mime_type.
</return>
</function>
+<function name="g_socket_address_get_family">
+<description>
+Gets the socket family type of @address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the socket family type of @address.
+
+</return>
+</function>
+
<function name="g_socket_set_keepalive">
<description>
Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When
@@ -7160,6 +6933,7 @@ Since: 2.22
Gets the domain that @srv serves. This might be either UTF-8 or
ASCII-encoded, depending on what @srv was created with.
+Since: 2.22
</description>
<parameters>
@@ -7170,13 +6944,30 @@ ASCII-encoded, depending on what @srv was created with.
</parameters>
<return> @srv's domain name
-Since: 2.22
</return>
</function>
<function name="g_unix_fd_message_steal_fds">
<description>
-Returns: an array of file descriptors
+Returns the array of file descriptors that is contained in this
+object.
+
+After this call, the descriptors are no longer contained in
+ message Further calls will return an empty list (unless more
+descriptors have been added).
+
+The return result of this function must be freed with g_free().
+The caller is also responsible for closing all of the file
+descriptors.
+
+If @length is non-%NULL then it is set to the number of file
+descriptors in the returned array. The returned array is also
+terminated with -1.
+
+This function never returns %NULL. In case there are no file
+descriptors contained in @message, an empty array is returned.
+
+Since: 2.22
</description>
<parameters>
@@ -7191,7 +6982,6 @@ Returns: an array of file descriptors
</parameters>
<return> an array of file descriptors
-Since: 2.22
</return>
</function>
@@ -7233,9 +7023,13 @@ Since: 2.18
Waits for @condition to become true on @socket. When the condition
is met, %TRUE is returned.
-If @cancellable is cancelled before the condition is met then %FALSE
-is returned and @error, if non-%NULL, is set to %G_IO_ERROR_CANCELLED.
+If @cancellable is cancelled before the condition is met, or if the
+socket has a timeout set and it is reached before the condition is
+met, then %FALSE is returned and @error, if non-%NULL, is set to
+the appropriate value (%G_IO_ERROR_CANCELLED or
+%G_IO_ERROR_TIMED_OUT).
+Since: 2.22
</description>
<parameters>
@@ -7258,7 +7052,6 @@ is returned and @error, if non-%NULL, is set to %G_IO_ERROR_CANCELLED.
</parameters>
<return> %TRUE if the condition was met, %FALSE otherwise
-Since: 2.22
</return>
</function>
@@ -7266,6 +7059,7 @@ Since: 2.22
<description>
Gives back the icon from @emblem.
+Since: 2.18
</description>
<parameters>
@@ -7277,7 +7071,6 @@ Gives back the icon from @emblem.
<return> a #GIcon. The returned object belongs to the emblem
and should not be modified or freed.
-Since: 2.18
</return>
</function>
@@ -7297,30 +7090,6 @@ Checks if a unix mount point is read only.
</return>
</function>
-<function name="g_file_enumerator_next_file">
-<description>
-Return value: A #GFileInfo or %NULL on error or end of enumerator.
-
-</description>
-<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-</parameter_description>
-</parameter>
-</parameters>
-<return> A #GFileInfo or %NULL on error or end of enumerator.
-Free the returned object with g_object_unref() when no longer needed.
-</return>
-</function>
-
<function name="g_file_info_set_symlink_target">
<description>
Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info
@@ -7340,25 +7109,31 @@ to the given symlink target.
<return></return>
</function>
-<function name="g_mount_operation_get_domain">
+<function name="g_unix_fd_list_get_length">
<description>
-Gets the domain of the mount operation.
+Gets the length of @list (ie: the number of file descriptors
+contained within).
+Since: 2.24
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="list">
+<parameter_description> a #GUnixFDList
</parameter_description>
</parameter>
</parameters>
-<return> a string set to the domain.
+<return> the length of @list
+
</return>
</function>
<function name="g_win32_input_stream_get_close_handle">
<description>
-Return value: %TRUE if the handle is closed when done
+Returns whether the handle of @stream will be
+closed when the stream is closed.
+
+Since: 2.26
</description>
<parameters>
@@ -7369,56 +7144,22 @@ Return value: %TRUE if the handle is closed when done
</parameters>
<return> %TRUE if the handle is closed when done
-Since: 2.26
</return>
</function>
-<function name="g_drive_get_identifier">
-<description>
-Gets the identifier of the given kind for @drive.
-
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive
-</parameter_description>
-</parameter>
-<parameter name="kind">
-<parameter_description> the kind of identifier to return
-</parameter_description>
-</parameter>
-</parameters>
-<return> a newly allocated string containing the
-requested identfier, or %NULL if the #GDrive
-doesn't have this kind of identifier.
-</return>
-</function>
-
-<function name="GThreadedSocketService">
+<function name="g_file_info_get_display_name">
<description>
-The ::run signal is emitted in a worker thread in response to an
-incoming connection. This thread is dedicated to handling
- connection and may perform blocking IO. The signal handler need
-not return until the connection is closed.
+Gets a display name for a file.
</description>
<parameters>
-<parameter name="service">
-<parameter_description> the #GThreadedSocketService.
-</parameter_description>
-</parameter>
-<parameter name="connection">
-<parameter_description> a new #GSocketConnection object.
-</parameter_description>
-</parameter>
-<parameter name="source_object">
-<parameter_description> the source_object passed to g_socket_listener_add_address().
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE to stope further signal handlers from being called
+<return> a string containing the display name.
</return>
</function>
@@ -7466,26 +7207,32 @@ accordingly.
</return>
</function>
-<function name="g_file_info_get_attribute_int32">
+<function name="g_socket_address_enumerator_next_async">
<description>
-Gets a signed 32-bit integer contained within the attribute. If the
-attribute does not contain a signed 32-bit integer, or is invalid,
-0 will be returned.
-
+Asynchronously retrieves the next #GSocketAddress from @enumerator
+and then calls @callback, which must call
+g_socket_address_enumerator_next_finish() to get the result.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="enumerator">
+<parameter_description> a #GSocketAddressEnumerator
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<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> a signed 32-bit integer from the attribute.
-</return>
+<return></return>
</function>
<function name="g_socket_speaks_ipv4">
@@ -7500,6 +7247,7 @@ information.
No other types of sockets are currently considered as being capable
of speaking IPv4.
+Since: 2.22
</description>
<parameters>
@@ -7510,7 +7258,6 @@ of speaking IPv4.
</parameters>
<return> %TRUE if this socket can be used with IPv4.
-Since: 2.22
</return>
</function>
@@ -7521,6 +7268,7 @@ Creates a new #GWin32OutputStream for the given @handle.
If @close_handle, is %TRUE, the handle will be closed when the
output stream is destroyed.
+Since: 2.26
</description>
<parameters>
@@ -7535,7 +7283,6 @@ output stream is destroyed.
</parameters>
<return> a new #GOutputStream
-Since: 2.26
</return>
</function>
@@ -7545,6 +7292,7 @@ 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>
@@ -7560,13 +7308,31 @@ ignore
</parameters>
<return> %TRUE if pending was previously unset and is now set.
-Since: 2.22
</return>
</function>
<function name="g_unix_fd_list_steal_fds">
<description>
-Returns: an array of file descriptors
+Returns the array of file descriptors that is contained in this
+object.
+
+After this call, the descriptors are no longer contained in
+ list Further calls will return an empty list (unless more
+descriptors have been added).
+
+The return result of this function must be freed with g_free().
+The caller is also responsible for closing all of the file
+descriptors. The file descriptors in the array are set to
+close-on-exec.
+
+If @length is non-%NULL then it is set to the number of file
+descriptors in the returned array. The returned array is also
+terminated with -1.
+
+This function never returns %NULL. In case there are no file
+descriptors contained in @list, an empty array is returned.
+
+Since: 2.24
</description>
<parameters>
@@ -7581,70 +7347,23 @@ Returns: an array of file descriptors
</parameters>
<return> an array of file descriptors
-Since: 2.24
-</return>
-</function>
-
-<function name="g_simple_async_result_is_valid">
-<description>
-Ensures that the data passed to the _finish function of an async
-operation is consistent. Three checks are performed.
-
-First, @result is checked to ensure that it is really a
-#GSimpleAsyncResult. Second, @source is checked to ensure that it
-matches the source object of @result. Third, @source_tag is
-checked to ensure that it is equal to the source_tag argument given
-to g_simple_async_result_new() (which, by convention, is a pointer
-to the _async function corresponding to the _finish function from
-which this function is called).
-
-
-</description>
-<parameters>
-<parameter name="result">
-<parameter_description> the #GAsyncResult passed to the _finish function.
-</parameter_description>
-</parameter>
-<parameter name="source">
-<parameter_description> the #GObject passed to the _finish function.
-</parameter_description>
-</parameter>
-<parameter name="source_tag">
-<parameter_description> the asynchronous function.
-</parameter_description>
-</parameter>
-</parameters>
-<return> #TRUE if all checks passed or #FALSE if any failed.
</return>
</function>
-<function name="g_file_unmount_mountable_finish">
+<function name="g_mount_operation_get_choice">
<description>
-Finishes an unmount operation, see g_file_unmount_mountable() for details.
-
-Finish an asynchronous unmount operation that was started
-with g_file_unmount_mountable().
+Gets a choice from the mount operation.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
-
-Deprecated: 2.22: Use g_file_unmount_mountable_with_operation_finish() instead.
+<return> an integer containing an index of the user's choice from
+the choice's list, or %0.
</return>
</function>
@@ -7708,36 +7427,6 @@ when no longer needed.
</return>
</function>
-<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.
-
-Startup notification IDs are defined in the <ulink
-url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">
-FreeDesktop.Org Startup Notifications standard</ulink>.
-
-
-</description>
-<parameters>
-<parameter name="context">
-<parameter_description> a #GAppLaunchContext
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> a #GAppInfo
-</parameter_description>
-</parameter>
-<parameter name="files">
-<parameter_description> a #GList of of #GFile objects
-</parameter_description>
-</parameter>
-</parameters>
-<return> a startup notification ID for the application, or %NULL if
-not supported.
-</return>
-</function>
-
<function name="g_file_has_prefix">
<description>
Checks whether @file has the prefix specified by @prefix. In other word,
@@ -7783,38 +7472,6 @@ Gets the device path for a unix mount point.
</return>
</function>
-<function name="GNetworkService">
-<description>
-A #GSocketConnectable for resolving a SRV record and connecting to
-that service.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_unix_output_stream_set_close_fd">
-<description>
-Sets whether the file descriptor of @stream shall be closed
-when the stream is closed.
-
-Since: 2.20
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GUnixOutputStream
-</parameter_description>
-</parameter>
-<parameter name="close_fd">
-<parameter_description> %TRUE to close the file descriptor when done
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_mount_get_drive">
<description>
Gets the drive for the @mount.
@@ -7909,6 +7566,7 @@ Creates a new #GUnixSocketAddress for @path.
To create abstract socket addresses, on systems that support that,
use g_unix_socket_address_new_abstract().
+Since: 2.22
</description>
<parameters>
@@ -7919,49 +7577,41 @@ use g_unix_socket_address_new_abstract().
</parameters>
<return> a new #GUnixSocketAddress
-Since: 2.22
</return>
</function>
-<function name="g_resolver_lookup_by_name_async">
+<function name="g_file_enumerator_next_files_finish">
<description>
-Begins asynchronously resolving @hostname to determine its
-associated IP address(es), and eventually calls @callback, which
-must call g_resolver_lookup_by_name_finish() to get the result.
-See g_resolver_lookup_by_name() for more details.
+Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
-Since: 2.22
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="hostname">
-<parameter_description> the hostname to look up the address of
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GList of #GFileInfo<!---->s. You must free the list with
+g_list_free() and unref the infos with g_object_unref() when you're
+done with them.
+</return>
</function>
<function name="g_drive_get_start_stop_type">
<description>
Gets a hint about how a drive can be started/stopped.
+Since: 2.22
</description>
<parameters>
@@ -7972,7 +7622,6 @@ Gets a hint about how a drive can be started/stopped.
</parameters>
<return> A value from the #GDriveStartStopType enumeration.
-Since: 2.22
</return>
</function>
@@ -8002,38 +7651,72 @@ This call does no blocking i/o.
</return>
</function>
-<function name="g_settings_new_with_path">
+<function name="g_themed_icon_new">
<description>
-Creates a new #GSettings object with a given schema and path.
+Creates a new themed icon for @iconname.
-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.
+</description>
+<parameters>
+<parameter name="iconname">
+<parameter_description> a string containing an icon name.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GThemedIcon.
+</return>
+</function>
-Since: 2.26
+<function name="g_file_set_attributes_async">
+<description>
+Asynchronously sets the attributes of @file with @info.
+
+For more details, see g_file_set_attributes_from_info() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_set_attributes_finish() to get the result of the operation.
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path to use
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">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> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> a #gpointer.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
-</return>
+<return></return>
</function>
<function name="g_inet_address_get_is_mc_global">
<description>
Tests whether @address is a global multicast address.
+Since: 2.22
</description>
<parameters>
@@ -8044,7 +7727,25 @@ Tests whether @address is a global multicast address.
</parameters>
<return> %TRUE if @address is a global multicast address.
-Since: 2.22
+</return>
+</function>
+
+<function name="g_volume_monitor_get_mounts">
+<description>
+Gets a list of the mounts 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 #GMount objects.
</return>
</function>
@@ -8053,6 +7754,7 @@ Since: 2.22
Finishes an asynchronous file create operation started with
g_file_create_readwrite_async().
+Since: 2.22
</description>
<parameters>
@@ -8072,7 +7774,6 @@ g_file_create_readwrite_async().
<return> a #GFileIOStream or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -8108,6 +7809,7 @@ g_tcp_connection_set_graceful_disconnect(). But of course, this
only works if the client will close its connection after the server
does.)
+Since: 2.22
</description>
<parameters>
@@ -8122,7 +7824,6 @@ does.)
</parameters>
<return> %TRUE on success, %FALSE on error
-Since: 2.22
</return>
</function>
@@ -8232,6 +7933,33 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_socket_client_connect_finish">
+<description>
+Finishes an async connect operation. See g_socket_client_connect_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</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 #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
<function name="g_file_create_finish">
<description>
Finishes an asynchronous file create operation started with
@@ -8260,7 +7988,10 @@ Free the returned object with g_object_unref().
<function name="g_unix_input_stream_get_close_fd">
<description>
-Return value: %TRUE if the file descriptor is closed when done
+Returns whether the file descriptor of @stream will be
+closed when the stream is closed.
+
+Since: 2.20
</description>
<parameters>
@@ -8271,7 +8002,6 @@ Return value: %TRUE if the file descriptor is closed when done
</parameters>
<return> %TRUE if the file descriptor is closed when done
-Since: 2.20
</return>
</function>
@@ -8314,47 +8044,45 @@ classes. However, if you override one you must override all.
<return></return>
</function>
-<function name="g_mount_operation_get_password_save">
+<function name="g_app_info_launch">
<description>
-Gets the state of saving passwords for the mount operation.
+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.
-</description>
-<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GPasswordSave flag.
-</return>
-</function>
+Note that even if the launch is successful the application launched
+can fail to start if it runs into problems during startup. There is
+no way to detect this.
-<function name="g_data_output_stream_put_uint32">
-<description>
-Puts an unsigned 32-bit integer into the stream.
+Some URIs can be changed when passed through a GFile (for instance
+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.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> a #guint32.
+<parameter name="files">
+<parameter_description> a #GList of #GFile objects
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="launch_context">
+<parameter_description> a #GAppLaunchContext or %NULL
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
+<return> %TRUE on successful launch, %FALSE otherwise.
</return>
</function>
@@ -8364,6 +8092,7 @@ Gets the local address of the socket client.
See g_socket_client_set_local_address() for details.
+Since: 2.22
</description>
<parameters>
@@ -8374,7 +8103,6 @@ See g_socket_client_set_local_address() for details.
</parameters>
<return> a #GSocketAddres or %NULL. don't free
-Since: 2.22
</return>
</function>
@@ -8395,6 +8123,24 @@ a buffer set to the default size (4 kilobytes).
</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 when does not know.
+
+</return>
+</function>
+
<function name="g_content_type_guess">
<description>
Guesses the content type based on example data. If the function is
@@ -8427,66 +8173,61 @@ given data.
</return>
</function>
-<function name="g_settings_backend_keys_changed">
+<function name="g_simple_async_result_set_error_va">
<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
+Sets an error within the asynchronous result without a #GError.
+Unless writing a binding, see g_simple_async_result_set_error().
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path containing the changes
+<parameter name="domain">
+<parameter_description> a #GQuark (usually #G_IO_ERROR).
</parameter_description>
</parameter>
-<parameter name="items">
-<parameter_description> the %NULL-terminated list of changed keys
+<parameter name="code">
+<parameter_description> an error code.
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<parameter name="format">
+<parameter_description> a formatted error reporting string.
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description> va_list of arguments.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_settings_delay">
+<function name="g_drive_poll_for_media">
<description>
-Changes the #GSettings object into 'delay-apply' mode. In this
-mode, changes to @settings are not immediately propagated to the
-backend, but kept locally until g_settings_apply() is called.
+Asynchronously polls @drive to see if media has been inserted or removed.
-Since: 2.26
+When the operation is finished, @callback will be called.
+You can then call g_drive_poll_for_media_finish() to obtain the
+result of the operation.
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</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>
@@ -8517,6 +8258,7 @@ g_socket_connect()).
See g_socket_send() for additional information.
+Since: 2.22
</description>
<parameters>
@@ -8548,7 +8290,6 @@ See g_socket_send() for additional information.
<return> Number of bytes written (which may be less than @size), or -1
on error
-Since: 2.22
</return>
</function>
@@ -8587,22 +8328,35 @@ not supported.
</return>
</function>
-<function name="g_mount_operation_set_anonymous">
+<function name="g_file_query_writable_namespaces">
<description>
-Sets the mount operation to use an anonymous user if @anonymous is %TRUE.
+Obtain the list of attribute namespaces where new attributes
+can be created by a user. An example of this is extended
+attributes (in the "xattr" namespace).
+
+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="op">
-<parameter_description> a #GMountOperation.
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="anonymous">
-<parameter_description> boolean value.
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GFileAttributeInfoList describing the writable namespaces.
+When you are done with it, release it with g_file_attribute_info_list_unref()
+</return>
</function>
<function name="g_data_input_stream_read_line_finish">
@@ -8610,6 +8364,7 @@ Sets the mount operation to use an anonymous user if @anonymous is %TRUE.
Finish an asynchronous call started by
g_data_input_stream_read_line_async().
+Since: 2.20
</description>
<parameters>
@@ -8635,7 +8390,6 @@ 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.
-Since: 2.20
</return>
</function>
@@ -8655,30 +8409,6 @@ Gets the icon for a content type.
</return>
</function>
-<function name="SECTION">
-<description>
-Data output stream implements #GOutputStream and includes functions for
-writing data directly to an output stream.
-
-
-</description>
-<parameters>
-<parameter name="short_description">
-<parameter_description> Data Output Stream
-</parameter_description>
-</parameter>
-<parameter name="include">
-<parameter_description> gio/gio.h
-</parameter_description>
-</parameter>
-<parameter name="see_also">
-<parameter_description> #GOutputStream
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_eject_mountable_with_operation">
<description>
Starts an asynchronous eject on a mountable.
@@ -8722,22 +8452,17 @@ Since: 2.22
<return></return>
</function>
-<function name="g_unix_mounts_get">
+<function name="g_unix_fd_list_new">
<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
-with g_unix_mounts_changed_since().
+Creates a new #GUnixFDList containing no file descriptors.
+Since: 2.24
</description>
<parameters>
-<parameter name="time_read">
-<parameter_description> guint64 to contain a timestamp.
-</parameter_description>
-</parameter>
</parameters>
-<return> a #GList of the UNIX mounts.
+<return> a new #GUnixFDList
+
</return>
</function>
@@ -8773,6 +8498,7 @@ Gets @target's priority. You should not need to look at this;
#GResolver already sorts the targets according to the algorithm in
RFC 2782.
+Since: 2.22
</description>
<parameters>
@@ -8783,66 +8509,27 @@ RFC 2782.
</parameters>
<return> @target's priority
-Since: 2.22
</return>
</function>
-<function name="GVolumeMonitor">
+<function name="g_zlib_decompressor_new">
<description>
-Emitted when the stop button is pressed on @drive.
+Creates a new #GZlibDecompressor.
-Since: 2.22
+Since: 2.24
</description>
<parameters>
-<parameter name="volume_monitor">
-<parameter_description> The volume monitor emitting the signal.
-</parameter_description>
-</parameter>
-<parameter name="drive">
-<parameter_description> the drive where the stop button was pressed
+<parameter name="format">
+<parameter_description> The format to use for the compressed data
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="g_mount_operation_get_choice">
-<description>
-Gets a choice from the mount operation.
-
+<return> a new #GZlibDecompressor
-</description>
-<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
-</parameter_description>
-</parameter>
-</parameters>
-<return> an integer containing an index of the user's choice from
-the choice's list, or %0.
</return>
</function>
-<function name="g_file_info_set_icon">
-<description>
-Sets the icon for a given #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_ICON.
-
-</description>
-<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="icon">
-<parameter_description> a #GIcon.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gvdb_table_list">
<description>
List all of the keys that appear below @key. The nesting of keys
@@ -8890,6 +8577,7 @@ g_io_scheduler_push_job().
Creates a #GSocketConnection subclass of the right type for
@socket.
+Since: 2.22
</description>
<parameters>
@@ -8900,40 +8588,9 @@ Creates a #GSocketConnection subclass of the right type for
</parameters>
<return> a #GSocketConnection
-Since: 2.22
</return>
</function>
-<function name="g_drive_poll_for_media">
-<description>
-Asynchronously polls @drive to see if media has been inserted or removed.
-
-When the operation is finished, @callback will be called.
-You can then call g_drive_poll_for_media_finish() to obtain the
-result of the operation.
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</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_file_trash">
<description>
Sends @file to the "Trashcan", if possible. This is similar to
@@ -8966,18 +8623,22 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
-<function name="g_unix_fd_list_new">
+<function name="g_settings_delay">
<description>
-Creates a new #GUnixFDList containing no file descriptors.
+Changes the #GSettings object into 'delay-apply' mode. In this
+mode, changes to @settings are not immediately propagated to the
+backend, but kept locally until g_settings_apply() is called.
+Since: 2.26
</description>
<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GUnixFDList
-
-Since: 2.24
-</return>
+<return></return>
</function>
<function name="g_network_address_get_hostname">
@@ -8985,6 +8646,7 @@ Since: 2.24
Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded,
depending on what @addr was created with.
+Since: 2.22
</description>
<parameters>
@@ -8995,28 +8657,53 @@ depending on what @addr was created with.
</parameters>
<return> @addr's hostname
-Since: 2.22
</return>
</function>
-<function name="g_app_info_get_commandline">
+<function name="g_file_input_stream_query_info_async">
<description>
-Gets the commandline with which the application will be
-started.
+Queries the stream information asynchronously.
+When the operation is finished @callback will be called.
+You can then call g_file_input_stream_query_info_finish()
+to get the result of the operation.
+
+For the synchronous version of this function,
+see g_file_input_stream_query_info().
+
+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 set
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<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="io_priority">
+<parameter_description> the <link linkend="io-priority">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> a string containing the @appinfo's commandline,
-or %NULL if this information is not available
-
-Since: 2.20
-</return>
+<return></return>
</function>
<function name="g_file_unmount_mountable_with_operation_finish">
@@ -9026,6 +8713,7 @@ Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for
Finish an asynchronous unmount operation that was started
with g_file_unmount_mountable_with_operation().
+Since: 2.22
</description>
<parameters>
@@ -9045,69 +8733,26 @@ with g_file_unmount_mountable_with_operation().
<return> %TRUE if the operation finished successfully. %FALSE
otherwise.
-Since: 2.22
-</return>
-</function>
-
-<function name="g_unix_fd_message_append_fd">
-<description>
-Adds a file descriptor to @message.
-
-The file descriptor is duplicated using dup(). You keep your copy
-of the descriptor and the copy contained in @message will be closed
-when @message is finalized.
-
-A possible cause of failure is exceeding the per-process or
-system-wide file descriptor limit.
-
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> a #GUnixFDMessage
-</parameter_description>
-</parameter>
-<parameter name="fd">
-<parameter_description> a valid open file descriptor
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError pointer
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE in case of success, else %FALSE (and @error is set)
-
-Since: 2.22
</return>
</function>
-<function name="g_data_output_stream_put_uint64">
+<function name="g_simple_async_result_set_handle_cancellation">
<description>
-Puts an unsigned 64-bit integer into the stream.
+Sets whether to handle cancellation within the asynchronous operation.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a #guint64.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="handle_cancellation">
+<parameter_description> a #gboolean.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
-</return>
+<return></return>
</function>
<function name="g_file_get_parent">
@@ -9132,17 +8777,6 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="GSocketAddress">
-<description>
-A socket endpoint address, corresponding to <type>struct sockaddr</type>
-or one of its subtypes.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_set_attribute_byte_string">
<description>
Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
@@ -9188,7 +8822,8 @@ in the @file, %FALSE otherwise.
<function name="g_file_monitor_is_cancelled">
<description>
-Returns: %TRUE if monitor is canceled. %FALSE otherwise.
+Returns whether the monitor is canceled.
+
</description>
<parameters>
@@ -9201,30 +8836,46 @@ Returns: %TRUE if monitor is canceled. %FALSE otherwise.
</return>
</function>
-<function name="g_io_stream_close_finish">
+<function name="g_file_set_attributes_from_info">
<description>
-Closes a stream.
+Tries to set all attributes in the #GFileInfo on the target values,
+not stopping on the first error.
+
+If there is any error during this operation then @error will be set to
+the first error. Error on particular fields are flagged by setting
+the "status" field in the attribute value to
+%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect
+further errors.
+
+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 #GIOStream
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> #GFileQueryInfoFlags
+</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> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if stream was successfully closed, %FALSE otherwise.
-
-Since: 2.22
+<return> %TRUE if there was any error, %FALSE otherwise.
</return>
</function>
@@ -9273,6 +8924,7 @@ sockets with the specified @family,@type and @protocol_id.
If no type is registered, the #GSocketConnection base type is returned.
+Since: 2.22
</description>
<parameters>
@@ -9291,7 +8943,6 @@ If no type is registered, the #GSocketConnection base type is returned.
</parameters>
<return> a #GType
-Since: 2.22
</return>
</function>
@@ -9316,16 +8967,19 @@ Since: 2.26
</return>
</function>
-<function name="g_file_create_async">
+<function name="g_file_load_partial_contents_async">
<description>
-Asynchronously creates a new file and returns an output stream for writing to it.
-The file must not already exist.
+Reads the partial contents of a file. A #GFileReadMoreCallback should be
+used to stop reading from the file when appropriate, else this function
+will behave exactly as g_file_load_contents_async(). This operation
+can be finished by g_file_load_partial_contents_finish().
-For more details, see g_file_create() which is
-the synchronous version of this call.
+Users of this function should be aware that @user_data is passed to
+both the @read_more_callback and the @callback.
-When the operation is finished, @callback will be called. You can then call
-g_file_create_finish() to get the result of the operation.
+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>
@@ -9333,46 +8987,51 @@ g_file_create_finish() to get the result of the operation.
<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">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="read_more_callback">
+<parameter_description> a #GFileReadMoreCallback to receive partial data and to specify whether further data should be read.
+</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> the data to pass to the callback functions.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_io_stream_is_closed">
+<function name="g_data_output_stream_put_uint32">
<description>
-Checks if a stream is closed.
+Puts an unsigned 32-bit integer into the stream.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #guint32.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the stream is closed.
-
-Since: 2.22
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
@@ -9392,6 +9051,7 @@ One example where this is used is graceful disconnect for TCP connections
where you close the sending side, then wait for the other side to close
the connection, thus ensuring that the other side saw all sent data.
+Since: 2.22
</description>
<parameters>
@@ -9414,7 +9074,6 @@ the connection, thus ensuring that the other side saw all sent data.
</parameters>
<return> %TRUE on success, %FALSE on error
-Since: 2.22
</return>
</function>
@@ -9424,6 +9083,7 @@ Converts some common error codes into GIO error codes. The
fallback value G_IO_ERROR_FAILED is returned for error codes not
handled.
+Since: 2.26
</description>
<parameters>
@@ -9434,7 +9094,6 @@ handled.
</parameters>
<return> #GIOErrorEnum value for the given error number.
-Since: 2.26
</return>
</function>
@@ -9462,32 +9121,21 @@ The returned string should be freed with g_free() when no longer needed.
</return>
</function>
-<function name="g_loadable_icon_load_finish">
+<function name="g_inet_address_get_is_loopback">
<description>
-Finishes an asynchronous icon load started in g_loadable_icon_load_async().
+Tests whether @address is the loopback address for its family.
+Since: 2.22
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GLoadableIcon.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a location to store the type of the loaded icon, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="address">
+<parameter_description> a #GInetAddress
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream to read the icon from.
+<return> %TRUE if @address is the loopback address for its family.
+
</return>
</function>
@@ -9514,6 +9162,7 @@ Finishes an stop operation, see g_file_stop_mountable() for details.
Finish an asynchronous stop operation that was started
with g_file_stop_mountable().
+Since: 2.22
</description>
<parameters>
@@ -9533,7 +9182,6 @@ with g_file_stop_mountable().
<return> %TRUE if the operation finished successfully. %FALSE
otherwise.
-Since: 2.22
</return>
</function>
@@ -9546,6 +9194,7 @@ or similar functions.
The attribute must exist in @info for this to work. Otherwise %FALSE
is returned and @info is unchanged.
+Since: 2.22
</description>
<parameters>
@@ -9564,7 +9213,6 @@ is returned and @info is unchanged.
</parameters>
<return> %TRUE if the status was changed, %FALSE if the key was not set.
-Since: 2.22
</return>
</function>
@@ -9589,16 +9237,20 @@ of the OS.
</return>
</function>
-<function name="g_cancellable_get_current">
+<function name="g_file_info_get_etag">
<description>
-Gets the top cancellable from the stack.
+Gets the <link linkend="gfile-etag">entity tag</link> for a given
+#GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
</description>
<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GCancellable from the top of the stack, or %NULL
-if the stack is empty.
+<return> a string containing the value of the "etag:value" attribute.
</return>
</function>
@@ -9636,6 +9288,7 @@ function; there's no need to listen for the 'mount-added' signal on
<description>
Creates a new emblemed icon for @icon with the emblem @emblem.
+Since: 2.18
</description>
<parameters>
@@ -9650,7 +9303,6 @@ Creates a new emblemed icon for @icon with the emblem @emblem.
</parameters>
<return> a new #GIcon
-Since: 2.18
</return>
</function>
@@ -9670,53 +9322,6 @@ Gets the icon for the application.
</return>
</function>
-<function name="g_volume_get_activation_root">
-<description>
-Gets the activation root for a #GVolume if it is known ahead of
-mount time. Returns %NULL otherwise. If not %NULL and if @volume
-is mounted, then the result of g_mount_get_root() on the
-#GMount object obtained from g_volume_get_mount() will always
-either be equal or a prefix of what this function returns. In
-other words, in code
-
-<programlisting>
-GMount *mount;
-GFile *mount_root
-GFile *volume_activation_root;
-
-mount = g_volume_get_mount (volume); /* mounted, so never NULL */
-mount_root = g_mount_get_root (mount);
-volume_activation_root = g_volume_get_activation_root(volume); /* assume not NULL */
-</programlisting>
-
-then the expression
-
-<programlisting>
-(g_file_has_prefix (volume_activation_root, mount_root) ||
- g_file_equal (volume_activation_root, mount_root))
-</programlisting>
-
-will always be %TRUE.
-
-Activation roots are typically used in #GVolumeMonitor
-implementations to find the underlying mount to shadow, see
-g_mount_is_shadowed() for more details.
-
-
-</description>
-<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume
-</parameter_description>
-</parameter>
-</parameters>
-<return> the activation root of @volume or %NULL. Use
-g_object_unref() to free.
-
-Since: 2.18
-</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()).
@@ -9803,44 +9408,64 @@ Increases the reference count on @file.
</return>
</function>
-<function name="g_volume_monitor_get_connected_drives">
+<function name="g_file_eject_mountable_finish">
<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().
+Finishes an asynchronous eject operation started by
+g_file_eject_mountable().
+Deprecated: 2.22: Use g_file_eject_mountable_with_operation_finish() instead.
</description>
<parameters>
-<parameter name="volume_monitor">
-<parameter_description> a #GVolumeMonitor.
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of connected #GDrive objects.
-</return>
-</function>
-
-<function name="g_local_vfs_new">
-<description>
-Returns: a new #GVfs handle.
+<return> %TRUE if the @file was ejected successfully. %FALSE
+otherwise.
-</description>
-<parameters>
-</parameters>
-<return> a new #GVfs handle.
</return>
</function>
-<function name="GUnixInputStream">
+<function name="g_settings_backend_flatten_tree">
<description>
-Whether to close the file descriptor when the stream is closed.
+Calculate the longest common prefix of all keys in a tree and write
+out an array of the key names relative to that prefix and,
+optionally, the value to store at each of those keys.
-Since: 2.20
+You must free the value returned in @path, @keys and @values using
+g_free(). You should not attempt to free or unref the contents of
+ keys or @values.
+
+Since: 2.26
</description>
<parameters>
+<parameter name="tree">
+<parameter_description> a #GTree containing the changes
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the location to save the path
+</parameter_description>
+</parameter>
+<parameter name="keys">
+<parameter_description> the location to save the relative keys
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description> the location to save the values, or %NULL
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -9895,35 +9520,6 @@ Polls @file for changes.
</return>
</function>
-<function name="g_simple_async_result_new">
-<description>
-Creates a #GSimpleAsyncResult.
-
-
-</description>
-<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject the asynchronous function was called with,
-or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
-</parameter_description>
-</parameter>
-<parameter name="source_tag">
-<parameter_description> the asynchronous function.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GSimpleAsyncResult.
-</return>
-</function>
-
<function name="g_data_input_stream_read_until">
<description>
Reads a string from the data input stream, up to the first
@@ -10015,6 +9611,22 @@ or less than @mount2, respectively.
</return>
</function>
+<function name="g_unix_mount_guess_icon">
+<description>
+Guesses the icon of a Unix mount.
+
+
+</description>
+<parameters>
+<parameter name="mount_entry">
+<parameter_description> a #GUnixMountEntry
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIcon
+</return>
+</function>
+
<function name="g_resolver_free_addresses">
<description>
Frees @addresses (which should be the return value from
@@ -10046,67 +9658,21 @@ Gets the local #GVfs for the system.
</return>
</function>
-<function name="g_async_initable_init_async">
+<function name="g_filter_output_stream_get_close_base_stream">
<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.
+Returns whether the base stream will be closed when @stream is
+closed.
-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 name="stream">
+<parameter_description> a #GFilterOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the base stream will be closed.
+</return>
</function>
<function name="g_file_is_native">
@@ -10136,24 +9702,35 @@ This call does no blocking i/o.
</return>
</function>
-<function name="g_srv_target_get_weight">
+<function name="g_settings_backend_setup">
<description>
-Gets @target's weight. You should not need to look at this;
-#GResolver already sorts the targets according to the algorithm in
-RFC 2782.
+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="target">
-<parameter_description> a #GSrvTarget
+<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> @target's weight
-
-Since: 2.22
-</return>
+<return></return>
</function>
<function name="g_file_set_attribute_uint64">
@@ -10198,15 +9775,43 @@ in the @file, %FALSE otherwise.
</return>
</function>
-<function name="g_file_info_unset_attribute_mask">
+<function name="g_file_unmount_mountable_with_operation">
<description>
-Unsets a mask set by g_file_info_set_attribute_mask(), if one
-is set.
+Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_unmount_mountable_finish() to get the result of the operation.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> #GFileInfo.
+<parameter name="file">
+<parameter_description> input #GFile.
+</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 to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
@@ -10229,21 +9834,53 @@ Checks if the @drive supports removable media.
</return>
</function>
-<function name="g_volume_get_icon">
+<function name="g_unix_socket_address_get_address_type">
<description>
-Gets the icon for @volume.
+Gets @address's type.
+Since: 2.26
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume.
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
</parameter_description>
</parameter>
</parameters>
-<return> a #GIcon.
-The returned object should be unreffed with g_object_unref()
-when no longer needed.
+<return> a #GUnixSocketAddressType
+
+</return>
+</function>
+
+<function name="g_file_enumerator_next_file">
+<description>
+Returns information for the next file in the enumerated object.
+Will block until the information is available. The #GFileInfo
+returned from this function will contain attributes that match the
+attribute string that was passed when the #GFileEnumerator was created.
+
+On error, returns %NULL and sets @error to the error. If the
+enumerator is at the end, %NULL will be returned and @error will
+be unset.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occuring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GFileInfo or %NULL on error or end of enumerator.
+Free the returned object with g_object_unref() when no longer needed.
</return>
</function>
@@ -10251,6 +9888,7 @@ when no longer needed.
<description>
Gets the #GCharsetConverter:use-fallback property.
+Since: 2.24
</description>
<parameters>
@@ -10261,7 +9899,6 @@ Gets the #GCharsetConverter:use-fallback property.
</parameters>
<return> %TRUE if fallbacks are used by @converter
-Since: 2.24
</return>
</function>
@@ -10319,19 +9956,30 @@ Gets the attribute type, value and status for an attribute key.
</return>
</function>
-<function name="g_seekable_can_truncate">
+<function name="g_io_stream_close_finish">
<description>
-Tests if the stream can be truncated.
+Closes a stream.
+Since: 2.22
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</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> %TRUE if the stream can be truncated, %FALSE otherwise.
+<return> %TRUE if stream was successfully closed, %FALSE otherwise.
+
</return>
</function>
@@ -10420,6 +10068,7 @@ at a partial multibyte sequence). Converters are supposed to try
to produce as much output as possible and then return an error
(typically %G_IO_ERROR_PARTIAL_INPUT).
+Since: 2.24
</description>
<parameters>
@@ -10462,7 +10111,6 @@ to produce as much output as possible and then return an error
</parameters>
<return> a #GConverterResult, %G_CONVERTER_ERROR on error.
-Since: 2.24
</return>
</function>
@@ -10510,42 +10158,31 @@ g_output_stream_splice().
<return></return>
</function>
-<function name="GDataStream">
+<function name="g_unix_mount_guess_should_display">
<description>
-The :newline-type property determines what is considered
-as a line ending when reading complete lines from the stream.
+Guesses whether a Unix mount should be displayed in the UI.
+
</description>
<parameters>
+<parameter name="mount_entry">
+<parameter_description> a #GUnixMountEntry
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @mount_entry is deemed to be displayable.
+</return>
</function>
-<function name="g_data_output_stream_put_byte">
+<function name="g_mount_operation_new">
<description>
-Puts a byte into the output stream.
+Creates a new mount operation.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a #guchar.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
+<return> a #GMountOperation.
</return>
</function>
@@ -10570,6 +10207,7 @@ Checks if the unix mounts have changed since a given unix time.
Gets the keepalive mode of the socket. For details on this,
see g_socket_set_keepalive().
+Since: 2.22
</description>
<parameters>
@@ -10580,7 +10218,6 @@ see g_socket_set_keepalive().
</parameters>
<return> %TRUE if keepalive is active, %FALSE otherwise.
-Since: 2.22
</return>
</function>
@@ -10619,6 +10256,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<description>
Finishes an async connect operation. See g_socket_client_connect_to_service_async()
+Since: 2.22
</description>
<parameters>
@@ -10638,7 +10276,27 @@ ignore.
</parameters>
<return> a #GSocketConnection on success, %NULL on error.
-Since: 2.22
+</return>
+</function>
+
+<function name="g_output_stream_is_closing">
+<description>
+Checks if an output stream is being closed. This can be
+used inside e.g. a flush implementation to see if the
+flush (or other i/o operation) is called from within
+the closing operation.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is being closed. %FALSE otherwise.
+
</return>
</function>
@@ -10667,6 +10325,7 @@ will be returned. To be notified when data is available, wait for the
On error -1 is returned and @error is set accordingly.
+Since: 2.22
</description>
<parameters>
@@ -10694,7 +10353,6 @@ bytes long).
</parameters>
<return> Number of bytes read, or -1 on error
-Since: 2.22
</return>
</function>
@@ -10722,8 +10380,11 @@ attribute does not contain an signed 64-bit integer, or is invalid,
<function name="g_unix_socket_address_get_is_abstract">
<description>
-Gets @address's path.
+Tests if @address is abstract.
+Since: 2.22
+
+Deprecated: Use g_unix_socket_address_get_address_type()
</description>
<parameters>
@@ -10734,7 +10395,6 @@ Gets @address's path.
</parameters>
<return> %TRUE if the address is abstract, %FALSE otherwise
-Since: 2.22
</return>
</function>
@@ -10757,6 +10417,7 @@ and the user can be notified of the connection finishing by waiting
for the G_IO_OUT condition. The result of the connection can then be
checked with g_socket_check_connect_result().
+Since: 2.22
</description>
<parameters>
@@ -10779,7 +10440,43 @@ checked with g_socket_check_connect_result().
</parameters>
<return> %TRUE if connected, %FALSE on error.
-Since: 2.22
+</return>
+</function>
+
+<function name="g_seekable_truncate">
+<description>
+Truncates a stream with a given #offset.
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+<parameter name="offset">
+<parameter_description> a #goffset.
+</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> %TRUE if successful. If an error
+has occurred, this function will return %FALSE and set @error
+appropriately if present.
</return>
</function>
@@ -10823,6 +10520,7 @@ On error -1 is returned and @error is set accordingly.
<description>
Finishes ejecting a drive.
+Deprecated: 2.22: Use g_drive_eject_with_operation_finish() instead.
</description>
<parameters>
@@ -10842,20 +10540,12 @@ Finishes ejecting a drive.
<return> %TRUE if the drive has been ejected successfully,
%FALSE otherwise.
-Deprecated: 2.22: Use g_drive_eject_with_operation_finish() instead.
</return>
</function>
-<function name="g_socket_set_blocking">
+<function name="g_socket_get_socket_type">
<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.
+Gets the socket type of the socket.
Since: 2.22
@@ -10865,12 +10555,10 @@ Since: 2.22
<parameter_description> a #GSocket.
</parameter_description>
</parameter>
-<parameter name="blocking">
-<parameter_description> Whether to use blocking I/O or not.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a #GSocketType
+
+</return>
</function>
<function name="g_buffered_input_stream_get_buffer_size">
@@ -10891,7 +10579,21 @@ Gets the size of the input buffer.
<function name="g_unix_fd_list_peek_fds">
<description>
-Returns: an array of file descriptors
+Returns the array of file descriptors that is contained in this
+object.
+
+After this call, the descriptors remain the property of @list. The
+caller must not close them and must not free the array. The array is
+valid only until @list is changed in any way.
+
+If @length is non-%NULL then it is set to the number of file
+descriptors in the returned array. The returned array is also
+terminated with -1.
+
+This function never returns %NULL. In case there are no file
+descriptors contained in @list, an empty array is returned.
+
+Since: 2.24
</description>
<parameters>
@@ -10906,23 +10608,19 @@ Returns: an array of file descriptors
</parameters>
<return> an array of file descriptors
-Since: 2.24
</return>
</function>
-<function name="g_file_load_partial_contents_async">
+<function name="g_file_create_async">
<description>
-Reads the partial contents of a file. A #GFileReadMoreCallback should be
-used to stop reading from the file when appropriate, else this function
-will behave exactly as g_file_load_contents_async(). This operation
-can be finished by g_file_load_partial_contents_finish().
+Asynchronously creates a new file and returns an output stream for writing to it.
+The file must not already exist.
-Users of this function should be aware that @user_data is passed to
-both the @read_more_callback and the @callback.
+For more details, see g_file_create() which is
+the synchronous version of this call.
-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.
+When the operation is finished, @callback will be called. You can then call
+g_file_create_finish() to get the result of the operation.
</description>
<parameters>
@@ -10930,12 +10628,17 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<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 #GFileCreateFlags.
</parameter_description>
</parameter>
-<parameter name="read_more_callback">
-<parameter_description> a #GFileReadMoreCallback to receive partial data and to specify whether further data should be read.
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">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">
@@ -10943,30 +10646,19 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to the callback functions.
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="_fen_add">
-<description>
-Won't hold a ref, we have a timout callback to clean unused fdata.
-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_file_info_has_namespace">
<description>
Checks if a file info structure has an attribute in the
specified @name_space.
+Since: 2.22
</description>
<parameters>
@@ -10982,7 +10674,6 @@ specified @name_space.
<return> %TRUE if @Ginfo has an attribute in @name_space,
%FALSE otherwise.
-Since: 2.22
</return>
</function>
@@ -10991,6 +10682,7 @@ Since: 2.22
Obtains the information whether the #GAppInfo can be deleted.
See g_app_info_delete().
+Since: 2.20
</description>
<parameters>
@@ -11001,7 +10693,6 @@ See g_app_info_delete().
</parameters>
<return> %TRUE if @appinfo can be deleted
-Since: 2.20
</return>
</function>
@@ -11065,74 +10756,88 @@ tables, for example).
</return>
</function>
-<function name="g_srv_target_new">
+<function name="g_file_set_attribute">
<description>
-Creates a new #GSrvTarget with the given parameters.
+Sets an attribute in the file with attribute name @attribute to @value.
-You should not need to use this; normally #GSrvTarget<!-- -->s are
-created by #GResolver.
+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="hostname">
-<parameter_description> the host that the service is running on
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="port">
-<parameter_description> the port that the service is running on
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
</parameter_description>
</parameter>
-<parameter name="priority">
-<parameter_description> the target's priority
+<parameter name="type">
+<parameter_description> The type of the attribute
</parameter_description>
</parameter>
-<parameter name="weight">
-<parameter_description> the target's weight
+<parameter name="value_p">
+<parameter_description> a pointer to the value (or the pointer itself if the type is a pointer type)
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSrvTarget.
-
-Since: 2.22
+<return> %TRUE if the attribute was set, %FALSE otherwise.
</return>
</function>
-<function name="g_seekable_truncate">
+<function name="g_simple_async_report_error_in_idle">
<description>
-Truncates a stream with a given #offset.
-
-If @cancellable is not %NULL, then the operation can be cancelled by
-triggering the cancellable object from another thread. If the operation
-was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
-
+Reports an error in an asynchronous function in an idle function by
+directly setting the contents of the #GAsyncResult with the given error
+information.
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="object">
+<parameter_description> a #GObject.
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> a #goffset.
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="domain">
+<parameter_description> a #GQuark containing the error domain (usually #G_IO_ERROR).
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> a specific error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a formatted error reporting string.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of variables to fill in @format.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error
-has occurred, this function will return %FALSE and set @error
-appropriately if present.
-</return>
+<return></return>
</function>
<function name="g_file_icon_new">
@@ -11151,45 +10856,6 @@ Creates a new icon for a file.
</return>
</function>
-<function name="g_file_unmount_mountable">
-<description>
-Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
-
-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.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_unmount_mountable_finish() to get the result of the operation.
-
-Deprecated: 2.22: Use g_file_unmount_mountable_with_operation() instead.
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting 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, or %NULL.
-</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_settings_new">
<description>
Creates a new #GSettings object with a given schema.
@@ -11304,6 +10970,42 @@ Since: 2.22
<return></return>
</function>
+<function name="g_socket_listener_add_any_inet_port">
+<description>
+Listens for TCP connections on any available port number for both
+IPv6 and IPv4 (if each are available).
+
+This is useful if you need to have a socket for incoming connections
+but don't care about the specific port number.
+
+ 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.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</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> the port number, or 0 in case of failure.
+
+</return>
+</function>
+
<function name="g_app_info_get_default_for_uri_scheme">
<description>
Gets the default application for launching applications
@@ -11372,29 +11074,12 @@ Finishes setting an attribute started in g_file_set_attributes_async().
</return>
</function>
-<function name="g_inet_address_get_is_loopback">
-<description>
-Tests whether @address is the loopback address for its family.
-
-
-</description>
-<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if @address is the loopback address for its family.
-
-Since: 2.22
-</return>
-</function>
-
<function name="g_socket_get_listen_backlog">
<description>
Gets the listen backlog setting of the socket. For details on this,
see g_socket_set_listen_backlog().
+Since: 2.22
</description>
<parameters>
@@ -11405,7 +11090,6 @@ see g_socket_set_listen_backlog().
</parameters>
<return> the maximum number of pending connections.
-Since: 2.22
</return>
</function>
@@ -11462,6 +11146,7 @@ finished
<description>
Gets @srv's protocol name (eg, "tcp").
+Since: 2.22
</description>
<parameters>
@@ -11472,29 +11157,53 @@ Gets @srv's protocol name (eg, "tcp").
</parameters>
<return> @srv's protocol name
-Since: 2.22
</return>
</function>
-<function name="g_unix_fd_message_new">
+<function name="g_file_unmount_mountable">
<description>
-Creates a new #GUnixFDMessage containing an empty file descriptor
-list.
+Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
+
+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.
+When the operation is finished, @callback will be called. You can then call
+g_file_unmount_mountable_finish() to get the result of the operation.
+
+Deprecated: 2.22: Use g_file_unmount_mountable_with_operation() instead.
</description>
<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting 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, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GUnixFDMessage
-
-Since: 2.22
-</return>
+<return></return>
</function>
<function name="g_network_address_get_port">
<description>
Gets @addr's port number
+Since: 2.22
</description>
<parameters>
@@ -11505,10 +11214,47 @@ Gets @addr's port number
</parameters>
<return> @addr's port (which may be 0)
-Since: 2.22
</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="volume">
+<parameter_description> a #GVolume.
+</parameter_description>
+</parameter>
+<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>
+<return></return>
+</function>
+
<function name="g_unix_fd_list_append">
<description>
Adds a file descriptor to @list.
@@ -11524,6 +11270,7 @@ The index of the file descriptor in the list is returned. If you use
this index with g_unix_fd_list_get() then you will receive back a
duplicated copy of the same file descriptor.
+Since: 2.24
</description>
<parameters>
@@ -11543,35 +11290,32 @@ duplicated copy of the same file descriptor.
<return> the index of the appended fd in case of success, else -1
(and @error is set)
-Since: 2.24
</return>
</function>
-<function name="g_data_output_stream_put_uint16">
+<function name="g_settings_get_child">
<description>
-Puts an unsigned 16-bit integer into the output stream.
+Creates a 'child' settings object which has a base path of
+<replaceable>base-path</replaceable>/@name", where
+<replaceable>base-path</replaceable> is the base path of @settings.
+The schema for the child settings object must have been declared
+in the schema of @settings using a <tag class="starttag">child</tag> element.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a #guint16.
-</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> a #GError, %NULL to ignore.
+<parameter name="name">
+<parameter_description> the name of the 'child' schema
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
+<return> a 'child' settings object
</return>
</function>
@@ -11636,21 +11380,22 @@ g_simple_async_result_complete_in_idle().
<return></return>
</function>
-<function name="g_srv_target_get_port">
+<function name="g_volume_enumerate_identifiers">
<description>
-Gets @target's port
+Gets the kinds of <link linkend="volume-identifier">identifiers</link>
+that @volume has. Use g_volume_get_identifer() to obtain
+the identifiers themselves.
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="volume">
+<parameter_description> a #GVolume
</parameter_description>
</parameter>
</parameters>
-<return> @target's port
-
-Since: 2.22
+<return> a %NULL-terminated array of strings containing
+kinds of identifiers. Use g_strfreev() to free.
</return>
</function>
@@ -11739,27 +11484,24 @@ Checks if an input stream has pending actions.
</return>
</function>
-<function name="g_themed_icon_append_name">
+<function name="g_inet_address_new_any">
<description>
-Append a name to the list of icons from within @icon.
+Creates a #GInetAddress for the "any" address (unassigned/"don't
+care") for @family.
-<note><para>
-Note that doing so invalidates the hash computed by prior calls
-to g_icon_hash().
-</para></note>
+Since: 2.22
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GThemedIcon
-</parameter_description>
-</parameter>
-<parameter name="iconname">
-<parameter_description> name of icon to append to list of icons from within @icon.
+<parameter name="family">
+<parameter_description> the address family
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #GInetAddress corresponding to the "any" address
+for @family.
+
+</return>
</function>
<function name="g_socket_listener_add_socket">
@@ -11773,6 +11515,7 @@ 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.
+Since: 2.22
</description>
<parameters>
@@ -11795,47 +11538,6 @@ different things depending on what address is connected to.
</parameters>
<return> %TRUE on success, %FALSE on error.
-Since: 2.22
-</return>
-</function>
-
-<function name="g_file_info_set_attribute_byte_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 byte string.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_socket_control_message_get_msg_type">
-<description>
-Returns: an integer describing the type of control message
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> a #GSocketControlMessage
-</parameter_description>
-</parameter>
-</parameters>
-<return> an integer describing the type of control message
-
-Since: 2.22
</return>
</function>
@@ -11861,79 +11563,43 @@ not contain a byte string, %NULL will be returned.
</return>
</function>
-<function name="g_buffered_output_stream_new_sized">
+<function name="g_data_input_stream_read_uint64">
<description>
-Creates a new buffered output stream with a given buffer size.
-
-
-</description>
-<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="size">
-<parameter_description> a #gsize.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GOutputStream with an internal buffer set to @size.
-</return>
-</function>
+Reads an unsigned 64-bit/8-byte value from @stream.
-<function name="g_async_initable_new_async">
-<description>
-Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_new() but also initializes the object asynchronously.
+In order to get the correct byte order for this read operation,
+see g_data_stream_get_byte_order().
-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.
+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="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="stream">
+<parameter_description> a given #GDataInputStream.
</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_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">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> an unsigned 64-bit/8-byte read from @stream or %0 if
+an error occurred.
+</return>
</function>
<function name="g_emblemed_icon_get_emblems">
<description>
Gets the list of emblems for the @icon.
+Since: 2.18
</description>
<parameters>
@@ -11944,63 +11610,34 @@ Gets the list of emblems for the @icon.
</parameters>
<return> a #GList of #GEmblem <!-- -->s that is owned by @emblemed
-Since: 2.18
</return>
</function>
-<function name="g_emblem_new_with_origin">
+<function name="g_data_output_stream_put_uint64">
<description>
-Creates a new emblem for @icon.
+Puts an unsigned 64-bit integer into the stream.
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a GIcon containing the icon.
-</parameter_description>
-</parameter>
-<parameter name="origin">
-<parameter_description> a GEmblemOrigin enum defining the emblem's origin
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
</parameter_description>
</parameter>
-</parameters>
-<return> a new #GEmblem.
-
-Since: 2.18
-</return>
-</function>
-
-<function name="gvdb_table_new">
-<description>
-Creates a new #GvdbTable from the contents of the file found at
- filename
-
-The only time this function fails is if the file can not be opened.
-In that case, the #GError that is returned will be an error from
-g_mapped_file_new().
-
-An empty or otherwise corrupted file is considered to be a valid
-#GvdbTable with no entries.
-
-You should call gvdb_table_unref() on the return result when you no
-longer require it.
-
-</description>
-<parameters>
-<parameter name="filename">
-<parameter_description> the path to the hash file
+<parameter name="data">
+<parameter_description> a #guint64.
</parameter_description>
</parameter>
-<parameter name="trusted">
-<parameter_description> if the contents of @filename are trusted
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> %NULL, or a pointer to a %NULL #GError
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GvdbTable
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
@@ -12008,6 +11645,7 @@ longer require it.
<description>
Creates a new #GSocketClient with the default options.
+Since: 2.22
</description>
<parameters>
@@ -12015,7 +11653,6 @@ Creates a new #GSocketClient with the default options.
<return> a #GSocketClient.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -12024,6 +11661,7 @@ Since: 2.22
Finalizes the asynchronous query started
by g_file_io_stream_query_info_async().
+Since: 2.22
</description>
<parameters>
@@ -12042,7 +11680,6 @@ by g_file_io_stream_query_info_async().
</parameters>
<return> A #GFileInfo for the finished query.
-Since: 2.22
</return>
</function>
@@ -12067,19 +11704,6 @@ add to a #GHashTable or similar data structure.
</return>
</function>
-<function name="_ih_startup">
-<description>
-Initializes the inotify backend. This must be called before
-any other functions in this module.
-
-
-</description>
-<parameters>
-</parameters>
-<return> #TRUE if initialization succeeded, #FALSE otherwise
-</return>
-</function>
-
<function name="g_file_output_stream_query_info">
<description>
Queries a file output stream for the given @attributes.
@@ -12124,59 +11748,40 @@ be returned.
</return>
</function>
-<function name="g_io_extension_get_type">
+<function name="g_io_extension_point_lookup">
<description>
-Gets the type associated with @extension.
+Looks up an existing extension point.
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="name">
+<parameter_description> the name of the extension point
</parameter_description>
</parameter>
</parameters>
-<return> the type of @extension
+<return> the #GIOExtensionPoint, or %NULL if there is no
+registered extension point with the given name
</return>
</function>
-<function name="g_file_info_get_etag">
+<function name="g_inet_address_new_loopback">
<description>
-Gets the <link linkend="gfile-etag">entity tag</link> for a given
-#GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
+Creates a #GInetAddress for the loopback address for @family.
+Since: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="family">
+<parameter_description> the address family
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the value of the "etag:value" attribute.
-</return>
-</function>
-
-<function name="g_unix_mount_monitor_set_rate_limit">
-<description>
-Sets the rate limit to which the @mount_monitor will report
-consecutive change events to the mount and mount point entry files.
-
-Since: 2.18
+<return> a new #GInetAddress corresponding to the loopback address
+for @family.
-</description>
-<parameters>
-<parameter name="mount_monitor">
-<parameter_description> a #GUnixMountMonitor
-</parameter_description>
-</parameter>
-<parameter name="limit_msec">
-<parameter_description> a integer with the limit in milliseconds to
-poll for changes.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
+</return>
</function>
<function name="g_file_copy">
@@ -12343,6 +11948,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<description>
Checks whether a socket is closed.
+Since: 2.22
</description>
<parameters>
@@ -12353,7 +11959,6 @@ Checks whether a socket is closed.
</parameters>
<return> %TRUE if socket is closed, %FALSE otherwise
-Since: 2.22
</return>
</function>
@@ -12376,15 +11981,19 @@ complete directory names, and not file names.
<return></return>
</function>
-<function name="g_file_enumerator_next_files_finish">
+<function name="g_file_poll_mountable_finish">
<description>
-Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
+Finishes a poll operation. See g_file_poll_mountable() for details.
+
+Finish an asynchronous poll operation that was polled
+with g_file_poll_mountable().
+Since: 2.22
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
<parameter name="result">
@@ -12392,14 +12001,13 @@ Finishes the asynchronous operation started with g_file_enumerator_next_files_as
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GFileInfo<!---->s. You must free the list with
-g_list_free() and unref the infos with g_object_unref() when you're
-done with them.
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
</return>
</function>
@@ -12448,18 +12056,35 @@ string should be freed when no longer needed.
</return>
</function>
-<function name="g_filter_output_stream_get_close_base_stream">
+<function name="g_file_get_child_for_display_name">
<description>
-Return value: %TRUE if the base stream will be closed.
+Gets the child of @file for a given @display_name (i.e. a UTF8
+version of the name). If this function fails, it returns %NULL and @error will be
+set. This is very useful when constructing a GFile for a new file
+and the user entered the filename in the user interface, for instance
+when you select a directory and type a filename in the file selector.
+
+This call does no blocking i/o.
+
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterOutputStream.
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="display_name">
+<parameter_description> string to a possible child.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the base stream will be closed.
+<return> a #GFile to the specified child, or
+%NULL if the display name couldn't be converted.
+Free the returned object with g_object_unref().
</return>
</function>
@@ -12467,6 +12092,7 @@ Return value: %TRUE if the base stream will be closed.
<description>
Creates a new #GUnixFDMessage containing @list.
+Since: 2.24
</description>
<parameters>
@@ -12477,7 +12103,53 @@ Creates a new #GUnixFDMessage containing @list.
</parameters>
<return> a new #GUnixFDMessage
-Since: 2.24
+</return>
+</function>
+
+<function name="g_volume_get_activation_root">
+<description>
+Gets the activation root for a #GVolume if it is known ahead of
+mount time. Returns %NULL otherwise. If not %NULL and if @volume
+is mounted, then the result of g_mount_get_root() on the
+#GMount object obtained from g_volume_get_mount() will always
+either be equal or a prefix of what this function returns. In
+other words, in code
+
+<programlisting>
+GMount *mount;
+GFile *mount_root
+GFile *volume_activation_root;
+
+mount = g_volume_get_mount (volume); / * mounted, so never NULL * /
+mount_root = g_mount_get_root (mount);
+volume_activation_root = g_volume_get_activation_root(volume); / * assume not NULL * /
+</programlisting>
+
+then the expression
+
+<programlisting>
+(g_file_has_prefix (volume_activation_root, mount_root) ||
+ g_file_equal (volume_activation_root, mount_root))
+</programlisting>
+
+will always be %TRUE.
+
+Activation roots are typically used in #GVolumeMonitor
+implementations to find the underlying mount to shadow, see
+g_mount_is_shadowed() for more details.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> a #GVolume
+</parameter_description>
+</parameter>
+</parameters>
+<return> the activation root of @volume or %NULL. Use
+g_object_unref() to free.
+
</return>
</function>
@@ -12544,6 +12216,18 @@ Checks if a unix mount is a system path.
</return>
</function>
+<function name="g_vfs_get_default">
+<description>
+Gets the default #GVfs for the system.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GVfs.
+</return>
+</function>
+
<function name="missing_add">
<description>
Unsafe, need lock fen_lock.
@@ -12560,13 +12244,13 @@ Creates a new #GSocketService with no sockets to listen for.
New listeners can be added with e.g. g_socket_listener_add_address()
or g_socket_listener_add_inet_port().
+Since: 2.22
</description>
<parameters>
</parameters>
<return> a new #GSocketService.
-Since: 2.22
</return>
</function>
@@ -12596,6 +12280,7 @@ As well as reading the fd this also reads a single byte from the
stream, as this is required for fd passing to work on some
implementations.
+Since: 2.22
</description>
<parameters>
@@ -12614,7 +12299,6 @@ implementations.
</parameters>
<return> a file descriptor on success, -1 on error.
-Since: 2.22
</return>
</function>
@@ -12667,23 +12351,10 @@ more addresses.
<function name="g_unix_socket_address_new_abstract">
<description>
-Creates a new abstract #GUnixSocketAddress for @path.
-
-Unix domain sockets are generally visible in the filesystem. However, some
-systems support abstract socket name which are not visible in the
-filesystem and not affected by the filesystem permissions, visibility, etc.
-
-Note that not all systems (really only Linux) support abstract
-socket names, so if you use them on other systems function calls may
-return %G_IO_ERROR_NOT_SUPPORTED errors. You can use
-g_unix_socket_address_abstract_names_supported() to see if abstract
-names are supported.
-
-If @path_len is -1 then @path is assumed to be a zero terminated
-string (although in general abstract names need not be zero terminated
-and can have embedded nuls). All bytes after @path_len up to the max size
-of an abstract unix domain name is filled with zero bytes.
+Creates a new %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED
+#GUnixSocketAddress for @path.
+Deprecated: Use g_unix_socket_address_new_with_type().
</description>
<parameters>
@@ -12698,7 +12369,6 @@ of an abstract unix domain name is filled with zero bytes.
</parameters>
<return> a new #GUnixSocketAddress
-Since: 2.22
</return>
</function>
@@ -12773,6 +12443,7 @@ of message and if so deserialize it into a #GSocketControlMessage.
If there is no implementation for this kind of control message, %NULL
will be returned.
+Since: 2.22
</description>
<parameters>
@@ -12795,7 +12466,6 @@ will be returned.
</parameters>
<return> the deserialized message or %NULL
-Since: 2.22
</return>
</function>
@@ -12803,6 +12473,7 @@ Since: 2.22
<description>
Gets the socket family of the socket.
+Since: 2.22
</description>
<parameters>
@@ -12813,39 +12484,6 @@ Gets the socket family of the socket.
</parameters>
<return> a #GSocketFamily
-Since: 2.22
-</return>
-</function>
-
-<function name="g_filter_input_stream_get_base_stream">
-<description>
-Gets the base stream for the filter stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterInputStream.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GInputStream.
-</return>
-</function>
-
-<function name="g_unix_mount_point_get_fs_type">
-<description>
-Gets the file system type for the mount point.
-
-
-</description>
-<parameters>
-<parameter name="mount_point">
-<parameter_description> a #GUnixMountPoint.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a string containing the file system type.
</return>
</function>
@@ -12886,20 +12524,31 @@ Removes all cases of @attribute from @info if it exists.
<return></return>
</function>
-<function name="g_file_info_get_sort_order">
+<function name="g_drive_eject_with_operation_finish">
<description>
-Gets the value of the sort_order attribute from the #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+Finishes ejecting a drive. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+Since: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</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 #gint32 containing the value of the "standard::sort_order" attribute.
+<return> %TRUE if the drive was successfully ejected. %FALSE otherwise.
+
</return>
</function>
@@ -12968,6 +12617,7 @@ Gets the socket type of the socket client.
See g_socket_client_set_socket_type() for details.
+Since: 2.22
</description>
<parameters>
@@ -12978,7 +12628,6 @@ See g_socket_client_set_socket_type() for details.
</parameters>
<return> a #GSocketFamily
-Since: 2.22
</return>
</function>
@@ -13019,23 +12668,6 @@ Since: 2.26
</return>
</function>
-<function name="g_app_info_get_executable">
-<description>
-Gets the executable's name for the installed application.
-
-
-</description>
-<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
-</parameter_description>
-</parameter>
-</parameters>
-<return> a string containing the @appinfo's application
-binaries name
-</return>
-</function>
-
<function name="g_settings_get_value">
<description>
Gets the value that is stored in @settings for @key.
@@ -13060,44 +12692,102 @@ Since: 2.26
</return>
</function>
-<function name="g_file_get_child_for_display_name">
+<function name="g_socket_listener_accept">
<description>
-Gets the child of @file for a given @display_name (i.e. a UTF8
-version of the name). If this function fails, it returns %NULL and @error will be
-set. This is very useful when constructing a GFile for a new file
-and the user entered the filename in the user interface, for instance
-when you select a directory and type a filename in the file selector.
+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.
-This call does no blocking i/o.
+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="file">
-<parameter_description> input #GFile.
+<parameter name="listener">
+<parameter_description> a #GSocketListener
</parameter_description>
</parameter>
-<parameter name="display_name">
-<parameter_description> string to a possible child.
+<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.
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile to the specified child, or
-%NULL if the display name couldn't be converted.
-Free the returned object with g_object_unref().
+<return> a #GSocketConnection on success, %NULL on error.
+
</return>
</function>
+<function name="g_async_initable_new_async">
+<description>
+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> 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_desktop_app_info_get_filename">
<description>
When @info was created from a known filename, return it. In some
situations such as the #GDesktopAppInfo returned from
g_desktop_app_info_new_from_keyfile(), this function will return %NULL.
+Since: 2.24
</description>
<parameters>
@@ -13107,7 +12797,6 @@ g_desktop_app_info_new_from_keyfile(), this function will return %NULL.
</parameter>
</parameters>
<return> The full path to the file for @info, or %NULL if not known.
-Since: 2.24
</return>
</function>
@@ -13157,65 +12846,6 @@ not contain a string, %NULL will be returned.
</return>
</function>
-<function name="g_file_replace_contents_async">
-<description>
-Starts an asynchronous replacement of @file with the given
- contents of @length bytes. @etag will replace the document's
-current entity tag.
-
-When this operation has completed, @callback will be called with
- user_user data, and the operation can be finalized with
-g_file_replace_contents_finish().
-
-If @cancellable is not %NULL, then the operation can be cancelled by
-triggering the cancellable object from another thread. If the operation
-was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
-
-If @make_backup is %TRUE, this function will attempt to
-make a backup of @file.
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> string of contents to replace the file with.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> the length of @contents in bytes.
-</parameter_description>
-</parameter>
-<parameter name="etag">
-<parameter_description> a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
-</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_content_type_equals">
<description>
Compares two content types for equality.
@@ -13256,31 +12886,36 @@ to the given size.
<return></return>
</function>
-<function name="g_file_eject_mountable_finish">
+<function name="g_simple_async_result_is_valid">
<description>
-Finishes an asynchronous eject operation started by
-g_file_eject_mountable().
+Ensures that the data passed to the _finish function of an async
+operation is consistent. Three checks are performed.
+
+First, @result is checked to ensure that it is really a
+#GSimpleAsyncResult. Second, @source is checked to ensure that it
+matches the source object of @result. Third, @source_tag is
+checked to ensure that it is equal to the source_tag argument given
+to g_simple_async_result_new() (which, by convention, is a pointer
+to the _async function corresponding to the _finish function from
+which this function is called).
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="result">
+<parameter_description> the #GAsyncResult passed to the _finish function.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="source">
+<parameter_description> the #GObject passed to the _finish function.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="source_tag">
+<parameter_description> the asynchronous function.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @file was ejected successfully. %FALSE
-otherwise.
-
-Deprecated: 2.22: Use g_file_eject_mountable_with_operation_finish() instead.
+<return> #TRUE if all checks passed or #FALSE if any failed.
</return>
</function>
@@ -13349,14 +12984,23 @@ Since: 2.26
</return>
</function>
-<function name="GFileIcon">
+<function name="g_inet_address_to_string">
<description>
-The file containing the icon.
+Converts @address to string form.
+
+Since: 2.22
</description>
<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> a representation of @address as a string, which should be
+freed after use.
+
+</return>
</function>
<function name="g_socket_bind">
@@ -13379,6 +13023,7 @@ fully cleaned-up by the kernel. Failing to set this flag on a server
socket may cause the bind call to return %G_IO_ERROR_ADDRESS_IN_USE if
the server program is stopped and then immediately restarted.)
+Since: 2.22
</description>
<parameters>
@@ -13401,10 +13046,48 @@ the server program is stopped and then immediately restarted.)
</parameters>
<return> %TRUE on success, %FALSE on error.
-Since: 2.22
</return>
</function>
+<function name="g_socket_set_timeout">
+<description>
+Sets the time in seconds after which I/O operations on @socket will
+time out if they have not yet completed.
+
+On a blocking socket, this means that any blocking #GSocket
+operation will time out after @timeout seconds of inactivity,
+returning %G_IO_ERROR_TIMED_OUT.
+
+On a non-blocking socket, calls to g_socket_condition_wait() will
+also fail with %G_IO_ERROR_TIMED_OUT after the given time. Sources
+created with g_socket_create_source() will trigger after
+ timeout seconds of inactivity, with the requested condition
+set, at which point calling g_socket_receive(), g_socket_send(),
+g_socket_check_connect_result(), etc, will fail with
+%G_IO_ERROR_TIMED_OUT.
+
+If @timeout is 0 (the default), operations will never time out
+on their own.
+
+Note that if an I/O operation is interrupted by a signal, this may
+cause the timeout to be reset.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the timeout for @socket, in seconds, or 0 for none
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_app_info_set_as_default_for_extension">
<description>
Sets the application as the default handler for the given file extension.
@@ -13487,6 +13170,7 @@ As well as sending the fd this also writes a single byte to the
stream, as this is required for fd passing to work on some
implementations.
+Since: 2.22
</description>
<parameters>
@@ -13509,7 +13193,6 @@ implementations.
</parameters>
<return> a %TRUE on success, %NULL on error.
-Since: 2.22
</return>
</function>
@@ -13547,6 +13230,7 @@ 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>
@@ -13566,7 +13250,22 @@ a value from #GResolverError. If the operation was cancelled,
<return> a hostname (either ASCII-only, or in ASCII-encoded
form), or %NULL on error.
-Since: 2.22
+</return>
+</function>
+
+<function name="g_unix_mount_point_get_fs_type">
+<description>
+Gets the file system type for the mount point.
+
+
+</description>
+<parameters>
+<parameter name="mount_point">
+<parameter_description> a #GUnixMountPoint.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the file system type.
</return>
</function>
@@ -13621,7 +13320,13 @@ while on win32 it is "*".
<function name="g_socket_get_fd">
<description>
-Returns: the file descriptor of the socket.
+Returns the underlying OS socket object. On unix this
+is a socket file descriptor, and on windows this is
+a Winsock2 SOCKET handle. This may be useful for
+doing platform specific or otherwise unusual operations
+on the socket.
+
+Since: 2.22
</description>
<parameters>
@@ -13632,7 +13337,6 @@ Returns: the file descriptor of the socket.
</parameters>
<return> the file descriptor of the socket.
-Since: 2.22
</return>
</function>
@@ -13719,55 +13423,68 @@ of the request.
<return></return>
</function>
-<function name="g_unix_mount_guess_can_eject">
+<function name="g_data_output_stream_set_byte_order">
<description>
-Guesses whether a Unix mount can be ejected.
-
+Sets the byte order of the data output stream to @order.
</description>
<parameters>
-<parameter name="mount_entry">
-<parameter_description> a #GUnixMountEntry
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="order">
+<parameter_description> a %GDataStreamByteOrder.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @mount_entry is deemed to be ejectable.
-</return>
+<return></return>
</function>
-<function name="g_socket_control_message_get_size">
+<function name="g_data_input_stream_set_byte_order">
<description>
-Returns: The number of bytes required.
+This function sets the byte order for the given @stream. All subsequent
+reads from the @stream will be read in the given @order.
+
</description>
<parameters>
-<parameter name="message">
-<parameter_description> a #GSocketControlMessage
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="order">
+<parameter_description> a #GDataStreamByteOrder to set.
</parameter_description>
</parameter>
</parameters>
-<return> The number of bytes required.
-
-Since: 2.22
-</return>
+<return></return>
</function>
-<function name="g_inet_address_to_string">
+<function name="g_drive_stop_finish">
<description>
-Converts @address to string form.
+Finishes stopping a drive.
+Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a representation of @address as a string, which should be
-freed after use.
+<return> %TRUE if the drive has been stopped successfully,
+%FALSE otherwise.
-Since: 2.22
</return>
</function>
@@ -13842,35 +13559,20 @@ Sets a default choice for the mount operation.
<return></return>
</function>
-<function name="g_data_input_stream_read_int64">
+<function name="g_mount_operation_get_anonymous">
<description>
-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().
-
-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.
+Check to see whether the mount operation is being used
+for an anonymous user.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
-</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 name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
</parameters>
-<return> a signed 64-bit/8-byte value read from @stream or %0 if
-an error occurred.
+<return> %TRUE if mount operation is anonymous.
</return>
</function>
@@ -13936,19 +13638,22 @@ by g_file_output_stream_query_info_async().
</return>
</function>
-<function name="g_simple_async_result_get_op_res_gpointer">
+<function name="g_socket_is_connected">
<description>
-Gets a pointer result as returned by the asynchronous function.
+Check whether the socket is connected. This is only useful for
+connection-oriented sockets.
+Since: 2.22
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="socket">
+<parameter_description> a #GSocket.
</parameter_description>
</parameter>
</parameters>
-<return> a pointer from the result.
+<return> %TRUE if socket is connected, %FALSE otherwise.
+
</return>
</function>
@@ -13977,6 +13682,7 @@ If you are planning to connect to the service, it is usually easier
to create a #GNetworkService and use its #GSocketConnectable
interface.
+Since: 2.22
</description>
<parameters>
@@ -14009,7 +13715,6 @@ interface.
free each of the targets and the list when you are done with it.
(You can use g_resolver_free_targets() to do this.)
-Since: 2.22
</return>
</function>
@@ -14126,17 +13831,6 @@ Frees a unix mount point.
<return></return>
</function>
-<function name="GInetSocketAddress">
-<description>
-An IPv4 or IPv6 socket address, corresponding to a <type>struct
-sockaddr_in</type> or <type>struct sockaddr_in6</type>.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_drive_start">
<description>
Asynchronously starts a drive.
@@ -14177,6 +13871,25 @@ Since: 2.22
<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_file_create_readwrite">
<description>
Creates a new file and returns a stream for reading and writing to it.
@@ -14201,6 +13914,7 @@ Note that in many non-local file cases read and write streams are not
supported, so make sure you really need to do read and write streaming,
rather than just opening for reading or writing.
+Since: 2.22
</description>
<parameters>
@@ -14224,45 +13938,67 @@ rather than just opening for reading or writing.
<return> a #GFileIOStream for the newly created file, or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
-<function name="g_file_read_async">
+<function name="g_socket_listener_add_address">
<description>
-Asynchronously opens @file for reading.
+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.
-For more details, see g_file_read() which is
-the synchronous version of this call.
+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().
-When the operation is finished, @callback will be called. You can then call
-g_file_read_finish() to get the result of the operation.
+ 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="file">
-<parameter_description> input #GFile
+<parameter name="listener">
+<parameter_description> a #GSocketListener
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="address">
+<parameter_description> a #GSocketAddress
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="type">
+<parameter_description> a #GSocketType
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="protocol">
+<parameter_description> a #GSocketProtocol
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<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></return>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
</function>
<function name="g_data_input_stream_read_int32">
@@ -14297,6 +14033,24 @@ an error occurred.
</return>
</function>
+<function name="g_emblem_get_origin">
+<description>
+Gets the origin of the emblem.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblem">
+<parameter_description> a #GEmblem
+</parameter_description>
+</parameter>
+</parameters>
+<return> the origin of the emblem
+
+</return>
+</function>
+
<function name="g_file_info_set_display_name">
<description>
Sets the display name for the current #GFileInfo.
@@ -14342,49 +14096,46 @@ Free the returned object with g_object_unref().
</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().
+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
-
-Since: 2.22
-</return>
+<return></return>
</function>
<function name="g_seekable_can_seek">
@@ -14408,6 +14159,7 @@ Tests if the stream supports the #GSeekableIface.
Gets the value of a stringv attribute. If the attribute does
not contain a stringv, %NULL will be returned.
+Since: 2.22
</description>
<parameters>
@@ -14423,7 +14175,6 @@ not contain a stringv, %NULL will be returned.
<return> the contents of the @attribute value as a stringv, or
%NULL otherwise. Do not free.
-Since: 2.22
</return>
</function>
@@ -14452,7 +14203,48 @@ if possible.
<function name="g_file_replace">
<description>
-Returns: a #GFileOutputStream or %NULL on error.
+Returns an output stream for overwriting the file, possibly
+creating a backup copy of the file first. If the file doesn't exist,
+it will be created.
+
+This will try to replace the file in the safest way possible so
+that any errors during the writing will not affect an already
+existing copy of the file. For instance, for local files it
+may write to a temporary file and then atomically rename over
+the destination when the stream is closed.
+
+By default files created are generally readable by everyone,
+but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
+will be made readable only to the current user, to the level that
+is supported on the target filesystem.
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
+
+If you pass in a non-#NULL @etag value, then this value is
+compared to the current entity tag of the file, and if they differ
+an G_IO_ERROR_WRONG_ETAG error is returned. This generally means
+that the file has been changed since you last read it. You can get
+the new etag from g_file_output_stream_get_etag() after you've
+finished writing and closed the #GFileOutputStream. When you load
+a new file you can use g_file_input_stream_query_info() to get
+the etag of the file.
+
+If @make_backup is %TRUE, this function will attempt to make a backup
+of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP
+error will be returned. If you want to replace anyway, try again with
+ make_backup set to %FALSE.
+
+If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned,
+and if the file is some other form of non-regular file then a
+G_IO_ERROR_NOT_REGULAR_FILE error will be returned.
+Some file systems don't allow all file names, and may
+return an G_IO_ERROR_INVALID_FILENAME error, and if the name
+is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
+Other errors are possible too, and depend on what kind of
+filesystem the file is on.
+
</description>
<parameters>
@@ -14487,49 +14279,55 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_mount_operation_new">
+<function name="gvdb_table_new">
<description>
-Creates a new mount operation.
+Creates a new #GvdbTable from the contents of the file found at
+ filename
+The only time this function fails is if the file can not be opened.
+In that case, the #GError that is returned will be an error from
+g_mapped_file_new().
+
+An empty or otherwise corrupted file is considered to be a valid
+#GvdbTable with no entries.
+
+You should call gvdb_table_unref() on the return result when you no
+longer require it.
</description>
<parameters>
+<parameter name="filename">
+<parameter_description> the path to the hash file
+</parameter_description>
+</parameter>
+<parameter name="trusted">
+<parameter_description> if the contents of @filename are trusted
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> %NULL, or a pointer to a %NULL #GError
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GMountOperation.
+<return> a new #GvdbTable
</return>
</function>
-<function name="g_file_monitor_directory">
+<function name="g_inet_address_get_is_mc_org_local">
<description>
-Obtains a directory monitor for the given file.
-This may fail if directory monitoring is not supported.
-
-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.
+Tests whether @address is an organization-local multicast address.
+Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileMonitorFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL.
+<parameter name="address">
+<parameter_description> a #GInetAddress
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileMonitor for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if @address is an organization-local multicast address.
+
</return>
</function>
@@ -14572,40 +14370,6 @@ all keys in the unix namespace.</entry></row>
</return>
</function>
-<function name="GCharsetConverter">
-<description>
-Conversions between character sets.
-
-</description>
-<parameters>
-</parameters>
-<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_socket_condition_check">
<description>
Checks on the readiness of @socket to perform operations.
@@ -14618,6 +14382,7 @@ these conditions will always be set in the output if they are true.
This call never blocks.
+Since: 2.22
</description>
<parameters>
@@ -14632,7 +14397,6 @@ This call never blocks.
</parameters>
<return> the @GIOCondition mask of the current state
-Since: 2.22
</return>
</function>
@@ -14643,6 +14407,7 @@ this to the user, you should use g_hostname_is_ascii_encoded() to
check if it contains encoded Unicode segments, and use
g_hostname_to_unicode() to convert it if it does.)
+Since: 2.22
</description>
<parameters>
@@ -14653,7 +14418,6 @@ g_hostname_to_unicode() to convert it if it does.)
</parameters>
<return> @target's hostname
-Since: 2.22
</return>
</function>
@@ -14711,42 +14475,6 @@ and #GAsyncResult returned in the @callback.
<return></return>
</function>
-<function name="g_socket_client_connect_async">
-<description>
-This is the asynchronous version of g_socket_client_connect().
-
-When the operation is finished @callback will be
-called. You can then call g_socket_client_connect_finish() to get
-the result of the operation.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="client">
-<parameter_description> a #GTcpClient
-</parameter_description>
-</parameter>
-<parameter name="connectable">
-<parameter_description> a #GSocketConnectable specifying the remote address.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_io_extension_point_implement">
<description>
Registers @type as extension for the extension point with name
@@ -14779,53 +14507,28 @@ extension point, the existing #GIOExtension object is returned.
</return>
</function>
-<function name="GResolver">
-<description>
-Emitted when the resolver notices that the system resolver
-configuration has changed.
-
-</description>
-<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_unix_mount_is_readonly">
+<function name="g_file_attribute_matcher_enumerate_next">
<description>
-Checks if a unix mount is mounted read only.
+Gets the next matched attribute from a #GFileAttributeMatcher.
</description>
<parameters>
-<parameter name="mount_entry">
-<parameter_description> a #GUnixMount.
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @mount_entry is read only.
+<return> a string containing the next attribute or %NULL if
+no more attribute exist.
</return>
</function>
-<function name="GUnixOutputStream">
-<description>
-Whether to close the file descriptor when the stream is closed.
-
-Since: 2.20
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_inet_address_new_from_string">
<description>
Parses @string as an IP address and creates a new #GInetAddress.
+Since: 2.22
</description>
<parameters>
@@ -14837,7 +14540,6 @@ Parses @string as an IP address and creates a new #GInetAddress.
<return> a new #GInetAddress corresponding to @string, or %NULL if
@string could not be parsed.
-Since: 2.22
</return>
</function>
@@ -14862,57 +14564,81 @@ Gets the attribute type for an attribute key.
</return>
</function>
-<function name="g_file_find_enclosing_mount_finish">
+<function name="g_file_attribute_info_list_lookup">
<description>
-Finishes an asynchronous find mount request.
-See g_file_find_enclosing_mount_async().
+Gets the file attribute with the name @name from @list.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="name">
+<parameter_description> the name of the attribute to lookup.
</parameter_description>
</parameter>
</parameters>
-<return> #GMount for given @file or %NULL on error.
-Free the returned object with g_object_unref().
+<return> a #GFileAttributeInfo for the @name, or %NULL if an
+attribute isn't found.
</return>
</function>
-<function name="g_inet_socket_address_get_port">
+<function name="g_app_info_get_id">
<description>
-Gets @address's port.
+Gets the ID of an application. An id is a string that
+identifies the application. The exact format of the id is
+platform dependent. For instance, on Unix this is the
+desktop file id from the xdg menu specification.
+
+Note that the returned ID may be %NULL, depending on how
+the @appinfo has been constructed.
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetSocketAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> the port for @address
-
-Since: 2.22
+<return> a string containing the application's ID.
</return>
</function>
-<function name="GMountOperation">
+<function name="g_socket_client_connect_async">
<description>
-The index of the user's choice when a question is asked during the
-mount operation. See the #GMountOperation::ask-question signal.
+This is the asynchronous version of g_socket_client_connect().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_client_connect_finish() to get
+the result of the operation.
+
+Since: 2.22
</description>
<parameters>
+<parameter name="client">
+<parameter_description> a #GTcpClient
+</parameter_description>
+</parameter>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable specifying the remote address.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -15003,6 +14729,37 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_settings_new_with_context">
+<description>
+Creates a new #GSettings object with a given schema and context.
+
+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.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> the name of the schema
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> the context to use
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+</return>
+</function>
+
<function name="g_memory_input_stream_add_data">
<description>
Appends @data to data that can be read from the input stream
@@ -15034,6 +14791,7 @@ Appends @data to data that can be read from the input stream
Gets the output stream for this object. This is used for
writing.
+Since: 2.22
</description>
<parameters>
@@ -15044,7 +14802,6 @@ writing.
</parameters>
<return> a #GOutputStream, owned by the #GIOStream. Do not free.
-Since: 2.22
</return>
</function>
@@ -15114,6 +14871,7 @@ or %NULL if the entity tag is not needed
<description>
Tests whether @address is a multicast address.
+Since: 2.22
</description>
<parameters>
@@ -15124,7 +14882,6 @@ Tests whether @address is a multicast address.
</parameters>
<return> %TRUE if @address is a multicast address.
-Since: 2.22
</return>
</function>
@@ -15156,22 +14913,55 @@ Puts a signed 64-bit integer into the stream.
</return>
</function>
-<function name="g_inet_socket_address_get_address">
+<function name="g_output_stream_close">
<description>
-Gets @address's #GInetAddress.
+Closes the stream, releasing resources related to it.
+
+Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
+Closing a stream multiple times will not return an error.
+
+Closing a stream will automatically flush any outstanding buffers in the
+stream.
+
+Streams will be automatically closed when the last reference
+is dropped, but you might want to call this function to make sure
+resources are released as early as possible.
+
+Some streams might keep the backing store of the stream (e.g. a file descriptor)
+open after the stream is closed. See the documentation for the individual
+stream for details.
+
+On failure the first error that happened will be reported, but the close
+operation will finish as much as possible. A stream that failed to
+close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
+is important to check and report the error to the user, otherwise
+there might be a loss of data as all data might not be written.
+
+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.
+Cancelling a close will still leave the stream closed, but there some streams
+can use a faster close that doesn't block to e.g. check errors. On
+cancellation (as with any error) there is no guarantee that all written
+data will reach the target.
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetSocketAddress
+<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> the #GInetAddress for @address, which must be
-g_object_ref()'d if it will be stored
-
-Since: 2.22
+<return> %TRUE on success, %FALSE on failure
</return>
</function>
@@ -15244,6 +15034,7 @@ appropriately if present.
<description>
Return the Windows handle that the stream writes to.
+Since: 2.26
</description>
<parameters>
@@ -15254,7 +15045,6 @@ Return the Windows handle that the stream writes to.
</parameters>
<return> The handle descriptor of @stream
-Since: 2.26
</return>
</function>
@@ -15262,6 +15052,7 @@ Since: 2.26
<description>
Creates a #GSocketAddressEnumerator for @connectable.
+Since: 2.22
</description>
<parameters>
@@ -15272,66 +15063,24 @@ Creates a #GSocketAddressEnumerator for @connectable.
</parameters>
<return> a new #GSocketAddressEnumerator.
-Since: 2.22
</return>
</function>
-<function name="g_emblemed_icon_get_icon">
+<function name="g_unix_input_stream_get_fd">
<description>
-Gets the main icon for @emblemed.
+Return the UNIX file descriptor that the stream reads from.
+Since: 2.20
</description>
<parameters>
-<parameter name="emblemed">
-<parameter_description> a #GEmblemedIcon
+<parameter name="stream">
+<parameter_description> a #GUnixInputStream
</parameter_description>
</parameter>
</parameters>
-<return> a #GIcon that is owned by @emblemed
+<return> The file descriptor of @stream
-Since: 2.18
-</return>
-</function>
-
-<function name="GSrvTarget">
-<description>
-A single target host/port that a network service is running on.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_file_query_writable_namespaces">
-<description>
-Obtain the list of attribute namespaces where new attributes
-can be created by a user. An example of this is extended
-attributes (in the "xattr" namespace).
-
-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="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GFileAttributeInfoList describing the writable namespaces.
-When you are done with it, release it with g_file_attribute_info_list_unref()
</return>
</function>
@@ -15382,16 +15131,41 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="GWin32InputStream">
+<function name="g_app_info_launch_uris">
<description>
-Whether to close the file handle when the stream is closed.
+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.
+
+To lauch the application without arguments pass a %NULL @uris 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
+no way to detect this.
-Since: 2.26
</description>
<parameters>
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="uris">
+<parameter_description> a #GList containing URIs to launch.
+</parameter_description>
+</parameter>
+<parameter name="launch_context">
+<parameter_description> a #GAppLaunchContext or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> %TRUE on successful launch, %FALSE otherwise.
+</return>
</function>
<function name="g_network_address_parse">
@@ -15414,6 +15188,7 @@ In general, @host_and_port is expected to be provided by the user
(allowing them to give the hostname, and a port overide if necessary)
and @default_port is expected to be provided by the application.
+Since: 2.22
</description>
<parameters>
@@ -15432,7 +15207,6 @@ and @default_port is expected to be provided by the application.
</parameters>
<return> the new #GNetworkAddress, or %NULL on error
-Since: 2.22
</return>
</function>
@@ -15480,17 +15254,6 @@ Since: 2.26
<return></return>
</function>
-<function name="GSettings">
-<description>
-If this property is %TRUE, the #GSettings object has outstanding
-changes that will be applied when g_settings_apply() is called.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_open_readwrite">
<description>
Opens an existing file for reading and writing. The result is
@@ -15507,6 +15270,7 @@ Note that in many non-local file cases read and write streams are not supported,
so make sure you really need to do read and write streaming, rather than
just opening for reading or writing.
+Since: 2.22
</description>
<parameters>
@@ -15526,7 +15290,6 @@ just opening for reading or writing.
<return> #GFileIOStream or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -15573,6 +15336,7 @@ 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>
@@ -15595,48 +15359,29 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</parameters>
<return> a #GSocket on success, %NULL on error.
-Since: 2.22
-</return>
-</function>
-
-<function name="g_unix_mount_guess_icon">
-<description>
-Guesses the icon of a Unix mount.
-
-
-</description>
-<parameters>
-<parameter name="mount_entry">
-<parameter_description> a #GUnixMountEntry
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GIcon
</return>
</function>
-<function name="g_socket_address_get_family">
+<function name="g_file_attribute_matcher_unref">
<description>
-Gets the socket family type of @address.
+Unreferences @matcher. If the reference count falls below 1,
+the @matcher is automatically freed.
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GSocketAddress
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
</parameter_description>
</parameter>
</parameters>
-<return> the socket family type of @address.
-
-Since: 2.22
-</return>
+<return></return>
</function>
-<function name="g_file_monitor">
+<function name="g_file_set_attribute_int32">
<description>
-Obtains a file or directory monitor for the given file, depending
-on the type of the file.
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
+If @attribute is of a different type, this operation will fail.
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
@@ -15646,15 +15391,23 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</description>
<parameters>
<parameter name="file">
-<parameter_description> input #GFile
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #gint32 containing the attribute's new value.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> a set of #GFileMonitorFlags
+<parameter_description> a #GFileQueryInfoFlags.
</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">
@@ -15662,88 +15415,47 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileMonitor for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
-
-Since: 2.18
+<return> %TRUE if the @attribute was successfully set to @value
+in the @file, %FALSE otherwise.
</return>
</function>
-<function name="g_app_info_launch_uris">
+<function name="g_unix_mount_at">
<description>
-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.
-
-To lauch the application without arguments pass a %NULL @uris 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
-no way to detect this.
+Gets a #GUnixMountEntry for a given mount path. If @time_read
+is set, it will be filled with a unix timestamp for checking
+if the mounts have changed since with g_unix_mounts_changed_since().
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
-</parameter_description>
-</parameter>
-<parameter name="uris">
-<parameter_description> a #GList containing URIs to launch.
-</parameter_description>
-</parameter>
-<parameter name="launch_context">
-<parameter_description> a #GAppLaunchContext or %NULL
+<parameter name="mount_path">
+<parameter_description> path for a possible unix mount.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="time_read">
+<parameter_description> guint64 to contain a timestamp.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful launch, %FALSE otherwise.
+<return> a #GUnixMount.
</return>
</function>
-<function name="g_simple_async_report_error_in_idle">
+<function name="g_simple_async_result_get_op_res_gssize">
<description>
-Reports an error in an asynchronous function in an idle function by
-directly setting the contents of the #GAsyncResult with the given error
-information.
+Gets a gssize from the asynchronous result.
+
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #GObject.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark containing the error domain (usually #G_IO_ERROR).
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> a specific error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a formatted error reporting string.
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> a list of variables to fill in @format.
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a gssize returned from the asynchronous function.
+</return>
</function>
<function name="g_file_append_to_async">
@@ -15787,33 +15499,102 @@ of the request.
<return></return>
</function>
-<function name="g_vfs_get_default">
+<function name="g_unix_socket_address_new_with_type">
<description>
-Gets the default #GVfs for the system.
+Creates a new #GUnixSocketAddress of type @type with name @path.
+
+If @type is %G_UNIX_SOCKET_ADDRESS_PATH, this is equivalent to
+calling g_unix_socket_address_new().
+
+If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT, then @path_len
+bytes of @path will be copied to the socket's path, and only those
+bytes will be considered part of the name. (If @path_len is -1,
+then @path is assumed to be NUL-terminated.) For example, if @path
+was "test", then calling g_socket_address_get_native_size() on the
+returned socket would return 7 (2 bytes of overhead, 1 byte for the
+abstract-socket indicator byte, and 4 bytes for the name "test").
+
+If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED, then
+ path_len bytes of @path will be copied to the socket's path, the
+rest of the path will be padded with 0 bytes, and the entire
+zero-padded buffer will be considered the name. (As above, if
+ path_len is -1, then @path is assumed to be NUL-terminated.) In
+this case, g_socket_address_get_native_size() will always return
+the full size of a <literal>struct sockaddr_un</literal>, although
+g_unix_socket_address_get_path_len() will still return just the
+length of @path.
+%G_UNIX_SOCKET_ADDRESS_ABSTRACT is preferred over
+%G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED for new programs. Of course,
+when connecting to a server created by another process, you must
+use the appropriate type corresponding to how that process created
+its listening socket.
+
+Since: 2.26
</description>
<parameters>
+<parameter name="path">
+<parameter_description> the name
+</parameter_description>
+</parameter>
+<parameter name="path_len">
+<parameter_description> the length of @path, or -1
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GUnixSocketAddressType
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GVfs.
+<return> a new #GUnixSocketAddress
+
</return>
</function>
-<function name="g_drive_can_start_degraded">
+<function name="g_volume_get_icon">
<description>
-Checks if a drive can be started degraded.
+Gets the icon for @volume.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="volume">
+<parameter_description> a #GVolume.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @drive can be started degraded, %FALSE otherwise.
+<return> a #GIcon.
+The returned object should be unreffed with g_object_unref()
+when no longer needed.
+</return>
+</function>
-Since: 2.22
+<function name="g_file_mount_mountable_finish">
+<description>
+Finishes a mount operation. See g_file_mount_mountable() for details.
+
+Finish an asynchronous mount operation that was started
+with g_file_mount_mountable().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile or %NULL on error.
+Free the returned object with g_object_unref().
</return>
</function>
@@ -15874,11 +15655,36 @@ context</link>).
<return></return>
</function>
+<function name="g_volume_get_identifier">
+<description>
+Gets the identifier of the given kind for @volume.
+See the <link linkend="volume-identifier">introduction</link>
+for more information about volume identifiers.
+
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> a #GVolume
+</parameter_description>
+</parameter>
+<parameter name="kind">
+<parameter_description> the kind of identifier to return
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string containing the
+requested identfier, or %NULL if the #GVolume
+doesn't have this kind of identifier
+</return>
+</function>
+
<function name="g_io_stream_get_input_stream">
<description>
Gets the input stream for this object. This is used
for reading.
+Since: 2.22
</description>
<parameters>
@@ -15889,7 +15695,6 @@ for reading.
</parameters>
<return> a #GInputStream, owned by the #GIOStream. Do not free.
-Since: 2.22
</return>
</function>
@@ -15918,6 +15723,7 @@ Gets the length of @address's path.
For details, see g_unix_socket_address_get_path().
+Since: 2.22
</description>
<parameters>
@@ -15928,7 +15734,6 @@ For details, see g_unix_socket_address_get_path().
</parameters>
<return> the length of the path
-Since: 2.22
</return>
</function>
@@ -16085,7 +15890,13 @@ Deprecated: 2.22: Use g_mount_unmount_with_operation() instead.
<function name="g_file_query_default_handler">
<description>
-Returns: a #GAppInfo if the handle was found, %NULL if there were errors.
+Returns the #GAppInfo that is registered as the default
+application to handle the file specified by @file.
+
+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>
@@ -16107,28 +15918,6 @@ When you are done with it, release it with g_object_unref()
</return>
</function>
-<function name="g_unix_mount_at">
-<description>
-Gets a #GUnixMountEntry for a given mount path. If @time_read
-is set, it will be filled with a unix timestamp for checking
-if the mounts have changed since with g_unix_mounts_changed_since().
-
-
-</description>
-<parameters>
-<parameter name="mount_path">
-<parameter_description> path for a possible unix mount.
-</parameter_description>
-</parameter>
-<parameter name="time_read">
-<parameter_description> guint64 to contain a timestamp.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GUnixMount.
-</return>
-</function>
-
<function name="g_app_info_supports_files">
<description>
Checks if the application accepts files as arguments.
@@ -16145,48 +15934,6 @@ Checks if the application accepts files as arguments.
</return>
</function>
-<function name="g_file_set_attribute_int32">
-<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
-If @attribute is of a different type, this operation will fail.
-
-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="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #gint32 containing the attribute's new value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the @attribute was successfully set to @value
-in the @file, %FALSE otherwise.
-</return>
-</function>
-
<function name="g_unix_mount_point_is_user_mountable">
<description>
Checks if a unix mount point is mountable by the user.
@@ -16219,22 +15966,23 @@ Checks if the application supports reading files and directories from URIs.
</return>
</function>
-<function name="g_zlib_decompressor_new">
+<function name="g_file_info_set_icon">
<description>
-Creates a new #GZlibDecompressor.
-
+Sets the icon for a given #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_ICON.
</description>
<parameters>
-<parameter name="format">
-<parameter_description> The format to use for the compressed data
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="icon">
+<parameter_description> a #GIcon.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GZlibDecompressor
-
-Since: 2.24
-</return>
+<return></return>
</function>
<function name="g_file_attribute_info_list_dup">
@@ -16257,6 +16005,7 @@ Makes a duplicate of a file attribute info list.
<description>
Checks if a drive can be stopped.
+Since: 2.22
</description>
<parameters>
@@ -16267,54 +16016,43 @@ Checks if a drive can be stopped.
</parameters>
<return> %TRUE if the @drive can be stopped, %FALSE otherwise.
-Since: 2.22
</return>
</function>
-<function name="g_file_input_stream_query_info_async">
+<function name="g_app_info_get_commandline">
<description>
-Queries the stream information asynchronously.
-When the operation is finished @callback will be called.
-You can then call g_file_input_stream_query_info_finish()
-to get the result of the operation.
-
-For the synchronous version of this function,
-see g_file_input_stream_query_info().
-
-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 set
+Gets the commandline with which the application will be
+started.
+Since: 2.20
</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="io_priority">
-<parameter_description> the <link linkend="io-priority">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 name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+</parameters>
+<return> a string containing the @appinfo's commandline,
+or %NULL if this information is not available
+
+</return>
+</function>
+
+<function name="g_seekable_can_truncate">
+<description>
+Tests if the stream can be truncated.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the stream can be truncated, %FALSE otherwise.
+</return>
</function>
<function name="g_socket_new_from_fd">
@@ -16327,6 +16065,7 @@ all properties should work. Note that the file descriptor
will be set to non-blocking mode, independent on the blocking
mode of the #GSocket.
+Since: 2.22
</description>
<parameters>
@@ -16342,7 +16081,22 @@ mode of the #GSocket.
<return> a #GSocket or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
+</return>
+</function>
+
+<function name="g_seekable_tell">
+<description>
+Tells the current position within the stream.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the offset from the beginning of the buffer.
</return>
</function>
@@ -16385,6 +16139,7 @@ Since: 2.26
<description>
Gets the number of fallbacks that @converter has applied so far.
+Since: 2.24
</description>
<parameters>
@@ -16395,7 +16150,6 @@ Gets the number of fallbacks that @converter has applied so far.
</parameters>
<return> the number of fallbacks that @converter has applied
-Since: 2.24
</return>
</function>
@@ -16435,6 +16189,7 @@ cancelled.
See #GCancellable::cancelled for details on how to use this.
+Since: 2.22
</description>
<parameters>
@@ -16458,7 +16213,6 @@ See #GCancellable::cancelled for details on how to use this.
<return> The id of the signal handler or 0 if @cancellable has already
been cancelled.
-Since: 2.22
</return>
</function>
@@ -16466,6 +16220,7 @@ Since: 2.22
<description>
Creates a new emblem for @icon.
+Since: 2.18
</description>
<parameters>
@@ -16476,7 +16231,6 @@ Creates a new emblem for @icon.
</parameters>
<return> a new #GEmblem.
-Since: 2.18
</return>
</function>
@@ -16485,6 +16239,7 @@ Since: 2.18
Gets the blocking mode of the socket. For details on blocking I/O,
see g_socket_set_blocking().
+Since: 2.22
</description>
<parameters>
@@ -16495,15 +16250,34 @@ see g_socket_set_blocking().
</parameters>
<return> %TRUE if blocking I/O is used, %FALSE otherwise.
-Since: 2.22
</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_network_address_new">
<description>
Creates a new #GSocketConnectable for connecting to the given
@hostname and @port.
+Since: 2.22
</description>
<parameters>
@@ -16518,7 +16292,6 @@ Creates a new #GSocketConnectable for connecting to the given
</parameters>
<return> the new #GNetworkAddress
-Since: 2.22
</return>
</function>
@@ -16752,112 +16525,72 @@ with a buffer set to @size.
</return>
</function>
-<function name="g_file_query_settable_attributes">
+<function name="g_buffered_input_stream_fill_finish">
<description>
-Obtain the list of settable attributes for the file.
+Finishes an asynchronous read.
-Returns: a #GFileAttributeInfoList describing the settable attributes.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="stream">
+<parameter_description> a #GBufferedInputStream.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeInfoList describing the settable attributes.
-When you are done with it, release it with g_file_attribute_info_list_unref()
+<return> a #gssize of the read stream, or %-1 on an error.
</return>
</function>
-<function name="g_io_error_from_errno">
+<function name="g_socket_receive_from">
<description>
-Converts errno.h error codes into GIO error codes.
-
-
-</description>
-<parameters>
-<parameter name="err_no">
-<parameter_description> Error number as defined in errno.h.
-</parameter_description>
-</parameter>
-</parameters>
-<return> #GIOErrorEnum value for the given errno.h error number.
-</return>
-</function>
+Receive data (up to @size bytes) from a socket.
-<function name="g_file_mount_enclosing_volume">
-<description>
-Starts a @mount_operation, mounting the volume that contains the file @location.
+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.
-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().
+See g_socket_receive() for additional information.
-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="location">
-<parameter_description> input #GFile.
-</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 name="socket">
+<parameter_description> a #GSocket
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="address">
+<parameter_description> a pointer to a #GSocketAddress pointer, or %NULL
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_data_input_stream_read_byte">
-<description>
-Reads an unsigned 8-bit/1-byte value from @stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="size">
+<parameter_description> the number of bytes you want to read from the socket
</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.
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 8-bit/1-byte value read from the @stream or %0
-if an error occurred.
+<return> Number of bytes read, or -1 on error
+
</return>
</function>
@@ -17032,20 +16765,35 @@ Gets the name for a file.
</return>
</function>
-<function name="g_mount_operation_get_anonymous">
+<function name="g_data_input_stream_read_int64">
<description>
-Check to see whether the mount operation is being used
-for an anonymous user.
+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().
+
+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="op">
-<parameter_description> a #GMountOperation.
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</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> %TRUE if mount operation is anonymous.
+<return> a signed 64-bit/8-byte value read from @stream or %0 if
+an error occurred.
</return>
</function>
@@ -17069,33 +16817,68 @@ g_object_unref() when no longer needed.
</return>
</function>
-<function name="g_socket_is_connected">
+<function name="g_simple_async_result_get_op_res_gpointer">
<description>
-Check whether the socket is connected. This is only useful for
-connection-oriented sockets.
+Gets a pointer result as returned by the asynchronous function.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if socket is connected, %FALSE otherwise.
+<return> a pointer from the result.
+</return>
+</function>
-Since: 2.22
+<function name="g_data_output_stream_put_byte">
+<description>
+Puts a byte into the output stream.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #guchar.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="GWin32OutputStream">
+<function name="g_unix_mount_monitor_set_rate_limit">
<description>
-Whether to close the file handle when the stream is closed.
+Sets the rate limit to which the @mount_monitor will report
+consecutive change events to the mount and mount point entry files.
-Since: 2.26
+Since: 2.18
</description>
<parameters>
+<parameter name="mount_monitor">
+<parameter_description> a #GUnixMountMonitor
+</parameter_description>
+</parameter>
+<parameter name="limit_msec">
+<parameter_description> a integer with the limit in milliseconds to
+poll for changes.
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
@@ -17105,6 +16888,7 @@ Since: 2.26
Try to get the remove address of a connected socket. This is only
useful for connection oriented sockets that have been connected.
+Since: 2.22
</description>
<parameters>
@@ -17120,7 +16904,6 @@ useful for connection oriented sockets that have been connected.
<return> a #GSocketAddress or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -17218,21 +17001,21 @@ Since: 2.26
<return></return>
</function>
-<function name="g_unix_input_stream_get_fd">
+<function name="g_emblemed_icon_get_icon">
<description>
-Return the UNIX file descriptor that the stream reads from.
+Gets the main icon for @emblemed.
+Since: 2.18
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GUnixInputStream
+<parameter name="emblemed">
+<parameter_description> a #GEmblemedIcon
</parameter_description>
</parameter>
</parameters>
-<return> The file descriptor of @stream
+<return> a #GIcon that is owned by @emblemed
-Since: 2.20
</return>
</function>
@@ -17242,6 +17025,7 @@ Gets the socket family of the socket client.
See g_socket_client_set_family() for details.
+Since: 2.22
</description>
<parameters>
@@ -17252,7 +17036,6 @@ See g_socket_client_set_family() for details.
</parameters>
<return> a #GSocketFamily
-Since: 2.22
</return>
</function>
@@ -17277,20 +17060,33 @@ when no longer needed.
</return>
</function>
-<function name="g_file_attribute_matcher_unref">
+<function name="g_simple_async_result_new">
<description>
-Unreferences @matcher. If the reference count falls below 1,
-the @matcher is automatically freed.
+Creates a #GSimpleAsyncResult.
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="source_object">
+<parameter_description> a #GObject the asynchronous function was called with,
+or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="source_tag">
+<parameter_description> the asynchronous function.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GSimpleAsyncResult.
+</return>
</function>
<function name="g_content_type_get_mime_type">
@@ -17313,24 +17109,47 @@ Gets the mime-type for the content type. If one is registered
<description>
Gets the #GResolver Error Quark.
+Since: 2.22
</description>
<parameters>
</parameters>
<return> a #GQuark.
-Since: 2.22
</return>
</function>
-<function name="g_input_stream_clear_pending">
+<function name="g_file_find_enclosing_mount_async">
<description>
-Clears the pending flag on @stream.
+Asynchronously gets the mount for the file.
+
+For more details, see g_file_find_enclosing_mount() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_find_enclosing_mount_finish() to get the result of the operation.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> input stream
+<parameter name="file">
+<parameter_description> a #GFile
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">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> 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>
@@ -17442,6 +17261,36 @@ Since: 2.26
<return></return>
</function>
+<function name="g_themed_icon_new_with_default_fallbacks">
+<description>
+Creates a new themed icon for @iconname, and all the names
+that can be created by shortening @iconname at '-' characters.
+
+In the following example, @icon1 and @icon2 are equivalent:
+|[
+const char *names[] = {
+"gnome-dev-cdrom-audio",
+"gnome-dev-cdrom",
+"gnome-dev",
+"gnome"
+};
+
+icon1 = g_themed_icon_new_from_names (names, 4);
+icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
+]|
+
+
+</description>
+<parameters>
+<parameter name="iconname">
+<parameter_description> a string containing an icon name
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GThemedIcon.
+</return>
+</function>
+
<function name="g_mount_get_name">
<description>
Gets the name of @mount.
@@ -17524,6 +17373,7 @@ list available applications.
Finishes ejecting a mount. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
+Since: 2.22
</description>
<parameters>
@@ -17543,7 +17393,6 @@ ignore.
</parameters>
<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
-Since: 2.22
</return>
</function>
@@ -17578,6 +17427,34 @@ Since: 2.26
</return>
</function>
+<function name="g_settings_new_with_path">
+<description>
+Creates a new #GSettings object with a given schema and path.
+
+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="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> a new #GSettings object
+</return>
+</function>
+
<function name="g_file_attribute_matcher_matches">
<description>
Checks if an attribute will be matched by an attribute matcher. If
@@ -17637,6 +17514,7 @@ very common due to the way the underlying APIs work.)
On error -1 is returned and @error is set accordingly.
+Since: 2.22
</description>
<parameters>
@@ -17664,57 +17542,36 @@ On error -1 is returned and @error is set accordingly.
<return> Number of bytes written (which may be less than @size), or -1
on error
-Since: 2.22
</return>
</function>
-<function name="g_resolver_lookup_service_finish">
+<function name="g_file_get_basename">
<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 base name (the last component of the path) for a given #GFile.
-</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.
+If called for the top level of a system (such as the filesystem root
+or a uri like sftp://host/) it will return a single directory separator
+(and on Windows, possibly a drive letter).
-Since: 2.22
-</return>
-</function>
+The base name is a byte string (*not* UTF-8). It has no defined encoding
+or rules other than it may not contain zero bytes. If you want to use
+filenames in a user interface you should use the display name that you
+can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
+attribute with g_file_query_info().
-<function name="g_volume_get_drive">
-<description>
-Gets the drive for the @volume.
+This call does no blocking i/o.
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume.
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
</parameters>
-<return> a #GDrive or %NULL if @volume is not associated with a drive.
-The returned object should be unreffed with g_object_unref()
-when no longer needed.
+<return> string containing the #GFile's base name, or %NULL
+if given #GFile is invalid. The returned string should be
+freed with g_free() when no longer needed.
</return>
</function>
@@ -17773,6 +17630,7 @@ if possible.
Finishes an asynchronous file read operation started with
g_file_open_readwrite_async().
+Since: 2.22
</description>
<parameters>
@@ -17792,7 +17650,6 @@ g_file_open_readwrite_async().
<return> a #GFileIOStream or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -17813,25 +17670,6 @@ Checks if the buffer automatically grows as data is added.
</return>
</function>
-<function name="g_memory_output_stream_get_data">
-<description>
-Gets any loaded data from the @ostream.
-
-Note that the returned pointer may become invalid on the next
-write or truncate operation on the stream.
-
-
-</description>
-<parameters>
-<parameter name="ostream">
-<parameter_description> a #GMemoryOutputStream
-</parameter_description>
-</parameter>
-</parameters>
-<return> pointer to the stream's data
-</return>
-</function>
-
<function name="g_cancellable_cancel">
<description>
Will set @cancellable to cancelled, and will emit the
@@ -17875,6 +17713,7 @@ The protocol id is passed directly to the operating
system, so you can use protocols not listed in #GSocketProtocol if you
know the protocol number used for it.
+Since: 2.22
</description>
<parameters>
@@ -17898,37 +17737,38 @@ know the protocol number used for it.
<return> a #GSocket or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
-<function name="g_file_get_basename">
+<function name="g_resolver_lookup_service_finish">
<description>
-Gets the base name (the last component of the path) for a given #GFile.
-
-If called for the top level of a system (such as the filesystem root
-or a uri like sftp://host/) it will return a single directory separator
-(and on Windows, possibly a drive letter).
-
-The base name is a byte string (*not* UTF-8). It has no defined encoding
-or rules other than it may not contain zero bytes. If you want to use
-filenames in a user interface you should use the display name that you
-can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
-attribute with g_file_query_info().
+Retrieves the result of a previous call to
+g_resolver_lookup_service_async().
-This call does no blocking i/o.
+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="file">
-<parameter_description> input #GFile.
+<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> string containing the #GFile's base name, or %NULL
-if given #GFile is invalid. The returned string should be
-freed with g_free() when no longer needed.
+<return> a #GList of #GSrvTarget, or %NULL on error. See
+g_resolver_lookup_service() for more details.
+
</return>
</function>
@@ -17953,20 +17793,72 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_file_attribute_matcher_enumerate_next">
+<function name="g_unix_fd_message_append_fd">
<description>
-Gets the next matched attribute from a #GFileAttributeMatcher.
+Adds a file descriptor to @message.
+
+The file descriptor is duplicated using dup(). You keep your copy
+of the descriptor and the copy contained in @message will be closed
+when @message is finalized.
+
+A possible cause of failure is exceeding the per-process or
+system-wide file descriptor limit.
+Since: 2.22
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="message">
+<parameter_description> a #GUnixFDMessage
+</parameter_description>
+</parameter>
+<parameter name="fd">
+<parameter_description> a valid open file descriptor
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the next attribute or %NULL if
-no more attribute exist.
+<return> %TRUE in case of success, else %FALSE (and @error is set)
+
+</return>
+</function>
+
+<function name="g_volume_get_drive">
+<description>
+Gets the drive for the @volume.
+
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> a #GVolume.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GDrive or %NULL if @volume is not associated with a drive.
+The returned object should be unreffed with g_object_unref()
+when no longer needed.
+</return>
+</function>
+
+<function name="g_converter_input_stream_get_converter">
+<description>
+Gets the #GConverter that is used by @converter_stream.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="converter_stream">
+<parameter_description> a #GConverterInputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the converter of the converter input stream
+
</return>
</function>
@@ -17976,6 +17868,7 @@ 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.
+Since: 2.22
</description>
<parameters>
@@ -17986,7 +17879,6 @@ and closed, as the etag can change while writing.
</parameters>
<return> the entity tag for the stream.
-Since: 2.22
</return>
</function>
@@ -18039,6 +17931,7 @@ simply the name (such as <literal>network-server</literal>).
</para></listitem>
</itemizedlist>
+Since: 2.20
</description>
<parameters>
@@ -18050,7 +17943,6 @@ simply the name (such as <literal>network-server</literal>).
<return> An allocated NUL-terminated UTF8 string or %NULL if @icon can't
be serialized. Use g_free() to free.
-Since: 2.20
</return>
</function>
@@ -18128,6 +18020,11 @@ 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>
@@ -18139,11 +18036,6 @@ is to return #GVolume objects representing entries in the users
<return> the #GVolume object that is the parent for @mount or %NULL
if no wants to adopt the #GMount.
-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.
</return>
</function>
@@ -18176,22 +18068,22 @@ sure resources are released as early as possible.
</return>
</function>
-<function name="g_io_extension_get_name">
+<function name="g_socket_control_message_get_msg_type">
<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.
+Returns the protocol specific type of the control message.
+For instance, for UNIX fd passing this would be SCM_RIGHTS.
+Since: 2.22
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="message">
+<parameter_description> a #GSocketControlMessage
</parameter_description>
</parameter>
</parameters>
-<return> the name of @extension.
+<return> an integer describing the type of control message
+
</return>
</function>
@@ -18257,117 +18149,133 @@ Checks if two icons are equal.
</return>
</function>
-<function name="g_volume_should_automount">
+<function name="g_input_stream_skip_async">
<description>
-Returns: %TRUE if the volume should be automatically mounted.
+Request an asynchronous skip of @count bytes from the stream.
+When the operation is finished @callback will be called.
+You can then call g_input_stream_skip_finish() to get the result of the
+operation.
+
+During an async request no other sync and async calls are allowed, and will
+result in %G_IO_ERROR_PENDING errors.
+
+A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes skipped will be passed to the
+callback. It is not an error if this is not the same as the requested size, as it
+can happen e.g. near the end of a file, but generally we try to skip
+as many bytes as requested. Zero is returned on end of file
+(or if @count is zero), but never otherwise.
+
+Any outstanding i/o request with higher priority (lower numerical value) will
+be executed before an outstanding request with lower priority. Default
+priority is %G_PRIORITY_DEFAULT.
+
+The asyncronous methods have a default fallback that uses threads to implement
+asynchronicity, so they are optional for inheriting classes. However, if you
+override one you must override all.
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume
+<parameter name="stream">
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be skipped 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>
+</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> %TRUE if the volume should be automatically mounted.
-</return>
+<return></return>
</function>
-<function name="g_seekable_tell">
+<function name="g_memory_output_stream_get_data">
<description>
-Tells the current position within the stream.
+Gets any loaded data from the @ostream.
+
+Note that the returned pointer may become invalid on the next
+write or truncate operation on the stream.
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
</parameter_description>
</parameter>
</parameters>
-<return> the offset from the beginning of the buffer.
+<return> pointer to the stream's data
</return>
</function>
-<function name="g_file_set_attributes_from_info">
+<function name="g_socket_listener_new">
<description>
-Tries to set all attributes in the #GFileInfo on the target values,
-not stopping on the first error.
-
-If there is any error during this operation then @error will be set to
-the first error. Error on particular fields are flagged by setting
-the "status" field in the attribute value to
-%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect
-further errors.
-
-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.
+Creates a new #GSocketListener with no sockets to listen for.
+New listeners can be added with e.g. g_socket_listener_add_address()
+or g_socket_listener_add_inet_port().
+Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> #GFileQueryInfoFlags
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if there was any error, %FALSE otherwise.
+<return> a new #GSocketListener.
+
</return>
</function>
-<function name="g_simple_async_result_new_error">
+<function name="g_initable_new_valist">
<description>
-Creates a new #GSimpleAsyncResult with a set error.
+Helper function for constructing #GInitiable object. This is
+similar to g_object_new_valist() but also initializes the object
+and returns %NULL, setting an error on failure.
+Since: 2.22
</description>
<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GInitable.
</parameter_description>
</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark.
+<parameter name="first_property_name">
+<parameter_description> the name of the first property, followed by
+the value, and other property value pairs, and ended by %NULL.
</parameter_description>
</parameter>
-<parameter name="code">
-<parameter_description> an error code.
+<parameter name="var_args">
+<parameter_description> The var args list generated from @first_property_name.
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> a string with format characters.
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> a list of values to insert into @format.
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSimpleAsyncResult.
+<return> a newly allocated #GObject, or %NULL on error
+
</return>
</function>
@@ -18382,6 +18290,7 @@ 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.
+Since: 2.22
</description>
<parameters>
@@ -18404,7 +18313,6 @@ different things depending on what address is connected to.
</parameters>
<return> %TRUE on success, %FALSE on error.
-Since: 2.22
</return>
</function>
@@ -18428,6 +18336,7 @@ Gets the mount path for a unix mount.
<description>
Finishes an async accept operation. See g_socket_listener_accept_socket_async()
+Since: 2.22
</description>
<parameters>
@@ -18451,7 +18360,6 @@ ignore.
</parameters>
<return> a #GSocket on success, %NULL on error.
-Since: 2.22
</return>
</function>
@@ -18476,6 +18384,7 @@ or %NULL on error.
<description>
Return the Windows file handle that the stream reads from.
+Since: 2.26
</description>
<parameters>
@@ -18486,30 +18395,40 @@ Return the Windows file handle that the stream reads from.
</parameters>
<return> The file handle of @stream
-Since: 2.26
</return>
</function>
-<function name="g_settings_backend_changed_tree">
+<function name="g_file_read_async">
<description>
-This call is a convenience wrapper. It gets the list of changes from
- tree, computes the longest common prefix and calls
-g_settings_backend_changed().
+Asynchronously opens @file for reading.
-Since: 2.26
+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.
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="file">
+<parameter_description> input #GFile
</parameter_description>
</parameter>
-<parameter name="tree">
-<parameter_description> a #GTree containing the changes
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<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>
@@ -18602,27 +18521,22 @@ if possible.
<return></return>
</function>
-<function name="g_inet_address_new_from_bytes">
+<function name="g_socket_get_timeout">
<description>
-Creates a new #GInetAddress from the given @family and @bytes.
- bytes should be 4 bytes for %G_INET_ADDRESS_IPV4 and 16 bytes for
-%G_INET_ADDRESS_IPV6.
+Gets the timeout setting of the socket. For details on this, see
+g_socket_set_timeout().
+Since: 2.26
</description>
<parameters>
-<parameter name="bytes">
-<parameter_description> raw address data
-</parameter_description>
-</parameter>
-<parameter name="family">
-<parameter_description> the address family of @bytes
+<parameter name="socket">
+<parameter_description> a #GSocket.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetAddress corresponding to @family and @bytes.
+<return> the timeout in seconds
-Since: 2.22
</return>
</function>
@@ -18645,15 +18559,32 @@ g_unix_mounts_points_changed_since().
</return>
</function>
-<function name="g_file_attribute_info_list_unref">
+<function name="g_socket_listener_accept_socket_async">
<description>
-Removes a reference from the given @list. If the reference count
-falls to zero, the @list is deleted.
+This is the asynchronous version of g_socket_listener_accept_socket().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_listener_accept_socket_finish()
+to get the result of the operation.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="list">
-<parameter_description> The #GFileAttributeInfoList to unreference.
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
</parameter_description>
</parameter>
</parameters>
@@ -18671,6 +18602,7 @@ specification for more on x-content types.
This is an synchronous operation and as such may block doing IO;
see g_mount_guess_content_type() for the asynchronous version.
+Since: 2.18
</description>
<parameters>
@@ -18696,7 +18628,6 @@ ignore
<return> a %NULL-terminated array of content types or %NULL on error.
Caller should free this array with g_strfreev() when done with it.
-Since: 2.18
</return>
</function>
@@ -18705,6 +18636,7 @@ Since: 2.18
Finishes asynchronous initialization and returns the result.
See g_async_initable_init_async().
+Since: 2.22
</description>
<parameters>
@@ -18725,57 +18657,62 @@ ignore.
<return> %TRUE if successful. If an error has occurred, this function
will return %FALSE and set @error appropriately if present.
-Since: 2.22
</return>
</function>
-<function name="g_input_stream_skip_async">
+<function name="g_async_initable_init_async">
<description>
-Request an asynchronous skip of @count bytes from the stream.
-When the operation is finished @callback will be called.
-You can then call g_input_stream_skip_finish() to get the result of the
-operation.
+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.
-During an async request no other sync and async calls are allowed, and will
-result in %G_IO_ERROR_PENDING errors.
+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.
-A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+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.
-On success, the number of bytes skipped will be passed to the
-callback. It is not an error if this is not the same as the requested size, as it
-can happen e.g. near the end of a file, but generally we try to skip
-as many bytes as requested. Zero is returned on end of file
-(or if @count is zero), but never otherwise.
+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.
-Any outstanding i/o request with higher priority (lower numerical value) will
-be executed before an outstanding request with lower priority. Default
-priority is %G_PRIORITY_DEFAULT.
+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.
-The asyncronous methods have a default fallback that uses threads to implement
-asynchronicity, so they are optional for inheriting classes. However, if you
-override one you must override all.
+For 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="stream">
-<parameter_description> A #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be skipped from the stream
+<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 request.
+<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> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -18794,6 +18731,7 @@ during the operation, @error will be set to contain the errors and
%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
guessing.
+Since: 2.18
</description>
<parameters>
@@ -18814,7 +18752,6 @@ ignore
<return> a %NULL-terminated array of content types or %NULL on error.
Caller should free this array with g_strfreev() when done with it.
-Since: 2.18
</return>
</function>
@@ -18920,6 +18857,7 @@ errors that can happen due to races when you execute the operation.
<description>
Tests whether @address is the "any" address for its family.
+Since: 2.22
</description>
<parameters>
@@ -18930,7 +18868,6 @@ Tests whether @address is the "any" address for its family.
</parameters>
<return> %TRUE if @address is the "any" address for its family.
-Since: 2.22
</return>
</function>
@@ -18943,6 +18880,7 @@ may contain embedded zeros, and thus you should use
g_unix_socket_address_get_path_len() to get the true length
of this string.
+Since: 2.22
</description>
<parameters>
@@ -18953,7 +18891,6 @@ of this string.
</parameters>
<return> the path for @address
-Since: 2.22
</return>
</function>
@@ -18978,23 +18915,6 @@ Since: 2.20
<return></return>
</function>
-<function name="g_io_extension_ref_class">
-<description>
-Gets a reference to the class for the type that is
-associated with @extension.
-
-
-</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_app_info_get_default_for_type">
<description>
Gets the #GAppInfo that corresponds to a given content type.
@@ -19131,23 +19051,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
-<function name="g_settings_apply">
-<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.
-
-</description>
-<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings instance
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_read_finish">
<description>
Finishes an asynchronous file read operation started with
@@ -19174,26 +19077,19 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_unix_input_stream_new">
+<function name="g_file_info_get_symlink_target">
<description>
-Creates a new #GUnixInputStream for the given @fd.
-
-If @close_fd is %TRUE, the file descriptor will be closed
-when the stream is closed.
+Gets the symlink target for a given #GFileInfo.
</description>
<parameters>
-<parameter name="fd">
-<parameter_description> a UNIX file descriptor
-</parameter_description>
-</parameter>
-<parameter name="close_fd">
-<parameter_description> %TRUE to close the file descriptor when done
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GUnixInputStream
+<return> a string containing the symlink target.
</return>
</function>
@@ -19246,14 +19142,21 @@ is needed to run the job and report its completion.
<return></return>
</function>
-<function name="g_file_load_partial_contents_finish">
+<function name="g_file_load_contents_async">
<description>
-Finishes an asynchronous partial load operation that was started
-with g_file_load_partial_contents_async(). The data is always
-zero-terminated, but this is not included in the resultant @length.
-The returned @content should be freed with g_free() when no longer
-needed.
+Starts an asynchronous load of the @file's contents.
+For more details, see g_file_load_contents() which is
+the synchronous version of this call.
+
+When the load operation has completed, @callback will be called
+with @user data. To finish the operation, call
+g_file_load_contents_finish() with the #GAsyncResult returned by
+the @callback.
+
+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>
@@ -19261,86 +19164,43 @@ needed.
<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> a location to place the contents of the file.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> a location to place the length of the contents of the file,
-or %NULL if the length is not needed
-</parameter_description>
-</parameter>
-<parameter name="etag_out">
-<parameter_description> a location to place the current entity tag for the file,
-or %NULL if the entity tag is not needed
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if the load was successful. If %FALSE and @error is
-present, it will be set appropriately.
-</return>
-</function>
-
-<function name="g_inet_address_to_bytes">
-<description>
-Gets the raw binary address data from @address.
-
-
-</description>
-<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
</parameter_description>
</parameter>
-</parameters>
-<return> a pointer to an internal array of the bytes in @address,
-which should not be modified, stored, or freed. The size of this
-array can be gotten with g_inet_address_get_native_size().
-
-Since: 2.22
-</return>
-</function>
-
-<function name="g_socket_get_socket_type">
-<description>
-Gets the socket type of the socket.
-
-
-</description>
-<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketType
-
-Since: 2.22
-</return>
+<return></return>
</function>
-<function name="g_output_stream_write_all">
+<function name="g_output_stream_write">
<description>
Tries to write @count bytes from @buffer into the stream. Will block
during the operation.
-This function is similar to g_output_stream_write(), except it tries to
-write as many bytes as requested, only stopping on an error.
+If count is zero returns zero and does nothing. A value of @count
+larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
-On a successful write of @count bytes, %TRUE is returned, and @bytes_written
-is set to @count.
+On success, the number of bytes written to the stream is returned.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. on a partial i/o error, or if there is not enough
+storage in the stream. All writes either block until at least one byte
+is written, so zero is never returned (unless @count is zero).
-If there is an error during the operation FALSE is returned and @error
-is set to indicate the error status, @bytes_written is updated to contain
-the number of bytes written into the stream before the error occurred.
+If @cancellable is not NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+On error -1 is returned and @error is set accordingly.
</description>
@@ -19357,13 +19217,8 @@ the number of bytes written into the stream before the error occurred.
<parameter_description> the number of bytes to write
</parameter_description>
</parameter>
-<parameter name="bytes_written">
-<parameter_description> location to store the number of bytes that was
-written to the stream
-</parameter_description>
-</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional cancellable object
</parameter_description>
</parameter>
<parameter name="error">
@@ -19371,27 +19226,25 @@ written to the stream
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE if there was an error
+<return> Number of bytes written, or -1 on error
</return>
</function>
-<function name="g_file_get_path">
+<function name="g_vfs_get_supported_uri_schemes">
<description>
-Gets the local pathname for #GFile, if one exists.
-
-This call does no blocking i/o.
+Gets a list of URI schemes supported by @vfs.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="vfs">
+<parameter_description> a #GVfs.
</parameter_description>
</parameter>
</parameters>
-<return> string containing the #GFile's path, or %NULL if
-no such path exists. The returned string should be
-freed with g_free() when no longer needed.
+<return> a %NULL-terminated array of strings.
+The returned array belongs to GIO and must
+not be freed or modified.
</return>
</function>
@@ -19429,45 +19282,72 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_converter_input_stream_get_converter">
+<function name="g_file_output_stream_get_etag">
<description>
-Gets the #GConverter that is used by @converter_stream.
+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="converter_stream">
-<parameter_description> a #GConverterInputStream
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return> the converter of the converter input stream
-
-Since: 2.24
+<return> the entity tag for the stream.
</return>
</function>
-<function name="g_file_output_stream_get_etag">
+<function name="g_input_stream_close">
<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.
+Closes the stream, releasing resources related to it.
+
+Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
+Closing a stream multiple times will not return an error.
+
+Streams will be automatically closed when the last reference
+is dropped, but you might want to call this function to make sure
+resources are released as early as possible.
+
+Some streams might keep the backing store of the stream (e.g. a file descriptor)
+open after the stream is closed. See the documentation for the individual
+stream for details.
+
+On failure the first error that happened will be reported, but the close
+operation will finish as much as possible. A stream that failed to
+close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
+is important to check and report the error to the user.
+
+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.
+Cancelling a close will still leave the stream closed, but some streams
+can use a faster close that doesn't block to e.g. check errors.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occuring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> the entity tag for the stream.
+<return> %TRUE on success, %FALSE on failure
</return>
</function>
<function name="g_file_move">
<description>
-
Tries to move the file or directory @source to the location specified by @destination.
If native move operations are supported then this is used, otherwise a copy + delete
fallback is used. The native implementation may support moving directories (for instance
@@ -19544,6 +19424,7 @@ may be returned (if the native move operation isn't available).
<description>
Try to get the local address of a socket connection.
+Since: 2.22
</description>
<parameters>
@@ -19559,7 +19440,6 @@ Try to get the local address of a socket connection.
<return> a #GSocketAddress or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -19567,6 +19447,7 @@ Since: 2.22
<description>
Tests whether @address is a link-local multicast address.
+Since: 2.22
</description>
<parameters>
@@ -19577,7 +19458,6 @@ Tests whether @address is a link-local multicast address.
</parameters>
<return> %TRUE if @address is a link-local multicast address.
-Since: 2.22
</return>
</function>
@@ -19613,79 +19493,54 @@ Gets the edit name for a file.
</return>
</function>
-<function name="g_file_set_attribute">
+<function name="g_mount_operation_set_username">
<description>
-Sets an attribute in the file with attribute name @attribute to @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.
-
+Sets the user name within @op to @username.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> The type of the attribute
-</parameter_description>
-</parameter>
-<parameter name="value_p">
-<parameter_description> a pointer to the value (or the pointer itself if the type is a pointer type)
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="username">
+<parameter_description> input username.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the attribute was set, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_data_input_stream_read_uint64">
+<function name="g_srv_target_new">
<description>
-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().
+Creates a new #GSrvTarget with the given parameters.
-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.
+You should not need to use this; normally #GSrvTarget<!-- -->s are
+created by #GResolver.
+Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="hostname">
+<parameter_description> the host that the service is running on
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="port">
+<parameter_description> the port that the service is running on
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter name="priority">
+<parameter_description> the target's priority
+</parameter_description>
+</parameter>
+<parameter name="weight">
+<parameter_description> the target's weight
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 64-bit/8-byte read from @stream or %0 if
-an error occurred.
+<return> a new #GSrvTarget.
+
</return>
</function>
@@ -19853,12 +19708,13 @@ discarded. This is to facilitate the common practice of sending a
single '\0' byte for the purposes of transferring ancillary data.
@messages, if non-%NULL, will be set to point to a newly-allocated
-array of #GSocketControlMessage instances. These correspond to the
-control messages received from the kernel, one
-#GSocketControlMessage per message from the kernel. This array is
-%NULL-terminated and must be freed by the caller using g_free(). If
- messages is %NULL, any control messages received will be
-discarded.
+array of #GSocketControlMessage instances or %NULL if no such
+messages was received. These correspond to the control messages
+received from the kernel, one #GSocketControlMessage per message
+from the kernel. This array is %NULL-terminated and must be freed
+by the caller using g_free() after calling g_object_unref() on each
+element. If @messages is %NULL, any control messages received will
+be discarded.
@num_messages, if non-%NULL, will be set to the number of control
messages received.
@@ -19889,6 +19745,7 @@ data is available, wait for the %G_IO_IN condition.
On error -1 is returned and @error is set accordingly.
+Since: 2.22
</description>
<parameters>
@@ -19909,7 +19766,7 @@ On error -1 is returned and @error is set accordingly.
</parameter_description>
</parameter>
<parameter name="messages">
-<parameter_description> a pointer which will be filled with an array of
+<parameter_description> a pointer which may be filled with an array of
#GSocketControlMessages, or %NULL
</parameter_description>
</parameter>
@@ -19933,7 +19790,6 @@ elements in @messages, or %NULL
</parameters>
<return> Number of bytes read, or -1 on error
-Since: 2.22
</return>
</function>
@@ -19941,6 +19797,7 @@ Since: 2.22
<description>
Copies @target
+Since: 2.22
</description>
<parameters>
@@ -19951,7 +19808,6 @@ Copies @target
</parameters>
<return> a copy of @target
-Since: 2.22
</return>
</function>
@@ -19959,6 +19815,7 @@ Since: 2.22
<description>
Tests whether @address is a site-local multicast address.
+Since: 2.22
</description>
<parameters>
@@ -19969,7 +19826,6 @@ Tests whether @address is a site-local multicast address.
</parameters>
<return> %TRUE if @address is a site-local multicast address.
-Since: 2.22
</return>
</function>
@@ -19999,6 +19855,7 @@ a given destination.
Finishes an asynchronous file replace operation started with
g_file_replace_readwrite_async().
+Since: 2.22
</description>
<parameters>
@@ -20018,23 +19875,9 @@ g_file_replace_readwrite_async().
<return> a #GFileIOStream, or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
-<function name="GInetAddress">
-<description>
-Whether this is a site-local multicast address.
-See g_inet_address_get_is_mc_site_local().
-
-Since: 2.22
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_app_launch_context_get_display">
<description>
Gets the display string for the display. This is used to ensure new
@@ -20106,7 +19949,10 @@ Since: 2.24
<function name="g_win32_output_stream_get_close_handle">
<description>
-Return value: %TRUE if the handle is closed when done
+Returns whether the handle of @stream will be closed when the
+stream is closed.
+
+Since: 2.26
</description>
<parameters>
@@ -20117,7 +19963,6 @@ Return value: %TRUE if the handle is closed when done
</parameters>
<return> %TRUE if the handle is closed when done
-Since: 2.26
</return>
</function>
@@ -20146,6 +19991,7 @@ Since: 2.22
Finishes an asynchronous eject operation started by
g_file_eject_mountable_with_operation().
+Since: 2.22
</description>
<parameters>
@@ -20165,7 +20011,6 @@ g_file_eject_mountable_with_operation().
<return> %TRUE if the @file was ejected successfully. %FALSE
otherwise.
-Since: 2.22
</return>
</function>
@@ -20237,6 +20082,7 @@ very common due to the way the underlying APIs work.)
On error -1 is returned and @error is set accordingly.
+Since: 2.22
</description>
<parameters>
@@ -20281,7 +20127,6 @@ On error -1 is returned and @error is set accordingly.
<return> Number of bytes written (which may be less than @size), or -1
on error
-Since: 2.22
</return>
</function>
@@ -20346,68 +20191,6 @@ Checks if the VFS is active.
</return>
</function>
-<function name="g_simple_async_result_set_error_va">
-<description>
-Sets an error within the asynchronous result without a #GError.
-Unless writing a binding, see g_simple_async_result_set_error().
-
-</description>
-<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark (usually #G_IO_ERROR).
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> an error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a formatted error reporting string.
-</parameter_description>
-</parameter>
-<parameter name="args">
-<parameter_description> va_list of arguments.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_settings_set_int">
-<description>
-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.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> the value to set it to
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
-</return>
-</function>
-
<function name="g_srv_target_free">
<description>
Frees @target
@@ -20488,43 +20271,6 @@ finished
<return></return>
</function>
-<function name="g_socket_client_connect_to_service_async">
-<description>
-This is the asynchronous version of
-g_socket_client_connect_to_service().
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a domain name
-</parameter_description>
-</parameter>
-<parameter name="service">
-<parameter_description> the name of the service to connect to
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_simple_async_result_new_from_error">
<description>
Creates a #GSimpleAsyncResult from an error condition.
@@ -20553,28 +20299,20 @@ Creates a #GSimpleAsyncResult from an error condition.
</return>
</function>
-<function name="GThemedIcon">
+<function name="g_unix_mount_is_readonly">
<description>
-Whether to use the default fallbacks found by shortening the icon name
-at '-' characters. If the "names" array has more than one element,
-ignores any past the first.
+Checks if a unix mount is mounted read only.
-For example, if the icon name was "gnome-dev-cdrom-audio", the array
-would become
-|[
-{
-"gnome-dev-cdrom-audio",
-"gnome-dev-cdrom",
-"gnome-dev",
-"gnome",
-NULL
-};
-]|
</description>
<parameters>
+<parameter name="mount_entry">
+<parameter_description> a #GUnixMount.
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @mount_entry is read only.
+</return>
</function>
<function name="g_content_type_guess_for_tree">
@@ -20590,6 +20328,7 @@ 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>
@@ -20601,7 +20340,6 @@ This function is useful in the implementation of g_mount_guess_content_type().
<return> an %NULL-terminated array of zero or more content types, or %NULL.
Free with g_strfreev()
-Since: 2.18
</return>
</function>
@@ -20612,6 +20350,7 @@ Finishes a start operation. See g_file_start_mountable() for details.
Finish an asynchronous start operation that was started
with g_file_start_mountable().
+Since: 2.22
</description>
<parameters>
@@ -20631,26 +20370,22 @@ with g_file_start_mountable().
<return> %TRUE if the operation finished successfully. %FALSE
otherwise.
-Since: 2.22
</return>
</function>
-<function name="g_unix_fd_list_get_length">
+<function name="g_mount_operation_get_domain">
<description>
-Gets the length of @list (ie: the number of file descriptors
-contained within).
+Gets the domain of the mount operation.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GUnixFDList
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
</parameters>
-<return> the length of @list
-
-Since: 2.24
+<return> a string set to the domain.
</return>
</function>
@@ -20715,47 +20450,37 @@ of the request.
<return></return>
</function>
-<function name="g_drive_eject_with_operation_finish">
+<function name="g_file_info_get_sort_order">
<description>
-Finishes ejecting a drive. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Gets the value of the sort_order attribute from the #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</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="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drive was successfully ejected. %FALSE otherwise.
-
-Since: 2.22
+<return> a #gint32 containing the value of the "standard::sort_order" attribute.
</return>
</function>
-<function name="g_themed_icon_new">
+<function name="g_app_info_get_executable">
<description>
-Creates a new themed icon for @iconname.
+Gets the executable's name for the installed application.
</description>
<parameters>
-<parameter name="iconname">
-<parameter_description> a string containing an icon name.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
</parameters>
-<return> a new #GThemedIcon.
+<return> a string containing the @appinfo's application
+binaries name
</return>
</function>
@@ -20802,22 +20527,28 @@ present, it will be set appropriately.
</return>
</function>
-<function name="g_file_get_uri">
+<function name="g_input_stream_read_finish">
<description>
-Gets the URI for the @file.
-
-This call does no blocking i/o.
+Finishes an asynchronous stream read operation.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<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> a string containing the #GFile's URI.
-The returned string should be freed with g_free() when no longer needed.
+<return> number of bytes read in, or -1 on error.
</return>
</function>
@@ -20871,16 +20602,6 @@ g_object_unref() when no longer needed.
</return>
</function>
-<function name="GZlibCompressor">
-<description>
-Zlib decompression
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_buffered_input_stream_get_available">
<description>
Gets the size of the available data within the stream.
@@ -20897,33 +20618,6 @@ Gets the size of the available data within the stream.
</return>
</function>
-<function name="g_drive_stop_finish">
-<description>
-Finishes stopping a drive.
-
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the drive has been stopped successfully,
-%FALSE otherwise.
-
-Since: 2.22
-</return>
-</function>
-
<function name="missing_remove">
<description>
Unsafe, need lock fen_lock.
@@ -20944,13 +20638,13 @@ storage when necessary. To construct a fixed-size output stream,
pass %NULL as @realloc_fn.
|[
-/* a stream that can grow */
+/ * a stream that can grow * /
stream = g_memory_output_stream_new (NULL, 0, realloc, free);
-/* another stream that can grow */
+/ * another stream that can grow * /
stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
-/* a fixed-size stream */
+/ * a fixed-size stream * /
data = malloc (200);
stream3 = g_memory_output_stream_new (data, 200, NULL, free);
]|
@@ -20981,78 +20675,60 @@ finalized, or %NULL
</return>
</function>
-<function name="g_file_info_get_display_name">
+<function name="g_drive_get_identifier">
<description>
-Gets a display name for a file.
+Gets the identifier of the given kind for @drive.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="drive">
+<parameter_description> a #GDrive
</parameter_description>
</parameter>
-</parameters>
-<return> a string containing the display name.
-</return>
-</function>
-
-<function name="g_inet_address_get_is_mc_org_local">
-<description>
-Tests whether @address is an organization-local multicast address.
-
-
-</description>
-<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="kind">
+<parameter_description> the kind of identifier to return
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is an organization-local multicast address.
-
-Since: 2.22
+<return> a newly allocated string containing the
+requested identfier, or %NULL if the #GDrive
+doesn't have this kind of identifier.
</return>
</function>
-<function name="g_socket_client_connect_to_host_async">
+<function name="g_file_monitor_directory">
<description>
-This is the asynchronous version of g_socket_client_connect_to_host().
+Obtains a directory monitor for the given file.
+This may fail if directory monitoring is not supported.
-When the operation is finished @callback will be
-called. You can then call g_socket_client_connect_to_host_finish() to get
-the result of the operation.
+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="client">
-<parameter_description> a #GTcpClient
-</parameter_description>
-</parameter>
-<parameter name="host_and_port">
-<parameter_description> the name and optionally the port of the host to connect to
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="default_port">
-<parameter_description> the default port to connect to
+<parameter name="flags">
+<parameter_description> a set of #GFileMonitorFlags.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter name="error">
+<parameter_description> a #GError, or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GFileMonitor for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
</function>
<function name="g_volume_eject_finish">
@@ -21060,6 +20736,7 @@ Since: 2.22
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>
@@ -21078,7 +20755,6 @@ Finishes ejecting a volume. If any errors occured during the operation,
</parameters>
<return> %TRUE, %FALSE if operation failed.
-Deprecated: 2.22: Use g_volume_eject_with_operation_finish() instead.
</return>
</function>
@@ -21136,40 +20812,6 @@ Checks if the unix mount points have changed since a given unix time.
</return>
</function>
-<function name="gvdb_table_get_value">
-<description>
-Looks up a value named @key in @file.
-
-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.
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> a #GvdbTable
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> a string
-</parameter_description>
-</parameter>
-<parameter name="options">
-<parameter_description> a pointer to a #GVariant, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GVariant, or %NULL
-</return>
-</function>
-
<function name="g_settings_set_string">
<description>
Sets @key in @settings to @value.
@@ -21201,31 +20843,63 @@ Since: 2.26
</return>
</function>
-<function name="g_socket_client_connect_finish">
+<function name="g_file_replace_contents_async">
<description>
-Finishes an async connect operation. See g_socket_client_connect_async()
+Starts an asynchronous replacement of @file with the given
+ contents of @length bytes. @etag will replace the document's
+current entity tag.
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_replace_contents_finish().
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
+
+If @make_backup is %TRUE, this function will attempt to
+make a backup of @file.
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="contents">
+<parameter_description> string of contents to replace the file with.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="length">
+<parameter_description> the length of @contents in bytes.
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</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> a #GSocketConnection on success, %NULL on error.
-
-Since: 2.22
-</return>
+<return></return>
</function>
<function name="g_file_query_file_type">
@@ -21236,6 +20910,7 @@ implemented using g_file_query_info() and as such does blocking I/O.
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>
@@ -21255,7 +20930,6 @@ directory, or symlink.
<return> The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file
does not exist
-Since: 2.18
</return>
</function>
@@ -21264,6 +20938,7 @@ Since: 2.18
Finishes unmounting a mount. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
+Deprecated: 2.22: Use g_mount_unmount_with_operation_finish() instead.
</description>
<parameters>
@@ -21283,7 +20958,6 @@ ignore.
</parameters>
<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
-Deprecated: 2.22: Use g_mount_unmount_with_operation_finish() instead.
</return>
</function>
@@ -21303,6 +20977,28 @@ Gets the size of the buffer in the @stream.
</return>
</function>
+<function name="g_file_info_get_attribute_int32">
+<description>
+Gets a signed 32-bit integer contained within the attribute. If the
+attribute does not contain a signed 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> a signed 32-bit integer from the attribute.
+</return>
+</function>
+
<function name="g_drive_stop">
<description>
Asynchronously stops a drive.
@@ -21410,7 +21106,11 @@ not contain a #GObject, %NULL will be returned.
<function name="g_memory_output_stream_get_data_size">
<description>
-Returns: the number of bytes written to the stream
+Returns the number of bytes from the start up
+to including the last byte written in the stream
+that has not been truncated away.
+
+Since: 2.18
</description>
<parameters>
@@ -21421,7 +21121,6 @@ Returns: the number of bytes written to the stream
</parameters>
<return> the number of bytes written to the stream
-Since: 2.18
</return>
</function>
@@ -21441,35 +21140,39 @@ References a file attribute matcher.
</return>
</function>
-<function name="GFilenameCompleter">
+<function name="g_inet_socket_address_get_port">
<description>
-Emitted when the file name completion information comes available.
+Gets @address's port.
+
+Since: 2.22
</description>
<parameters>
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> the port for @address
+
+</return>
</function>
-<function name="g_app_info_get_id">
+<function name="g_io_stream_is_closed">
<description>
-Gets the ID of an application. An id is a string that
-identifies the application. The exact format of the id is
-platform dependent. For instance, on Unix this is the
-desktop file id from the xdg menu specification.
-
-Note that the returned ID may be %NULL, depending on how
-the @appinfo has been constructed.
+Checks if a stream is closed.
+Since: 2.22
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="stream">
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the application's ID.
+<return> %TRUE if the stream is closed.
+
</return>
</function>
@@ -21507,6 +21210,7 @@ If @parent is %NULL then this function returns %TRUE if @file has any
parent at all. If @parent is non-%NULL then %TRUE is only returned
if @file is a child of @parent.
+Since: 2.24
</description>
<parameters>
@@ -21522,7 +21226,6 @@ if @file is a child of @parent.
<return> %TRUE if @file is a child of @parent (or any parent in the
case that @parent is %NULL).
-Since: 2.24
</return>
</function>
@@ -21565,6 +21268,7 @@ the output stream is destroyed.
<description>
Try to get the remote address of a socket connection.
+Since: 2.22
</description>
<parameters>
@@ -21580,7 +21284,6 @@ Try to get the remote address of a socket connection.
<return> a #GSocketAddress or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -21604,37 +21307,19 @@ Since: 2.22
<return></return>
</function>
-<function name="g_input_stream_close">
+<function name="g_data_output_stream_put_uint16">
<description>
-Closes the stream, releasing resources related to it.
-
-Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
-Closing a stream multiple times will not return an error.
-
-Streams will be automatically closed when the last reference
-is dropped, but you might want to call this function to make sure
-resources are released as early as possible.
-
-Some streams might keep the backing store of the stream (e.g. a file descriptor)
-open after the stream is closed. See the documentation for the individual
-stream for details.
-
-On failure the first error that happened will be reported, but the close
-operation will finish as much as possible. A stream that failed to
-close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
-is important to check and report the error to the user.
-
-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.
-Cancelling a close will still leave the stream closed, but some streams
-can use a faster close that doesn't block to e.g. check errors.
+Puts an unsigned 16-bit integer into the output stream.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> A #GInputStream.
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #guint16.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -21642,49 +21327,51 @@ can use a faster close that doesn't block to e.g. check errors.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_initable_new_valist">
+<function name="g_simple_async_result_new_error">
<description>
-Helper function for constructing #GInitiable object. This is
-similar to g_object_new_valist() but also initializes the object
-and returns %NULL, setting an error on failure.
+Creates a new #GSimpleAsyncResult with a set error.
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GInitable.
+<parameter name="source_object">
+<parameter_description> a #GObject, or %NULL.
</parameter_description>
</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of the first property, followed by
-the value, and other property value pairs, and ended by %NULL.
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
</parameter_description>
</parameter>
-<parameter name="var_args">
-<parameter_description> The var args list generated from @first_property_name.
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="domain">
+<parameter_description> a #GQuark.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="code">
+<parameter_description> an error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a string with format characters.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of values to insert into @format.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
-
-Since: 2.22
+<return> a #GSimpleAsyncResult.
</return>
</function>
@@ -21701,6 +21388,7 @@ If there are no outstanding connections then the operation will block
or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled.
To be notified of an incoming connection, wait for the %G_IO_IN condition.
+Since: 2.22
</description>
<parameters>
@@ -21720,7 +21408,6 @@ To be notified of an incoming connection, wait for the %G_IO_IN condition.
<return> a new #GSocket, or %NULL on error.
Free the returned object with g_object_unref().
-Since: 2.22
</return>
</function>
@@ -21765,34 +21452,33 @@ of the request.
<return></return>
</function>
-<function name="g_socket_listener_accept_finish">
+<function name="g_file_unmount_mountable_finish">
<description>
-Finishes an async accept operation. See g_socket_listener_accept_async()
+Finishes an unmount operation, see g_file_unmount_mountable() for details.
+
+Finish an asynchronous unmount operation that was started
+with g_file_unmount_mountable().
+Deprecated: 2.22: Use g_file_unmount_mountable_with_operation_finish() instead.
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="file">
+<parameter_description> input #GFile.
</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> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
-Since: 2.22
</return>
</function>
@@ -21804,6 +21490,7 @@ contexts</link>. If this returns %FALSE, you cannot perform
asynchronous operations on @file in a thread that has a
thread-default context.
+Since: 2.22
</description>
<parameters>
@@ -21814,7 +21501,6 @@ thread-default context.
</parameters>
<return> Whether or not @file supports thread-default contexts.
-Since: 2.22
</return>
</function>
@@ -21824,6 +21510,7 @@ Gets the size of @address's native <type>struct sockaddr</type>.
You can use this to allocate memory to pass to
g_socket_address_to_native().
+Since: 2.22
</description>
<parameters>
@@ -21835,7 +21522,6 @@ g_socket_address_to_native().
<return> the size of the native <type>struct sockaddr</type> that
@address represents
-Since: 2.22
</return>
</function>
@@ -21904,6 +21590,47 @@ Since: 2.22
<return></return>
</function>
+<function name="g_io_stream_close_async">
+<description>
+Requests an asynchronous close of the stream, releasing resources
+related to it. When the operation is finished @callback will be
+called. You can then call g_io_stream_close_finish() to get
+the result of the operation.
+
+For behaviour details see g_io_stream_close().
+
+The asynchronous methods have a default fallback that uses threads
+to implement asynchronicity, so they are optional for inheriting
+classes. However, if you override one you must override all.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request
+</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>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</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
@@ -21940,6 +21667,7 @@ can use a faster close that doesn't block to e.g. check errors.
The default implementation of this method just calls close on the
individual input/output streams.
+Since: 2.22
</description>
<parameters>
@@ -21958,47 +21686,21 @@ individual input/output streams.
</parameters>
<return> %TRUE on success, %FALSE on failure
-Since: 2.22
</return>
</function>
-<function name="g_socket_listener_accept">
+<function name="g_unix_fd_message_new">
<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.
+Creates a new #GUnixFDMessage containing an empty file descriptor
+list.
+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> a new #GUnixFDMessage
-Since: 2.22
</return>
</function>
@@ -22066,47 +21768,69 @@ in @result.
<return></return>
</function>
-<function name="g_input_stream_read_finish">
+<function name="g_file_get_uri">
<description>
-Finishes an asynchronous stream read operation.
+Gets the URI for the @file.
+
+This call does no blocking i/o.
</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 name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
</parameters>
-<return> number of bytes read in, or -1 on error.
+<return> a string containing the #GFile's URI.
+The returned string should be freed with g_free() when no longer needed.
</return>
</function>
-<function name="g_mount_operation_set_username">
+<function name="gvdb_table_get_value">
<description>
-Sets the user name within @op to @username.
+Looks up a value named @key in @file.
+
+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.
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="file">
+<parameter_description> a #GvdbTable
</parameter_description>
</parameter>
-<parameter name="username">
-<parameter_description> input username.
+<parameter name="key">
+<parameter_description> a string
+</parameter_description>
+</parameter>
+<parameter name="options">
+<parameter_description> a pointer to a #GVariant, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GVariant, or %NULL
+</return>
+</function>
+
+<function name="g_local_vfs_new">
+<description>
+Returns a new #GVfs handle for a local vfs.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GVfs handle.
+</return>
</function>
<function name="g_mount_shadow">
@@ -22128,41 +21852,51 @@ Since: 2.20
<return></return>
</function>
-<function name="g_io_stream_close_async">
+<function name="g_unix_mount_guess_can_eject">
<description>
-Requests an asynchronous close of the stream, releasing resources
-related to it. When the operation is finished @callback will be
-called. You can then call g_io_stream_close_finish() to get
-the result of the operation.
+Guesses whether a Unix mount can be ejected.
-For behaviour details see g_io_stream_close().
-The asynchronous methods have a default fallback that uses threads
-to implement asynchronicity, so they are optional for inheriting
-classes. However, if you override one you must override all.
+</description>
+<parameters>
+<parameter name="mount_entry">
+<parameter_description> a #GUnixMountEntry
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @mount_entry is deemed to be ejectable.
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_name_async">
+<description>
+Begins asynchronously resolving @hostname to determine its
+associated IP address(es), and eventually calls @callback, which
+must call g_resolver_lookup_by_name_finish() to get the result.
+See g_resolver_lookup_by_name() for more details.
Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter name="resolver">
+<parameter_description> a #GResolver
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request
+<parameter name="hostname">
+<parameter_description> the hostname to look up the address of
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<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="callback">
+<parameter_description> callback to call after resolution completes
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional cancellable object
+<parameter name="user_data">
+<parameter_description> data for @callback
</parameter_description>
</parameter>
</parameters>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
