Changeset 391f6628 in rtems

Timestamp:

02/13/96 15:38:37 (28 years ago)

Author:

Joel Sherrill <joel.sherrill@…>

Branches:

4.10, 4.11, 4.8, 4.9, 5, master

Children:

6ca1184

Parents:

b38955b

Message:

more comments added and existing ones cleaned up in synchronization paths

Files:

• c/src/exec/score/src/threadq.c (modified) (2 diffs)
• cpukit/score/src/threadq.c (modified) (2 diffs)

c/src/exec/score/src/threadq.c

@@ -327 +327 @@
     case OBJECTS_LOCAL:
       the_thread_queue = the_thread->Wait.queue;
+
+      /*
+       *  If the_thread_queue is not synchronized, then it is either
+       *  "nothing happened", "timeout", or "satisfied".   If the_thread
+       *  is the executing thread, then it is in the process of blocking
+       *  and it is the thread which is responsible for the synchronization
+       *  process.
+       *
+       *  If it is not satisfied, then it is "nothing happened" and
+       *  this is the "timeout" transition.  After a request is satisfied,
+       *  a timeout is not allowed to occur.
+       */
 
       if ( the_thread_queue->sync_state != THREAD_QUEUE_SYNCHRONIZED &&
@@ -715 +727 @@
     case THREAD_QUEUE_NOTHING_HAPPENED:
       /*
-       *  All of this was dealt with above.  This should never happen.
+       *  This should never happen.  All of this was dealt with above.
        */
       break;

cpukit/score/src/threadq.c

@@ -327 +327 @@
     case OBJECTS_LOCAL:
       the_thread_queue = the_thread->Wait.queue;
+
+      /*
+       *  If the_thread_queue is not synchronized, then it is either
+       *  "nothing happened", "timeout", or "satisfied".   If the_thread
+       *  is the executing thread, then it is in the process of blocking
+       *  and it is the thread which is responsible for the synchronization
+       *  process.
+       *
+       *  If it is not satisfied, then it is "nothing happened" and
+       *  this is the "timeout" transition.  After a request is satisfied,
+       *  a timeout is not allowed to occur.
+       */
 
       if ( the_thread_queue->sync_state != THREAD_QUEUE_SYNCHRONIZED &&
@@ -715 +727 @@
     case THREAD_QUEUE_NOTHING_HAPPENED:
       /*
-       *  All of this was dealt with above.  This should never happen.
+       *  This should never happen.  All of this was dealt with above.
        */
       break;