Skip to content

Commit dad35f5

Browse files
committed
DOC mention JOBLIB_START_METHOD in crash/freeze FAQ
1 parent 647b7c1 commit dad35f5

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

doc/faq.rst

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -248,10 +248,13 @@ Python processes for parallel computing. Unfortunately this is a violation of
248248
the POSIX standard and therefore some software editors like Apple refuse to
249249
consider the lack of fork-safety in Accelerate / vecLib as a bug.
250250

251-
In Python 3.4+ it is now possible to configure ``multiprocessing`` to use the
252-
'forkserver' or 'spawn' start methods (instead of the default 'fork') to manage
253-
the process pools. This makes it possible to not be subject to this issue
254-
anymore.
251+
In Python 3.4+ it is now possible to configure ``multiprocessing`` to
252+
use the 'forkserver' or 'spawn' start methods (instead of the default
253+
'fork') to manage the process pools. To work around this issue when
254+
using scikit-learn, you can set the JOBLIB_START_METHOD environment
255+
variable to 'forkserver'. However the user should be aware that using
256+
the 'forkserver' method prevents joblib.Parallel to call function
257+
interactively defined in a shell session.
255258

256259
If you have custom code that uses ``multiprocessing`` directly instead of using
257260
it via joblib you can enable the 'forkserver' mode globally for your

0 commit comments

Comments
 (0)