diff options
| author | Antoine Pitrou <solipsis@pitrou.net> | 2010-06-02 17:10:45 +0000 |
|---|---|---|
| committer | Antoine Pitrou <solipsis@pitrou.net> | 2010-06-02 17:10:45 +0000 |
| commit | b56b50ddd149fd0d81e8b37d38efac60e736da9e (patch) | |
| tree | 3e2353c2fdc8f616e3480bf200e1425f757bfbe1 | |
| parent | bebd23b73bcd8571f8977639e89837e9041fa824 (diff) | |
| download | cpython-git-b56b50ddd149fd0d81e8b37d38efac60e736da9e.tar.gz | |
Merged revisions 81652 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r81652 | antoine.pitrou | 2010-06-02 19:08:47 +0200 (mer., 02 juin 2010) | 4 lines
Issue #8873: add a documentation note about possible performance issues with the
default of unbuffered IO in subprocess.Popen.
........
| -rw-r--r-- | Doc/library/subprocess.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 967c4a97ee..ffa880fa00 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -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 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 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, |