You are looking at historical revision 34052 of this page. It may differ significantly from its current revision.
Module (chicken process signal)
This module offers procedures for dealing with POSIX process signals.
set-alarm!
[procedure] (set-alarm! SECONDS)Sets an internal timer to raise the signal/alrm after SECONDS are elapsed. You can use the set-signal-handler! procedure to write a handler for this signal.
set-signal-handler!
signal-handler
[procedure] (signal-handler SIGNUM)Returns the signal handler for the code SIGNUM or #f.
[procedure] (set-signal-handler! SIGNUM PROC)Establishes the procedure of one argument PROC as the handler for the signal with the code SIGNUM. PROC is called with the signal number as its sole argument. If the argument PROC is #f then any signal handler will be removed, and the corresponding signal set to SIG_IGN.
Notes
- it is unspecified in which thread of execution the signal handler will be invoked.
- when signals arrive in quick succession (specifically, before the handler for a signal has been started), then signals will be queued (up to a certain limit); the order in which the queued signals will be handled is not specified
- (set! (signal-handler SIG) PROC) can be used as an alternative to (set-signal-handler! SIG PROC)
- Any signal handlers for the signals signal/segv, signal/bus, signal/fpe and signal/ill will be ignored and these signals will always trigger an exception, unless the executable was started with the -:S runtime option. This feature is only available on platforms that support the sigprocmask(3) POSIX API function.
set-signal-mask!
[procedure] (set-signal-mask! SIGLIST)Sets the signal mask of the current process to block all signals given in the list SIGLIST. Signals masked in that way will not be delivered to the current process.
signal-mask
[procedure] (signal-mask)Returns the signal mask of the current process.
signal-masked?
[procedure] (signal-masked? SIGNUM)Returns whether the signal for the code SIGNUM is currently masked.
signal-mask!
[procedure] (signal-mask! SIGNUM)Masks (blocks) the signal for the code SIGNUM.
signal-unmask!
[procedure] (signal-unmask! SIGNUM)Unmasks (unblocks) the signal for the code SIGNUM.
Signal codes
[constant] signal/term[constant] signal/kill
[constant] signal/int
[constant] signal/hup
[constant] signal/fpe
[constant] signal/ill
[constant] signal/segv
[constant] signal/abrt
[constant] signal/trap
[constant] signal/quit
[constant] signal/alrm
[constant] signal/vtalrm
[constant] signal/prof
[constant] signal/io
[constant] signal/urg
[constant] signal/chld
[constant] signal/cont
[constant] signal/stop
[constant] signal/tstp
[constant] signal/pipe
[constant] signal/xcpu
[constant] signal/xfsz
[constant] signal/usr1
[constant] signal/usr2
[constant] signal/bus
[constant] signal/winch
[constant] signal/break
These variables contain signal codes for use with process-signal, set-signal-handler!, signal-handler, signal-masked?, signal-mask!, or signal-unmask!.
Previous: Module (chicken process)