Copyright	Will Thompson, Iñaki García Etxebarria and Jonas Platte
License	LGPL-2.1
Maintainer	Iñaki García Etxebarria (garetxe@gmail.com)
Safe Haskell	None
Language	Haskell2010

GI.Gio.Objects.NetworkService

Contents

Exported types
Methods
Properties

Description

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 and example of using the connectable interface.

Synopsis

Exported types

newtype NetworkService Source #

Constructors

NetworkService (ManagedPtr NetworkService)

Instances

GObject NetworkService Source #
Methods gobjectType :: NetworkService -> IO GType #
IsObject NetworkService Source #

IsSocketConnectable NetworkService Source #

IsNetworkService NetworkService Source #

((~) * info (ResolveNetworkServiceMethod t NetworkService), MethodInfo * info NetworkService p) => IsLabel t (NetworkService -> p) Source #
Methods fromLabel :: Proxy# Symbol t -> NetworkService -> p #
((~) * info (ResolveNetworkServiceMethod t NetworkService), MethodInfo * info NetworkService p) => IsLabelProxy t (NetworkService -> p) Source #
Methods fromLabelProxy :: Proxy Symbol t -> NetworkService -> p #
HasAttributeList * NetworkService Source #

type AttributeList NetworkService Source #
type AttributeList NetworkService
type SignalList NetworkService Source #
type SignalList NetworkService

class GObject o => IsNetworkService o Source #

Instances

(GObject a, UnknownAncestorError Constraint NetworkService a) => IsNetworkService a Source #

IsNetworkService NetworkService Source #

toNetworkService :: IsNetworkService o => o -> IO NetworkService Source #

noNetworkService :: Maybe NetworkService Source #

Methods

getDomain

data NetworkServiceGetDomainMethodInfo Source #

Instances

((~) * signature (m Text), MonadIO m, IsNetworkService a) => MethodInfo * NetworkServiceGetDomainMethodInfo a signature Source #
Methods overloadedMethod :: MethodProxy NetworkServiceGetDomainMethodInfo a -> signature -> s #

networkServiceGetDomain Source #

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

data NetworkServiceGetProtocolMethodInfo Source #

Instances

((~) * signature (m Text), MonadIO m, IsNetworkService a) => MethodInfo * NetworkServiceGetProtocolMethodInfo a signature Source #
Methods overloadedMethod :: MethodProxy NetworkServiceGetProtocolMethodInfo a -> signature -> s #

networkServiceGetProtocol Source #

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

data NetworkServiceGetSchemeMethodInfo Source #

Instances

((~) * signature (m Text), MonadIO m, IsNetworkService a) => MethodInfo * NetworkServiceGetSchemeMethodInfo a signature Source #
Methods overloadedMethod :: MethodProxy NetworkServiceGetSchemeMethodInfo a -> signature -> s #

networkServiceGetScheme Source #

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

data NetworkServiceGetServiceMethodInfo Source #

Instances

((~) * signature (m Text), MonadIO m, IsNetworkService a) => MethodInfo * NetworkServiceGetServiceMethodInfo a signature Source #
Methods overloadedMethod :: MethodProxy NetworkServiceGetServiceMethodInfo a -> signature -> s #

networkServiceGetService Source #

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 Source #

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

data NetworkServiceSetSchemeMethodInfo Source #

Instances

((~) * signature (Text -> m ()), MonadIO m, IsNetworkService a) => MethodInfo * NetworkServiceSetSchemeMethodInfo a signature Source #
Methods overloadedMethod :: MethodProxy NetworkServiceSetSchemeMethodInfo a -> signature -> s #

networkServiceSetScheme Source #

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

data NetworkServiceDomainPropertyInfo Source #

Instances

