diff options
author | hershey <hershey@noemail.net> | 1999-04-16 22:53:43 (GMT) |
---|---|---|
committer | hershey <hershey@noemail.net> | 1999-04-16 22:53:43 (GMT) |
commit | ae0edef68c40464f7d70820d8980e639aaeaed39 (patch) | |
tree | 3977126c2fc9f4c7d38da0d44d1c02a3f8b107b9 /doc/Thread.3 | |
parent | 997b31f580d7baebe2c4e486a15cbcab70615bcd (diff) | |
download | tcl-ae0edef68c40464f7d70820d8980e639aaeaed39.zip tcl-ae0edef68c40464f7d70820d8980e639aaeaed39.tar.gz tcl-ae0edef68c40464f7d70820d8980e639aaeaed39.tar.bz2 |
added Tcl_DStringTrunc to DString.3
added mention of Tcl_ThreadQueueEvent, Tcl_ThreadAlert to Notifier.3
added Tcl_ThreadQueueEvent, Tcl_ThreadAlert, and Tcl_GetCurrentThread to
Thread.3
FossilOrigin-Name: 401c4cabb05a3bdc401aa51f2d7de8415e89464c
Diffstat (limited to 'doc/Thread.3')
-rw-r--r-- | doc/Thread.3 | 18 |
1 files changed, 16 insertions, 2 deletions
diff --git a/doc/Thread.3 b/doc/Thread.3 index 595fac3..733bb52 100644 --- a/doc/Thread.3 +++ b/doc/Thread.3 @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: Thread.3,v 1.2 1999/04/16 00:46:33 stanton Exp $ +'\" RCS: @(#) $Id: Thread.3,v 1.3 1999/04/16 22:53:43 hershey Exp $ '\" .so man.macros .TH Tcl_ConditionNotify 3 "8.1" Tcl "Tcl Library Procedures" @@ -21,6 +21,9 @@ void void \fBTcl_ConditionWait\fR(\fIcondPtr, mutexPtr, timePtr\fR) .sp +Tcl_ThreadId +\fBTcl_GetCurrentThread\fR() +.sp VOID * \fBTcl_GetThreadData\fR(\fIkeyPtr, size\fR) .sp @@ -29,6 +32,10 @@ void .sp void \fBTcl_MutexUnlock\fR(\fImutexPtr\fR) +.sp +\fBTcl_ThreadAlert\fR(\fIthreadId\fR) +.sp +\fBTcl_ThreadQueueEvent\fR(\fIthreadId, evPtr, position\fR) .SH ARGUMENTS .AS Tcl_ThreadDataKey *keyPtr .AP Tcl_Condition *condPtr in @@ -77,11 +84,18 @@ The caller of \fBTcl_ConditionWait\fR should be prepared for spurious notifications by calling \fBTcl_ConditionWait\fR within a while loop that tests some invariant. .PP +The \fBTcl_GetCurrentThread\fR call returns the thread Id of the +thread in which the call is made. The thread Id can be used in calls +to \fBTcl_ThreadQueueEvent\fR and \fBTcl_ThreadAlert\fR. These +procedures are essentially mutex-protected vesions of +\fBTcl_AlertNotifier\fR and \fBTcl_QueueEvent\fR, respectively. See +the manual entry for \fBNotifier\fR for more details. +.PP The \fBTcl_GetThreadData\fR call returns a pointer to a block of thread-private data. Its argument is a key that is shared by all threads and a size for the block of storage. The storage is automatically allocated and initialized to all zeros the first time each thread asks for it. -The storage is automatically deallocated by \fBTcl_FinalizeThread\fR +The storage is automatically deallocated by \fBTcl_FinalizeThread\fR. .SH INITIALIZATION .PP .PP |