gio/org.gtkkn.bindings.gio/TlsClientConnection

TlsClientConnection

interface TlsClientConnection : Proxy(source)

GTlsClientConnection is the client-side subclass of class@Gio.TlsConnection, representing a client-side TLS connection.

Skipped during bindings generation

method server-identity: Property TypeInfo of getter and setter do not match

Since

2.28

Inheritors

TlsClientConnectionImpl

Types

Companion

object Companion

TlsClientConnectionImpl

class TlsClientConnectionImpl( gioTlsClientConnectionPointer: <Error class: unknown class><<Error class: unknown class>>) : TlsConnection, TlsClientConnection

The TlsClientConnectionImpl type represents a native instance of the TlsClientConnection interface.

Properties

acceptedCas

open val acceptedCas: <Error class: unknown class>

A list of the distinguished names of the Certificate Authorities that the server will accept client certificates signed by. If the server requests a client certificate during the handshake, then this property will be set after the handshake completes.

gioProxyPointer

abstract val gioProxyPointer: <Error class: unknown class><<Error class: unknown class>>

gioTlsClientConnectionPointer

abstract val gioTlsClientConnectionPointer: <Error class: unknown class><<Error class: unknown class>>

useSsl3

open var useSsl3: Boolean

This is deprecated since version 2.56.

validationFlags

open var validationFlags: TlsCertificateFlags

This is deprecated since version 2.72.

Functions

connect

open fun connect(connection: IoStream, proxyAddress: ProxyAddress, cancellable: Cancellable? = null): <Error class: unknown class><IoStream>

Given @connection to communicate with a proxy (eg, a #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload.

connectAsync

open fun connectAsync(connection: IoStream, proxyAddress: ProxyAddress, cancellable: Cancellable? = null, callback: AsyncReadyCallback?)

Asynchronous version of g_proxy_connect().

connectFinish

open fun connectFinish(result: AsyncResult): <Error class: unknown class><IoStream>

See g_proxy_connect().

copySessionState

open fun copySessionState(source: TlsClientConnection)

Possibly copies session state from one connection to another, for use in TLS session resumption. This is not normally needed, but may be used when the same session needs to be used between different endpoints, as is required by some protocols, such as FTP over TLS.

getAcceptedCas

open fun getAcceptedCas(): <Error class: unknown class>

Gets the list of distinguished names of the Certificate Authorities that the server will accept certificates from. This will be set during the TLS handshake if the server requests a certificate. Otherwise, it will be null.

getServerIdentity

open fun getServerIdentity(): SocketConnectable?

Gets @conn's expected server identity

getUseSsl3

open fun getUseSsl3(): Boolean

This is deprecated since version 2.56.

getValidationFlags

open fun getValidationFlags(): TlsCertificateFlags

This is deprecated since version 2.72.

setServerIdentity

open fun setServerIdentity(identity: SocketConnectable)

Sets @conn's expected server identity, which is used both to tell servers on virtual hosts which certificate to present, and also to let @conn know what name to look for in the certificate when performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.

setUseSsl3

open fun setUseSsl3(useSsl3: Boolean)

This is deprecated since version 2.56.

setValidationFlags

open fun setValidationFlags(flags: TlsCertificateFlags)

This is deprecated since version 2.72.

supportsHostname

open fun supportsHostname(): Boolean

Some proxy protocols expect to be passed a hostname, which they will resolve to an IP address themselves. Others, like SOCKS4, do not allow this. This function will return false if @proxy is implementing such a protocol. When false is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async().