dbus

A client library for the D-Bus IPC system.

https://github.com/rblaze/haskell-dbus#readme

Version on this page:	1.2.28
LTS Haskell 21.13:	1.2.29
Stackage Nightly 2023-09-25:	1.3.1
Latest on Hackage:	1.3.1

See all snapshots dbus appears in

Apache-2.0 licensed by John Millikin

Maintained by Andrey Sverdlichenko

This version can be pinned in stack with:dbus-1.2.28@sha256:2f6b95393e32c9be8352796059e738e814a9b9a1131f6fad6578dca0355e80d4,4562

Module documentation for 1.2.28

DBus

Depends on 21 packages(full list with versions):

base, bytestring, cereal, conduit, containers, deepseq, exceptions, filepath, lens, network, parsec, random, split, template-haskell, text, th-lift, transformers, unix, vector, xml-conduit, xml-types

Used by 5 packages in lts-20.23(full list with versions):

credential-store, dbus-hslogger, fdo-notify, gtk-sni-tray, status-notifier-item

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