Skip to content

Commit 241ed67

Browse files
committed
Mention the forkserver start method change in Porting
1 parent 910e1e0 commit 241ed67

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

Doc/whatsnew/3.14.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1312,6 +1312,8 @@ concurrent.futures
13121312
in :pep:`734`.
13131313
(Contributed by Eric Snow in :gh:`124548`.)
13141314

1315+
.. _whatsnew314-concurrent-futures-start-method:
1316+
13151317
* On Unix platforms other than macOS, :ref:`'forkserver'
13161318
<multiprocessing-start-method-forkserver>` is now the the default :ref:`start
13171319
method <multiprocessing-start-methods>` for
@@ -1745,6 +1747,8 @@ mimetypes
17451747
multiprocessing
17461748
---------------
17471749

1750+
.. _whatsnew314-multiprocessing-start-method:
1751+
17481752
* On Unix platforms other than macOS, :ref:`'forkserver'
17491753
<multiprocessing-start-method-forkserver>` is now the the default :ref:`start
17501754
method <multiprocessing-start-methods>`
@@ -3210,6 +3214,20 @@ that may require changes to your code.
32103214
Changes in the Python API
32113215
-------------------------
32123216

3217+
* On Unix platforms other than macOS, *forkserver* is now the default
3218+
:ref:`start method <multiprocessing-start-methods>` for :mod:`multiprocessing`
3219+
and :class:`~concurrent.futures.ProcessPoolExecutor`, instead of *fork*.
3220+
3221+
See :ref:`(1) <whatsnew314-concurrent-futures-start-method>` and
3222+
:ref:`(2) <whatsnew314-multiprocessing-start-method>` for details.
3223+
3224+
If you encounter :exc:`NameError`\s or pickling errors coming out of
3225+
:mod:`multiprocessing` or :mod:`concurrent.futures`, see the
3226+
:ref:`forkserver restrictions <multiprocessing-programming-forkserver>`.
3227+
3228+
This change does not affect Windows or macOS, where :ref:`'spawn'
3229+
<multiprocessing-start-method-spawn>` remains the default start method.
3230+
32133231
* :class:`functools.partial` is now a method descriptor.
32143232
Wrap it in :func:`staticmethod` if you want to preserve the old behavior.
32153233
(Contributed by Serhiy Storchaka and Dominykas Grigonis in :gh:`121027`.)

0 commit comments

Comments
 (0)