AttrInfo NetworkServiceDomainPropertyInfo Source #
Associated Types type AttrAllowedOps NetworkServiceDomainPropertyInfo :: [AttrOpTag] # type AttrSetTypeConstraint NetworkServiceDomainPropertyInfo :: * -> Constraint # type AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo :: * -> Constraint # type AttrGetType NetworkServiceDomainPropertyInfo :: * # type AttrLabel NetworkServiceDomainPropertyInfo :: Symbol # type AttrOrigin NetworkServiceDomainPropertyInfo :: * # Methods attrGet :: AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo o => Proxy * NetworkServiceDomainPropertyInfo -> o -> IO (AttrGetType NetworkServiceDomainPropertyInfo) # attrSet :: (AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo o, AttrSetTypeConstraint NetworkServiceDomainPropertyInfo b) => Proxy * NetworkServiceDomainPropertyInfo -> o -> b -> IO () # attrClear :: AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo o => Proxy * NetworkServiceDomainPropertyInfo -> o -> IO () # attrConstruct :: (AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo o, AttrSetTypeConstraint NetworkServiceDomainPropertyInfo b) => Proxy * NetworkServiceDomainPropertyInfo -> b -> IO (GValueConstruct o) #
type AttrOrigin NetworkServiceDomainPropertyInfo Source #
type AttrOrigin NetworkServiceDomainPropertyInfo = NetworkService
type AttrLabel NetworkServiceDomainPropertyInfo Source #
type AttrLabel NetworkServiceDomainPropertyInfo = "domain"
type AttrGetType NetworkServiceDomainPropertyInfo Source #
type AttrGetType NetworkServiceDomainPropertyInfo = Text
type AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo Source #
type AttrBaseTypeConstraint NetworkServiceDomainPropertyInfo = IsNetworkService
type AttrSetTypeConstraint NetworkServiceDomainPropertyInfo Source #
type AttrSetTypeConstraint NetworkServiceDomainPropertyInfo = * ~ Text
type AttrAllowedOps NetworkServiceDomainPropertyInfo Source #
type AttrAllowedOps NetworkServiceDomainPropertyInfo = (:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ((:) AttrOpTag AttrClear ([] AttrOpTag)))

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

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

networkServiceDomain :: AttrLabelProxy "domain" Source #

protocol

data NetworkServiceProtocolPropertyInfo Source #

Instances

AttrInfo NetworkServiceProtocolPropertyInfo Source #
Associated Types type AttrAllowedOps NetworkServiceProtocolPropertyInfo :: [AttrOpTag] # type AttrSetTypeConstraint NetworkServiceProtocolPropertyInfo :: * -> Constraint # type AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo :: * -> Constraint # type AttrGetType NetworkServiceProtocolPropertyInfo :: * # type AttrLabel NetworkServiceProtocolPropertyInfo :: Symbol # type AttrOrigin NetworkServiceProtocolPropertyInfo :: * # Methods attrGet :: AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo o => Proxy * NetworkServiceProtocolPropertyInfo -> o -> IO (AttrGetType NetworkServiceProtocolPropertyInfo) # attrSet :: (AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo o, AttrSetTypeConstraint NetworkServiceProtocolPropertyInfo b) => Proxy * NetworkServiceProtocolPropertyInfo -> o -> b -> IO () # attrClear :: AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo o => Proxy * NetworkServiceProtocolPropertyInfo -> o -> IO () # attrConstruct :: (AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo o, AttrSetTypeConstraint NetworkServiceProtocolPropertyInfo b) => Proxy * NetworkServiceProtocolPropertyInfo -> b -> IO (GValueConstruct o) #
type AttrOrigin NetworkServiceProtocolPropertyInfo Source #
type AttrOrigin NetworkServiceProtocolPropertyInfo = NetworkService
type AttrLabel NetworkServiceProtocolPropertyInfo Source #
type AttrLabel NetworkServiceProtocolPropertyInfo = "protocol"
type AttrGetType NetworkServiceProtocolPropertyInfo Source #
type AttrGetType NetworkServiceProtocolPropertyInfo = Text
type AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo Source #
type AttrBaseTypeConstraint NetworkServiceProtocolPropertyInfo = IsNetworkService
type AttrSetTypeConstraint NetworkServiceProtocolPropertyInfo Source #
type AttrSetTypeConstraint NetworkServiceProtocolPropertyInfo = * ~ Text
type AttrAllowedOps NetworkServiceProtocolPropertyInfo Source #
type AttrAllowedOps NetworkServiceProtocolPropertyInfo = (:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ((:) AttrOpTag AttrClear ([] AttrOpTag)))

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

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

networkServiceProtocol :: AttrLabelProxy "protocol" Source #

scheme

data NetworkServiceSchemePropertyInfo Source #

Instances

