luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 23:16:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

GDBusConnection: warn that direct access to the stream is a bad idea

Browse Source 
Bug: https://bugzilla.gnome.org/show_bug.cgi?id=661679
Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
This commit is contained in:
Simon McVittie 2011-10-13 17:39:03 +01:00 committed by Matthias Clasen
parent 70eff50f21
commit a7143a0e9f
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
gio/gdbusconnection.c
View File

@ -674,6 +674,10 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* If this is passed on construction and is a #GSocketConnection, * If this is passed on construction and is a #GSocketConnection,
* then the corresponding #GSocket will be put into non-blocking mode. * then the corresponding #GSocket will be put into non-blocking mode.
* *
* While the #GDBusConnection is active, it will interact with this
* stream from a worker thread, so it is not safe to interact with
* the stream directly.
*
* Since: 2.26 * Since: 2.26
*/ */
g_object_class_install_property (gobject_class, g_object_class_install_property (gobject_class,
@ -947,6 +951,10 @@ g_dbus_connection_init (GDBusConnection *connection)
* *
* Gets the underlying stream used for IO. * Gets the underlying stream used for IO.
* *
* While the #GDBusConnection is active, it will interact with this
* stream from a worker thread, so it is not safe to interact with
* the stream directly.
*
* Returns: (transfer none): the stream used for IO * Returns: (transfer none): the stream used for IO
* *
* Since: 2.26 * Since: 2.26
@ -2501,6 +2509,10 @@ async_initable_iface_init (GAsyncInitableIface *async_initable_iface)
* If @stream is a #GSocketConnection, then the corresponding #GSocket * If @stream is a #GSocketConnection, then the corresponding #GSocket
* will be put into non-blocking mode. * will be put into non-blocking mode.
* *
* The D-Bus connection will interact with @stream from a worker thread.
* As a result, the caller should not interact with @stream after this
* method has been called, except by calling g_object_unref() on it.
*
* If @observer is not %NULL it may be used to control the * If @observer is not %NULL it may be used to control the
* authentication process. * authentication process.
* *
@ -2584,6 +2596,10 @@ g_dbus_connection_new_finish (GAsyncResult *res,
* If @stream is a #GSocketConnection, then the corresponding #GSocket * If @stream is a #GSocketConnection, then the corresponding #GSocket
* will be put into non-blocking mode. * will be put into non-blocking mode.
* *
* The D-Bus connection will interact with @stream from a worker thread.
* As a result, the caller should not interact with @stream after this
* method has been called, except by calling g_object_unref() on it.
*
* If @observer is not %NULL it may be used to control the * If @observer is not %NULL it may be used to control the
* authentication process. * authentication process.
* *