diff options
| author | Phil Connell <pconnell@gmail.com> | 2019-11-15 16:56:03 (GMT) |
|---|---|---|
| committer | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2019-11-15 16:56:03 (GMT) |
| commit | b22030073b9327a3aeccb69507694bce078192aa (patch) | |
| tree | f51c71791a42d9ccbc9a015b397b2391e87b0ddf | |
| parent | e8acc865a3f112b98417f676c897ca6ec2dac2c7 (diff) | |
| download | cpython-b22030073b9327a3aeccb69507694bce078192aa.zip cpython-b22030073b9327a3aeccb69507694bce078192aa.tar.gz cpython-b22030073b9327a3aeccb69507694bce078192aa.tar.bz2 | |
bpo-38778: Document that os.fork is not allowed in subinterpreters (GH-17123)
Small docs update for [bpo-34651](https://bugs.python.org/issue34651).
Other references to fork (e.g. the PyOS.*Fork functions or discussions of fork() when embedding Python) point back to os.fork, so I don't think any other updates are needed.
https://bugs.python.org/issue38778
Automerge-Triggered-By: @ericsnowcurrently
| -rw-r--r-- | Doc/library/os.rst | 10 | ||||
| -rw-r--r-- | Misc/NEWS.d/next/Documentation/2019-11-12-15-31-09.bpo-38778.PHhTlv.rst | 1 |
2 files changed, 10 insertions, 1 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 652d8de..4fec647 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -3478,7 +3478,11 @@ written in Python, such as a mail server's external command delivery program. parent. If an error occurs :exc:`OSError` is raised. Note that some platforms including FreeBSD <= 6.3 and Cygwin have - known issues when using fork() from a thread. + known issues when using ``fork()`` from a thread. + + .. versionchanged:: 3.8 + Calling ``fork()`` in a subinterpreter is no longer supported + (:exc:`RuntimeError` is raised). .. warning:: @@ -3495,6 +3499,10 @@ written in Python, such as a mail server's external command delivery program. master end of the pseudo-terminal. For a more portable approach, use the :mod:`pty` module. If an error occurs :exc:`OSError` is raised. + .. versionchanged:: 3.8 + Calling ``forkpty()`` in a subinterpreter is no longer supported + (:exc:`RuntimeError` is raised). + .. availability:: some flavors of Unix. diff --git a/Misc/NEWS.d/next/Documentation/2019-11-12-15-31-09.bpo-38778.PHhTlv.rst b/Misc/NEWS.d/next/Documentation/2019-11-12-15-31-09.bpo-38778.PHhTlv.rst new file mode 100644 index 0000000..053e1d2 --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2019-11-12-15-31-09.bpo-38778.PHhTlv.rst @@ -0,0 +1 @@ +Document the fact that :exc:`RuntimeError` is raised if :meth:`os.fork` is called in a subinterpreter. |