[glibmm] Re-generate gio_docs.xml
- From: Jonathon Jongsma <jjongsma src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [glibmm] Re-generate gio_docs.xml
- Date: Sun, 3 Jan 2010 04:58:18 +0000 (UTC)
commit 4cc7e82041fc00b72a26b86633b8175101c3b541
Author: Jonathon Jongsma <jonathon quotidian org>
Date: Sat Jan 2 16:30:16 2010 -0600
Re-generate gio_docs.xml
gio/src/gio_docs.xml | 5185 +++++++++++++++++++++++++++++++++++---------------
1 files changed, 3682 insertions(+), 1503 deletions(-)
---
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 09f260a..78fad7f 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -175,6 +175,8 @@ Ejects a mount. This is an asynchronous operation, and is
finished by calling g_mount_eject_finish() with the @mount
and #GAsyncResult data returned in the @callback.
+Deprecated: 2.22: Use g_mount_eject_with_operation() instead.
+
</description>
<parameters>
<parameter name="mount">
@@ -270,25 +272,32 @@ g_unix_mount_monitor_set_rate_limit() to change this.
</return>
</function>
-<function name="g_app_info_delete">
+<function name="g_unix_fd_list_new_from_array">
<description>
-Tries to delete an #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.
</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
+Since: 2.24
</return>
</function>
@@ -356,7 +365,7 @@ Gets the file's size.
<function name="g_socket_control_message_get_level">
<description>
-Returns: and int describing the level
+Returns: an integer describing the level
</description>
<parameters>
@@ -365,7 +374,7 @@ Returns: and int describing the level
</parameter_description>
</parameter>
</parameters>
-<return> and int describing the level
+<return> an integer describing the level
Since: 2.22
</return>
@@ -413,6 +422,28 @@ Sets the @attribute to contain the given value, if possible.
<return></return>
</function>
+<function name="g_zlib_compressor_new">
+<description>
+Creates a new #GZlibCompressor.
+
+
+</description>
+<parameters>
+<parameter name="format">
+<parameter_description> The format to use for the compressed data
+</parameter_description>
+</parameter>
+<parameter name="level">
+<parameter_description> compression level (0-9), -1 for default
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GZlibCompressor
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_file_make_symbolic_link">
<description>
Creates a symbolic link.
@@ -453,11 +484,11 @@ Checks if a stream has pending actions.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream.
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream has pending actions.
+<return> %TRUE if @stream has pending actions.
Since: 2.22
</return>
@@ -465,9 +496,12 @@ Since: 2.22
<function name="g_cancellable_disconnect">
<description>
-Disconnects a handler from an cancellable instance similar to
-g_signal_handler_disconnect() but ensures that once this
-function returns the handler will not run anymore in any thread.
+Disconnects a handler from a cancellable instance similar to
+g_signal_handler_disconnect(). Additionally, in the event that a
+signal handler is currently running, this call will block until the
+handler has finished. Calling this function from a
+#GCancellable::cancelled signal handler will therefore result in a
+deadlock.
This avoids a race condition where a thread cancels at the
same time as the cancellable operation is finished and the
@@ -613,23 +647,20 @@ Emitted when the unix mount points have changed.
<return></return>
</function>
-<function name="g_file_info_set_sort_order">
+<function name="g_socket_listener_new">
<description>
-Sets the sort order attribute in the file info structure. See
-%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+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>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="sort_order">
-<parameter_description> a sort order integer.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a new #GSocketListener.
+
+Since: 2.22
+</return>
</function>
<function name="g_resolver_lookup_by_address_async">
@@ -696,8 +727,10 @@ 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
-cause the source to trigger, reporting the current condition. You can
-check for this in the callback using g_cancellable_is_cancelled().
+cause the source to trigger, reporting the current condition (which
+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().
</description>
@@ -721,6 +754,25 @@ 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>
+
<function name="g_unix_mount_point_is_loopback">
<description>
Checks if a unix mount point is a loopback device.
@@ -1068,6 +1120,41 @@ Since: 2.22
</return>
</function>
+<function name="g_file_poll_mountable">
+<description>
+Polls 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_mount_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="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_simple_async_result_set_handle_cancellation">
<description>
Sets whether to handle cancellation within the asynchronous operation.
@@ -1087,25 +1174,48 @@ Sets whether to handle cancellation within the asynchronous operation.
<return></return>
</function>
-<function name="g_socket_get_protocol_id">
+<function name="g_socket_check_connect_result">
<description>
-Gets the socket protocol id the socket was created with.
-In case the protocol is unknown, -1 is returned.
+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.
</description>
<parameters>
<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a protocol id, or -1 if unknown
+<return> %TRUE if no error, %FALSE otherwise, setting @error to the error
Since: 2.22
</return>
</function>
+<function name="g_io_module_new">
+<description>
+Creates a new GIOModule that will load the specific
+shared library when in use.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> filename of the shared library module.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIOModule from given @filename,
+or %NULL on error.
+</return>
+</function>
+
<function name="g_resolver_lookup_by_name">
<description>
Synchronously resolves @hostname to determine its associated IP
@@ -1157,22 +1267,79 @@ Since: 2.22
</return>
</function>
-<function name="g_unix_socket_address_new">
+<function name="g_socket_listener_accept_async">
<description>
-Creates a new #GUnixSocketAddress for @path.
+This is the asynchronous version of g_socket_listener_accept().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_listener_accept_socket()
+to get the result of the operation.
+Since: 2.22
</description>
<parameters>
-<parameter name="path">
-<parameter_description> the socket path
+<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> a new #GUnixSocketAddress
+<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
-</return>
+
+</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">
@@ -1189,6 +1356,24 @@ Clears the status information from @info.
<return></return>
</function>
+<function name="g_network_service_get_service">
+<description>
+Gets @srv's service name (eg, "ldap").
+
+
+</description>
+<parameters>
+<parameter name="srv">
+<parameter_description> a #GNetworkService
+</parameter_description>
+</parameter>
+</parameters>
+<return> @srv's service name
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_mount_unshadow">
<description>
Decrements the shadow count on @mount. Usually used by
@@ -1219,6 +1404,8 @@ 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.
+Deprecated: 2.22: Use g_file_eject_mountable_with_operation() instead.
+
</description>
<parameters>
<parameter name="file">
@@ -1277,6 +1464,31 @@ Since: 2.22
</return>
</function>
+<function name="g_output_stream_splice_finish">
+<description>
+Finishes an asynchronous stream splice operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</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 #gssize of the number of bytes spliced.
+</return>
+</function>
+
<function name="g_file_info_get_is_backup">
<description>
Checks if a file is a backup file.
@@ -1330,21 +1542,24 @@ of the request.
<return></return>
</function>
-<function name="g_unix_volume_set_mount">
+<function name="g_unix_fd_message_get_fd_list">
<description>
+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.
+
</description>
<parameters>
-<parameter name="volume">
-<parameter_description>
-</parameter_description>
-</parameter>
-<parameter name="mount">
-<parameter_description>
+<parameter name="message">
+<parameter_description> a #GUnixFDMessage
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #GUnixFDList from @message
+
+Since: 2.24
+</return>
</function>
<function name="g_resolver_lookup_by_address">
@@ -1535,6 +1750,83 @@ Checks if @mount can be mounted.
</return>
</function>
+<function name="g_file_replace_readwrite">
+<description>
+Returns: a #GFileIOStream or %NULL on error.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
+current #GFile, or #NULL to ignore
+</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="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<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">
+<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_file_query_filesystem_info_finish">
<description>
Finishes an asynchronous filesystem info query. See
@@ -1661,6 +1953,25 @@ See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.
<return></return>
</function>
+<function name="g_tcp_connection_get_graceful_disconnect">
+<description>
+Checks if graceful disconnects are used. See
+g_tcp_connection_set_graceful_disconnect().
+
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GTcpConnection
+</parameter_description>
+</parameter>
+</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.
@@ -1671,6 +1982,27 @@ Information about an installed application from a desktop file.
<return></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.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is being closed. %FALSE otherwise.
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_unix_mount_point_guess_icon">
<description>
Guesses the icon of a Unix mount point.
@@ -1704,6 +2036,28 @@ or #G_TYPE_INVALID if the extension point has no required type
</return>
</function>
+<function name="g_app_info_delete">
+<description>
+Tries to delete a #GAppInfo.
+
+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().
+
+
+</description>
+<parameters>
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @appinfo has been deleted
+
+Since: 2.20
+</return>
+</function>
+
<function name="g_loadable_icon_load_async">
<description>
Loads an icon asynchronously. To finish this function, see
@@ -1801,18 +2155,22 @@ See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.
<return></return>
</function>
-<function name="g_unix_mount_point_free">
+<function name="g_drive_can_start">
<description>
-Frees a unix mount point.
+Checks if a drive can be started.
+
</description>
<parameters>
-<parameter name="mount_point">
-<parameter_description> unix mount point to free.
+<parameter name="drive">
+<parameter_description> a #GDrive.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the @drive can be started, %FALSE otherwise.
+
+Since: 2.22
+</return>
</function>
<function name="g_emblem_get_origin">
@@ -1823,7 +2181,7 @@ Gets the origin of the emblem.
</description>
<parameters>
<parameter name="emblem">
-<parameter_description> a #GEmblem
+<parameter_description> a #GEmblem
</parameter_description>
</parameter>
</parameters>
@@ -1977,6 +2335,20 @@ Sets the application as the default handler for a given type.
</return>
</function>
+<function name="g_unix_socket_address_abstract_names_supported">
+<description>
+Checks if abstract unix domain socket names are supported.
+
+
+</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.
@@ -2058,39 +2430,21 @@ Return value: %TRUE if the base stream will be closed.
</return>
</function>
-<function name="g_file_monitor">
+<function name="g_converter_output_stream_get_converter">
<description>
-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.
+Gets the #GConverter that is used by @converter_stream.
</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="converter_stream">
+<parameter_description> a #GConverterOutputStream
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileMonitor for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> the converter of the converter output stream
-Since: 2.18
+Since: 2.24
</return>
</function>
@@ -2151,34 +2505,34 @@ of the request.
<function name="g_file_create_readwrite_async">
<description>
-Asynchronously creates a new file and returns a stream for reading and writing
-to it. The file must not already exist.
+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.
+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> input #GFile
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<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.
+of the request
</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">
@@ -2296,9 +2650,8 @@ 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> %TRUE if successful. If an error has occurred, this function will
+return %FALSE and set @error appropriately if present.
Since: 2.22
</return>
@@ -2400,6 +2753,26 @@ Checks if a file is hidden.
</return>
</function>
+<function name="g_socket_connection_get_socket">
+<description>
+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.
+
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL on error.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_themed_icon_get_names">
<description>
Gets the names of icons from within @icon.
@@ -2448,6 +2821,24 @@ Check if @drive has any mountable volumes.
</return>
</function>
+<function name="g_utf8_input_stream_new">
+<description>
+Creates a new #GUtf8InputStream from the given @base_stream.
+
+
+</description>
+<parameters>
+<parameter name="base_stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GInputStream for the given @base_stream.
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_app_info_get_description">
<description>
Gets a human-readable description of an installed application.
@@ -2467,7 +2858,7 @@ application @appinfo, or %NULL if none.
<function name="g_app_info_equal">
<description>
-Checks if two #GAppInfos are equal.
+Checks if two #GAppInfo<!-- -->s are equal.
</description>
@@ -2543,20 +2934,61 @@ Checks if an output stream has already been closed.
</return>
</function>
-<function name="g_inet_address_to_bytes">
+<function name="g_socket_listener_add_address">
<description>
-Gets the raw binary address data from @address.
+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.
</description>
<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSocketType
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> a #GSocketProtocol
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="effective_address">
+<parameter_description> location to store the address that was bound to, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to an internal array of the bytes in @address,
-which should not be modified, stored, or freed.
+<return> %TRUE on success, %FALSE on error.
Since: 2.22
</return>
@@ -2833,9 +3265,11 @@ Returns: read-only buffer
<function name="GDrive">
<description>
-Emitted when the physical eject button (if any) of a drive has
+Emitted when the physical stop button (if any) of a drive has
been pressed.
+Since: 2.22
+
</description>
<parameters>
<parameter name="drive">
@@ -2874,13 +3308,21 @@ appropriately if present.
<function name="g_threaded_socket_service_new">
<description>
-Creates a new #GThreadedSocketService with no listeners. Listeners
+Creates a new #GThreadedSocketService with no listeners. Listeners
must be added with g_socket_service_add_listeners().
+
</description>
<parameters>
+<parameter name="max_threads">
+<parameter_description> the maximal number of threads to execute concurrently
+handling incoming clients, -1 means no limit
+</parameter_description>
+</parameter>
</parameters>
<return> a new #GSocketService.
+
+Since: 2.22
</return>
</function>
@@ -2984,66 +3426,74 @@ ignored.
</parameter>
</parameters>
<return> a #GSocketAddress (owned by the caller), or %NULL on
-error (in which case * error will be set) or if there are no more
-addresses.
+error (in which case * error will be set) or if there are no
+more addresses.
</return>
</function>
-<function name="g_file_monitor_cancel">
+<function name="g_io_scheduler_job_send_to_mainloop_async">
<description>
-Cancels a file monitor.
+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="monitor">
-<parameter_description> a #GFileMonitor.
+<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> %TRUE if monitor was cancelled.
-</return>
+<return></return>
</function>
-<function name="g_data_output_stream_new">
+<function name="g_file_monitor_cancel">
<description>
-Creates a new data output stream for @base_stream.
+Cancels a file monitor.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GOutputStream.
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
</parameter_description>
</parameter>
</parameters>
-<return> #GDataOutputStream.
+<return> %TRUE if monitor was cancelled.
</return>
</function>
-<function name="g_file_read_finish">
+<function name="g_data_output_stream_new">
<description>
-Finishes an asynchronous file read operation started with
-g_file_read_async().
+Creates a new data output stream for @base_stream.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInputStream or %NULL on error.
-Free the returned object with g_object_unref().
+<return> #GDataOutputStream.
</return>
</function>
@@ -3072,6 +3522,16 @@ to g_poll() and used to poll for cancellation. This is useful both
for unix systems without a native poll and for portability to
windows.
+When this function returns %TRUE, you should use
+g_cancellable_release_fd() to free up resources allocated for the
+ pollfd After a %FALSE return, do not call g_cancellable_release_fd().
+
+If this function returns %FALSE, either no @cancellable was given or
+resource limits prevent this function from allocating the necessary
+structures for polling. (On Linux, you will likely have reached
+the maximum number of file descriptors.) The suggested way to handle
+these cases is to ignore the @cancellable.
+
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().
@@ -3080,7 +3540,7 @@ with g_cancellable_reset().
</description>
<parameters>
<parameter name="cancellable">
-<parameter_description> a #GCancellable.
+<parameter_description> a #GCancellable or %NULL
</parameter_description>
</parameter>
<parameter name="pollfd">
@@ -3088,7 +3548,11 @@ with g_cancellable_reset().
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @pollfd was successfully initialized, %FALSE on
+failure to prepare the cancellable.
+
+Since: 2.22
+</return>
</function>
<function name="g_file_icon_get_file">
@@ -3133,11 +3597,10 @@ when the stream is closed.
<function name="GSocketService">
<description>
The ::incoming signal is emitted when a new incoming connection
-to @service needs to be handled. The handler must initiate the
+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.
-If %TRUE is returned then no other handlers are called.
</description>
<parameters>
@@ -3154,7 +3617,37 @@ If %TRUE is returned then no other handlers are called.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @connection has been handled.
+<return> %TRUE to stop other handlers from being called
+
+Since: 2.22
+</return>
+</function>
+
+<function name="g_mount_unmount_with_operation_finish">
+<description>
+Finishes unmounting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</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 mount was successfully unmounted. %FALSE otherwise.
+
+Since: 2.22
</return>
</function>
@@ -3266,6 +3759,31 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
+<function name="g_file_input_stream_query_info_finish">
+<description>
+Finishes an asynchronous info query operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring,
+or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileInfo.
+</return>
+</function>
+
<function name="g_seekable_seek">
<description>
Seeks in the stream by the given @offset, modified by @type.
@@ -3342,63 +3860,47 @@ given name, or %NULL if there is no extension with that name
</return>
</function>
-<function name="g_file_set_attribute">
+<function name="g_data_input_stream_get_newline_type">
<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.
+Gets the current newline type for the @stream.
</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_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the attribute was set, %FALSE otherwise.
+<return> #GDataStreamNewlineType for the given @stream.
</return>
</function>
-<function name="g_data_input_stream_get_newline_type">
+<function name="g_volume_eject_with_operation_finish">
<description>
-Gets the current newline type for the @stream.
+Finishes ejecting a volume. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="volume">
+<parameter_description> a #GVolume.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return> #GDataStreamNewlineType for the given @stream.
+<return> %TRUE if the volume was successfully ejected. %FALSE otherwise.
+
+Since: 2.22
</return>
</function>
@@ -3500,6 +4002,10 @@ Converts a #GSocketAddress to a native <type>struct
sockaddr</type>, which can be passed to low-level functions like
connect() or bind().
+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.
+
</description>
<parameters>
@@ -3517,9 +4023,12 @@ connect() or bind().
g_socket_address_get_native_size().
</parameter_description>
</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
</parameters>
-<return> %TRUE if @dest was filled in, %FALSE if @address is invalid
-or @destlen is too small.
+<return> %TRUE if @dest was filled in, %FALSE on error
Since: 2.22
</return>
@@ -3625,95 +4134,49 @@ See g_socket_client_set_protocol() for details.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient
</parameter_description>
</parameter>
</parameters>
-<return> a string or %NULL. don't free
+<return> a #GSocketProtocol
Since: 2.22
</return>
</function>
-<function name="g_io_scheduler_job_send_to_mainloop_async">
+<function name="g_cancellable_release_fd">
<description>
-Used from an I/O job to send a callback to be run asynchronously
-in the main loop (main thread). 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.
+Releases a resources previously allocated by g_cancellable_get_fd()
+or g_cancellable_make_pollfd().
-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 main 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_data_input_stream_read_byte">
-<description>
-Reads an unsigned 8-bit/1-byte value from @stream.
+For compatibility reasons with older releases, calling this function
+is not strictly required, the resources will be automatically freed
+when the @cancellable is finalized. However, the @cancellable will
+block scarce file descriptors until it is finalized if this function
+is not called. This can cause the application to run out of file
+descriptors when many #GCancellables are used at the same time.
+Since: 2.22
</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_description> a #GCancellable
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 8-bit/1-byte value read from the @stream or %0
-if an error occurred.
-</return>
+<return></return>
</function>
-<function name="g_filename_completer_get_completions">
+<function name="GZlibDecompressor">
<description>
-Gets an array of completion strings for a given initial text.
-
+Zlib decompression
</description>
<parameters>
-<parameter name="completer">
-<parameter_description> the filename completer.
-</parameter_description>
-</parameter>
-<parameter name="initial_text">
-<parameter_description> text to be completed.
-</parameter_description>
-</parameter>
</parameters>
-<return> array of strings with possible completions for @initial_text.
-This array must be freed by g_strfreev() when finished.
-</return>
+<return></return>
</function>
<function name="g_inet_address_get_family">
@@ -3798,17 +4261,24 @@ that host.
<return></return>
</function>
-<function name="g_dummy_file_new">
+<function name="g_filename_completer_get_completions">
<description>
+Gets an array of completion strings for a given initial text.
+
</description>
<parameters>
-<parameter name="uri">
-<parameter_description> Universal Resource Identifier for the dummy file object.
+<parameter name="completer">
+<parameter_description> the filename completer.
+</parameter_description>
+</parameter>
+<parameter name="initial_text">
+<parameter_description> text to be completed.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFile.
+<return> array of strings with possible completions for @initial_text.
+This array must be freed by g_strfreev() when finished.
</return>
</function>
@@ -3852,18 +4322,6 @@ Since: 2.20
</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_get_icon">
<description>
Gets the icon for a file.
@@ -3993,6 +4451,56 @@ 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_socket_client_set_socket_type">
<description>
Sets the socket type of the socket client.
@@ -4006,8 +4514,8 @@ Since: 2.22
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
<parameter name="type">
@@ -4018,6 +4526,36 @@ Since: 2.22
<return></return>
</function>
+<function name="g_file_poll_mountable_finish">
+<description>
+Finishes a poll operation. See g_file_poll_mountable() for details.
+
+Finish an asynchronous poll operation that was polled
+with g_file_poll_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> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_mount_remount_finish">
<description>
Finishes remounting a mount. If any errors occurred during the operation,
@@ -4082,15 +4620,64 @@ I/O operation if @arg points to a malformed path.
</return>
</function>
-<function name="g_io_error_quark">
+<function name="g_data_input_stream_read_until_async">
<description>
-Gets the GIO Error Quark.
+The asynchronous version of g_data_input_stream_read_until().
+It is an error to have two outstanding calls to this function.
+
+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_stream_get_output_stream">
+<description>
+Gets the output stream for this object. This is used for
+writing.
</description>
<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GQuark.
+<return> a #GOutputStream, owned by the #GIOStream. Do not free.
+
+Since: 2.22
</return>
</function>
@@ -4183,20 +4770,22 @@ multi-byte entities (such as integers) to the stream.
<return></return>
</function>
-<function name="g_unix_mount_point_get_fs_type">
+<function name="g_converter_reset">
<description>
-Gets the file system type for the mount point.
+Resets all internal state in the converter, making it behave
+as if it was just created. If the converter has any internal
+state that would produce output then that output is lost.
+Since: 2.24
</description>
<parameters>
-<parameter name="mount_point">
-<parameter_description> a #GUnixMountPoint.
+<parameter name="converter">
+<parameter_description> a #GConverter.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the file system type.
-</return>
+<return></return>
</function>
<function name="g_volume_monitor_get_mounts">
@@ -4218,6 +4807,25 @@ its elements have been unreffed with g_object_unref().
</return>
</function>
+<function name="g_socket_get_protocol">
+<description>
+Gets the socket protocol id the socket was created with.
+In case the protocol is unknown, -1 is returned.
+
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a protocol id, or -1 if unknown
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_file_query_info_async">
<description>
Asynchronously gets the requested information about specified @file. The result
@@ -4265,6 +4873,34 @@ of the request.
<return></return>
</function>
+<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>
+
<function name="g_app_info_remove_supports_type">
<description>
Removes a supported type from an application, if possible.
@@ -4289,6 +4925,47 @@ Removes a supported type from an application, if possible.
</return>
</function>
+<function name="g_file_info_set_sort_order">
+<description>
+Sets the sort order attribute in the file info structure. See
+%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="sort_order">
+<parameter_description> a sort order integer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_listener_set_backlog">
+<description>
+Sets the listen backlog on the sockets in the listener.
+
+See g_socket_set_listen_backlog() for details
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="listen_backlog">
+<parameter_description> an integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_io_scheduler_push_job">
<description>
Schedules the I/O job to run.
@@ -4327,33 +5004,25 @@ of the request.
<return></return>
</function>
-<function name="g_file_set_attribute_byte_string">
+<function name="g_initable_newv">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
-If @attribute is of a different type, this operation will fail,
-returning %FALSE.
-
-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.
+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.
</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 name="object_type">
+<parameter_description> a #GType supporting #GInitable.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> a string containing the attribute's new value.
+<parameter name="n_parameters">
+<parameter_description> the number of parameters in @parameters
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
+<parameter name="parameters">
+<parameter_description> the parameters to use to construct the object
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -4361,12 +5030,56 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set to @value
-in the @file, %FALSE otherwise.
+<return> a newly allocated #GObject, or %NULL on error
+
+Since: 2.22
+</return>
+</function>
+
+<function name="g_charset_converter_new">
+<description>
+Creates a new #GCharsetConverter.
+
+
+</description>
+<parameters>
+<parameter name="to_charset">
+<parameter_description> destination charset
+</parameter_description>
+</parameter>
+<parameter name="from_charset">
+<parameter_description> source charset
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GCharsetConverter or %NULL on error.
+
+Since: 2.24
+</return>
+</function>
+
+<function name="g_data_input_stream_new">
+<description>
+Creates a new data input stream for the @base_stream.
+
+
+</description>
+<parameters>
+<parameter name="base_stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GDataInputStream.
</return>
</function>
@@ -4499,45 +5212,60 @@ Since: 2.22
</return>
</function>
-<function name="g_mount_operation_set_password">
+<function name="g_unix_fd_list_get">
<description>
-Sets the mount operation's password to @password.
+Gets a file descriptor out of @list.
+
+ index_ specifies the index of the file descriptor to get. It is a
+programmer error for @index_ to be out of range; see
+g_unix_fd_list_get_length().
+
+The file descriptor is duplicated using dup() and set as
+close-on-exec before being returned. You must call close() on it
+when you are done.
+
+A possible cause of failure is exceeding the per-process or
+system-wide file descriptor limit.
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="list">
+<parameter_description> a #GUnixFDList
</parameter_description>
</parameter>
-<parameter name="password">
-<parameter_description> password to set.
+<parameter name="index_">
+<parameter_description> the index into the list
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the file descriptor, or -1 in case of error
+
+Since: 2.24
+</return>
</function>
-<function name="g_winhttp_file_output_stream_new">
+<function name="g_mount_operation_set_password">
<description>
+Sets the mount operation's password to @password.
+
</description>
<parameters>
-<parameter name="file">
-<parameter_description> the GWinHttpFile being read
-</parameter_description>
-</parameter>
-<parameter name="connection">
-<parameter_description> handle to the HTTP connection, as from WinHttpConnect()
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
-<parameter name="request">
-<parameter_description> handle to the HTTP request, as from WinHttpOpenRequest
+<parameter name="password">
+<parameter_description> password to set.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileOutputStream for the given request
-</return>
+<return></return>
</function>
<function name="g_socket_listen">
@@ -4548,6 +5276,9 @@ to accept incoming requests using g_socket_accept().
Before calling this the socket must be bound to a local address using
g_socket_bind().
+To set the maximum amount of outstanding clients, use
+g_socket_set_listen_backlog().
+
</description>
<parameters>
@@ -4569,7 +5300,7 @@ Since: 2.22
<function name="g_initable_new">
<description>
Helper function for constructing #GInitiable object. This is
-similar to g_object_newv() but also initializes the object
+similar to g_object_new() but also initializes the object
and returns %NULL, setting an error on failure.
@@ -4579,14 +5310,6 @@ and returns %NULL, setting an error on failure.
<parameter_description> a #GType supporting #GInitable.
</parameter_description>
</parameter>
-<parameter name="n_parameters">
-<parameter_description> the number of parameters in @parameters
-</parameter_description>
-</parameter>
-<parameter name="parameters">
-<parameter_description> the parameters to use to construct the object
-</parameter_description>
-</parameter>
<parameter name="cancellable">
<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
@@ -4596,6 +5319,16 @@ and returns %NULL, setting an error on failure.
ignore.
</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 if the first property, followed by and other property
+value pairs, and ended by %NULL.
+</parameter_description>
+</parameter>
</parameters>
<return> a newly allocated #GObject, or %NULL on error
@@ -4674,10 +5407,31 @@ be freed with g_free() when no longer needed.
</return>
</function>
+<function name="g_converter_input_stream_new">
+<description>
+Creates a new converter input stream for the @base_stream.
+
+
+</description>
+<parameters>
+<parameter name="base_stream">
+<parameter_description> a #GInputStream
+</parameter_description>
+</parameter>
+<parameter name="converter">
+<parameter_description> a #GConverter
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInputStream.
+</return>
+</function>
+
<function name="g_simple_async_result_complete_in_idle">
<description>
-Completes an asynchronous function in the main event loop using
-an idle function.
+Completes an asynchronous function in an idle handler in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread that @simple was initially created in.
</description>
<parameters>
@@ -4714,27 +5468,40 @@ ignore.
</return>
</function>
-<function name="g_file_info_set_attribute_byte_string">
+<function name="g_socket_listener_add_any_inet_port">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+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.
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="listener">
+<parameter_description> a #GSocketListener
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
</parameter_description>
</parameter>
-<parameter name="attr_value">
-<parameter_description> a byte string.
+<parameter name="error">
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the port number, or 0 in case of failure.
+
+Since: 2.24
+</return>
</function>
<function name="g_inet_address_get_is_link_local">
@@ -4757,25 +5524,32 @@ Since: 2.22
</return>
</function>
-<function name="g_emblem_new_with_origin">
+<function name="g_async_initable_new_finish">
<description>
-Creates a new emblem for @icon.
+Finishes the async construction for the various g_async_initable_new calls,
+returning the created object or %NULL on error.
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a GIcon containing the icon.
+<parameter name="initable">
+<parameter_description> the #GAsyncInitable from the callback
</parameter_description>
</parameter>
-<parameter name="origin">
-<parameter_description> a GEmblemOrigin enum defining the emblem's origin
+<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 new #GEmblem.
+<return> a newly created #GObject, or %NULL on error. Free with
+g_object_unref().
-Since: 2.18
+Since: 2.22
</return>
</function>
@@ -4840,43 +5614,6 @@ if the operation's result was %FALSE.
</return>
</function>
-<function name="g_memory_output_stream_get_size">
-<description>
-Gets the size of the currently allocated data area (availible from
-g_memory_output_stream_get_data()). If the stream isn't
-growable (no realloc was passed to g_memory_output_stream_new()) then
-this is the maximum size of the stream and further writes
-will return %G_IO_ERROR_NO_SPACE.
-
-Note that for growable streams the returned size may become invalid on
-the next write or truncate operation on the stream.
-
-If you want the number of bytes currently written to the stream, use
-g_memory_output_stream_get_data_size().
-
-
-</description>
-<parameters>
-<parameter name="ostream">
-<parameter_description> a #GMemoryOutputStream
-</parameter_description>
-</parameter>
-</parameters>
-<return> the number of bytes allocated for the data buffer
-</return>
-</function>
-
-<function name="port_add_internal">
-<description>
-< private >
-Unsafe, need lock fen_lock.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_simple_async_result_set_op_res_gssize">
<description>
Sets the operation result within the asynchronous result to
@@ -4899,7 +5636,8 @@ the given @op_res.
<function name="g_socket_get_local_address">
<description>
Try to get the local address of a bound socket. This is only
-useful if the socket has been bound to a local address.
+useful if the socket has been bound to a local address,
+either explicitly or implicitly when connecting.
</description>
@@ -4914,27 +5652,12 @@ useful if the socket has been bound to a local address.
</parameter>
</parameters>
<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
Since: 2.22
</return>
</function>
-<function name="g_content_type_get_icon">
-<description>
-Gets the icon for a content type.
-
-
-</description>
-<parameters>
-<parameter name="type">
-<parameter_description> a content type string.
-</parameter_description>
-</parameter>
-</parameters>
-<return> #GIcon corresponding to the content type.
-</return>
-</function>
-
<function name="g_unix_output_stream_get_fd">
<description>
Return the UNIX file descriptor that the stream writes to.
@@ -4996,6 +5719,25 @@ ignore.
</return>
</function>
+<function name="g_inet_address_get_native_size">
+<description>
+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().
+
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes used for the native version of @address.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_resolver_get_default">
<description>
Gets the default #GResolver. You should unref it when you are done
@@ -5007,7 +5749,7 @@ resolutions.
</description>
<parameters>
</parameters>
-<return> the #GResolver.
+<return> the default #GResolver.
Since: 2.22
</return>
@@ -5139,17 +5881,6 @@ Should be called only once; subsequent calls are ignored.
<return></return>
</function>
-<function name="g_winhttp_vfs_new">
-<description>
-Returns: a new #GVfs handle.
-
-</description>
-<parameters>
-</parameters>
-<return> a new #GVfs handle.
-</return>
-</function>
-
<function name="g_file_io_stream_query_info">
<description>
Queries a file io stream for the given @attributes.
@@ -5201,7 +5932,7 @@ Since: 2.22
This signal is emitted when the #GMount is about to be
unmounted.
-Since: 2.22.
+Since: 2.22
</description>
<parameters>
@@ -5213,6 +5944,24 @@ Since: 2.22.
<return></return>
</function>
+<function name="g_content_type_can_be_executable">
+<description>
+Checks if a content type can be executable. Note that for instance
+things like text files can be executables (i.e. scripts and batch files).
+
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> a content type string.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file type corresponds to a type that
+can be executable, %FALSE otherwise.
+</return>
+</function>
+
<function name="g_mount_eject_finish">
<description>
Finishes ejecting a mount. If any errors occurred during the operation,
@@ -5236,6 +5985,8 @@ ignore.
</parameter>
</parameters>
<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
+
+Deprecated: 2.22: Use g_mount_eject_with_operation_finish() instead.
</return>
</function>
@@ -5463,6 +6214,10 @@ You are not supposed to read from the fd yourself, just check for
readable status. Reading to unset the readable status is done
with g_cancellable_reset().
+After a successful return from this function, you should use
+g_cancellable_release_fd() to free up resources allocated for
+the returned file descriptor.
+
See also g_cancellable_make_pollfd().
@@ -5478,15 +6233,44 @@ is not supported, or on errors.
</return>
</function>
-<function name="GNetworkService">
+<function name="g_converter_output_stream_new">
<description>
-A #GSocketConnectable for resolving a SRV record and connecting to
-that service.
+Creates a new converter output stream for the @base_stream.
+
</description>
<parameters>
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream
+</parameter_description>
+</parameter>
+<parameter name="converter">
+<parameter_description> a #GConverter
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> a new #GOutputStream.
+</return>
+</function>
+
+<function name="g_app_info_get_display_name">
+<description>
+Gets the display name of the application. The display name is often more
+descriptive to the user than the name itself.
+
+
+</description>
+<parameters>
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the display name of the application for @appinfo, or the name if
+no display name is available.
+
+Since: 2.24
+</return>
</function>
<function name="g_buffered_input_stream_fill_finish">
@@ -5653,7 +6437,7 @@ Get the #GFile container which is being enumerated.
</parameters>
<return> the #GFile which is being enumerated.
-Since: 2.18.
+Since: 2.18
</return>
</function>
@@ -5740,13 +6524,40 @@ Since: 2.22
</return>
</function>
+<function name="g_drive_start_finish">
+<description>
+Finishes starting 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 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().
+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() to get
-the result of the operation.
+called. You can then call g_socket_listener_accept_socket_finish()
+to get the result of the operation.
Since: 2.22
@@ -5786,7 +6597,7 @@ so you rarely have to call this yourself.
</description>
<parameters>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> a #GCancellable object
</parameter_description>
</parameter>
</parameters>
@@ -5878,18 +6689,21 @@ to handle @mime_type.
<function name="g_socket_set_keepalive">
<description>
-Setting @keepalive to %TRUE enables the sending of periodic ping requests
-on idle connections in order to keep the connection alive. This is only
-useful for connection oriented sockets. The exact period used between
-each ping is system and protocol dependent.
+Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When
+this flag is set on a socket, the system will attempt to verify that the
+remote socket endpoint is still present if a sufficiently long period of
+time passes with no data being exchanged. If the system is unable to
+verify the presence of the remote endpoint, it will automatically close
+the connection.
-Sending keepalive requests like this has a few disadvantages. For instance,
-it uses more network bandwidth, and it makes your application more sensitive
-to temporary outages in the network (i.e. if a cable is pulled your otherwise
-idle connection could be terminated, whereas otherwise it would survive unless
-actually used before the cable was reinserted). However, it is sometimes
-useful to ensure that connections are eventually terminated if e.g. the
-remote side is disconnected, so as to avoid leaking resources forever.
+This option is only functional on certain kinds of sockets. (Notably,
+%G_SOCKET_PROTOCOL_TCP sockets.)
+
+The exact time between pings is system- and protocol-dependent, but will
+normally be at least two hours. Most commonly, you would set this flag
+on a server socket if you want to allow clients to remain idle for long
+periods of time, but also want to ensure that connections are eventually
+garbage-collected if clients crash or become unreachable.
Since: 2.22
@@ -5900,7 +6714,7 @@ Since: 2.22
</parameter_description>
</parameter>
<parameter name="keepalive">
-<parameter_description> Whether to use try to keep the connection alive or not.
+<parameter_description> Value for the keepalive flag
</parameter_description>
</parameter>
</parameters>
@@ -5909,6 +6723,7 @@ Since: 2.22
<function name="g_unix_fd_message_steal_fds">
<description>
+Returns: an array of file descriptors
</description>
<parameters>
@@ -5922,23 +6737,8 @@ Since: 2.22
</parameter>
</parameters>
<return> an array of file descriptors
-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
</return>
</function>
@@ -5977,11 +6777,11 @@ Since: 2.18
<function name="g_socket_condition_wait">
<description>
-Waits for @condition to become true on @socket. When the condition
-becomes true, %TRUE is returned.
+Waits for @condition to become true on @socket. When the condition
+is met, %TRUE is returned.
-If @cancellable is cancelled before the condition becomes true 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 then %FALSE
+is returned and @error, if non-%NULL, is set to %G_IO_ERROR_CANCELLED.
</description>
@@ -6149,11 +6949,10 @@ doesn't have this kind of identifier.
<function name="GThreadedSocketService">
<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
+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.
-If %TRUE is returned then no other handlers are called.
</description>
<parameters>
@@ -6170,7 +6969,51 @@ If %TRUE is returned then no other handlers are called.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @connection has been handled.
+<return> %TRUE to stope further signal handlers from being called
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_service">
+<description>
+Attempts to create a TCP connection to a service.
+
+This call looks up the SRV record for @service at @domain for the
+"tcp" protocol. It then attempts to connect, in turn, to each of
+the hosts providing the service until either a connection succeeds
+or there are no hosts remaining.
+
+Upon a successful connection, a new #GSocketConnection is constructed
+and returned. The caller owns this new object and must drop their
+reference to it when finished with it.
+
+In the event of any failure (DNS error, service not found, no hosts
+connectable) %NULL is returned and @error (if non-%NULL) is set
+accordingly.
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketConnection
+</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="error">
+<parameter_description> a pointer to a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection if successful, or %NULL on error
</return>
</function>
@@ -6196,21 +7039,29 @@ attribute does not contain a signed 32-bit integer, or is invalid,
</return>
</function>
-<function name="g_network_service_get_service">
+<function name="g_socket_speaks_ipv4">
<description>
-Gets @srv's service name (eg, "ldap").
+Checks if a socket is capable of speaking IPv4.
+
+IPv4 sockets are capable of speaking IPv4. On some operating systems
+and under some combinations of circumstances IPv6 sockets are also
+capable of speaking IPv4. See RFC 3493 section 3.7 for more
+information.
+
+No other types of sockets are currently considered as being capable
+of speaking IPv4.
</description>
<parameters>
-<parameter name="srv">
-<parameter_description> a #GNetworkService
+<parameter name="socket">
+<parameter_description> a #GSocket
</parameter_description>
</parameter>
</parameters>
-<return> @srv's service name
+<return> %TRUE if this socket can be used with IPv4.
-Since: 2.22
+Since: 2.22.
</return>
</function>
@@ -6224,12 +7075,12 @@ already set or @stream is closed, it will return %FALSE and set
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream.
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> a #GError location to store the error occuring, or %NULL to
+ignore
</parameter_description>
</parameter>
</parameters>
@@ -6239,6 +7090,27 @@ Since: 2.22
</return>
</function>
+<function name="g_unix_fd_list_steal_fds">
+<description>
+Returns: an array of file descriptors
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GUnixFDList
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> pointer to the length of the returned array, or %NULL
+</parameter_description>
+</parameter>
+</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
@@ -6297,6 +7169,8 @@ with g_file_unmount_mountable().
</parameters>
<return> %TRUE if the operation finished successfully. %FALSE
otherwise.
+
+Deprecated: 2.22: Use g_file_unmount_mountable_with_operation_finish() instead.
</return>
</function>
@@ -6342,16 +7216,6 @@ in the @file, %FALSE otherwise.
</return>
</function>
-<function name="g_unix_volume_monitor_new">
-<description>
-
-</description>
-<parameters>
-</parameters>
-<return> a new #GVolumeMonitor.
-</return>
-</function>
-
<function name="g_volume_get_mount">
<description>
Gets the mount for the @volume.
@@ -6429,6 +7293,33 @@ of @prefix.
</return>
</function>
+<function name="g_unix_mount_point_get_device_path">
+<description>
+Gets the device path for a unix mount point.
+
+
+</description>
+<parameters>
+<parameter name="mount_point">
+<parameter_description> a #GUnixMountPoint.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the device path.
+</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
@@ -6479,6 +7370,8 @@ When the operation is finished, @callback will be called.
You can then call g_drive_eject_finish() to obtain the
result of the operation.
+Deprecated: 2.22: Use g_drive_eject_with_operation() instead.
+
</description>
<parameters>
<parameter name="drive">
@@ -6535,21 +7428,24 @@ string should be freed with g_free() when no longer needed.
</return>
</function>
-<function name="g_io_module_new">
+<function name="g_unix_socket_address_new">
<description>
-Creates a new GIOModule that will load the specific
-shared library when in use.
+Creates a new #GUnixSocketAddress for @path.
+
+To create abstract socket addresses, on systems that support that,
+use g_unix_socket_address_new_abstract().
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> filename of the shared library module.
+<parameter name="path">
+<parameter_description> the socket path
</parameter_description>
</parameter>
</parameters>
-<return> a #GIOModule from given @filename,
-or %NULL on error.
+<return> a new #GUnixSocketAddress
+
+Since: 2.22
</return>
</function>
@@ -6588,33 +7484,21 @@ Since: 2.22
<return></return>
</function>
-<function name="g_local_file_input_stream_new">
+<function name="g_drive_get_start_stop_type">
<description>
-
-</description>
-<parameters>
-<parameter name="fd">
-<parameter_description> File Descriptor.
-</parameter_description>
-</parameter>
-</parameters>
-<return> #GFileInputStream for the given file descriptor.
-</return>
-</function>
-
-<function name="g_filter_input_stream_get_base_stream">
-<description>
-Gets the base stream for the filter stream.
+Gets a hint about how a drive can be started/stopped.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterInputStream.
+<parameter name="drive">
+<parameter_description> a #GDrive.
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream.
+<return> A value from the #GDriveStartStopType enumeration.
+
+Since: 2.22
</return>
</function>
@@ -6716,11 +7600,11 @@ g_file_create_readwrite_async().
</description>
<parameters>
<parameter name="file">
-<parameter_description> input #GFile.
+<parameter_description> input #GFile
</parameter_description>
</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> a #GAsyncResult
</parameter_description>
</parameter>
<parameter name="error">
@@ -6739,17 +7623,34 @@ Since: 2.22
<description>
Closes the socket, shutting down any active connection.
-Closing a socket does not wait for all outstanding I/O operations to finish,
-so the caller should not rely on them to be guaranteed to complete even
-if the close returns with no error.
+Closing a socket does not wait for all outstanding I/O operations
+to finish, so the caller should not rely on them to be guaranteed
+to complete even if the close returns with no error.
-Once the socket is closed, all other operations will return %G_IO_ERROR_CLOSED.
-Closing a stream multiple times will not return an error.
+Once the socket is closed, all other operations will return
+%G_IO_ERROR_CLOSED. Closing a socket multiple times will not
+return an error.
Sockets 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.
+Beware that due to the way that TCP works, it is possible for
+recently-sent data to be lost if either you close a socket while the
+%G_IO_IN condition is set, or else if the remote connection tries to
+send something to you after you close the socket but before it has
+finished reading all of the data you sent. There is no easy generic
+way to avoid this problem; the easiest fix is to design the network
+protocol such that the client will never send data "out of turn".
+Another solution is for the server to half-close the connection by
+calling g_socket_shutdown() with only the @shutdown_write flag set,
+and then wait for the client to notice this and close its side of the
+connection, after which the server can safely call g_socket_close().
+(This is what #GTcpConnection does if you call
+g_tcp_connection_set_graceful_disconnect(). But of course, this
+only works if the client will close its connection after the server
+does.)
+
</description>
<parameters>
@@ -6777,31 +7678,13 @@ Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> output stream
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_unix_volume_new">
-<description>
-
-</description>
-<parameters>
-<parameter name="volume_monitor">
-<parameter_description> a #GVolumeMonitor.
-</parameter_description>
-</parameter>
-<parameter name="mountpoint">
-<parameter_description> a #GUnixMountPoint.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GUnixVolume for the given #GUnixMountPoint.
-</return>
-</function>
-
<function name="g_file_monitor_set_rate_limit">
<description>
Sets the rate limit to which the @monitor will report
@@ -7006,8 +7889,8 @@ See g_socket_client_set_local_address() for details.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
</parameters>
@@ -7127,43 +8010,11 @@ Checks if the file enumerator has pending operations.
<function name="g_socket_send_to">
<description>
-Send data to @address on @socket. This is the most complicated and
-fully-featured version of this call. For easier use, see
-g_socket_send() and g_socket_send_to().
-
-If @address is %NULL then the message is sent to the default receiver
-(set by g_socket_connect()).
-
- vector must point to an array of #GOutputVector structs and
- num_vectors must be the length of this array. These structs
-describe the buffers that the sent data will be gathered from.
-If @num_vector is -1, then @vector is assumed to be terminated
-by a #GOutputVector with a %NULL buffer pointer.
-
-
- messages, if non-%NULL, is taken to point to an array of @num_messages
-#GSocketControlMessage instances. These correspond to the control
-messages to be sent on the socket.
-If @num_messages is -1 then @messages is treated as a %NULL-terminated
-array.
-
- flags modify how the message sent. The commonly available arguments
-for this is available in the #GSocketMsgFlags enum, but the
-values there are the same as the system values, and the flags
-are passed in as-is, so you can pass in system specific flags too.
-
-If the socket is in blocking mode the call will block until there is
-space for the data in the socket queue. If there is no space available
-and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified of available space, wait for the %G_IO_OUT
-condition.
+Tries to send @size bytes from @buffer to @address. If @address is
+%NULL then the message is sent to the default receiver (set by
+g_socket_connect()).
-Note that on Windows you can't rely on a %G_IO_OUT condition
-not producing a %G_IO_ERROR_WOULD_BLOCK error, as this is how Winsock
-write notification works. However, robust apps should always be able to
-handle this since it can easily appear in other cases too.
-
-On error -1 is returned and @error is set accordingly.
+See g_socket_send() for additional information.
</description>
@@ -7176,25 +8027,16 @@ On error -1 is returned and @error is set accordingly.
<parameter_description> a #GSocketAddress, or %NULL
</parameter_description>
</parameter>
-<parameter name="vectors">
-<parameter_description> an array of #GOutputVector structs
-</parameter_description>
-</parameter>
-<parameter name="num_vectors">
-<parameter_description> the number of elements in @vectors, or -1
-</parameter_description>
-</parameter>
-<parameter name="messages">
-<parameter_description> a pointer to an array of #GSocketControlMessages, or
-%NULL.
+<parameter name="buffer">
+<parameter_description> the buffer containing the data to send.
</parameter_description>
</parameter>
-<parameter name="num_messages">
-<parameter_description> number of elements in @messages, or -1.
+<parameter name="size">
+<parameter_description> the number of bytes to send
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> an int containing #GSocketMsgFlags flags
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
</parameter_description>
</parameter>
<parameter name="error">
@@ -7202,7 +8044,8 @@ On error -1 is returned and @error is set accordingly.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> Number of bytes written (which may be less than @size), or -1
+on error
Since: 2.22
</return>
@@ -7291,17 +8134,24 @@ 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
+Since: 2.20
</return>
</function>
-<function name="Adds">
+<function name="g_content_type_get_icon">
<description>
+Gets the icon for a content type.
+
</description>
<parameters>
+<parameter name="type">
+<parameter_description> a content type string.
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> #GIcon corresponding to the content type.
+</return>
</function>
<function name="SECTION">
@@ -7328,6 +8178,68 @@ writing data directly to an output stream.
<return></return>
</function>
+<function name="g_file_eject_mountable_with_operation">
+<description>
+Starts an asynchronous eject on a mountable.
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_eject_mountable_with_operation_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.
+
+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_unix_mounts_get">
+<description>
+Gets a #GList of strings containing the unix mounts.
+If @time_read is set, it will be filled with the mount
+timestamp, allowing for checking if the mounts have changed
+with g_unix_mounts_changed_since().
+
+
+</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>
+</function>
+
<function name="g_socket_set_listen_backlog">
<description>
Sets the maximum number of outstanding connections allowed
@@ -7335,6 +8247,9 @@ when listening on this socket. If more clients than this are
connecting to the socket and the application is not handling them
on time then the new connections will be refused.
+Note that this must be called before g_socket_listen() and has no
+effect if called after that.
+
Since: 2.22
</description>
@@ -7371,29 +8286,11 @@ Since: 2.22
</return>
</function>
-<function name="_g_local_directory_monitor_new">
-<description>
-
-</description>
-<parameters>
-<parameter name="dirname">
-<parameter_description> filename of the directory to monitor.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> #GFileMonitorFlags.
-</parameter_description>
-</parameter>
-</parameters>
-<return> new #GFileMonitor for the given @dirname.
-</return>
-</function>
-
<function name="GVolumeMonitor">
<description>
-Emitted when the eject button is pressed on @drive.
+Emitted when the stop button is pressed on @drive.
-Since: 2.18
+Since: 2.22
</description>
<parameters>
@@ -7402,7 +8299,7 @@ Since: 2.18
</parameter_description>
</parameter>
<parameter name="drive">
-<parameter_description> the drive where the eject button was pressed
+<parameter_description> the drive where the stop button was pressed
</parameter_description>
</parameter>
</parameters>
@@ -7426,42 +8323,19 @@ the choice's list, or %0.
</return>
</function>
-<function name="g_data_input_stream_read_until_async">
+<function name="g_file_info_set_icon">
<description>
-The asynchronous version of g_data_input_stream_read_until().
-It is an error to have two outstanding calls to this function.
-
-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
+Sets the icon for a given #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_ICON.
</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 name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function.
+<parameter name="icon">
+<parameter_description> a #GIcon.
</parameter_description>
</parameter>
</parameters>
@@ -7490,7 +8364,7 @@ Creates a #GSocketConnection subclass of the right type for
</description>
<parameters>
<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter_description> a #GSocket
</parameter_description>
</parameter>
</parameters>
@@ -7562,22 +8436,17 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</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.
</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
+
+Since: 2.24
</return>
</function>
@@ -7620,17 +8489,48 @@ Since: 2.20
</return>
</function>
+<function name="g_file_unmount_mountable_with_operation_finish">
+<description>
+Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details.
+
+Finish an asynchronous unmount operation that was started
+with g_file_unmount_mountable_with_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_description>
+</parameter>
+</parameters>
+<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
+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">
@@ -7647,6 +8547,8 @@ system-wide file descriptor limit.
</parameter>
</parameters>
<return> %TRUE in case of success, else %FALSE (and @error is set)
+
+Since: 2.22
</return>
</function>
@@ -7711,6 +8613,49 @@ or one of its subtypes.
<return></return>
</function>
+<function name="g_file_set_attribute_byte_string">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
+If @attribute is of a different type, this operation will fail,
+returning %FALSE.
+
+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 string 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_file_monitor_is_cancelled">
<description>
Returns: %TRUE if monitor is canceled. %FALSE otherwise.
@@ -7734,16 +8679,16 @@ Closes a stream.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream.
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter_description> a #GAsyncResult
</parameter_description>
</parameter>
<parameter name="error">
<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+ignore
</parameter_description>
</parameter>
</parameters>
@@ -7753,6 +8698,44 @@ Since: 2.22
</return>
</function>
+<function name="g_mount_unmount_with_operation">
+<description>
+Unmounts a mount. This is an asynchronous operation, and is
+finished by calling g_mount_unmount_with_operation_finish() with the @mount
+and #GAsyncResult data returned in the @callback.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_connection_factory_lookup_type">
<description>
Looks up the #GType to be used when creating socket connections on
@@ -7764,7 +8747,7 @@ If no type is registered, the #GSocketConnection base type is returned.
</description>
<parameters>
<parameter name="family">
-<parameter_description> a #GSocketFamily.
+<parameter_description> a #GSocketFamily
</parameter_description>
</parameter>
<parameter name="type">
@@ -7777,6 +8760,7 @@ If no type is registered, the #GSocketConnection base type is returned.
</parameter>
</parameters>
<return> a #GType
+
Since: 2.22
</return>
</function>
@@ -7831,7 +8815,7 @@ Checks if a stream is closed.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream.
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
</parameters>
@@ -7841,6 +8825,48 @@ Since: 2.22
</return>
</function>
+<function name="g_socket_shutdown">
+<description>
+Shut down part of a full-duplex connection.
+
+If @shutdown_read is %TRUE then the recieving side of the connection
+is shut down, and further reading is disallowed.
+
+If @shutdown_write is %TRUE then the sending side of the connection
+is shut down, and further writing is disallowed.
+
+It is allowed for both @shutdown_read and @shutdown_write to be %TRUE.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="shutdown_read">
+<parameter_description> whether to shut down the read side
+</parameter_description>
+</parameter>
+<parameter name="shutdown_write">
+<parameter_description> whether to shut down the write side
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_file_get_relative_path">
<description>
Gets the path for @descendant relative to @parent.
@@ -7899,6 +8925,67 @@ Gets the installed name of the application.
</return>
</function>
+<function name="g_file_stop_mountable_finish">
+<description>
+Finishes an stop operation, see g_file_stop_mountable() for details.
+
+Finish an asynchronous stop operation that was started
+with g_file_stop_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> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+Since: 2.22
+</return>
+</function>
+
+<function name="g_file_info_set_attribute_status">
+<description>
+Sets the attribute status for an attribute key. This is only
+needed by external code that implement g_file_set_attributes_from_info()
+or similar functions.
+
+The attribute must exist in @info for this to work. Otherwise %FALSE
+is returned and @info is unchanged.
+
+
+</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="status">
+<parameter_description> a #GFileAttributeStatus
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the status was changed, %FALSE if the key was not set.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_unix_is_mount_path_system_internal">
<description>
Determines if @mount_path is considered an implementation of the
@@ -7929,7 +9016,7 @@ Gets the top cancellable from the stack.
<parameters>
</parameters>
<return> a #GCancellable from the top of the stack, or %NULL
-if the stack is empty.
+if the stack is empty.
</return>
</function>
@@ -8001,26 +9088,50 @@ Gets the icon for the application.
</return>
</function>
-<function name="g_socket_check_pending_error">
+<function name="g_volume_get_activation_root">
<description>
-Checks and resets the pending error for the socket. This is typically
-used to check for errors when g_socket_connect() is used in non-blocking mode.
+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="socket">
-<parameter_description> a #GSocket
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="volume">
+<parameter_description> a #GVolume
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if no error, %FALSE otherwise, setting @error to the error
+<return> the activation root of @volume or %NULL. Use
+g_object_unref() to free.
-Since: 2.22
+Since: 2.18
</return>
</function>
@@ -8044,14 +9155,14 @@ operation if the @parse_name cannot be parsed.
<function name="g_file_replace_readwrite_async">
<description>
-Asynchronously overwrites the file in read-write mode, replacing the contents,
-possibly creating a backup copy of the file first.
+Asynchronously overwrites the file in read-write mode, replacing the
+contents, possibly creating a backup copy of the file first.
For more details, see g_file_replace_readwrite() which is
the synchronous version of this call.
-When the operation is finished, @callback will be called. You can then call
-g_file_replace_readwrite_finish() to get the result of the operation.
+When the operation is finished, @callback will be called. You can then
+call g_file_replace_readwrite_finish() to get the result of the operation.
Since: 2.22
@@ -8131,6 +9242,8 @@ Ejects a volume. This is an asynchronous operation, and is
finished by calling g_volume_eject_finish() with the @volume
and #GAsyncResult returned in the @callback.
+Deprecated: 2.22: Use g_volume_eject_with_operation() instead.
+
</description>
<parameters>
<parameter name="volume">
@@ -8173,32 +9286,38 @@ Polls @file for changes.
</return>
</function>
-<function name="g_simple_async_result_new">
+<function name="g_data_input_stream_read_until">
<description>
-Creates a #GSimpleAsyncResult.
+Reads a string from the data input stream, up to the first
+occurrence of any of the stop characters.
</description>
<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject the asynchronous function was called with,
-or %NULL.
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
+<parameter name="stop_chars">
+<parameter_description> characters to terminate the read.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
</parameter_description>
</parameter>
-<parameter name="source_tag">
-<parameter_description> the asynchronous function.
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSimpleAsyncResult.
+<return> a string with the data that was read before encountering
+any of the stop characters. Set @length to a #gsize to get the length
+of the string. This function will return %NULL on an error.
</return>
</function>
@@ -8288,32 +9407,33 @@ Gets the local #GVfs for the system.
<function name="g_async_initable_init_async">
<description>
-Starts asynchronous initialization of the object implementing the interface.
-This must be done before any real use of the object after initial construction.
-If the object also implements #GInitable you can optionally call g_initable_init()
-instead.
+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.
+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
+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
+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
+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 its safe to implement the singleton
+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
+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
@@ -8466,6 +9586,24 @@ when no longer needed.
</return>
</function>
+<function name="g_charset_converter_get_use_fallback">
+<description>
+Gets the #GCharsetConverter:use-fallback property.
+
+
+</description>
+<parameters>
+<parameter name="converter">
+<parameter_description> a #GCharsetConverter
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if fallbacks are used by @converter
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_file_info_get_attribute_data">
<description>
Gets the attribute type, value and status for an attribute key.
@@ -8515,6 +9653,137 @@ Tests if the stream can be truncated.
</return>
</function>
+<function name="g_converter_convert">
+<description>
+This is the main operation used when converting data. It is to be called
+multiple times in a loop, and each time it will do some work, i.e.
+producing some output (in @outbuf) or consuming some input (from @inbuf) or
+both. If its not possible to do any work an error is returned.
+
+Note that a single call may not consume all input (or any input at all).
+Also a call may produce output even if given no input, due to state stored
+in the converter producing output.
+
+If any data was either produced or consumed, and then an error happens, then
+only the successful conversion is reported and the error is returned on the
+next call.
+
+A full conversion loop involves calling this method repeatedly, each time
+giving it new input and space output space. When there is no more input
+data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
+The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
+each time until all data is consumed and all output is produced, then
+%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
+may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
+in a decompression converter where the end of data is detectable from the
+data (and there might even be other data after the end of the compressed data).
+
+When some data has successfully been converted @bytes_read and is set to
+the number of bytes read from @inbuf, and @bytes_written is set to indicate
+how many bytes was written to @outbuf. If there are more data to output
+or consume (i.e. unless the G_CONVERTER_INPUT_AT_END is specified) then
+G_CONVERTER_CONVERTED is returned, and if no more data is to be output
+then G_CONVERTER_FINISHED is returned.
+
+On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
+Some errors need special handling:
+
+%G_IO_ERROR_NO_SPACE is returned if there is not enough space
+to write the resulting converted data, the application should
+call the function again with a larger @outbuf to continue.
+
+%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
+input to fully determine what the conversion should produce,
+and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
+example with an incomplete multibyte sequence when converting text,
+or when a regexp matches up to the end of the input (and may match
+further input). It may also happen when @inbuf_size is zero and
+there is no more data to produce.
+
+When this happens the application should read more input and then
+call the function again. If further input shows that there is no
+more data call the function again with the same data but with
+the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
+to finish as e.g. in the regexp match case (or, to fail again with
+%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
+input is actually partial).
+
+After g_converter_convert() has returned %G_CONVERTER_FINISHED the
+converter object is in an invalid state where its not allowed
+to call g_converter_convert() anymore. At this time you can only
+free the object or call g_converter_reset() to reset it to the
+initial state.
+
+If the flag %G_CONVERTER_FLUSH is set then conversion is modified
+to try to write out all internal state to the output. The application
+has to call the function multiple times with the flag set, and when
+the availible input has been consumed and all internal state has
+been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
+really at the end) is returned instead of %G_CONVERTER_CONVERTED.
+This is somewhat similar to what happens at the end of the input stream,
+but done in the middle of the data.
+
+This has different meanings for different conversions. For instance
+in a compression converter it would mean that we flush all the
+compression state into output such that if you uncompress the
+compressed data you get back all the input data. Doing this may
+make the final file larger due to padding though. Another example
+is a regexp conversion, where if you at the end of the flushed data
+have a match, but there is also a potential longer match. In the
+non-flushed case we would ask for more input, but when flushing we
+treat this as the end of input and do the match.
+
+Flushing is not always possible (like if a charset converter flushes
+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).
+
+
+</description>
+<parameters>
+<parameter name="converter">
+<parameter_description> a #GConverter.
+</parameter_description>
+</parameter>
+<parameter name="inbuf">
+<parameter_description> the buffer containing the data to convert.
+</parameter_description>
+</parameter>
+<parameter name="inbuf_size">
+<parameter_description> the number of bytes in @inbuf
+</parameter_description>
+</parameter>
+<parameter name="outbuf">
+<parameter_description> a buffer to write converted data in.
+</parameter_description>
+</parameter>
+<parameter name="outbuf_size">
+<parameter_description> the number of bytes in @outbuf, must be at least one
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GConvertFlags controlling the conversion details
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> will be set to the number of bytes read from @inbuf on success
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> will be set to the number of bytes written to @outbuf on success
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occuring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GConverterResult, %G_CONVERTER_ERROR on error.
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_output_stream_splice_async">
<description>
Splices a stream asynchronously.
@@ -8664,20 +9933,55 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
+<function name="g_socket_client_connect_to_service_finish">
+<description>
+Finishes an async connect operation. See g_socket_client_connect_to_service_async()
+
+
+</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.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_socket_receive">
<description>
Receive data (up to @size bytes) from a socket. This is mainly used by
-connection oriented sockets, it is identical to g_socket_receive_from()
+connection-oriented sockets; it is identical to g_socket_receive_from()
with @address set to %NULL.
-If a message is too long to fit in @buffer, excess bytes may be discarded
-depending on the type of socket the message is received from.
+For %G_SOCKET_TYPE_DATAGRAM and %G_SOCKET_TYPE_SEQPACKET sockets,
+g_socket_receive() will always read either 0 or 1 complete messages from
+the socket. If the received message is too large to fit in @buffer, then
+the data beyond @size bytes will be discarded, without any explicit
+indication that this has occurred.
+
+For %G_SOCKET_TYPE_STREAM sockets, g_socket_receive() can return any
+number of bytes, up to @size. If more than @size bytes have been
+received, the additional data will be returned in future calls to
+g_socket_receive().
If the socket is in blocking mode the call will block until there is
some data to receive or there is an error. If there is no data available
-and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified of available data, wait for the %G_IO_IN
-condition.
+and the socket is in non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error
+will be returned. To be notified when data is available, wait for the
+%G_IO_IN condition.
On error -1 is returned and @error is set accordingly.
@@ -8689,11 +9993,16 @@ On error -1 is returned and @error is set accordingly.
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least count bytes long).
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> the number of bytes that will be read from the stream
+<parameter_description> the number of bytes you want to read from the socket
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
</parameter_description>
</parameter>
<parameter name="error">
@@ -8727,6 +10036,24 @@ Since: 2.22
</return>
</function>
+<function name="g_unix_socket_address_get_is_abstract">
+<description>
+Gets @address's path.
+
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the address is abstract, %FALSE otherwise
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_io_extension_get_name">
<description>
Gets the name under which @extension was registered.
@@ -8804,6 +10131,8 @@ Finishes ejecting a drive.
</parameters>
<return> %TRUE if the drive has been ejected successfully,
%FALSE otherwise.
+
+Deprecated: 2.22: Use g_drive_eject_with_operation_finish() instead.
</return>
</function>
@@ -8850,6 +10179,27 @@ Gets the size of the input buffer.
</return>
</function>
+<function name="g_unix_fd_list_peek_fds">
+<description>
+Returns: an array of file descriptors
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GUnixFDList
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> pointer to the length of the returned array, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> an array of file descriptors
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_file_load_partial_contents_async">
<description>
Reads the partial contents of a file. A #GFileReadMoreCallback should be
@@ -8890,9 +10240,45 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<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.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="name_space">
+<parameter_description> a file attribute namespace.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @Ginfo has an attribute in @name_space,
+%FALSE otherwise.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_app_info_can_delete">
<description>
-Obtains the information whether the GAppInfo can be deleted.
+Obtains the information whether the #GAppInfo can be deleted.
See g_app_info_delete().
@@ -8909,51 +10295,42 @@ Since: 2.20
</return>
</function>
-<function name="g_output_stream_splice_finish">
+<function name="g_drive_eject_with_operation">
<description>
-Finishes an asynchronous stream splice operation.
+Ejects a drive. This is an asynchronous operation, and is
+finished by calling g_drive_eject_with_operation_finish() with the @drive
+and #GAsyncResult data returned in the @callback.
+Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter name="drive">
+<parameter_description> a #GDrive.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for eject
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
</parameter_description>
</parameter>
-</parameters>
-<return> a #gssize of the number of bytes spliced.
-</return>
-</function>
-
-<function name="g_winhttp_file_input_stream_new">
-<description>
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> the GWinHttpFile being read
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="connection">
-<parameter_description> handle to the HTTP connection, as from WinHttpConnect()
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
</parameter_description>
</parameter>
-<parameter name="request">
-<parameter_description> handle to the HTTP request, as from WinHttpOpenRequest
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInputStream for the given request
-</return>
+<return></return>
</function>
<function name="g_srv_target_new">
@@ -9053,6 +10430,8 @@ 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">
@@ -9094,8 +10473,8 @@ Since: 2.22
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
<parameter name="family">
@@ -9131,6 +10510,51 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_file_start_mountable">
+<description>
+Starts a file of type G_FILE_TYPE_MOUNTABLE.
+Using @start_operation, you can request callbacks when, for instance,
+passwords are needed during authentication.
+
+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_mount_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="start_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_app_info_get_default_for_uri_scheme">
<description>
Gets the default application for launching applications
@@ -9218,6 +10642,55 @@ Since: 2.22
</return>
</function>
+<function name="g_async_initable_new_valist_async">
+<description>
+Helper function for constructing #GAsyncInitiable object. This is
+similar to g_object_new_valist() 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="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="var_args">
+<parameter_description> The var args list generated from @first_property_name.
+</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>
+</parameters>
+<return></return>
+</function>
+
<function name="g_network_service_get_protocol">
<description>
Gets @srv's protocol name (eg, "tcp").
@@ -9238,12 +10711,16 @@ Since: 2.22
<function name="g_unix_fd_message_new">
<description>
-Creates a new #GUnixFDMessage containing no file descriptors.
+Creates a new #GUnixFDMessage containing an empty file descriptor
+list.
+
</description>
<parameters>
</parameters>
<return> a new #GUnixFDMessage
+
+Since: 2.22
</return>
</function>
@@ -9259,12 +10736,50 @@ Gets @addr's port number
</parameter_description>
</parameter>
</parameters>
-<return> @addr's port (which may be %0)
+<return> @addr's port (which may be 0)
Since: 2.22
</return>
</function>
+<function name="g_unix_fd_list_append">
+<description>
+Adds a file descriptor to @list.
+
+The file descriptor is duplicated using dup(). You keep your copy
+of the descriptor and the copy contained in @list will be closed
+when @list is finalized.
+
+A possible cause of failure is exceeding the per-process or
+system-wide file descriptor limit.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GUnixFDList
+</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> 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">
<description>
Puts an unsigned 16-bit integer into the output stream.
@@ -9325,11 +10840,11 @@ Since: 2.22
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
-<parameter name="addres">
+<parameter name="address">
<parameter_description> a #GSocketAddress, or %NULL
</parameter_description>
</parameter>
@@ -9339,10 +10854,10 @@ Since: 2.22
<function name="g_simple_async_result_complete">
<description>
-Completes an asynchronous I/O job.
-Must be called in the main thread, as it invokes the callback that
-should be called in the main thread. If you are in a different thread
-use g_simple_async_result_complete_in_idle().
+Completes an asynchronous I/O job immediately. Must be called in
+the thread where the asynchronous result was to be delivered, as it
+invokes the callback directly. If you are in a different thread use
+g_simple_async_result_complete_in_idle().
</description>
<parameters>
@@ -9470,9 +10985,9 @@ to g_icon_hash().
<function name="g_socket_listener_add_socket">
<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.
+Adds @socket to the set of sockets that we try to accept
+new clients from. The socket must be bound to a local
+address and listened to.
@source_object will be passed out in the various calls
to accept to identify this particular source, which is
@@ -9486,16 +11001,8 @@ different things depending on what address is connected to.
<parameter_description> a #GSocketListener
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddres
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a #GSocketType
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> a protocol name, or %NULL
+<parameter name="socket">
+<parameter_description> a listening #GSocket
</parameter_description>
</parameter>
<parameter name="source_object">
@@ -9513,9 +11020,32 @@ 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: and int describing the level
+Returns: an integer describing the type of control message
</description>
<parameters>
@@ -9524,7 +11054,7 @@ Returns: and int describing the level
</parameter_description>
</parameter>
</parameters>
-<return> and int describing the level
+<return> an integer describing the type of control message
Since: 2.22
</return>
@@ -9572,49 +11102,49 @@ Creates a new buffered output stream with a given buffer size.
</return>
</function>
-<function name="g_data_input_stream_read_uint64">
+<function name="g_async_initable_new_async">
<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().
+Helper function for constructing #GAsyncInitiable object. This is
+similar to g_object_new() but also initializes the object asynchronously.
-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 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="stream">
-<parameter_description> a given #GDataInputStream.
+<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="error">
-<parameter_description> #GError for error reporting.
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the initialization is
+finished
</parameter_description>
</parameter>
-</parameters>
-<return> an unsigned 64-bit/8-byte read from @stream or %0 if
-an error occurred.
-</return>
-</function>
-
-<function name="g_unix_volume_unset_mount">
-<description>
-
-</description>
-<parameters>
-<parameter name="volume">
-<parameter_description>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
-<parameter name="mount">
-<parameter_description>
+<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>
@@ -9639,52 +11169,25 @@ Since: 2.18
</return>
</function>
-<function name="g_input_stream_read">
+<function name="g_emblem_new_with_origin">
<description>
-Tries to read @count bytes from the stream into the buffer starting at
- buffer Will block during this read.
-
-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 read into the buffer is returned.
-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. Zero is returned on end of file
-(or if @count is zero), but never otherwise.
-
-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.
+Creates a new emblem for @icon.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least count bytes long).
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="icon">
+<parameter_description> a GIcon containing the icon.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> 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> Number of bytes read, or -1 on error
+<return> a new #GEmblem.
+
+Since: 2.18
</return>
</function>
@@ -10067,7 +11570,7 @@ ignore.
</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
+g_list_free() and unref the infos with g_object_unref() when you're
done with them.
</return>
</function>
@@ -10132,50 +11635,21 @@ Return value: %TRUE if the base stream will be closed.
</return>
</function>
-<function name="g_volume_get_activation_root">
+<function name="g_unix_fd_message_new_with_fd_list">
<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.
+Creates a new #GUnixFDMessage containing @list.
</description>
<parameters>
-<parameter name="volume">
-<parameter_description> a #GVolume
+<parameter name="fd_list">
+<parameter_description> a #GUnixFDList
</parameter_description>
</parameter>
</parameters>
-<return> the activation root of @volume or %NULL. Use
-g_object_unref() to free.
+<return> a new #GUnixFDMessage
-Since: 2.18
+Since: 2.24
</return>
</function>
@@ -10200,13 +11674,30 @@ the data to the underlying stream.
<return></return>
</function>
-<function name="fdata_add_event">
+<function name="g_memory_output_stream_get_size">
<description>
+Gets the size of the currently allocated data area (availible from
+g_memory_output_stream_get_data()). If the stream isn't
+growable (no realloc was passed to g_memory_output_stream_new()) then
+this is the maximum size of the stream and further writes
+will return %G_IO_ERROR_NO_SPACE.
+
+Note that for growable streams the returned size may become invalid on
+the next write or truncate operation on the stream.
+
+If you want the number of bytes currently written to the stream, use
+g_memory_output_stream_get_data_size().
+
</description>
<parameters>
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> the number of bytes allocated for the data buffer
+</return>
</function>
<function name="g_unix_mount_is_system_internal">
@@ -10246,7 +11737,6 @@ or g_socket_listener_add_inet_port().
<parameters>
</parameters>
<return> a new #GSocketService.
- a new #GSocketService.
Since: 2.22
</return>
@@ -10270,9 +11760,9 @@ Gets the file's content type.
<function name="g_unix_connection_receive_fd">
<description>
-Recieves a file descriptor from the sending end of the
-connection. The sending end has to call g_unix_connection_send_fd()
-for this to work.
+Receives a file descriptor from the sending end of the connection.
+The sending end has to call g_unix_connection_send_fd() for this
+to work.
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
@@ -10282,15 +11772,15 @@ implementations.
</description>
<parameters>
<parameter name="connection">
-<parameter_description> a #GUnixConnection.
+<parameter_description> a #GUnixConnection
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> #GError for error reporting, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
@@ -10333,17 +11823,54 @@ error handling.
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter_description> a #GAsyncResult
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
<return> a #GSocketAddress (owned by the caller), or %NULL on
-error (in which case * error will be set) or if there are no more
-addresses.
+error (in which case * error will be set) or if there are no
+more addresses.
+</return>
+</function>
+
+<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.
+
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> the abstract name
+</parameter_description>
+</parameter>
+<parameter name="path_len">
+<parameter_description> the length of @path, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GUnixSocketAddress
+
+Since: 2.22
</return>
</function>
@@ -10380,19 +11907,20 @@ Sets an error within the asynchronous result without a #GError.
<function name="g_socket_connection_factory_register_type">
<description>
Looks up the #GType to be used when creating socket connections on
-sockets with the specified @family,@type and @protocol_id.
+sockets with the specified @family,@type and @protocol.
If no type is registered, the #GSocketConnection base type is returned.
+Since: 2.22
</description>
<parameters>
<parameter name="g_type">
-<parameter_description> a #GType, inheriting from G_SOCKET_CONNECTION
+<parameter_description> a #GType, inheriting from %G_TYPE_SOCKET_CONNECTION
</parameter_description>
</parameter>
<parameter name="family">
-<parameter_description> a #GSocketFamily.
+<parameter_description> a #GSocketFamily
</parameter_description>
</parameter>
<parameter name="type">
@@ -10404,24 +11932,42 @@ If no type is registered, the #GSocketConnection base type is returned.
</parameter_description>
</parameter>
</parameters>
-<return> a #GType
-Since: 2.22
-</return>
+<return></return>
</function>
-<function name="g_unix_mount_point_get_device_path">
+<function name="g_socket_control_message_deserialize">
<description>
-Gets the device path for a unix mount point.
+Tries to deserialize a socket control message of a given
+ level and @type. This will ask all known (to GType) subclasses
+of #GSocketControlMessage if they can understand this kind
+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.
</description>
<parameters>
-<parameter name="mount_point">
-<parameter_description> a #GUnixMountPoint.
+<parameter name="level">
+<parameter_description> a socket level
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a socket control message type for the given @level
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of the data in bytes
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> pointer to the message data
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the device path.
+<return> the deserialized message or %NULL
+
+Since: 2.22
</return>
</function>
@@ -10443,6 +11989,38 @@ 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>
+
<function name="g_file_info_set_modification_time">
<description>
Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
@@ -10480,19 +12058,20 @@ Removes all cases of @attribute from @info if it exists.
<return></return>
</function>
-<function name="g_data_input_stream_new">
+<function name="g_file_info_get_sort_order">
<description>
-Creates a new data input stream for the @base_stream.
+Gets the value of the sort_order attribute from the #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GInputStream.
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDataInputStream.
+<return> a #gint32 containing the value of the "standard::sort_order" attribute.
</return>
</function>
@@ -10505,8 +12084,8 @@ See g_socket_client_set_socket_type() for details.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
</parameters>
@@ -10529,7 +12108,7 @@ Gets the executable's name for the installed application.
</parameter>
</parameters>
<return> a string containing the @appinfo's application
-binary's name
+binaries name
</return>
</function>
@@ -10599,63 +12178,33 @@ not contain a string, %NULL will be returned.
</return>
</function>
-<function name="g_file_replace_contents_async">
+<function name="g_simple_async_result_new">
<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.
+Creates a #GSimpleAsyncResult.
-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 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 to call when the request is satisfied
+<parameter_description> a #GAsyncReadyCallback.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<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_equals">
@@ -10721,6 +12270,8 @@ g_file_eject_mountable().
</parameters>
<return> %TRUE if the @file was ejected successfully. %FALSE
otherwise.
+
+Deprecated: 2.22: Use g_file_eject_mountable_with_operation_finish() instead.
</return>
</function>
@@ -10775,16 +12326,17 @@ address (sometimes called name) of the socket.
It is generally required to bind to a local address before you can
receive connections. (See g_socket_listen() and g_socket_accept() ).
+In certain situations, you may also want to bind a socket that will be
+used to initiate connections, though this is not normally required.
-If @allow_reuse is %TRUE this allows the bind call to succeed in some
-situation where it would otherwise return a %G_IO_ERROR_ADDRESS_IN_USE
-error. The main example is for a TCP server socket where there are
-outstanding connections in the WAIT state, which are generally safe
-to ignore. However, setting it to %TRUE doesn't mean the call will
-succeed if there is a socket actively bound to the address.
-
-In general, pass %TRUE if the socket will be used to accept connections,
-otherwise pass %FALSE.
+ allow_reuse should be %TRUE for server sockets (sockets that you will
+eventually call g_socket_accept() on), and %FALSE for client sockets.
+(Specifically, if it is %TRUE, then g_socket_bind() will set the
+%SO_REUSEADDR flag on the socket, allowing it to bind @address even if
+that address was previously used by another socket that has not yet been
+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.)
</description>
@@ -10814,7 +12366,7 @@ Since: 2.22
<function name="g_app_info_set_as_default_for_extension">
<description>
-Sets the application as the default handler for the given file extention.
+Sets the application as the default handler for the given file extension.
</description>
@@ -10898,7 +12450,7 @@ implementations.
</description>
<parameters>
<parameter name="connection">
-<parameter_description> a #GUnixConnection.
+<parameter_description> a #GUnixConnection
</parameter_description>
</parameter>
<parameter name="fd">
@@ -10945,24 +12497,6 @@ ignore.
</return>
</function>
-<function name="g_local_file_monitor_new">
-<description>
-
-</description>
-<parameters>
-<parameter name="pathname">
-<parameter_description> path name to monitor.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> #GFileMonitorFlags.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GFileMonitor for the given @pathname.
-</return>
-</function>
-
<function name="g_resolver_lookup_by_address_finish">
<description>
Retrieves the result of a previous call to
@@ -11032,13 +12566,13 @@ Since: 2.22
<function name="g_cancellable_pop_current">
<description>
-Pops @cancellable off the cancellable stack (verifying that @cancellable
+Pops @cancellable off the cancellable stack (verifying that @cancellable
is on the top of the stack).
</description>
<parameters>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> a #GCancellable object
</parameter_description>
</parameter>
</parameters>
@@ -11053,11 +12587,12 @@ Gets the source object from a #GAsyncResult.
</description>
<parameters>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> a #GAsyncResult
</parameter_description>
</parameter>
</parameters>
-<return> the source object for the @res.
+<return> a new reference to the source object for the @res,
+or %NULL if there is none.
</return>
</function>
@@ -11451,6 +12986,20 @@ or -1 on error.
</return>
</function>
+<function name="g_unix_mount_point_free">
+<description>
+Frees a unix mount point.
+
+</description>
+<parameters>
+<parameter name="mount_point">
+<parameter_description> unix mount point to free.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="GInetSocketAddress">
<description>
An IPv4 or IPv6 socket address, corresponding to a <type>struct
@@ -11462,6 +13011,46 @@ sockaddr_in</type> or <type>struct sockaddr_in6</type>.
<return></return>
</function>
+<function name="g_drive_start">
+<description>
+Asynchronously starts a drive.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_start_finish() to obtain the
+result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the start operation.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_create_readwrite">
<description>
Creates a new file and returns a stream for reading and writing to it.
@@ -11476,40 +13065,37 @@ 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 a file or directory with this name already exists the G_IO_ERROR_EXISTS
-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.
+If a file or directory with this name already exists the %G_IO_ERROR_EXISTS
+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 too 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.
-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.
+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.
</description>
<parameters>
<parameter name="file">
-<parameter_description> input #GFile.
+<parameter_description> a #GFile
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<parameter_description> a set of #GFileCreateFlags
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream for the newly created file, or
-%NULL on error.
+<return> a #GFileIOStream for the newly created file, or %NULL on error.
Free the returned object with g_object_unref().
Since: 2.22
@@ -11529,12 +13115,12 @@ g_file_read_finish() to get the result of the operation.
</description>
<parameters>
<parameter name="file">
-<parameter_description> input #GFile.
+<parameter_description> input #GFile
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -11638,13 +13224,7 @@ If @address is non-%NULL then @address will be set equal to the
source address of the received packet.
@address is owned by the caller.
-If the socket is in blocking mode the call will block until there is
-some data to receive or there is an error. If there is no data available
-and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified of available data, wait for the %G_IO_IN
-condition.
-
-On error -1 is returned and @error is set accordingly.
+See g_socket_receive() for additional information.
</description>
@@ -11658,11 +13238,16 @@ On error -1 is returned and @error is set accordingly.
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least count bytes long).
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> the number of bytes that will be read from the stream
+<parameter_description> the number of bytes you want to read from the socket
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
</parameter_description>
</parameter>
<parameter name="error">
@@ -11692,6 +13277,30 @@ Tests if the stream supports the #GSeekableIface.
</return>
</function>
+<function name="g_file_info_get_attribute_stringv">
+<description>
+Gets the value of a stringv attribute. If the attribute does
+not contain a stringv, %NULL 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> the contents of the @attribute value as a stringv, or
+%NULL otherwise. Do not free.
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_file_info_set_attribute_object">
<description>
Sets the @attribute to contain the given @attr_value,
@@ -11717,7 +13326,7 @@ if possible.
<function name="g_file_replace">
<description>
-Returns: a #GFileIOStream or %NULL on error.
+Returns: a #GFileOutputStream or %NULL on error.
</description>
<parameters>
@@ -11726,7 +13335,7 @@ Returns: a #GFileIOStream or %NULL on error.
</parameter_description>
</parameter>
<parameter name="etag">
-<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
+<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
current #GFile, or #NULL to ignore.
</parameter_description>
</parameter>
@@ -11747,10 +13356,8 @@ current #GFile, or #NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream or %NULL on error.
+<return> a #GFileOutputStream or %NULL on error.
Free the returned object with g_object_unref().
-
-Since: 2.22
</return>
</function>
@@ -11839,10 +13446,9 @@ all keys in the unix namespace.</entry></row>
</return>
</function>
-<function name="port_remove">
+<function name="GCharsetConverter">
<description>
-< private >
-Unsafe, need lock fen_lock.
+Conversions between character sets.
</description>
<parameters>
@@ -11872,9 +13478,9 @@ with g_list_free().
<function name="g_socket_condition_check">
<description>
-Checks on the readiness of @socket to perform operations. The
-operations specified in @condition are checked for and masked
-against the currently-satisfied conditions on @socket. The result
+Checks on the readiness of @socket to perform operations.
+The operations specified in @condition are checked for and masked
+against the currently-satisfied conditions on @socket. The result
is returned.
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
@@ -11900,15 +13506,6 @@ Since: 2.22
</return>
</function>
-<function name="Get">
-<description>
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_srv_target_get_hostname">
<description>
Gets @target's hostname (in ASCII form; if you are going to present
@@ -11984,6 +13581,42 @@ 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
@@ -12018,11 +13651,15 @@ extension point, the existing #GIOExtension object is returned.
<function name="GResolver">
<description>
-The object that handles DNS resolution. Use g_resolver_get_default()
-to get the default resolver.
+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>
@@ -12091,7 +13728,7 @@ Gets the attribute type for an attribute key.
</parameter>
</parameters>
<return> a #GFileAttributeType for the given @attribute, or
-%G_FILE_ATTRIBUTE_TYPE_INVALID if the key is invalid.
+%G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set.
</return>
</function>
@@ -12150,6 +13787,44 @@ mount operation. See the #GMountOperation::ask-question signal.
<return></return>
</function>
+<function name="g_mount_eject_with_operation">
+<description>
+Ejects a mount. This is an asynchronous operation, and is
+finished by calling g_mount_eject_with_operation_finish() with the @mount
+and #GAsyncResult data returned in the @callback.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</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_file_create">
<description>
Creates a new file and returns an output stream for writing to it.
@@ -12224,25 +13899,6 @@ Appends @data to data that can be read from the input stream
<return></return>
</function>
-<function name="g_io_stream_get_output_stream">
-<description>
-Gets the output stream for this object. This is used for
-writing.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> input #GIOStream.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GOutputStream, owned by the #GIOStream do not free.
-
-Since: 2.22
-</return>
-</function>
-
<function name="g_content_type_get_description">
<description>
Gets the human readable description of the content type.
@@ -12481,42 +14137,59 @@ A single target host/port that a network service is running on.
<return></return>
</function>
-<function name="g_socket_protocol_id_lookup_by_name">
+<function name="g_file_replace_contents_async">
<description>
-Tries to look up the protocol id for a given
-protocol name. If the protocol name is not known
-on this system it returns -1.
+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 @protocol_name is %NULL (default protocol) then
-0 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.
+If @make_backup is %TRUE, this function will attempt to
+make a backup of @file.
</description>
<parameters>
-<parameter name="protocol_name">
-<parameter_description> The name of a protocol, or %NULL
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-</parameters>
-<return> a protocol id, or -1 if unknown
-
-Since: 2.22
-</return>
-</function>
-
-<function name="g_file_info_set_is_symlink">
-<description>
-Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
-See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
-
-</description>
-<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="contents">
+<parameter_description> string of contents to replace the file with.
</parameter_description>
</parameter>
-<parameter name="is_symlink">
-<parameter_description> a #gboolean.
+<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>
@@ -12589,17 +14262,17 @@ parsing @host_and_port fails.
@host_and_port may be in any of a number of recognised formats: an IPv6
address, an IPv4 address, or a domain name (in which case a DNS
-lookup is performed). Quoting with [] is supported for all address
-types. A port override may be specified in the usual way with a
-colon. Ports may be given as decimal numbers or symbolic names (in
+lookup is performed). Quoting with [] is supported for all address
+types. A port override may be specified in the usual way with a
+colon. Ports may be given as decimal numbers or symbolic names (in
which case an /etc/services lookup is performed).
If no port is specified in @host_and_port then @default_port will be
used as the port number to connect to.
-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.
+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.
</description>
@@ -12675,9 +14348,9 @@ 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
+If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
-was cancelled, the error G_IO_ERROR_CANCELLED will be returned.
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</description>
@@ -12739,34 +14412,39 @@ Since: 2.22
</return>
</function>
-<function name="Cancels">
+<function name="g_file_monitor">
<description>
+Obtains a file or directory monitor for the given file, depending
+on the type of the file.
-</description>
-<parameters>
-</parameters>
-<return></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().
+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="mount_path">
-<parameter_description> path for a possible unix mount.
+<parameter name="file">
+<parameter_description> input #GFile
</parameter_description>
</parameter>
-<parameter name="time_read">
-<parameter_description> guint64 to contain a timestamp.
+<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> a #GUnixMount.
+<return> a #GFileMonitor for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
+
+Since: 2.18
</return>
</function>
@@ -12879,31 +14557,21 @@ Gets the default #GVfs for the system.
</return>
</function>
-<function name="g_file_mount_mountable_finish">
+<function name="g_drive_can_start_degraded">
<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().
+Checks if a drive can be started degraded.
</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="drive">
+<parameter_description> a #GDrive.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile or %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the @drive can be started degraded, %FALSE otherwise.
+
+Since: 2.22
</return>
</function>
@@ -12938,7 +14606,9 @@ Emits the #GFileMonitor::changed signal if a change
has taken place. Should be called from file monitor
implementations only.
-The signal will be emitted from an idle handler.
+The signal will be emitted from an idle handler (in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+context</link>).
</description>
<parameters>
@@ -12971,77 +14641,52 @@ for reading.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> input #GIOStream.
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream, owned by the #GIOStream do not free.
+<return> a #GInputStream, owned by the #GIOStream. Do not free.
Since: 2.22
</return>
</function>
-<function name="g_async_initable_new_async">
+<function name="g_file_info_set_is_symlink">
<description>
-Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_new_valist() but also initializes the object asyncronously.
-
-When the initialization is finished, @callback will be called. You can then call
-g_async_initable_new_finish() to get new object and check for any errors.
-
-Since: 2.22
+Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
+See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GAsyncInitable.
-</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_description>
-</parameter>
-<parameter name="var_args">
-<parameter_description> The var args list generated from @first_property_name.
-</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 name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="is_symlink">
+<parameter_description> a #gboolean.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_content_type_can_be_executable">
+<function name="g_unix_socket_address_get_path_len">
<description>
-Checks if a content type can be executable. Note that for instance
-things like text files can be executables (i.e. scripts and batch files).
+Gets the length of @address's path.
+
+For details, see g_unix_socket_address_get_path().
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string.
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file type corresponds to a type that
-can be executable, %FALSE otherwise.
+<return> the length of the path
+
+Since: 2.22
</return>
</function>
@@ -13119,55 +14764,31 @@ When you're done with the string it must be freed with g_free().
</return>
</function>
-<function name="g_unix_volume_disconnected">
-<description>
-
-</description>
-<parameters>
-<parameter name="volume">
-<parameter_description>
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_socket_client_set_protocol">
<description>
Sets the protocol of the socket client.
The sockets created by this object will use of the specified
protocol.
-If @protocol is %NULL that means to use the default
+If @protocol is %0 that means to use the default
protocol for the socket family and type.
Since: 2.22
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
<parameter name="protocol">
-<parameter_description> a string, or %NULL
+<parameter_description> a #GSocketProtocol
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="get_viewable_logical_drives">
-<description>
-Return value: bitmask with same meaning as returned by GetLogicalDrives()
-
-</description>
-<parameters>
-</parameters>
-<return> bitmask with same meaning as returned by GetLogicalDrives()
-</return>
-</function>
-
<function name="g_file_info_set_attribute_mask">
<description>
Sets @mask on @info to match specific attribute types.
@@ -13192,6 +14813,8 @@ Unmounts a mount. This is an asynchronous operation, and is
finished by calling g_mount_unmount_finish() with the @mount
and #GAsyncResult data returned in the @callback.
+Deprecated: 2.22: Use g_mount_unmount_with_operation() instead.
+
</description>
<parameters>
<parameter name="mount">
@@ -13242,13 +14865,26 @@ When you are done with it, release it with g_object_unref()
</return>
</function>
-<function name="Adjust">
+<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></return>
+<return> a #GUnixMount.
+</return>
</function>
<function name="g_app_info_supports_files">
@@ -13341,23 +14977,22 @@ Checks if the application supports reading files and directories from URIs.
</return>
</function>
-<function name="g_file_info_set_icon">
+<function name="g_zlib_decompressor_new">
<description>
-Sets the icon for a given #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_ICON.
+Creates a new #GZlibDecompressor.
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="icon">
-<parameter_description> a #GIcon.
+<parameter name="format">
+<parameter_description> The format to use for the compressed data
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #GZlibDecompressor
+
+Since: 2.24
+</return>
</function>
<function name="g_file_attribute_info_list_dup">
@@ -13376,6 +15011,24 @@ Makes a duplicate of a file attribute info list.
</return>
</function>
+<function name="g_drive_can_stop">
+<description>
+Checks if a drive can be stopped.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</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">
<description>
Queries the stream information asynchronously.
@@ -13451,38 +15104,21 @@ Since: 2.22
</return>
</function>
-<function name="g_data_input_stream_read_until">
+<function name="g_charset_converter_get_num_fallbacks">
<description>
-Reads a string from the data input stream, up to the first
-occurrence of any of the stop characters.
+Gets the number of fallbacks that @converter has applied so far.
</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="length">
-<parameter_description> a #gsize to get the length of the data read in.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter name="converter">
+<parameter_description> a #GCharsetConverter
</parameter_description>
</parameter>
</parameters>
-<return> a string with the data that was read before encountering
-any of the stop characters. Set @length to a #gsize to get the length
-of the string. This function will return %NULL on an error.
+<return> the number of fallbacks that @converter has applied
+
+Since: 2.24
</return>
</function>
@@ -13704,16 +15340,6 @@ Gets the device path for a unix mount.
</return>
</function>
-<function name="If">
-<description>
-Unsafe, need lock.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_file_info_set_is_hidden">
<description>
Sets the "is_hidden" attribute in a #GFileInfo according to @is_symlink.
@@ -13733,22 +15359,52 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
<return></return>
</function>
-<function name="g_socket_get_protocol_name">
+<function name="g_input_stream_read">
<description>
-Gets the socket protocol type name the socket was created with.
-This can be %NULL if the socket was created with a NULL protocol.
+Tries to read @count bytes from the stream into the buffer starting at
+ buffer Will block during this read.
+
+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 read into the buffer is returned.
+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. Zero is returned on end of file
+(or if @count is zero), but never otherwise.
+
+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="socket">
-<parameter_description> a #GSocket.
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least count bytes long).
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occuring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> a string or %NULL, free with g_free
-
-Since: 2.22
+<return> Number of bytes read, or -1 on error
</return>
</function>
@@ -13903,6 +15559,31 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
<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_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> an unsigned 8-bit/1-byte value read from the @stream or %0
+if an error occurred.
+</return>
+</function>
+
<function name="g_mount_can_eject">
<description>
Checks if @mount can be eject.
@@ -14000,7 +15681,7 @@ Free the returned object with g_object_unref().
Removes all changes to the type associations done by
g_app_info_set_as_default_for_type(),
g_app_info_set_as_default_for_extension(),
-g_app_info_add_supports_type() of g_app_info_remove_supports_type().
+g_app_info_add_supports_type() or g_app_info_remove_supports_type().
Since: 2.20
@@ -14061,6 +15742,26 @@ for an anonymous user.
</return>
</function>
+<function name="g_mount_get_default_location">
+<description>
+Gets the default location of @mount. The default location of the given
+ mount is a path that reflects the main entry point for the user (e.g.
+the home directory, or the root of the volume).
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile.
+The returned object should be unreffed with
+g_object_unref() when no longer needed.
+</return>
+</function>
+
<function name="g_socket_is_connected">
<description>
Check whether the socket is connected. This is only useful for
@@ -14098,6 +15799,7 @@ useful for connection oriented sockets that have been connected.
</parameter>
</parameters>
<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
Since: 2.22
</return>
@@ -14105,8 +15807,8 @@ Since: 2.22
<function name="g_io_scheduler_job_send_to_mainloop">
<description>
-Used from an I/O job to send a callback to be run in the
-main loop (main thread), waiting for the result (and thus
+Used from an I/O job to send a callback to be run in the thread
+that the job was started from, waiting for the result (and thus
blocking the I/O job).
@@ -14117,7 +15819,7 @@ blocking the I/O job).
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> a #GSourceFunc callback that will be called in the main thread
+<parameter_description> a #GSourceFunc callback that will be called in the original thread
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -14208,8 +15910,8 @@ See g_socket_client_set_family() for details.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="client">
+<parameter_description> a #GSocketClient.
</parameter_description>
</parameter>
</parameters>
@@ -14325,6 +16027,26 @@ g_file_copy_async().
</return>
</function>
+<function name="g_charset_converter_set_use_fallback">
+<description>
+Sets the #GCharsetConverter:use-fallback property.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="converter">
+<parameter_description> a #GCharsetConverter
+</parameter_description>
+</parameter>
+<parameter name="use_fallback">
+<parameter_description> %TRUE to use fallbacks
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_open_readwrite_async">
<description>
Asynchronously opens @file for reading and writing.
@@ -14441,20 +16163,29 @@ list available applications.
</return>
</function>
-<function name="g_inet_address_new_loopback">
+<function name="g_mount_eject_with_operation_finish">
<description>
-Creates a #GInetAddress for the loopback address for @family.
+Finishes ejecting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
</description>
<parameters>
-<parameter name="family">
-<parameter_description> the address family
+<parameter name="mount">
+<parameter_description> a #GMount.
+</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 new #GInetAddress corresponding to the loopback address
-for @family.
+<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
Since: 2.22
</return>
@@ -14504,20 +16235,18 @@ the <literal>Hidden</literal> key set.
<function name="g_socket_send">
<description>
-Tries to send @size bytes from @buffer on the socket. This is mainly used by
-connection oriented sockets, it is identical to g_socket_send_to()
-with @address set to %NULL.
+Tries to send @size bytes from @buffer on the socket. This is
+mainly used by connection-oriented sockets; it is identical to
+g_socket_send_to() with @address set to %NULL.
If the socket is in blocking mode the call will block until there is
space for the data in the socket queue. If there is no space available
and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified of available space, wait for the %G_IO_OUT
-condition.
-
-Note that on Windows you can't rely on a %G_IO_OUT condition
-not producing a %G_IO_ERROR_WOULD_BLOCK error, as this is how Winsock
-write notification works. However, robust apps should always be able to
-handle this since it can easily appear in other cases too.
+will be returned. To be notified when space is available, wait for the
+%G_IO_OUT condition. Note though that you may still receive
+%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
+notified of a %G_IO_OUT condition. (On Windows in particular, this is
+very common due to the way the underlying APIs work.)
On error -1 is returned and @error is set accordingly.
@@ -14536,12 +16265,17 @@ On error -1 is returned and @error is set accordingly.
<parameter_description> the number of bytes to send
</parameter_description>
</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
<parameter name="error">
<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> Number of bytes written (which may be less than @size), or -1
+on error
Since: 2.22
</return>
@@ -14711,37 +16445,48 @@ write or truncate operation on the stream.
</return>
</function>
-<function name="_g_winhttp_file_new">
+<function name="g_cancellable_cancel">
<description>
+Will set @cancellable to cancelled, and will emit the
+#GCancellable::cancelled signal. (However, see the warning about
+race conditions in the documentation for that signal if you are
+planning to connect to it.)
+
+This function is thread-safe. In other words, you can safely call
+it from a thread other than the one running the operation that was
+passed the @cancellable.
+
+The convention within gio is that cancelling an asynchronous
+operation causes it to complete asynchronously. That is, if you
+cancel the operation from the same thread in which it is running,
+then the operation's #GAsyncReadyCallback will not be invoked until
+the application returns to the main loop.
</description>
<parameters>
-<parameter name="vfs">
-<parameter_description> GWinHttpVfs to use
-</parameter_description>
-</parameter>
-<parameter name="uri">
-<parameter_description> URI of the GWinHttpFile to create.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object.
</parameter_description>
</parameter>
</parameters>
-<return> new winhttp #GFile.
-</return>
+<return></return>
</function>
<function name="g_socket_new">
<description>
Creates a new #GSocket with the defined family, type and protocol.
-If @protocol is %NULL the default protocol type for the family and
-type is used.
+If @protocol is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type
+for the family and type is used.
The @protocol is a family and type specific int that specifies what
-kind of protocol to use. Many families only support one protocol,
-and use 0 for this, others support several and using 0 means
-to use the default protocol for the family and type. To use
-other protocol, you can use g_socket_protocol_id_lookup_by_name()
-to look up the protocol by name, or if you known the system specific
-protocol id you can use that.
+kind of protocol to use. #GSocketProtocol lists several common ones.
+Many families only support one protocol, and use 0 for this, others
+support several and using 0 means to use the default protocol for
+the family and type.
+
+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.
</description>
@@ -14754,7 +16499,7 @@ protocol id you can use that.
<parameter_description> the socket type to use.
</parameter_description>
</parameter>
-<parameter name="protocol_id">
+<parameter name="protocol">
<parameter_description> the id of the protocol to use, or 0 for default.
</parameter_description>
</parameter>
@@ -14860,6 +16605,31 @@ attribute does not contain an signed 64-bit integer, or is invalid,
</return>
</function>
+<function name="g_file_info_set_attribute_stringv">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+Sinze: 2.22
+
+</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 %NULL terminated string array
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_icon_to_string">
<description>
Generates a textual representation of @icon that can be used for
@@ -15030,14 +16800,15 @@ a connection to the @address. For a connection-less socket it sets
the default address for g_socket_send() and discards all incoming datagrams
from other sources.
-Generally connection oriented sockets can only connect once, but connection-less
-sockets can connect multiple times to change the default address.
+Generally connection oriented sockets can only connect once, but
+connection-less sockets can connect multiple times to change the
+default address.
If the connect call needs to do network I/O it will block, unless
non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned
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_pending_error().
+checked with g_socket_check_connect_result().
</description>
@@ -15050,6 +16821,10 @@ checked with g_socket_check_pending_error().
<parameter_description> a #GSocketAddress specifying the remote address.
</parameter_description>
</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
<parameter name="error">
<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
@@ -15256,7 +17031,7 @@ different things depending on what address is connected to.
</parameter_description>
</parameter>
<parameter name="port">
-<parameter_description> an ip port number
+<parameter_description> an IP port number (non-zero)
</parameter_description>
</parameter>
<parameter name="source_object">
@@ -15323,7 +17098,7 @@ Since: 2.22
<function name="g_app_info_get_all_for_type">
<description>
-Gets a list of all #GAppInfo s for a given content type.
+Gets a list of all #GAppInfo<!-- -->s for a given content type.
</description>
@@ -15333,11 +17108,23 @@ Gets a list of all #GAppInfo s for a given content type.
</parameter_description>
</parameter>
</parameters>
-<return> #GList of #GAppInfo s for given @content_type
+<return> #GList of #GAppInfo<!-- -->s for given @content_type
or %NULL on error.
</return>
</function>
+<function name="g_io_error_quark">
+<description>
+Gets the GIO Error Quark.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GQuark.
+</return>
+</function>
+
<function name="g_socket_get_socket_type">
<description>
Gets the socket type of the socket.
@@ -15396,7 +17183,7 @@ Since: 2.22
</description>
<parameters>
<parameter name="client">
-<parameter_description> a #GTcpClient
+<parameter_description> a #SocketClient
</parameter_description>
</parameter>
<parameter name="host_and_port">
@@ -15416,8 +17203,7 @@ Since: 2.22
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection if successful, or %NULL on error
-</return>
+<return></return>
</function>
<function name="g_file_info_set_attribute_uint64">
@@ -15501,33 +17287,6 @@ falls to zero, the @list is deleted.
<return></return>
</function>
-<function name="g_cancellable_cancel">
-<description>
-Will set @cancellable to cancelled, and will emit the
-#GCancellable::cancelled signal. (However, see the warning about
-race conditions in the documentation for that signal if you are
-planning to connect to it.)
-
-This function is thread-safe. In other words, you can safely call
-it from a thread other than the one running the operation that was
-passed the @cancellable.
-
-The convention within gio is that cancelling an asynchronous
-operation causes it to complete asynchronously. That is, if you
-cancel the operation from the same thread in which it is running,
-then the operation's #GAsyncReadyCallback will not be invoked until
-the application returns to the main loop.
-
-</description>
-<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_mount_guess_content_type_sync">
<description>
Tries to guess the type of content stored on @mount. Returns one or
@@ -15590,9 +17349,8 @@ 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> %TRUE if successful. If an error has occurred, this function
+will return %FALSE and set @error appropriately if present.
Since: 2.22
</return>
@@ -15803,28 +17561,26 @@ Since: 2.22
</return>
</function>
-<function name="g_file_input_stream_query_info_finish">
+<function name="g_unix_socket_address_get_path">
<description>
-Finishes an asynchronous info query operation.
+Gets @address's path, or for abstract sockets the "name".
+
+Guaranteed to be zero-terminated, but an abstract socket
+may contain embedded zeros, and thus you should use
+g_unix_socket_address_get_path_len() to get the true length
+of this string.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring,
-or %NULL to ignore.
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInfo.
+<return> the path for @address
+
+Since: 2.22
</return>
</function>
@@ -15868,7 +17624,7 @@ associated with @extension.
<function name="g_app_info_get_default_for_type">
<description>
-Gets the #GAppInfo that correspond to a given content type.
+Gets the #GAppInfo that corresponds to a given content type.
</description>
@@ -16002,26 +17758,30 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</return>
</function>
-<function name="g_socket_listener_accept_finish">
+<function name="g_file_read_finish">
<description>
-Sets the listen backlog on the sockets in the listener.
+Finishes an asynchronous file read operation started with
+g_file_read_async().
-See g_socket_set_listen_backlog() for details
-
-Since: 2.22
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="file">
+<parameter_description> input #GFile.
</parameter_description>
</parameter>
-<parameter name="listen_backlog">
-<parameter_description> an integer
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GFileInputStream or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
</function>
<function name="g_file_info_get_symlink_target">
@@ -16060,7 +17820,9 @@ be freed with g_free()
<function name="g_simple_async_result_run_in_thread">
<description>
-Runs the asynchronous job in a separated thread.
+Runs the asynchronous job in a separate thread and then calls
+g_simple_async_result_complete_in_idle() on @simple to return
+the result to the appropriate main loop.
</description>
<parameters>
@@ -16127,53 +17889,23 @@ present, it will be set appropriately.
</return>
</function>
-<function name="g_output_stream_write">
+<function name="g_inet_address_to_bytes">
<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.
+Gets the raw binary address data from @address.
</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 name="address">
+<parameter_description> a #GInetAddress
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes written, or -1 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>
@@ -16279,31 +18011,21 @@ Free the returned object with g_object_unref().
</return>
</function>
-<function name="g_async_initable_new_finish">
+<function name="g_converter_input_stream_get_converter">
<description>
-Finishes the async construction for the various g_async_initable_new calls,
-returning the created object or %NULL on error.
+Gets the #GConverter that is used by @converter_stream.
</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 name="converter_stream">
+<parameter_description> a #GConverterInputStream
</parameter_description>
</parameter>
</parameters>
-<return> a newly created #GObject, or %NULL on error. Free with g_object_unref().
+<return> the converter of the converter input stream
-Since: 2.22
+Since: 2.24
</return>
</function>
@@ -16408,7 +18130,7 @@ Try to get the local address of a socket connection.
</description>
<parameters>
<parameter name="connection">
-<parameter_description> a #GSocketConnection.
+<parameter_description> a #GSocketConnection
</parameter_description>
</parameter>
<parameter name="error">
@@ -16417,6 +18139,7 @@ Try to get the local address of a socket connection.
</parameter>
</parameters>
<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
Since: 2.22
</return>
@@ -16472,21 +18195,79 @@ Gets the edit name for a file.
</return>
</function>
-<function name="_g_mount_get_for_mount_path">
+<function name="g_file_set_attribute">
<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.
+
</description>
<parameters>
-<parameter name="mountpoint">
-<parameter_description> a string.
+<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> a #GCancellable, or %NULL
+<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 set, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_data_input_stream_read_uint64">
+<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().
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> a #GMount for given @mount_path or %NULL.
+<return> an unsigned 64-bit/8-byte read from @stream or %0 if
+an error occurred.
</return>
</function>
@@ -16568,16 +18349,17 @@ Splices an input stream into an output stream.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
+<parameter_description> a #GError location to store the error occuring, or %NULL to
ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize containing the size of the data spliced.
+<return> a #gssize containing the size of the data spliced, or
+-1 if an error occurred.
</return>
</function>
@@ -16644,21 +18426,21 @@ source address of the received packet.
@vector must point to an array of #GInputVector structs and
@num_vectors must be the length of this array. These structs
describe the buffers that received data will be scattered into.
-If @num_vector is -1, then @vector is assumed to be terminated
+If @num_vectors is -1, then @vectors is assumed to be terminated
by a #GInputVector with a %NULL buffer pointer.
-As a special case, if the size of the array is zero (in which case,
- vectors may of course be %NULL), then a single byte is received
-and discarded. This is to facilitate the common practice of
-sending a single '\0' byte for the purposes of transferring
-ancillary data.
+As a special case, if @num_vectors is 0 (in which case, @vectors
+may of course be %NULL), then a single byte is received and
+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, is taken to point to a pointer that 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().
+ 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.
@num_messages, if non-%NULL, will be set to the number of control
messages received.
@@ -16668,15 +18450,24 @@ If both @messages and @num_messages are non-%NULL, then
in @messages (ie: not including the %NULL terminator).
@flags is an in/out parameter. The commonly available arguments
-for this is available in the #GSocketMsgFlags enum, but the
+for this are available in the #GSocketMsgFlags enum, but the
values there are the same as the system values, and the flags
-are passed in as-is, so you can pass in system specific flags too.
-
-If the socket is in blocking mode the call will block until there is
-some data to receive or there is an error. If there is no data available
-and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified of available data, wait for the %G_IO_IN
-condition.
+are passed in as-is, so you can pass in system-specific flags too
+(and g_socket_receive_message() may pass system-specific flags out).
+
+As with g_socket_receive(), data may be discarded if @socket is
+%G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not
+provide enough buffer space to read a complete message. You can pass
+%G_SOCKET_MSG_PEEK in @flags to peek at the current message without
+removing it from the receive queue, but there is no portable way to find
+out the length of the message other than by reading it into a
+sufficiently-large buffer.
+
+If the socket is in blocking mode the call will block until there
+is some data to receive or there is an error. If there is no data
+available and the socket is in non-blocking mode, a
+%G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when
+data is available, wait for the %G_IO_IN condition.
On error -1 is returned and @error is set accordingly.
@@ -16713,6 +18504,10 @@ elements in @messages, or %NULL
<parameter_description> a pointer to an int containing #GSocketMsgFlags flags
</parameter_description>
</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
<parameter name="error">
<parameter_description> a #GError pointer, or %NULL
</parameter_description>
@@ -16811,7 +18606,10 @@ Since: 2.22
<function name="GInetAddress">
<description>
-An IPv4 or IPv6 internet address.
+Whether this is a site-local multicast address.
+See g_inet_address_get_is_mc_site_local().
+
+Since: 2.22
</description>
<parameters>
@@ -16882,17 +18680,31 @@ Since: 2.22
<return></return>
</function>
-<function name="_g_local_file_new">
+<function name="g_file_eject_mountable_with_operation_finish">
<description>
+Finishes an asynchronous eject operation started by
+g_file_eject_mountable_with_operation().
+
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> filename of the file to create.
+<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> new local #GFile.
+<return> %TRUE if the @file was ejected successfully. %FALSE
+otherwise.
+
+Since: 2.22
</return>
</function>
@@ -16924,6 +18736,94 @@ Puts a string into the output stream.
</return>
</function>
+<function name="g_socket_send_message">
+<description>
+Send data to @address on @socket. This is the most complicated and
+fully-featured version of this call. For easier use, see
+g_socket_send() and g_socket_send_to().
+
+If @address is %NULL then the message is sent to the default receiver
+(set by g_socket_connect()).
+
+ vectors must point to an array of #GOutputVector structs and
+ num_vectors must be the length of this array. (If @num_vectors is -1,
+then @vectors is assumed to be terminated by a #GOutputVector with a
+%NULL buffer pointer.) The #GOutputVector structs describe the buffers
+that the sent data will be gathered from. Using multiple
+#GOutputVector<!-- -->s is more memory-efficient than manually copying
+data from multiple sources into a single buffer, and more
+network-efficient than making multiple calls to g_socket_send().
+
+ messages, if non-%NULL, is taken to point to an array of @num_messages
+#GSocketControlMessage instances. These correspond to the control
+messages to be sent on the socket.
+If @num_messages is -1 then @messages is treated as a %NULL-terminated
+array.
+
+ flags modify how the message is sent. The commonly available arguments
+for this are available in the #GSocketMsgFlags enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too.
+
+If the socket is in blocking mode the call will block until there is
+space for the data in the socket queue. If there is no space available
+and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
+will be returned. To be notified when space is available, wait for the
+%G_IO_OUT condition. Note though that you may still receive
+%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
+notified of a %G_IO_OUT condition. (On Windows in particular, this is
+very common due to the way the underlying APIs work.)
+
+On error -1 is returned and @error is set accordingly.
+
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> an array of #GOutputVector structs
+</parameter_description>
+</parameter>
+<parameter name="num_vectors">
+<parameter_description> the number of elements in @vectors, or -1
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> a pointer to an array of #GSocketControlMessages, or
+%NULL.
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> number of elements in @messages, or -1.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> an int containing #GSocketMsgFlags flags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written (which may be less than @size), or -1
+on error
+
+Since: 2.22
+</return>
+</function>
+
<function name="g_file_info_get_attribute_uint32">
<description>
Gets an unsigned 32-bit integer contained within the attribute. If the
@@ -17052,10 +18952,11 @@ and should not be freed
<function name="g_async_initable_newv_async">
<description>
Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_newv() but also initializes the object asyncronously.
+similar to g_object_newv() 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 new object and check for any errors.
+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
@@ -17083,7 +18984,8 @@ of the operation.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the initialization is finished
+<parameter_description> a #GAsyncReadyCallback to call when the initialization is
+finished
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -17094,6 +18996,43 @@ of the operation.
<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.
@@ -17174,6 +19113,55 @@ Since: 2.18
</return>
</function>
+<function name="g_file_start_mountable_finish">
+<description>
+Finishes a start operation. See g_file_start_mountable() for details.
+
+Finish an asynchronous start operation that was started
+with g_file_start_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> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+Since: 2.22
+</return>
+</function>
+
+<function name="g_unix_fd_list_get_length">
+<description>
+Gets the length of @list (ie: the number of file descriptors
+contained within).
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GUnixFDList
+</parameter_description>
+</parameter>
+</parameters>
+<return> the length of @list
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_input_stream_read_async">
<description>
Request an asynchronous read of @count bytes from the stream into the buffer
@@ -17181,7 +19169,7 @@ starting at @buffer. When the operation is finished @callback will be called.
You can then call g_input_stream_read_finish() to get the result of the
operation.
-During an async request no other sync and async calls are allowed, and will
+During an async request no other sync and async calls are allowed on @stream, 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.
@@ -17235,20 +19223,31 @@ of the request.
<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.
</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.
+
+Since: 2.22
</return>
</function>
@@ -17380,6 +19379,16 @@ 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.
@@ -17396,6 +19405,33 @@ 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.
@@ -17449,30 +19485,19 @@ or %NULL
</return>
</function>
-<function name="delete">
+<function name="g_file_info_get_display_name">
<description>
+Gets a display name for a file.
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="_g_unix_volume_monitor_lookup_volume_for_mount_path">
-<description>
</description>
<parameters>
-<parameter name="monitor">
-<parameter_description>
-</parameter_description>
-</parameter>
-<parameter name="mount_path">
-<parameter_description>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
</parameter_description>
</parameter>
</parameters>
-<return> #GUnixVolume for the given @mount_path.
+<return> a string containing the display name.
</return>
</function>
@@ -17556,6 +19581,8 @@ Finishes ejecting a volume. If any errors occured during the operation,
</parameter>
</parameters>
<return> %TRUE, %FALSE if operation failed.
+
+Deprecated: 2.22: Use g_volume_eject_with_operation_finish() instead.
</return>
</function>
@@ -17694,6 +19721,8 @@ ignore.
</parameter>
</parameters>
<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
+
+Deprecated: 2.22: Use g_mount_unmount_with_operation_finish() instead.
</return>
</function>
@@ -17713,6 +19742,46 @@ Gets the size of the buffer in the @stream.
</return>
</function>
+<function name="g_drive_stop">
+<description>
+Asynchronously stops a drive.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_stop_finish() to obtain the
+result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for stopping.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_icon_hash">
<description>
Gets a hash for an icon.
@@ -17785,25 +19854,6 @@ References a file attribute matcher.
</return>
</function>
-<function name="g_mount_shadow">
-<description>
-Increments the shadow count on @mount. Usually used by
-#GVolumeMonitor implementations when creating a shadow mount for
- mount, see g_mount_is_shadowed() for more information. The caller
-will need to emit the #GMount::changed signal on @mount manually.
-
-Since: 2.20
-
-</description>
-<parameters>
-<parameter name="mount">
-<parameter_description> A #GMount.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="GFilenameCompleter">
<description>
Emitted when the file name completion information comes available.
@@ -17862,6 +19912,33 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_file_has_parent">
+<description>
+Checks if @file has a parent, and optionally, if it is @parent.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> the parent to check for, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @file is a child of @parent (or any parent in the
+case that @parent is %NULL).
+
+Since: 2.24
+</return>
+</function>
+
<function name="g_file_info_new">
<description>
Creates a new file info structure.
@@ -17899,13 +19976,13 @@ the output stream is destroyed.
<function name="g_socket_connection_get_remote_address">
<description>
-Try to get the remove address of a socket connection.
+Try to get the remote address of a socket connection.
</description>
<parameters>
<parameter name="connection">
-<parameter_description> a #GSocketConnection.
+<parameter_description> a #GSocketConnection
</parameter_description>
</parameter>
<parameter name="error">
@@ -17914,6 +19991,7 @@ Try to get the remove address of a socket connection.
</parameter>
</parameters>
<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
Since: 2.22
</return>
@@ -18043,6 +20121,10 @@ To be notified of an incoming connection, wait for the %G_IO_IN condition.
<parameter_description> a #GSocket.
</parameter_description>
</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
<parameter name="error">
<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
@@ -18096,19 +20178,56 @@ of the request.
<return></return>
</function>
-<function name="g_file_info_get_display_name">
+<function name="g_socket_listener_accept_finish">
<description>
-Gets a display name for a file.
+Finishes an async accept operation. See g_socket_listener_accept_async()
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<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 string containing the display name.
+<return> a #GSocketConnection on success, %NULL on error.
+
+Since: 2.22
+</return>
+</function>
+
+<function name="g_file_supports_thread_contexts">
+<description>
+Checks if @file supports <link
+linkend="g-main-context-push-thread-default-context">thread-default
+contexts</link>. If this returns %FALSE, you cannot perform
+asynchronous operations on @file in a thread that has a
+thread-default context.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Whether or not @file supports thread-default contexts.
+
+Since: 2.22
</return>
</function>
@@ -18155,31 +20274,75 @@ attribute does not contain an unsigned 64-bit integer, or is invalid,
</return>
</function>
+<function name="g_file_stop_mountable">
+<description>
+Stops 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_stop_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_io_stream_close">
<description>
Closes the stream, releasing resources related to it. This will also
closes the individual input and output streams, if they are not already
closed.
-Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
-Closing a stream multiple times will not return an error.
+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.
+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.
+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.
+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
@@ -18194,11 +20357,11 @@ individual input/output streams.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> A #GIOStream.
+<parameter_description> a #GIOStream
</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">
@@ -18222,9 +20385,9 @@ 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
+If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
-was cancelled, the error G_IO_ERROR_CANCELLED will be returned.
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</description>
@@ -18252,6 +20415,34 @@ Since: 2.22
</return>
</function>
+<function name="g_tcp_connection_set_graceful_disconnect">
+<description>
+This enabled graceful disconnects on close. A graceful disconnect
+means that we signal the recieving end that the connection is terminated
+and wait for it to close the connection before closing the connection.
+
+A graceful disconnect means that we can be sure that we successfully sent
+all the outstanding data to the other end, or get an error reported.
+However, it also means we have to wait for all the data to reach the
+other side and for it to acknowledge this by closing the socket, which may
+take a while. For this reason it is disabled by default.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GTcpConnection
+</parameter_description>
+</parameter>
+<parameter name="graceful_disconnect">
+<parameter_description> Whether to do graceful disconnects or not
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_app_info_can_remove_supports_type">
<description>
Checks if a supported content type can be removed from an application.
@@ -18331,34 +20522,22 @@ Sets the user name within @op to @username.
<return></return>
</function>
-<function name="_g_win32_mount_new">
+<function name="g_mount_shadow">
<description>
+Increments the shadow count on @mount. Usually used by
+#GVolumeMonitor implementations when creating a shadow mount for
+ mount, see g_mount_is_shadowed() for more information. The caller
+will need to emit the #GMount::changed signal on @mount manually.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="volume_monitor">
-<parameter_description> a #GVolumeMonitor.
-</parameter_description>
-</parameter>
-<parameter name="path">
-<parameter_description> a win32 path.
-</parameter_description>
-</parameter>
-<parameter name="volume">
-<parameter_description> ususally NULL
+<parameter name="mount">
+<parameter_description> A #GMount.
</parameter_description>
</parameter>
</parameters>
-<return> a #GWin32Mount for the given win32 path.
-</return>
-</function>
-
-<function name="depth">
-<description>
-
-</description>
-<parameters>
-</parameters>
<return></return>
</function>
@@ -18371,7 +20550,7 @@ the result of the operation.
For behaviour details see g_io_stream_close().
-The asyncronous methods have a default fallback that uses threads
+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.
@@ -18380,11 +20559,11 @@ Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> A #GIOStream.
+<parameter_description> a #GIOStream
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the io priority of the request.
+<parameter_description> the io priority of the request
</parameter_description>
</parameter>
<parameter name="callback">
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
