blob: e9abec437de583d165bbec204a0b4951583cbfba [file] [log] [blame]
Guido van Rossum398d9fe1994-05-11 08:59:13 +00001
Guido van Rossum3bbc62e1995-01-02 19:30:30 +00002/* Signal module -- many thanks to Lance Ellinghaus */
Guido van Rossum398d9fe1994-05-11 08:59:13 +00003
Guido van Rossum644a12b1997-04-09 19:24:53 +00004/* XXX Signals should be recorded per thread, now we have thread state. */
5
Guido van Rossum602099a1994-09-14 13:32:22 +00006#include "Python.h"
Guido van Rossum398d9fe1994-05-11 08:59:13 +00007#include "intrcheck.h"
8
Martin v. Löwis6238d2b2002-06-30 15:26:10 +00009#ifdef MS_WINDOWS
Brian Curtinb42a21d2010-08-06 19:52:50 +000010#include <Windows.h>
11#ifdef HAVE_PROCESS_H
Guido van Rossum644a12b1997-04-09 19:24:53 +000012#include <process.h>
13#endif
Brian Curtinb42a21d2010-08-06 19:52:50 +000014#endif
Guido van Rossum644a12b1997-04-09 19:24:53 +000015
Guido van Rossum398d9fe1994-05-11 08:59:13 +000016#include <signal.h>
17
Christian Heimes5fb7c2a2007-12-24 08:52:31 +000018#include <sys/stat.h>
Martin v. Löwis3bf3cc02008-03-24 14:05:07 +000019#ifdef HAVE_SYS_TIME_H
Martin v. Löwis823725e2008-03-24 13:39:54 +000020#include <sys/time.h>
Martin v. Löwis3bf3cc02008-03-24 14:05:07 +000021#endif
Christian Heimes5fb7c2a2007-12-24 08:52:31 +000022
Guido van Rossumbb4ba121994-06-23 11:25:45 +000023#ifndef SIG_ERR
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +000024#define SIG_ERR ((PyOS_sighandler_t)(-1))
Guido van Rossumbb4ba121994-06-23 11:25:45 +000025#endif
26
Andrew MacIntyre7bf68332002-03-03 02:59:16 +000027#if defined(PYOS_OS2) && !defined(PYCC_GCC)
Guido van Rossum8e9ebfd1997-11-22 21:53:48 +000028#define NSIG 12
29#include <process.h>
30#endif
31
Guido van Rossum3bbc62e1995-01-02 19:30:30 +000032#ifndef NSIG
Marc-André Lemburg8bcfb8a2000-07-04 14:17:33 +000033# if defined(_NSIG)
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +000034# define NSIG _NSIG /* For BSD/SysV */
Marc-André Lemburg8bcfb8a2000-07-04 14:17:33 +000035# elif defined(_SIGMAX)
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +000036# define NSIG (_SIGMAX + 1) /* For QNX */
Marc-André Lemburg8bcfb8a2000-07-04 14:17:33 +000037# elif defined(SIGMAX)
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +000038# define NSIG (SIGMAX + 1) /* For djgpp */
Marc-André Lemburg8bcfb8a2000-07-04 14:17:33 +000039# else
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +000040# define NSIG 64 /* Use a reasonable default value */
Marc-André Lemburg8bcfb8a2000-07-04 14:17:33 +000041# endif
Guido van Rossum3bbc62e1995-01-02 19:30:30 +000042#endif
43
44
Guido van Rossumbb4ba121994-06-23 11:25:45 +000045/*
46 NOTES ON THE INTERACTION BETWEEN SIGNALS AND THREADS
47
48 When threads are supported, we want the following semantics:
49
50 - only the main thread can set a signal handler
51 - any thread can get a signal handler
52 - signals are only delivered to the main thread
53
54 I.e. we don't support "synchronous signals" like SIGFPE (catching
55 this doesn't make much sense in Python anyway) nor do we support
56 signals as a means of inter-thread communication, since not all
57 thread implementations support that (at least our thread library
58 doesn't).
59
60 We still have the problem that in some implementations signals
61 generated by the keyboard (e.g. SIGINT) are delivered to all
62 threads (e.g. SGI), while in others (e.g. Solaris) such signals are
63 delivered to one random thread (an intermediate possibility would
Guido van Rossuma3c04b01995-01-12 11:29:01 +000064 be to deliver it to the main thread -- POSIX?). For now, we have
Guido van Rossumbb4ba121994-06-23 11:25:45 +000065 a working implementation that works in all three cases -- the
66 handler ignores signals if getpid() isn't the same as in the main
67 thread. XXX This is a hack.
68
Guido van Rossum9e8181b2000-09-19 00:46:46 +000069 GNU pth is a user-space threading library, and as such, all threads
70 run within the same process. In this case, if the currently running
71 thread is not the main_thread, send the signal to the main_thread.
Guido van Rossumbb4ba121994-06-23 11:25:45 +000072*/
73
74#ifdef WITH_THREAD
Guido van Rossum295b8e51997-06-06 21:16:41 +000075#include <sys/types.h> /* For pid_t */
Guido van Rossum49b56061998-10-01 20:42:43 +000076#include "pythread.h"
Guido van Rossumbb4ba121994-06-23 11:25:45 +000077static long main_thread;
78static pid_t main_pid;
79#endif
80
Barry Warsaw92971171997-01-03 00:14:25 +000081static struct {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +000082 int tripped;
83 PyObject *func;
Barry Warsaw92971171997-01-03 00:14:25 +000084} Handlers[NSIG];
Guido van Rossum398d9fe1994-05-11 08:59:13 +000085
Christian Heimes5fb7c2a2007-12-24 08:52:31 +000086static sig_atomic_t wakeup_fd = -1;
87
Christian Heimesb76922a2007-12-11 01:06:40 +000088/* Speed up sigcheck() when none tripped */
89static volatile sig_atomic_t is_tripped = 0;
Guido van Rossum398d9fe1994-05-11 08:59:13 +000090
Barry Warsaw92971171997-01-03 00:14:25 +000091static PyObject *DefaultHandler;
92static PyObject *IgnoreHandler;
93static PyObject *IntHandler;
Guido van Rossum398d9fe1994-05-11 08:59:13 +000094
Martin v. Löwisf58de1b2001-03-06 12:13:56 +000095/* On Solaris 8, gcc will produce a warning that the function
96 declaration is not a prototype. This is caused by the definition of
97 SIG_DFL as (void (*)())0; the correct declaration would have been
98 (void (*)(int))0. */
99
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000100static PyOS_sighandler_t old_siginthandler = SIG_DFL;
Guido van Rossum08c16611997-08-02 03:01:42 +0000101
Martin v. Löwis823725e2008-03-24 13:39:54 +0000102#ifdef HAVE_GETITIMER
103static PyObject *ItimerError;
104
105/* auxiliary functions for setitimer/getitimer */
106static void
107timeval_from_double(double d, struct timeval *tv)
108{
109 tv->tv_sec = floor(d);
110 tv->tv_usec = fmod(d, 1.0) * 1000000.0;
111}
112
Christian Heimes1a8501c2008-10-02 19:56:01 +0000113Py_LOCAL_INLINE(double)
Martin v. Löwis823725e2008-03-24 13:39:54 +0000114double_from_timeval(struct timeval *tv)
115{
116 return tv->tv_sec + (double)(tv->tv_usec / 1000000.0);
117}
118
119static PyObject *
120itimer_retval(struct itimerval *iv)
121{
122 PyObject *r, *v;
123
124 r = PyTuple_New(2);
125 if (r == NULL)
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000126 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000127
128 if(!(v = PyFloat_FromDouble(double_from_timeval(&iv->it_value)))) {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000129 Py_DECREF(r);
130 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000131 }
132
133 PyTuple_SET_ITEM(r, 0, v);
134
135 if(!(v = PyFloat_FromDouble(double_from_timeval(&iv->it_interval)))) {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000136 Py_DECREF(r);
137 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000138 }
139
140 PyTuple_SET_ITEM(r, 1, v);
141
142 return r;
143}
144#endif
Barry Warsaw92971171997-01-03 00:14:25 +0000145
Guido van Rossume4485b01994-09-07 14:32:49 +0000146static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000147signal_default_int_handler(PyObject *self, PyObject *args)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000148{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000149 PyErr_SetNone(PyExc_KeyboardInterrupt);
150 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000151}
152
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000153PyDoc_STRVAR(default_int_handler_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000154"default_int_handler(...)\n\
155\n\
Michael W. Hudson24ec2112004-06-17 15:55:53 +0000156The default handler for SIGINT installed by Python.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000157It raises KeyboardInterrupt.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000158
Thomas Wouters0796b002000-07-22 23:49:30 +0000159
160static int
161checksignals_witharg(void * unused)
162{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000163 return PyErr_CheckSignals();
Thomas Wouters0796b002000-07-22 23:49:30 +0000164}
165
Tim Peters4f1b2082000-07-23 21:18:09 +0000166static void
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000167signal_handler(int sig_num)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000168{
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000169#ifdef WITH_THREAD
Guido van Rossum9e8181b2000-09-19 00:46:46 +0000170#ifdef WITH_PTH
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000171 if (PyThread_get_thread_ident() != main_thread) {
172 pth_raise(*(pth_t *) main_thread, sig_num);
173 return;
174 }
Guido van Rossum9e8181b2000-09-19 00:46:46 +0000175#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000176 /* See NOTES section above */
177 if (getpid() == main_pid) {
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000178#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000179 Handlers[sig_num].tripped = 1;
180 /* Set is_tripped after setting .tripped, as it gets
181 cleared in PyErr_CheckSignals() before .tripped. */
182 is_tripped = 1;
183 Py_AddPendingCall(checksignals_witharg, NULL);
184 if (wakeup_fd != -1)
185 write(wakeup_fd, "\0", 1);
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000186#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000187 }
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000188#endif
Guido van Rossum602099a1994-09-14 13:32:22 +0000189#ifdef SIGCHLD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000190 if (sig_num == SIGCHLD) {
191 /* To avoid infinite recursion, this signal remains
192 reset until explicit re-instated.
193 Don't clear the 'func' field as it is our pointer
194 to the Python handler... */
195 return;
196 }
Guido van Rossum602099a1994-09-14 13:32:22 +0000197#endif
Jean-Paul Calderone9c39bc72010-05-09 03:25:16 +0000198#ifndef HAVE_SIGACTION
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000199 /* If the handler was not set up with sigaction, reinstall it. See
200 * Python/pythonrun.c for the implementation of PyOS_setsig which
201 * makes this true. See also issue8354. */
202 PyOS_setsig(sig_num, signal_handler);
Jean-Paul Calderone9c39bc72010-05-09 03:25:16 +0000203#endif
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000204}
Guido van Rossume4485b01994-09-07 14:32:49 +0000205
Guido van Rossum06d511d1995-03-10 15:13:48 +0000206
Guido van Rossum1171ee61997-08-22 20:42:00 +0000207#ifdef HAVE_ALARM
Guido van Rossume4485b01994-09-07 14:32:49 +0000208static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000209signal_alarm(PyObject *self, PyObject *args)
Guido van Rossumb6775db1994-08-01 11:34:53 +0000210{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000211 int t;
212 if (!PyArg_ParseTuple(args, "i:alarm", &t))
213 return NULL;
214 /* alarm() returns the number of seconds remaining */
215 return PyLong_FromLong((long)alarm(t));
Guido van Rossumaa0f4c71994-08-23 13:49:37 +0000216}
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000217
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000218PyDoc_STRVAR(alarm_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000219"alarm(seconds)\n\
220\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000221Arrange for SIGALRM to arrive after the given number of seconds.");
Guido van Rossum06d511d1995-03-10 15:13:48 +0000222#endif
Guido van Rossumb6775db1994-08-01 11:34:53 +0000223
Guido van Rossum1171ee61997-08-22 20:42:00 +0000224#ifdef HAVE_PAUSE
Guido van Rossuma597dde1995-01-10 20:56:29 +0000225static PyObject *
Neal Norwitz3a6f9782002-03-25 20:46:46 +0000226signal_pause(PyObject *self)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000227{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000228 Py_BEGIN_ALLOW_THREADS
229 (void)pause();
230 Py_END_ALLOW_THREADS
231 /* make sure that any exceptions that got raised are propagated
232 * back into Python
233 */
234 if (PyErr_CheckSignals())
235 return NULL;
Barry Warsaw92971171997-01-03 00:14:25 +0000236
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000237 Py_INCREF(Py_None);
238 return Py_None;
Guido van Rossume4485b01994-09-07 14:32:49 +0000239}
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000240PyDoc_STRVAR(pause_doc,
Barry Warsaw1ee36ff1998-07-21 22:41:18 +0000241"pause()\n\
242\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000243Wait until a signal arrives.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000244
Guido van Rossum06d511d1995-03-10 15:13:48 +0000245#endif
Guido van Rossume4485b01994-09-07 14:32:49 +0000246
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000247
Guido van Rossume4485b01994-09-07 14:32:49 +0000248static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000249signal_signal(PyObject *self, PyObject *args)
Guido van Rossume4485b01994-09-07 14:32:49 +0000250{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000251 PyObject *obj;
252 int sig_num;
253 PyObject *old_handler;
254 void (*func)(int);
Brian Curtin3f004b12010-08-06 19:34:52 +0000255#ifdef MS_WINDOWS
256 int cur_sig, num_valid_sigs = 6;
257 static int valid_sigs[] = {SIGABRT, SIGFPE, SIGILL, SIGINT,
258 SIGSEGV, SIGTERM};
259 BOOL valid_sig = FALSE;
260#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000261 if (!PyArg_ParseTuple(args, "iO:signal", &sig_num, &obj))
262 return NULL;
Brian Curtin3f004b12010-08-06 19:34:52 +0000263#ifdef MS_WINDOWS
264 /* Validate that sig_num is one of the allowable signals */
265 for (cur_sig = 0; cur_sig < num_valid_sigs; cur_sig++)
266 valid_sig |= (sig_num == valid_sigs[cur_sig]);
267 if (!valid_sig) {
268 PyErr_SetString(PyExc_ValueError, "signal number out of range");
269 return NULL;
270 }
271#endif
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000272#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000273 if (PyThread_get_thread_ident() != main_thread) {
274 PyErr_SetString(PyExc_ValueError,
275 "signal only works in main thread");
276 return NULL;
277 }
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000278#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000279 if (sig_num < 1 || sig_num >= NSIG) {
280 PyErr_SetString(PyExc_ValueError,
281 "signal number out of range");
282 return NULL;
283 }
284 if (obj == IgnoreHandler)
285 func = SIG_IGN;
286 else if (obj == DefaultHandler)
287 func = SIG_DFL;
288 else if (!PyCallable_Check(obj)) {
289 PyErr_SetString(PyExc_TypeError,
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000290"signal handler must be signal.SIG_IGN, signal.SIG_DFL, or a callable object");
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000291 return NULL;
292 }
293 else
294 func = signal_handler;
295 if (PyOS_setsig(sig_num, func) == SIG_ERR) {
296 PyErr_SetFromErrno(PyExc_RuntimeError);
297 return NULL;
298 }
299 old_handler = Handlers[sig_num].func;
300 Handlers[sig_num].tripped = 0;
301 Py_INCREF(obj);
302 Handlers[sig_num].func = obj;
303 return old_handler;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000304}
305
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000306PyDoc_STRVAR(signal_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000307"signal(sig, action) -> action\n\
308\n\
309Set the action for the given signal. The action can be SIG_DFL,\n\
310SIG_IGN, or a callable Python object. The previous action is\n\
311returned. See getsignal() for possible return values.\n\
312\n\
313*** IMPORTANT NOTICE ***\n\
314A signal handler function is called with two arguments:\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000315the first is the signal number, the second is the interrupted stack frame.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000316
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000317
Guido van Rossume4485b01994-09-07 14:32:49 +0000318static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000319signal_getsignal(PyObject *self, PyObject *args)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000320{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000321 int sig_num;
322 PyObject *old_handler;
323 if (!PyArg_ParseTuple(args, "i:getsignal", &sig_num))
324 return NULL;
325 if (sig_num < 1 || sig_num >= NSIG) {
326 PyErr_SetString(PyExc_ValueError,
327 "signal number out of range");
328 return NULL;
329 }
330 old_handler = Handlers[sig_num].func;
331 Py_INCREF(old_handler);
332 return old_handler;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000333}
334
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000335PyDoc_STRVAR(getsignal_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000336"getsignal(sig) -> action\n\
337\n\
338Return the current action for the given signal. The return value can be:\n\
339SIG_IGN -- if the signal is being ignored\n\
340SIG_DFL -- if the default action for the signal is in effect\n\
341None -- if an unknown handler is in effect\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000342anything else -- the callable Python object used as a handler");
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000343
Christian Heimes8640e742008-02-23 16:23:06 +0000344#ifdef HAVE_SIGINTERRUPT
345PyDoc_STRVAR(siginterrupt_doc,
346"siginterrupt(sig, flag) -> None\n\
347change system call restart behaviour: if flag is False, system calls\n\
348will be restarted when interrupted by signal sig, else system calls\n\
349will be interrupted.");
350
351static PyObject *
352signal_siginterrupt(PyObject *self, PyObject *args)
353{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000354 int sig_num;
355 int flag;
Christian Heimes8640e742008-02-23 16:23:06 +0000356
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000357 if (!PyArg_ParseTuple(args, "ii:siginterrupt", &sig_num, &flag))
358 return NULL;
359 if (sig_num < 1 || sig_num >= NSIG) {
360 PyErr_SetString(PyExc_ValueError,
361 "signal number out of range");
362 return NULL;
363 }
364 if (siginterrupt(sig_num, flag)<0) {
365 PyErr_SetFromErrno(PyExc_RuntimeError);
366 return NULL;
367 }
Christian Heimes8640e742008-02-23 16:23:06 +0000368
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000369 Py_INCREF(Py_None);
370 return Py_None;
Christian Heimes8640e742008-02-23 16:23:06 +0000371}
372
373#endif
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000374
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000375static PyObject *
376signal_set_wakeup_fd(PyObject *self, PyObject *args)
377{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000378 struct stat buf;
379 int fd, old_fd;
380 if (!PyArg_ParseTuple(args, "i:set_wakeup_fd", &fd))
381 return NULL;
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000382#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000383 if (PyThread_get_thread_ident() != main_thread) {
384 PyErr_SetString(PyExc_ValueError,
385 "set_wakeup_fd only works in main thread");
386 return NULL;
387 }
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000388#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000389 if (fd != -1 && fstat(fd, &buf) != 0) {
390 PyErr_SetString(PyExc_ValueError, "invalid fd");
391 return NULL;
392 }
393 old_fd = wakeup_fd;
394 wakeup_fd = fd;
395 return PyLong_FromLong(old_fd);
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000396}
397
398PyDoc_STRVAR(set_wakeup_fd_doc,
399"set_wakeup_fd(fd) -> fd\n\
400\n\
401Sets the fd to be written to (with '\\0') when a signal\n\
402comes in. A library can use this to wakeup select or poll.\n\
403The previous fd is returned.\n\
404\n\
405The fd must be non-blocking.");
406
407/* C API for the same, without all the error checking */
408int
409PySignal_SetWakeupFd(int fd)
410{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000411 int old_fd = wakeup_fd;
412 if (fd < 0)
413 fd = -1;
414 wakeup_fd = fd;
415 return old_fd;
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000416}
417
418
Martin v. Löwis823725e2008-03-24 13:39:54 +0000419#ifdef HAVE_SETITIMER
420static PyObject *
421signal_setitimer(PyObject *self, PyObject *args)
422{
423 double first;
424 double interval = 0;
425 int which;
426 struct itimerval new, old;
427
428 if(!PyArg_ParseTuple(args, "id|d:setitimer", &which, &first, &interval))
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000429 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000430
431 timeval_from_double(first, &new.it_value);
432 timeval_from_double(interval, &new.it_interval);
433 /* Let OS check "which" value */
434 if (setitimer(which, &new, &old) != 0) {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000435 PyErr_SetFromErrno(ItimerError);
436 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000437 }
438
439 return itimer_retval(&old);
440}
441
442PyDoc_STRVAR(setitimer_doc,
443"setitimer(which, seconds[, interval])\n\
444\n\
445Sets given itimer (one of ITIMER_REAL, ITIMER_VIRTUAL\n\
446or ITIMER_PROF) to fire after value seconds and after\n\
447that every interval seconds.\n\
448The itimer can be cleared by setting seconds to zero.\n\
449\n\
450Returns old values as a tuple: (delay, interval).");
451#endif
452
453
454#ifdef HAVE_GETITIMER
455static PyObject *
456signal_getitimer(PyObject *self, PyObject *args)
457{
458 int which;
459 struct itimerval old;
460
461 if (!PyArg_ParseTuple(args, "i:getitimer", &which))
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000462 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000463
464 if (getitimer(which, &old) != 0) {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000465 PyErr_SetFromErrno(ItimerError);
466 return NULL;
Martin v. Löwis823725e2008-03-24 13:39:54 +0000467 }
468
469 return itimer_retval(&old);
470}
471
472PyDoc_STRVAR(getitimer_doc,
473"getitimer(which)\n\
474\n\
475Returns current value of given itimer.");
476#endif
477
478
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000479/* List of functions defined in the module */
Barry Warsaw92971171997-01-03 00:14:25 +0000480static PyMethodDef signal_methods[] = {
Guido van Rossum1171ee61997-08-22 20:42:00 +0000481#ifdef HAVE_ALARM
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000482 {"alarm", signal_alarm, METH_VARARGS, alarm_doc},
Guido van Rossum06d511d1995-03-10 15:13:48 +0000483#endif
Martin v. Löwis823725e2008-03-24 13:39:54 +0000484#ifdef HAVE_SETITIMER
485 {"setitimer", signal_setitimer, METH_VARARGS, setitimer_doc},
486#endif
487#ifdef HAVE_GETITIMER
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000488 {"getitimer", signal_getitimer, METH_VARARGS, getitimer_doc},
Martin v. Löwis823725e2008-03-24 13:39:54 +0000489#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000490 {"signal", signal_signal, METH_VARARGS, signal_doc},
491 {"getsignal", signal_getsignal, METH_VARARGS, getsignal_doc},
492 {"set_wakeup_fd", signal_set_wakeup_fd, METH_VARARGS, set_wakeup_fd_doc},
Christian Heimes8640e742008-02-23 16:23:06 +0000493#ifdef HAVE_SIGINTERRUPT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000494 {"siginterrupt", signal_siginterrupt, METH_VARARGS, siginterrupt_doc},
Christian Heimes8640e742008-02-23 16:23:06 +0000495#endif
Guido van Rossum1171ee61997-08-22 20:42:00 +0000496#ifdef HAVE_PAUSE
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000497 {"pause", (PyCFunction)signal_pause,
498 METH_NOARGS,pause_doc},
Guido van Rossum06d511d1995-03-10 15:13:48 +0000499#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000500 {"default_int_handler", signal_default_int_handler,
501 METH_VARARGS, default_int_handler_doc},
502 {NULL, NULL} /* sentinel */
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000503};
504
Barry Warsaw92971171997-01-03 00:14:25 +0000505
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000506PyDoc_STRVAR(module_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000507"This module provides mechanisms to use signal handlers in Python.\n\
508\n\
509Functions:\n\
510\n\
511alarm() -- cause SIGALRM after a specified time [Unix only]\n\
Martin v. Löwis823725e2008-03-24 13:39:54 +0000512setitimer() -- cause a signal (described below) after a specified\n\
513 float time and the timer may restart then [Unix only]\n\
514getitimer() -- get current value of timer [Unix only]\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000515signal() -- set the action for a given signal\n\
516getsignal() -- get the signal action for a given signal\n\
517pause() -- wait until a signal arrives [Unix only]\n\
518default_int_handler() -- default SIGINT handler\n\
519\n\
Martin v. Löwis823725e2008-03-24 13:39:54 +0000520signal constants:\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000521SIG_DFL -- used to refer to the system default handler\n\
522SIG_IGN -- used to ignore the signal\n\
523NSIG -- number of defined signals\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000524SIGINT, SIGTERM, etc. -- signal numbers\n\
525\n\
Martin v. Löwis823725e2008-03-24 13:39:54 +0000526itimer constants:\n\
527ITIMER_REAL -- decrements in real time, and delivers SIGALRM upon\n\
528 expiration\n\
529ITIMER_VIRTUAL -- decrements only when the process is executing,\n\
530 and delivers SIGVTALRM upon expiration\n\
531ITIMER_PROF -- decrements both when the process is executing and\n\
532 when the system is executing on behalf of the process.\n\
533 Coupled with ITIMER_VIRTUAL, this timer is usually\n\
534 used to profile the time spent by the application\n\
535 in user and kernel space. SIGPROF is delivered upon\n\
536 expiration.\n\
537\n\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000538*** IMPORTANT NOTICE ***\n\
539A signal handler function is called with two arguments:\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000540the first is the signal number, the second is the interrupted stack frame.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000541
Martin v. Löwis1a214512008-06-11 05:26:20 +0000542static struct PyModuleDef signalmodule = {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000543 PyModuleDef_HEAD_INIT,
544 "signal",
545 module_doc,
546 -1,
547 signal_methods,
548 NULL,
549 NULL,
550 NULL,
551 NULL
Martin v. Löwis1a214512008-06-11 05:26:20 +0000552};
553
Mark Hammondfe51c6d2002-08-02 02:27:13 +0000554PyMODINIT_FUNC
Martin v. Löwis1a214512008-06-11 05:26:20 +0000555PyInit_signal(void)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000556{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000557 PyObject *m, *d, *x;
558 int i;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000559
560#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000561 main_thread = PyThread_get_thread_ident();
562 main_pid = getpid();
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000563#endif
564
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000565 /* Create the module and add the functions */
566 m = PyModule_Create(&signalmodule);
567 if (m == NULL)
568 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000569
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000570 /* Add some symbolic constants to the module */
571 d = PyModule_GetDict(m);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000572
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000573 x = DefaultHandler = PyLong_FromVoidPtr((void *)SIG_DFL);
574 if (!x || PyDict_SetItemString(d, "SIG_DFL", x) < 0)
575 goto finally;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000576
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000577 x = IgnoreHandler = PyLong_FromVoidPtr((void *)SIG_IGN);
578 if (!x || PyDict_SetItemString(d, "SIG_IGN", x) < 0)
579 goto finally;
Barry Warsaw92971171997-01-03 00:14:25 +0000580
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000581 x = PyLong_FromLong((long)NSIG);
582 if (!x || PyDict_SetItemString(d, "NSIG", x) < 0)
583 goto finally;
584 Py_DECREF(x);
Barry Warsaw92971171997-01-03 00:14:25 +0000585
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000586 x = IntHandler = PyDict_GetItemString(d, "default_int_handler");
587 if (!x)
588 goto finally;
589 Py_INCREF(IntHandler);
Barry Warsaw92971171997-01-03 00:14:25 +0000590
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000591 Handlers[0].tripped = 0;
592 for (i = 1; i < NSIG; i++) {
593 void (*t)(int);
594 t = PyOS_getsig(i);
595 Handlers[i].tripped = 0;
596 if (t == SIG_DFL)
597 Handlers[i].func = DefaultHandler;
598 else if (t == SIG_IGN)
599 Handlers[i].func = IgnoreHandler;
600 else
601 Handlers[i].func = Py_None; /* None of our business */
602 Py_INCREF(Handlers[i].func);
603 }
604 if (Handlers[SIGINT].func == DefaultHandler) {
605 /* Install default int handler */
606 Py_INCREF(IntHandler);
607 Py_DECREF(Handlers[SIGINT].func);
608 Handlers[SIGINT].func = IntHandler;
609 old_siginthandler = PyOS_setsig(SIGINT, signal_handler);
610 }
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000611
612#ifdef SIGHUP
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000613 x = PyLong_FromLong(SIGHUP);
614 PyDict_SetItemString(d, "SIGHUP", x);
615 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000616#endif
617#ifdef SIGINT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000618 x = PyLong_FromLong(SIGINT);
619 PyDict_SetItemString(d, "SIGINT", x);
620 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000621#endif
Tim Peters1ce3cf72001-10-01 17:58:40 +0000622#ifdef SIGBREAK
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000623 x = PyLong_FromLong(SIGBREAK);
624 PyDict_SetItemString(d, "SIGBREAK", x);
625 Py_XDECREF(x);
Tim Peters1ce3cf72001-10-01 17:58:40 +0000626#endif
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000627#ifdef SIGQUIT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000628 x = PyLong_FromLong(SIGQUIT);
629 PyDict_SetItemString(d, "SIGQUIT", x);
630 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000631#endif
632#ifdef SIGILL
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000633 x = PyLong_FromLong(SIGILL);
634 PyDict_SetItemString(d, "SIGILL", x);
635 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000636#endif
637#ifdef SIGTRAP
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000638 x = PyLong_FromLong(SIGTRAP);
639 PyDict_SetItemString(d, "SIGTRAP", x);
640 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000641#endif
642#ifdef SIGIOT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000643 x = PyLong_FromLong(SIGIOT);
644 PyDict_SetItemString(d, "SIGIOT", x);
645 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000646#endif
647#ifdef SIGABRT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000648 x = PyLong_FromLong(SIGABRT);
649 PyDict_SetItemString(d, "SIGABRT", x);
650 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000651#endif
652#ifdef SIGEMT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000653 x = PyLong_FromLong(SIGEMT);
654 PyDict_SetItemString(d, "SIGEMT", x);
655 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000656#endif
657#ifdef SIGFPE
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000658 x = PyLong_FromLong(SIGFPE);
659 PyDict_SetItemString(d, "SIGFPE", x);
660 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000661#endif
662#ifdef SIGKILL
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000663 x = PyLong_FromLong(SIGKILL);
664 PyDict_SetItemString(d, "SIGKILL", x);
665 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000666#endif
667#ifdef SIGBUS
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000668 x = PyLong_FromLong(SIGBUS);
669 PyDict_SetItemString(d, "SIGBUS", x);
670 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000671#endif
672#ifdef SIGSEGV
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000673 x = PyLong_FromLong(SIGSEGV);
674 PyDict_SetItemString(d, "SIGSEGV", x);
675 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000676#endif
677#ifdef SIGSYS
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000678 x = PyLong_FromLong(SIGSYS);
679 PyDict_SetItemString(d, "SIGSYS", x);
680 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000681#endif
682#ifdef SIGPIPE
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000683 x = PyLong_FromLong(SIGPIPE);
684 PyDict_SetItemString(d, "SIGPIPE", x);
685 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000686#endif
687#ifdef SIGALRM
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000688 x = PyLong_FromLong(SIGALRM);
689 PyDict_SetItemString(d, "SIGALRM", x);
690 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000691#endif
692#ifdef SIGTERM
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000693 x = PyLong_FromLong(SIGTERM);
694 PyDict_SetItemString(d, "SIGTERM", x);
695 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000696#endif
697#ifdef SIGUSR1
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000698 x = PyLong_FromLong(SIGUSR1);
699 PyDict_SetItemString(d, "SIGUSR1", x);
700 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000701#endif
702#ifdef SIGUSR2
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000703 x = PyLong_FromLong(SIGUSR2);
704 PyDict_SetItemString(d, "SIGUSR2", x);
705 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000706#endif
707#ifdef SIGCLD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000708 x = PyLong_FromLong(SIGCLD);
709 PyDict_SetItemString(d, "SIGCLD", x);
710 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000711#endif
712#ifdef SIGCHLD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000713 x = PyLong_FromLong(SIGCHLD);
714 PyDict_SetItemString(d, "SIGCHLD", x);
715 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000716#endif
717#ifdef SIGPWR
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000718 x = PyLong_FromLong(SIGPWR);
719 PyDict_SetItemString(d, "SIGPWR", x);
720 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000721#endif
722#ifdef SIGIO
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000723 x = PyLong_FromLong(SIGIO);
724 PyDict_SetItemString(d, "SIGIO", x);
725 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000726#endif
727#ifdef SIGURG
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000728 x = PyLong_FromLong(SIGURG);
729 PyDict_SetItemString(d, "SIGURG", x);
730 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000731#endif
732#ifdef SIGWINCH
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000733 x = PyLong_FromLong(SIGWINCH);
734 PyDict_SetItemString(d, "SIGWINCH", x);
735 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000736#endif
737#ifdef SIGPOLL
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000738 x = PyLong_FromLong(SIGPOLL);
739 PyDict_SetItemString(d, "SIGPOLL", x);
740 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000741#endif
742#ifdef SIGSTOP
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000743 x = PyLong_FromLong(SIGSTOP);
744 PyDict_SetItemString(d, "SIGSTOP", x);
745 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000746#endif
747#ifdef SIGTSTP
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000748 x = PyLong_FromLong(SIGTSTP);
749 PyDict_SetItemString(d, "SIGTSTP", x);
750 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000751#endif
752#ifdef SIGCONT
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000753 x = PyLong_FromLong(SIGCONT);
754 PyDict_SetItemString(d, "SIGCONT", x);
755 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000756#endif
757#ifdef SIGTTIN
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000758 x = PyLong_FromLong(SIGTTIN);
759 PyDict_SetItemString(d, "SIGTTIN", x);
760 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000761#endif
762#ifdef SIGTTOU
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000763 x = PyLong_FromLong(SIGTTOU);
764 PyDict_SetItemString(d, "SIGTTOU", x);
765 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000766#endif
767#ifdef SIGVTALRM
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000768 x = PyLong_FromLong(SIGVTALRM);
769 PyDict_SetItemString(d, "SIGVTALRM", x);
770 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000771#endif
772#ifdef SIGPROF
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000773 x = PyLong_FromLong(SIGPROF);
774 PyDict_SetItemString(d, "SIGPROF", x);
775 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000776#endif
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000777#ifdef SIGXCPU
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000778 x = PyLong_FromLong(SIGXCPU);
779 PyDict_SetItemString(d, "SIGXCPU", x);
780 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000781#endif
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000782#ifdef SIGXFSZ
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000783 x = PyLong_FromLong(SIGXFSZ);
784 PyDict_SetItemString(d, "SIGXFSZ", x);
785 Py_XDECREF(x);
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000786#endif
Anthony Baxterf37f37d2003-07-31 10:35:29 +0000787#ifdef SIGRTMIN
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000788 x = PyLong_FromLong(SIGRTMIN);
789 PyDict_SetItemString(d, "SIGRTMIN", x);
790 Py_XDECREF(x);
Anthony Baxterf37f37d2003-07-31 10:35:29 +0000791#endif
792#ifdef SIGRTMAX
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000793 x = PyLong_FromLong(SIGRTMAX);
794 PyDict_SetItemString(d, "SIGRTMAX", x);
795 Py_XDECREF(x);
Anthony Baxterf37f37d2003-07-31 10:35:29 +0000796#endif
Martin v. Löwis175af252002-01-12 11:43:25 +0000797#ifdef SIGINFO
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000798 x = PyLong_FromLong(SIGINFO);
799 PyDict_SetItemString(d, "SIGINFO", x);
800 Py_XDECREF(x);
Martin v. Löwis175af252002-01-12 11:43:25 +0000801#endif
Martin v. Löwis823725e2008-03-24 13:39:54 +0000802
803#ifdef ITIMER_REAL
804 x = PyLong_FromLong(ITIMER_REAL);
805 PyDict_SetItemString(d, "ITIMER_REAL", x);
806 Py_DECREF(x);
807#endif
808#ifdef ITIMER_VIRTUAL
809 x = PyLong_FromLong(ITIMER_VIRTUAL);
810 PyDict_SetItemString(d, "ITIMER_VIRTUAL", x);
811 Py_DECREF(x);
812#endif
813#ifdef ITIMER_PROF
814 x = PyLong_FromLong(ITIMER_PROF);
815 PyDict_SetItemString(d, "ITIMER_PROF", x);
816 Py_DECREF(x);
817#endif
818
819#if defined (HAVE_SETITIMER) || defined (HAVE_GETITIMER)
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000820 ItimerError = PyErr_NewException("signal.ItimerError",
821 PyExc_IOError, NULL);
Neal Norwitz2f99b242008-08-24 05:48:10 +0000822 if (ItimerError != NULL)
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000823 PyDict_SetItemString(d, "ItimerError", ItimerError);
Martin v. Löwis823725e2008-03-24 13:39:54 +0000824#endif
825
Martin v. Löwis1a214512008-06-11 05:26:20 +0000826 if (PyErr_Occurred()) {
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000827 Py_DECREF(m);
828 m = NULL;
Martin v. Löwis1a214512008-06-11 05:26:20 +0000829 }
Barry Warsaw92971171997-01-03 00:14:25 +0000830
Barry Warsaw92971171997-01-03 00:14:25 +0000831 finally:
Martin v. Löwis1a214512008-06-11 05:26:20 +0000832 return m;
Guido van Rossum08c16611997-08-02 03:01:42 +0000833}
834
835static void
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000836finisignal(void)
Guido van Rossum08c16611997-08-02 03:01:42 +0000837{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000838 int i;
839 PyObject *func;
Guido van Rossum08c16611997-08-02 03:01:42 +0000840
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000841 PyOS_setsig(SIGINT, old_siginthandler);
842 old_siginthandler = SIG_DFL;
Guido van Rossum08c16611997-08-02 03:01:42 +0000843
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000844 for (i = 1; i < NSIG; i++) {
845 func = Handlers[i].func;
846 Handlers[i].tripped = 0;
847 Handlers[i].func = NULL;
848 if (i != SIGINT && func != NULL && func != Py_None &&
849 func != DefaultHandler && func != IgnoreHandler)
850 PyOS_setsig(i, SIG_DFL);
851 Py_XDECREF(func);
852 }
Guido van Rossum08c16611997-08-02 03:01:42 +0000853
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000854 Py_XDECREF(IntHandler);
855 IntHandler = NULL;
856 Py_XDECREF(DefaultHandler);
857 DefaultHandler = NULL;
858 Py_XDECREF(IgnoreHandler);
859 IgnoreHandler = NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000860}
861
Barry Warsaw92971171997-01-03 00:14:25 +0000862
Barry Warsaw92971171997-01-03 00:14:25 +0000863/* Declared in pyerrors.h */
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000864int
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000865PyErr_CheckSignals(void)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000866{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000867 int i;
868 PyObject *f;
Barry Warsaw92971171997-01-03 00:14:25 +0000869
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000870 if (!is_tripped)
871 return 0;
Christian Heimesb76922a2007-12-11 01:06:40 +0000872
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000873#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000874 if (PyThread_get_thread_ident() != main_thread)
875 return 0;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000876#endif
Christian Heimesb76922a2007-12-11 01:06:40 +0000877
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000878 /*
879 * The is_tripped variable is meant to speed up the calls to
880 * PyErr_CheckSignals (both directly or via pending calls) when no
881 * signal has arrived. This variable is set to 1 when a signal arrives
882 * and it is set to 0 here, when we know some signals arrived. This way
883 * we can run the registered handlers with no signals blocked.
884 *
885 * NOTE: with this approach we can have a situation where is_tripped is
886 * 1 but we have no more signals to handle (Handlers[i].tripped
887 * is 0 for every signal i). This won't do us any harm (except
888 * we're gonna spent some cycles for nothing). This happens when
889 * we receive a signal i after we zero is_tripped and before we
890 * check Handlers[i].tripped.
891 */
892 is_tripped = 0;
Christian Heimesb76922a2007-12-11 01:06:40 +0000893
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000894 if (!(f = (PyObject *)PyEval_GetFrame()))
895 f = Py_None;
Christian Heimesb76922a2007-12-11 01:06:40 +0000896
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000897 for (i = 1; i < NSIG; i++) {
898 if (Handlers[i].tripped) {
899 PyObject *result = NULL;
900 PyObject *arglist = Py_BuildValue("(iO)", i, f);
901 Handlers[i].tripped = 0;
Barry Warsaw92971171997-01-03 00:14:25 +0000902
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000903 if (arglist) {
904 result = PyEval_CallObject(Handlers[i].func,
905 arglist);
906 Py_DECREF(arglist);
907 }
908 if (!result)
909 return -1;
Barry Warsaw92971171997-01-03 00:14:25 +0000910
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000911 Py_DECREF(result);
912 }
913 }
Christian Heimesb76922a2007-12-11 01:06:40 +0000914
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000915 return 0;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000916}
917
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000918
Barry Warsaw92971171997-01-03 00:14:25 +0000919/* Replacements for intrcheck.c functionality
920 * Declared in pyerrors.h
921 */
922void
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000923PyErr_SetInterrupt(void)
Barry Warsaw92971171997-01-03 00:14:25 +0000924{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000925 is_tripped = 1;
926 Handlers[SIGINT].tripped = 1;
927 Py_AddPendingCall((int (*)(void *))PyErr_CheckSignals, NULL);
Barry Warsaw92971171997-01-03 00:14:25 +0000928}
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000929
930void
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000931PyOS_InitInterrupts(void)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000932{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000933 PyObject *m = PyInit_signal();
934 if (m) {
935 _PyImport_FixupExtension(m, "signal", "signal");
936 Py_DECREF(m);
937 }
Guido van Rossum08c16611997-08-02 03:01:42 +0000938}
939
940void
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000941PyOS_FiniInterrupts(void)
Guido van Rossum08c16611997-08-02 03:01:42 +0000942{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000943 finisignal();
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000944}
945
946int
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000947PyOS_InterruptOccurred(void)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000948{
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000949 if (Handlers[SIGINT].tripped) {
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000950#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000951 if (PyThread_get_thread_ident() != main_thread)
952 return 0;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000953#endif
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000954 Handlers[SIGINT].tripped = 0;
955 return 1;
956 }
957 return 0;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000958}
Guido van Rossum359bcaa1997-11-14 22:24:28 +0000959
960void
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000961PyOS_AfterFork(void)
Guido van Rossum359bcaa1997-11-14 22:24:28 +0000962{
963#ifdef WITH_THREAD
Antoine Pitrou7f14f0d2010-05-09 16:14:21 +0000964 PyEval_ReInitThreads();
965 main_thread = PyThread_get_thread_ident();
966 main_pid = getpid();
967 _PyImport_ReInitLock();
968 PyThread_ReInitTLS();
Guido van Rossum359bcaa1997-11-14 22:24:28 +0000969#endif
970}