Emitted when client's activity on connectable changes state.
Among other things, this can be used to provide progress
information about a network connection in the UI. The meanings of
the different event values are as follows:
- G_SOCKET_CLIENT_RESOLVING:client is about to look up connectable
in DNS. connection will be NULL.
- G_SOCKET_CLIENT_RESOLVED:client has successfully resolved
connectable in DNS. connection will be NULL.
- G_SOCKET_CLIENT_CONNECTING:client is about to make a connection
to a remote host; either a proxy server or the destination server
itself. connection is the gio.SocketConnection, which is not yet
connected. Since GLib 2.40, you can access the remote
address via Socket.connectionGetRemoteAddress.
- G_SOCKET_CLIENT_CONNECTED:client has successfully connected
to a remote host. connection is the connected gio.SocketConnection
- G_SOCKET_CLIENT_PROXY_NEGOTIATING:client is about to negotiate
with a proxy to get it to connect to connectable. connection is
the gio.SocketConnection to the proxy server.
- G_SOCKET_CLIENT_PROXY_NEGOTIATED:client has negotiated a
connection to connectable through a proxy server. connection is
the stream returned from g_proxy_connect(), which may or may not
be a gio.SocketConnection
- G_SOCKET_CLIENT_TLS_HANDSHAKING:client is about to begin a TLS
handshake. connection is a GTlsClientConnection
- G_SOCKET_CLIENT_TLS_HANDSHAKED:client has successfully completed
the TLS handshake. connection is a GTlsClientConnection
- G_SOCKET_CLIENT_COMPLETE:client has either successfully connected
to connectable (in which case connection is the gio.SocketConnection
that it will be returning to the caller) or has failed (in which
case connection is NULL and the client is about to return an error).
Each event except G_SOCKET_CLIENT_COMPLETE may be emitted
multiple times (or not at all) for a given connectable (in
particular, if client ends up attempting to connect to more than
one address). However, if client emits the event
signal at all for a given connectable, that it will always emit
it with G_SOCKET_CLIENT_COMPLETE when it is done.
Note that there may be additional GSocketClientEvent values in
the future; unrecognized event values should be ignored.
Emitted when client's activity on connectable changes state. Among other things, this can be used to provide progress information about a network connection in the UI. The meanings of the different event values are as follows:
- G_SOCKET_CLIENT_RESOLVING: client is about to look up connectable in DNS. connection will be NULL.
- G_SOCKET_CLIENT_RESOLVED: client has successfully resolved connectable in DNS. connection will be NULL.
- G_SOCKET_CLIENT_CONNECTING: client is about to make a connection to a remote host; either a proxy server or the destination server itself. connection is the gio.SocketConnection, which is not yet connected. Since GLib 2.40, you can access the remote address via Socket.connectionGetRemoteAddress.
- G_SOCKET_CLIENT_CONNECTED: client has successfully connected to a remote host. connection is the connected gio.SocketConnection
- G_SOCKET_CLIENT_PROXY_NEGOTIATING: client is about to negotiate with a proxy to get it to connect to connectable. connection is the gio.SocketConnection to the proxy server.
- G_SOCKET_CLIENT_PROXY_NEGOTIATED: client has negotiated a connection to connectable through a proxy server. connection is the stream returned from g_proxy_connect(), which may or may not be a gio.SocketConnection
- G_SOCKET_CLIENT_TLS_HANDSHAKING: client is about to begin a TLS handshake. connection is a GTlsClientConnection
- G_SOCKET_CLIENT_TLS_HANDSHAKED: client has successfully completed the TLS handshake. connection is a GTlsClientConnection
- G_SOCKET_CLIENT_COMPLETE: client has either successfully connected to connectable (in which case connection is the gio.SocketConnection that it will be returning to the caller) or has failed (in which case connection is NULL and the client is about to return an error).
Each event except G_SOCKET_CLIENT_COMPLETE may be emitted multiple times (or not at all) for a given connectable (in particular, if client ends up attempting to connect to more than one address). However, if client emits the event signal at all for a given connectable, that it will always emit it with G_SOCKET_CLIENT_COMPLETE when it is done.
Note that there may be additional GSocketClientEvent values in the future; unrecognized event values should be ignored.