Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 1 | /* select - Module containing unix select(2) call. |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 2 | Under Unix, the file descriptors are small integers. |
| 3 | Under Win32, select only exists for sockets, and sockets may |
| 4 | have any value except INVALID_SOCKET. |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 5 | */ |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 6 | |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 7 | #include "Python.h" |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 8 | #include <structmember.h> |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 9 | |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 10 | #ifdef __APPLE__ |
| 11 | /* Perform runtime testing for a broken poll on OSX to make it easier |
| 12 | * to use the same binary on multiple releases of the OS. |
| 13 | */ |
| 14 | #undef HAVE_BROKEN_POLL |
| 15 | #endif |
| 16 | |
Tim Peters | d92dfe0 | 2000-12-12 01:18:41 +0000 | [diff] [blame] | 17 | /* Windows #defines FD_SETSIZE to 64 if FD_SETSIZE isn't already defined. |
| 18 | 64 is too small (too many people have bumped into that limit). |
| 19 | Here we boost it. |
| 20 | Users who want even more than the boosted limit should #define |
| 21 | FD_SETSIZE higher before this; e.g., via compiler /D switch. |
| 22 | */ |
| 23 | #if defined(MS_WINDOWS) && !defined(FD_SETSIZE) |
| 24 | #define FD_SETSIZE 512 |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 25 | #endif |
Tim Peters | d92dfe0 | 2000-12-12 01:18:41 +0000 | [diff] [blame] | 26 | |
Andrew M. Kuchling | 737fbb3 | 2001-07-14 20:54:37 +0000 | [diff] [blame] | 27 | #if defined(HAVE_POLL_H) |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 28 | #include <poll.h> |
Andrew M. Kuchling | 737fbb3 | 2001-07-14 20:54:37 +0000 | [diff] [blame] | 29 | #elif defined(HAVE_SYS_POLL_H) |
| 30 | #include <sys/poll.h> |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 31 | #endif |
Guido van Rossum | a376cc5 | 1996-12-05 23:43:35 +0000 | [diff] [blame] | 32 | |
Guido van Rossum | 3727317 | 1996-12-09 18:47:43 +0000 | [diff] [blame] | 33 | #ifdef __sgi |
| 34 | /* This is missing from unistd.h */ |
Thomas Wouters | bd4bc4e | 2000-07-22 23:57:55 +0000 | [diff] [blame] | 35 | extern void bzero(void *, int); |
Guido van Rossum | 3727317 | 1996-12-09 18:47:43 +0000 | [diff] [blame] | 36 | #endif |
| 37 | |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 38 | #ifdef HAVE_SYS_TYPES_H |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 39 | #include <sys/types.h> |
Guido van Rossum | ff7e83d | 1999-08-27 20:39:37 +0000 | [diff] [blame] | 40 | #endif |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 41 | |
Andrew MacIntyre | 7bf6833 | 2002-03-03 02:59:16 +0000 | [diff] [blame] | 42 | #if defined(PYOS_OS2) && !defined(PYCC_GCC) |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 43 | #include <sys/time.h> |
| 44 | #include <utils.h> |
| 45 | #endif |
| 46 | |
Guido van Rossum | 6f489d9 | 1996-06-28 20:15:15 +0000 | [diff] [blame] | 47 | #ifdef MS_WINDOWS |
Christian Heimes | c36625b | 2008-01-04 13:33:00 +0000 | [diff] [blame] | 48 | # define WIN32_LEAN_AND_MEAN |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 49 | # include <winsock.h> |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 50 | #else |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 51 | # define SOCKET int |
Skip Montanaro | eb33e5a | 2007-08-17 12:57:41 +0000 | [diff] [blame] | 52 | # if defined(__VMS) |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 53 | # include <socket.h> |
| 54 | # endif |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 55 | #endif |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 56 | |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 57 | static PyObject *SelectError; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 58 | |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 59 | /* list of Python objects and their file descriptor */ |
| 60 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 61 | PyObject *obj; /* owned reference */ |
| 62 | SOCKET fd; |
| 63 | int sentinel; /* -1 == sentinel */ |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 64 | } pylist; |
| 65 | |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 66 | static void |
Tim Peters | 4b046c2 | 2001-08-16 21:59:46 +0000 | [diff] [blame] | 67 | reap_obj(pylist fd2obj[FD_SETSIZE + 1]) |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 68 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 69 | int i; |
| 70 | for (i = 0; i < FD_SETSIZE + 1 && fd2obj[i].sentinel >= 0; i++) { |
| 71 | Py_XDECREF(fd2obj[i].obj); |
| 72 | fd2obj[i].obj = NULL; |
| 73 | } |
| 74 | fd2obj[0].sentinel = -1; |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 75 | } |
| 76 | |
| 77 | |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 78 | /* returns -1 and sets the Python exception if an error occurred, otherwise |
| 79 | returns a number >= 0 |
| 80 | */ |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 81 | static int |
Brett Cannon | 62dba4c | 2003-09-10 19:37:42 +0000 | [diff] [blame] | 82 | seq2set(PyObject *seq, fd_set *set, pylist fd2obj[FD_SETSIZE + 1]) |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 83 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 84 | int i; |
| 85 | int max = -1; |
| 86 | int index = 0; |
| 87 | int len = -1; |
| 88 | PyObject* fast_seq = NULL; |
| 89 | PyObject* o = NULL; |
Guido van Rossum | 07432c0 | 1995-03-29 16:47:45 +0000 | [diff] [blame] | 90 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 91 | fd2obj[0].obj = (PyObject*)0; /* set list to zero size */ |
| 92 | FD_ZERO(set); |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 93 | |
Benjamin Peterson | e0edb8b | 2010-06-27 23:49:45 +0000 | [diff] [blame] | 94 | fast_seq = PySequence_Fast(seq, "arguments 1-3 must be sequences"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 95 | if (!fast_seq) |
| 96 | return -1; |
| 97 | |
| 98 | len = PySequence_Fast_GET_SIZE(fast_seq); |
| 99 | |
| 100 | for (i = 0; i < len; i++) { |
| 101 | SOCKET v; |
| 102 | |
| 103 | /* any intervening fileno() calls could decr this refcnt */ |
| 104 | if (!(o = PySequence_Fast_GET_ITEM(fast_seq, i))) |
Brett Cannon | 62dba4c | 2003-09-10 19:37:42 +0000 | [diff] [blame] | 105 | return -1; |
| 106 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 107 | Py_INCREF(o); |
| 108 | v = PyObject_AsFileDescriptor( o ); |
| 109 | if (v == -1) goto finally; |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 110 | |
Guido van Rossum | 947a0fa | 2000-01-14 16:33:09 +0000 | [diff] [blame] | 111 | #if defined(_MSC_VER) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 112 | max = 0; /* not used for Win32 */ |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 113 | #else /* !_MSC_VER */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 114 | if (v < 0 || v >= FD_SETSIZE) { |
| 115 | PyErr_SetString(PyExc_ValueError, |
| 116 | "filedescriptor out of range in select()"); |
| 117 | goto finally; |
| 118 | } |
| 119 | if (v > max) |
| 120 | max = v; |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 121 | #endif /* _MSC_VER */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 122 | FD_SET(v, set); |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 123 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 124 | /* add object and its file descriptor to the list */ |
| 125 | if (index >= FD_SETSIZE) { |
| 126 | PyErr_SetString(PyExc_ValueError, |
| 127 | "too many file descriptors in select()"); |
| 128 | goto finally; |
| 129 | } |
| 130 | fd2obj[index].obj = o; |
| 131 | fd2obj[index].fd = v; |
| 132 | fd2obj[index].sentinel = 0; |
| 133 | fd2obj[++index].sentinel = -1; |
| 134 | } |
| 135 | Py_DECREF(fast_seq); |
| 136 | return max+1; |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 137 | |
| 138 | finally: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 139 | Py_XDECREF(o); |
| 140 | Py_DECREF(fast_seq); |
| 141 | return -1; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 142 | } |
| 143 | |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 144 | /* returns NULL and sets the Python exception if an error occurred */ |
| 145 | static PyObject * |
Tim Peters | 4b046c2 | 2001-08-16 21:59:46 +0000 | [diff] [blame] | 146 | set2list(fd_set *set, pylist fd2obj[FD_SETSIZE + 1]) |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 147 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 148 | int i, j, count=0; |
| 149 | PyObject *list, *o; |
| 150 | SOCKET fd; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 151 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 152 | for (j = 0; fd2obj[j].sentinel >= 0; j++) { |
| 153 | if (FD_ISSET(fd2obj[j].fd, set)) |
| 154 | count++; |
| 155 | } |
| 156 | list = PyList_New(count); |
| 157 | if (!list) |
| 158 | return NULL; |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 159 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 160 | i = 0; |
| 161 | for (j = 0; fd2obj[j].sentinel >= 0; j++) { |
| 162 | fd = fd2obj[j].fd; |
| 163 | if (FD_ISSET(fd, set)) { |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 164 | #ifndef _MSC_VER |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 165 | if (fd > FD_SETSIZE) { |
| 166 | PyErr_SetString(PyExc_SystemError, |
| 167 | "filedescriptor out of range returned in select()"); |
| 168 | goto finally; |
| 169 | } |
Guido van Rossum | 4f0fbf8 | 1996-06-12 04:22:53 +0000 | [diff] [blame] | 170 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 171 | o = fd2obj[j].obj; |
| 172 | fd2obj[j].obj = NULL; |
| 173 | /* transfer ownership */ |
| 174 | if (PyList_SetItem(list, i, o) < 0) |
| 175 | goto finally; |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 176 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 177 | i++; |
| 178 | } |
| 179 | } |
| 180 | return list; |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 181 | finally: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 182 | Py_DECREF(list); |
| 183 | return NULL; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 184 | } |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 185 | |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 186 | #undef SELECT_USES_HEAP |
| 187 | #if FD_SETSIZE > 1024 |
| 188 | #define SELECT_USES_HEAP |
| 189 | #endif /* FD_SETSIZE > 1024 */ |
| 190 | |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 191 | static PyObject * |
Peter Schneider-Kamp | 41c36ff | 2000-07-10 12:29:26 +0000 | [diff] [blame] | 192 | select_select(PyObject *self, PyObject *args) |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 193 | { |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 194 | #ifdef SELECT_USES_HEAP |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 195 | pylist *rfd2obj, *wfd2obj, *efd2obj; |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 196 | #else /* !SELECT_USES_HEAP */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 197 | /* XXX: All this should probably be implemented as follows: |
| 198 | * - find the highest descriptor we're interested in |
| 199 | * - add one |
| 200 | * - that's the size |
| 201 | * See: Stevens, APitUE, $12.5.1 |
| 202 | */ |
| 203 | pylist rfd2obj[FD_SETSIZE + 1]; |
| 204 | pylist wfd2obj[FD_SETSIZE + 1]; |
| 205 | pylist efd2obj[FD_SETSIZE + 1]; |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 206 | #endif /* SELECT_USES_HEAP */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 207 | PyObject *ifdlist, *ofdlist, *efdlist; |
| 208 | PyObject *ret = NULL; |
| 209 | PyObject *tout = Py_None; |
| 210 | fd_set ifdset, ofdset, efdset; |
| 211 | double timeout; |
| 212 | struct timeval tv, *tvp; |
| 213 | long seconds; |
| 214 | int imax, omax, emax, max; |
| 215 | int n; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 216 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 217 | /* convert arguments */ |
| 218 | if (!PyArg_UnpackTuple(args, "select", 3, 4, |
| 219 | &ifdlist, &ofdlist, &efdlist, &tout)) |
| 220 | return NULL; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 221 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 222 | if (tout == Py_None) |
| 223 | tvp = (struct timeval *)0; |
| 224 | else if (!PyNumber_Check(tout)) { |
| 225 | PyErr_SetString(PyExc_TypeError, |
| 226 | "timeout must be a float or None"); |
| 227 | return NULL; |
| 228 | } |
| 229 | else { |
| 230 | timeout = PyFloat_AsDouble(tout); |
| 231 | if (timeout == -1 && PyErr_Occurred()) |
| 232 | return NULL; |
| 233 | if (timeout > (double)LONG_MAX) { |
| 234 | PyErr_SetString(PyExc_OverflowError, |
| 235 | "timeout period too long"); |
| 236 | return NULL; |
| 237 | } |
| 238 | seconds = (long)timeout; |
| 239 | timeout = timeout - (double)seconds; |
| 240 | tv.tv_sec = seconds; |
| 241 | tv.tv_usec = (long)(timeout * 1E6); |
| 242 | tvp = &tv; |
| 243 | } |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 244 | |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 245 | |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 246 | #ifdef SELECT_USES_HEAP |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 247 | /* Allocate memory for the lists */ |
| 248 | rfd2obj = PyMem_NEW(pylist, FD_SETSIZE + 1); |
| 249 | wfd2obj = PyMem_NEW(pylist, FD_SETSIZE + 1); |
| 250 | efd2obj = PyMem_NEW(pylist, FD_SETSIZE + 1); |
| 251 | if (rfd2obj == NULL || wfd2obj == NULL || efd2obj == NULL) { |
| 252 | if (rfd2obj) PyMem_DEL(rfd2obj); |
| 253 | if (wfd2obj) PyMem_DEL(wfd2obj); |
| 254 | if (efd2obj) PyMem_DEL(efd2obj); |
| 255 | return PyErr_NoMemory(); |
| 256 | } |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 257 | #endif /* SELECT_USES_HEAP */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 258 | /* Convert sequences to fd_sets, and get maximum fd number |
| 259 | * propagates the Python exception set in seq2set() |
| 260 | */ |
| 261 | rfd2obj[0].sentinel = -1; |
| 262 | wfd2obj[0].sentinel = -1; |
| 263 | efd2obj[0].sentinel = -1; |
| 264 | if ((imax=seq2set(ifdlist, &ifdset, rfd2obj)) < 0) |
| 265 | goto finally; |
| 266 | if ((omax=seq2set(ofdlist, &ofdset, wfd2obj)) < 0) |
| 267 | goto finally; |
| 268 | if ((emax=seq2set(efdlist, &efdset, efd2obj)) < 0) |
| 269 | goto finally; |
| 270 | max = imax; |
| 271 | if (omax > max) max = omax; |
| 272 | if (emax > max) max = emax; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 273 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 274 | Py_BEGIN_ALLOW_THREADS |
| 275 | n = select(max, &ifdset, &ofdset, &efdset, tvp); |
| 276 | Py_END_ALLOW_THREADS |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 277 | |
Thomas Heller | 106f4c7 | 2002-09-24 16:51:00 +0000 | [diff] [blame] | 278 | #ifdef MS_WINDOWS |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 279 | if (n == SOCKET_ERROR) { |
| 280 | PyErr_SetExcFromWindowsErr(SelectError, WSAGetLastError()); |
| 281 | } |
Thomas Heller | 106f4c7 | 2002-09-24 16:51:00 +0000 | [diff] [blame] | 282 | #else |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 283 | if (n < 0) { |
| 284 | PyErr_SetFromErrno(SelectError); |
| 285 | } |
Thomas Heller | 106f4c7 | 2002-09-24 16:51:00 +0000 | [diff] [blame] | 286 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 287 | else { |
| 288 | /* any of these three calls can raise an exception. it's more |
| 289 | convenient to test for this after all three calls... but |
| 290 | is that acceptable? |
| 291 | */ |
| 292 | ifdlist = set2list(&ifdset, rfd2obj); |
| 293 | ofdlist = set2list(&ofdset, wfd2obj); |
| 294 | efdlist = set2list(&efdset, efd2obj); |
| 295 | if (PyErr_Occurred()) |
| 296 | ret = NULL; |
| 297 | else |
| 298 | ret = PyTuple_Pack(3, ifdlist, ofdlist, efdlist); |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 299 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 300 | Py_DECREF(ifdlist); |
| 301 | Py_DECREF(ofdlist); |
| 302 | Py_DECREF(efdlist); |
| 303 | } |
| 304 | |
Barry Warsaw | c1cb360 | 1996-12-12 22:16:21 +0000 | [diff] [blame] | 305 | finally: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 306 | reap_obj(rfd2obj); |
| 307 | reap_obj(wfd2obj); |
| 308 | reap_obj(efd2obj); |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 309 | #ifdef SELECT_USES_HEAP |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 310 | PyMem_DEL(rfd2obj); |
| 311 | PyMem_DEL(wfd2obj); |
| 312 | PyMem_DEL(efd2obj); |
Barry Warsaw | b44740f | 2001-08-16 16:52:59 +0000 | [diff] [blame] | 313 | #endif /* SELECT_USES_HEAP */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 314 | return ret; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 315 | } |
| 316 | |
Nicholas Bastin | e62c5c8 | 2004-03-21 23:45:42 +0000 | [diff] [blame] | 317 | #if defined(HAVE_POLL) && !defined(HAVE_BROKEN_POLL) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 318 | /* |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 319 | * poll() support |
| 320 | */ |
| 321 | |
| 322 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 323 | PyObject_HEAD |
| 324 | PyObject *dict; |
| 325 | int ufd_uptodate; |
| 326 | int ufd_len; |
| 327 | struct pollfd *ufds; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 328 | } pollObject; |
| 329 | |
Jeremy Hylton | 938ace6 | 2002-07-17 16:30:39 +0000 | [diff] [blame] | 330 | static PyTypeObject poll_Type; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 331 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 332 | /* Update the malloc'ed array of pollfds to match the dictionary |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 333 | contained within a pollObject. Return 1 on success, 0 on an error. |
| 334 | */ |
| 335 | |
| 336 | static int |
| 337 | update_ufd_array(pollObject *self) |
| 338 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 339 | Py_ssize_t i, pos; |
| 340 | PyObject *key, *value; |
| 341 | struct pollfd *old_ufds = self->ufds; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 342 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 343 | self->ufd_len = PyDict_Size(self->dict); |
| 344 | PyMem_RESIZE(self->ufds, struct pollfd, self->ufd_len); |
| 345 | if (self->ufds == NULL) { |
| 346 | self->ufds = old_ufds; |
| 347 | PyErr_NoMemory(); |
| 348 | return 0; |
| 349 | } |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 350 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 351 | i = pos = 0; |
| 352 | while (PyDict_Next(self->dict, &pos, &key, &value)) { |
| 353 | self->ufds[i].fd = PyLong_AsLong(key); |
| 354 | self->ufds[i].events = (short)PyLong_AsLong(value); |
| 355 | i++; |
| 356 | } |
| 357 | self->ufd_uptodate = 1; |
| 358 | return 1; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 359 | } |
| 360 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 361 | PyDoc_STRVAR(poll_register_doc, |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 362 | "register(fd [, eventmask] ) -> None\n\n\ |
| 363 | Register a file descriptor with the polling object.\n\ |
Barry Warsaw | 2f70455 | 2001-08-16 16:55:10 +0000 | [diff] [blame] | 364 | fd -- either an integer, or an object with a fileno() method returning an\n\ |
| 365 | int.\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 366 | events -- an optional bitmask describing the type of events to check for"); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 367 | |
| 368 | static PyObject * |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 369 | poll_register(pollObject *self, PyObject *args) |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 370 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 371 | PyObject *o, *key, *value; |
| 372 | int fd, events = POLLIN | POLLPRI | POLLOUT; |
| 373 | int err; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 374 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 375 | if (!PyArg_ParseTuple(args, "O|i:register", &o, &events)) { |
| 376 | return NULL; |
| 377 | } |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 378 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 379 | fd = PyObject_AsFileDescriptor(o); |
| 380 | if (fd == -1) return NULL; |
Guido van Rossum | a0dfc85 | 2001-10-25 20:18:35 +0000 | [diff] [blame] | 381 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 382 | /* Add entry to the internal dictionary: the key is the |
| 383 | file descriptor, and the value is the event mask. */ |
| 384 | key = PyLong_FromLong(fd); |
| 385 | if (key == NULL) |
| 386 | return NULL; |
| 387 | value = PyLong_FromLong(events); |
| 388 | if (value == NULL) { |
| 389 | Py_DECREF(key); |
| 390 | return NULL; |
| 391 | } |
| 392 | err = PyDict_SetItem(self->dict, key, value); |
| 393 | Py_DECREF(key); |
| 394 | Py_DECREF(value); |
| 395 | if (err < 0) |
| 396 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 397 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 398 | self->ufd_uptodate = 0; |
| 399 | |
| 400 | Py_INCREF(Py_None); |
| 401 | return Py_None; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 402 | } |
| 403 | |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 404 | PyDoc_STRVAR(poll_modify_doc, |
| 405 | "modify(fd, eventmask) -> None\n\n\ |
Christian Heimes | f6cd967 | 2008-03-26 13:45:42 +0000 | [diff] [blame] | 406 | Modify an already registered file descriptor.\n\ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 407 | fd -- either an integer, or an object with a fileno() method returning an\n\ |
| 408 | int.\n\ |
| 409 | events -- an optional bitmask describing the type of events to check for"); |
| 410 | |
| 411 | static PyObject * |
| 412 | poll_modify(pollObject *self, PyObject *args) |
| 413 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 414 | PyObject *o, *key, *value; |
| 415 | int fd, events; |
| 416 | int err; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 417 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 418 | if (!PyArg_ParseTuple(args, "Oi:modify", &o, &events)) { |
| 419 | return NULL; |
| 420 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 421 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 422 | fd = PyObject_AsFileDescriptor(o); |
| 423 | if (fd == -1) return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 424 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 425 | /* Modify registered fd */ |
| 426 | key = PyLong_FromLong(fd); |
| 427 | if (key == NULL) |
| 428 | return NULL; |
| 429 | if (PyDict_GetItem(self->dict, key) == NULL) { |
| 430 | errno = ENOENT; |
| 431 | PyErr_SetFromErrno(PyExc_IOError); |
| 432 | return NULL; |
| 433 | } |
| 434 | value = PyLong_FromLong(events); |
| 435 | if (value == NULL) { |
| 436 | Py_DECREF(key); |
| 437 | return NULL; |
| 438 | } |
| 439 | err = PyDict_SetItem(self->dict, key, value); |
| 440 | Py_DECREF(key); |
| 441 | Py_DECREF(value); |
| 442 | if (err < 0) |
| 443 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 444 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 445 | self->ufd_uptodate = 0; |
| 446 | |
| 447 | Py_INCREF(Py_None); |
| 448 | return Py_None; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 449 | } |
| 450 | |
| 451 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 452 | PyDoc_STRVAR(poll_unregister_doc, |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 453 | "unregister(fd) -> None\n\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 454 | Remove a file descriptor being tracked by the polling object."); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 455 | |
| 456 | static PyObject * |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 457 | poll_unregister(pollObject *self, PyObject *o) |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 458 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 459 | PyObject *key; |
| 460 | int fd; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 461 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 462 | fd = PyObject_AsFileDescriptor( o ); |
| 463 | if (fd == -1) |
| 464 | return NULL; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 465 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 466 | /* Check whether the fd is already in the array */ |
| 467 | key = PyLong_FromLong(fd); |
| 468 | if (key == NULL) |
| 469 | return NULL; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 470 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 471 | if (PyDict_DelItem(self->dict, key) == -1) { |
| 472 | Py_DECREF(key); |
| 473 | /* This will simply raise the KeyError set by PyDict_DelItem |
| 474 | if the file descriptor isn't registered. */ |
| 475 | return NULL; |
| 476 | } |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 477 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 478 | Py_DECREF(key); |
| 479 | self->ufd_uptodate = 0; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 480 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 481 | Py_INCREF(Py_None); |
| 482 | return Py_None; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 483 | } |
| 484 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 485 | PyDoc_STRVAR(poll_poll_doc, |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 486 | "poll( [timeout] ) -> list of (fd, event) 2-tuples\n\n\ |
| 487 | Polls the set of registered file descriptors, returning a list containing \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 488 | any descriptors that have events or errors to report."); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 489 | |
| 490 | static PyObject * |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 491 | poll_poll(pollObject *self, PyObject *args) |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 492 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 493 | PyObject *result_list = NULL, *tout = NULL; |
| 494 | int timeout = 0, poll_result, i, j; |
| 495 | PyObject *value = NULL, *num = NULL; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 496 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 497 | if (!PyArg_UnpackTuple(args, "poll", 0, 1, &tout)) { |
| 498 | return NULL; |
| 499 | } |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 500 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 501 | /* Check values for timeout */ |
| 502 | if (tout == NULL || tout == Py_None) |
| 503 | timeout = -1; |
| 504 | else if (!PyNumber_Check(tout)) { |
| 505 | PyErr_SetString(PyExc_TypeError, |
| 506 | "timeout must be an integer or None"); |
| 507 | return NULL; |
| 508 | } |
| 509 | else { |
| 510 | tout = PyNumber_Long(tout); |
| 511 | if (!tout) |
| 512 | return NULL; |
| 513 | timeout = PyLong_AsLong(tout); |
| 514 | Py_DECREF(tout); |
| 515 | if (timeout == -1 && PyErr_Occurred()) |
| 516 | return NULL; |
| 517 | } |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 518 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 519 | /* Ensure the ufd array is up to date */ |
| 520 | if (!self->ufd_uptodate) |
| 521 | if (update_ufd_array(self) == 0) |
| 522 | return NULL; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 523 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 524 | /* call poll() */ |
| 525 | Py_BEGIN_ALLOW_THREADS |
| 526 | poll_result = poll(self->ufds, self->ufd_len, timeout); |
| 527 | Py_END_ALLOW_THREADS |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 528 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 529 | if (poll_result < 0) { |
| 530 | PyErr_SetFromErrno(SelectError); |
| 531 | return NULL; |
| 532 | } |
| 533 | |
| 534 | /* build the result list */ |
| 535 | |
| 536 | result_list = PyList_New(poll_result); |
| 537 | if (!result_list) |
| 538 | return NULL; |
| 539 | else { |
| 540 | for (i = 0, j = 0; j < poll_result; j++) { |
| 541 | /* skip to the next fired descriptor */ |
| 542 | while (!self->ufds[i].revents) { |
| 543 | i++; |
| 544 | } |
| 545 | /* if we hit a NULL return, set value to NULL |
| 546 | and break out of loop; code at end will |
| 547 | clean up result_list */ |
| 548 | value = PyTuple_New(2); |
| 549 | if (value == NULL) |
| 550 | goto error; |
| 551 | num = PyLong_FromLong(self->ufds[i].fd); |
| 552 | if (num == NULL) { |
| 553 | Py_DECREF(value); |
| 554 | goto error; |
| 555 | } |
| 556 | PyTuple_SET_ITEM(value, 0, num); |
| 557 | |
| 558 | /* The &0xffff is a workaround for AIX. 'revents' |
| 559 | is a 16-bit short, and IBM assigned POLLNVAL |
| 560 | to be 0x8000, so the conversion to int results |
| 561 | in a negative number. See SF bug #923315. */ |
| 562 | num = PyLong_FromLong(self->ufds[i].revents & 0xffff); |
| 563 | if (num == NULL) { |
| 564 | Py_DECREF(value); |
| 565 | goto error; |
| 566 | } |
| 567 | PyTuple_SET_ITEM(value, 1, num); |
| 568 | if ((PyList_SetItem(result_list, j, value)) == -1) { |
| 569 | Py_DECREF(value); |
| 570 | goto error; |
| 571 | } |
| 572 | i++; |
| 573 | } |
| 574 | } |
| 575 | return result_list; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 576 | |
| 577 | error: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 578 | Py_DECREF(result_list); |
| 579 | return NULL; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 580 | } |
| 581 | |
| 582 | static PyMethodDef poll_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 583 | {"register", (PyCFunction)poll_register, |
| 584 | METH_VARARGS, poll_register_doc}, |
| 585 | {"modify", (PyCFunction)poll_modify, |
| 586 | METH_VARARGS, poll_modify_doc}, |
| 587 | {"unregister", (PyCFunction)poll_unregister, |
| 588 | METH_O, poll_unregister_doc}, |
| 589 | {"poll", (PyCFunction)poll_poll, |
| 590 | METH_VARARGS, poll_poll_doc}, |
| 591 | {NULL, NULL} /* sentinel */ |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 592 | }; |
| 593 | |
| 594 | static pollObject * |
Fred Drake | 8ce159a | 2000-08-31 05:18:54 +0000 | [diff] [blame] | 595 | newPollObject(void) |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 596 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 597 | pollObject *self; |
| 598 | self = PyObject_New(pollObject, &poll_Type); |
| 599 | if (self == NULL) |
| 600 | return NULL; |
| 601 | /* ufd_uptodate is a Boolean, denoting whether the |
| 602 | array pointed to by ufds matches the contents of the dictionary. */ |
| 603 | self->ufd_uptodate = 0; |
| 604 | self->ufds = NULL; |
| 605 | self->dict = PyDict_New(); |
| 606 | if (self->dict == NULL) { |
| 607 | Py_DECREF(self); |
| 608 | return NULL; |
| 609 | } |
| 610 | return self; |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 611 | } |
| 612 | |
| 613 | static void |
| 614 | poll_dealloc(pollObject *self) |
| 615 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 616 | if (self->ufds != NULL) |
| 617 | PyMem_DEL(self->ufds); |
| 618 | Py_XDECREF(self->dict); |
| 619 | PyObject_Del(self); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 620 | } |
| 621 | |
Tim Peters | 0c32279 | 2002-07-17 16:49:03 +0000 | [diff] [blame] | 622 | static PyTypeObject poll_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 623 | /* The ob_type field must be initialized in the module init function |
| 624 | * to be portable to Windows without using C++. */ |
| 625 | PyVarObject_HEAD_INIT(NULL, 0) |
| 626 | "select.poll", /*tp_name*/ |
| 627 | sizeof(pollObject), /*tp_basicsize*/ |
| 628 | 0, /*tp_itemsize*/ |
| 629 | /* methods */ |
| 630 | (destructor)poll_dealloc, /*tp_dealloc*/ |
| 631 | 0, /*tp_print*/ |
| 632 | 0, /*tp_getattr*/ |
| 633 | 0, /*tp_setattr*/ |
| 634 | 0, /*tp_reserved*/ |
| 635 | 0, /*tp_repr*/ |
| 636 | 0, /*tp_as_number*/ |
| 637 | 0, /*tp_as_sequence*/ |
| 638 | 0, /*tp_as_mapping*/ |
| 639 | 0, /*tp_hash*/ |
| 640 | 0, /*tp_call*/ |
| 641 | 0, /*tp_str*/ |
| 642 | 0, /*tp_getattro*/ |
| 643 | 0, /*tp_setattro*/ |
| 644 | 0, /*tp_as_buffer*/ |
| 645 | Py_TPFLAGS_DEFAULT, /*tp_flags*/ |
| 646 | 0, /*tp_doc*/ |
| 647 | 0, /*tp_traverse*/ |
| 648 | 0, /*tp_clear*/ |
| 649 | 0, /*tp_richcompare*/ |
| 650 | 0, /*tp_weaklistoffset*/ |
| 651 | 0, /*tp_iter*/ |
| 652 | 0, /*tp_iternext*/ |
| 653 | poll_methods, /*tp_methods*/ |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 654 | }; |
| 655 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 656 | PyDoc_STRVAR(poll_doc, |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 657 | "Returns a polling object, which supports registering and\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 658 | unregistering file descriptors, and then polling them for I/O events."); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 659 | |
| 660 | static PyObject * |
Thomas Wouters | 4d70c3d | 2006-06-08 14:42:34 +0000 | [diff] [blame] | 661 | select_poll(PyObject *self, PyObject *unused) |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 662 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 663 | return (PyObject *)newPollObject(); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 664 | } |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 665 | |
| 666 | #ifdef __APPLE__ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 667 | /* |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 668 | * On some systems poll() sets errno on invalid file descriptors. We test |
| 669 | * for this at runtime because this bug may be fixed or introduced between |
| 670 | * OS releases. |
| 671 | */ |
| 672 | static int select_have_broken_poll(void) |
| 673 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 674 | int poll_test; |
| 675 | int filedes[2]; |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 676 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 677 | struct pollfd poll_struct = { 0, POLLIN|POLLPRI|POLLOUT, 0 }; |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 678 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 679 | /* Create a file descriptor to make invalid */ |
| 680 | if (pipe(filedes) < 0) { |
| 681 | return 1; |
| 682 | } |
| 683 | poll_struct.fd = filedes[0]; |
| 684 | close(filedes[0]); |
| 685 | close(filedes[1]); |
| 686 | poll_test = poll(&poll_struct, 1, 0); |
| 687 | if (poll_test < 0) { |
| 688 | return 1; |
| 689 | } else if (poll_test == 0 && poll_struct.revents != POLLNVAL) { |
| 690 | return 1; |
| 691 | } |
| 692 | return 0; |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 693 | } |
| 694 | #endif /* __APPLE__ */ |
| 695 | |
| 696 | #endif /* HAVE_POLL */ |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 697 | |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 698 | #ifdef HAVE_EPOLL |
| 699 | /* ************************************************************************** |
| 700 | * epoll interface for Linux 2.6 |
| 701 | * |
| 702 | * Written by Christian Heimes |
| 703 | * Inspired by Twisted's _epoll.pyx and select.poll() |
| 704 | */ |
| 705 | |
| 706 | #ifdef HAVE_SYS_EPOLL_H |
| 707 | #include <sys/epoll.h> |
| 708 | #endif |
| 709 | |
| 710 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 711 | PyObject_HEAD |
| 712 | SOCKET epfd; /* epoll control file descriptor */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 713 | } pyEpoll_Object; |
| 714 | |
| 715 | static PyTypeObject pyEpoll_Type; |
| 716 | #define pyepoll_CHECK(op) (PyObject_TypeCheck((op), &pyEpoll_Type)) |
| 717 | |
| 718 | static PyObject * |
| 719 | pyepoll_err_closed(void) |
| 720 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 721 | PyErr_SetString(PyExc_ValueError, "I/O operation on closed epoll fd"); |
| 722 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 723 | } |
| 724 | |
| 725 | static int |
| 726 | pyepoll_internal_close(pyEpoll_Object *self) |
| 727 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 728 | int save_errno = 0; |
| 729 | if (self->epfd >= 0) { |
| 730 | int epfd = self->epfd; |
| 731 | self->epfd = -1; |
| 732 | Py_BEGIN_ALLOW_THREADS |
| 733 | if (close(epfd) < 0) |
| 734 | save_errno = errno; |
| 735 | Py_END_ALLOW_THREADS |
| 736 | } |
| 737 | return save_errno; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 738 | } |
| 739 | |
| 740 | static PyObject * |
| 741 | newPyEpoll_Object(PyTypeObject *type, int sizehint, SOCKET fd) |
| 742 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 743 | pyEpoll_Object *self; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 744 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 745 | if (sizehint == -1) { |
| 746 | sizehint = FD_SETSIZE-1; |
| 747 | } |
| 748 | else if (sizehint < 1) { |
| 749 | PyErr_Format(PyExc_ValueError, |
| 750 | "sizehint must be greater zero, got %d", |
| 751 | sizehint); |
| 752 | return NULL; |
| 753 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 754 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 755 | assert(type != NULL && type->tp_alloc != NULL); |
| 756 | self = (pyEpoll_Object *) type->tp_alloc(type, 0); |
| 757 | if (self == NULL) |
| 758 | return NULL; |
| 759 | |
| 760 | if (fd == -1) { |
| 761 | Py_BEGIN_ALLOW_THREADS |
| 762 | self->epfd = epoll_create(sizehint); |
| 763 | Py_END_ALLOW_THREADS |
| 764 | } |
| 765 | else { |
| 766 | self->epfd = fd; |
| 767 | } |
| 768 | if (self->epfd < 0) { |
| 769 | Py_DECREF(self); |
| 770 | PyErr_SetFromErrno(PyExc_IOError); |
| 771 | return NULL; |
| 772 | } |
| 773 | return (PyObject *)self; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 774 | } |
| 775 | |
| 776 | |
| 777 | static PyObject * |
| 778 | pyepoll_new(PyTypeObject *type, PyObject *args, PyObject *kwds) |
| 779 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 780 | int sizehint = -1; |
| 781 | static char *kwlist[] = {"sizehint", NULL}; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 782 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 783 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "|i:epoll", kwlist, |
| 784 | &sizehint)) |
| 785 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 786 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 787 | return newPyEpoll_Object(type, sizehint, -1); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 788 | } |
| 789 | |
| 790 | |
| 791 | static void |
| 792 | pyepoll_dealloc(pyEpoll_Object *self) |
| 793 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 794 | (void)pyepoll_internal_close(self); |
| 795 | Py_TYPE(self)->tp_free(self); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 796 | } |
| 797 | |
| 798 | static PyObject* |
| 799 | pyepoll_close(pyEpoll_Object *self) |
| 800 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 801 | errno = pyepoll_internal_close(self); |
| 802 | if (errno < 0) { |
| 803 | PyErr_SetFromErrno(PyExc_IOError); |
| 804 | return NULL; |
| 805 | } |
| 806 | Py_RETURN_NONE; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 807 | } |
| 808 | |
| 809 | PyDoc_STRVAR(pyepoll_close_doc, |
| 810 | "close() -> None\n\ |
| 811 | \n\ |
| 812 | Close the epoll control file descriptor. Further operations on the epoll\n\ |
| 813 | object will raise an exception."); |
| 814 | |
| 815 | static PyObject* |
| 816 | pyepoll_get_closed(pyEpoll_Object *self) |
| 817 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 818 | if (self->epfd < 0) |
| 819 | Py_RETURN_TRUE; |
| 820 | else |
| 821 | Py_RETURN_FALSE; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 822 | } |
| 823 | |
| 824 | static PyObject* |
| 825 | pyepoll_fileno(pyEpoll_Object *self) |
| 826 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 827 | if (self->epfd < 0) |
| 828 | return pyepoll_err_closed(); |
| 829 | return PyLong_FromLong(self->epfd); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 830 | } |
| 831 | |
| 832 | PyDoc_STRVAR(pyepoll_fileno_doc, |
| 833 | "fileno() -> int\n\ |
| 834 | \n\ |
| 835 | Return the epoll control file descriptor."); |
| 836 | |
| 837 | static PyObject* |
| 838 | pyepoll_fromfd(PyObject *cls, PyObject *args) |
| 839 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 840 | SOCKET fd; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 841 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 842 | if (!PyArg_ParseTuple(args, "i:fromfd", &fd)) |
| 843 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 844 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 845 | return newPyEpoll_Object((PyTypeObject*)cls, -1, fd); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 846 | } |
| 847 | |
| 848 | PyDoc_STRVAR(pyepoll_fromfd_doc, |
| 849 | "fromfd(fd) -> epoll\n\ |
| 850 | \n\ |
| 851 | Create an epoll object from a given control fd."); |
| 852 | |
| 853 | static PyObject * |
| 854 | pyepoll_internal_ctl(int epfd, int op, PyObject *pfd, unsigned int events) |
| 855 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 856 | struct epoll_event ev; |
| 857 | int result; |
| 858 | int fd; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 859 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 860 | if (epfd < 0) |
| 861 | return pyepoll_err_closed(); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 862 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 863 | fd = PyObject_AsFileDescriptor(pfd); |
| 864 | if (fd == -1) { |
| 865 | return NULL; |
| 866 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 867 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 868 | switch(op) { |
| 869 | case EPOLL_CTL_ADD: |
| 870 | case EPOLL_CTL_MOD: |
| 871 | ev.events = events; |
| 872 | ev.data.fd = fd; |
| 873 | Py_BEGIN_ALLOW_THREADS |
| 874 | result = epoll_ctl(epfd, op, fd, &ev); |
| 875 | Py_END_ALLOW_THREADS |
| 876 | break; |
| 877 | case EPOLL_CTL_DEL: |
| 878 | /* In kernel versions before 2.6.9, the EPOLL_CTL_DEL |
| 879 | * operation required a non-NULL pointer in event, even |
| 880 | * though this argument is ignored. */ |
| 881 | Py_BEGIN_ALLOW_THREADS |
| 882 | result = epoll_ctl(epfd, op, fd, &ev); |
| 883 | if (errno == EBADF) { |
| 884 | /* fd already closed */ |
| 885 | result = 0; |
| 886 | errno = 0; |
| 887 | } |
| 888 | Py_END_ALLOW_THREADS |
| 889 | break; |
| 890 | default: |
| 891 | result = -1; |
| 892 | errno = EINVAL; |
| 893 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 894 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 895 | if (result < 0) { |
| 896 | PyErr_SetFromErrno(PyExc_IOError); |
| 897 | return NULL; |
| 898 | } |
| 899 | Py_RETURN_NONE; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 900 | } |
| 901 | |
| 902 | static PyObject * |
| 903 | pyepoll_register(pyEpoll_Object *self, PyObject *args, PyObject *kwds) |
| 904 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 905 | PyObject *pfd; |
| 906 | unsigned int events = EPOLLIN | EPOLLOUT | EPOLLPRI; |
| 907 | static char *kwlist[] = {"fd", "eventmask", NULL}; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 908 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 909 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|I:register", kwlist, |
| 910 | &pfd, &events)) { |
| 911 | return NULL; |
| 912 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 913 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 914 | return pyepoll_internal_ctl(self->epfd, EPOLL_CTL_ADD, pfd, events); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 915 | } |
| 916 | |
| 917 | PyDoc_STRVAR(pyepoll_register_doc, |
Georg Brandl | 222569d | 2010-08-02 20:47:56 +0000 | [diff] [blame] | 918 | "register(fd[, eventmask]) -> None\n\ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 919 | \n\ |
Georg Brandl | 222569d | 2010-08-02 20:47:56 +0000 | [diff] [blame] | 920 | Registers a new fd or modifies an already registered fd.\n\ |
Christian Heimes | f6cd967 | 2008-03-26 13:45:42 +0000 | [diff] [blame] | 921 | fd is the target file descriptor of the operation.\n\ |
| 922 | events is a bit set composed of the various EPOLL constants; the default\n\ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 923 | is EPOLL_IN | EPOLL_OUT | EPOLL_PRI.\n\ |
| 924 | \n\ |
| 925 | The epoll interface supports all file descriptors that support poll."); |
| 926 | |
| 927 | static PyObject * |
| 928 | pyepoll_modify(pyEpoll_Object *self, PyObject *args, PyObject *kwds) |
| 929 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 930 | PyObject *pfd; |
| 931 | unsigned int events; |
| 932 | static char *kwlist[] = {"fd", "eventmask", NULL}; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 933 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 934 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "OI:modify", kwlist, |
| 935 | &pfd, &events)) { |
| 936 | return NULL; |
| 937 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 938 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 939 | return pyepoll_internal_ctl(self->epfd, EPOLL_CTL_MOD, pfd, events); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 940 | } |
| 941 | |
| 942 | PyDoc_STRVAR(pyepoll_modify_doc, |
| 943 | "modify(fd, eventmask) -> None\n\ |
| 944 | \n\ |
| 945 | fd is the target file descriptor of the operation\n\ |
| 946 | events is a bit set composed of the various EPOLL constants"); |
| 947 | |
| 948 | static PyObject * |
| 949 | pyepoll_unregister(pyEpoll_Object *self, PyObject *args, PyObject *kwds) |
| 950 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 951 | PyObject *pfd; |
| 952 | static char *kwlist[] = {"fd", NULL}; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 953 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 954 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "O:unregister", kwlist, |
| 955 | &pfd)) { |
| 956 | return NULL; |
| 957 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 958 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 959 | return pyepoll_internal_ctl(self->epfd, EPOLL_CTL_DEL, pfd, 0); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 960 | } |
| 961 | |
| 962 | PyDoc_STRVAR(pyepoll_unregister_doc, |
| 963 | "unregister(fd) -> None\n\ |
| 964 | \n\ |
| 965 | fd is the target file descriptor of the operation."); |
| 966 | |
| 967 | static PyObject * |
| 968 | pyepoll_poll(pyEpoll_Object *self, PyObject *args, PyObject *kwds) |
| 969 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 970 | double dtimeout = -1.; |
| 971 | int timeout; |
| 972 | int maxevents = -1; |
| 973 | int nfds, i; |
| 974 | PyObject *elist = NULL, *etuple = NULL; |
| 975 | struct epoll_event *evs = NULL; |
| 976 | static char *kwlist[] = {"timeout", "maxevents", NULL}; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 977 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 978 | if (self->epfd < 0) |
| 979 | return pyepoll_err_closed(); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 980 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 981 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "|di:poll", kwlist, |
| 982 | &dtimeout, &maxevents)) { |
| 983 | return NULL; |
| 984 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 985 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 986 | if (dtimeout < 0) { |
| 987 | timeout = -1; |
| 988 | } |
| 989 | else if (dtimeout * 1000.0 > INT_MAX) { |
| 990 | PyErr_SetString(PyExc_OverflowError, |
| 991 | "timeout is too large"); |
| 992 | return NULL; |
| 993 | } |
| 994 | else { |
| 995 | timeout = (int)(dtimeout * 1000.0); |
| 996 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 997 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 998 | if (maxevents == -1) { |
| 999 | maxevents = FD_SETSIZE-1; |
| 1000 | } |
| 1001 | else if (maxevents < 1) { |
| 1002 | PyErr_Format(PyExc_ValueError, |
| 1003 | "maxevents must be greater than 0, got %d", |
| 1004 | maxevents); |
| 1005 | return NULL; |
| 1006 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1007 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1008 | evs = PyMem_New(struct epoll_event, maxevents); |
| 1009 | if (evs == NULL) { |
| 1010 | Py_DECREF(self); |
| 1011 | PyErr_NoMemory(); |
| 1012 | return NULL; |
| 1013 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1014 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1015 | Py_BEGIN_ALLOW_THREADS |
| 1016 | nfds = epoll_wait(self->epfd, evs, maxevents, timeout); |
| 1017 | Py_END_ALLOW_THREADS |
| 1018 | if (nfds < 0) { |
| 1019 | PyErr_SetFromErrno(PyExc_IOError); |
| 1020 | goto error; |
| 1021 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1022 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1023 | elist = PyList_New(nfds); |
| 1024 | if (elist == NULL) { |
| 1025 | goto error; |
| 1026 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1027 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1028 | for (i = 0; i < nfds; i++) { |
| 1029 | etuple = Py_BuildValue("iI", evs[i].data.fd, evs[i].events); |
| 1030 | if (etuple == NULL) { |
| 1031 | Py_CLEAR(elist); |
| 1032 | goto error; |
| 1033 | } |
| 1034 | PyList_SET_ITEM(elist, i, etuple); |
| 1035 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1036 | |
Christian Heimes | f6cd967 | 2008-03-26 13:45:42 +0000 | [diff] [blame] | 1037 | error: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1038 | PyMem_Free(evs); |
| 1039 | return elist; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1040 | } |
| 1041 | |
| 1042 | PyDoc_STRVAR(pyepoll_poll_doc, |
| 1043 | "poll([timeout=-1[, maxevents=-1]]) -> [(fd, events), (...)]\n\ |
| 1044 | \n\ |
| 1045 | Wait for events on the epoll file descriptor for a maximum time of timeout\n\ |
| 1046 | in seconds (as float). -1 makes poll wait indefinitely.\n\ |
| 1047 | Up to maxevents are returned to the caller."); |
| 1048 | |
| 1049 | static PyMethodDef pyepoll_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1050 | {"fromfd", (PyCFunction)pyepoll_fromfd, |
| 1051 | METH_VARARGS | METH_CLASS, pyepoll_fromfd_doc}, |
| 1052 | {"close", (PyCFunction)pyepoll_close, METH_NOARGS, |
| 1053 | pyepoll_close_doc}, |
| 1054 | {"fileno", (PyCFunction)pyepoll_fileno, METH_NOARGS, |
| 1055 | pyepoll_fileno_doc}, |
| 1056 | {"modify", (PyCFunction)pyepoll_modify, |
| 1057 | METH_VARARGS | METH_KEYWORDS, pyepoll_modify_doc}, |
| 1058 | {"register", (PyCFunction)pyepoll_register, |
| 1059 | METH_VARARGS | METH_KEYWORDS, pyepoll_register_doc}, |
| 1060 | {"unregister", (PyCFunction)pyepoll_unregister, |
| 1061 | METH_VARARGS | METH_KEYWORDS, pyepoll_unregister_doc}, |
| 1062 | {"poll", (PyCFunction)pyepoll_poll, |
| 1063 | METH_VARARGS | METH_KEYWORDS, pyepoll_poll_doc}, |
| 1064 | {NULL, NULL}, |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1065 | }; |
| 1066 | |
| 1067 | static PyGetSetDef pyepoll_getsetlist[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1068 | {"closed", (getter)pyepoll_get_closed, NULL, |
| 1069 | "True if the epoll handler is closed"}, |
| 1070 | {0}, |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1071 | }; |
| 1072 | |
| 1073 | PyDoc_STRVAR(pyepoll_doc, |
| 1074 | "select.epoll([sizehint=-1])\n\ |
| 1075 | \n\ |
| 1076 | Returns an epolling object\n\ |
| 1077 | \n\ |
| 1078 | sizehint must be a positive integer or -1 for the default size. The\n\ |
| 1079 | sizehint is used to optimize internal data structures. It doesn't limit\n\ |
| 1080 | the maximum number of monitored events."); |
| 1081 | |
| 1082 | static PyTypeObject pyEpoll_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1083 | PyVarObject_HEAD_INIT(NULL, 0) |
| 1084 | "select.epoll", /* tp_name */ |
| 1085 | sizeof(pyEpoll_Object), /* tp_basicsize */ |
| 1086 | 0, /* tp_itemsize */ |
| 1087 | (destructor)pyepoll_dealloc, /* tp_dealloc */ |
| 1088 | 0, /* tp_print */ |
| 1089 | 0, /* tp_getattr */ |
| 1090 | 0, /* tp_setattr */ |
| 1091 | 0, /* tp_reserved */ |
| 1092 | 0, /* tp_repr */ |
| 1093 | 0, /* tp_as_number */ |
| 1094 | 0, /* tp_as_sequence */ |
| 1095 | 0, /* tp_as_mapping */ |
| 1096 | 0, /* tp_hash */ |
| 1097 | 0, /* tp_call */ |
| 1098 | 0, /* tp_str */ |
| 1099 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 1100 | 0, /* tp_setattro */ |
| 1101 | 0, /* tp_as_buffer */ |
| 1102 | Py_TPFLAGS_DEFAULT, /* tp_flags */ |
| 1103 | pyepoll_doc, /* tp_doc */ |
| 1104 | 0, /* tp_traverse */ |
| 1105 | 0, /* tp_clear */ |
| 1106 | 0, /* tp_richcompare */ |
| 1107 | 0, /* tp_weaklistoffset */ |
| 1108 | 0, /* tp_iter */ |
| 1109 | 0, /* tp_iternext */ |
| 1110 | pyepoll_methods, /* tp_methods */ |
| 1111 | 0, /* tp_members */ |
| 1112 | pyepoll_getsetlist, /* tp_getset */ |
| 1113 | 0, /* tp_base */ |
| 1114 | 0, /* tp_dict */ |
| 1115 | 0, /* tp_descr_get */ |
| 1116 | 0, /* tp_descr_set */ |
| 1117 | 0, /* tp_dictoffset */ |
| 1118 | 0, /* tp_init */ |
| 1119 | 0, /* tp_alloc */ |
| 1120 | pyepoll_new, /* tp_new */ |
| 1121 | 0, /* tp_free */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1122 | }; |
| 1123 | |
| 1124 | #endif /* HAVE_EPOLL */ |
| 1125 | |
| 1126 | #ifdef HAVE_KQUEUE |
| 1127 | /* ************************************************************************** |
| 1128 | * kqueue interface for BSD |
| 1129 | * |
| 1130 | * Copyright (c) 2000 Doug White, 2006 James Knight, 2007 Christian Heimes |
| 1131 | * All rights reserved. |
| 1132 | * |
| 1133 | * Redistribution and use in source and binary forms, with or without |
| 1134 | * modification, are permitted provided that the following conditions |
| 1135 | * are met: |
| 1136 | * 1. Redistributions of source code must retain the above copyright |
| 1137 | * notice, this list of conditions and the following disclaimer. |
| 1138 | * 2. Redistributions in binary form must reproduce the above copyright |
| 1139 | * notice, this list of conditions and the following disclaimer in the |
| 1140 | * documentation and/or other materials provided with the distribution. |
| 1141 | * |
| 1142 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND |
| 1143 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| 1144 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| 1145 | * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE |
| 1146 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| 1147 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
| 1148 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
| 1149 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
| 1150 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY |
| 1151 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| 1152 | * SUCH DAMAGE. |
| 1153 | */ |
| 1154 | |
| 1155 | #ifdef HAVE_SYS_EVENT_H |
| 1156 | #include <sys/event.h> |
| 1157 | #endif |
| 1158 | |
| 1159 | PyDoc_STRVAR(kqueue_event_doc, |
Benjamin Peterson | 1baf465 | 2009-12-31 03:11:23 +0000 | [diff] [blame] | 1160 | "kevent(ident, filter=KQ_FILTER_READ, flags=KQ_EV_ADD, fflags=0, data=0, udata=0)\n\ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1161 | \n\ |
| 1162 | This object is the equivalent of the struct kevent for the C API.\n\ |
| 1163 | \n\ |
| 1164 | See the kqueue manpage for more detailed information about the meaning\n\ |
| 1165 | of the arguments.\n\ |
| 1166 | \n\ |
| 1167 | One minor note: while you might hope that udata could store a\n\ |
| 1168 | reference to a python object, it cannot, because it is impossible to\n\ |
| 1169 | keep a proper reference count of the object once it's passed into the\n\ |
| 1170 | kernel. Therefore, I have restricted it to only storing an integer. I\n\ |
| 1171 | recommend ignoring it and simply using the 'ident' field to key off\n\ |
| 1172 | of. You could also set up a dictionary on the python side to store a\n\ |
| 1173 | udata->object mapping."); |
| 1174 | |
| 1175 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1176 | PyObject_HEAD |
| 1177 | struct kevent e; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1178 | } kqueue_event_Object; |
| 1179 | |
| 1180 | static PyTypeObject kqueue_event_Type; |
| 1181 | |
| 1182 | #define kqueue_event_Check(op) (PyObject_TypeCheck((op), &kqueue_event_Type)) |
| 1183 | |
| 1184 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1185 | PyObject_HEAD |
| 1186 | SOCKET kqfd; /* kqueue control fd */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1187 | } kqueue_queue_Object; |
| 1188 | |
| 1189 | static PyTypeObject kqueue_queue_Type; |
| 1190 | |
| 1191 | #define kqueue_queue_Check(op) (PyObject_TypeCheck((op), &kqueue_queue_Type)) |
| 1192 | |
Antoine Pitrou | d83f1e6 | 2009-11-04 21:10:38 +0000 | [diff] [blame] | 1193 | #if (SIZEOF_UINTPTR_T != SIZEOF_VOID_P) |
| 1194 | # error uintptr_t does not match void *! |
| 1195 | #elif (SIZEOF_UINTPTR_T == SIZEOF_LONG_LONG) |
| 1196 | # define T_UINTPTRT T_ULONGLONG |
| 1197 | # define T_INTPTRT T_LONGLONG |
| 1198 | # define PyLong_AsUintptr_t PyLong_AsUnsignedLongLong |
| 1199 | # define UINTPTRT_FMT_UNIT "K" |
| 1200 | # define INTPTRT_FMT_UNIT "L" |
| 1201 | #elif (SIZEOF_UINTPTR_T == SIZEOF_LONG) |
| 1202 | # define T_UINTPTRT T_ULONG |
| 1203 | # define T_INTPTRT T_LONG |
| 1204 | # define PyLong_AsUintptr_t PyLong_AsUnsignedLong |
| 1205 | # define UINTPTRT_FMT_UNIT "k" |
| 1206 | # define INTPTRT_FMT_UNIT "l" |
| 1207 | #elif (SIZEOF_UINTPTR_T == SIZEOF_INT) |
| 1208 | # define T_UINTPTRT T_UINT |
| 1209 | # define T_INTPTRT T_INT |
| 1210 | # define PyLong_AsUintptr_t PyLong_AsUnsignedLong |
| 1211 | # define UINTPTRT_FMT_UNIT "I" |
| 1212 | # define INTPTRT_FMT_UNIT "i" |
| 1213 | #else |
| 1214 | # error uintptr_t does not match int, long, or long long! |
| 1215 | #endif |
| 1216 | |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1217 | /* Unfortunately, we can't store python objects in udata, because |
| 1218 | * kevents in the kernel can be removed without warning, which would |
| 1219 | * forever lose the refcount on the object stored with it. |
| 1220 | */ |
| 1221 | |
| 1222 | #define KQ_OFF(x) offsetof(kqueue_event_Object, x) |
| 1223 | static struct PyMemberDef kqueue_event_members[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1224 | {"ident", T_UINTPTRT, KQ_OFF(e.ident)}, |
| 1225 | {"filter", T_SHORT, KQ_OFF(e.filter)}, |
| 1226 | {"flags", T_USHORT, KQ_OFF(e.flags)}, |
| 1227 | {"fflags", T_UINT, KQ_OFF(e.fflags)}, |
| 1228 | {"data", T_INTPTRT, KQ_OFF(e.data)}, |
| 1229 | {"udata", T_UINTPTRT, KQ_OFF(e.udata)}, |
| 1230 | {NULL} /* Sentinel */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1231 | }; |
| 1232 | #undef KQ_OFF |
| 1233 | |
| 1234 | static PyObject * |
Georg Brandl | c0e22b7 | 2010-03-14 10:51:01 +0000 | [diff] [blame] | 1235 | |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1236 | kqueue_event_repr(kqueue_event_Object *s) |
| 1237 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1238 | char buf[1024]; |
| 1239 | PyOS_snprintf( |
| 1240 | buf, sizeof(buf), |
| 1241 | "<select.kevent ident=%zu filter=%d flags=0x%x fflags=0x%x " |
| 1242 | "data=0x%zd udata=%p>", |
| 1243 | (size_t)(s->e.ident), s->e.filter, s->e.flags, |
| 1244 | s->e.fflags, (Py_ssize_t)(s->e.data), s->e.udata); |
| 1245 | return PyUnicode_FromString(buf); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1246 | } |
| 1247 | |
| 1248 | static int |
| 1249 | kqueue_event_init(kqueue_event_Object *self, PyObject *args, PyObject *kwds) |
| 1250 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1251 | PyObject *pfd; |
| 1252 | static char *kwlist[] = {"ident", "filter", "flags", "fflags", |
| 1253 | "data", "udata", NULL}; |
| 1254 | static char *fmt = "O|hhi" INTPTRT_FMT_UNIT UINTPTRT_FMT_UNIT ":kevent"; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1255 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1256 | EV_SET(&(self->e), 0, EVFILT_READ, EV_ADD, 0, 0, 0); /* defaults */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1257 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1258 | if (!PyArg_ParseTupleAndKeywords(args, kwds, fmt, kwlist, |
| 1259 | &pfd, &(self->e.filter), &(self->e.flags), |
| 1260 | &(self->e.fflags), &(self->e.data), &(self->e.udata))) { |
| 1261 | return -1; |
| 1262 | } |
| 1263 | |
| 1264 | if (PyLong_Check(pfd)) { |
| 1265 | self->e.ident = PyLong_AsUintptr_t(pfd); |
| 1266 | } |
| 1267 | else { |
| 1268 | self->e.ident = PyObject_AsFileDescriptor(pfd); |
| 1269 | } |
| 1270 | if (PyErr_Occurred()) { |
| 1271 | return -1; |
| 1272 | } |
| 1273 | return 0; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1274 | } |
| 1275 | |
| 1276 | static PyObject * |
| 1277 | kqueue_event_richcompare(kqueue_event_Object *s, kqueue_event_Object *o, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1278 | int op) |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1279 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1280 | Py_intptr_t result = 0; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1281 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1282 | if (!kqueue_event_Check(o)) { |
| 1283 | if (op == Py_EQ || op == Py_NE) { |
| 1284 | PyObject *res = op == Py_EQ ? Py_False : Py_True; |
| 1285 | Py_INCREF(res); |
| 1286 | return res; |
| 1287 | } |
| 1288 | PyErr_Format(PyExc_TypeError, |
| 1289 | "can't compare %.200s to %.200s", |
| 1290 | Py_TYPE(s)->tp_name, Py_TYPE(o)->tp_name); |
| 1291 | return NULL; |
| 1292 | } |
| 1293 | if (((result = s->e.ident - o->e.ident) == 0) && |
| 1294 | ((result = s->e.filter - o->e.filter) == 0) && |
| 1295 | ((result = s->e.flags - o->e.flags) == 0) && |
| 1296 | ((result = s->e.fflags - o->e.fflags) == 0) && |
| 1297 | ((result = s->e.data - o->e.data) == 0) && |
| 1298 | ((result = s->e.udata - o->e.udata) == 0) |
| 1299 | ) { |
| 1300 | result = 0; |
| 1301 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1302 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1303 | switch (op) { |
| 1304 | case Py_EQ: |
| 1305 | result = (result == 0); |
| 1306 | break; |
| 1307 | case Py_NE: |
| 1308 | result = (result != 0); |
| 1309 | break; |
| 1310 | case Py_LE: |
| 1311 | result = (result <= 0); |
| 1312 | break; |
| 1313 | case Py_GE: |
| 1314 | result = (result >= 0); |
| 1315 | break; |
| 1316 | case Py_LT: |
| 1317 | result = (result < 0); |
| 1318 | break; |
| 1319 | case Py_GT: |
| 1320 | result = (result > 0); |
| 1321 | break; |
| 1322 | } |
| 1323 | return PyBool_FromLong((long)result); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1324 | } |
| 1325 | |
| 1326 | static PyTypeObject kqueue_event_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1327 | PyVarObject_HEAD_INIT(NULL, 0) |
| 1328 | "select.kevent", /* tp_name */ |
| 1329 | sizeof(kqueue_event_Object), /* tp_basicsize */ |
| 1330 | 0, /* tp_itemsize */ |
| 1331 | 0, /* tp_dealloc */ |
| 1332 | 0, /* tp_print */ |
| 1333 | 0, /* tp_getattr */ |
| 1334 | 0, /* tp_setattr */ |
| 1335 | 0, /* tp_reserved */ |
| 1336 | (reprfunc)kqueue_event_repr, /* tp_repr */ |
| 1337 | 0, /* tp_as_number */ |
| 1338 | 0, /* tp_as_sequence */ |
| 1339 | 0, /* tp_as_mapping */ |
| 1340 | 0, /* tp_hash */ |
| 1341 | 0, /* tp_call */ |
| 1342 | 0, /* tp_str */ |
| 1343 | 0, /* tp_getattro */ |
| 1344 | 0, /* tp_setattro */ |
| 1345 | 0, /* tp_as_buffer */ |
| 1346 | Py_TPFLAGS_DEFAULT, /* tp_flags */ |
| 1347 | kqueue_event_doc, /* tp_doc */ |
| 1348 | 0, /* tp_traverse */ |
| 1349 | 0, /* tp_clear */ |
| 1350 | (richcmpfunc)kqueue_event_richcompare, /* tp_richcompare */ |
| 1351 | 0, /* tp_weaklistoffset */ |
| 1352 | 0, /* tp_iter */ |
| 1353 | 0, /* tp_iternext */ |
| 1354 | 0, /* tp_methods */ |
| 1355 | kqueue_event_members, /* tp_members */ |
| 1356 | 0, /* tp_getset */ |
| 1357 | 0, /* tp_base */ |
| 1358 | 0, /* tp_dict */ |
| 1359 | 0, /* tp_descr_get */ |
| 1360 | 0, /* tp_descr_set */ |
| 1361 | 0, /* tp_dictoffset */ |
| 1362 | (initproc)kqueue_event_init, /* tp_init */ |
| 1363 | 0, /* tp_alloc */ |
| 1364 | 0, /* tp_new */ |
| 1365 | 0, /* tp_free */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1366 | }; |
| 1367 | |
| 1368 | static PyObject * |
| 1369 | kqueue_queue_err_closed(void) |
| 1370 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1371 | PyErr_SetString(PyExc_ValueError, "I/O operation on closed kqueue fd"); |
| 1372 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1373 | } |
| 1374 | |
| 1375 | static int |
| 1376 | kqueue_queue_internal_close(kqueue_queue_Object *self) |
| 1377 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1378 | int save_errno = 0; |
| 1379 | if (self->kqfd >= 0) { |
| 1380 | int kqfd = self->kqfd; |
| 1381 | self->kqfd = -1; |
| 1382 | Py_BEGIN_ALLOW_THREADS |
| 1383 | if (close(kqfd) < 0) |
| 1384 | save_errno = errno; |
| 1385 | Py_END_ALLOW_THREADS |
| 1386 | } |
| 1387 | return save_errno; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1388 | } |
| 1389 | |
| 1390 | static PyObject * |
| 1391 | newKqueue_Object(PyTypeObject *type, SOCKET fd) |
| 1392 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1393 | kqueue_queue_Object *self; |
| 1394 | assert(type != NULL && type->tp_alloc != NULL); |
| 1395 | self = (kqueue_queue_Object *) type->tp_alloc(type, 0); |
| 1396 | if (self == NULL) { |
| 1397 | return NULL; |
| 1398 | } |
| 1399 | |
| 1400 | if (fd == -1) { |
| 1401 | Py_BEGIN_ALLOW_THREADS |
| 1402 | self->kqfd = kqueue(); |
| 1403 | Py_END_ALLOW_THREADS |
| 1404 | } |
| 1405 | else { |
| 1406 | self->kqfd = fd; |
| 1407 | } |
| 1408 | if (self->kqfd < 0) { |
| 1409 | Py_DECREF(self); |
| 1410 | PyErr_SetFromErrno(PyExc_IOError); |
| 1411 | return NULL; |
| 1412 | } |
| 1413 | return (PyObject *)self; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1414 | } |
| 1415 | |
| 1416 | static PyObject * |
| 1417 | kqueue_queue_new(PyTypeObject *type, PyObject *args, PyObject *kwds) |
| 1418 | { |
| 1419 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1420 | if ((args != NULL && PyObject_Size(args)) || |
| 1421 | (kwds != NULL && PyObject_Size(kwds))) { |
| 1422 | PyErr_SetString(PyExc_ValueError, |
| 1423 | "select.kqueue doesn't accept arguments"); |
| 1424 | return NULL; |
| 1425 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1426 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1427 | return newKqueue_Object(type, -1); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1428 | } |
| 1429 | |
| 1430 | static void |
| 1431 | kqueue_queue_dealloc(kqueue_queue_Object *self) |
| 1432 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1433 | kqueue_queue_internal_close(self); |
| 1434 | Py_TYPE(self)->tp_free(self); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1435 | } |
| 1436 | |
| 1437 | static PyObject* |
| 1438 | kqueue_queue_close(kqueue_queue_Object *self) |
| 1439 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1440 | errno = kqueue_queue_internal_close(self); |
| 1441 | if (errno < 0) { |
| 1442 | PyErr_SetFromErrno(PyExc_IOError); |
| 1443 | return NULL; |
| 1444 | } |
| 1445 | Py_RETURN_NONE; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1446 | } |
| 1447 | |
| 1448 | PyDoc_STRVAR(kqueue_queue_close_doc, |
| 1449 | "close() -> None\n\ |
| 1450 | \n\ |
| 1451 | Close the kqueue control file descriptor. Further operations on the kqueue\n\ |
| 1452 | object will raise an exception."); |
| 1453 | |
| 1454 | static PyObject* |
| 1455 | kqueue_queue_get_closed(kqueue_queue_Object *self) |
| 1456 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1457 | if (self->kqfd < 0) |
| 1458 | Py_RETURN_TRUE; |
| 1459 | else |
| 1460 | Py_RETURN_FALSE; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1461 | } |
| 1462 | |
| 1463 | static PyObject* |
| 1464 | kqueue_queue_fileno(kqueue_queue_Object *self) |
| 1465 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1466 | if (self->kqfd < 0) |
| 1467 | return kqueue_queue_err_closed(); |
| 1468 | return PyLong_FromLong(self->kqfd); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1469 | } |
| 1470 | |
| 1471 | PyDoc_STRVAR(kqueue_queue_fileno_doc, |
| 1472 | "fileno() -> int\n\ |
| 1473 | \n\ |
| 1474 | Return the kqueue control file descriptor."); |
| 1475 | |
| 1476 | static PyObject* |
| 1477 | kqueue_queue_fromfd(PyObject *cls, PyObject *args) |
| 1478 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1479 | SOCKET fd; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1480 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1481 | if (!PyArg_ParseTuple(args, "i:fromfd", &fd)) |
| 1482 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1483 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1484 | return newKqueue_Object((PyTypeObject*)cls, fd); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1485 | } |
| 1486 | |
| 1487 | PyDoc_STRVAR(kqueue_queue_fromfd_doc, |
| 1488 | "fromfd(fd) -> kqueue\n\ |
| 1489 | \n\ |
| 1490 | Create a kqueue object from a given control fd."); |
| 1491 | |
| 1492 | static PyObject * |
| 1493 | kqueue_queue_control(kqueue_queue_Object *self, PyObject *args) |
| 1494 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1495 | int nevents = 0; |
| 1496 | int gotevents = 0; |
| 1497 | int nchanges = 0; |
| 1498 | int i = 0; |
| 1499 | PyObject *otimeout = NULL; |
| 1500 | PyObject *ch = NULL; |
| 1501 | PyObject *it = NULL, *ei = NULL; |
| 1502 | PyObject *result = NULL; |
| 1503 | struct kevent *evl = NULL; |
| 1504 | struct kevent *chl = NULL; |
| 1505 | struct timespec timeoutspec; |
| 1506 | struct timespec *ptimeoutspec; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1507 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1508 | if (self->kqfd < 0) |
| 1509 | return kqueue_queue_err_closed(); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1510 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1511 | if (!PyArg_ParseTuple(args, "Oi|O:control", &ch, &nevents, &otimeout)) |
| 1512 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1513 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1514 | if (nevents < 0) { |
| 1515 | PyErr_Format(PyExc_ValueError, |
| 1516 | "Length of eventlist must be 0 or positive, got %d", |
| 1517 | nevents); |
| 1518 | return NULL; |
| 1519 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1520 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1521 | if (otimeout == Py_None || otimeout == NULL) { |
| 1522 | ptimeoutspec = NULL; |
| 1523 | } |
| 1524 | else if (PyNumber_Check(otimeout)) { |
| 1525 | double timeout; |
| 1526 | long seconds; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1527 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1528 | timeout = PyFloat_AsDouble(otimeout); |
| 1529 | if (timeout == -1 && PyErr_Occurred()) |
| 1530 | return NULL; |
| 1531 | if (timeout > (double)LONG_MAX) { |
| 1532 | PyErr_SetString(PyExc_OverflowError, |
| 1533 | "timeout period too long"); |
| 1534 | return NULL; |
| 1535 | } |
| 1536 | if (timeout < 0) { |
| 1537 | PyErr_SetString(PyExc_ValueError, |
| 1538 | "timeout must be positive or None"); |
| 1539 | return NULL; |
| 1540 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1541 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1542 | seconds = (long)timeout; |
| 1543 | timeout = timeout - (double)seconds; |
| 1544 | timeoutspec.tv_sec = seconds; |
| 1545 | timeoutspec.tv_nsec = (long)(timeout * 1E9); |
| 1546 | ptimeoutspec = &timeoutspec; |
| 1547 | } |
| 1548 | else { |
| 1549 | PyErr_Format(PyExc_TypeError, |
| 1550 | "timeout argument must be an number " |
| 1551 | "or None, got %.200s", |
| 1552 | Py_TYPE(otimeout)->tp_name); |
| 1553 | return NULL; |
| 1554 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1555 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1556 | if (ch != NULL && ch != Py_None) { |
| 1557 | it = PyObject_GetIter(ch); |
| 1558 | if (it == NULL) { |
| 1559 | PyErr_SetString(PyExc_TypeError, |
| 1560 | "changelist is not iterable"); |
| 1561 | return NULL; |
| 1562 | } |
| 1563 | nchanges = PyObject_Size(ch); |
| 1564 | if (nchanges < 0) { |
| 1565 | goto error; |
| 1566 | } |
Georg Brandl | c0e22b7 | 2010-03-14 10:51:01 +0000 | [diff] [blame] | 1567 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1568 | chl = PyMem_New(struct kevent, nchanges); |
| 1569 | if (chl == NULL) { |
| 1570 | PyErr_NoMemory(); |
| 1571 | goto error; |
| 1572 | } |
| 1573 | i = 0; |
| 1574 | while ((ei = PyIter_Next(it)) != NULL) { |
| 1575 | if (!kqueue_event_Check(ei)) { |
| 1576 | Py_DECREF(ei); |
| 1577 | PyErr_SetString(PyExc_TypeError, |
| 1578 | "changelist must be an iterable of " |
| 1579 | "select.kevent objects"); |
| 1580 | goto error; |
| 1581 | } else { |
| 1582 | chl[i++] = ((kqueue_event_Object *)ei)->e; |
| 1583 | } |
| 1584 | Py_DECREF(ei); |
| 1585 | } |
| 1586 | } |
| 1587 | Py_CLEAR(it); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1588 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1589 | /* event list */ |
| 1590 | if (nevents) { |
| 1591 | evl = PyMem_New(struct kevent, nevents); |
| 1592 | if (evl == NULL) { |
| 1593 | PyErr_NoMemory(); |
| 1594 | goto error; |
| 1595 | } |
| 1596 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1597 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1598 | Py_BEGIN_ALLOW_THREADS |
| 1599 | gotevents = kevent(self->kqfd, chl, nchanges, |
| 1600 | evl, nevents, ptimeoutspec); |
| 1601 | Py_END_ALLOW_THREADS |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1602 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1603 | if (gotevents == -1) { |
| 1604 | PyErr_SetFromErrno(PyExc_OSError); |
| 1605 | goto error; |
| 1606 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1607 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1608 | result = PyList_New(gotevents); |
| 1609 | if (result == NULL) { |
| 1610 | goto error; |
| 1611 | } |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1612 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1613 | for (i = 0; i < gotevents; i++) { |
| 1614 | kqueue_event_Object *ch; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1615 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1616 | ch = PyObject_New(kqueue_event_Object, &kqueue_event_Type); |
| 1617 | if (ch == NULL) { |
| 1618 | goto error; |
| 1619 | } |
| 1620 | ch->e = evl[i]; |
| 1621 | PyList_SET_ITEM(result, i, (PyObject *)ch); |
| 1622 | } |
| 1623 | PyMem_Free(chl); |
| 1624 | PyMem_Free(evl); |
| 1625 | return result; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1626 | |
| 1627 | error: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1628 | PyMem_Free(chl); |
| 1629 | PyMem_Free(evl); |
| 1630 | Py_XDECREF(result); |
| 1631 | Py_XDECREF(it); |
| 1632 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1633 | } |
| 1634 | |
| 1635 | PyDoc_STRVAR(kqueue_queue_control_doc, |
Benjamin Peterson | 9bc9351 | 2008-09-22 22:10:59 +0000 | [diff] [blame] | 1636 | "control(changelist, max_events[, timeout=None]) -> eventlist\n\ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1637 | \n\ |
| 1638 | Calls the kernel kevent function.\n\ |
| 1639 | - changelist must be a list of kevent objects describing the changes\n\ |
| 1640 | to be made to the kernel's watch list or None.\n\ |
| 1641 | - max_events lets you specify the maximum number of events that the\n\ |
| 1642 | kernel will return.\n\ |
| 1643 | - timeout is the maximum time to wait in seconds, or else None,\n\ |
| 1644 | to wait forever. timeout accepts floats for smaller timeouts, too."); |
| 1645 | |
| 1646 | |
| 1647 | static PyMethodDef kqueue_queue_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1648 | {"fromfd", (PyCFunction)kqueue_queue_fromfd, |
| 1649 | METH_VARARGS | METH_CLASS, kqueue_queue_fromfd_doc}, |
| 1650 | {"close", (PyCFunction)kqueue_queue_close, METH_NOARGS, |
| 1651 | kqueue_queue_close_doc}, |
| 1652 | {"fileno", (PyCFunction)kqueue_queue_fileno, METH_NOARGS, |
| 1653 | kqueue_queue_fileno_doc}, |
| 1654 | {"control", (PyCFunction)kqueue_queue_control, |
| 1655 | METH_VARARGS , kqueue_queue_control_doc}, |
| 1656 | {NULL, NULL}, |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1657 | }; |
| 1658 | |
| 1659 | static PyGetSetDef kqueue_queue_getsetlist[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1660 | {"closed", (getter)kqueue_queue_get_closed, NULL, |
| 1661 | "True if the kqueue handler is closed"}, |
| 1662 | {0}, |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1663 | }; |
| 1664 | |
| 1665 | PyDoc_STRVAR(kqueue_queue_doc, |
| 1666 | "Kqueue syscall wrapper.\n\ |
| 1667 | \n\ |
| 1668 | For example, to start watching a socket for input:\n\ |
| 1669 | >>> kq = kqueue()\n\ |
| 1670 | >>> sock = socket()\n\ |
| 1671 | >>> sock.connect((host, port))\n\ |
| 1672 | >>> kq.control([kevent(sock, KQ_FILTER_WRITE, KQ_EV_ADD)], 0)\n\ |
| 1673 | \n\ |
| 1674 | To wait one second for it to become writeable:\n\ |
| 1675 | >>> kq.control(None, 1, 1000)\n\ |
| 1676 | \n\ |
| 1677 | To stop listening:\n\ |
| 1678 | >>> kq.control([kevent(sock, KQ_FILTER_WRITE, KQ_EV_DELETE)], 0)"); |
| 1679 | |
| 1680 | static PyTypeObject kqueue_queue_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1681 | PyVarObject_HEAD_INIT(NULL, 0) |
| 1682 | "select.kqueue", /* tp_name */ |
| 1683 | sizeof(kqueue_queue_Object), /* tp_basicsize */ |
| 1684 | 0, /* tp_itemsize */ |
| 1685 | (destructor)kqueue_queue_dealloc, /* tp_dealloc */ |
| 1686 | 0, /* tp_print */ |
| 1687 | 0, /* tp_getattr */ |
| 1688 | 0, /* tp_setattr */ |
| 1689 | 0, /* tp_reserved */ |
| 1690 | 0, /* tp_repr */ |
| 1691 | 0, /* tp_as_number */ |
| 1692 | 0, /* tp_as_sequence */ |
| 1693 | 0, /* tp_as_mapping */ |
| 1694 | 0, /* tp_hash */ |
| 1695 | 0, /* tp_call */ |
| 1696 | 0, /* tp_str */ |
| 1697 | 0, /* tp_getattro */ |
| 1698 | 0, /* tp_setattro */ |
| 1699 | 0, /* tp_as_buffer */ |
| 1700 | Py_TPFLAGS_DEFAULT, /* tp_flags */ |
| 1701 | kqueue_queue_doc, /* tp_doc */ |
| 1702 | 0, /* tp_traverse */ |
| 1703 | 0, /* tp_clear */ |
| 1704 | 0, /* tp_richcompare */ |
| 1705 | 0, /* tp_weaklistoffset */ |
| 1706 | 0, /* tp_iter */ |
| 1707 | 0, /* tp_iternext */ |
| 1708 | kqueue_queue_methods, /* tp_methods */ |
| 1709 | 0, /* tp_members */ |
| 1710 | kqueue_queue_getsetlist, /* tp_getset */ |
| 1711 | 0, /* tp_base */ |
| 1712 | 0, /* tp_dict */ |
| 1713 | 0, /* tp_descr_get */ |
| 1714 | 0, /* tp_descr_set */ |
| 1715 | 0, /* tp_dictoffset */ |
| 1716 | 0, /* tp_init */ |
| 1717 | 0, /* tp_alloc */ |
| 1718 | kqueue_queue_new, /* tp_new */ |
| 1719 | 0, /* tp_free */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1720 | }; |
| 1721 | |
| 1722 | #endif /* HAVE_KQUEUE */ |
| 1723 | /* ************************************************************************ */ |
| 1724 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1725 | PyDoc_STRVAR(select_doc, |
Guido van Rossum | 1d8fb2d | 1998-06-28 16:54:49 +0000 | [diff] [blame] | 1726 | "select(rlist, wlist, xlist[, timeout]) -> (rlist, wlist, xlist)\n\ |
| 1727 | \n\ |
| 1728 | Wait until one or more file descriptors are ready for some kind of I/O.\n\ |
Brett Cannon | 62dba4c | 2003-09-10 19:37:42 +0000 | [diff] [blame] | 1729 | The first three arguments are sequences of file descriptors to be waited for:\n\ |
Guido van Rossum | 1d8fb2d | 1998-06-28 16:54:49 +0000 | [diff] [blame] | 1730 | rlist -- wait until ready for reading\n\ |
| 1731 | wlist -- wait until ready for writing\n\ |
| 1732 | xlist -- wait for an ``exceptional condition''\n\ |
| 1733 | If only one kind of condition is required, pass [] for the other lists.\n\ |
| 1734 | A file descriptor is either a socket or file object, or a small integer\n\ |
| 1735 | gotten from a fileno() method call on one of those.\n\ |
| 1736 | \n\ |
| 1737 | The optional 4th argument specifies a timeout in seconds; it may be\n\ |
| 1738 | a floating point number to specify fractions of seconds. If it is absent\n\ |
| 1739 | or None, the call will never time out.\n\ |
| 1740 | \n\ |
| 1741 | The return value is a tuple of three lists corresponding to the first three\n\ |
| 1742 | arguments; each contains the subset of the corresponding file descriptors\n\ |
| 1743 | that are ready.\n\ |
| 1744 | \n\ |
| 1745 | *** IMPORTANT NOTICE ***\n\ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1746 | On Windows and OpenVMS, only sockets are supported; on Unix, all file\n\ |
Christian Heimes | f6cd967 | 2008-03-26 13:45:42 +0000 | [diff] [blame] | 1747 | descriptors can be used."); |
Guido van Rossum | 1d8fb2d | 1998-06-28 16:54:49 +0000 | [diff] [blame] | 1748 | |
Barry Warsaw | e4ac0aa | 1996-12-12 00:04:35 +0000 | [diff] [blame] | 1749 | static PyMethodDef select_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1750 | {"select", select_select, METH_VARARGS, select_doc}, |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1751 | #ifdef HAVE_POLL |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1752 | {"poll", select_poll, METH_NOARGS, poll_doc}, |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1753 | #endif /* HAVE_POLL */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1754 | {0, 0}, /* sentinel */ |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 1755 | }; |
| 1756 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1757 | PyDoc_STRVAR(module_doc, |
Guido van Rossum | 1d8fb2d | 1998-06-28 16:54:49 +0000 | [diff] [blame] | 1758 | "This module supports asynchronous I/O on multiple file descriptors.\n\ |
| 1759 | \n\ |
| 1760 | *** IMPORTANT NOTICE ***\n\ |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 1761 | On Windows and OpenVMS, only sockets are supported; on Unix, all file descriptors."); |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 1762 | |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 1763 | |
| 1764 | static struct PyModuleDef selectmodule = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1765 | PyModuleDef_HEAD_INIT, |
| 1766 | "select", |
| 1767 | module_doc, |
| 1768 | -1, |
| 1769 | select_methods, |
| 1770 | NULL, |
| 1771 | NULL, |
| 1772 | NULL, |
| 1773 | NULL |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 1774 | }; |
| 1775 | |
Mark Hammond | 62b1ab1 | 2002-07-23 06:31:15 +0000 | [diff] [blame] | 1776 | PyMODINIT_FUNC |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 1777 | PyInit_select(void) |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 1778 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1779 | PyObject *m; |
| 1780 | m = PyModule_Create(&selectmodule); |
| 1781 | if (m == NULL) |
| 1782 | return NULL; |
Fred Drake | 4baedc1 | 2002-04-01 14:53:37 +0000 | [diff] [blame] | 1783 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1784 | SelectError = PyErr_NewException("select.error", NULL, NULL); |
| 1785 | Py_INCREF(SelectError); |
| 1786 | PyModule_AddObject(m, "error", SelectError); |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1787 | |
Amaury Forgeot d'Arc | ace3102 | 2009-07-09 22:44:11 +0000 | [diff] [blame] | 1788 | #ifdef PIPE_BUF |
R. David Murray | e16cda9 | 2010-10-15 23:12:57 +0000 | [diff] [blame] | 1789 | #ifdef HAVE_BROKEN_PIPE_BUF |
| 1790 | #undef PIPE_BUF |
| 1791 | #define PIPE_BUF 512 |
| 1792 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1793 | PyModule_AddIntConstant(m, "PIPE_BUF", PIPE_BUF); |
Amaury Forgeot d'Arc | ace3102 | 2009-07-09 22:44:11 +0000 | [diff] [blame] | 1794 | #endif |
Gregory P. Smith | b970b86 | 2009-07-04 02:28:47 +0000 | [diff] [blame] | 1795 | |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1796 | #if defined(HAVE_POLL) |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1797 | #ifdef __APPLE__ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1798 | if (select_have_broken_poll()) { |
| 1799 | if (PyObject_DelAttrString(m, "poll") == -1) { |
| 1800 | PyErr_Clear(); |
| 1801 | } |
| 1802 | } else { |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1803 | #else |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1804 | { |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1805 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1806 | if (PyType_Ready(&poll_Type) < 0) |
| 1807 | return NULL; |
| 1808 | PyModule_AddIntConstant(m, "POLLIN", POLLIN); |
| 1809 | PyModule_AddIntConstant(m, "POLLPRI", POLLPRI); |
| 1810 | PyModule_AddIntConstant(m, "POLLOUT", POLLOUT); |
| 1811 | PyModule_AddIntConstant(m, "POLLERR", POLLERR); |
| 1812 | PyModule_AddIntConstant(m, "POLLHUP", POLLHUP); |
| 1813 | PyModule_AddIntConstant(m, "POLLNVAL", POLLNVAL); |
Andrew M. Kuchling | cf96dc8 | 2000-08-25 01:15:33 +0000 | [diff] [blame] | 1814 | |
Andrew M. Kuchling | 36d97eb | 2000-09-28 21:33:44 +0000 | [diff] [blame] | 1815 | #ifdef POLLRDNORM |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1816 | PyModule_AddIntConstant(m, "POLLRDNORM", POLLRDNORM); |
Andrew M. Kuchling | 36d97eb | 2000-09-28 21:33:44 +0000 | [diff] [blame] | 1817 | #endif |
| 1818 | #ifdef POLLRDBAND |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1819 | PyModule_AddIntConstant(m, "POLLRDBAND", POLLRDBAND); |
Andrew M. Kuchling | 36d97eb | 2000-09-28 21:33:44 +0000 | [diff] [blame] | 1820 | #endif |
| 1821 | #ifdef POLLWRNORM |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1822 | PyModule_AddIntConstant(m, "POLLWRNORM", POLLWRNORM); |
Andrew M. Kuchling | 36d97eb | 2000-09-28 21:33:44 +0000 | [diff] [blame] | 1823 | #endif |
| 1824 | #ifdef POLLWRBAND |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1825 | PyModule_AddIntConstant(m, "POLLWRBAND", POLLWRBAND); |
Andrew M. Kuchling | 36d97eb | 2000-09-28 21:33:44 +0000 | [diff] [blame] | 1826 | #endif |
Sjoerd Mullender | 239f836 | 2000-08-25 13:59:18 +0000 | [diff] [blame] | 1827 | #ifdef POLLMSG |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1828 | PyModule_AddIntConstant(m, "POLLMSG", POLLMSG); |
Sjoerd Mullender | 239f836 | 2000-08-25 13:59:18 +0000 | [diff] [blame] | 1829 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1830 | } |
Thomas Wouters | 477c8d5 | 2006-05-27 19:21:47 +0000 | [diff] [blame] | 1831 | #endif /* HAVE_POLL */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1832 | |
| 1833 | #ifdef HAVE_EPOLL |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1834 | Py_TYPE(&pyEpoll_Type) = &PyType_Type; |
| 1835 | if (PyType_Ready(&pyEpoll_Type) < 0) |
| 1836 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1837 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1838 | Py_INCREF(&pyEpoll_Type); |
| 1839 | PyModule_AddObject(m, "epoll", (PyObject *) &pyEpoll_Type); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1840 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1841 | PyModule_AddIntConstant(m, "EPOLLIN", EPOLLIN); |
| 1842 | PyModule_AddIntConstant(m, "EPOLLOUT", EPOLLOUT); |
| 1843 | PyModule_AddIntConstant(m, "EPOLLPRI", EPOLLPRI); |
| 1844 | PyModule_AddIntConstant(m, "EPOLLERR", EPOLLERR); |
| 1845 | PyModule_AddIntConstant(m, "EPOLLHUP", EPOLLHUP); |
| 1846 | PyModule_AddIntConstant(m, "EPOLLET", EPOLLET); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1847 | #ifdef EPOLLONESHOT |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1848 | /* Kernel 2.6.2+ */ |
| 1849 | PyModule_AddIntConstant(m, "EPOLLONESHOT", EPOLLONESHOT); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1850 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1851 | /* PyModule_AddIntConstant(m, "EPOLL_RDHUP", EPOLLRDHUP); */ |
| 1852 | PyModule_AddIntConstant(m, "EPOLLRDNORM", EPOLLRDNORM); |
| 1853 | PyModule_AddIntConstant(m, "EPOLLRDBAND", EPOLLRDBAND); |
| 1854 | PyModule_AddIntConstant(m, "EPOLLWRNORM", EPOLLWRNORM); |
| 1855 | PyModule_AddIntConstant(m, "EPOLLWRBAND", EPOLLWRBAND); |
| 1856 | PyModule_AddIntConstant(m, "EPOLLMSG", EPOLLMSG); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1857 | #endif /* HAVE_EPOLL */ |
| 1858 | |
| 1859 | #ifdef HAVE_KQUEUE |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1860 | kqueue_event_Type.tp_new = PyType_GenericNew; |
| 1861 | Py_TYPE(&kqueue_event_Type) = &PyType_Type; |
| 1862 | if(PyType_Ready(&kqueue_event_Type) < 0) |
| 1863 | return NULL; |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1864 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1865 | Py_INCREF(&kqueue_event_Type); |
| 1866 | PyModule_AddObject(m, "kevent", (PyObject *)&kqueue_event_Type); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1867 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1868 | Py_TYPE(&kqueue_queue_Type) = &PyType_Type; |
| 1869 | if(PyType_Ready(&kqueue_queue_Type) < 0) |
| 1870 | return NULL; |
| 1871 | Py_INCREF(&kqueue_queue_Type); |
| 1872 | PyModule_AddObject(m, "kqueue", (PyObject *)&kqueue_queue_Type); |
| 1873 | |
| 1874 | /* event filters */ |
| 1875 | PyModule_AddIntConstant(m, "KQ_FILTER_READ", EVFILT_READ); |
| 1876 | PyModule_AddIntConstant(m, "KQ_FILTER_WRITE", EVFILT_WRITE); |
| 1877 | PyModule_AddIntConstant(m, "KQ_FILTER_AIO", EVFILT_AIO); |
| 1878 | PyModule_AddIntConstant(m, "KQ_FILTER_VNODE", EVFILT_VNODE); |
| 1879 | PyModule_AddIntConstant(m, "KQ_FILTER_PROC", EVFILT_PROC); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1880 | #ifdef EVFILT_NETDEV |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1881 | PyModule_AddIntConstant(m, "KQ_FILTER_NETDEV", EVFILT_NETDEV); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1882 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1883 | PyModule_AddIntConstant(m, "KQ_FILTER_SIGNAL", EVFILT_SIGNAL); |
| 1884 | PyModule_AddIntConstant(m, "KQ_FILTER_TIMER", EVFILT_TIMER); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1885 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1886 | /* event flags */ |
| 1887 | PyModule_AddIntConstant(m, "KQ_EV_ADD", EV_ADD); |
| 1888 | PyModule_AddIntConstant(m, "KQ_EV_DELETE", EV_DELETE); |
| 1889 | PyModule_AddIntConstant(m, "KQ_EV_ENABLE", EV_ENABLE); |
| 1890 | PyModule_AddIntConstant(m, "KQ_EV_DISABLE", EV_DISABLE); |
| 1891 | PyModule_AddIntConstant(m, "KQ_EV_ONESHOT", EV_ONESHOT); |
| 1892 | PyModule_AddIntConstant(m, "KQ_EV_CLEAR", EV_CLEAR); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1893 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1894 | PyModule_AddIntConstant(m, "KQ_EV_SYSFLAGS", EV_SYSFLAGS); |
| 1895 | PyModule_AddIntConstant(m, "KQ_EV_FLAG1", EV_FLAG1); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1896 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1897 | PyModule_AddIntConstant(m, "KQ_EV_EOF", EV_EOF); |
| 1898 | PyModule_AddIntConstant(m, "KQ_EV_ERROR", EV_ERROR); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1899 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1900 | /* READ WRITE filter flag */ |
| 1901 | PyModule_AddIntConstant(m, "KQ_NOTE_LOWAT", NOTE_LOWAT); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1902 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1903 | /* VNODE filter flags */ |
| 1904 | PyModule_AddIntConstant(m, "KQ_NOTE_DELETE", NOTE_DELETE); |
| 1905 | PyModule_AddIntConstant(m, "KQ_NOTE_WRITE", NOTE_WRITE); |
| 1906 | PyModule_AddIntConstant(m, "KQ_NOTE_EXTEND", NOTE_EXTEND); |
| 1907 | PyModule_AddIntConstant(m, "KQ_NOTE_ATTRIB", NOTE_ATTRIB); |
| 1908 | PyModule_AddIntConstant(m, "KQ_NOTE_LINK", NOTE_LINK); |
| 1909 | PyModule_AddIntConstant(m, "KQ_NOTE_RENAME", NOTE_RENAME); |
| 1910 | PyModule_AddIntConstant(m, "KQ_NOTE_REVOKE", NOTE_REVOKE); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1911 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1912 | /* PROC filter flags */ |
| 1913 | PyModule_AddIntConstant(m, "KQ_NOTE_EXIT", NOTE_EXIT); |
| 1914 | PyModule_AddIntConstant(m, "KQ_NOTE_FORK", NOTE_FORK); |
| 1915 | PyModule_AddIntConstant(m, "KQ_NOTE_EXEC", NOTE_EXEC); |
| 1916 | PyModule_AddIntConstant(m, "KQ_NOTE_PCTRLMASK", NOTE_PCTRLMASK); |
| 1917 | PyModule_AddIntConstant(m, "KQ_NOTE_PDATAMASK", NOTE_PDATAMASK); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1918 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1919 | PyModule_AddIntConstant(m, "KQ_NOTE_TRACK", NOTE_TRACK); |
| 1920 | PyModule_AddIntConstant(m, "KQ_NOTE_CHILD", NOTE_CHILD); |
| 1921 | PyModule_AddIntConstant(m, "KQ_NOTE_TRACKERR", NOTE_TRACKERR); |
| 1922 | |
| 1923 | /* NETDEV filter flags */ |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1924 | #ifdef EVFILT_NETDEV |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1925 | PyModule_AddIntConstant(m, "KQ_NOTE_LINKUP", NOTE_LINKUP); |
| 1926 | PyModule_AddIntConstant(m, "KQ_NOTE_LINKDOWN", NOTE_LINKDOWN); |
| 1927 | PyModule_AddIntConstant(m, "KQ_NOTE_LINKINV", NOTE_LINKINV); |
Christian Heimes | 4fbc72b | 2008-03-22 00:47:35 +0000 | [diff] [blame] | 1928 | #endif |
| 1929 | |
| 1930 | #endif /* HAVE_KQUEUE */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1931 | return m; |
Guido van Rossum | ed233a5 | 1992-06-23 09:07:03 +0000 | [diff] [blame] | 1932 | } |