[Python-checkins] bpo-32146: Add documentation about frozen executables on Unix (GH-5850)

Miss Islington (bot) webhook-mailer at python.org
Thu Jan 10 13:13:26 EST 2019

commit: b9cd38f928f7eb4e18ad4b63e5c49c05c626c33e
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019-01-10T10:13:21-08:00

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

(cherry picked from commit bab4bbb4c9cd5d25ede21a1b8c99d56e3b8dae9d)

Co-authored-by: Bo Bayles <bbayles at gmail.com>

A Misc/NEWS.d/next/Library/2018-02-25-10-17-23.bpo-32146.xOzUFW.rst
M Doc/library/multiprocessing.rst

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 504f3a1c3c33..c50625dda320 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 000000000000..f071c7101806
--- /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.

More information about the Python-checkins mailing list