GI.Gio.Objects.NetworkService

Like NetworkAddress does with hostnames, NetworkService provides an easy way to resolve a SRV record, and then attempt to connect to one of the hosts that implements that service, handling service priority/weighting, multiple IP addresses, and multiple address families.

See SrvTarget for more information about SRV records, and see SocketConnectable for an example of using the connectable interface.

Exported types

newtype NetworkService

Memory-managed wrapper type.

Constructors

NetworkService (ManagedPtr NetworkService)

Instances

GObject NetworkService

Defined in GI.Gio.Objects.NetworkService

Methods

gobjectType :: IO GType

HasParentTypes NetworkService

Defined in GI.Gio.Objects.NetworkService

type ParentTypes NetworkService

Defined in GI.Gio.Objects.NetworkService

type ParentTypes NetworkService = Object ': (SocketConnectable ': ([] :: [Type]))

class (GObject o, IsDescendantOf NetworkService o) => IsNetworkService o

Type class for types which can be safely cast to NetworkService, for instance with toNetworkService.

Instances

(GObject o, IsDescendantOf NetworkService o) => IsNetworkService o

Defined in GI.Gio.Objects.NetworkService

toNetworkService :: (MonadIO m, IsNetworkService o) => o -> m NetworkService

Cast to NetworkService, for types for which this is known to be safe. For general casts, use castTo.

noNetworkService :: Maybe NetworkService

A convenience alias for Nothing :: Maybe NetworkService.

Methods

getDomain

networkServiceGetDomain

Arguments

:: (HasCallStack, MonadIO m, IsNetworkService a)

=> a

srv: a NetworkService

-> m Text

Returns: srv's domain name

Gets the domain that srv serves. This might be either UTF-8 or ASCII-encoded, depending on what srv was created with.

Since: 2.22

getProtocol

networkServiceGetProtocol

Arguments

:: (HasCallStack, MonadIO m, IsNetworkService a)

=> a

srv: a NetworkService

-> m Text

Returns: srv's protocol name

Gets srv's protocol name (eg, "tcp").

Since: 2.22

getScheme

networkServiceGetScheme

Arguments

:: (HasCallStack, MonadIO m, IsNetworkService a)

=> a

srv: a NetworkService

-> m Text

Returns: srv's scheme name

Get's the URI scheme used to resolve proxies. By default, the service name is used as scheme.

Since: 2.26

getService

networkServiceGetService

Arguments

:: (HasCallStack, MonadIO m, IsNetworkService a)

=> a

srv: a NetworkService

-> m Text

Returns: srv's service name

Gets srv's service name (eg, "ldap").

Since: 2.22

new

networkServiceNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

service: the service type to look up (eg, "ldap")

-> Text

protocol: the networking protocol to use for service (eg, "tcp")

-> Text

domain: the DNS domain to look up the service in

-> m NetworkService

Returns: a new NetworkService

Creates a new NetworkService representing the given service, protocol, and domain. This will initially be unresolved; use the SocketConnectable interface to resolve it.

Since: 2.22

setScheme

networkServiceSetScheme

Arguments

:: (HasCallStack, MonadIO m, IsNetworkService a)

=> a

srv: a NetworkService

-> Text

scheme: a URI scheme

-> m ()

Set's the URI scheme used to resolve proxies. By default, the service name is used as scheme.

Since: 2.26

Properties

domain

No description available in the introspection data.

constructNetworkServiceDomain :: IsNetworkService o => Text -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “domain” property. This is rarely needed directly, but it is used by new.

getNetworkServiceDomain :: (MonadIO m, IsNetworkService o) => o -> m Text

Get the value of the “domain” property. When overloading is enabled, this is equivalent to

get networkService #domain

protocol

No description available in the introspection data.

constructNetworkServiceProtocol :: IsNetworkService o => Text -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “protocol” property. This is rarely needed directly, but it is used by new.

getNetworkServiceProtocol :: (MonadIO m, IsNetworkService o) => o -> m Text

Get the value of the “protocol” property. When overloading is enabled, this is equivalent to

get networkService #protocol

scheme

No description available in the introspection data.

constructNetworkServiceScheme :: IsNetworkService o => Text -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “scheme” property. This is rarely needed directly, but it is used by new.

getNetworkServiceScheme :: (MonadIO m, IsNetworkService o) => o -> m Text

Get the value of the “scheme” property. When overloading is enabled, this is equivalent to

get networkService #scheme

setNetworkServiceScheme :: (MonadIO m, IsNetworkService o) => o -> Text -> m ()

Set the value of the “scheme” property. When overloading is enabled, this is equivalent to

set networkService [ #scheme := value ]

service

No description available in the introspection data.

constructNetworkServiceService :: IsNetworkService o => Text -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “service” property. This is rarely needed directly, but it is used by new.

getNetworkServiceService :: (MonadIO m, IsNetworkService o) => o -> m Text

Get the value of the “service” property. When overloading is enabled, this is equivalent to

get networkService #service