SrvTarget

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 g_resolver_lookup_service() or g_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 GNetworkService's GSocketConnectable interface and not need to worry about GSrvTarget at all.

class SrvTarget : Boxed {

protected

GSrvTarget* gSrvTarget;

GSrvTarget* getSrvTargetStruct();

void* getStruct();

this(GSrvTarget* gSrvTarget);

this(string hostname, ushort port, ushort priority, ushort weight);

SrvTarget copy();

void free();

string getHostname();

ushort getPort();

ushort getPriority();

ushort getWeight();

static ListG listSort(ListG targets);

}

Constructors

this this(GSrvTarget* gSrvTarget): Sets our main struct and passes it to the parent class
this this(string hostname, ushort port, ushort priority, ushort weight): Creates a new GSrvTarget with the given parameters. You should not need to use this; normally GSrvTargets are created by GResolver. Since 2.22

Members

Functions

copy SrvTarget copy(): Copies target Since 2.22
free void free(): Frees target Since 2.22
getHostname string getHostname(): 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.) Since 2.22
getPort ushort getPort(): Gets target's port Since 2.22
getPriority ushort getPriority(): Gets target's priority. You should not need to look at this; GResolver already sorts the targets according to the algorithm in RFC 2782. Since 2.22
getSrvTargetStruct GSrvTarget* getSrvTargetStruct(): Undocumented in source. Be warned that the author may not have intended to support it.
getStruct void* getStruct(): the main Gtk struct as a void*
getWeight ushort getWeight(): Gets target's weight. You should not need to look at this; GResolver already sorts the targets according to the algorithm in RFC 2782. Since 2.22

Static functions

listSort ListG listSort(ListG targets): Sorts targets in place according to the algorithm in RFC 2782. Since 2.22

Variables

gSrvTarget GSrvTarget* gSrvTarget;: the main Gtk struct

Inherited Members

From Boxed

boxedCopy void* boxedCopy(GType boxedType, void* srcBoxed): Provide a copy of a boxed structure src_boxed which is of type boxed_type.
boxedFree void boxedFree(GType boxedType, void* boxed): Free the boxed structure boxed which is of type boxed_type.
boxedTypeRegisterStatic GType boxedTypeRegisterStatic(string name, GBoxedCopyFunc boxedCopy, GBoxedFreeFunc boxedFree): This function creates a new G_TYPE_BOXED derived type id for a new boxed type with name name. Boxed type handling functions have to be provided to copy and free opaque boxed structures of this type.
pointerTypeRegisterStatic GType pointerTypeRegisterStatic(string name): Creates a new G_TYPE_POINTER derived type id for a new pointer type with name name.