git.iko.soy/distributed-process
on bb91973 help sign in
7 files changed+106−237
since splitsnapshots
unifiedsplit
distributed-process-tests/distributed-process-tests.cabal+1−1 distributed-process-tests/src/Control/Distributed/Process/Tests/CH.hs+25−104 distributed-process-tests/src/Control/Distributed/Process/Tests/Internal/Utils.hs+1−3 distributed-process-tests/src/Control/Distributed/Process/Tests/Mx.hs+75−87 distributed-process.cabal+1−1 src/Control/Distributed/Process/Internal/Primitives.hs+1−7 src/Control/Distributed/Process/Management.hs+2−34
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: Tim Watson <watson.timothy@gmail.com>
9+Maintainer: Facundo Domínguez <facundo.dominguez@tweag.io>
1010copyright: Well-Typed LLP
1111category: Control, Cloud Haskell
1212build-type: Simple
distributed-process-tests/src/Control/Distributed/Process/Tests/CH.hs+25−104
@@ -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−import Data.Maybe (isNothing, isJust)
49+
5050import Test.HUnit (Assertion, assertBool, assertFailure)
5151import Test.Framework (Test, testGroup)
5252import Test.Framework.Providers.HUnit (testCase)
53−import Control.Rematch hiding (match, isNothing, isJust)
53+import Control.Rematch hiding (match)
5454import Control.Rematch.Run (Match(..))
5555
5656newtype Ping = Ping ProcessId
@@ -735,6 +735,7 @@ testRemoteRegistry :: TestTransport -> Assertion
735735testRemoteRegistry TestTransport{..} = do
736736 node1 <- newLocalNode testTransport initRemoteTable
737737 node2 <- newLocalNode testTransport initRemoteTable
738+ done <- newEmptyMVar
738739
739740 pingServer <- forkProcess node1 ping
740741 deadProcess <- forkProcess node1 (return ())
@@ -749,7 +750,6 @@ testRemoteRegistry TestTransport{..} = do
749750
750751 pid <- verifyWhereIsRemote nid1 "ping"
751752 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 [ 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−
762+ receiveWait [
763+ matchIf (\(RegisterReply label' False Nothing) -> "dead" == label')
764+ (\(RegisterReply _ _ _) -> return ()) ]
766765 registerRemoteAsync nid1 "ping" deadProcess
767766 receiveWait [
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−
767+ matchIf (\(RegisterReply label' False (Just pid'')) ->
768+ "ping" == label' && pid'' == pingServer)
769+ (\(RegisterReply _ _ _) -> return ()) ]
773770 unregisterRemoteAsync nid1 "dead"
774771 receiveWait [
775− matchIf (\(RegisterReply label' _ _) -> "dead" == label')
776− (\(RegisterReply _ f mPid) -> return (not f && isNothing mPid))
777− ] >>= liftIO . assertBool "Expected False and Nothing in RegisterReply"
772+ matchIf (\(RegisterReply label' False Nothing) ->
773+ "dead" == label' && pid == pingServer)
774+ (\(RegisterReply _ _ _) -> return ()) ]
775+ liftIO $ putMVar done ()
776+
777+ takeMVar done
778778
779779testRemoteRegistryRemoteProcess :: TestTransport -> Assertion
780780testRemoteRegistryRemoteProcess TestTransport{..} = do
@@ -1272,76 +1272,6 @@ 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−
13451275testKillLocal :: TestTransport -> Assertion
13461276testKillLocal TestTransport{..} = do
13471277 localNode <- newLocalNode testTransport initRemoteTable
@@ -1556,24 +1486,20 @@ testRegistryMonitoring :: TestTransport -> Assertion
15561486testRegistryMonitoring TestTransport{..} = do
15571487 node1 <- newLocalNode testTransport initRemoteTable
15581488 node2 <- newLocalNode testTransport initRemoteTable
1489+ waitH <- newEmptyMVar
15591490
15601491 let nid = localNodeId node2
15611492 pid <- forkProcess node1 $ do
1562− self <- getSelfPid
1563− runUntilRegistered nid self
1564− say $ (show self) ++ " registered as " ++ regName
1565− expect :: Process ()
1566− say $ (show self) ++ " exiting normally"
1493+ getSelfPid >>= runUntilRegistered nid
1494+ liftIO $ takeMVar waitH
15671495
15681496 runProcess node2 $ do
15691497 register regName pid
1570− say $ regName ++ " registered to " ++ show pid
15711498 res <- whereis regName
1572− send pid ()
1573− say $ " sent finish signal to " ++ show pid
15741499 us <- getSelfPid
1575− liftIO $ assertBool "expected (Just pid)" $ res == (Just pid)
1576−
1500+ liftIO $ do
1501+ putMVar waitH ()
1502+ assertBool "expected (Just pid)" $ res == (Just pid)
15771503
15781504 -- This delay isn't essential!
15791505 -- The test case passes perfectly fine without it (feel free to comment out
@@ -1598,9 +1524,7 @@ testRegistryMonitoring TestTransport{..} = do
15981524 regHere <- newEmptyMVar
15991525 runProcess node2 $ whereis regName >>= liftIO . putMVar regHere
16001526 res <- takeMVar regHere
1601− case res of
1602− Nothing -> return ()
1603− Just pid -> assertBool ("expected Nothing, but got " ++ show pid) False
1527+ assertBool "expected Nothing, but process still registered" (res == Nothing)
16041528
16051529 where
16061530 runUntilRegistered nid us = do
@@ -1612,13 +1536,11 @@ testRegistryMonitoring TestTransport{..} = do
16121536
16131537 delayUntilMaybeUnregistered nid p = do
16141538 whereisRemoteAsync nid regName
1615− res <- receiveTimeout 20000000 {- 20 sec delay -} [
1616− matchIf (\(WhereIsReply n p) -> n == regName && isNothing p)
1539+ receiveTimeout 20000000 {- 20 sec delay -} [
1540+ matchIf (\(WhereIsReply n p) -> n == regName && p == Nothing)
16171541 (const $ return ())
16181542 ]
1619− case res of
1620− Just () -> return ()
1621− Nothing -> delayUntilMaybeUnregistered nid p
1543+ return ()
16221544
16231545 regName = "testRegisterRemote"
16241546
@@ -1814,7 +1736,6 @@ tests testtrans = return [
18141736 , testCase "MatchMessageUnwrap" (testMatchMessageWithUnwrap testtrans)
18151737 , testCase "ReceiveChanTimeout" (testReceiveChanTimeout testtrans)
18161738 , testCase "ReceiveChanFeatures" (testReceiveChanFeatures testtrans)
1817− , testCase "ChanLifecycle" (testChanLifecycle testtrans)
18181739 , testCase "KillLocal" (testKillLocal testtrans)
18191740 , testCase "KillRemote" (testKillRemote testtrans)
18201741 , testCase "Die" (testDie testtrans)
distributed-process-tests/src/Control/Distributed/Process/Tests/Internal/Utils.hs+1−3
@@ -91,7 +91,6 @@ import Test.HUnit (Assertion, assertFailure)
9191import Test.HUnit.Base (assertBool)
9292
9393import GHC.Generics
94−import System.Timeout (timeout)
9594
9695-- | A mutable cell containing a test result.
9796type TestResult a = MVar a
@@ -234,8 +233,7 @@ testProcessReport pid = do
234233tryRunProcess :: LocalNode -> Process () -> IO ()
235234tryRunProcess node p = do
236235 tid <- liftIO myThreadId
237− void $ timeout (1000000 * 60 * 5 :: Int) $
238− runProcess node $ catch p (\e -> liftIO $ throwTo tid (e::SomeException))
236+ runProcess node $ catch p (\e -> liftIO $ throwTo tid (e::SomeException))
239237
240238tryForkProcess :: LocalNode -> Process () -> IO ProcessId
241239tryForkProcess node p = do
distributed-process-tests/src/Control/Distributed/Process/Tests/Mx.hs+75−87
@@ -5,6 +5,7 @@ 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)
89import Control.Distributed.Process hiding (bracket, finally, try)
910import Control.Distributed.Process.Internal.Types
1011 ( ProcessExitException(..)
@@ -38,7 +39,7 @@ import Control.Monad.Catch(finally, bracket, try)
3839import Control.Rematch (equalTo)
3940import Data.Binary
4041import Data.List (find, sort, intercalate)
41−import Data.Maybe (isJust, fromJust, isNothing, fromMaybe, catMaybes)
42+import Data.Maybe (isJust, fromJust, isNothing, fromMaybe)
4243import Data.Typeable
4344import GHC.Generics hiding (from)
4445#if ! MIN_VERSION_base(4,6,0)
@@ -66,7 +67,7 @@ awaitExit pid =
6667 where
6768 withMonitorRef p = bracket (monitor p) unmonitor
6869
69−testAgentBroadcast :: TestResult (Maybe ()) -> Process ()
70+testAgentBroadcast :: TestResult () -> Process ()
7071testAgentBroadcast result = do
7172 (resultSP, resultRP) <- newChan :: Process (SendPort (), ReceivePort ())
7273
@@ -81,10 +82,10 @@ testAgentBroadcast result = do
8182 mxNotify ()
8283 -- Once the publisher has seen our message, it will broadcast the Publish
8384 -- and the consumer will see that and send the result to our typed channel.
84− stash result =<< receiveChanTimeout 10000000 resultRP
85+ stash result =<< receiveChan resultRP
8586
86− kill publisher "finished"
87− kill consumer "finished"
87+ kill publisher "finished" >> awaitExit publisher
88+ kill consumer "finished" >> awaitExit consumer
8889
8990testAgentDualInput :: TestResult (Maybe Int) -> Process ()
9091testAgentDualInput result = do
@@ -99,8 +100,6 @@ testAgentDualInput result = do
99100 else mxReady)
100101 ]
101102
102− mRef <- monitor s
103−
104103 mxNotify (1 :: Int)
105104 nsend "sum-agent" (3 :: Int)
106105 mxNotify (2 :: Int)
@@ -108,10 +107,7 @@ testAgentDualInput result = do
108107 mxNotify (5 :: Int)
109108
110109 stash result =<< receiveChanTimeout 10000000 rp
111− died <- receiveTimeout 10000000 [
112− matchIf (\(ProcessMonitorNotification r _ _) -> r == mRef) (const $ return True)
113− ]
114− died `shouldBe` equalTo (Just True)
110+ awaitExit s
115111
116112testAgentPrioritisation :: TestResult [String] -> Process ()
117113testAgentPrioritisation result = do
@@ -125,10 +121,10 @@ testAgentPrioritisation result = do
125121 (sp, rp) <- newChan
126122 s <- mxAgent (MxAgentId name) ["first"] [
127123 mxSink (\(s :: String) -> do
128− mxUpdateLocal (s:)
124+ mxUpdateLocal ((s:))
129125 st <- mxGetLocal
130126 case length st of
131− n | n == 5 -> do liftMX $ sendChan sp (sort st)
127+ n | n == 5 -> do liftMX $ sendChan sp st
132128 mxDeactivate "finished"
133129 _ -> mxReceive -- go to the mailbox
134130 )
@@ -139,7 +135,7 @@ testAgentPrioritisation result = do
139135 mxNotify "fourth"
140136 nsend name "fifth"
141137
142− stash result . fromMaybe [] =<< receiveChanTimeout 10000000 rp
138+ stash result . sort =<< receiveChan rp
143139 awaitExit s
144140
145141testAgentMailboxHandling :: TestResult (Maybe ()) -> Process ()
@@ -152,19 +148,12 @@ testAgentMailboxHandling result = do
152148 nsend "mailbox-agent" ()
153149
154150 stash result =<< receiveChanTimeout 1000000 rp
155− kill agent "finished"
151+ kill agent "finished" >> awaitExit agent
156152
157153testAgentEventHandling :: TestResult Bool -> Process ()
158154testAgentEventHandling result = do
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"
166−
167155 let initState = [] :: [MxEvent]
156+
168157 (rc, rs) <- newChan
169158 agentPid <- mxAgent (MxAgentId "lifecycle-listener-agent") initState [
170159 (mxSink $ \ev -> do
@@ -197,7 +186,8 @@ testAgentEventHandling result = do
197186 -- TODO: yes, this is racy, but we're at the mercy of the scheduler here...
198187 faff 2000000 rs
199188
200− (sp, rp) <- newChan :: Process (SendPort (), ReceivePort ())
189+ _ <- monitor agentPid
190+ (sp, rp) <- newChan
201191
202192 pid <- spawnLocal $ expect >>= sendChan sp
203193
@@ -206,11 +196,9 @@ testAgentEventHandling result = do
206196 monitor pid
207197
208198 send pid ()
209− rct <- receiveChanTimeout 10000000 rp
210− unless (isJust rct) $ die "No response on channel"
199+ () <- receiveChan rp
211200
212− pmn <- receiveTimeout 2000000 [ match (\ProcessMonitorNotification{} -> return ()) ]
213− unless (isJust pmn) $ die "No monitor notification arrived"
201+ receiveWait [ match (\(ProcessMonitorNotification _ _ _) -> return ()) ]
214202
215203 -- TODO: yes, this is racy, but we're at the mercy of the scheduler here...
216204 faff 2000000 rs
@@ -219,16 +207,17 @@ testAgentEventHandling result = do
219207 mxNotify (MxSpawned pid, replyTo)
220208 mxNotify (MxProcessDied pid DiedNormal, replyTo)
221209
222− seenAlive <- receiveChanTimeout 10000000 reply
223− seenDead <- receiveChanTimeout 10000000 reply
210+ seenAlive <- receiveChan reply
211+ seenDead <- receiveChan reply
224212
225− stash result $ foldr (&&) True $ catMaybes [seenAlive, seenDead]
226− kill timer "test-complete"
227− kill agentPid "test-complete"
213+ stash result $ seenAlive && seenDead
214+ kill agentPid "test-complete" >> awaitExit agentPid
228215 where
229216 faff delay port = do
230217 res <- receiveChanTimeout delay port
231− unless (isNothing res) $ pause delay
218+ unless (isNothing res) $ do
219+ pause delay
220+ faff delay port
232221
233222testMxRegEvents :: TestResult () -> Process ()
234223testMxRegEvents result = do
@@ -275,6 +264,7 @@ testMxRegEvents result = do
275264 reg3 `shouldBe` equalTo (Just (label, p1))
276265
277266 mapM_ (flip kill $ "test-complete") [agent, p1, p2]
267+ awaitExit agent
278268
279269testMxRegMon :: LocalNode -> TestResult () -> Process ()
280270testMxRegMon remoteNode result = do
@@ -332,70 +322,70 @@ testMxRegMon remoteNode result = do
332322 evts `shouldContain` (Just (label1, p1))
333323 evts `shouldContain` (Just (label2, p1))
334324
335− kill agent "test-complete"
325+ kill agent "test-complete" >> awaitExit agent
336326
337327ensure :: Process () -> Process () -> Process ()
338328ensure = flip finally
339329
340330testNSend :: (String -> () -> Process ())
341331 -> Maybe LocalNode
332+ -> TestResult Bool
342333 -> Process ()
343−testNSend op n = do
344− us <- getSelfPid
334+testNSend op n r = testMxSend n r $ \p1 sink -> do
345335 let delay = 5000000
346− let label = "testMxSend" ++ (show us)
336+ let label = "testMxSend"
347337 let isValid = isValidLabel n label
348338
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
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
356345
357− op label ()
346+ op label ()
358347
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
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
364354
365355 where
366− isValidLabel nd l1 l2
356+ isValidLabel n l1 l2
367357 | l2 == l2 = True
368− | isJust nd = l2 == l1 ++ "@" ++ show (localNodeId $ fromJust nd)
358+ | isJust n = l2 == l1 ++ "@" ++ show (localNodeId $ fromJust n)
369359 | otherwise = False
370360
371361testSend :: (ProcessId -> () -> Process ())
372362 -> Maybe LocalNode
363+ -> TestResult Bool
373364 -> Process ()
374−testSend op n = do
365+testSend op n r = testMxSend n r $ \p1 sink -> do
366+ -- initiate a send
367+ op p1 ()
368+
369+ -- verify the management event
375370 us <- getSelfPid
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
371+ sent <- receiveChanTimeout 5000000 sink
372+ case sent of
373+ Just (MxSent pidTo pidFrom _)
374+ | pidTo == p1 && pidFrom == us -> return True
375+ _ -> return False
387376
388377testChan :: (SendPort () -> () -> Process ())
389378 -> Maybe LocalNode
379+ -> TestResult Bool
390380 -> Process ()
391−testChan op n = testMxSend n "" $ \p1 sink -> do
381+testChan op n r = testMxSend n r $ \p1 sink -> do
392382
393383 us <- getSelfPid
394384 send p1 us
395385
396− cleared <- receiveChanTimeout 2000000 sink
386+ cleared <- receiveChan sink
397387 case cleared of
398− Just (MxSent pidTo pidFrom _)
388+ (MxSent pidTo pidFrom _)
399389 | pidTo == p1 && pidFrom == us -> return ()
400390 _ -> die "Received uncleared Mx Event"
401391
@@ -414,8 +404,8 @@ testChan op n = testMxSend n "" $ \p1 sink -> do
414404
415405type SendTest = ProcessId -> ReceivePort MxEvent -> Process Bool
416406
417−testMxSend :: Maybe LocalNode -> String -> SendTest -> Process ()
418−testMxSend mNode label test = do
407+testMxSend :: Maybe LocalNode -> TestResult Bool -> SendTest -> Process ()
408+testMxSend mNode result test = do
419409 us <- getSelfPid
420410 (sp, rp) <- newChan
421411 (chan, sink) <- newChan
@@ -439,19 +429,16 @@ testMxSend mNode label test = do
439429 Nothing -> void $ spawnLocal (proc sp)
440430 Just remoteNode -> void $ liftIO $ forkProcess remoteNode $ proc sp
441431
442− p1 <- receiveChanTimeout 2000000 rp
443− unless (isJust p1) $ die "Timed out waiting for ProcessId"
444− res <- try $ test (fromJust p1) sink
445−
446− kill agent "bye"
447− kill (fromJust p1) "bye"
448−
432+ p1 <- receiveChan rp
433+ res <- try (test p1 sink)
449434 case res of
450− Left (ProcessExitException _ m) -> (liftIO $ putStrLn $ "SomeException-" ++ show m) >> die m
451− Right tr -> tr `shouldBe` equalTo True
452−
435+ Left (ProcessExitException _ m) -> (liftIO $ putStrLn $ "SomeException-" ++ show m) >> stash result False
436+ Right tr -> stash result tr
437+ kill agent "bye"
438+ kill p1 "bye"
453439
454440 where
441+ label = "testMxSend"
455442 agentLabel s = "mx-unsafe-check-agent-" ++ show s
456443 proc sp' = getSelfPid >>= sendChan sp' >> go Nothing
457444
@@ -477,7 +464,7 @@ tests TestTransport{..} = do
477464 , testCase "InterAgentBroadcast"
478465 (delayedAssertion
479466 "expected (), but no broadcast was received"
480− node1 (Just ()) testAgentBroadcast)
467+ node1 () testAgentBroadcast)
481468 , testCase "AgentMailboxHandling"
482469 (delayedAssertion
483470 "expected (Just ()), but no regular (mailbox) input was handled"
@@ -502,11 +489,12 @@ tests TestTransport{..} = do
502489 (delayedAssertion
503490 "expected process deaths to result in unregistration events"
504491 node1 () (testMxRegMon node2))
505− , testGroup "SendEvents" $ buildTestCases node1 node2
492+ -- , testGroup "SendEvents" $ buildTestCases node1 node2
506493 ]
507494 ]
508495 where
509− buildTestCases n1 n2 = let nid = localNodeId n2 in build n1 n2 [
496+ buildTestCases n1 n2 =
497+ let nid = localNodeId n2 in build n2 [
510498 ("NSend", [
511499 ("nsend", testNSend nsend)
512500 , ("Unsafe.nsend", testNSend Unsafe.nsend)
@@ -528,13 +516,13 @@ tests TestTransport{..} = do
528516 ]
529517
530518 build :: LocalNode
531− -> LocalNode
532− -> [(String, [(String, (Maybe LocalNode -> Process ()))])]
519+ -> [(String, [(String, (Maybe LocalNode -> TestResult Bool -> Process ()))])]
533520 -> [Test]
534− build n ln specs =
521+ build ln specs =
535522 [ testGroup (intercalate "-" [groupName, caseSuffix]) [
536523 testCase (intercalate "-" [caseName, caseSuffix])
537− (runProcess n (caseImpl caseNode))
524+ (delayedAssertion "expected mx events failed"
525+ ln True (caseImpl caseNode))
538526 | (caseName, caseImpl) <- groupCases
539527 ]
540528 | (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: Tim Watson <watson.timothy@gmail.com>
9+Maintainer: Facundo Domínguez <facundo.dominguez@tweag.io>
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+1−7
@@ -307,13 +307,7 @@ expect = receiveWait [match return]
307307-- Channels --
308308--------------------------------------------------------------------------------
309309
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−--
310+-- | Create a new typed channel
317311newChan :: Serializable a => Process (SendPort a, ReceivePort a)
318312newChan = do
319313 proc <- ask
src/Control/Distributed/Process/Management.hs+2−34
@@ -76,40 +76,6 @@
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−--
11379-- [Management Data API]
11480--
11581-- Both management agents and clients of the API have access to a variety of
@@ -178,6 +144,8 @@
178144-- > monitorNames = getSelfPid >>= nsend "name-monitor"
179145-- > monitorNames2 = getSelfPid >>= mxNotify
180146--
147+-- For some real-world examples, see the distributed-process-platform package.
148+--
181149-- [Performance, Stablity and Scalability]
182150--
183151-- /Management Agents/ offer numerous advantages over regular processes: