diff options
author | Michael Catanzaro <mcatanzaro@igalia.com> | 2019-04-07 16:03:41 -0500 |
---|---|---|
committer | Michael Catanzaro <mcatanzaro@posteo.net> | 2019-05-15 14:02:30 +0000 |
commit | 51305b3081bf821c3e20610466c25494467c83c2 (patch) | |
tree | 0d6e44bde5f92f49c7e7938ec21333b17ecc233d | |
parent | 1f2546d9350137b7570010103678e2043138097c (diff) | |
download | glib-networking-51305b3081bf821c3e20610466c25494467c83c2.tar.gz |
gtlsconnection-base: improve comments
Port of 6e84378392696c8780addfc8b9c958cb6917a81a and 40285bf52105c782730dff2e85d7c21efefa150a
-rw-r--r-- | tls/base/gtlsconnection-base.c | 26 |
1 files changed, 17 insertions, 9 deletions
diff --git a/tls/base/gtlsconnection-base.c b/tls/base/gtlsconnection-base.c index f06c7bc..79ffbfd 100644 --- a/tls/base/gtlsconnection-base.c +++ b/tls/base/gtlsconnection-base.c @@ -55,22 +55,30 @@ typedef struct { - /* When operating in stream mode. - * Mutually exclusive with base_socket. + /* When operating in stream mode, as a GTlsConnection. These are + * mutually-exclusive with base_socket. There are two different + * GIOStreams here: (a) base_io_stream and (b) the GTlsConnection + * itself. base_io_stream is the GIOStream used to create the GTlsConnection, + * and corresponds to the GTlsConnection::base-io-stream property. + * base_istream and base_ostream are the GInputStream and GOutputStream, + * respectively, of base_io_stream. These are for the underlying sockets that + * don't know about TLS. + * + * Then the GTlsConnection also has tls_istream and tls_ostream, which + * wrap the aforementioned base streams with a TLS session. + * + * When operating in datagram mode, none of these are used. */ GIOStream *base_io_stream; GPollableInputStream *base_istream; GPollableOutputStream *base_ostream; - - /* When operating in stream mode; when operating in datagram mode, the - * GTlsConnectionBase itself is the DTLS GDatagramBased (and uses - * base_socket for its underlying I/O): - */ GInputStream *tls_istream; GOutputStream *tls_ostream; - /* When operating in datagram mode. - * Mutually exclusive with base_io_stream. + /* When operating in datagram mode, as a GDtlsConnection, the + * GTlsConnection is itself the DTLS GDatagramBased. It uses base_socket + * for the underlying I/O. It is mutually-exclusive with base_io_stream and + * the other streams. */ GDatagramBased *base_socket; |