The dbus package

[Tags:gpl, library]

D‑Bus is a simple, message-based protocol for inter-process communication, which allows applications to interact with other parts of the machine and the user's session using remote procedure calls.

D‑Bus is a essential part of the modern Linux desktop, where it replaces earlier protocols such as CORBA and DCOP.

This library is an implementation of the D‑Bus protocol in Haskell. It can be used to add D‑Bus support to Haskell applications, without the awkward interfaces common to foreign bindings.

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)
$ ghc --make list-names.hs
$ ./list-names
:1.0
:1.1
:1.10
:1.106
:1.109
:1.110
ca.desrt.dconf
org.freedesktop.DBus
org.freedesktop.Notifications
org.freedesktop.secrets
org.gnome.ScreenSaver

Properties

Versions 0.10, 0.10.1, 0.10.2, 0.10.3, 0.10.4, 0.10.5, 0.10.6, 0.10.7, 0.10.8, 0.10.9, 0.10.9.1, 0.10.9.2, 0.10.10, 0.10.11, 0.10.12
Dependencies base (>=4.0 && <5.0), bytestring (==0.9.*), cereal (>=0.3.4 && <0.4), containers (>=0.1 && <0.6), libxml-sax (==0.7.*), network (>=2.2 && <2.4), network-bytestring (>=0.1.2 && <0.2), parsec (>=2.0 && <3.2), random (==1.0.*), text (>=0.11.1.5 && <0.12), transformers (>=0.2 && <0.4), unix (>=2.2 && <2.6), vector (>=0.7 && <0.10), xml-types (==0.3.*) [details]
License GPL-3
Author John Millikin <jmillikin@gmail.com>
Maintainer John Millikin <jmillikin@gmail.com>
Stability experimental
Category Network, Desktop
Home page https://john-millikin.com/software/haskell-dbus/
Bug tracker mailto:jmillikin@gmail.com
Source repository head: bzr branch https://john-millikin.com/branches/haskell-dbus/0.10/
this: bzr branch https://john-millikin.com/branches/haskell-dbus/0.10/ -r haskell-dbus_0.10
Uploaded Sat Jun 23 15:17:56 UTC 2012 by JohnMillikin
Distributions Arch:0.10.12, Debian:0.10.11, Fedora:0.10.12, LTSHaskell:0.10.12, NixOS:0.10.12
Downloads 8559 total (51 in the last 30 days)
Votes
0 []
Status Docs uploaded by user
Build status unknown [no reports yet]

Modules

[Index]

Flags

NameDescriptionDefaultType
network-bytestring-610DisabledAutomatic
network-bytestringEnabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

For package maintainers and hackage trustees