bpo-32146: Add documentation about frozen executables on Unix (GH-5850)

(cherry picked from commit bab4bbb) Co-authored-by: Bo Bayles <bbayles@gmail.com>
python · Jan 10, 2019 · b9cd38f · b9cd38f
1 parent 3e3d57d
commit b9cd38f
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 0 deletions.
diff --git 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
@@ -0,0 +1,2 @@
+Document the interaction between frozen executables and the spawn and
+forkserver start methods in multiprocessing.