DBus.Client

dbus-1.3.11: A client library for the D-Bus IPC system.

Safe Haskell | None
Language | Haskell2010

DBus.Client

Contents

- Clients
- Path/Interface storage
- Connecting to a bus
- Sending method calls
- Receiving method calls
- Signals
  - Match rules
- Introspection
- Name reservation
- Client errors
- Advanced connection options

Description

D-Bus clients are an abstraction over the lower-level messaging system. When combined with an external daemon called the "bus", clients can perform remote procedure calls to other clients on the bus.

Clients may also listen for or emit signals, which are asynchronous broadcast notifications.

Example: connect to the session bus, and get a list of active names.

    {-# LANGUAGE OverloadedStrings #-}

    import Data.List (sort)
    import DBus
    import DBus.Client

    main = do
        client <- connectSession
        //
        -- Request a list of connected clients from the bus
        reply <- call_ client (methodCall "/org/freedesktop/DBus" "org.freedesktop.DBus" "ListNames")
            { methodCallDestination = Just "org.freedesktop.DBus"
            }
        //
        -- org.freedesktop.DBus.ListNames() returns a single value, which is
        -- a list of names (here represented as [String])
        let Just names = fromVariant (methodReturnBody reply !! 0)
        //
        -- Print each name on a line, sorted so reserved names are below
        -- temporary names.
        mapM_ putStrLn (sort names)

Synopsis

- data Client = Client {
  - clientSocket :: Socket
  - clientPendingCalls :: IORef (Map Serial (MVar (Either MethodError MethodReturn)))
  - clientSignalHandlers :: IORef (Map Unique SignalHandler)
  - clientObjects :: IORef PathInfo
  - clientThreadID :: ThreadId
  - clientInterfaces :: [Interface]
  }
- type DBusR a = ReaderT Client IO a
- data PathInfo = PathInfo {
  - _pathInterfaces :: [Interface]
  - _pathChildren :: Map String PathInfo
  }
- pathInterfaces :: Lens' PathInfo [Interface]
- pathChildren :: Lens' PathInfo (Map String PathInfo)
- pathLens :: Applicative f => ObjectPath -> ((PathInfo -> f PathInfo) -> Maybe PathInfo -> f (Maybe PathInfo)) -> (PathInfo -> f PathInfo) -> PathInfo -> f PathInfo
- findPath :: ObjectPath -> PathInfo -> Maybe PathInfo
- data Interface = Interface {
  - interfaceName :: InterfaceName
  - interfaceMethods :: [Method]
  - interfaceProperties :: [Property]
  - interfaceSignals :: [Signal]
  }
- defaultInterface :: Interface
- connect :: Address -> IO Client
- connectSystem :: IO Client
- connectSession :: IO Client
- connectStarter :: IO Client
- disconnect :: Client -> IO ()
- call :: Client -> MethodCall -> IO (Either MethodError MethodReturn)
- call_ :: Client -> MethodCall -> IO MethodReturn
- callNoReply :: Client -> MethodCall -> IO ()
- getProperty :: Client -> MethodCall -> IO (Either MethodError Variant)
- getPropertyValue :: IsValue a => Client -> MethodCall -> IO (Either MethodError a)
- setProperty :: Client -> MethodCall -> Variant -> IO (Either MethodError MethodReturn)
- setPropertyValue :: IsValue a => Client -> MethodCall -> a -> IO (Maybe MethodError)
- getAllProperties :: Client -> MethodCall -> IO (Either MethodError MethodReturn)
- getAllPropertiesMap :: Client -> MethodCall -> IO (Either MethodError (Map String Variant))
- buildPropertiesInterface :: Client -> Interface
- export :: Client -> ObjectPath -> Interface -> IO ()
- unexport :: Client -> ObjectPath -> IO ()
- data Method = Method {
  - methodName :: MemberName
  - inSignature :: Signature
  - outSignature :: Signature
  - methodHandler :: MethodCall -> DBusR Reply
  }
- makeMethod :: MemberName -> Signature -> Signature -> (MethodCall -> DBusR Reply) -> Method
- class AutoMethod a
- autoMethod :: AutoMethod fn => MemberName -> fn -> Method
- autoMethodWithMsg :: AutoMethod fn => MemberName -> (MethodCall -> fn) -> Method
- data Property = Property {
  - propertyName :: MemberName
  - propertyType :: Type
  - propertyGetter :: Maybe (IO Variant)
  - propertySetter :: Maybe (Variant -> IO ())
  }
- autoProperty :: IsValue v => MemberName -> Maybe (IO v) -> Maybe (v -> IO ()) -> Property
- readOnlyProperty :: IsValue v => MemberName -> IO v -> Property
- data Reply
  - = ReplyReturn [Variant]
  - | ReplyError ErrorName [Variant]
- throwError :: ErrorName -> String -> [Variant] -> IO a
- data SignalHandler
- addMatch :: Client -> MatchRule -> (Signal -> IO ()) -> IO SignalHandler
- removeMatch :: Client -> SignalHandler -> IO ()
- emit :: Client -> Signal -> IO ()
- listen :: Client -> MatchRule -> (Signal -> IO ()) -> IO ()
- data MatchRule
- formatMatchRule :: MatchRule -> String
- matchAny :: MatchRule
- matchSender :: MatchRule -> Maybe BusName
- matchDestination :: MatchRule -> Maybe BusName
- matchPath :: MatchRule -> Maybe ObjectPath
- matchInterface :: MatchRule -> Maybe InterfaceName
- matchMember :: MatchRule -> Maybe MemberName
- matchPathNamespace :: MatchRule -> Maybe ObjectPath
- buildIntrospectionObject :: [Interface] -> PathInfo -> [String] -> Object
- buildIntrospectionInterface :: Interface -> Interface
- buildIntrospectionMethod :: Method -> Method
- buildIntrospectionProperty :: Property -> Property
- buildIntrospectableInterface :: Client -> Interface
- requestName :: Client -> BusName -> [RequestNameFlag] -> IO RequestNameReply
- releaseName :: Client -> BusName -> IO ReleaseNameReply
- data RequestNameFlag
- nameAllowReplacement :: RequestNameFlag
- nameReplaceExisting :: RequestNameFlag
- nameDoNotQueue :: RequestNameFlag
- data RequestNameReply
  - = NamePrimaryOwner
  - | NameInQueue
  - | NameExists
  - | NameAlreadyOwner
  - | UnknownRequestNameReply Word32
- data ReleaseNameReply
  - = NameReleased
  - | NameNonExistent
  - | NameNotOwner
  - | UnknownReleaseNameReply Word32
- data ClientError
- clientError :: String -> ClientError
- clientErrorMessage :: ClientError -> String
- clientErrorFatal :: ClientError -> Bool
- data ClientOptions t
- clientSocketOptions :: ClientOptions t -> SocketOptions t
- clientThreadRunner :: ClientOptions t -> IO () -> IO ()
- defaultClientOptions :: ClientOptions SocketTransport
- connectWith :: TransportOpen t => ClientOptions t -> Address -> IO Client
- connectWithName :: TransportOpen t => ClientOptions t -> Address -> IO (Client, BusName)
- dbusName :: BusName
- dbusPath :: ObjectPath
- data ErrorName
- errorFailed :: ErrorName
- errorInvalidParameters :: ErrorName
- errorUnknownMethod :: ErrorName

# Clients

data Client #

An active client session to a message bus. Clients may send or receive method calls, and listen for or emit signals.

Constructors

Client |
Fields clientSocket :: Socket clientPendingCalls :: IORef (Map Serial (MVar (Either MethodError MethodReturn))) clientSignalHandlers :: IORef (Map Unique SignalHandler) clientObjects :: IORef PathInfo clientThreadID :: ThreadId clientInterfaces :: [Interface]

#### Instances

Instances details

IsValue a => AutoMethod (DBusR (Either Reply a)) # |
Instance details Defined in DBus.Client Methods funTypes :: DBusR (Either Reply a) -> ([Type], [Type]) apply :: DBusR (Either Reply a) -> [Variant] -> DBusR Reply
IsValue a => AutoMethod (DBusR a) # |
Instance details Defined in DBus.Client Methods funTypes :: DBusR a -> ([Type], [Type]) apply :: DBusR a -> [Variant] -> DBusR Reply

type DBusR a = ReaderT Client IO a #

# Path/Interface storage

data PathInfo #

Constructors

PathInfo |
Fields _pathInterfaces :: [Interface] _pathChildren :: Map String PathInfo

#### Instances

Instances details

Eq PathInfo # |
Instance details Defined in DBus.Client Methods (==) :: PathInfo -> PathInfo -> Bool # (/=) :: PathInfo -> PathInfo -> Bool #

pathInterfaces :: Lens' PathInfo [Interface] #

pathChildren :: Lens' PathInfo (Map String PathInfo) #

pathLens :: Applicative f => ObjectPath -> ((PathInfo -> f PathInfo) -> Maybe PathInfo -> f (Maybe PathInfo)) -> (PathInfo -> f PathInfo) -> PathInfo -> f PathInfo #

findPath :: ObjectPath -> PathInfo -> Maybe PathInfo #

data Interface #

Constructors

Interface |
Fields interfaceName :: InterfaceName interfaceMethods :: [Method] interfaceProperties :: [Property] interfaceSignals :: [Signal]

defaultInterface :: Interface #

# Connecting to a bus

connect :: Address -> IO Client #

Connect to the bus at the specified address.

Throws a `ClientError` on failure.

connectSystem :: IO Client #

Connect to the bus specified in the environment variable `DBUS_SYSTEM_BUS_ADDRESS`, or to `unix:path=/var/run/dbus/system_bus_socket` if `DBUS_SYSTEM_BUS_ADDRESS` is not set.

Throws a `ClientError` if `DBUS_SYSTEM_BUS_ADDRESS` contains an invalid address, or if connecting to the bus failed.

connectSession :: IO Client #

Connect to the bus specified in the environment variable `DBUS_SESSION_BUS_ADDRESS`, which must be set.

Throws a `ClientError` if `DBUS_SESSION_BUS_ADDRESS` is unset, contains an invalid address, or if connecting to the bus failed.

connectStarter :: IO Client #

Connect to the bus specified in the environment variable `DBUS_STARTER_ADDRESS`, which must be set.

Throws a `ClientError` if `DBUS_STARTER_ADDRESS` is unset, contains an invalid address, or if connecting to the bus failed.

disconnect :: Client -> IO () #

Stop a `Client'`s callback thread and close its underlying socket.

# Sending method calls

call :: Client -> MethodCall -> IO (Either MethodError MethodReturn) #

Send a method call to the bus, and wait for the response.

Throws a `ClientError` if the method call couldn't be sent, or if the reply couldn't be parsed.

call_ :: Client -> MethodCall -> IO MethodReturn #

Send a method call to the bus, and wait for the response.

Unsets the `noReplyExpected` message flag before sending.

Throws a `ClientError` if the method call couldn't sent, if the reply couldn't be parsed, or if the reply was a `MethodError`.

callNoReply :: Client -> MethodCall -> IO () #

Send a method call to the bus, and do not wait for a response.

Sets the `noReplyExpected` message flag before sending.

Throws a `ClientError` if the method call couldn't be sent.

getProperty :: Client -> MethodCall -> IO (Either MethodError Variant) #

Retrieve a property using the method call parameters that were provided.

Throws a `ClientError` if the property request couldn't be sent.

getPropertyValue :: IsValue a => Client -> MethodCall -> IO (Either MethodError a) #

setProperty :: Client -> MethodCall -> Variant -> IO (Either MethodError MethodReturn) #

setPropertyValue :: IsValue a => Client -> MethodCall -> a -> IO (Maybe MethodError) #

getAllProperties :: Client -> MethodCall -> IO (Either MethodError MethodReturn) #

getAllPropertiesMap :: Client -> MethodCall -> IO (Either MethodError (Map String Variant)) #

buildPropertiesInterface :: Client -> Interface #

# Receiving method calls

export :: Client -> ObjectPath -> Interface -> IO () #

Export the given `Interface` at the given `ObjectPath`

Use `autoMethod` to construct a `Method` from a function that accepts and returns simple types.

Use `method` to construct a `Method` from a function that handles parameter conversion manually.

    ping :: MethodCall -> IO Reply
    ping _ = ReplyReturn []

    sayHello :: String -> IO String
    sayHello name = return ("Hello " ++ name ++ "!")

     export client "/hello_world"
       defaultInterface { interfaceName = "com.example.HelloWorld"
                        , interfaceMethods =
                          [ method "com.example.HelloWorld" "Ping" ping
                          , autoMethod "com.example.HelloWorld" "Hello" sayHello
                          ]
                        }

unexport :: Client -> ObjectPath -> IO () #

Revokes the export of the given `ObjectPath`. This will remove all interfaces and methods associated with the path.

data Method #

Constructors

Method |
Fields methodName :: MemberName inSignature :: Signature outSignature :: Signature methodHandler :: MethodCall -> DBusR Reply

makeMethod #

Arguments

:: MemberName |
-> Signature | Input parameter signature
-> Signature | Output parameter signature
-> (MethodCall -> DBusR Reply) |
-> Method |

Define a method handler, which will accept method calls with the given interface and member name.

Note that the input and output parameter signatures are used for introspection, but are not checked when executing a method.

See `autoMethod` for an easier way to export functions with simple parameter and return types.

class AutoMethod a #

Used to automatically generate method signatures for introspection documents. To support automatic signatures, a method's parameters and return value must all be instances of `IsValue`.

This class maps Haskell idioms to D-Bus; it is therefore unable to generate some signatures. In particular, it does not support methods which accept/return a single structure, or single-element structures. It also cannot generate signatures for methods with parameters or return values which are only instances of `IsVariant`. For these cases, please use `method`.

To match common Haskell use, if the return value is a tuple, it will be converted to a list of return values.

Minimal complete definition

funTypes, apply

#### Instances

Instances details

IsValue a => AutoMethod (DBusR (Either Reply a)) # |
Instance details Defined in DBus.Client Methods funTypes :: DBusR (Either Reply a) -> ([Type], [Type]) apply :: DBusR (Either Reply a) -> [Variant] -> DBusR Reply
IsValue a => AutoMethod (DBusR a) # |
Instance details Defined in DBus.Client Methods funTypes :: DBusR a -> ([Type], [Type]) apply :: DBusR a -> [Variant] -> DBusR Reply
IsValue a => AutoMethod (IO (Either Reply a)) # |
Instance details Defined in DBus.Client Methods funTypes :: IO (Either Reply a) -> ([Type], [Type]) apply :: IO (Either Reply a) -> [Variant] -> DBusR Reply
IsValue a => AutoMethod (IO a) # |
Instance details Defined in DBus.Client Methods funTypes :: IO a -> ([Type], [Type]) apply :: IO a -> [Variant] -> DBusR Reply
(IsValue a, AutoMethod fn) => AutoMethod (a -> fn) # |
Instance details Defined in DBus.Client Methods funTypes :: (a -> fn) -> ([Type], [Type]) apply :: (a -> fn) -> [Variant] -> DBusR Reply

autoMethod :: AutoMethod fn => MemberName -> fn -> Method #

Prepare a Haskell function for export, automatically detecting the function's type signature.

See `AutoMethod` for details on the limitations of this function.

See `method` for exporting functions with user-defined types.

autoMethodWithMsg :: AutoMethod fn => MemberName -> (MethodCall -> fn) -> Method #

data Property #

Constructors

Property |
Fields propertyName :: MemberName propertyType :: Type propertyGetter :: Maybe (IO Variant) propertySetter :: Maybe (Variant -> IO ())

autoProperty :: IsValue v => MemberName -> Maybe (IO v) -> Maybe (v -> IO ()) -> Property #

readOnlyProperty :: IsValue v => MemberName -> IO v -> Property #

data Reply #

Constructors

ReplyReturn [Variant] |
ReplyError ErrorName [Variant] |

#### Instances

Instances details

IsValue a => AutoMethod (DBusR (Either Reply a)) # |
Instance details Defined in DBus.Client Methods funTypes :: DBusR (Either Reply a) -> ([Type], [Type]) apply :: DBusR (Either Reply a) -> [Variant] -> DBusR Reply
IsValue a => AutoMethod (IO (Either Reply a)) # |
Instance details Defined in DBus.Client Methods funTypes :: IO (Either Reply a) -> ([Type], [Type]) apply :: IO (Either Reply a) -> [Variant] -> DBusR Reply

throwError #

Arguments

:: ErrorName |
-> String | Error message
-> [Variant] | Additional items of the error body
-> IO a |

Normally, any exceptions raised while executing a method will be given the generic `"org.freedesktop.DBus.Error.Failed"` name. `throwError` allows the programmer to specify an error name, and provide additional information to the remote application. You may use this instead of `throwIO` to abort a method call.

# Signals

data SignalHandler #

addMatch :: Client -> MatchRule -> (Signal -> IO ()) -> IO SignalHandler #

Request that the bus forward signals matching the given rule to this client, and process them in a callback.

A received signal might be processed by more than one callback at a time. Callbacks each run in their own thread.

The returned `SignalHandler` can be passed to `removeMatch` to stop handling this signal.

Throws a `ClientError` if the match rule couldn't be added to the bus.

removeMatch :: Client -> SignalHandler -> IO () #

Request that the bus stop forwarding signals for the given handler.

Throws a `ClientError` if the match rule couldn't be removed from the bus.

emit :: Client -> Signal -> IO () #

Emit the signal on the bus.

Throws a `ClientError` if the signal message couldn't be sent.

listen :: Client -> MatchRule -> (Signal -> IO ()) -> IO () #

Deprecated: Prefer DBus.Client.addMatch in new code.

Equivalent to `addMatch`, but does not return the added `SignalHandler`.

## Match rules

data MatchRule #

A match rule describes which signals a particular callback is interested in. Use `matchAny` to construct match rules.

Example: a match rule which matches signals sent by the root object.

    matchFromRoot :: MatchRule
    matchFromRoot = matchAny { matchPath = Just "/" }

#### Instances

Instances details

Show MatchRule # |
Instance details Defined in DBus.Client Methods showsPrec :: Int -> MatchRule -> ShowS # show :: MatchRule -> String # showList :: [MatchRule] -> ShowS #

formatMatchRule :: MatchRule -> String #

Convert a match rule into the textual format accepted by the bus.

matchAny :: MatchRule #

Match any signal.

matchSender :: MatchRule -> Maybe BusName #

If set, only receives signals sent from the given bus name.

The standard D-Bus implementation from http://dbus.freedesktop.org/ almost always sets signal senders to the unique name of the sending client. If `matchSender` is a requested name like `"com.example.Foo"`, it will not match any signals.

The exception is for signals sent by the bus itself, which always have a sender of `"org.freedesktop.DBus"`.

matchDestination :: MatchRule -> Maybe BusName #

If set, only receives signals sent to the given bus name.

matchPath :: MatchRule -> Maybe ObjectPath #

If set, only receives signals sent with the given path.

matchInterface :: MatchRule -> Maybe InterfaceName #

If set, only receives signals sent with the given interface name.

matchMember :: MatchRule -> Maybe MemberName #

If set, only receives signals sent with the given member name.

matchPathNamespace :: MatchRule -> Maybe ObjectPath #

If set, only receives signals sent with the given path or any of its children.

# Introspection

buildIntrospectionObject :: [Interface] -> PathInfo -> [String] -> Object #

buildIntrospectionInterface :: Interface -> Interface #

buildIntrospectionMethod :: Method -> Method #

buildIntrospectionProperty :: Property -> Property #

buildIntrospectableInterface :: Client -> Interface #

# Name reservation

requestName :: Client -> BusName -> [RequestNameFlag] -> IO RequestNameReply #

Asks the message bus to assign the given name to this client. The bus maintains a queue of possible owners, where the head of the queue is the current ("primary") owner.

There are several uses for name reservation:

- Clients which export methods reserve a name so users and applications can send them messages. For example, the GNOME Keyring reserves the name `"org.gnome.keyring"` on the user's session bus, and NetworkManager reserves `"org.freedesktop.NetworkManager"` on the system bus.
- When there are multiple implementations of a particular service, the service standard will ususally include a generic bus name for the service. This allows other clients to avoid depending on any particular implementation's name. For example, both the GNOME Keyring and KDE KWallet services request the `"org.freedesktop.secrets"` name on the user's session bus.
- A process with "single instance" behavior can use name assignment to check whether the instance is already running, and invoke some method on it (e.g. opening a new window).

Throws a `ClientError` if the call failed.

releaseName :: Client -> BusName -> IO ReleaseNameReply #

Release a name that this client previously requested. See `requestName` for an explanation of name reservation.

Throws a `ClientError` if the call failed.

data RequestNameFlag #

#### Instances

Instances details

Show RequestNameFlag # |
Instance details Defined in DBus.Client Methods showsPrec :: Int -> RequestNameFlag -> ShowS # show :: RequestNameFlag -> String # showList :: [RequestNameFlag] -> ShowS #
Eq RequestNameFlag # |
Instance details Defined in DBus.Client Methods (==) :: RequestNameFlag -> RequestNameFlag -> Bool # (/=) :: RequestNameFlag -> RequestNameFlag -> Bool #

nameAllowReplacement :: RequestNameFlag #

Allow this client's reservation to be replaced, if another client requests it with the `nameReplaceExisting` flag.

If this client's reservation is replaced, this client will be added to the wait queue unless the request also included the `nameDoNotQueue` flag.

nameReplaceExisting :: RequestNameFlag #

If the name being requested is already reserved, attempt to replace it. This only works if the current owner provided the `nameAllowReplacement` flag.

nameDoNotQueue :: RequestNameFlag #

If the name is already in use, do not add this client to the queue, just return an error.

data RequestNameReply #

Constructors

NamePrimaryOwner | This client is now the primary owner of the requested name.
NameInQueue | The name was already reserved by another client, and replacement was either not attempted or not successful.
NameExists | The name was already reserved by another client, `DoNotQueue` was set, and replacement was either not attempted or not successful.
NameAlreadyOwner | This client is already the primary owner of the requested name.
UnknownRequestNameReply Word32 | Not exported; exists to generate a compiler warning if users case on the reply and forget to include a default case.

#### Instances

Instances details

Show RequestNameReply # |
Instance details Defined in DBus.Client Methods showsPrec :: Int -> RequestNameReply -> ShowS # show :: RequestNameReply -> String # showList :: [RequestNameReply] -> ShowS #
Eq RequestNameReply # |
Instance details Defined in DBus.Client Methods (==) :: RequestNameReply -> RequestNameReply -> Bool # (/=) :: RequestNameReply -> RequestNameReply -> Bool #

data ReleaseNameReply #

Constructors

NameReleased | This client has released the provided name.
NameNonExistent | The provided name is not assigned to any client on the bus.
NameNotOwner | The provided name is not assigned to this client.
UnknownReleaseNameReply Word32 | Not exported; exists to generate a compiler warning if users case on the reply and forget to include a default case.

#### Instances

Instances details

Show ReleaseNameReply # |
Instance details Defined in DBus.Client Methods showsPrec :: Int -> ReleaseNameReply -> ShowS # show :: ReleaseNameReply -> String # showList :: [ReleaseNameReply] -> ShowS #
Eq ReleaseNameReply # |
Instance details Defined in DBus.Client Methods (==) :: ReleaseNameReply -> ReleaseNameReply -> Bool # (/=) :: ReleaseNameReply -> ReleaseNameReply -> Bool #

# Client errors

data ClientError #

#### Instances

Instances details

Exception ClientError # |
Instance details Defined in DBus.Client Methods toException :: ClientError -> SomeException # fromException :: SomeException -> Maybe ClientError # displayException :: ClientError -> String # backtraceDesired :: ClientError -> Bool #
Show ClientError # |
Instance details Defined in DBus.Client Methods showsPrec :: Int -> ClientError -> ShowS # show :: ClientError -> String # showList :: [ClientError] -> ShowS #
Eq ClientError # |
Instance details Defined in DBus.Client Methods (==) :: ClientError -> ClientError -> Bool # (/=) :: ClientError -> ClientError -> Bool #

clientError :: String -> ClientError #

clientErrorMessage :: ClientError -> String #

clientErrorFatal :: ClientError -> Bool #

# Advanced connection options

data ClientOptions t #

clientSocketOptions :: ClientOptions t -> SocketOptions t #

Options for the underlying socket, for advanced use cases. See the DBus.Socket module.

clientThreadRunner :: ClientOptions t -> IO () -> IO () #

A function to run the client thread. The provided IO computation should be called repeatedly; each time it is called, it will process one incoming message.

The provided computation will throw a `ClientError` if it fails to process an incoming message, or if the connection is lost.

The default implementation is `forever`.

defaultClientOptions :: ClientOptions SocketTransport #

Default client options. Uses the built-in Socket-based transport, which supports the `tcp:` and `unix:` methods.

connectWith :: TransportOpen t => ClientOptions t -> Address -> IO Client #

Connect to the bus at the specified address, with the given connection options. Most users should use `connect` instead.

Throws a `ClientError` on failure.

connectWithName :: TransportOpen t => ClientOptions t -> Address -> IO (Client, BusName) #

Connect to the bus at the specified address, with the given connection options, and return the unique client bus name. Most users should use `connect` or `connectWith` instead.

Throws a `ClientError` on failure.

dbusName :: BusName #

dbusPath :: ObjectPath #

data ErrorName #

Error names are used to identify which type of error was returned from a method call. Error names consist of alphanumeric characters separated by periods.

See http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-error for details.

#### Instances

Instances details

IsVariant ErrorName # |
Instance details Defined in DBus.Internal.Types Methods toVariant :: ErrorName -> Variant # fromVariant :: Variant -> Maybe ErrorName #
NFData ErrorName # |
Instance details Defined in DBus.Internal.Types Methods rnf :: ErrorName -> () #
IsString ErrorName # |
Instance details Defined in DBus.Internal.Types Methods fromString :: String -> ErrorName #
Show ErrorName # |
Instance details Defined in DBus.Internal.Types Methods showsPrec :: Int -> ErrorName -> ShowS # show :: ErrorName -> String # showList :: [ErrorName] -> ShowS #
Eq ErrorName # |
Instance details Defined in DBus.Internal.Types Methods (==) :: ErrorName -> ErrorName -> Bool # (/=) :: ErrorName -> ErrorName -> Bool #
Ord ErrorName # |
Instance details Defined in DBus.Internal.Types Methods compare :: ErrorName -> ErrorName -> Ordering # (<) :: ErrorName -> ErrorName -> Bool # (<=) :: ErrorName -> ErrorName -> Bool # (>) :: ErrorName -> ErrorName -> Bool # (>=) :: ErrorName -> ErrorName -> Bool # max :: ErrorName -> ErrorName -> ErrorName # min :: ErrorName -> ErrorName -> ErrorName #

errorFailed :: ErrorName #

errorInvalidParameters :: ErrorName #

errorUnknownMethod :: ErrorName #