gio/org.gtkkn.bindings.gio/NetworkService

NetworkService

open class NetworkService(val gioNetworkServicePointer: <Error class: unknown class><<Error class: unknown class>>) : SocketConnectable(source)

Like class@Gio.NetworkAddress does with hostnames, GNetworkService provides an easy way to resolve a SRV record, and then attempt to connect to one of the hosts that implements that service, handling service priority/weighting, multiple IP addresses, and multiple address families.

See struct@Gio.SrvTarget for more information about SRV records, and see iface@Gio.SocketConnectable for an example of using the connectable interface.

Constructors

NetworkService

constructor(service: String, protocol: String, domain: String)

Creates a new #GNetworkService representing the given @service,

constructor(gioNetworkServicePointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion

Properties

domain

open val domain: String

Network domain, for example example.com.

gioNetworkServicePointer

val gioNetworkServicePointer: <Error class: unknown class><<Error class: unknown class>>

gioProxyPointer

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

gioSocketConnectablePointer

open override val gioSocketConnectablePointer: <Error class: unknown class><<Error class: unknown class>>

protocol

open val protocol: String

Network protocol, for example tcp.

scheme

open var scheme: String

Network scheme (default is to use service).

service

open val service: String

Service name, for example ldap.

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().

enumerate

open fun enumerate(): SocketAddressEnumerator

Creates a #GSocketAddressEnumerator for @connectable.

proxyEnumerate

open fun proxyEnumerate(): SocketAddressEnumerator

Creates a #GSocketAddressEnumerator for @connectable that will return a #GProxyAddress for each of its addresses that you must connect to via a proxy.

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().

toStringSocketConnectable

open fun toStringSocketConnectable(): String

Format a #GSocketConnectable as a string. This is a human-readable format for use in debugging output, and is not a stable serialization format. It is not suitable for use in user interfaces as it exposes too much information for a user.