diff options
author | Fred Drake <fdrake@acm.org> | 2002-04-01 23:30:47 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2002-04-01 23:30:47 (GMT) |
commit | 4dfb7a81c1bc80d8e4d1d8279d6df81aac4d01e6 (patch) | |
tree | 1d484160ca6d753efe50ea90cb28b4ffe4d79401 | |
parent | d764b0a484b1cd653b155dcf80bdda76f2e7e84f (diff) | |
download | cpython-4dfb7a81c1bc80d8e4d1d8279d6df81aac4d01e6.zip cpython-4dfb7a81c1bc80d8e4d1d8279d6df81aac4d01e6.tar.gz cpython-4dfb7a81c1bc80d8e4d1d8279d6df81aac4d01e6.tar.bz2 |
Explain that os.spawn*() return the process handle on Windows.
Clarify that os.waitpid() on Windows takes a process handle, not a process ID.
This closes SF bug #537582.
-rw-r--r-- | Doc/lib/libos.tex | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex index 5739485..8c819d9 100644 --- a/Doc/lib/libos.tex +++ b/Doc/lib/libos.tex @@ -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} |