Yury Selivanov | b0b0e62 | 2014-02-18 22:27:48 -0500 | [diff] [blame] | 1 | """Selector and proactor event loops for Windows.""" |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 2 | |
Victor Stinner | 4271dfd | 2017-11-28 15:19:56 +0100 | [diff] [blame] | 3 | import _overlapped |
Victor Stinner | f2e1768 | 2014-01-31 16:25:24 +0100 | [diff] [blame] | 4 | import _winapi |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 5 | import errno |
Victor Stinner | f2e1768 | 2014-01-31 16:25:24 +0100 | [diff] [blame] | 6 | import math |
Andrew Svetlov | a19fb3c | 2018-02-25 19:32:14 +0300 | [diff] [blame] | 7 | import msvcrt |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 8 | import socket |
Victor Stinner | f2e1768 | 2014-01-31 16:25:24 +0100 | [diff] [blame] | 9 | import struct |
Victor Stinner | b1e4573 | 2019-01-15 11:48:00 +0100 | [diff] [blame] | 10 | import time |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 11 | import weakref |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 12 | |
Guido van Rossum | 0eaa5ac | 2013-11-04 15:50:46 -0800 | [diff] [blame] | 13 | from . import events |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 14 | from . import base_subprocess |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 15 | from . import futures |
Andrew Svetlov | 0baa72f | 2018-09-11 10:13:04 -0700 | [diff] [blame] | 16 | from . import exceptions |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 17 | from . import proactor_events |
| 18 | from . import selector_events |
| 19 | from . import tasks |
| 20 | from . import windows_utils |
Victor Stinner | f951d28 | 2014-06-29 00:46:45 +0200 | [diff] [blame] | 21 | from .log import logger |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 22 | |
| 23 | |
Yury Selivanov | 6370f34 | 2017-12-10 18:36:12 -0500 | [diff] [blame] | 24 | __all__ = ( |
| 25 | 'SelectorEventLoop', 'ProactorEventLoop', 'IocpProactor', |
Yury Selivanov | 8f40429 | 2018-06-07 20:44:57 -0400 | [diff] [blame] | 26 | 'DefaultEventLoopPolicy', 'WindowsSelectorEventLoopPolicy', |
| 27 | 'WindowsProactorEventLoopPolicy', |
Yury Selivanov | 6370f34 | 2017-12-10 18:36:12 -0500 | [diff] [blame] | 28 | ) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 29 | |
| 30 | |
| 31 | NULL = 0 |
| 32 | INFINITE = 0xffffffff |
| 33 | ERROR_CONNECTION_REFUSED = 1225 |
| 34 | ERROR_CONNECTION_ABORTED = 1236 |
| 35 | |
Victor Stinner | 7ffa2c5 | 2015-01-22 22:55:08 +0100 | [diff] [blame] | 36 | # Initial delay in seconds for connect_pipe() before retrying to connect |
| 37 | CONNECT_PIPE_INIT_DELAY = 0.001 |
| 38 | |
| 39 | # Maximum delay in seconds for connect_pipe() before retrying to connect |
| 40 | CONNECT_PIPE_MAX_DELAY = 0.100 |
| 41 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 42 | |
| 43 | class _OverlappedFuture(futures.Future): |
| 44 | """Subclass of Future which represents an overlapped operation. |
| 45 | |
| 46 | Cancelling it will immediately cancel the overlapped operation. |
| 47 | """ |
| 48 | |
| 49 | def __init__(self, ov, *, loop=None): |
| 50 | super().__init__(loop=loop) |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 51 | if self._source_traceback: |
| 52 | del self._source_traceback[-1] |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 53 | self._ov = ov |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 54 | |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 55 | def _repr_info(self): |
| 56 | info = super()._repr_info() |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 57 | if self._ov is not None: |
| 58 | state = 'pending' if self._ov.pending else 'completed' |
Yury Selivanov | 6370f34 | 2017-12-10 18:36:12 -0500 | [diff] [blame] | 59 | info.insert(1, f'overlapped=<{state}, {self._ov.address:#x}>') |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 60 | return info |
Victor Stinner | e912e65 | 2014-07-12 03:11:53 +0200 | [diff] [blame] | 61 | |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 62 | def _cancel_overlapped(self): |
| 63 | if self._ov is None: |
| 64 | return |
| 65 | try: |
| 66 | self._ov.cancel() |
| 67 | except OSError as exc: |
| 68 | context = { |
| 69 | 'message': 'Cancelling an overlapped future failed', |
| 70 | 'exception': exc, |
| 71 | 'future': self, |
| 72 | } |
| 73 | if self._source_traceback: |
| 74 | context['source_traceback'] = self._source_traceback |
| 75 | self._loop.call_exception_handler(context) |
| 76 | self._ov = None |
| 77 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 78 | def cancel(self): |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 79 | self._cancel_overlapped() |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 80 | return super().cancel() |
| 81 | |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 82 | def set_exception(self, exception): |
| 83 | super().set_exception(exception) |
| 84 | self._cancel_overlapped() |
| 85 | |
Victor Stinner | 51e44ea | 2014-07-26 00:58:34 +0200 | [diff] [blame] | 86 | def set_result(self, result): |
| 87 | super().set_result(result) |
| 88 | self._ov = None |
| 89 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 90 | |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 91 | class _BaseWaitHandleFuture(futures.Future): |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 92 | """Subclass of Future which represents a wait handle.""" |
| 93 | |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 94 | def __init__(self, ov, handle, wait_handle, *, loop=None): |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 95 | super().__init__(loop=loop) |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 96 | if self._source_traceback: |
| 97 | del self._source_traceback[-1] |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 98 | # Keep a reference to the Overlapped object to keep it alive until the |
| 99 | # wait is unregistered |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 100 | self._ov = ov |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 101 | self._handle = handle |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 102 | self._wait_handle = wait_handle |
| 103 | |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 104 | # Should we call UnregisterWaitEx() if the wait completes |
| 105 | # or is cancelled? |
| 106 | self._registered = True |
| 107 | |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 108 | def _poll(self): |
| 109 | # non-blocking wait: use a timeout of 0 millisecond |
| 110 | return (_winapi.WaitForSingleObject(self._handle, 0) == |
| 111 | _winapi.WAIT_OBJECT_0) |
| 112 | |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 113 | def _repr_info(self): |
| 114 | info = super()._repr_info() |
Yury Selivanov | 6370f34 | 2017-12-10 18:36:12 -0500 | [diff] [blame] | 115 | info.append(f'handle={self._handle:#x}') |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 116 | if self._handle is not None: |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 117 | state = 'signaled' if self._poll() else 'waiting' |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 118 | info.append(state) |
| 119 | if self._wait_handle is not None: |
Yury Selivanov | 6370f34 | 2017-12-10 18:36:12 -0500 | [diff] [blame] | 120 | info.append(f'wait_handle={self._wait_handle:#x}') |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 121 | return info |
Victor Stinner | 18a28dc | 2014-07-25 13:05:20 +0200 | [diff] [blame] | 122 | |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 123 | def _unregister_wait_cb(self, fut): |
| 124 | # The wait was unregistered: it's not safe to destroy the Overlapped |
| 125 | # object |
| 126 | self._ov = None |
| 127 | |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 128 | def _unregister_wait(self): |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 129 | if not self._registered: |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 130 | return |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 131 | self._registered = False |
| 132 | |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 133 | wait_handle = self._wait_handle |
| 134 | self._wait_handle = None |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 135 | try: |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 136 | _overlapped.UnregisterWait(wait_handle) |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 137 | except OSError as exc: |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 138 | if exc.winerror != _overlapped.ERROR_IO_PENDING: |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 139 | context = { |
| 140 | 'message': 'Failed to unregister the wait handle', |
| 141 | 'exception': exc, |
| 142 | 'future': self, |
| 143 | } |
| 144 | if self._source_traceback: |
| 145 | context['source_traceback'] = self._source_traceback |
| 146 | self._loop.call_exception_handler(context) |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 147 | return |
| 148 | # ERROR_IO_PENDING means that the unregister is pending |
| 149 | |
| 150 | self._unregister_wait_cb(None) |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 151 | |
| 152 | def cancel(self): |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 153 | self._unregister_wait() |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 154 | return super().cancel() |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 155 | |
| 156 | def set_exception(self, exception): |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 157 | self._unregister_wait() |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 158 | super().set_exception(exception) |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 159 | |
| 160 | def set_result(self, result): |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 161 | self._unregister_wait() |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 162 | super().set_result(result) |
| 163 | |
| 164 | |
| 165 | class _WaitCancelFuture(_BaseWaitHandleFuture): |
| 166 | """Subclass of Future which represents a wait for the cancellation of a |
| 167 | _WaitHandleFuture using an event. |
| 168 | """ |
| 169 | |
| 170 | def __init__(self, ov, event, wait_handle, *, loop=None): |
| 171 | super().__init__(ov, event, wait_handle, loop=loop) |
| 172 | |
| 173 | self._done_callback = None |
| 174 | |
Victor Stinner | 1ca9392 | 2015-01-22 00:17:54 +0100 | [diff] [blame] | 175 | def cancel(self): |
| 176 | raise RuntimeError("_WaitCancelFuture must not be cancelled") |
| 177 | |
INADA Naoki | a836362 | 2016-10-21 12:30:15 +0900 | [diff] [blame] | 178 | def set_result(self, result): |
| 179 | super().set_result(result) |
| 180 | if self._done_callback is not None: |
| 181 | self._done_callback(self) |
| 182 | |
| 183 | def set_exception(self, exception): |
| 184 | super().set_exception(exception) |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 185 | if self._done_callback is not None: |
| 186 | self._done_callback(self) |
| 187 | |
| 188 | |
| 189 | class _WaitHandleFuture(_BaseWaitHandleFuture): |
| 190 | def __init__(self, ov, handle, wait_handle, proactor, *, loop=None): |
| 191 | super().__init__(ov, handle, wait_handle, loop=loop) |
| 192 | self._proactor = proactor |
| 193 | self._unregister_proactor = True |
| 194 | self._event = _overlapped.CreateEvent(None, True, False, None) |
| 195 | self._event_fut = None |
| 196 | |
| 197 | def _unregister_wait_cb(self, fut): |
| 198 | if self._event is not None: |
| 199 | _winapi.CloseHandle(self._event) |
| 200 | self._event = None |
| 201 | self._event_fut = None |
| 202 | |
| 203 | # If the wait was cancelled, the wait may never be signalled, so |
| 204 | # it's required to unregister it. Otherwise, IocpProactor.close() will |
| 205 | # wait forever for an event which will never come. |
| 206 | # |
| 207 | # If the IocpProactor already received the event, it's safe to call |
| 208 | # _unregister() because we kept a reference to the Overlapped object |
Martin Panter | 6245cb3 | 2016-04-15 02:14:19 +0000 | [diff] [blame] | 209 | # which is used as a unique key. |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 210 | self._proactor._unregister(self._ov) |
| 211 | self._proactor = None |
| 212 | |
| 213 | super()._unregister_wait_cb(fut) |
| 214 | |
| 215 | def _unregister_wait(self): |
| 216 | if not self._registered: |
| 217 | return |
| 218 | self._registered = False |
| 219 | |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 220 | wait_handle = self._wait_handle |
| 221 | self._wait_handle = None |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 222 | try: |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 223 | _overlapped.UnregisterWaitEx(wait_handle, self._event) |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 224 | except OSError as exc: |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 225 | if exc.winerror != _overlapped.ERROR_IO_PENDING: |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 226 | context = { |
| 227 | 'message': 'Failed to unregister the wait handle', |
| 228 | 'exception': exc, |
| 229 | 'future': self, |
| 230 | } |
| 231 | if self._source_traceback: |
| 232 | context['source_traceback'] = self._source_traceback |
| 233 | self._loop.call_exception_handler(context) |
Victor Stinner | 24dfa3c | 2015-01-26 22:30:28 +0100 | [diff] [blame] | 234 | return |
| 235 | # ERROR_IO_PENDING is not an error, the wait was unregistered |
| 236 | |
| 237 | self._event_fut = self._proactor._wait_cancel(self._event, |
| 238 | self._unregister_wait_cb) |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 239 | |
| 240 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 241 | class PipeServer(object): |
| 242 | """Class representing a pipe server. |
| 243 | |
| 244 | This is much like a bound, listening socket. |
| 245 | """ |
| 246 | def __init__(self, address): |
| 247 | self._address = address |
| 248 | self._free_instances = weakref.WeakSet() |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 249 | # initialize the pipe attribute before calling _server_pipe_handle() |
| 250 | # because this function can raise an exception and the destructor calls |
| 251 | # the close() method |
| 252 | self._pipe = None |
| 253 | self._accept_pipe_future = None |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 254 | self._pipe = self._server_pipe_handle(True) |
| 255 | |
| 256 | def _get_unconnected_pipe(self): |
| 257 | # Create new instance and return previous one. This ensures |
| 258 | # that (until the server is closed) there is always at least |
| 259 | # one pipe handle for address. Therefore if a client attempt |
| 260 | # to connect it will not fail with FileNotFoundError. |
| 261 | tmp, self._pipe = self._pipe, self._server_pipe_handle(False) |
| 262 | return tmp |
| 263 | |
| 264 | def _server_pipe_handle(self, first): |
| 265 | # Return a wrapper for a new pipe handle. |
Victor Stinner | a19b7b3 | 2015-01-26 15:03:20 +0100 | [diff] [blame] | 266 | if self.closed(): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 267 | return None |
| 268 | flags = _winapi.PIPE_ACCESS_DUPLEX | _winapi.FILE_FLAG_OVERLAPPED |
| 269 | if first: |
| 270 | flags |= _winapi.FILE_FLAG_FIRST_PIPE_INSTANCE |
| 271 | h = _winapi.CreateNamedPipe( |
| 272 | self._address, flags, |
| 273 | _winapi.PIPE_TYPE_MESSAGE | _winapi.PIPE_READMODE_MESSAGE | |
| 274 | _winapi.PIPE_WAIT, |
| 275 | _winapi.PIPE_UNLIMITED_INSTANCES, |
| 276 | windows_utils.BUFSIZE, windows_utils.BUFSIZE, |
| 277 | _winapi.NMPWAIT_WAIT_FOREVER, _winapi.NULL) |
| 278 | pipe = windows_utils.PipeHandle(h) |
| 279 | self._free_instances.add(pipe) |
| 280 | return pipe |
| 281 | |
Victor Stinner | a19b7b3 | 2015-01-26 15:03:20 +0100 | [diff] [blame] | 282 | def closed(self): |
| 283 | return (self._address is None) |
| 284 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 285 | def close(self): |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 286 | if self._accept_pipe_future is not None: |
| 287 | self._accept_pipe_future.cancel() |
| 288 | self._accept_pipe_future = None |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 289 | # Close all instances which have not been connected to by a client. |
| 290 | if self._address is not None: |
| 291 | for pipe in self._free_instances: |
| 292 | pipe.close() |
| 293 | self._pipe = None |
| 294 | self._address = None |
| 295 | self._free_instances.clear() |
| 296 | |
| 297 | __del__ = close |
| 298 | |
| 299 | |
Guido van Rossum | 0eaa5ac | 2013-11-04 15:50:46 -0800 | [diff] [blame] | 300 | class _WindowsSelectorEventLoop(selector_events.BaseSelectorEventLoop): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 301 | """Windows version of selector event loop.""" |
| 302 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 303 | |
| 304 | class ProactorEventLoop(proactor_events.BaseProactorEventLoop): |
| 305 | """Windows version of proactor event loop using IOCP.""" |
| 306 | |
| 307 | def __init__(self, proactor=None): |
| 308 | if proactor is None: |
| 309 | proactor = IocpProactor() |
| 310 | super().__init__(proactor) |
| 311 | |
Vladimir Matveev | b5c8cfa | 2018-12-18 13:56:17 -0800 | [diff] [blame] | 312 | def run_forever(self): |
| 313 | try: |
| 314 | assert self._self_reading_future is None |
| 315 | self.call_soon(self._loop_self_reading) |
| 316 | super().run_forever() |
| 317 | finally: |
| 318 | if self._self_reading_future is not None: |
Vladimir Matveev | 67ba547 | 2019-01-05 12:44:59 -0800 | [diff] [blame] | 319 | ov = self._self_reading_future._ov |
Vladimir Matveev | b5c8cfa | 2018-12-18 13:56:17 -0800 | [diff] [blame] | 320 | self._self_reading_future.cancel() |
Vladimir Matveev | 67ba547 | 2019-01-05 12:44:59 -0800 | [diff] [blame] | 321 | # self_reading_future was just cancelled so it will never be signalled |
| 322 | # Unregister it otherwise IocpProactor.close will wait for it forever |
| 323 | if ov is not None: |
| 324 | self._proactor._unregister(ov) |
Vladimir Matveev | b5c8cfa | 2018-12-18 13:56:17 -0800 | [diff] [blame] | 325 | self._self_reading_future = None |
| 326 | |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 327 | async def create_pipe_connection(self, protocol_factory, address): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 328 | f = self._proactor.connect_pipe(address) |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 329 | pipe = await f |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 330 | protocol = protocol_factory() |
| 331 | trans = self._make_duplex_pipe_transport(pipe, protocol, |
| 332 | extra={'addr': address}) |
| 333 | return trans, protocol |
| 334 | |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 335 | async def start_serving_pipe(self, protocol_factory, address): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 336 | server = PipeServer(address) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 337 | |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 338 | def loop_accept_pipe(f=None): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 339 | pipe = None |
| 340 | try: |
| 341 | if f: |
| 342 | pipe = f.result() |
| 343 | server._free_instances.discard(pipe) |
Victor Stinner | a19b7b3 | 2015-01-26 15:03:20 +0100 | [diff] [blame] | 344 | |
| 345 | if server.closed(): |
| 346 | # A client connected before the server was closed: |
| 347 | # drop the client (close the pipe) and exit |
| 348 | pipe.close() |
| 349 | return |
| 350 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 351 | protocol = protocol_factory() |
| 352 | self._make_duplex_pipe_transport( |
| 353 | pipe, protocol, extra={'addr': address}) |
Victor Stinner | a19b7b3 | 2015-01-26 15:03:20 +0100 | [diff] [blame] | 354 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 355 | pipe = server._get_unconnected_pipe() |
| 356 | if pipe is None: |
| 357 | return |
Victor Stinner | a19b7b3 | 2015-01-26 15:03:20 +0100 | [diff] [blame] | 358 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 359 | f = self._proactor.accept_pipe(pipe) |
Yury Selivanov | ff827f0 | 2014-02-18 18:02:19 -0500 | [diff] [blame] | 360 | except OSError as exc: |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 361 | if pipe and pipe.fileno() != -1: |
Yury Selivanov | ff827f0 | 2014-02-18 18:02:19 -0500 | [diff] [blame] | 362 | self.call_exception_handler({ |
| 363 | 'message': 'Pipe accept failed', |
| 364 | 'exception': exc, |
| 365 | 'pipe': pipe, |
| 366 | }) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 367 | pipe.close() |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 368 | elif self._debug: |
| 369 | logger.warning("Accept pipe failed on pipe %r", |
| 370 | pipe, exc_info=True) |
Andrew Svetlov | 0baa72f | 2018-09-11 10:13:04 -0700 | [diff] [blame] | 371 | except exceptions.CancelledError: |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 372 | if pipe: |
| 373 | pipe.close() |
| 374 | else: |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 375 | server._accept_pipe_future = f |
| 376 | f.add_done_callback(loop_accept_pipe) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 377 | |
Victor Stinner | b261475 | 2014-08-25 23:20:52 +0200 | [diff] [blame] | 378 | self.call_soon(loop_accept_pipe) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 379 | return [server] |
| 380 | |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 381 | async def _make_subprocess_transport(self, protocol, args, shell, |
| 382 | stdin, stdout, stderr, bufsize, |
| 383 | extra=None, **kwargs): |
Yury Selivanov | 7661db6 | 2016-05-16 15:38:39 -0400 | [diff] [blame] | 384 | waiter = self.create_future() |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 385 | transp = _WindowsSubprocessTransport(self, protocol, args, shell, |
| 386 | stdin, stdout, stderr, bufsize, |
Victor Stinner | 47cd10d | 2015-01-30 00:05:19 +0100 | [diff] [blame] | 387 | waiter=waiter, extra=extra, |
| 388 | **kwargs) |
Victor Stinner | 4bf22e0 | 2015-01-15 14:24:22 +0100 | [diff] [blame] | 389 | try: |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 390 | await waiter |
Yury Selivanov | 431b540 | 2019-05-27 14:45:12 +0200 | [diff] [blame^] | 391 | except (SystemExit, KeyboardInterrupt): |
| 392 | raise |
| 393 | except BaseException: |
Victor Stinner | 4bf22e0 | 2015-01-15 14:24:22 +0100 | [diff] [blame] | 394 | transp.close() |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 395 | await transp._wait() |
| 396 | raise |
Victor Stinner | 4bf22e0 | 2015-01-15 14:24:22 +0100 | [diff] [blame] | 397 | |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 398 | return transp |
| 399 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 400 | |
| 401 | class IocpProactor: |
| 402 | """Proactor implementation using IOCP.""" |
| 403 | |
| 404 | def __init__(self, concurrency=0xffffffff): |
| 405 | self._loop = None |
| 406 | self._results = [] |
| 407 | self._iocp = _overlapped.CreateIoCompletionPort( |
| 408 | _overlapped.INVALID_HANDLE_VALUE, NULL, 0, concurrency) |
| 409 | self._cache = {} |
| 410 | self._registered = weakref.WeakSet() |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 411 | self._unregistered = [] |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 412 | self._stopped_serving = weakref.WeakSet() |
| 413 | |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 414 | def _check_closed(self): |
| 415 | if self._iocp is None: |
| 416 | raise RuntimeError('IocpProactor is closed') |
| 417 | |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 418 | def __repr__(self): |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 419 | info = ['overlapped#=%s' % len(self._cache), |
| 420 | 'result#=%s' % len(self._results)] |
| 421 | if self._iocp is None: |
| 422 | info.append('closed') |
| 423 | return '<%s %s>' % (self.__class__.__name__, " ".join(info)) |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 424 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 425 | def set_loop(self, loop): |
| 426 | self._loop = loop |
| 427 | |
| 428 | def select(self, timeout=None): |
| 429 | if not self._results: |
| 430 | self._poll(timeout) |
| 431 | tmp = self._results |
| 432 | self._results = [] |
| 433 | return tmp |
| 434 | |
Victor Stinner | 41063d2 | 2015-01-26 22:30:49 +0100 | [diff] [blame] | 435 | def _result(self, value): |
Yury Selivanov | 7661db6 | 2016-05-16 15:38:39 -0400 | [diff] [blame] | 436 | fut = self._loop.create_future() |
Victor Stinner | 41063d2 | 2015-01-26 22:30:49 +0100 | [diff] [blame] | 437 | fut.set_result(value) |
| 438 | return fut |
| 439 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 440 | def recv(self, conn, nbytes, flags=0): |
| 441 | self._register_with_iocp(conn) |
| 442 | ov = _overlapped.Overlapped(NULL) |
Victor Stinner | 41063d2 | 2015-01-26 22:30:49 +0100 | [diff] [blame] | 443 | try: |
| 444 | if isinstance(conn, socket.socket): |
| 445 | ov.WSARecv(conn.fileno(), nbytes, flags) |
| 446 | else: |
| 447 | ov.ReadFile(conn.fileno(), nbytes) |
| 448 | except BrokenPipeError: |
| 449 | return self._result(b'') |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 450 | |
Victor Stinner | c89c8a7 | 2014-02-26 17:35:30 +0100 | [diff] [blame] | 451 | def finish_recv(trans, key, ov): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 452 | try: |
| 453 | return ov.getresult() |
| 454 | except OSError as exc: |
Andrew Svetlov | 7c68407 | 2018-01-27 21:22:47 +0200 | [diff] [blame] | 455 | if exc.winerror in (_overlapped.ERROR_NETNAME_DELETED, |
| 456 | _overlapped.ERROR_OPERATION_ABORTED): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 457 | raise ConnectionResetError(*exc.args) |
| 458 | else: |
| 459 | raise |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 460 | |
Victor Stinner | c89c8a7 | 2014-02-26 17:35:30 +0100 | [diff] [blame] | 461 | return self._register(ov, conn, finish_recv) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 462 | |
Antoine Pitrou | 525f40d | 2017-10-19 21:46:40 +0200 | [diff] [blame] | 463 | def recv_into(self, conn, buf, flags=0): |
| 464 | self._register_with_iocp(conn) |
| 465 | ov = _overlapped.Overlapped(NULL) |
| 466 | try: |
| 467 | if isinstance(conn, socket.socket): |
| 468 | ov.WSARecvInto(conn.fileno(), buf, flags) |
| 469 | else: |
| 470 | ov.ReadFileInto(conn.fileno(), buf) |
| 471 | except BrokenPipeError: |
| 472 | return self._result(b'') |
| 473 | |
| 474 | def finish_recv(trans, key, ov): |
| 475 | try: |
| 476 | return ov.getresult() |
| 477 | except OSError as exc: |
Andrew Svetlov | 7c68407 | 2018-01-27 21:22:47 +0200 | [diff] [blame] | 478 | if exc.winerror in (_overlapped.ERROR_NETNAME_DELETED, |
| 479 | _overlapped.ERROR_OPERATION_ABORTED): |
Antoine Pitrou | 525f40d | 2017-10-19 21:46:40 +0200 | [diff] [blame] | 480 | raise ConnectionResetError(*exc.args) |
| 481 | else: |
| 482 | raise |
| 483 | |
| 484 | return self._register(ov, conn, finish_recv) |
| 485 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 486 | def send(self, conn, buf, flags=0): |
| 487 | self._register_with_iocp(conn) |
| 488 | ov = _overlapped.Overlapped(NULL) |
| 489 | if isinstance(conn, socket.socket): |
| 490 | ov.WSASend(conn.fileno(), buf, flags) |
| 491 | else: |
| 492 | ov.WriteFile(conn.fileno(), buf) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 493 | |
Victor Stinner | c89c8a7 | 2014-02-26 17:35:30 +0100 | [diff] [blame] | 494 | def finish_send(trans, key, ov): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 495 | try: |
| 496 | return ov.getresult() |
| 497 | except OSError as exc: |
Andrew Svetlov | 7c68407 | 2018-01-27 21:22:47 +0200 | [diff] [blame] | 498 | if exc.winerror in (_overlapped.ERROR_NETNAME_DELETED, |
| 499 | _overlapped.ERROR_OPERATION_ABORTED): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 500 | raise ConnectionResetError(*exc.args) |
| 501 | else: |
| 502 | raise |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 503 | |
Victor Stinner | c89c8a7 | 2014-02-26 17:35:30 +0100 | [diff] [blame] | 504 | return self._register(ov, conn, finish_send) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 505 | |
| 506 | def accept(self, listener): |
| 507 | self._register_with_iocp(listener) |
| 508 | conn = self._get_accept_socket(listener.family) |
| 509 | ov = _overlapped.Overlapped(NULL) |
| 510 | ov.AcceptEx(listener.fileno(), conn.fileno()) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 511 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 512 | def finish_accept(trans, key, ov): |
| 513 | ov.getresult() |
| 514 | # Use SO_UPDATE_ACCEPT_CONTEXT so getsockname() etc work. |
| 515 | buf = struct.pack('@P', listener.fileno()) |
| 516 | conn.setsockopt(socket.SOL_SOCKET, |
| 517 | _overlapped.SO_UPDATE_ACCEPT_CONTEXT, buf) |
| 518 | conn.settimeout(listener.gettimeout()) |
| 519 | return conn, conn.getpeername() |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 520 | |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 521 | async def accept_coro(future, conn): |
Victor Stinner | 7de2646 | 2014-01-11 00:03:21 +0100 | [diff] [blame] | 522 | # Coroutine closing the accept socket if the future is cancelled |
| 523 | try: |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 524 | await future |
Andrew Svetlov | 0baa72f | 2018-09-11 10:13:04 -0700 | [diff] [blame] | 525 | except exceptions.CancelledError: |
Victor Stinner | 7de2646 | 2014-01-11 00:03:21 +0100 | [diff] [blame] | 526 | conn.close() |
| 527 | raise |
| 528 | |
| 529 | future = self._register(ov, listener, finish_accept) |
| 530 | coro = accept_coro(future, conn) |
Yury Selivanov | 59eb9a4 | 2015-05-11 14:48:38 -0400 | [diff] [blame] | 531 | tasks.ensure_future(coro, loop=self._loop) |
Victor Stinner | 7de2646 | 2014-01-11 00:03:21 +0100 | [diff] [blame] | 532 | return future |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 533 | |
| 534 | def connect(self, conn, address): |
| 535 | self._register_with_iocp(conn) |
| 536 | # The socket needs to be locally bound before we call ConnectEx(). |
| 537 | try: |
| 538 | _overlapped.BindLocal(conn.fileno(), conn.family) |
| 539 | except OSError as e: |
| 540 | if e.winerror != errno.WSAEINVAL: |
| 541 | raise |
| 542 | # Probably already locally bound; check using getsockname(). |
| 543 | if conn.getsockname()[1] == 0: |
| 544 | raise |
| 545 | ov = _overlapped.Overlapped(NULL) |
| 546 | ov.ConnectEx(conn.fileno(), address) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 547 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 548 | def finish_connect(trans, key, ov): |
| 549 | ov.getresult() |
| 550 | # Use SO_UPDATE_CONNECT_CONTEXT so getsockname() etc work. |
| 551 | conn.setsockopt(socket.SOL_SOCKET, |
| 552 | _overlapped.SO_UPDATE_CONNECT_CONTEXT, 0) |
| 553 | return conn |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 554 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 555 | return self._register(ov, conn, finish_connect) |
| 556 | |
Andrew Svetlov | a19fb3c | 2018-02-25 19:32:14 +0300 | [diff] [blame] | 557 | def sendfile(self, sock, file, offset, count): |
| 558 | self._register_with_iocp(sock) |
| 559 | ov = _overlapped.Overlapped(NULL) |
| 560 | offset_low = offset & 0xffff_ffff |
| 561 | offset_high = (offset >> 32) & 0xffff_ffff |
| 562 | ov.TransmitFile(sock.fileno(), |
| 563 | msvcrt.get_osfhandle(file.fileno()), |
| 564 | offset_low, offset_high, |
| 565 | count, 0, 0) |
| 566 | |
| 567 | def finish_sendfile(trans, key, ov): |
| 568 | try: |
| 569 | return ov.getresult() |
| 570 | except OSError as exc: |
| 571 | if exc.winerror in (_overlapped.ERROR_NETNAME_DELETED, |
| 572 | _overlapped.ERROR_OPERATION_ABORTED): |
| 573 | raise ConnectionResetError(*exc.args) |
| 574 | else: |
| 575 | raise |
| 576 | return self._register(ov, sock, finish_sendfile) |
| 577 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 578 | def accept_pipe(self, pipe): |
| 579 | self._register_with_iocp(pipe) |
| 580 | ov = _overlapped.Overlapped(NULL) |
Victor Stinner | 2b77c54 | 2015-01-22 23:50:03 +0100 | [diff] [blame] | 581 | connected = ov.ConnectNamedPipe(pipe.fileno()) |
| 582 | |
| 583 | if connected: |
| 584 | # ConnectNamePipe() failed with ERROR_PIPE_CONNECTED which means |
| 585 | # that the pipe is connected. There is no need to wait for the |
| 586 | # completion of the connection. |
Victor Stinner | 41063d2 | 2015-01-26 22:30:49 +0100 | [diff] [blame] | 587 | return self._result(pipe) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 588 | |
Victor Stinner | c89c8a7 | 2014-02-26 17:35:30 +0100 | [diff] [blame] | 589 | def finish_accept_pipe(trans, key, ov): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 590 | ov.getresult() |
| 591 | return pipe |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 592 | |
Victor Stinner | 2b77c54 | 2015-01-22 23:50:03 +0100 | [diff] [blame] | 593 | return self._register(ov, pipe, finish_accept_pipe) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 594 | |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 595 | async def connect_pipe(self, address): |
Victor Stinner | e0fd157 | 2015-01-26 15:04:03 +0100 | [diff] [blame] | 596 | delay = CONNECT_PIPE_INIT_DELAY |
| 597 | while True: |
Yury Selivanov | 6370f34 | 2017-12-10 18:36:12 -0500 | [diff] [blame] | 598 | # Unfortunately there is no way to do an overlapped connect to |
| 599 | # a pipe. Call CreateFile() in a loop until it doesn't fail with |
| 600 | # ERROR_PIPE_BUSY. |
Victor Stinner | e0fd157 | 2015-01-26 15:04:03 +0100 | [diff] [blame] | 601 | try: |
| 602 | handle = _overlapped.ConnectPipe(address) |
| 603 | break |
| 604 | except OSError as exc: |
| 605 | if exc.winerror != _overlapped.ERROR_PIPE_BUSY: |
| 606 | raise |
| 607 | |
| 608 | # ConnectPipe() failed with ERROR_PIPE_BUSY: retry later |
| 609 | delay = min(delay * 2, CONNECT_PIPE_MAX_DELAY) |
Andrew Svetlov | 5f841b5 | 2017-12-09 00:23:48 +0200 | [diff] [blame] | 610 | await tasks.sleep(delay, loop=self._loop) |
Victor Stinner | e0fd157 | 2015-01-26 15:04:03 +0100 | [diff] [blame] | 611 | |
| 612 | return windows_utils.PipeHandle(handle) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 613 | |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 614 | def wait_for_handle(self, handle, timeout=None): |
Victor Stinner | 4d825b4 | 2014-12-19 17:10:44 +0100 | [diff] [blame] | 615 | """Wait for a handle. |
| 616 | |
| 617 | Return a Future object. The result of the future is True if the wait |
| 618 | completed, or False if the wait did not complete (on timeout). |
| 619 | """ |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 620 | return self._wait_for_handle(handle, timeout, False) |
| 621 | |
| 622 | def _wait_cancel(self, event, done_callback): |
| 623 | fut = self._wait_for_handle(event, None, True) |
| 624 | # add_done_callback() cannot be used because the wait may only complete |
| 625 | # in IocpProactor.close(), while the event loop is not running. |
| 626 | fut._done_callback = done_callback |
| 627 | return fut |
| 628 | |
| 629 | def _wait_for_handle(self, handle, timeout, _is_cancel): |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 630 | self._check_closed() |
| 631 | |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 632 | if timeout is None: |
| 633 | ms = _winapi.INFINITE |
| 634 | else: |
Victor Stinner | f2e1768 | 2014-01-31 16:25:24 +0100 | [diff] [blame] | 635 | # RegisterWaitForSingleObject() has a resolution of 1 millisecond, |
| 636 | # round away from zero to wait *at least* timeout seconds. |
| 637 | ms = math.ceil(timeout * 1e3) |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 638 | |
| 639 | # We only create ov so we can use ov.address as a key for the cache. |
| 640 | ov = _overlapped.Overlapped(NULL) |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 641 | wait_handle = _overlapped.RegisterWaitWithQueue( |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 642 | handle, self._iocp, ov.address, ms) |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 643 | if _is_cancel: |
| 644 | f = _WaitCancelFuture(ov, handle, wait_handle, loop=self._loop) |
| 645 | else: |
| 646 | f = _WaitHandleFuture(ov, handle, wait_handle, self, |
| 647 | loop=self._loop) |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 648 | if f._source_traceback: |
| 649 | del f._source_traceback[-1] |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 650 | |
Victor Stinner | c89c8a7 | 2014-02-26 17:35:30 +0100 | [diff] [blame] | 651 | def finish_wait_for_handle(trans, key, ov): |
Richard Oudkerk | 71196e7 | 2013-11-24 17:50:40 +0000 | [diff] [blame] | 652 | # Note that this second wait means that we should only use |
| 653 | # this with handles types where a successful wait has no |
| 654 | # effect. So events or processes are all right, but locks |
| 655 | # or semaphores are not. Also note if the handle is |
| 656 | # signalled and then quickly reset, then we may return |
| 657 | # False even though we have not timed out. |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 658 | return f._poll() |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 659 | |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 660 | self._cache[ov.address] = (f, ov, 0, finish_wait_for_handle) |
Guido van Rossum | 90fb914 | 2013-10-30 14:44:05 -0700 | [diff] [blame] | 661 | return f |
| 662 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 663 | def _register_with_iocp(self, obj): |
| 664 | # To get notifications of finished ops on this objects sent to the |
| 665 | # completion port, were must register the handle. |
| 666 | if obj not in self._registered: |
| 667 | self._registered.add(obj) |
| 668 | _overlapped.CreateIoCompletionPort(obj.fileno(), self._iocp, 0, 0) |
| 669 | # XXX We could also use SetFileCompletionNotificationModes() |
| 670 | # to avoid sending notifications to completion port of ops |
| 671 | # that succeed immediately. |
| 672 | |
Victor Stinner | 2b77c54 | 2015-01-22 23:50:03 +0100 | [diff] [blame] | 673 | def _register(self, ov, obj, callback): |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 674 | self._check_closed() |
| 675 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 676 | # Return a future which will be set with the result of the |
| 677 | # operation when it completes. The future's value is actually |
| 678 | # the value returned by callback(). |
| 679 | f = _OverlappedFuture(ov, loop=self._loop) |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 680 | if f._source_traceback: |
| 681 | del f._source_traceback[-1] |
Victor Stinner | 2b77c54 | 2015-01-22 23:50:03 +0100 | [diff] [blame] | 682 | if not ov.pending: |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 683 | # The operation has completed, so no need to postpone the |
| 684 | # work. We cannot take this short cut if we need the |
| 685 | # NumberOfBytes, CompletionKey values returned by |
| 686 | # PostQueuedCompletionStatus(). |
| 687 | try: |
| 688 | value = callback(None, None, ov) |
| 689 | except OSError as e: |
| 690 | f.set_exception(e) |
| 691 | else: |
| 692 | f.set_result(value) |
Victor Stinner | 42d3bde | 2014-07-28 00:18:43 +0200 | [diff] [blame] | 693 | # Even if GetOverlappedResult() was called, we have to wait for the |
| 694 | # notification of the completion in GetQueuedCompletionStatus(). |
| 695 | # Register the overlapped operation to keep a reference to the |
| 696 | # OVERLAPPED object, otherwise the memory is freed and Windows may |
| 697 | # read uninitialized memory. |
Victor Stinner | 2b77c54 | 2015-01-22 23:50:03 +0100 | [diff] [blame] | 698 | |
| 699 | # Register the overlapped operation for later. Note that |
| 700 | # we only store obj to prevent it from being garbage |
| 701 | # collected too early. |
| 702 | self._cache[ov.address] = (f, ov, obj, callback) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 703 | return f |
| 704 | |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 705 | def _unregister(self, ov): |
| 706 | """Unregister an overlapped object. |
| 707 | |
| 708 | Call this method when its future has been cancelled. The event can |
| 709 | already be signalled (pending in the proactor event queue). It is also |
| 710 | safe if the event is never signalled (because it was cancelled). |
| 711 | """ |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 712 | self._check_closed() |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 713 | self._unregistered.append(ov) |
| 714 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 715 | def _get_accept_socket(self, family): |
| 716 | s = socket.socket(family) |
| 717 | s.settimeout(0) |
| 718 | return s |
| 719 | |
| 720 | def _poll(self, timeout=None): |
| 721 | if timeout is None: |
| 722 | ms = INFINITE |
| 723 | elif timeout < 0: |
| 724 | raise ValueError("negative timeout") |
| 725 | else: |
Victor Stinner | f2e1768 | 2014-01-31 16:25:24 +0100 | [diff] [blame] | 726 | # GetQueuedCompletionStatus() has a resolution of 1 millisecond, |
| 727 | # round away from zero to wait *at least* timeout seconds. |
| 728 | ms = math.ceil(timeout * 1e3) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 729 | if ms >= INFINITE: |
| 730 | raise ValueError("timeout too big") |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 731 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 732 | while True: |
| 733 | status = _overlapped.GetQueuedCompletionStatus(self._iocp, ms) |
| 734 | if status is None: |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 735 | break |
Victor Stinner | 313a980 | 2014-07-29 12:58:23 +0200 | [diff] [blame] | 736 | ms = 0 |
| 737 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 738 | err, transferred, key, address = status |
| 739 | try: |
| 740 | f, ov, obj, callback = self._cache.pop(address) |
| 741 | except KeyError: |
Victor Stinner | 42d3bde | 2014-07-28 00:18:43 +0200 | [diff] [blame] | 742 | if self._loop.get_debug(): |
| 743 | self._loop.call_exception_handler({ |
| 744 | 'message': ('GetQueuedCompletionStatus() returned an ' |
| 745 | 'unexpected event'), |
| 746 | 'status': ('err=%s transferred=%s key=%#x address=%#x' |
| 747 | % (err, transferred, key, address)), |
| 748 | }) |
| 749 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 750 | # key is either zero, or it is used to return a pipe |
| 751 | # handle which should be closed to avoid a leak. |
| 752 | if key not in (0, _overlapped.INVALID_HANDLE_VALUE): |
| 753 | _winapi.CloseHandle(key) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 754 | continue |
Victor Stinner | 51e44ea | 2014-07-26 00:58:34 +0200 | [diff] [blame] | 755 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 756 | if obj in self._stopped_serving: |
| 757 | f.cancel() |
Victor Stinner | 42d3bde | 2014-07-28 00:18:43 +0200 | [diff] [blame] | 758 | # Don't call the callback if _register() already read the result or |
| 759 | # if the overlapped has been cancelled |
| 760 | elif not f.done(): |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 761 | try: |
| 762 | value = callback(transferred, key, ov) |
| 763 | except OSError as e: |
| 764 | f.set_exception(e) |
| 765 | self._results.append(f) |
| 766 | else: |
| 767 | f.set_result(value) |
| 768 | self._results.append(f) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 769 | |
Andrew Svetlov | 7a6706b | 2017-12-13 17:50:16 +0200 | [diff] [blame] | 770 | # Remove unregistered futures |
Victor Stinner | d0a28de | 2015-01-21 23:39:51 +0100 | [diff] [blame] | 771 | for ov in self._unregistered: |
| 772 | self._cache.pop(ov.address, None) |
| 773 | self._unregistered.clear() |
| 774 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 775 | def _stop_serving(self, obj): |
| 776 | # obj is a socket or pipe handle. It will be closed in |
| 777 | # BaseProactorEventLoop._stop_serving() which will make any |
| 778 | # pending operations fail quickly. |
| 779 | self._stopped_serving.add(obj) |
| 780 | |
| 781 | def close(self): |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 782 | if self._iocp is None: |
| 783 | # already closed |
| 784 | return |
| 785 | |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 786 | # Cancel remaining registered operations. |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 787 | for address, (fut, ov, obj, callback) in list(self._cache.items()): |
Victor Stinner | 3d2256f | 2015-01-26 11:02:59 +0100 | [diff] [blame] | 788 | if fut.cancelled(): |
Victor Stinner | 752aba7 | 2015-01-22 22:47:13 +0100 | [diff] [blame] | 789 | # Nothing to do with cancelled futures |
| 790 | pass |
Victor Stinner | 1ca9392 | 2015-01-22 00:17:54 +0100 | [diff] [blame] | 791 | elif isinstance(fut, _WaitCancelFuture): |
| 792 | # _WaitCancelFuture must not be cancelled |
| 793 | pass |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 794 | else: |
| 795 | try: |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 796 | fut.cancel() |
| 797 | except OSError as exc: |
| 798 | if self._loop is not None: |
| 799 | context = { |
| 800 | 'message': 'Cancelling a future failed', |
| 801 | 'exception': exc, |
| 802 | 'future': fut, |
| 803 | } |
| 804 | if fut._source_traceback: |
| 805 | context['source_traceback'] = fut._source_traceback |
| 806 | self._loop.call_exception_handler(context) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 807 | |
Victor Stinner | b1e4573 | 2019-01-15 11:48:00 +0100 | [diff] [blame] | 808 | # Wait until all cancelled overlapped complete: don't exit with running |
| 809 | # overlapped to prevent a crash. Display progress every second if the |
| 810 | # loop is still running. |
| 811 | msg_update = 1.0 |
| 812 | start_time = time.monotonic() |
| 813 | next_msg = start_time + msg_update |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 814 | while self._cache: |
Victor Stinner | b1e4573 | 2019-01-15 11:48:00 +0100 | [diff] [blame] | 815 | if next_msg <= time.monotonic(): |
Victor Stinner | b91140f | 2019-01-15 12:13:48 +0100 | [diff] [blame] | 816 | logger.debug('%r is running after closing for %.1f seconds', |
| 817 | self, time.monotonic() - start_time) |
Victor Stinner | b1e4573 | 2019-01-15 11:48:00 +0100 | [diff] [blame] | 818 | next_msg = time.monotonic() + msg_update |
| 819 | |
| 820 | # handle a few events, or timeout |
| 821 | self._poll(msg_update) |
Guido van Rossum | 27b7c7e | 2013-10-17 13:40:50 -0700 | [diff] [blame] | 822 | |
| 823 | self._results = [] |
Victor Stinner | 9b07681 | 2019-01-10 11:23:26 +0100 | [diff] [blame] | 824 | |
| 825 | _winapi.CloseHandle(self._iocp) |
| 826 | self._iocp = None |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 827 | |
Victor Stinner | fea6a10 | 2014-07-25 00:54:53 +0200 | [diff] [blame] | 828 | def __del__(self): |
| 829 | self.close() |
| 830 | |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 831 | |
| 832 | class _WindowsSubprocessTransport(base_subprocess.BaseSubprocessTransport): |
| 833 | |
| 834 | def _start(self, args, shell, stdin, stdout, stderr, bufsize, **kwargs): |
| 835 | self._proc = windows_utils.Popen( |
| 836 | args, shell=shell, stdin=stdin, stdout=stdout, stderr=stderr, |
| 837 | bufsize=bufsize, **kwargs) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 838 | |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 839 | def callback(f): |
| 840 | returncode = self._proc.poll() |
| 841 | self._process_exited(returncode) |
Guido van Rossum | a8d630a | 2013-11-01 14:20:55 -0700 | [diff] [blame] | 842 | |
Guido van Rossum | 5969128 | 2013-10-30 14:52:03 -0700 | [diff] [blame] | 843 | f = self._loop._proactor.wait_for_handle(int(self._proc._handle)) |
| 844 | f.add_done_callback(callback) |
Guido van Rossum | 0eaa5ac | 2013-11-04 15:50:46 -0800 | [diff] [blame] | 845 | |
| 846 | |
| 847 | SelectorEventLoop = _WindowsSelectorEventLoop |
| 848 | |
| 849 | |
Yury Selivanov | 8f40429 | 2018-06-07 20:44:57 -0400 | [diff] [blame] | 850 | class WindowsSelectorEventLoopPolicy(events.BaseDefaultEventLoopPolicy): |
Guido van Rossum | 0eaa5ac | 2013-11-04 15:50:46 -0800 | [diff] [blame] | 851 | _loop_factory = SelectorEventLoop |
| 852 | |
| 853 | |
Yury Selivanov | 8f40429 | 2018-06-07 20:44:57 -0400 | [diff] [blame] | 854 | class WindowsProactorEventLoopPolicy(events.BaseDefaultEventLoopPolicy): |
| 855 | _loop_factory = ProactorEventLoop |
| 856 | |
| 857 | |
Victor Stinner | 6ea29c5 | 2018-09-25 08:27:08 -0700 | [diff] [blame] | 858 | DefaultEventLoopPolicy = WindowsProactorEventLoopPolicy |