Changeset 05e2a7ad in mainline for generic/include/proc/thread.h

Timestamp:

2005-12-07T13:32:31Z (20 years ago)

Author:

Jakub Jermar <jakub@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

839470f

Parents:

253f8590

Message:

Add comments describing locking rules for some locks.
Cleanup.

File:

• generic/include/proc/thread.h (modified) (2 diffs)

generic/include/proc/thread.h

@@ -65 +65 @@
         link_t threads_link;                    /**< Link to the list of all threads. */
         
-        /* items below are protected by lock */
+        /** Lock protecting thread structure.
+         *
+         * Protects the whole thread structure except list links above.
+         * Must be acquired before T.lock for each T of type task_t.
+         * 
+         */
         spinlock_t lock;
 
@@ -110 +115 @@
 };
 
-extern spinlock_t threads_lock;                 /**< Lock protecting threads_head list. */
+/** Thread list lock.
+ *
+ * This lock protects all link_t structures chained in threads_head.
+ * Must be acquired before T.lock for each T of type thread_t.
+ *
+ */
+extern spinlock_t threads_lock;
+
 extern link_t threads_head;                     /**< List of all threads in the system. */