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

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 Gio.Resolver.lookup_service() or Gio.Resolver.lookup_service_async() to find the Gio.SrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use Gio.NetworkService's Gio.SocketConnectable interface and not need to worry about Gio.SrvTarget 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.