AttrInfo NetworkServiceSchemePropertyInfo Source #
Associated Types type AttrAllowedOps NetworkServiceSchemePropertyInfo :: [AttrOpTag] # type AttrSetTypeConstraint NetworkServiceSchemePropertyInfo :: * -> Constraint # type AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo :: * -> Constraint # type AttrGetType NetworkServiceSchemePropertyInfo :: * # type AttrLabel NetworkServiceSchemePropertyInfo :: Symbol # type AttrOrigin NetworkServiceSchemePropertyInfo :: * # Methods attrGet :: AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo o => Proxy * NetworkServiceSchemePropertyInfo -> o -> IO (AttrGetType NetworkServiceSchemePropertyInfo) # attrSet :: (AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo o, AttrSetTypeConstraint NetworkServiceSchemePropertyInfo b) => Proxy * NetworkServiceSchemePropertyInfo -> o -> b -> IO () # attrClear :: AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo o => Proxy * NetworkServiceSchemePropertyInfo -> o -> IO () # attrConstruct :: (AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo o, AttrSetTypeConstraint NetworkServiceSchemePropertyInfo b) => Proxy * NetworkServiceSchemePropertyInfo -> b -> IO (GValueConstruct o) #
type AttrOrigin NetworkServiceSchemePropertyInfo Source #
type AttrOrigin NetworkServiceSchemePropertyInfo = NetworkService
type AttrLabel NetworkServiceSchemePropertyInfo Source #
type AttrLabel NetworkServiceSchemePropertyInfo = "scheme"
type AttrGetType NetworkServiceSchemePropertyInfo Source #
type AttrGetType NetworkServiceSchemePropertyInfo = Text
type AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo Source #
type AttrBaseTypeConstraint NetworkServiceSchemePropertyInfo = IsNetworkService
type AttrSetTypeConstraint NetworkServiceSchemePropertyInfo Source #
type AttrSetTypeConstraint NetworkServiceSchemePropertyInfo = * ~ Text
type AttrAllowedOps NetworkServiceSchemePropertyInfo Source #
type AttrAllowedOps NetworkServiceSchemePropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

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

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

networkServiceScheme :: AttrLabelProxy "scheme" Source #

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

service

data NetworkServiceServicePropertyInfo Source #

Instances

AttrInfo NetworkServiceServicePropertyInfo Source #
Associated Types type AttrAllowedOps NetworkServiceServicePropertyInfo :: [AttrOpTag] # type AttrSetTypeConstraint NetworkServiceServicePropertyInfo :: * -> Constraint # type AttrBaseTypeConstraint NetworkServiceServicePropertyInfo :: * -> Constraint # type AttrGetType NetworkServiceServicePropertyInfo :: * # type AttrLabel NetworkServiceServicePropertyInfo :: Symbol # type AttrOrigin NetworkServiceServicePropertyInfo :: * # Methods attrGet :: AttrBaseTypeConstraint NetworkServiceServicePropertyInfo o => Proxy * NetworkServiceServicePropertyInfo -> o -> IO (AttrGetType NetworkServiceServicePropertyInfo) # attrSet :: (AttrBaseTypeConstraint NetworkServiceServicePropertyInfo o, AttrSetTypeConstraint NetworkServiceServicePropertyInfo b) => Proxy * NetworkServiceServicePropertyInfo -> o -> b -> IO () # attrClear :: AttrBaseTypeConstraint NetworkServiceServicePropertyInfo o => Proxy * NetworkServiceServicePropertyInfo -> o -> IO () # attrConstruct :: (AttrBaseTypeConstraint NetworkServiceServicePropertyInfo o, AttrSetTypeConstraint NetworkServiceServicePropertyInfo b) => Proxy * NetworkServiceServicePropertyInfo -> b -> IO (GValueConstruct o) #
type AttrOrigin NetworkServiceServicePropertyInfo Source #
type AttrOrigin NetworkServiceServicePropertyInfo = NetworkService
type AttrLabel NetworkServiceServicePropertyInfo Source #
type AttrLabel NetworkServiceServicePropertyInfo = "service"
type AttrGetType NetworkServiceServicePropertyInfo Source #
type AttrGetType NetworkServiceServicePropertyInfo = Text
type AttrBaseTypeConstraint NetworkServiceServicePropertyInfo Source #
type AttrBaseTypeConstraint NetworkServiceServicePropertyInfo = IsNetworkService
type AttrSetTypeConstraint NetworkServiceServicePropertyInfo Source #
type AttrSetTypeConstraint NetworkServiceServicePropertyInfo = * ~ Text
type AttrAllowedOps NetworkServiceServicePropertyInfo Source #
type AttrAllowedOps NetworkServiceServicePropertyInfo = (:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ((:) AttrOpTag AttrClear ([] AttrOpTag)))

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

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

networkServiceService :: AttrLabelProxy "service" Source #