diff options
| author | Johannes Gijsbers <jlg@dds.nl> | 2004-10-11 18:12:20 (GMT) |
|---|---|---|
| committer | Johannes Gijsbers <jlg@dds.nl> | 2004-10-11 18:12:20 (GMT) |
| commit | 9fc9789a0d0bd83f3c49fc2837555d022cf52014 (patch) | |
| tree | acbd62ef55224ccf26aa93a68f58e7d7a8c1d3d8 /Doc | |
| parent | c054a8b1a99c15146c9f2092172d04e5c832ffff (diff) | |
| download | cpython-9fc9789a0d0bd83f3c49fc2837555d022cf52014.zip cpython-9fc9789a0d0bd83f3c49fc2837555d022cf52014.tar.gz cpython-9fc9789a0d0bd83f3c49fc2837555d022cf52014.tar.bz2 | |
Document that on Unix, the 'cmd' argument to the os.popen2/3/4 and
popen2.popen2/3/4 functions can be a sequence. All texts are a variation on the
following:
On \UNIX, \var{cmd} may be a sequence, in which case arguments will be passed
directly to the program without shell intervention (as with
\function{os.spawnv()}). If \var{cmd} is a string it will be passed to the shell
(as with \function{os.system()}).
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/lib/libos.tex | 12 | ||||
| -rw-r--r-- | Doc/lib/libpopen2.tex | 6 |
2 files changed, 13 insertions, 5 deletions
diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex index 510da17..6ad5b3e 100644 --- a/Doc/lib/libos.tex +++ b/Doc/lib/libos.tex @@ -361,6 +361,11 @@ specified, it specifies the buffer size for the I/O pipes. objects should be opened in binary or text mode. The default value for \var{mode} is \code{'t'}. +Also, for each of these variants, on \UNIX, \var{cmd} may be a sequence, in +which case arguments will be passed directly to the program without shell +intervention (as with \function{os.spawnv()}). If \var{cmd} is a string it will +be passed to the shell (as with \function{os.system()}). + These methods do not make it possible to retrieve the return code from the child processes. The only way to control the input and output streams and also retrieve the return codes is to use the @@ -389,15 +394,14 @@ Availability: \UNIX, Windows. \begin{funcdesc}{popen4}{cmd\optional{, mode\optional{, bufsize}}} Executes \var{cmd} as a sub-process. Returns the file objects \code{(\var{child_stdin}, \var{child_stdout_and_stderr})}. +Availability: \UNIX, Windows. +\versionadded{2.0} +\end{funcdesc} (Note that \code{\var{child_stdin}, \var{child_stdout}, and \var{child_stderr}} are named from the point of view of the child process, i.e. \var{child_stdin} is the child's standard input.) -Availability: \UNIX, Windows. -\versionadded{2.0} -\end{funcdesc} - This functionality is also available in the \refmodule{popen2} module using functions of the same names, but the return values of those functions have a different order. diff --git a/Doc/lib/libpopen2.tex b/Doc/lib/libpopen2.tex index 70a68c2..985f580 100644 --- a/Doc/lib/libpopen2.tex +++ b/Doc/lib/libpopen2.tex @@ -24,6 +24,11 @@ this is needed to determine whether the file objects should be opened in binary or text mode. The default value for \var{mode} is \code{'t'}. +On \UNIX, \var{cmd} may be a sequence, in which case arguments will be passed +directly to the program without shell intervention (as with +\function{os.spawnv()}). If \var{cmd} is a string it will be passed to the +shell (as with \function{os.system()}). + The only way to retrieve the return codes for the child processes is by using the \method{poll()} or \method{wait()} methods on the \class{Popen3} and \class{Popen4} classes; these are only available on @@ -75,7 +80,6 @@ using \function{popen4()}. \versionadded{2.0} \end{classdesc} - \subsection{Popen3 and Popen4 Objects \label{popen3-objects}} Instances of the \class{Popen3} and \class{Popen4} classes have the |