DBus.Connection

Connection Basics

type Connection = ForeignPtr ConnectionTag

data BusType

Multiple buses may be active simultaneously on a single system. The BusType indicates which one to use.

Constructors

Session

The session bus is restricted to the user's current GNOME session.

System

This bus is system-wide.

Starter

The bus that started us, if any.

busGet :: BusType -> IO Connection

Connect to a standard bus.

busConnectionUnref :: Connection -> IO ()

Force the dereference of a connection. Note that this is usually not necessary since the connections are garbage collected automatically.

send

Arguments

:: Connection

-> Message

-> Word32

Serial.

-> IO Word32

Returned serial.

Adds a Message to the outgoing message queue.

sendWithReplyAndBlock

Arguments

:: Connection

-> Message

-> Int

Timeout in milliseconds.

-> IO Message

flush :: Connection -> IO ()

Block until all pending messages have been sent.

close :: Connection -> IO ()

withConnection :: BusType -> (Connection -> IO a) -> IO a

Open a connection and run an IO action, ensuring it is properly closed when you're done.

Main Loop Management

readWriteDispatch

Arguments

:: Connection

-> Int

Timeout, in milliseconds.

-> IO Bool

Block until a message is read or written, then return True unless a disconnect message is received.

addFilter

Arguments

:: Connection

-> (Message -> IO Bool)

A callback that returns True if the message has been handled.

-> IO ()

addMatch

Arguments

:: Connection

-> Bool

Whether to block waiting for a response, allowing us to raise an exception if a response never comes.

-> String

-> IO ()

data RequestNameReply

Constructors

PrimaryOwner

InQueue

Exists

AlreadyOwner

busRequestName :: Connection -> String -> [Int] -> IO RequestNameReply