diff options
| author | Philip Jenvey <pjenvey@underboss.org> | 2009-05-22 05:46:35 (GMT) |
|---|---|---|
| committer | Philip Jenvey <pjenvey@underboss.org> | 2009-05-22 05:46:35 (GMT) |
| commit | ab7481a0a4d0402b8d9290df608bb6759e97e9bc (patch) | |
| tree | 89849f7614abdabd4c9905a1f68089f6603c0563 /Doc | |
| parent | d40285a986990d45c29e83943dc7783a4e976da5 (diff) | |
| download | cpython-ab7481a0a4d0402b8d9290df608bb6759e97e9bc.zip cpython-ab7481a0a4d0402b8d9290df608bb6759e97e9bc.tar.gz cpython-ab7481a0a4d0402b8d9290df608bb6759e97e9bc.tar.bz2 | |
Merged revisions 72817 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r72817 | philip.jenvey | 2009-05-21 22:35:32 -0700 (Thu, 21 May 2009) | 4 lines
don't use subprocess.call with PIPEs as the child can fill the pipe buf and
deadlock. add a warning to subprocess docs about this, similar to Popen.wait's.
refs http://bugs.jython.org/issue1351
........
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/subprocess.rst | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 7952f68..9853e62 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -152,6 +152,12 @@ This module also defines four shortcut functions: retcode = call(["ls", "-l"]) + .. warning:: + + Like :meth:`Popen.wait`, this will deadlock if the child process + generates enough output to a stdout or stderr pipe such that it blocks + waiting for the OS pipe buffer to accept more data. + .. function:: check_call(*popenargs, **kwargs) @@ -164,6 +170,10 @@ This module also defines four shortcut functions: check_call(["ls", "-l"]) + .. warning:: + + See the warning for :func:`call`. + .. function:: check_output(*popenargs, **kwargs) |