gio/org.gtkkn.bindings.gio/SrvTarget

SrvTarget

class SrvTarget(pointer: <Error class: unknown class><<Error class: unknown class>>)

A single target host/port that a network service is running on.

SRV (service) records are used by some network protocols to provide service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses SRV records to locate the XMPP server for a domain; rather than connecting directly to ‘example.com’ or assuming a specific server hostname like ‘xmpp.example.com’, an XMPP client would look up the xmpp-client SRV record for ‘example.com’, and then connect to whatever host was pointed to by that record.

You can use method@Gio.Resolver.lookup_service or method@Gio.Resolver.lookup_service_async to find the GSrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use class@Gio.NetworkService’s iface@Gio.SocketConnectable interface and not need to worry about GSrvTarget at all.

Constructors

SrvTarget

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

Types

Companion

object Companion

Properties

gioSrvTargetPointer

val gioSrvTargetPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

copy

fun copy(): SrvTarget

Copies @target

free

fun free()

Frees @target

getHostname

fun getHostname(): String

Gets @target's hostname (in ASCII form; if you are going to present this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use g_hostname_to_unicode() to convert it if it does.)

getPort

fun getPort(): <Error class: unknown class>

Gets @target's port

getPriority

fun getPriority(): <Error class: unknown class>

Gets @target's priority. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782.

getWeight

fun getWeight(): <Error class: unknown class>

Gets @target's weight. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782.