git.iko.soy/distributed-process
on master help sign in
7 files changed+237−106
since splitsnapshots
unifiedsplit
distributed-process-tests/distributed-process-tests.cabal+1−1 distributed-process-tests/src/Control/Distributed/Process/Tests/CH.hs+104−25 distributed-process-tests/src/Control/Distributed/Process/Tests/Internal/Utils.hs+3−1 distributed-process-tests/src/Control/Distributed/Process/Tests/Mx.hs+87−75 distributed-process.cabal+1−1 src/Control/Distributed/Process/Internal/Primitives.hs+7−1 src/Control/Distributed/Process/Management.hs+34−2
distributed-process-tests/distributed-process-tests.cabal+1−1
@@ -6,7 +6,7 @@ description: Tests and test suite for Cloud Haskell libraries.
66license: BSD3
77license-file: LICENSE
88Author: Duncan Coutts, Nicolas Wu, Edsko de Vries
9−Maintainer: Facundo Domínguez <facundo.dominguez@tweag.io>
9+Maintainer: Tim Watson <watson.timothy@gmail.com>
1010copyright: Well-Typed LLP
1111category: Control, Cloud Haskell
1212build-type: Simple
distributed-process-tests/src/Control/Distributed/Process/Tests/CH.hs+104−25
@@ -46,11 +46,11 @@ import Control.Distributed.Process.Debug
4646import Control.Distributed.Process.Management.Internal.Types
4747import Control.Distributed.Process.Tests.Internal.Utils (shouldBe, pause)
4848import Control.Distributed.Process.Serializable (Serializable)
49−
49+import Data.Maybe (isNothing, isJust)
5050import Test.HUnit (Assertion, assertBool, assertFailure)
5151import Test.Framework (Test, testGroup)
5252import Test.Framework.Providers.HUnit (testCase)
53−import Control.Rematch hiding (match)
53+import Control.Rematch hiding (match, isNothing, isJust)
5454import Control.Rematch.Run (Match(..))
5555
5656newtype Ping = Ping ProcessId
@@ -735,7 +735,6 @@ testRemoteRegistry :: TestTransport -> Assertion
735735testRemoteRegistry TestTransport{..} = do
736736 node1 <- newLocalNode testTransport initRemoteTable
737737 node2 <- newLocalNode testTransport initRemoteTable
738− done <- newEmptyMVar
739738
740739 pingServer <- forkProcess node1 ping
741740 deadProcess <- forkProcess node1 (return ())
@@ -750,6 +749,7 @@ testRemoteRegistry TestTransport{..} = do
750749
751750 pid <- verifyWhereIsRemote nid1 "ping"
752751 liftIO $ assertBool "Expected pindServer to match pid" $ pingServer == pid
752+
753753 us <- getSelfPid
754754 nsendRemote nid1 "ping" (Pong us)
755755 receiveWait [
@@ -759,22 +759,22 @@ testRemoteRegistry TestTransport{..} = do
759759 -- test that if process was not registered Nothing is returned
760760 -- in owner field.
761761 registerRemoteAsync nid1 "dead" deadProcess
762− receiveWait [
763− matchIf (\(RegisterReply label' False Nothing) -> "dead" == label')
764− (\(RegisterReply _ _ _) -> return ()) ]
762+ receiveWait [ matchIf (\(RegisterReply label' f mPid) -> "dead" == label')
763+ (\(RegisterReply _ f mPid) -> return (not f && isNothing mPid))
764+ ] >>= liftIO . assertBool "Expected False Nothing in RegisterReply"
765+
765766 registerRemoteAsync nid1 "ping" deadProcess
766767 receiveWait [
767− matchIf (\(RegisterReply label' False (Just pid'')) ->
768− "ping" == label' && pid'' == pingServer)
769− (\(RegisterReply _ _ _) -> return ()) ]
768+ matchIf (\(RegisterReply label' False mPid) ->
769+ "ping" == label' && isJust mPid)
770+ (\(RegisterReply _ f (Just pid'')) -> return (not f && pid'' == pingServer))
771+ ] >>= liftIO . assertBool "Expected False and (Just alreadyRegisteredPid) in RegisterReply"
772+
770773 unregisterRemoteAsync nid1 "dead"
771774 receiveWait [
772− matchIf (\(RegisterReply label' False Nothing) ->
773− "dead" == label' && pid == pingServer)
774− (\(RegisterReply _ _ _) -> return ()) ]
775− liftIO $ putMVar done ()
776−
777− takeMVar done
775+ matchIf (\(RegisterReply label' _ _) -> "dead" == label')
776+ (\(RegisterReply _ f mPid) -> return (not f && isNothing mPid))
777+ ] >>= liftIO . assertBool "Expected False and Nothing in RegisterReply"
778778
779779testRemoteRegistryRemoteProcess :: TestTransport -> Assertion
780780testRemoteRegistryRemoteProcess TestTransport{..} = do
@@ -1272,6 +1272,76 @@ testReceiveChanFeatures TestTransport{..} = do
12721272
12731273 takeMVar done
12741274
1275+testChanLifecycle :: TestTransport -> Assertion
1276+testChanLifecycle TestTransport{..} = let delay = 3000000 in do
1277+ result <- newEmptyMVar
1278+ tchMV <- newEmptyMVar
1279+ localNode <- newLocalNode testTransport initRemoteTable
1280+ runProcess localNode $ do
1281+
1282+ pid <- spawnLocal $ do tCh <- newChan :: Process (SendPort (), ReceivePort ())
1283+ liftIO $ putMVar tchMV tCh
1284+ expect :: Process ()
1285+ let (sp, _) = tCh
1286+ sendChan sp ()
1287+ expect :: Process ()
1288+
1289+ mRefPid <- monitor pid
1290+
1291+ cPid <- spawnLocal $ do
1292+ (sp', rp) <- liftIO $ takeMVar tchMV
1293+ -- say "picked up our test channel"
1294+ send pid ()
1295+ -- say "told pid to continue"
1296+ res <- receiveChanTimeout delay rp
1297+ case res of
1298+ Nothing -> say "initial chan () missing!" >> (liftIO $ putMVar result False)
1299+ Just () -> do mr <- monitor pid
1300+ pause 10000
1301+ -- say "sending pid a second () will cause it to exit"
1302+ send pid ()
1303+
1304+ -- say "make sure we see a DOWN notification for pid having stopped"
1305+ receiveWait [ match (\(_ :: ProcessMonitorNotification) -> return ()) ]
1306+
1307+ -- now that pid has died, the send port should be useless...
1308+ liftIO $ putMVar tchMV (sp', rp)
1309+
1310+ -- let's verify that we do not see the message from our
1311+ -- parent process on the channel, once pid has died...
1312+ recv <- receiveChanTimeout delay rp
1313+ -- say $ "finished waiting for second (), writing result" ++ (show recv)
1314+ liftIO $ putMVar result $ isNothing recv
1315+
1316+ mRefCPid <- monitor cPid
1317+
1318+ receiveWait
1319+ [ matchIf (\(ProcessMonitorNotification r _ _) -> r == mRefPid)
1320+ (\_ -> return ())
1321+ ]
1322+
1323+ -- say "seen first pid die..."
1324+
1325+ (sendPort, _) <- liftIO $ takeMVar tchMV
1326+ sendChan sendPort ()
1327+ -- say "sent () after owning pid died"
1328+
1329+ -- let cPid know we've written to the channel...
1330+ send cPid ()
1331+
1332+ receiveWait
1333+ [ matchIf (\(ProcessMonitorNotification r _ _) -> r == mRefCPid)
1334+ (\_ -> return ())
1335+ ]
1336+
1337+ -- say "seen both pids die now..."
1338+
1339+ -- and wait on the result back in IO land...
1340+ testRes <- takeMVar result
1341+ -- runProcess localNode $ say "got result..."
1342+ assertBool "Expected sending on the channel to fail, but received data!" testRes
1343+
1344+
12751345testKillLocal :: TestTransport -> Assertion
12761346testKillLocal TestTransport{..} = do
12771347 localNode <- newLocalNode testTransport initRemoteTable
@@ -1486,20 +1556,24 @@ testRegistryMonitoring :: TestTransport -> Assertion
14861556testRegistryMonitoring TestTransport{..} = do
14871557 node1 <- newLocalNode testTransport initRemoteTable
14881558 node2 <- newLocalNode testTransport initRemoteTable
1489− waitH <- newEmptyMVar
14901559
14911560 let nid = localNodeId node2
14921561 pid <- forkProcess node1 $ do
1493− getSelfPid >>= runUntilRegistered nid
1494− liftIO $ takeMVar waitH
1562+ self <- getSelfPid
1563+ runUntilRegistered nid self
1564+ say $ (show self) ++ " registered as " ++ regName
1565+ expect :: Process ()
1566+ say $ (show self) ++ " exiting normally"
14951567
14961568 runProcess node2 $ do
14971569 register regName pid
1570+ say $ regName ++ " registered to " ++ show pid
14981571 res <- whereis regName
1572+ send pid ()
1573+ say $ " sent finish signal to " ++ show pid
14991574 us <- getSelfPid
1500− liftIO $ do
1501− putMVar waitH ()
1502− assertBool "expected (Just pid)" $ res == (Just pid)
1575+ liftIO $ assertBool "expected (Just pid)" $ res == (Just pid)
1576+
15031577
15041578 -- This delay isn't essential!
15051579 -- The test case passes perfectly fine without it (feel free to comment out
@@ -1524,7 +1598,9 @@ testRegistryMonitoring TestTransport{..} = do
15241598 regHere <- newEmptyMVar
15251599 runProcess node2 $ whereis regName >>= liftIO . putMVar regHere
15261600 res <- takeMVar regHere
1527− assertBool "expected Nothing, but process still registered" (res == Nothing)
1601+ case res of
1602+ Nothing -> return ()
1603+ Just pid -> assertBool ("expected Nothing, but got " ++ show pid) False
15281604
15291605 where
15301606 runUntilRegistered nid us = do
@@ -1536,11 +1612,13 @@ testRegistryMonitoring TestTransport{..} = do
15361612
15371613 delayUntilMaybeUnregistered nid p = do
15381614 whereisRemoteAsync nid regName
1539− receiveTimeout 20000000 {- 20 sec delay -} [
1540− matchIf (\(WhereIsReply n p) -> n == regName && p == Nothing)
1615+ res <- receiveTimeout 20000000 {- 20 sec delay -} [
1616+ matchIf (\(WhereIsReply n p) -> n == regName && isNothing p)
15411617 (const $ return ())
15421618 ]
1543− return ()
1619+ case res of
1620+ Just () -> return ()
1621+ Nothing -> delayUntilMaybeUnregistered nid p
15441622
15451623 regName = "testRegisterRemote"
15461624
@@ -1736,6 +1814,7 @@ tests testtrans = return [
17361814 , testCase "MatchMessageUnwrap" (testMatchMessageWithUnwrap testtrans)
17371815 , testCase "ReceiveChanTimeout" (testReceiveChanTimeout testtrans)
17381816 , testCase "ReceiveChanFeatures" (testReceiveChanFeatures testtrans)
1817+ , testCase "ChanLifecycle" (testChanLifecycle testtrans)
17391818 , testCase "KillLocal" (testKillLocal testtrans)
17401819 , testCase "KillRemote" (testKillRemote testtrans)
17411820 , testCase "Die" (testDie testtrans)
distributed-process-tests/src/Control/Distributed/Process/Tests/Internal/Utils.hs+3−1
@@ -91,6 +91,7 @@ import Test.HUnit (Assertion, assertFailure)
9191import Test.HUnit.Base (assertBool)
9292
9393import GHC.Generics
94+import System.Timeout (timeout)
9495
9596-- | A mutable cell containing a test result.
9697type TestResult a = MVar a
@@ -233,7 +234,8 @@ testProcessReport pid = do
233234tryRunProcess :: LocalNode -> Process () -> IO ()
234235tryRunProcess node p = do
235236 tid <- liftIO myThreadId
236− runProcess node $ catch p (\e -> liftIO $ throwTo tid (e::SomeException))
237+ void $ timeout (1000000 * 60 * 5 :: Int) $
238+ runProcess node $ catch p (\e -> liftIO $ throwTo tid (e::SomeException))
237239
238240tryForkProcess :: LocalNode -> Process () -> IO ProcessId
239241tryForkProcess node p = do
distributed-process-tests/src/Control/Distributed/Process/Tests/Mx.hs+87−75
@@ -5,7 +5,6 @@ module Control.Distributed.Process.Tests.Mx (tests) where
55
66import Control.Distributed.Process.Tests.Internal.Utils
77import Network.Transport.Test (TestTransport(..))
8−import Control.Exception (SomeException)
98import Control.Distributed.Process hiding (bracket, finally, try)
109import Control.Distributed.Process.Internal.Types
1110 ( ProcessExitException(..)
@@ -39,7 +38,7 @@ import Control.Monad.Catch(finally, bracket, try)
3938import Control.Rematch (equalTo)
4039import Data.Binary
4140import Data.List (find, sort, intercalate)
42−import Data.Maybe (isJust, fromJust, isNothing, fromMaybe)
41+import Data.Maybe (isJust, fromJust, isNothing, fromMaybe, catMaybes)
4342import Data.Typeable
4443import GHC.Generics hiding (from)
4544#if ! MIN_VERSION_base(4,6,0)
@@ -67,7 +66,7 @@ awaitExit pid =
6766 where
6867 withMonitorRef p = bracket (monitor p) unmonitor
6968
70−testAgentBroadcast :: TestResult () -> Process ()
69+testAgentBroadcast :: TestResult (Maybe ()) -> Process ()
7170testAgentBroadcast result = do
7271 (resultSP, resultRP) <- newChan :: Process (SendPort (), ReceivePort ())
7372
@@ -82,10 +81,10 @@ testAgentBroadcast result = do
8281 mxNotify ()
8382 -- Once the publisher has seen our message, it will broadcast the Publish
8483 -- and the consumer will see that and send the result to our typed channel.
85− stash result =<< receiveChan resultRP
84+ stash result =<< receiveChanTimeout 10000000 resultRP
8685
87− kill publisher "finished" >> awaitExit publisher
88− kill consumer "finished" >> awaitExit consumer
86+ kill publisher "finished"
87+ kill consumer "finished"
8988
9089testAgentDualInput :: TestResult (Maybe Int) -> Process ()
9190testAgentDualInput result = do
@@ -100,6 +99,8 @@ testAgentDualInput result = do
10099 else mxReady)
101100 ]
102101
102+ mRef <- monitor s
103+
103104 mxNotify (1 :: Int)
104105 nsend "sum-agent" (3 :: Int)
105106 mxNotify (2 :: Int)
@@ -107,7 +108,10 @@ testAgentDualInput result = do
107108 mxNotify (5 :: Int)
108109
109110 stash result =<< receiveChanTimeout 10000000 rp
110− awaitExit s
111+ died <- receiveTimeout 10000000 [
112+ matchIf (\(ProcessMonitorNotification r _ _) -> r == mRef) (const $ return True)
113+ ]
114+ died `shouldBe` equalTo (Just True)
111115
112116testAgentPrioritisation :: TestResult [String] -> Process ()
113117testAgentPrioritisation result = do
@@ -121,10 +125,10 @@ testAgentPrioritisation result = do
121125 (sp, rp) <- newChan
122126 s <- mxAgent (MxAgentId name) ["first"] [
123127 mxSink (\(s :: String) -> do
124− mxUpdateLocal ((s:))
128+ mxUpdateLocal (s:)
125129 st <- mxGetLocal
126130 case length st of
127− n | n == 5 -> do liftMX $ sendChan sp st
131+ n | n == 5 -> do liftMX $ sendChan sp (sort st)
128132 mxDeactivate "finished"
129133 _ -> mxReceive -- go to the mailbox
130134 )
@@ -135,7 +139,7 @@ testAgentPrioritisation result = do
135139 mxNotify "fourth"
136140 nsend name "fifth"
137141
138− stash result . sort =<< receiveChan rp
142+ stash result . fromMaybe [] =<< receiveChanTimeout 10000000 rp
139143 awaitExit s
140144
141145testAgentMailboxHandling :: TestResult (Maybe ()) -> Process ()
@@ -148,12 +152,19 @@ testAgentMailboxHandling result = do
148152 nsend "mailbox-agent" ()
149153
150154 stash result =<< receiveChanTimeout 1000000 rp
151− kill agent "finished" >> awaitExit agent
155+ kill agent "finished"
152156
153157testAgentEventHandling :: TestResult Bool -> Process ()
154158testAgentEventHandling result = do
155− let initState = [] :: [MxEvent]
159+ us <- getSelfPid
160+ -- because this test is a bit racy, let's ensure it can't run indefinitely
161+ timer <- spawnLocal $ do
162+ pause (1000000 * 60 * 5)
163+ -- okay we've waited 5 mins, let's kill the test off if it's stuck...
164+ stash result False
165+ kill us "Test Timed Out"
156166
167+ let initState = [] :: [MxEvent]
157168 (rc, rs) <- newChan
158169 agentPid <- mxAgent (MxAgentId "lifecycle-listener-agent") initState [
159170 (mxSink $ \ev -> do
@@ -186,8 +197,7 @@ testAgentEventHandling result = do
186197 -- TODO: yes, this is racy, but we're at the mercy of the scheduler here...
187198 faff 2000000 rs
188199
189− _ <- monitor agentPid
190− (sp, rp) <- newChan
200+ (sp, rp) <- newChan :: Process (SendPort (), ReceivePort ())
191201
192202 pid <- spawnLocal $ expect >>= sendChan sp
193203
@@ -196,9 +206,11 @@ testAgentEventHandling result = do
196206 monitor pid
197207
198208 send pid ()
199− () <- receiveChan rp
209+ rct <- receiveChanTimeout 10000000 rp
210+ unless (isJust rct) $ die "No response on channel"
200211
201− receiveWait [ match (\(ProcessMonitorNotification _ _ _) -> return ()) ]
212+ pmn <- receiveTimeout 2000000 [ match (\ProcessMonitorNotification{} -> return ()) ]
213+ unless (isJust pmn) $ die "No monitor notification arrived"
202214
203215 -- TODO: yes, this is racy, but we're at the mercy of the scheduler here...
204216 faff 2000000 rs
@@ -207,17 +219,16 @@ testAgentEventHandling result = do
207219 mxNotify (MxSpawned pid, replyTo)
208220 mxNotify (MxProcessDied pid DiedNormal, replyTo)
209221
210− seenAlive <- receiveChan reply
211− seenDead <- receiveChan reply
222+ seenAlive <- receiveChanTimeout 10000000 reply
223+ seenDead <- receiveChanTimeout 10000000 reply
212224
213− stash result $ seenAlive && seenDead
214− kill agentPid "test-complete" >> awaitExit agentPid
225+ stash result $ foldr (&&) True $ catMaybes [seenAlive, seenDead]
226+ kill timer "test-complete"
227+ kill agentPid "test-complete"
215228 where
216229 faff delay port = do
217230 res <- receiveChanTimeout delay port
218− unless (isNothing res) $ do
219− pause delay
220− faff delay port
231+ unless (isNothing res) $ pause delay
221232
222233testMxRegEvents :: TestResult () -> Process ()
223234testMxRegEvents result = do
@@ -264,7 +275,6 @@ testMxRegEvents result = do
264275 reg3 `shouldBe` equalTo (Just (label, p1))
265276
266277 mapM_ (flip kill $ "test-complete") [agent, p1, p2]
267− awaitExit agent
268278
269279testMxRegMon :: LocalNode -> TestResult () -> Process ()
270280testMxRegMon remoteNode result = do
@@ -322,70 +332,70 @@ testMxRegMon remoteNode result = do
322332 evts `shouldContain` (Just (label1, p1))
323333 evts `shouldContain` (Just (label2, p1))
324334
325− kill agent "test-complete" >> awaitExit agent
335+ kill agent "test-complete"
326336
327337ensure :: Process () -> Process () -> Process ()
328338ensure = flip finally
329339
330340testNSend :: (String -> () -> Process ())
331341 -> Maybe LocalNode
332− -> TestResult Bool
333342 -> Process ()
334−testNSend op n r = testMxSend n r $ \p1 sink -> do
343+testNSend op n = do
344+ us <- getSelfPid
335345 let delay = 5000000
336− let label = "testMxSend"
346+ let label = "testMxSend" ++ (show us)
337347 let isValid = isValidLabel n label
338348
339− register label p1
340− reg1 <- receiveChanTimeout delay sink
341− case reg1 of
342− Just (MxRegistered pd lb)
343− | pd == p1 && isValid lb -> return ()
344− _ -> die $ "Reg-Failed: " ++ show reg1
349+ testMxSend n label $ \p1 sink -> do
350+ register label p1
351+ reg1 <- receiveChanTimeout delay sink
352+ case reg1 of
353+ Just (MxRegistered pd lb)
354+ | pd == p1 && isValid lb -> return ()
355+ _ -> die $ "Reg-Failed: " ++ show reg1
345356
346− op label ()
357+ op label ()
347358
348− us <- getSelfPid
349− sent <- receiveChanTimeout delay sink
350− case sent of
351− Just (MxSentToName lb by _)
352− | by == us && isValid lb -> return True
353− _ -> die $ "Send-Failed: " ++ show sent
359+ sent <- receiveChanTimeout delay sink
360+ case sent of
361+ Just (MxSentToName lb by _)
362+ | by == us && isValid lb -> return True
363+ _ -> die $ "Send-Failed: " ++ show sent
354364
355365 where
356− isValidLabel n l1 l2
366+ isValidLabel nd l1 l2
357367 | l2 == l2 = True
358− | isJust n = l2 == l1 ++ "@" ++ show (localNodeId $ fromJust n)
368+ | isJust nd = l2 == l1 ++ "@" ++ show (localNodeId $ fromJust nd)
359369 | otherwise = False
360370
361371testSend :: (ProcessId -> () -> Process ())
362372 -> Maybe LocalNode
363− -> TestResult Bool
364373 -> Process ()
365−testSend op n r = testMxSend n r $ \p1 sink -> do
366− -- initiate a send
367− op p1 ()
368−
369− -- verify the management event
374+testSend op n = do
370375 us <- getSelfPid
371− sent <- receiveChanTimeout 5000000 sink
372− case sent of
373− Just (MxSent pidTo pidFrom _)
374− | pidTo == p1 && pidFrom == us -> return True
375− _ -> return False
376+ let label = "testMxSend" ++ (show us)
377+ testMxSend n label $ \p1 sink -> do
378+ -- initiate a send
379+ op p1 ()
380+
381+ -- verify the management event
382+ sent <- receiveChanTimeout 5000000 sink
383+ case sent of
384+ Just (MxSent pidTo pidFrom _)
385+ | pidTo == p1 && pidFrom == us -> return True
386+ _ -> return False
376387
377388testChan :: (SendPort () -> () -> Process ())
378389 -> Maybe LocalNode
379− -> TestResult Bool
380390 -> Process ()
381−testChan op n r = testMxSend n r $ \p1 sink -> do
391+testChan op n = testMxSend n "" $ \p1 sink -> do
382392
383393 us <- getSelfPid
384394 send p1 us
385395
386− cleared <- receiveChan sink
396+ cleared <- receiveChanTimeout 2000000 sink
387397 case cleared of
388− (MxSent pidTo pidFrom _)
398+ Just (MxSent pidTo pidFrom _)
389399 | pidTo == p1 && pidFrom == us -> return ()
390400 _ -> die "Received uncleared Mx Event"
391401
@@ -404,8 +414,8 @@ testChan op n r = testMxSend n r $ \p1 sink -> do
404414
405415type SendTest = ProcessId -> ReceivePort MxEvent -> Process Bool
406416
407−testMxSend :: Maybe LocalNode -> TestResult Bool -> SendTest -> Process ()
408−testMxSend mNode result test = do
417+testMxSend :: Maybe LocalNode -> String -> SendTest -> Process ()
418+testMxSend mNode label test = do
409419 us <- getSelfPid
410420 (sp, rp) <- newChan
411421 (chan, sink) <- newChan
@@ -429,16 +439,19 @@ testMxSend mNode result test = do
429439 Nothing -> void $ spawnLocal (proc sp)
430440 Just remoteNode -> void $ liftIO $ forkProcess remoteNode $ proc sp
431441
432− p1 <- receiveChan rp
433− res <- try (test p1 sink)
434− case res of
435− Left (ProcessExitException _ m) -> (liftIO $ putStrLn $ "SomeException-" ++ show m) >> stash result False
436− Right tr -> stash result tr
442+ p1 <- receiveChanTimeout 2000000 rp
443+ unless (isJust p1) $ die "Timed out waiting for ProcessId"
444+ res <- try $ test (fromJust p1) sink
445+
437446 kill agent "bye"
438− kill p1 "bye"
447+ kill (fromJust p1) "bye"
448+
449+ case res of
450+ Left (ProcessExitException _ m) -> (liftIO $ putStrLn $ "SomeException-" ++ show m) >> die m
451+ Right tr -> tr `shouldBe` equalTo True
452+
439453
440454 where
441− label = "testMxSend"
442455 agentLabel s = "mx-unsafe-check-agent-" ++ show s
443456 proc sp' = getSelfPid >>= sendChan sp' >> go Nothing
444457
@@ -464,7 +477,7 @@ tests TestTransport{..} = do
464477 , testCase "InterAgentBroadcast"
465478 (delayedAssertion
466479 "expected (), but no broadcast was received"
467− node1 () testAgentBroadcast)
480+ node1 (Just ()) testAgentBroadcast)
468481 , testCase "AgentMailboxHandling"
469482 (delayedAssertion
470483 "expected (Just ()), but no regular (mailbox) input was handled"
@@ -489,12 +502,11 @@ tests TestTransport{..} = do
489502 (delayedAssertion
490503 "expected process deaths to result in unregistration events"
491504 node1 () (testMxRegMon node2))
492− -- , testGroup "SendEvents" $ buildTestCases node1 node2
505+ , testGroup "SendEvents" $ buildTestCases node1 node2
493506 ]
494507 ]
495508 where
496− buildTestCases n1 n2 =
497− let nid = localNodeId n2 in build n2 [
509+ buildTestCases n1 n2 = let nid = localNodeId n2 in build n1 n2 [
498510 ("NSend", [
499511 ("nsend", testNSend nsend)
500512 , ("Unsafe.nsend", testNSend Unsafe.nsend)
@@ -516,13 +528,13 @@ tests TestTransport{..} = do
516528 ]
517529
518530 build :: LocalNode
519− -> [(String, [(String, (Maybe LocalNode -> TestResult Bool -> Process ()))])]
531+ -> LocalNode
532+ -> [(String, [(String, (Maybe LocalNode -> Process ()))])]
520533 -> [Test]
521− build ln specs =
534+ build n ln specs =
522535 [ testGroup (intercalate "-" [groupName, caseSuffix]) [
523536 testCase (intercalate "-" [caseName, caseSuffix])
524− (delayedAssertion "expected mx events failed"
525− ln True (caseImpl caseNode))
537+ (runProcess n (caseImpl caseNode))
526538 | (caseName, caseImpl) <- groupCases
527539 ]
528540 | (groupName, groupCases) <- specs
distributed-process.cabal+1−1
@@ -6,7 +6,7 @@ License: BSD3
66License-File: LICENSE
77Copyright: Well-Typed LLP, Tweag I/O Limited
88Author: Duncan Coutts, Nicolas Wu, Edsko de Vries
9−Maintainer: Facundo Domínguez <facundo.dominguez@tweag.io>
9+Maintainer: Tim Watson <watson.timothy@gmail.com>
1010Stability: experimental
1111Homepage: http://haskell-distributed.github.com/
1212Bug-Reports: https://github.com/haskell-distributed/distributed-process/issues
src/Control/Distributed/Process/Internal/Primitives.hs+7−1
@@ -307,7 +307,13 @@ expect = receiveWait [match return]
307307-- Channels --
308308--------------------------------------------------------------------------------
309309
310−-- | Create a new typed channel
310+-- | Create a new typed channel, bound to the calling Process
311+--
312+-- Note that the channel is bound to the lifecycle of the process that evaluates
313+-- this function, such that when it dies/exits, the channel will no longer
314+-- function, but will remain accessible. Thus reading from the ReceivePort will
315+-- fail silently thereafter, blocking indefinitely (unless a timeout is used).
316+--
311317newChan :: Serializable a => Process (SendPort a, ReceivePort a)
312318newChan = do
313319 proc <- ask
src/Control/Distributed/Process/Management.hs+34−2
@@ -76,6 +76,40 @@
7676--
7777-- * Whether messages will be taken from the mailbox first, or the event bus.
7878--
79+-- Since the event bus uses STM broadcast channels to communicate with agents,
80+-- no message written to the bus successfully can be lost.
81+--
82+-- Agents can also receive messages via their mailboxes - these are subject to
83+-- the same guarantees as all inter-process message sending.
84+--
85+-- Messages dispatched on an STM broadcast channel (i.e., management event bus)
86+-- are guaranteed to be delivered with the same FIFO ordering guarantees that
87+-- exist between two communicating processes, such that communication from the
88+-- node controller's threads (i.e., MxEvent's) will never be re-ordered, but
89+-- messages dispatched to the event bus by other processes (including, but not
90+-- limited to agents) are only guaranteed to be ordered between one sender and
91+-- one receiver.
92+--
93+-- No guarantee exists for the ordering in which messages sent to an agent's
94+-- mailbox will be delivered, vs messages dispatched via the event bus.
95+--
96+-- Because of the above, there are no ordering guarantees for messages sent
97+-- between agents, or for processes to agents, except for those that apply to
98+-- messages sent between regular processes, since agents are
99+-- implemented as such.
100+--
101+-- The event bus is serial and single threaded. Anything that is published by
102+-- the node controller will be seen in FIFO order. There are no ordering
103+-- guarantees pertaining to entries published to the event bus by other
104+-- processes or agents.
105+--
106+-- It should not be possible to see, for example, an @MxReceived@ before the
107+-- corresponding @MxSent@ event, since the places where we issue the @MxSent@
108+-- write directly to the event bus (using STM) in the calling (green) thread,
109+-- before dispatching instructions to the node controller to perform the
110+-- necessary routing to deliver the message to a process (or registered name,
111+-- or typed channel) locally or remotely.
112+--
79113-- [Management Data API]
80114--
81115-- Both management agents and clients of the API have access to a variety of
@@ -144,8 +178,6 @@
144178-- > monitorNames = getSelfPid >>= nsend "name-monitor"
145179-- > monitorNames2 = getSelfPid >>= mxNotify
146180--
147−-- For some real-world examples, see the distributed-process-platform package.
148−--
149181-- [Performance, Stablity and Scalability]
150182--
151183-- /Management Agents/ offer numerous advantages over regular processes: