installHandler int handler iset calls sigaction to install an interrupt handler for signal int. If handler is Default, SIG_DFL is installed; if handler is Ignore, SIG_IGN is installed; if handler is Catch action, a handler is installed which will invoke action in a new thread when (or shortly after) the signal is received. If iset is Just s, then the sa_mask of the sigaction structure is set to s; otherwise it is cleared. The previously installed signal handler for int is returned

data Handler #

The actions to perform when a signal is received.

Constructors

Default
Ignore
Catch (IO ())
CatchOnce (IO ())
CatchInfo (SignalInfo -> IO ())	Since: unix-2.7.0.0
CatchInfoOnce (SignalInfo -> IO ())	Since: unix-2.7.0.0

data SignalInfo #

Information about a received signal (derived from siginfo_t).

Since: unix-2.7.0.0

Constructors

SignalInfo
Fields siginfoSignal :: Signal siginfoError :: Errno siginfoSpecific :: SignalSpecificInfo

data SignalSpecificInfo #

Information specific to a particular type of signal (derived from siginfo_t).

Since: unix-2.7.0.0

Constructors

NoSignalSpecificInfo
SigChldInfo
Fields siginfoPid :: ProcessID siginfoUid :: UserID siginfoStatus :: ProcessStatus

Signal sets

data SignalSet #

emptySignalSet :: SignalSet #

fullSignalSet :: SignalSet #

reservedSignals :: SignalSet #

A set of signals reserved for use by the implementation. In GHC, this will normally include either sigVTALRM or sigALRM.

addSignal :: Signal -> SignalSet -> SignalSet infixr 9 #

deleteSignal :: Signal -> SignalSet -> SignalSet infixr 9 #

inSignalSet :: Signal -> SignalSet -> Bool #

Signal mask

getSignalMask :: IO SignalSet #

getSignalMask calls sigprocmask to determine the set of interrupts which are currently being blocked.

setSignalMask :: SignalSet -> IO () #

setSignalMask mask calls sigprocmask with SIG_SETMASK to block all interrupts in mask.

blockSignals :: SignalSet -> IO () #

blockSignals mask calls sigprocmask with SIG_BLOCK to add all interrupts in mask to the set of blocked interrupts.

unblockSignals :: SignalSet -> IO () #

unblockSignals mask calls sigprocmask with SIG_UNBLOCK to remove all interrupts in mask from the set of blocked interrupts.

Alarm timer

scheduleAlarm :: Int -> IO Int #

scheduleAlarm i calls alarm to schedule a real time alarm at least i seconds in the future.

Waiting for signals

getPendingSignals :: IO SignalSet #

getPendingSignals calls sigpending to obtain the set of interrupts which have been received but are currently blocked.

awaitSignal :: Maybe SignalSet -> IO () #

awaitSignal iset suspends execution until an interrupt is received. If iset is Just s, awaitSignal calls sigsuspend, installing s as the new signal mask before suspending execution; otherwise, it calls sigsuspend with current signal mask. Note that RTS scheduler signal (either virtualTimerExpired or realTimeAlarm) could cause premature termination of this call. It might be necessary to block that signal before invocation of awaitSignal with blockSignals reservedSignals.

awaitSignal returns when signal was received and processed by a signal handler, or if the signal could not be caught. If you have installed any signal handlers with installHandler, it may be wise to call yield directly after awaitSignal to ensure that the signal handler runs as promptly as possible.

NOCLDSTOP

setStoppedChildFlag :: Bool -> IO Bool #

Tells the system whether or not to set the SA_NOCLDSTOP flag when installing new signal handlers.

queryStoppedChildFlag :: IO Bool #

Queries the current state of the stopped child flag.