Copyright | Will Thompson and Iñaki García Etxebarria |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
GI.Gio.Structs.SrvTarget
Description
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 resolverLookupService
or
resolverLookupServiceAsync
to find the GSrvTarget
s
for a given service. However, if you are simply planning to connect
to the remote service, you can use NetworkService
’s
SocketConnectable
interface and not need to worry about
GSrvTarget
at all.
Synopsis
- newtype SrvTarget = SrvTarget (ManagedPtr SrvTarget)
- srvTargetCopy :: (HasCallStack, MonadIO m) => SrvTarget -> m SrvTarget
- srvTargetFree :: (HasCallStack, MonadIO m) => SrvTarget -> m ()
- srvTargetGetHostname :: (HasCallStack, MonadIO m) => SrvTarget -> m Text
- srvTargetGetPort :: (HasCallStack, MonadIO m) => SrvTarget -> m Word16
- srvTargetGetPriority :: (HasCallStack, MonadIO m) => SrvTarget -> m Word16
- srvTargetGetWeight :: (HasCallStack, MonadIO m) => SrvTarget -> m Word16
- srvTargetNew :: (HasCallStack, MonadIO m) => Text -> Word16 -> Word16 -> Word16 -> m SrvTarget
Exported types
Memory-managed wrapper type.
Instances
Eq SrvTarget Source # | |
GBoxed SrvTarget Source # | |
Defined in GI.Gio.Structs.SrvTarget | |
ManagedPtrNewtype SrvTarget Source # | |
Defined in GI.Gio.Structs.SrvTarget Methods toManagedPtr :: SrvTarget -> ManagedPtr SrvTarget | |
TypedObject SrvTarget Source # | |
Defined in GI.Gio.Structs.SrvTarget | |
HasParentTypes SrvTarget Source # | |
Defined in GI.Gio.Structs.SrvTarget | |
IsGValue (Maybe SrvTarget) Source # | Convert |
Defined in GI.Gio.Structs.SrvTarget Methods gvalueGType_ :: IO GType gvalueSet_ :: Ptr GValue -> Maybe SrvTarget -> IO () gvalueGet_ :: Ptr GValue -> IO (Maybe SrvTarget) | |
type ParentTypes SrvTarget Source # | |
Defined in GI.Gio.Structs.SrvTarget |
Methods
Click to display all available methods, including inherited ones
copy
Arguments
:: (HasCallStack, MonadIO m) | |
=> SrvTarget |
|
-> m SrvTarget | Returns: a copy of |
Copies target
Since: 2.22
free
Arguments
:: (HasCallStack, MonadIO m) | |
=> SrvTarget |
|
-> m () |
Frees target
Since: 2.22
getHostname
Arguments
:: (HasCallStack, MonadIO m) | |
=> SrvTarget |
|
-> m Text | Returns: |
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
Arguments
:: (HasCallStack, MonadIO m) | |
=> SrvTarget |
|
-> m Word16 | Returns: |
Gets target
's port
Since: 2.22
getPriority
Arguments
:: (HasCallStack, MonadIO m) | |
=> SrvTarget |
|
-> m Word16 | Returns: |
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
Arguments
:: (HasCallStack, MonadIO m) | |
=> SrvTarget |
|
-> m Word16 | Returns: |
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