GI.Gio.Structs.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 resolverLookupService or resolverLookupServiceAsync to find the GSrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use 'GI.Gio.Objects.NetworkService.NetworkService'\'s SocketConnectable interface and not need to worry about SrvTarget at all.

Exported types

newtype SrvTarget

Constructors

SrvTarget (ManagedPtr SrvTarget)

Instances

BoxedObject SrvTarget

Methods

boxedType :: SrvTarget -> IO GType

noSrvTarget :: Maybe SrvTarget

Methods

copy

srvTargetCopy

Arguments

:: (HasCallStack, MonadIO m)

=> SrvTarget

target: a SrvTarget

-> m SrvTarget

Returns: a copy of target

Copies target

Since: 2.22

free

srvTargetFree

Arguments

:: (HasCallStack, MonadIO m)

=> SrvTarget

target: a SrvTarget

-> m ()

Frees target

Since: 2.22

getHostname

srvTargetGetHostname

Arguments

:: (HasCallStack, MonadIO m)

=> SrvTarget

target: a SrvTarget

-> m Text

Returns: target's hostname

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

Since: 2.22

getPort

srvTargetGetPort

Arguments

:: (HasCallStack, MonadIO m)

=> SrvTarget

target: a SrvTarget

-> m Word16

Returns: target's port

Gets target's port

Since: 2.22

getPriority

srvTargetGetPriority

Arguments

:: (HasCallStack, MonadIO m)

=> SrvTarget

target: a SrvTarget

-> m Word16

Returns: target's priority

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

Since: 2.22

getWeight

srvTargetGetWeight

Arguments

:: (HasCallStack, MonadIO m)

=> SrvTarget

target: a SrvTarget

-> m Word16

Returns: target's weight

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

Since: 2.22

new

srvTargetNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

hostname: the host that the service is running on

-> Word16

port: the port that the service is running on

-> Word16

priority: the target's priority

-> Word16

weight: the target's weight

-> m SrvTarget

Returns: a new SrvTarget.

Creates a new SrvTarget with the given parameters.

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

Since: 2.22