SignalHandlerMBS.alarm(seconds as Integer)

SignalHandlerMBS.alarm 1

The alarm() function sets a timer to deliver the signal SIGALRM to the calling process after the specified number of seconds. If an alarm has already been set with alarm() but has not been delivered, another call to alarm() will supersede the prior call. The request alarm(0) voids the current alarm and the signal SIGALRM will not be delivered.

Due to setitimer restriction the maximum number of seconds allowed is 100000000.

alarm sends signal 14 after the time out.

SignalHandlerMBS.ClearStacktrace(signalIndex as Integer)

Some examples using this method:

• /Util/SignalHandler/Signal Handler Flag Test

SignalHandlerMBS.QueryStacktrace(signalIndex as Integer, skip as Integer = 2) as string()

Useful to know later which code got the signal.
Works for flag handlers and for the event handlers if enabled.

Some examples using this method:

• /Util/SignalHandler/Signal Handler Flag Test

SignalHandlerMBS.SendSignal(PID as Integer, Signal as Integer) as boolean

// send signal to a process
// PID is 17779 here
// 9 means kill on Mac OS X
call SignalHandlerMBS.SendSignal(17779, 9)

Returns true on success and false on failure.
Without a signal handler the target app could quit.

Lookup signal.h for the list of signals. They can be different on Mac and Linux.

SignalHandlerMBS.SendSignalToSelf(Signal as Integer) as boolean

Returns true on success and false on failure.
Without a signal handler the target app could quit.

SignalHandlerMBS.SetDefaultHandler(signalIndex as Integer) as boolean

Const SIGALRM = 14
if SignalHandlerMBS.SetDefaultHandler(SIGALRM) then
  MsgBox "Done"
else
  MsgBox "Failed"
end if

Returns true on success and false on failure.

Some examples using this method:

• /Util/BugreporterKit/BugReporter
• /Util/BugreporterKit/BugReporter Console
• /Util/SignalHandler/SignalHandler

SignalHandlerMBS.SetFlagHandler(signalIndex as Integer, CollectStackTrace as boolean = false) as boolean

Returns true on success and false on failure.
Please use IsFlagSet in your app regularly to check if the flag was set.

If CollectStackTrace is true, you can later use QueryStacktrace to get the stack trace from the time the signal was captured.

Some examples using this method:

• /Util/SignalHandler/Signal Handler Flag Test

SignalHandlerMBS.SetIgnore(signalIndex as Integer) as boolean

Const SIGALRM = 14
if SignalHandlerMBS.SetIgnore(SIGALRM) then
  MsgBox "Done"
else
  MsgBox "Failed"
end if

Returns true on success and false on failure.

Some examples using this method:

• /Util/SignalHandler/SignalHandler

SignalHandlerMBS.SignalStatus(signalIndex as Integer) as Integer

Returns 0 (unknown), kSignalDefault, kSignalEvent, kSignalFlag or kSignalIgnored.