Gio.SrvTarget¶

Fields¶

None

Methods¶

class	`new` (hostname, port, priority, weight)
	`copy` ()
	`free` ()
	`get_hostname` ()
	`get_port` ()
	`get_priority` ()
	`get_weight` ()

Details¶

class Gio.SrvTarget¶

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 GSrvTarget``s 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.

classmethod new(hostname, port, priority, weight)[source]¶

Parameters:

hostname (str) – the host that the service is running on
port (int) – the port that the service is running on
priority (int) – the target’s priority
weight (int) – the target’s weight

Returns:

a new Gio.SrvTarget.

Return type:

Gio.SrvTarget

Creates a new Gio.SrvTarget with the given parameters.

You should not need to use this; normally Gio.SrvTargets are created by Gio.Resolver.

New in version 2.22.

copy()[source]¶

Returns:: a copy of self
Return type:: Gio.SrvTarget

Copies self

New in version 2.22.

free()[source]¶: Frees self

New in version 2.22.

get_hostname()[source]¶

Returns:: self's hostname
Return type:: str

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

New in version 2.22.

get_port()[source]¶

Returns:: self's port
Return type:: int

Gets self's port

New in version 2.22.

get_priority()[source]¶

Returns:: self's priority
Return type:: int

Gets self's priority. You should not need to look at this; Gio.Resolver already sorts the targets according to the algorithm in RFC 2782.

New in version 2.22.

get_weight()[source]¶

Returns:: self's weight
Return type:: int

Gets self's weight. You should not need to look at this; Gio.Resolver already sorts the targets according to the algorithm in RFC 2782.

New in version 2.22.