|
GHC.TopHandler | Portability | non-portable (GHC Extensions) | Stability | internal | Maintainer | cvs-ghc@haskell.org |
|
|
|
Description |
Support for catching exceptions raised during top-level computations
(e.g. Main.main, Control.Concurrent.forkIO, and foreign exports)
|
|
Synopsis |
|
|
|
Documentation |
|
runMainIO :: IO a -> IO a |
runMainIO is wrapped around Main.main (or whatever main is
called in the program). It catches otherwise uncaught exceptions,
and also flushes stdout/stderr before exiting.
|
|
runIO :: IO a -> IO a |
runIO is wrapped around every foreign export and foreign
import "wrapper" to mop up any uncaught exceptions. Thus, the
result of running System.Exit.exitWith in a foreign-exported
function is the same as in the main thread: it terminates the
program.
|
|
runIOFastExit :: IO a -> IO a |
Like runIO, but in the event of an exception that causes an exit,
we don't shut down the system cleanly, we just exit. This is
useful in some cases, because the safe exit version will give other
threads a chance to clean up first, which might shut down the
system in a different way. For example, try
main = forkIO (runIO (exitWith (ExitFailure 1))) >> threadDelay 10000
This will sometimes exit with interrupted and code 0, because the
main thread is given a chance to shut down when the child thread calls
safeExit. There is a race to shut down between the main and child threads.
|
|
runNonIO :: a -> IO a |
The same as runIO, but for non-IO computations. Used for
wrapping foreign export and foreign import "wrapper" when these
are used to export Haskell functions with non-IO types.
|
|
topHandler :: Exception -> IO a |
|
topHandlerFastExit :: Exception -> IO a |
|
reportStackOverflow :: IO a |
|
reportError :: Exception -> IO a |
|
Produced by Haddock version 2.2.2 |