Attachment "21917x.diff.2" to
ticket [412609ffff]
added by
andreas_kupries
2001-03-31 20:19:30.
? doc/Signal.3
Index: ChangeLog
===================================================================
RCS file: /cvsroot/tcl/tcl/ChangeLog,v
retrieving revision 1.394
diff -u -r1.394 ChangeLog
--- ChangeLog 2001/03/31 07:57:31 1.394
+++ ChangeLog 2001/03/31 10:50:23
@@ -1,3 +1,12 @@
+2001-03-30 Andreas Kupries <[email protected]>
+
+ * unix/mkLinks: Added 'Signal.3', 'Tcl_WaitPid'.
+
+ * doc/DetachPids.3: Added description of 'Tcl_WaitPid' [Bug #219173].
+
+ * doc/Signal.3: New man page describing the public API procedures
+ 'Tcl_SignalId' and 'Tcl_SignalMsg' [Bug #219172].
+
2001-03-30 Jeff Hobbs <[email protected]>
* generic/tclCkalloc.c (TclFinalizeMemorySubsystem): set curTagPtr
Index: doc/DetachPids.3
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/DetachPids.3,v
retrieving revision 1.2
diff -u -r1.2 DetachPids.3
--- doc/DetachPids.3 1998/09/14 18:39:48 1.2
+++ doc/DetachPids.3 2001/03/31 10:50:23
@@ -11,7 +11,7 @@
.TH Tcl_DetachPids 3 "" Tcl "Tcl Library Procedures"
.BS
.SH NAME
-Tcl_DetachPids, Tcl_ReapDetachedProcs \- manage child processes in background
+Tcl_DetachPids, Tcl_ReapDetachedProcs, Tcl_WaitPid \- manage child processes in background
.SH SYNOPSIS
.nf
\fB#include <tcl.h>\fR
@@ -19,14 +19,23 @@
\fBTcl_DetachPids\fR(\fInumPids, pidPtr\fR)
.sp
\fBTcl_ReapDetachedProcs\fR()
+.sp
+Tcl_Pid
+\fBTcl_WaitPid\fR(\fIpid, statPtr, options\fR)
.SH ARGUMENTS
.AS int *statusPtr
.AP int numPids in
Number of process ids contained in the array pointed to by \fIpidPtr\fR.
.AP int *pidPtr in
Address of array containing \fInumPids\fR process ids.
+.AP Tcl_Pid pid in
+The id of the process (pipe) to wait for.
+.AP int* statPtr out
+The result of waiting on a process (pipe). Either 0 or ECHILD.
+.AP int options
+The options controlling the wait. WNOHANG specifies not to wait when
+checking the process.
.BE
-
.SH DESCRIPTION
.PP
\fBTcl_DetachPids\fR and \fBTcl_ReapDetachedProcs\fR provide a
@@ -57,6 +66,12 @@
\fBexec\fR command may never get executed, you may wish to call
\fBTcl_ReapDetachedProcs\fR from time to time so that background
processes can be cleaned up.
+.PP
+\fBTcl_WaitPid\fR is a thin wrapper around the facilities provided by
+the operating system to wait on the end of a spawned process and to
+check a whether spawned process is still running. It is used by
+\fBTcl_ReapDetachedProcs\fR and the channel system to portably access
+the operating system.
.SH KEYWORDS
background, child, detach, process, wait
Index: unix/mkLinks
===================================================================
RCS file: /cvsroot/tcl/tcl/unix/mkLinks,v
retrieving revision 1.19
diff -u -r1.19 mkLinks
--- unix/mkLinks 2001/03/30 23:06:40 1.19
+++ unix/mkLinks 2001/03/31 10:50:26
@@ -311,8 +311,10 @@
if test -r DetachPids.3; then
rm -f Tcl_DetachPids.3
rm -f Tcl_ReapDetachedProcs.3
+ rm -f Tcl_WaitPid.3
ln DetachPids.3 Tcl_DetachPids.3
ln DetachPids.3 Tcl_ReapDetachedProcs.3
+ ln DetachPids.3 Tcl_WaitPid.3
fi
if test -r DoOneEvent.3; then
rm -f Tcl_DoOneEvent.3
@@ -759,6 +761,12 @@
ln SetErrno.3 Tcl_GetErrno.3
ln SetErrno.3 Tcl_ErrnoId.3
ln SetErrno.3 Tcl_ErrnoMsg.3
+fi
+if test -r Signal.3; then
+ rm -f Tcl_SignalId.3
+ rm -f Tcl_SignalMsg.3
+ ln Signal.3 Tcl_SignalId.3
+ ln Signal.3 Tcl_SignalMsg.3
fi
if test -r SetRecLmt.3; then
rm -f Tcl_SetRecursionLimit.3