From f6d082148be6185a2d2414c464312b7b43bdcbc1 Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Tue, 16 Nov 1999 16:07:52 +0000
Subject: Added prototype for _Thread_Reset() and numerous comments.

---
 c/src/exec/score/include/rtems/score/thread.h | 32 +++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

(limited to 'c/src/exec/score')

diff --git a/c/src/exec/score/include/rtems/score/thread.h b/c/src/exec/score/include/rtems/score/thread.h
index bfc42b6fad..8ac9e8ed26 100644
--- a/c/src/exec/score/include/rtems/score/thread.h
+++ b/c/src/exec/score/include/rtems/score/thread.h
@@ -386,7 +386,10 @@ void _Thread_Stack_Free(
  *
  *  DESCRIPTION:
  *
- *  XXX
+ *  This routine initializes the specified the thread.  It allocates
+ *  all memory associated with this thread.  It completes by adding
+ *  the thread to the local object table so operations on this
+ *  thread id are allowed.
  *
  *  NOTES:
  *
@@ -415,7 +418,9 @@ boolean _Thread_Initialize(
  *
  *  DESCRIPTION:
  *
- *  XXX
+ *  This routine initializes the executable information for a thread
+ *  and makes it ready to execute.  After this routine executes, the
+ *  thread competes with all other threads for CPU time.
  */
  
 boolean _Thread_Start(
@@ -431,7 +436,9 @@ boolean _Thread_Start(
  *
  *  DESCRIPTION:
  *
- *  XXX
+ *  This support routine restarts the specified task in a way that the
+ *  next time this thread executes, it will begin execution at its
+ *  original starting point.
  */
  
 /* XXX multiple task arg profiles */
@@ -442,12 +449,29 @@ boolean _Thread_Restart(
   unsigned32                numeric_argument
 );
 
+/*
+ *  _Thread_Reset
+ *
+ *  DESCRIPTION:
+ *
+ *  This routine resets a thread to its initial state but does
+ *  not restart it.
+ */
+ 
+void _Thread_Reset(
+  Thread_Control      *the_thread,
+  void                *pointer_argument,
+  unsigned32           numeric_argument
+);
+
 /*
  *  _Thread_Close
  *
  *  DESCRIPTION:
  *
- *  XXX
+ *  This routine frees all memory associated with the specified
+ *  thread and removes it from the local object table so no further
+ *  operations on this thread are allowed.
  */
  
 void _Thread_Close(
-- 
cgit v1.2.3