Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Issue #8873: add a documentation note about possible performance issues with the 

default of unbuffered IO in subprocess.Popen.
This commit is contained in:
Antoine Pitrou 2010-06-02 17:08:47 +00:00
parent 3b4849a21d
commit c395545a4a
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Doc/library/subprocess.rst
View File

@ -94,6 +94,12 @@ This module defines one class called :class:`Popen`:
size. A negative *bufsize* means to use the system default, which usually means size. A negative *bufsize* means to use the system default, which usually means
fully buffered. The default value for *bufsize* is :const:`0` (unbuffered). fully buffered. The default value for *bufsize* is :const:`0` (unbuffered).
.. note::
If you experience performance issues, it is recommended that you try to
enable buffering by setting *bufsize* to either -1 or a large enough
positive value (such as 4096).
The *executable* argument specifies the program to execute. It is very seldom The *executable* argument specifies the program to execute. It is very seldom
needed: Usually, the program to execute is defined by the *args* argument. If needed: Usually, the program to execute is defined by the *args* argument. If
``shell=True``, the *executable* argument specifies which shell to use. On Unix, ``shell=True``, the *executable* argument specifies which shell to use. On Unix,