git-annex/Utility/DBus.hs
Joey Hess ef7b53e784 improved dbus error handling
Now when the dbus connection is dropped, it'll fall back to polling.

I could make it try to reconnect, but there's a FD leak in the dbus
library, so not yet.
2012-10-26 00:02:03 -04:00

85 lines
2.9 KiB
Haskell

{- DBus utilities
-
- Copyright 2012 Joey Hess <joey@kitenet.net>
-
- Licensed under the GNU GPL version 3 or higher.
-}
{-# LANGUAGE OverloadedStrings #-}
module Utility.DBus where
import DBus.Client
import DBus
import Data.Maybe
import Control.Concurrent
import Control.Exception as E
type ServiceName = String
listServiceNames :: Client -> IO [ServiceName]
listServiceNames client = do
reply <- callDBus client "ListNames" []
return $ fromMaybe [] $ fromVariant (methodReturnBody reply !! 0)
callDBus :: Client -> MemberName -> [Variant] -> IO MethodReturn
callDBus client name params = call_ client $
(methodCall "/org/freedesktop/DBus" "org.freedesktop.DBus" name)
{ methodCallDestination = Just "org.freedesktop.DBus"
, methodCallBody = params
}
{- Connects to the bus, and runs the client action.
-
- Throws a ClientError, and closes the connection if it fails to
- process an incoming message, or if the connection is lost.
- Unlike DBus's usual interface, this error is thrown at the top level,
- rather than inside the clientThreadRunner, so it can be caught, and
- runClient re-run as needed. -}
runClient :: IO (Maybe Address) -> (Client -> IO ()) -> IO ()
runClient getaddr clientaction = do
env <- getaddr
case env of
Nothing -> throwIO (clientError "runClient: unable to determine DBUS address")
Just addr -> do
{- The clientaction will set up listeners, which
- run in a different thread. We block while
- they're running, until our threadrunner catches
- a ClientError, which it will put into the MVar
- to be rethrown here. -}
mv <- newEmptyMVar
let tr = threadrunner (putMVar mv)
let opts = defaultClientOptions { clientThreadRunner = tr }
client <- connectWith opts addr
clientaction client
e <- takeMVar mv
disconnect client
throw e
where
threadrunner storeerr io = loop
where
loop = catchClientError (io >> loop) storeerr
{- Connects to the bus, and runs the client action.
-
- If the connection is lost, runs onretry, which can do something like
- a delay, or printing a warning, and has a state value (useful for
- exponential backoff). Once onretry returns, the connection is retried.
-
- Warning: Currently connectWith can throw a SocketError and leave behind
- an open FD. So each retry leaks one FD. -}
persistentClient :: IO (Maybe Address) -> v -> (SomeException -> v -> IO v) -> (Client -> IO ()) -> IO ()
persistentClient getaddr v onretry clientaction = do
{- runClient can fail with not just ClientError, but also other
- things, if dbus is not running. -}
r <- E.try (runClient getaddr clientaction) :: IO (Either SomeException ())
either retry return r
where
retry e = do
v' <- onretry e v
persistentClient getaddr v' onretry clientaction
{- Catches only ClientError -}
catchClientError :: IO () -> (ClientError -> IO ()) -> IO ()
catchClientError io handler = do
either handler return =<< (E.try io :: IO (Either ClientError ()))