Changeset 573 for trunk/libs/libsemaphore

Timestamp:

Oct 5, 2018, 12:21:52 AM (6 years ago)

Author:

alain

Message:

Cosmetic.

Location:

trunk/libs/libsemaphore

Files:

• semaphore.c (modified) (1 diff)
• semaphore.h (modified) (4 diffs)

trunk/libs/libsemaphore/semaphore.c

@@ -1 +1 @@
 /*
- * pthread.c - User leve <semaphore> library implementation.
+ * pthread.c - User level <semaphore> library implementation.
  * 
  * Author     Alain Greiner (2016,2017,2018)

trunk/libs/libsemaphore/semaphore.h

@@ -2 +2 @@
  * pthread.h - User level <semaphore> library definition.
  * 
- * Author     Alain Greiner (2016,2017)
+ * Author     Alain Greiner (2016,2017,2018)
  *
  * Copyright (c) UPMC Sorbonne Universites
@@ -33 +33 @@
 /********************************************************************************************* 
  * This function initializes an unnamed semaphore.
- * Process shared semaphores are not supported in this implementation.
  * Initializing a semaphore that has already been initialized results in undefined behavior.
  *********************************************************************************************
@@ -46 +45 @@
 
 /********************************************************************************************* 
- * This blocking function locks a semaphore. It decrements the semaphore pointed to by <sem>.
+ * This blocking function takes a semaphore. It decrements the semaphore pointed to by <sem>.
  * If the semaphore's value is greater than zero, then the decrement proceeds, and the
- * function returns immediately. If the semaphore currently has the value zero, then the call
- * blocks until it becomes possible to perform the decrement.
+ * function returns immediately. If the semaphore currently has the value zero, the calling
+ * thread registers in the associated waiting queue, blocks and deschedules.
+ * It will be unblocked by another thread when it becomes possible to perform the decrement.
  *********************************************************************************************
  * @ sem         : [in]  pointer on semaphore.
@@ -57 +57 @@
 
 /********************************************************************************************* 
- * This function unlocks a semaphore. It increments the semaphore pointed to by <sem>.
+ * This function releases a semaphore. It increments the semaphore pointed to by <sem>.
  * If the semaphore's value consequently becomes greater than zero, then another thread
- * blocked in a sem_wait() call will be woken up and proceed to lock the semaphore.
+ * blocked in a sem_wait() call will be woken up to try to take the semaphore.
  *********************************************************************************************
  * @ sem         : [in]  pointer on semaphore.