Changeset 11 for trunk/kernel/libk/remote_spinlock.h

Timestamp:

Apr 26, 2017, 2:29:23 PM (7 years ago)

Author:

alain

Message:

Merge all FS related files in one single vfs directory.

File:

• trunk/kernel/libk/remote_spinlock.h (modified) (3 diffs)

trunk/kernel/libk/remote_spinlock.h

@@ -48 +48 @@
  * This function initializes a remote spinlock.
  ***************************************************************************************
- * @ lock    : extended pointer on the remote spinlock
+ * @ lock_xp : extended pointer on the remote spinlock
  **************************************************************************************/
-void remote_spinlock_init( xptr_t   lock );
+void remote_spinlock_init( xptr_t   lock_xp );
+
+/*******************************************************************************************
+ * This blocking function uses a busy waiting strategy to lock a remote spinlock.
+ * It polls the lock and returns only when the lock has been taken.
+ * All IRQs are disabled and will keep disabled until the lock is released. 
+ * It increments the calling thread local_locks count when the lock has been taken.
+ *******************************************************************************************
+ * @ lock_xp    : extended pointer on the remote spinlock.
+ * @ irq_state  : buffer to save the SR state (in the calling thread stack)
+ ******************************************************************************************/
+void remote_spinlock_lock_busy( xptr_t     lock_xp,
+                                uint32_t * irq_state );
+
+/*******************************************************************************************
+ * This function releases a remote busy_waiting spinlock.
+ * It restores the CPU SR state.
+ *******************************************************************************************
+ * @ lock_xp    : extended pointer on remote spinlock.
+ * @ irq_state  : value to be resrored in CPU SR 
+ ******************************************************************************************/
+void remote_spinlock_unlock_busy( xptr_t     lock_xp,
+                                  uint32_t   irq_state );
 
 /***************************************************************************************
@@ -58 +80 @@
  * It increments the calling thread locks count when the lock has been taken.
  ***************************************************************************************
- * @ lock    : extended pointer on the remote spinlock
+ * @ lock_xp   : extended pointer on the remote spinlock
  **************************************************************************************/
-void remote_spinlock_lock( xptr_t lock );
+void remote_spinlock_lock( xptr_t lock_xp );
 
 /***************************************************************************************
@@ -66 +88 @@
  * It increments the calling thread locks count in case of success.
  ***************************************************************************************
- * @ lock    : extended pointer on the remote spinlock
+ * @ lock_xp    : extended pointer on the remote spinlock
  * @ returns O if success / returns non zero if lock already taken.
  **************************************************************************************/
-uint32_t remote_spinlock_trylock( xptr_t lock );
+error_t remote_spinlock_trylock( xptr_t  lock_xp );
 
 /***************************************************************************************
  * This function releases a remote spinlock.
  ***************************************************************************************
- * @ lock    : extended pointer on the remote spinlock
+ * @ lock_xp    : extended pointer on the remote spinlock
  **************************************************************************************/
-void remote_spinlock_unlock( xptr_t lock );
+void remote_spinlock_unlock( xptr_t  lock_xp );
 
 #endif