luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-04 08:23:38 +02:00
Code Issues Packages Projects Releases Wiki Activity

gio: Document thread safety of the streams API

Browse Source 
Specifically, GIOStream and the TLS connection streams.

Includes wording adapted from suggestions by Dan Winship
<danw@gnome.org>.

https://bugzilla.gnome.org/show_bug.cgi?id=735754
This commit is contained in:
Philip Withnall
2014-09-26 14:01:16 +01:00
parent 18fe6d8312
commit 3add5e2837
6 changed files with 45 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
gio/gtlsconnection.c
View File

@@ -95,7 +95,11 @@ g_tls_connection_class_init (GTlsConnectionClass *klass)
/**
* GTlsConnection:base-io-stream:
*
* The #GIOStream that the connection wraps
* The #GIOStream that the connection wraps. The connection holds a reference
* to this stream, and may run operations on the stream from other threads
* throughout its lifetime. Consequently, after the #GIOStream has been
* constructed, application code may only run its own operations on this
* stream when no #GIOStream operations are running.
*
* Since: 2.28
*/
@@ -621,7 +625,8 @@ g_tls_connection_get_peer_certificate_errors (GTlsConnection *conn)
* on @conn, this will send a close notification regardless of the
* setting of this property. If you explicitly want to do an unclean
* close, you can close @conn's #GTlsConnection:base-io-stream rather
* than closing @conn itself.
* than closing @conn itself, but note that this may only be done when no other
* operations are pending on @conn or the base I/O stream.
*
* Since: 2.28
*/