class: GSrvTarget

[24:7] extends: object

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.

Members

handleObj
lib
retainedCallbacks
signalHandlerNames
signalSetterHandlers

Methods

GSrvTarget (hostname = null, port = null, priority = null, weight = null)

Creates a new #GSrvTarget with the given parameters. You should not need to use this; normally #GSrvTargets are created by #GResolver.
- @p hostname is the host that the service is running on.
- @p port is the port that the service is running on.
- @p priority is the target's priority.
- @p weight is the target's weight.
toNativeHandle (Source)

Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.
- @p Source is the raw handle, raw buffer, wrapper, or null.
- @r A raw pointer carrier or null when no pointer is present.
getLib ()

Returns the opened native library for this generated wrapper.
- @r The opened native library.
handle ()

Returns the wrapped NativeHandle.
- @r The wrapped NativeHandle.
isNull ()

Returns true when the wrapped handle is null.
- @r A bool.
describe ()

Returns a small string for debugging generated wrappers.
- @r A string.
copy ()

Copies @target
- @r a copy of @target.
free ()

Frees @target
- @r None.
get_hostname ()

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.)
- @r @target's hostname.
get_port ()

Gets @target's port
- @r @target's port.
get_priority ()

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

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