DBus.MainLoop

Documentation

handleMessage :: (MessageHeader -> [SomeDBusValue] -> IO ()) -> (MessageHeader -> [SomeDBusValue] -> IO a) -> TVar AnswerSlots -> TVar SignalSlots -> TVar PropertySlots -> (MessageHeader, [SomeDBusValue]) -> IO ()

objectRoot :: Objects -> Handler

Create a message handler that dispatches matches to the methods in a root object

checkAlive :: DBusConnection -> IO Bool

Check whether connection is alive

waitFor :: DBusConnection -> IO ()

Wait until connection is closed. The intended use is to keep alive servers

data ConnectionType

Which Bus to connect to

Constructors

System

The well-known system bus. First the environmental variable DBUS_SYSTEM_BUS_ADDRESS is checked and if it doesn't exist the address unix:path=/var/run/dbus/system_bus_socket is used

Session

The well-known session bus. Refers to the address stored in the environmental variable DBUS_SESSION_BUS_ADDRESS

Address String

The bus at the give addresss

type MethodCallHandler

Arguments

 = DBusConnection

Connection that the call was received from. Should be used to return the result or error

-> MessageHeader

-> [SomeDBusValue]

-> IO ()

type SignalHandler = DBusConnection -> MessageHeader -> [SomeDBusValue] -> IO ()

connectBus

Arguments

:: ConnectionType

Bus to connect to

-> MethodCallHandler

Handler for incoming method calls

-> SignalHandler

Handler for incoming signals

-> IO DBusConnection

General way to connect to a message bus, see connectBusWithAuth.

Uses the EXTERNAL authentication mechanism.

connectBusWithAuth

Arguments

:: ConnectionType

Bus to connect to

-> SASL ByteString

The authentication mechanism

-> MethodCallHandler

Handler for incoming method calls

-> SignalHandler

Handler for incoming signals

-> IO DBusConnection

General way to connect to a message bus, with a custom authentication method. Takes two callback functions:

• A MethodCallHandler that is invoked when a method call is received.
• A SignalHandler that is invoked when a Signak is received:

makeServer :: ConnectionType -> Objects -> IO DBusConnection

Create a simple server that exports Objects and ignores all incoming signals.

Use the default EXTERNAL authentication mechanism (see makeServerWithAuth).

makeServerWithAuth :: ConnectionType -> SASL ByteString -> Objects -> IO DBusConnection

Create a simple server with a custom bus authentication mechanism that exports Objects and ignores all incoming signals.

type Handler = DBusConnection -> MessageHeader -> [SomeDBusValue] -> IO ()

sendCredentials :: Socket -> IO Int

close :: DBusConnection -> IO ()

Close the connection and finalize all handlers.

This is automatically done when the connection is garbage collected, but