diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index 8b3081cb80c972..949c07dbbac5b0 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -186,6 +186,13 @@ A library which wants to use a particular start method should probably use :func:`get_context` to avoid interfering with the choice of the library user. +.. warning:: + + The ``'spawn'`` and ``'forkserver'`` start methods cannot currently + be used with "frozen" executables (i.e., binaries produced by + packages like **PyInstaller** and **cx_Freeze**) on Unix. + The ``'fork'`` start method does work. + Exchanging objects between processes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/Misc/NEWS.d/next/Library/2018-02-25-10-17-23.bpo-32146.xOzUFW.rst b/Misc/NEWS.d/next/Library/2018-02-25-10-17-23.bpo-32146.xOzUFW.rst new file mode 100644 index 00000000000000..f071c7101806b3 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2018-02-25-10-17-23.bpo-32146.xOzUFW.rst @@ -0,0 +1,2 @@ +Document the interaction between frozen executables and the spawn and +forkserver start methods in multiprocessing.