mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-02 03:01:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 15

Explain that os.spawn*() return the process handle on Windows.

Browse source 
Clarify that os.waitpid() on Windows takes a process handle, not a process ID.
This closes SF bug #537582.
This commit is contained in:
Fred Drake 2002-04-01 23:30:47 +00:00
parent d764b0a484
commit 4dfb7a81c1
1 changed files with 5 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/lib/libos.tex
View file

@ -1029,7 +1029,9 @@ Execute the program \var{path} in a new process. If \var{mode} is
\constant{P_NOWAIT}, this function returns the process ID of the new
process; if \var{mode} is \constant{P_WAIT}, returns the process's
exit code if it exits normally, or \code{-\var{signal}}, where
\var{signal} is the signal that killed the process.
\var{signal} is the signal that killed the process. On Windows, the
process ID will actually be the process handle, so can be used with
the \function{waitpid()} function.
The \character{l} and \character{v} variants of the
\function{spawn*()} functions differ in how command-line arguments are
@ -1184,7 +1186,7 @@ than \code{-1}, status is requested for any process in the process
group \code{-\var{pid}} (the absolute value of \var{pid}).
On Windows:
Wait for completion of a process given by process id \var{pid},
Wait for completion of a process given by process handle \var{pid},
and return a tuple containing \var{pid},
and its exit status shifted left by 8 bits (shifting makes cross-platform
use of the function easier).
@ -1194,7 +1196,7 @@ The value of integer \var{options} has no effect.
\var{pid} can refer to any process whose id is known, not necessarily a
child process.
The \function{spawn()} functions called with \constant{P_NOWAIT}
return suitable process ids.
return suitable process handles.
\end{funcdesc}
\begin{datadesc}{WNOHANG}