blob: 6437cb44fbd45716202751ec2017b55e7e086899 [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 Curtineb24d742010-04-12 17:16:38 +000010#include <Windows.h>
Benjamin Peterson2614cda2010-03-21 22:36:19 +000011#ifdef HAVE_PROCESS_H
Guido van Rossum644a12b1997-04-09 19:24:53 +000012#include <process.h>
13#endif
Benjamin Peterson2614cda2010-03-21 22:36:19 +000014#endif
Guido van Rossum644a12b1997-04-09 19:24:53 +000015
Benjamin Peterson2614cda2010-03-21 22:36:19 +000016#ifdef HAVE_SIGNAL_H
Guido van Rossum398d9fe1994-05-11 08:59:13 +000017#include <signal.h>
Benjamin Peterson2614cda2010-03-21 22:36:19 +000018#endif
19#ifdef HAVE_SYS_STAT_H
Christian Heimes5fb7c2a2007-12-24 08:52:31 +000020#include <sys/stat.h>
Benjamin Peterson2614cda2010-03-21 22:36:19 +000021#endif
Martin v. Löwis3bf3cc02008-03-24 14:05:07 +000022#ifdef HAVE_SYS_TIME_H
Martin v. Löwis823725e2008-03-24 13:39:54 +000023#include <sys/time.h>
Martin v. Löwis3bf3cc02008-03-24 14:05:07 +000024#endif
Christian Heimes5fb7c2a2007-12-24 08:52:31 +000025
Guido van Rossumbb4ba121994-06-23 11:25:45 +000026#ifndef SIG_ERR
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +000027#define SIG_ERR ((PyOS_sighandler_t)(-1))
Guido van Rossumbb4ba121994-06-23 11:25:45 +000028#endif
29
Andrew MacIntyre7bf68332002-03-03 02:59:16 +000030#if defined(PYOS_OS2) && !defined(PYCC_GCC)
Guido van Rossum8e9ebfd1997-11-22 21:53:48 +000031#define NSIG 12
32#include <process.h>
33#endif
34
Guido van Rossum3bbc62e1995-01-02 19:30:30 +000035#ifndef NSIG
Marc-André Lemburg8bcfb8a2000-07-04 14:17:33 +000036# if defined(_NSIG)
37# define NSIG _NSIG /* For BSD/SysV */
38# elif defined(_SIGMAX)
39# define NSIG (_SIGMAX + 1) /* For QNX */
40# elif defined(SIGMAX)
41# define NSIG (SIGMAX + 1) /* For djgpp */
42# else
43# define NSIG 64 /* Use a reasonable default value */
44# endif
Guido van Rossum3bbc62e1995-01-02 19:30:30 +000045#endif
46
47
Guido van Rossumbb4ba121994-06-23 11:25:45 +000048/*
49 NOTES ON THE INTERACTION BETWEEN SIGNALS AND THREADS
50
51 When threads are supported, we want the following semantics:
52
53 - only the main thread can set a signal handler
54 - any thread can get a signal handler
55 - signals are only delivered to the main thread
56
57 I.e. we don't support "synchronous signals" like SIGFPE (catching
58 this doesn't make much sense in Python anyway) nor do we support
59 signals as a means of inter-thread communication, since not all
60 thread implementations support that (at least our thread library
61 doesn't).
62
63 We still have the problem that in some implementations signals
64 generated by the keyboard (e.g. SIGINT) are delivered to all
65 threads (e.g. SGI), while in others (e.g. Solaris) such signals are
66 delivered to one random thread (an intermediate possibility would
Guido van Rossuma3c04b01995-01-12 11:29:01 +000067 be to deliver it to the main thread -- POSIX?). For now, we have
Guido van Rossumbb4ba121994-06-23 11:25:45 +000068 a working implementation that works in all three cases -- the
69 handler ignores signals if getpid() isn't the same as in the main
70 thread. XXX This is a hack.
71
Guido van Rossum9e8181b2000-09-19 00:46:46 +000072 GNU pth is a user-space threading library, and as such, all threads
73 run within the same process. In this case, if the currently running
74 thread is not the main_thread, send the signal to the main_thread.
Guido van Rossumbb4ba121994-06-23 11:25:45 +000075*/
76
77#ifdef WITH_THREAD
Guido van Rossum295b8e51997-06-06 21:16:41 +000078#include <sys/types.h> /* For pid_t */
Guido van Rossum49b56061998-10-01 20:42:43 +000079#include "pythread.h"
Guido van Rossumbb4ba121994-06-23 11:25:45 +000080static long main_thread;
81static pid_t main_pid;
82#endif
83
Barry Warsaw92971171997-01-03 00:14:25 +000084static struct {
85 int tripped;
86 PyObject *func;
87} Handlers[NSIG];
Guido van Rossum398d9fe1994-05-11 08:59:13 +000088
Christian Heimes5fb7c2a2007-12-24 08:52:31 +000089static sig_atomic_t wakeup_fd = -1;
90
Christian Heimesb76922a2007-12-11 01:06:40 +000091/* Speed up sigcheck() when none tripped */
92static volatile sig_atomic_t is_tripped = 0;
Guido van Rossum398d9fe1994-05-11 08:59:13 +000093
Barry Warsaw92971171997-01-03 00:14:25 +000094static PyObject *DefaultHandler;
95static PyObject *IgnoreHandler;
96static PyObject *IntHandler;
Guido van Rossum398d9fe1994-05-11 08:59:13 +000097
Martin v. Löwisf58de1b2001-03-06 12:13:56 +000098/* On Solaris 8, gcc will produce a warning that the function
99 declaration is not a prototype. This is caused by the definition of
100 SIG_DFL as (void (*)())0; the correct declaration would have been
101 (void (*)(int))0. */
102
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000103static PyOS_sighandler_t old_siginthandler = SIG_DFL;
Guido van Rossum08c16611997-08-02 03:01:42 +0000104
Martin v. Löwis823725e2008-03-24 13:39:54 +0000105#ifdef HAVE_GETITIMER
106static PyObject *ItimerError;
107
108/* auxiliary functions for setitimer/getitimer */
109static void
110timeval_from_double(double d, struct timeval *tv)
111{
112 tv->tv_sec = floor(d);
113 tv->tv_usec = fmod(d, 1.0) * 1000000.0;
114}
115
Christian Heimes1a8501c2008-10-02 19:56:01 +0000116Py_LOCAL_INLINE(double)
Martin v. Löwis823725e2008-03-24 13:39:54 +0000117double_from_timeval(struct timeval *tv)
118{
119 return tv->tv_sec + (double)(tv->tv_usec / 1000000.0);
120}
121
122static PyObject *
123itimer_retval(struct itimerval *iv)
124{
125 PyObject *r, *v;
126
127 r = PyTuple_New(2);
128 if (r == NULL)
129 return NULL;
130
131 if(!(v = PyFloat_FromDouble(double_from_timeval(&iv->it_value)))) {
132 Py_DECREF(r);
133 return NULL;
134 }
135
136 PyTuple_SET_ITEM(r, 0, v);
137
138 if(!(v = PyFloat_FromDouble(double_from_timeval(&iv->it_interval)))) {
139 Py_DECREF(r);
140 return NULL;
141 }
142
143 PyTuple_SET_ITEM(r, 1, v);
144
145 return r;
146}
147#endif
Barry Warsaw92971171997-01-03 00:14:25 +0000148
Guido van Rossume4485b01994-09-07 14:32:49 +0000149static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000150signal_default_int_handler(PyObject *self, PyObject *args)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000151{
Guido van Rossume4485b01994-09-07 14:32:49 +0000152 PyErr_SetNone(PyExc_KeyboardInterrupt);
Barry Warsaw92971171997-01-03 00:14:25 +0000153 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000154}
155
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000156PyDoc_STRVAR(default_int_handler_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000157"default_int_handler(...)\n\
158\n\
Michael W. Hudson24ec2112004-06-17 15:55:53 +0000159The default handler for SIGINT installed by Python.\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000160It raises KeyboardInterrupt.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000161
Thomas Wouters0796b002000-07-22 23:49:30 +0000162
163static int
164checksignals_witharg(void * unused)
165{
166 return PyErr_CheckSignals();
167}
168
Tim Peters4f1b2082000-07-23 21:18:09 +0000169static void
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000170signal_handler(int sig_num)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000171{
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000172#ifdef WITH_THREAD
Guido van Rossum9e8181b2000-09-19 00:46:46 +0000173#ifdef WITH_PTH
174 if (PyThread_get_thread_ident() != main_thread) {
175 pth_raise(*(pth_t *) main_thread, sig_num);
176 return;
177 }
178#endif
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000179 /* See NOTES section above */
180 if (getpid() == main_pid) {
181#endif
Barry Warsaw92971171997-01-03 00:14:25 +0000182 Handlers[sig_num].tripped = 1;
Christian Heimesb76922a2007-12-11 01:06:40 +0000183 /* Set is_tripped after setting .tripped, as it gets
184 cleared in PyErr_CheckSignals() before .tripped. */
185 is_tripped = 1;
Thomas Wouters0796b002000-07-22 23:49:30 +0000186 Py_AddPendingCall(checksignals_witharg, NULL);
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000187 if (wakeup_fd != -1)
188 write(wakeup_fd, "\0", 1);
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000189#ifdef WITH_THREAD
190 }
191#endif
Guido van Rossum602099a1994-09-14 13:32:22 +0000192#ifdef SIGCHLD
193 if (sig_num == SIGCHLD) {
194 /* To avoid infinite recursion, this signal remains
195 reset until explicit re-instated.
196 Don't clear the 'func' field as it is our pointer
197 to the Python handler... */
Tim Peters4f1b2082000-07-23 21:18:09 +0000198 return;
Guido van Rossum602099a1994-09-14 13:32:22 +0000199 }
200#endif
Jean-Paul Calderone6f137ca2010-05-09 03:18:57 +0000201#ifndef HAVE_SIGACTION
202 /* If the handler was not set up with sigaction, reinstall it. See
203 * Python/pythonrun.c for the implementation of PyOS_setsig which
204 * makes this true. See also issue8354. */
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000205 PyOS_setsig(sig_num, signal_handler);
Jean-Paul Calderone6f137ca2010-05-09 03:18:57 +0000206#endif
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000207}
Guido van Rossume4485b01994-09-07 14:32:49 +0000208
Guido van Rossum06d511d1995-03-10 15:13:48 +0000209
Guido van Rossum1171ee61997-08-22 20:42:00 +0000210#ifdef HAVE_ALARM
Guido van Rossume4485b01994-09-07 14:32:49 +0000211static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000212signal_alarm(PyObject *self, PyObject *args)
Guido van Rossumb6775db1994-08-01 11:34:53 +0000213{
214 int t;
Neal Norwitzba3a16c2002-03-31 15:27:00 +0000215 if (!PyArg_ParseTuple(args, "i:alarm", &t))
Barry Warsaw92971171997-01-03 00:14:25 +0000216 return NULL;
Guido van Rossume4485b01994-09-07 14:32:49 +0000217 /* alarm() returns the number of seconds remaining */
Christian Heimes217cfd12007-12-02 14:31:20 +0000218 return PyLong_FromLong((long)alarm(t));
Guido van Rossumaa0f4c71994-08-23 13:49:37 +0000219}
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000220
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000221PyDoc_STRVAR(alarm_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000222"alarm(seconds)\n\
223\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000224Arrange for SIGALRM to arrive after the given number of seconds.");
Guido van Rossum06d511d1995-03-10 15:13:48 +0000225#endif
Guido van Rossumb6775db1994-08-01 11:34:53 +0000226
Guido van Rossum1171ee61997-08-22 20:42:00 +0000227#ifdef HAVE_PAUSE
Guido van Rossuma597dde1995-01-10 20:56:29 +0000228static PyObject *
Neal Norwitz3a6f9782002-03-25 20:46:46 +0000229signal_pause(PyObject *self)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000230{
Guido van Rossuma597dde1995-01-10 20:56:29 +0000231 Py_BEGIN_ALLOW_THREADS
Barry Warsaw92971171997-01-03 00:14:25 +0000232 (void)pause();
Guido van Rossuma597dde1995-01-10 20:56:29 +0000233 Py_END_ALLOW_THREADS
Barry Warsaw92971171997-01-03 00:14:25 +0000234 /* make sure that any exceptions that got raised are propagated
235 * back into Python
236 */
237 if (PyErr_CheckSignals())
238 return NULL;
239
Guido van Rossume4485b01994-09-07 14:32:49 +0000240 Py_INCREF(Py_None);
241 return Py_None;
242}
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000243PyDoc_STRVAR(pause_doc,
Barry Warsaw1ee36ff1998-07-21 22:41:18 +0000244"pause()\n\
245\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000246Wait until a signal arrives.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000247
Guido van Rossum06d511d1995-03-10 15:13:48 +0000248#endif
Guido van Rossume4485b01994-09-07 14:32:49 +0000249
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000250
Guido van Rossume4485b01994-09-07 14:32:49 +0000251static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000252signal_signal(PyObject *self, PyObject *args)
Guido van Rossume4485b01994-09-07 14:32:49 +0000253{
254 PyObject *obj;
255 int sig_num;
256 PyObject *old_handler;
Tim Peters4f1b2082000-07-23 21:18:09 +0000257 void (*func)(int);
Neal Norwitzba3a16c2002-03-31 15:27:00 +0000258 if (!PyArg_ParseTuple(args, "iO:signal", &sig_num, &obj))
Barry Warsaw92971171997-01-03 00:14:25 +0000259 return NULL;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000260#ifdef WITH_THREAD
Guido van Rossum65d5b571998-12-21 19:32:43 +0000261 if (PyThread_get_thread_ident() != main_thread) {
Guido van Rossumf4b012a1995-03-16 15:43:29 +0000262 PyErr_SetString(PyExc_ValueError,
263 "signal only works in main thread");
Barry Warsaw92971171997-01-03 00:14:25 +0000264 return NULL;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000265 }
266#endif
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000267 if (sig_num < 1 || sig_num >= NSIG) {
Guido van Rossumf4b012a1995-03-16 15:43:29 +0000268 PyErr_SetString(PyExc_ValueError,
269 "signal number out of range");
Barry Warsaw92971171997-01-03 00:14:25 +0000270 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000271 }
Barry Warsaw92971171997-01-03 00:14:25 +0000272 if (obj == IgnoreHandler)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000273 func = SIG_IGN;
Barry Warsaw92971171997-01-03 00:14:25 +0000274 else if (obj == DefaultHandler)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000275 func = SIG_DFL;
Guido van Rossumf4b012a1995-03-16 15:43:29 +0000276 else if (!PyCallable_Check(obj)) {
Guido van Rossume4485b01994-09-07 14:32:49 +0000277 PyErr_SetString(PyExc_TypeError,
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000278"signal handler must be signal.SIG_IGN, signal.SIG_DFL, or a callable object");
Barry Warsaw92971171997-01-03 00:14:25 +0000279 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000280 }
281 else
Barry Warsaw92971171997-01-03 00:14:25 +0000282 func = signal_handler;
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000283 if (PyOS_setsig(sig_num, func) == SIG_ERR) {
Guido van Rossume4485b01994-09-07 14:32:49 +0000284 PyErr_SetFromErrno(PyExc_RuntimeError);
Barry Warsaw92971171997-01-03 00:14:25 +0000285 return NULL;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000286 }
Barry Warsaw92971171997-01-03 00:14:25 +0000287 old_handler = Handlers[sig_num].func;
288 Handlers[sig_num].tripped = 0;
Guido van Rossume4485b01994-09-07 14:32:49 +0000289 Py_INCREF(obj);
Barry Warsaw92971171997-01-03 00:14:25 +0000290 Handlers[sig_num].func = obj;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000291 return old_handler;
292}
293
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000294PyDoc_STRVAR(signal_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000295"signal(sig, action) -> action\n\
296\n\
297Set the action for the given signal. The action can be SIG_DFL,\n\
298SIG_IGN, or a callable Python object. The previous action is\n\
299returned. See getsignal() for possible return values.\n\
300\n\
301*** IMPORTANT NOTICE ***\n\
302A signal handler function is called with two arguments:\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000303the first is the signal number, the second is the interrupted stack frame.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000304
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000305
Guido van Rossume4485b01994-09-07 14:32:49 +0000306static PyObject *
Peter Schneider-Kampe89b1562000-07-10 12:04:18 +0000307signal_getsignal(PyObject *self, PyObject *args)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000308{
309 int sig_num;
Guido van Rossume4485b01994-09-07 14:32:49 +0000310 PyObject *old_handler;
Neal Norwitzba3a16c2002-03-31 15:27:00 +0000311 if (!PyArg_ParseTuple(args, "i:getsignal", &sig_num))
Barry Warsaw92971171997-01-03 00:14:25 +0000312 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000313 if (sig_num < 1 || sig_num >= NSIG) {
Guido van Rossumf4b012a1995-03-16 15:43:29 +0000314 PyErr_SetString(PyExc_ValueError,
315 "signal number out of range");
Barry Warsaw92971171997-01-03 00:14:25 +0000316 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000317 }
Barry Warsaw92971171997-01-03 00:14:25 +0000318 old_handler = Handlers[sig_num].func;
Guido van Rossume4485b01994-09-07 14:32:49 +0000319 Py_INCREF(old_handler);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000320 return old_handler;
321}
322
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000323PyDoc_STRVAR(getsignal_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000324"getsignal(sig) -> action\n\
325\n\
326Return the current action for the given signal. The return value can be:\n\
327SIG_IGN -- if the signal is being ignored\n\
328SIG_DFL -- if the default action for the signal is in effect\n\
329None -- if an unknown handler is in effect\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000330anything else -- the callable Python object used as a handler");
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000331
Christian Heimes8640e742008-02-23 16:23:06 +0000332#ifdef HAVE_SIGINTERRUPT
333PyDoc_STRVAR(siginterrupt_doc,
334"siginterrupt(sig, flag) -> None\n\
335change system call restart behaviour: if flag is False, system calls\n\
336will be restarted when interrupted by signal sig, else system calls\n\
337will be interrupted.");
338
339static PyObject *
340signal_siginterrupt(PyObject *self, PyObject *args)
341{
342 int sig_num;
343 int flag;
344
345 if (!PyArg_ParseTuple(args, "ii:siginterrupt", &sig_num, &flag))
346 return NULL;
347 if (sig_num < 1 || sig_num >= NSIG) {
348 PyErr_SetString(PyExc_ValueError,
349 "signal number out of range");
350 return NULL;
351 }
352 if (siginterrupt(sig_num, flag)<0) {
353 PyErr_SetFromErrno(PyExc_RuntimeError);
354 return NULL;
355 }
356
357 Py_INCREF(Py_None);
358 return Py_None;
359}
360
361#endif
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000362
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000363static PyObject *
364signal_set_wakeup_fd(PyObject *self, PyObject *args)
365{
366 struct stat buf;
367 int fd, old_fd;
368 if (!PyArg_ParseTuple(args, "i:set_wakeup_fd", &fd))
369 return NULL;
370#ifdef WITH_THREAD
371 if (PyThread_get_thread_ident() != main_thread) {
372 PyErr_SetString(PyExc_ValueError,
373 "set_wakeup_fd only works in main thread");
374 return NULL;
375 }
376#endif
377 if (fd != -1 && fstat(fd, &buf) != 0) {
378 PyErr_SetString(PyExc_ValueError, "invalid fd");
379 return NULL;
380 }
381 old_fd = wakeup_fd;
382 wakeup_fd = fd;
383 return PyLong_FromLong(old_fd);
384}
385
386PyDoc_STRVAR(set_wakeup_fd_doc,
387"set_wakeup_fd(fd) -> fd\n\
388\n\
389Sets the fd to be written to (with '\\0') when a signal\n\
390comes in. A library can use this to wakeup select or poll.\n\
391The previous fd is returned.\n\
392\n\
393The fd must be non-blocking.");
394
395/* C API for the same, without all the error checking */
396int
397PySignal_SetWakeupFd(int fd)
398{
399 int old_fd = wakeup_fd;
400 if (fd < 0)
401 fd = -1;
402 wakeup_fd = fd;
403 return old_fd;
404}
405
406
Martin v. Löwis823725e2008-03-24 13:39:54 +0000407#ifdef HAVE_SETITIMER
408static PyObject *
409signal_setitimer(PyObject *self, PyObject *args)
410{
411 double first;
412 double interval = 0;
413 int which;
414 struct itimerval new, old;
415
416 if(!PyArg_ParseTuple(args, "id|d:setitimer", &which, &first, &interval))
417 return NULL;
418
419 timeval_from_double(first, &new.it_value);
420 timeval_from_double(interval, &new.it_interval);
421 /* Let OS check "which" value */
422 if (setitimer(which, &new, &old) != 0) {
423 PyErr_SetFromErrno(ItimerError);
424 return NULL;
425 }
426
427 return itimer_retval(&old);
428}
429
430PyDoc_STRVAR(setitimer_doc,
431"setitimer(which, seconds[, interval])\n\
432\n\
433Sets given itimer (one of ITIMER_REAL, ITIMER_VIRTUAL\n\
434or ITIMER_PROF) to fire after value seconds and after\n\
435that every interval seconds.\n\
436The itimer can be cleared by setting seconds to zero.\n\
437\n\
438Returns old values as a tuple: (delay, interval).");
439#endif
440
441
442#ifdef HAVE_GETITIMER
443static PyObject *
444signal_getitimer(PyObject *self, PyObject *args)
445{
446 int which;
447 struct itimerval old;
448
449 if (!PyArg_ParseTuple(args, "i:getitimer", &which))
450 return NULL;
451
452 if (getitimer(which, &old) != 0) {
453 PyErr_SetFromErrno(ItimerError);
454 return NULL;
455 }
456
457 return itimer_retval(&old);
458}
459
460PyDoc_STRVAR(getitimer_doc,
461"getitimer(which)\n\
462\n\
463Returns current value of given itimer.");
464#endif
465
466
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000467/* List of functions defined in the module */
Barry Warsaw92971171997-01-03 00:14:25 +0000468static PyMethodDef signal_methods[] = {
Guido van Rossum1171ee61997-08-22 20:42:00 +0000469#ifdef HAVE_ALARM
Neal Norwitzba3a16c2002-03-31 15:27:00 +0000470 {"alarm", signal_alarm, METH_VARARGS, alarm_doc},
Guido van Rossum06d511d1995-03-10 15:13:48 +0000471#endif
Martin v. Löwis823725e2008-03-24 13:39:54 +0000472#ifdef HAVE_SETITIMER
473 {"setitimer", signal_setitimer, METH_VARARGS, setitimer_doc},
474#endif
475#ifdef HAVE_GETITIMER
476 {"getitimer", signal_getitimer, METH_VARARGS, getitimer_doc},
477#endif
Neal Norwitzba3a16c2002-03-31 15:27:00 +0000478 {"signal", signal_signal, METH_VARARGS, signal_doc},
479 {"getsignal", signal_getsignal, METH_VARARGS, getsignal_doc},
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000480 {"set_wakeup_fd", signal_set_wakeup_fd, METH_VARARGS, set_wakeup_fd_doc},
Christian Heimes8640e742008-02-23 16:23:06 +0000481#ifdef HAVE_SIGINTERRUPT
482 {"siginterrupt", signal_siginterrupt, METH_VARARGS, siginterrupt_doc},
483#endif
Guido van Rossum1171ee61997-08-22 20:42:00 +0000484#ifdef HAVE_PAUSE
Neil Schemenauer78662cf2002-03-28 21:04:14 +0000485 {"pause", (PyCFunction)signal_pause,
486 METH_NOARGS,pause_doc},
Guido van Rossum06d511d1995-03-10 15:13:48 +0000487#endif
Christian Heimes5fb7c2a2007-12-24 08:52:31 +0000488 {"default_int_handler", signal_default_int_handler,
Neal Norwitzba3a16c2002-03-31 15:27:00 +0000489 METH_VARARGS, default_int_handler_doc},
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000490 {NULL, NULL} /* sentinel */
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000491};
492
Barry Warsaw92971171997-01-03 00:14:25 +0000493
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000494PyDoc_STRVAR(module_doc,
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000495"This module provides mechanisms to use signal handlers in Python.\n\
496\n\
497Functions:\n\
498\n\
499alarm() -- cause SIGALRM after a specified time [Unix only]\n\
Martin v. Löwis823725e2008-03-24 13:39:54 +0000500setitimer() -- cause a signal (described below) after a specified\n\
501 float time and the timer may restart then [Unix only]\n\
502getitimer() -- get current value of timer [Unix only]\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000503signal() -- set the action for a given signal\n\
504getsignal() -- get the signal action for a given signal\n\
505pause() -- wait until a signal arrives [Unix only]\n\
506default_int_handler() -- default SIGINT handler\n\
507\n\
Martin v. Löwis823725e2008-03-24 13:39:54 +0000508signal constants:\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000509SIG_DFL -- used to refer to the system default handler\n\
510SIG_IGN -- used to ignore the signal\n\
511NSIG -- number of defined signals\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000512SIGINT, SIGTERM, etc. -- signal numbers\n\
513\n\
Martin v. Löwis823725e2008-03-24 13:39:54 +0000514itimer constants:\n\
515ITIMER_REAL -- decrements in real time, and delivers SIGALRM upon\n\
516 expiration\n\
517ITIMER_VIRTUAL -- decrements only when the process is executing,\n\
518 and delivers SIGVTALRM upon expiration\n\
519ITIMER_PROF -- decrements both when the process is executing and\n\
520 when the system is executing on behalf of the process.\n\
521 Coupled with ITIMER_VIRTUAL, this timer is usually\n\
522 used to profile the time spent by the application\n\
523 in user and kernel space. SIGPROF is delivered upon\n\
524 expiration.\n\
525\n\n\
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000526*** IMPORTANT NOTICE ***\n\
527A signal handler function is called with two arguments:\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +0000528the first is the signal number, the second is the interrupted stack frame.");
Guido van Rossum1d8fb2d1998-06-28 16:54:49 +0000529
Martin v. Löwis1a214512008-06-11 05:26:20 +0000530static struct PyModuleDef signalmodule = {
531 PyModuleDef_HEAD_INIT,
532 "signal",
533 module_doc,
534 -1,
535 signal_methods,
536 NULL,
537 NULL,
538 NULL,
539 NULL
540};
541
Mark Hammondfe51c6d2002-08-02 02:27:13 +0000542PyMODINIT_FUNC
Martin v. Löwis1a214512008-06-11 05:26:20 +0000543PyInit_signal(void)
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000544{
Guido van Rossume4485b01994-09-07 14:32:49 +0000545 PyObject *m, *d, *x;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000546 int i;
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000547
548#ifdef WITH_THREAD
Guido van Rossum65d5b571998-12-21 19:32:43 +0000549 main_thread = PyThread_get_thread_ident();
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000550 main_pid = getpid();
551#endif
552
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000553 /* Create the module and add the functions */
Martin v. Löwis1a214512008-06-11 05:26:20 +0000554 m = PyModule_Create(&signalmodule);
Neal Norwitz1ac754f2006-01-19 06:09:39 +0000555 if (m == NULL)
Martin v. Löwis1a214512008-06-11 05:26:20 +0000556 return NULL;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000557
558 /* Add some symbolic constants to the module */
Guido van Rossume4485b01994-09-07 14:32:49 +0000559 d = PyModule_GetDict(m);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000560
Guido van Rossum276fa432000-06-30 23:04:18 +0000561 x = DefaultHandler = PyLong_FromVoidPtr((void *)SIG_DFL);
Barry Warsaw92971171997-01-03 00:14:25 +0000562 if (!x || PyDict_SetItemString(d, "SIG_DFL", x) < 0)
563 goto finally;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000564
Guido van Rossum276fa432000-06-30 23:04:18 +0000565 x = IgnoreHandler = PyLong_FromVoidPtr((void *)SIG_IGN);
Barry Warsaw92971171997-01-03 00:14:25 +0000566 if (!x || PyDict_SetItemString(d, "SIG_IGN", x) < 0)
567 goto finally;
568
Christian Heimes217cfd12007-12-02 14:31:20 +0000569 x = PyLong_FromLong((long)NSIG);
Barry Warsaw92971171997-01-03 00:14:25 +0000570 if (!x || PyDict_SetItemString(d, "NSIG", x) < 0)
571 goto finally;
Guido van Rossum08c16611997-08-02 03:01:42 +0000572 Py_DECREF(x);
Barry Warsaw92971171997-01-03 00:14:25 +0000573
574 x = IntHandler = PyDict_GetItemString(d, "default_int_handler");
575 if (!x)
576 goto finally;
Guido van Rossum08c16611997-08-02 03:01:42 +0000577 Py_INCREF(IntHandler);
Barry Warsaw92971171997-01-03 00:14:25 +0000578
579 Handlers[0].tripped = 0;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000580 for (i = 1; i < NSIG; i++) {
Tim Peters4f1b2082000-07-23 21:18:09 +0000581 void (*t)(int);
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000582 t = PyOS_getsig(i);
Barry Warsaw92971171997-01-03 00:14:25 +0000583 Handlers[i].tripped = 0;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000584 if (t == SIG_DFL)
Barry Warsaw92971171997-01-03 00:14:25 +0000585 Handlers[i].func = DefaultHandler;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000586 else if (t == SIG_IGN)
Barry Warsaw92971171997-01-03 00:14:25 +0000587 Handlers[i].func = IgnoreHandler;
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000588 else
Barry Warsaw92971171997-01-03 00:14:25 +0000589 Handlers[i].func = Py_None; /* None of our business */
590 Py_INCREF(Handlers[i].func);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000591 }
Barry Warsaw92971171997-01-03 00:14:25 +0000592 if (Handlers[SIGINT].func == DefaultHandler) {
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000593 /* Install default int handler */
Guido van Rossum08c16611997-08-02 03:01:42 +0000594 Py_INCREF(IntHandler);
Barry Warsaw92971171997-01-03 00:14:25 +0000595 Py_DECREF(Handlers[SIGINT].func);
596 Handlers[SIGINT].func = IntHandler;
Neal Norwitz41785152002-06-13 21:42:51 +0000597 old_siginthandler = PyOS_setsig(SIGINT, signal_handler);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000598 }
599
600#ifdef SIGHUP
Christian Heimes217cfd12007-12-02 14:31:20 +0000601 x = PyLong_FromLong(SIGHUP);
Guido van Rossume4485b01994-09-07 14:32:49 +0000602 PyDict_SetItemString(d, "SIGHUP", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000603 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000604#endif
605#ifdef SIGINT
Christian Heimes217cfd12007-12-02 14:31:20 +0000606 x = PyLong_FromLong(SIGINT);
Guido van Rossume4485b01994-09-07 14:32:49 +0000607 PyDict_SetItemString(d, "SIGINT", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000608 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000609#endif
Tim Peters1ce3cf72001-10-01 17:58:40 +0000610#ifdef SIGBREAK
Christian Heimes217cfd12007-12-02 14:31:20 +0000611 x = PyLong_FromLong(SIGBREAK);
Tim Peters1ce3cf72001-10-01 17:58:40 +0000612 PyDict_SetItemString(d, "SIGBREAK", x);
613 Py_XDECREF(x);
614#endif
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000615#ifdef SIGQUIT
Christian Heimes217cfd12007-12-02 14:31:20 +0000616 x = PyLong_FromLong(SIGQUIT);
Guido van Rossume4485b01994-09-07 14:32:49 +0000617 PyDict_SetItemString(d, "SIGQUIT", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000618 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000619#endif
620#ifdef SIGILL
Christian Heimes217cfd12007-12-02 14:31:20 +0000621 x = PyLong_FromLong(SIGILL);
Guido van Rossume4485b01994-09-07 14:32:49 +0000622 PyDict_SetItemString(d, "SIGILL", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000623 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000624#endif
625#ifdef SIGTRAP
Christian Heimes217cfd12007-12-02 14:31:20 +0000626 x = PyLong_FromLong(SIGTRAP);
Guido van Rossume4485b01994-09-07 14:32:49 +0000627 PyDict_SetItemString(d, "SIGTRAP", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000628 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000629#endif
630#ifdef SIGIOT
Christian Heimes217cfd12007-12-02 14:31:20 +0000631 x = PyLong_FromLong(SIGIOT);
Guido van Rossume4485b01994-09-07 14:32:49 +0000632 PyDict_SetItemString(d, "SIGIOT", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000633 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000634#endif
635#ifdef SIGABRT
Christian Heimes217cfd12007-12-02 14:31:20 +0000636 x = PyLong_FromLong(SIGABRT);
Guido van Rossume4485b01994-09-07 14:32:49 +0000637 PyDict_SetItemString(d, "SIGABRT", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000638 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000639#endif
640#ifdef SIGEMT
Christian Heimes217cfd12007-12-02 14:31:20 +0000641 x = PyLong_FromLong(SIGEMT);
Guido van Rossume4485b01994-09-07 14:32:49 +0000642 PyDict_SetItemString(d, "SIGEMT", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000643 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000644#endif
645#ifdef SIGFPE
Christian Heimes217cfd12007-12-02 14:31:20 +0000646 x = PyLong_FromLong(SIGFPE);
Guido van Rossume4485b01994-09-07 14:32:49 +0000647 PyDict_SetItemString(d, "SIGFPE", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000648 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000649#endif
650#ifdef SIGKILL
Christian Heimes217cfd12007-12-02 14:31:20 +0000651 x = PyLong_FromLong(SIGKILL);
Guido van Rossume4485b01994-09-07 14:32:49 +0000652 PyDict_SetItemString(d, "SIGKILL", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000653 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000654#endif
655#ifdef SIGBUS
Christian Heimes217cfd12007-12-02 14:31:20 +0000656 x = PyLong_FromLong(SIGBUS);
Guido van Rossume4485b01994-09-07 14:32:49 +0000657 PyDict_SetItemString(d, "SIGBUS", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000658 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000659#endif
660#ifdef SIGSEGV
Christian Heimes217cfd12007-12-02 14:31:20 +0000661 x = PyLong_FromLong(SIGSEGV);
Guido van Rossume4485b01994-09-07 14:32:49 +0000662 PyDict_SetItemString(d, "SIGSEGV", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000663 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000664#endif
665#ifdef SIGSYS
Christian Heimes217cfd12007-12-02 14:31:20 +0000666 x = PyLong_FromLong(SIGSYS);
Guido van Rossume4485b01994-09-07 14:32:49 +0000667 PyDict_SetItemString(d, "SIGSYS", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000668 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000669#endif
670#ifdef SIGPIPE
Christian Heimes217cfd12007-12-02 14:31:20 +0000671 x = PyLong_FromLong(SIGPIPE);
Guido van Rossume4485b01994-09-07 14:32:49 +0000672 PyDict_SetItemString(d, "SIGPIPE", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000673 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000674#endif
675#ifdef SIGALRM
Christian Heimes217cfd12007-12-02 14:31:20 +0000676 x = PyLong_FromLong(SIGALRM);
Guido van Rossume4485b01994-09-07 14:32:49 +0000677 PyDict_SetItemString(d, "SIGALRM", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000678 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000679#endif
680#ifdef SIGTERM
Christian Heimes217cfd12007-12-02 14:31:20 +0000681 x = PyLong_FromLong(SIGTERM);
Guido van Rossume4485b01994-09-07 14:32:49 +0000682 PyDict_SetItemString(d, "SIGTERM", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000683 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000684#endif
685#ifdef SIGUSR1
Christian Heimes217cfd12007-12-02 14:31:20 +0000686 x = PyLong_FromLong(SIGUSR1);
Guido van Rossume4485b01994-09-07 14:32:49 +0000687 PyDict_SetItemString(d, "SIGUSR1", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000688 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000689#endif
690#ifdef SIGUSR2
Christian Heimes217cfd12007-12-02 14:31:20 +0000691 x = PyLong_FromLong(SIGUSR2);
Guido van Rossume4485b01994-09-07 14:32:49 +0000692 PyDict_SetItemString(d, "SIGUSR2", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000693 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000694#endif
695#ifdef SIGCLD
Christian Heimes217cfd12007-12-02 14:31:20 +0000696 x = PyLong_FromLong(SIGCLD);
Guido van Rossume4485b01994-09-07 14:32:49 +0000697 PyDict_SetItemString(d, "SIGCLD", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000698 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000699#endif
700#ifdef SIGCHLD
Christian Heimes217cfd12007-12-02 14:31:20 +0000701 x = PyLong_FromLong(SIGCHLD);
Guido van Rossume4485b01994-09-07 14:32:49 +0000702 PyDict_SetItemString(d, "SIGCHLD", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000703 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000704#endif
705#ifdef SIGPWR
Christian Heimes217cfd12007-12-02 14:31:20 +0000706 x = PyLong_FromLong(SIGPWR);
Guido van Rossume4485b01994-09-07 14:32:49 +0000707 PyDict_SetItemString(d, "SIGPWR", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000708 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000709#endif
710#ifdef SIGIO
Christian Heimes217cfd12007-12-02 14:31:20 +0000711 x = PyLong_FromLong(SIGIO);
Guido van Rossume4485b01994-09-07 14:32:49 +0000712 PyDict_SetItemString(d, "SIGIO", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000713 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000714#endif
715#ifdef SIGURG
Christian Heimes217cfd12007-12-02 14:31:20 +0000716 x = PyLong_FromLong(SIGURG);
Guido van Rossume4485b01994-09-07 14:32:49 +0000717 PyDict_SetItemString(d, "SIGURG", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000718 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000719#endif
720#ifdef SIGWINCH
Christian Heimes217cfd12007-12-02 14:31:20 +0000721 x = PyLong_FromLong(SIGWINCH);
Guido van Rossume4485b01994-09-07 14:32:49 +0000722 PyDict_SetItemString(d, "SIGWINCH", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000723 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000724#endif
725#ifdef SIGPOLL
Christian Heimes217cfd12007-12-02 14:31:20 +0000726 x = PyLong_FromLong(SIGPOLL);
Guido van Rossume4485b01994-09-07 14:32:49 +0000727 PyDict_SetItemString(d, "SIGPOLL", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000728 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000729#endif
730#ifdef SIGSTOP
Christian Heimes217cfd12007-12-02 14:31:20 +0000731 x = PyLong_FromLong(SIGSTOP);
Guido van Rossume4485b01994-09-07 14:32:49 +0000732 PyDict_SetItemString(d, "SIGSTOP", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000733 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000734#endif
735#ifdef SIGTSTP
Christian Heimes217cfd12007-12-02 14:31:20 +0000736 x = PyLong_FromLong(SIGTSTP);
Guido van Rossume4485b01994-09-07 14:32:49 +0000737 PyDict_SetItemString(d, "SIGTSTP", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000738 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000739#endif
740#ifdef SIGCONT
Christian Heimes217cfd12007-12-02 14:31:20 +0000741 x = PyLong_FromLong(SIGCONT);
Guido van Rossume4485b01994-09-07 14:32:49 +0000742 PyDict_SetItemString(d, "SIGCONT", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000743 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000744#endif
745#ifdef SIGTTIN
Christian Heimes217cfd12007-12-02 14:31:20 +0000746 x = PyLong_FromLong(SIGTTIN);
Guido van Rossume4485b01994-09-07 14:32:49 +0000747 PyDict_SetItemString(d, "SIGTTIN", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000748 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000749#endif
750#ifdef SIGTTOU
Christian Heimes217cfd12007-12-02 14:31:20 +0000751 x = PyLong_FromLong(SIGTTOU);
Guido van Rossume4485b01994-09-07 14:32:49 +0000752 PyDict_SetItemString(d, "SIGTTOU", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000753 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000754#endif
755#ifdef SIGVTALRM
Christian Heimes217cfd12007-12-02 14:31:20 +0000756 x = PyLong_FromLong(SIGVTALRM);
Guido van Rossume4485b01994-09-07 14:32:49 +0000757 PyDict_SetItemString(d, "SIGVTALRM", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000758 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000759#endif
760#ifdef SIGPROF
Christian Heimes217cfd12007-12-02 14:31:20 +0000761 x = PyLong_FromLong(SIGPROF);
Guido van Rossume4485b01994-09-07 14:32:49 +0000762 PyDict_SetItemString(d, "SIGPROF", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000763 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000764#endif
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000765#ifdef SIGXCPU
Christian Heimes217cfd12007-12-02 14:31:20 +0000766 x = PyLong_FromLong(SIGXCPU);
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000767 PyDict_SetItemString(d, "SIGXCPU", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000768 Py_XDECREF(x);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000769#endif
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000770#ifdef SIGXFSZ
Christian Heimes217cfd12007-12-02 14:31:20 +0000771 x = PyLong_FromLong(SIGXFSZ);
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000772 PyDict_SetItemString(d, "SIGXFSZ", x);
Barry Warsaw73a75eb1997-01-09 23:50:28 +0000773 Py_XDECREF(x);
Barry Warsaw14ed5fb1996-12-16 20:24:22 +0000774#endif
Anthony Baxterf37f37d2003-07-31 10:35:29 +0000775#ifdef SIGRTMIN
Christian Heimes217cfd12007-12-02 14:31:20 +0000776 x = PyLong_FromLong(SIGRTMIN);
Anthony Baxterf37f37d2003-07-31 10:35:29 +0000777 PyDict_SetItemString(d, "SIGRTMIN", x);
778 Py_XDECREF(x);
779#endif
780#ifdef SIGRTMAX
Christian Heimes217cfd12007-12-02 14:31:20 +0000781 x = PyLong_FromLong(SIGRTMAX);
Anthony Baxterf37f37d2003-07-31 10:35:29 +0000782 PyDict_SetItemString(d, "SIGRTMAX", x);
783 Py_XDECREF(x);
784#endif
Martin v. Löwis175af252002-01-12 11:43:25 +0000785#ifdef SIGINFO
Christian Heimes217cfd12007-12-02 14:31:20 +0000786 x = PyLong_FromLong(SIGINFO);
Martin v. Löwis175af252002-01-12 11:43:25 +0000787 PyDict_SetItemString(d, "SIGINFO", x);
788 Py_XDECREF(x);
789#endif
Martin v. Löwis823725e2008-03-24 13:39:54 +0000790
791#ifdef ITIMER_REAL
792 x = PyLong_FromLong(ITIMER_REAL);
793 PyDict_SetItemString(d, "ITIMER_REAL", x);
794 Py_DECREF(x);
795#endif
796#ifdef ITIMER_VIRTUAL
797 x = PyLong_FromLong(ITIMER_VIRTUAL);
798 PyDict_SetItemString(d, "ITIMER_VIRTUAL", x);
799 Py_DECREF(x);
800#endif
801#ifdef ITIMER_PROF
802 x = PyLong_FromLong(ITIMER_PROF);
803 PyDict_SetItemString(d, "ITIMER_PROF", x);
804 Py_DECREF(x);
805#endif
806
807#if defined (HAVE_SETITIMER) || defined (HAVE_GETITIMER)
808 ItimerError = PyErr_NewException("signal.ItimerError",
809 PyExc_IOError, NULL);
Neal Norwitz2f99b242008-08-24 05:48:10 +0000810 if (ItimerError != NULL)
811 PyDict_SetItemString(d, "ItimerError", ItimerError);
Martin v. Löwis823725e2008-03-24 13:39:54 +0000812#endif
813
Brian Curtineb24d742010-04-12 17:16:38 +0000814#ifdef CTRL_C_EVENT
815 x = PyLong_FromLong(CTRL_C_EVENT);
816 PyDict_SetItemString(d, "CTRL_C_EVENT", x);
817 Py_DECREF(x);
818#endif
819
820#ifdef CTRL_BREAK_EVENT
821 x = PyLong_FromLong(CTRL_BREAK_EVENT);
822 PyDict_SetItemString(d, "CTRL_BREAK_EVENT", x);
823 Py_DECREF(x);
824#endif
825
Martin v. Löwis1a214512008-06-11 05:26:20 +0000826 if (PyErr_Occurred()) {
827 Py_DECREF(m);
828 m = NULL;
829 }
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{
838 int i;
Guido van Rossum7ff20ac1997-11-03 21:53:55 +0000839 PyObject *func;
Guido van Rossum08c16611997-08-02 03:01:42 +0000840
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000841 PyOS_setsig(SIGINT, old_siginthandler);
Guido van Rossum7ff20ac1997-11-03 21:53:55 +0000842 old_siginthandler = SIG_DFL;
Guido van Rossum08c16611997-08-02 03:01:42 +0000843
844 for (i = 1; i < NSIG; i++) {
Guido van Rossum7ff20ac1997-11-03 21:53:55 +0000845 func = Handlers[i].func;
Guido van Rossum08c16611997-08-02 03:01:42 +0000846 Handlers[i].tripped = 0;
Guido van Rossum08c16611997-08-02 03:01:42 +0000847 Handlers[i].func = NULL;
Guido van Rossum7ff20ac1997-11-03 21:53:55 +0000848 if (i != SIGINT && func != NULL && func != Py_None &&
849 func != DefaultHandler && func != IgnoreHandler)
Guido van Rossumd2cd7ad2000-09-16 16:35:28 +0000850 PyOS_setsig(i, SIG_DFL);
Guido van Rossum7ff20ac1997-11-03 21:53:55 +0000851 Py_XDECREF(func);
Guido van Rossum08c16611997-08-02 03:01:42 +0000852 }
853
854 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{
867 int i;
Guido van Rossume4485b01994-09-07 14:32:49 +0000868 PyObject *f;
Barry Warsaw92971171997-01-03 00:14:25 +0000869
870 if (!is_tripped)
Guido van Rossum6299d1e1994-05-31 12:51:13 +0000871 return 0;
Christian Heimesb76922a2007-12-11 01:06:40 +0000872
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000873#ifdef WITH_THREAD
Guido van Rossum65d5b571998-12-21 19:32:43 +0000874 if (PyThread_get_thread_ident() != main_thread)
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000875 return 0;
876#endif
Christian Heimesb76922a2007-12-11 01:06:40 +0000877
878 /*
Benjamin Peterson8719ad52009-09-11 22:24:02 +0000879 * The is_tripped variable is meant to speed up the calls to
Christian Heimesb76922a2007-12-11 01:06:40 +0000880 * 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;
893
Guido van Rossum6297a7a2003-02-19 15:53:17 +0000894 if (!(f = (PyObject *)PyEval_GetFrame()))
Guido van Rossume4485b01994-09-07 14:32:49 +0000895 f = Py_None;
Christian Heimesb76922a2007-12-11 01:06:40 +0000896
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000897 for (i = 1; i < NSIG; i++) {
Barry Warsaw92971171997-01-03 00:14:25 +0000898 if (Handlers[i].tripped) {
899 PyObject *result = NULL;
900 PyObject *arglist = Py_BuildValue("(iO)", i, f);
901 Handlers[i].tripped = 0;
902
903 if (arglist) {
904 result = PyEval_CallObject(Handlers[i].func,
905 arglist);
Guido van Rossume4485b01994-09-07 14:32:49 +0000906 Py_DECREF(arglist);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000907 }
Barry Warsaw92971171997-01-03 00:14:25 +0000908 if (!result)
Guido van Rossumfcdd0e41997-01-21 06:13:09 +0000909 return -1;
Barry Warsaw92971171997-01-03 00:14:25 +0000910
911 Py_DECREF(result);
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000912 }
913 }
Christian Heimesb76922a2007-12-11 01:06:40 +0000914
Guido van Rossum398d9fe1994-05-11 08:59:13 +0000915 return 0;
916}
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{
Christian Heimesb76922a2007-12-11 01:06:40 +0000925 is_tripped = 1;
Barry Warsaw92971171997-01-03 00:14:25 +0000926 Handlers[SIGINT].tripped = 1;
Thomas Wouters334fb892000-07-25 12:56:38 +0000927 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{
Martin v. Löwis1a214512008-06-11 05:26:20 +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{
943 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{
Barry Warsaw92971171997-01-03 00:14:25 +0000949 if (Handlers[SIGINT].tripped) {
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000950#ifdef WITH_THREAD
Guido van Rossum65d5b571998-12-21 19:32:43 +0000951 if (PyThread_get_thread_ident() != main_thread)
Guido van Rossumbb4ba121994-06-23 11:25:45 +0000952 return 0;
953#endif
Barry Warsaw92971171997-01-03 00:14:25 +0000954 Handlers[SIGINT].tripped = 0;
Guido van Rossum6299d1e1994-05-31 12:51:13 +0000955 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
Guido van Rossumfee3a2d2000-08-27 17:34:07 +0000964 PyEval_ReInitThreads();
Guido van Rossum65d5b571998-12-21 19:32:43 +0000965 main_thread = PyThread_get_thread_ident();
Guido van Rossum359bcaa1997-11-14 22:24:28 +0000966 main_pid = getpid();
Guido van Rossum8ee3e5a2005-09-14 18:09:42 +0000967 _PyImport_ReInitLock();
Benjamin Petersone68df0f2008-06-13 00:26:50 +0000968 PyThread_ReInitTLS();
Guido van Rossum359bcaa1997-11-14 22:24:28 +0000969#endif
970}