Whamcloud - gitweb
b=21853 define cfs_*_nested for CONFIG_DEBUG_LOCK_ALLOC=y
[fs/lustre-release.git] / libcfs / include / libcfs / linux / linux-lock.h
index 67a65cb..18dbfc8 100644 (file)
  * declared by CFS_DECL_* should be initialized explicitly.
  */
 
-
 /*
- * spin_lock (use Linux kernel's primitives)
+ * spin_lock "implementation" (use Linux kernel's primitives)
  *
  * - spin_lock_init(x)
  * - spin_lock(x)
+ * - spin_lock_bh(x)
+ * - spin_lock_bh_init(x)
  * - spin_unlock(x)
+ * - spin_unlock_bh(x)
  * - spin_trylock(x)
+ * - spin_is_locked(x)
  *
+ * - spin_lock_irq(x)
  * - spin_lock_irqsave(x, f)
  * - spin_unlock_irqrestore(x, f)
+ * - read_lock_irqsave(lock, f)
+ * - write_lock_irqsave(lock, f)
+ * - write_unlock_irqrestore(lock, f)
+ *
+ * - SPIN_LOCK_UNLOCKED
  */
 
 /*
- * rw_semaphore (use Linux kernel's primitives)
+ * spinlock "implementation"
+ */
+
+typedef spinlock_t cfs_spinlock_t;
+
+#define cfs_spin_lock_init(lock)             spin_lock_init(lock)
+#define cfs_spin_lock(lock)                  spin_lock(lock)
+#define cfs_spin_lock_bh(lock)               spin_lock_bh(lock)
+#define cfs_spin_lock_bh_init(lock)          spin_lock_bh_init(lock)
+#define cfs_spin_unlock(lock)                spin_unlock(lock)
+#define cfs_spin_unlock_bh(lock)             spin_unlock_bh(lock)
+#define cfs_spin_trylock(lock)               spin_trylock(lock)
+#define cfs_spin_is_locked(lock)             spin_is_locked(lock)
+
+#define cfs_spin_lock_irq(lock)              spin_lock_irq(lock)
+#define cfs_spin_unlock_irq(lock)            spin_unlock_irq(lock)
+#define cfs_read_lock_irqsave(lock, f)       read_lock_irqsave(lock, f)
+#define cfs_write_lock_irqsave(lock, f)      write_lock_irqsave(lock, f)
+#define cfs_write_unlock_irqrestore(lock, f) write_unlock_irqrestore(lock, f)
+#define cfs_spin_lock_irqsave(lock, f)       spin_lock_irqsave(lock, f)
+#define cfs_spin_unlock_irqrestore(lock, f)  spin_unlock_irqrestore(lock, f)
+
+#define CFS_SPIN_LOCK_UNLOCKED               SPIN_LOCK_UNLOCKED
+
+/*
+ * rw_semaphore "implementation" (use Linux kernel's primitives)
  *
+ * - sema_init(x)
  * - init_rwsem(x)
  * - down_read(x)
  * - up_read(x)
  * - down_write(x)
  * - up_write(x)
  */
-#define fini_rwsem(s) do {} while(0)
+typedef struct rw_semaphore cfs_rw_semaphore_t;
+
+#define cfs_sema_init(s, val)     sema_init(s, val)
+#define cfs_init_rwsem(s)         init_rwsem(s)
+#define cfs_down_read(s)          down_read(s)
+#define cfs_down_read_trylock(s)  down_read_trylock(s)
+#define cfs_up_read(s)            up_read(s)
+#define cfs_down_write(s)         down_write(s)
+#define cfs_down_write_trylock(s) down_write_trylock(s)
+#define cfs_up_write(s)           up_write(s)
+
+#define cfs_fini_rwsem(s)         do {} while(0)
+
+#define CFS_DECLARE_RWSEM(name)   DECLARE_RWSEM(name)
 
 /*
- * rwlock_t (use Linux kernel's primitives)
+ * semaphore "implementation" (use Linux kernel's primitives)
+ */
+typedef struct semaphore      cfs_semaphore_t;
+
+/*
+ * rwlock_t "implementation" (use Linux kernel's primitives)
  *
  * - rwlock_init(x)
  * - read_lock(x)
  * - read_unlock(x)
  * - write_lock(x)
  * - write_unlock(x)
+ * - write_lock_bh(x)
+ * - write_unlock_bh(x)
+ *
+ * - RW_LOCK_UNLOCKED
  */
+typedef rwlock_t cfs_rwlock_t;
+
+#define cfs_rwlock_init(lock)                  rwlock_init(lock)
+#define cfs_read_lock(lock)                    read_lock(lock)
+#define cfs_read_unlock(lock)                  read_unlock(lock)
+#define cfs_read_unlock_irqrestore(lock,flags) \
+        read_unlock_irqrestore(lock, flags)
+#define cfs_write_lock(lock)                   write_lock(lock)
+#define cfs_write_unlock(lock)                 write_unlock(lock)
+#define cfs_write_lock_bh(lock)                write_lock_bh(lock)
+#define cfs_write_unlock_bh(lock)              write_unlock_bh(lock)
+
+#define CFS_RW_LOCK_UNLOCKED                   RW_LOCK_UNLOCKED
 
 /*
- * mutex:
+ * completion "implementation" (use Linux kernel's primitives)
  *
- * - init_mutex(x)
- * - init_mutex_locked(x)
- * - mutex_up(x)
- * - mutex_down(x)
+ * - DECLARE_COMPLETION(work)
+ * - INIT_COMPLETION(c)
+ * - COMPLETION_INITIALIZER(work)
+ * - init_completion(c)
+ * - complete(c)
+ * - wait_for_completion(c)
+ * - wait_for_completion_interruptible(c)
+ * - fini_completion(c)
  */
-#define init_mutex(x)                   init_MUTEX(x)
-#define init_mutex_locked(x)            init_MUTEX_LOCKED(x)
-#define mutex_up(x)                     up(x)
-#define mutex_down(x)                   down(x)
-#define mutex_down_trylock(x)           down_trylock(x)
+typedef struct completion cfs_completion_t;
+
+#define CFS_DECLARE_COMPLETION(work)             DECLARE_COMPLETION(work)
+#define CFS_INIT_COMPLETION(c)                   INIT_COMPLETION(c)
+#define CFS_COMPLETION_INITIALIZER(work)         COMPLETION_INITIALIZER(work)
+#define cfs_init_completion(c)                   init_completion(c)
+#define cfs_complete(c)                          complete(c)
+#define cfs_wait_for_completion(c)               wait_for_completion(c)
+#define cfs_wait_for_completion_interruptible(c) \
+        wait_for_completion_interruptible(c)
+#define cfs_complete_and_exit(c, code)           complete_and_exit(c, code)
+#define cfs_fini_completion(c)                   do { } while (0)
 
 /*
- * completion (use Linux kernel's primitives)
+ * mutex "implementation" (use Linux kernel's primitives)
  *
- * - init_complition(c)
- * - complete(c)
- * - wait_for_completion(c)
+ * - DECLARE_MUTEX(name)
+ * - mutex_init(x)
+ * - init_mutex(x)
+ * - init_mutex_locked(x)
+ * - init_MUTEX_LOCKED(x)
+ * - mutex_up(x)
+ * - mutex_down(x)
+ * - up(x)
+ * - down(x)
+ * - mutex_down_trylock(x)
+ * - mutex_lock(x)
+ * - mutex_unlock(x)
  */
+typedef struct mutex cfs_mutex_t;
+
+#define CFS_DEFINE_MUTEX(name)             DEFINE_MUTEX(name)
+#define CFS_DECLARE_MUTEX(name)            DECLARE_MUTEX(name)
+
+#define cfs_mutex_init(x)                   mutex_init(x)
+#define cfs_init_mutex(x)                   init_MUTEX(x)
+#define cfs_init_mutex_locked(x)            init_MUTEX_LOCKED(x)
+#define cfs_mutex_up(x)                     up(x)
+#define cfs_mutex_down(x)                   down(x)
+#define cfs_up(x)                           up(x)
+#define cfs_down(x)                         down(x)
+#define cfs_mutex_down_trylock(x)           down_trylock(x)
+#define cfs_mutex_lock(x)                   mutex_lock(x)
+#define cfs_mutex_unlock(x)                 mutex_unlock(x)
+#define cfs_mutex_trylock(x)                mutex_trylock(x)
 
 #if LINUX_VERSION_CODE < KERNEL_VERSION(2,6,16)
 
  *
  **************************************************************************/
 
-struct mutex;
-
-static inline void mutex_destroy(struct mutex *lock)
+static inline void cfs_mutex_destroy(cfs_mutex_t *lock)
 {
 }
 
@@ -140,12 +244,24 @@ static inline void mutex_destroy(struct mutex *lock)
  *
  * \retval 0 mutex is not locked. This should never happen.
  */
-static inline int mutex_is_locked(struct mutex *lock)
+static inline int cfs_mutex_is_locked(cfs_mutex_t *lock)
 {
         return 1;
 }
+#else /* LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,16) */
+#define cfs_mutex_destroy(x)    mutex_destroy(x)
+#define cfs_mutex_is_locked(x)  mutex_is_locked(x)
 #endif /* LINUX_VERSION_CODE < KERNEL_VERSION(2,6,16) */
 
+/*
+ * Kernel locking primitives
+ *
+ * - lock_kernel
+ * - unlock_kernel
+ */
+#define cfs_lock_kernel()      lock_kernel()
+#define cfs_unlock_kernel()    unlock_kernel()
+
 #ifndef lockdep_set_class
 
 /**************************************************************************
@@ -154,67 +270,63 @@ static inline int mutex_is_locked(struct mutex *lock)
  *
  **************************************************************************/
 
-struct lock_class_key {
+typedef struct cfs_lock_class_key {
         ;
-};
+} cfs_lock_class_key_t;
 
-# define lockdep_set_class(lock, key) \
+#define cfs_lockdep_set_class(lock, key) \
         do { (void)sizeof (lock);(void)sizeof (key); } while (0)
 /* This has to be a macro, so that `subclass' can be undefined in kernels that
  * do not support lockdep. */
 
 
-static inline void lockdep_off(void)
+static inline void cfs_lockdep_off(void)
 {
 }
 
-static inline void lockdep_on(void)
+static inline void cfs_lockdep_on(void)
 {
 }
+#else
+typedef struct lock_class_key cfs_lock_class_key_t;
 
+#define cfs_lockdep_set_class(lock, key) lockdep_set_class(lock, key)
+#define cfs_lockdep_off()                lockdep_off()
+#define cfs_lockdep_on()                 lockdep_on()
 #endif /* lockdep_set_class */
 
 #ifndef CONFIG_DEBUG_LOCK_ALLOC
 #ifndef mutex_lock_nested
-# define mutex_lock_nested(mutex, subclass) mutex_lock(mutex)
+#define cfs_mutex_lock_nested(mutex, subclass) mutex_lock(mutex)
+#else
+#define cfs_mutex_lock_nested(mutex, subclass) \
+        mutex_lock_nested(mutex, subclass)
 #endif
 
 #ifndef spin_lock_nested
-# define spin_lock_nested(lock, subclass) spin_lock(lock)
+#define cfs_spin_lock_nested(lock, subclass) spin_lock(lock)
+#else
+#define cfs_spin_lock_nested(lock, subclass) spin_lock_nested(lock, subclass)
 #endif
 
 #ifndef down_read_nested
-# define down_read_nested(lock, subclass) down_read(lock)
+#define cfs_down_read_nested(lock, subclass) down_read(lock)
+#else
+#define cfs_down_read_nested(lock, subclass) down_read_nested(lock, subclass)
 #endif
 
 #ifndef down_write_nested
-# define down_write_nested(lock, subclass) down_write(lock)
+#define cfs_down_write_nested(lock, subclass) down_write(lock)
+#else
+#define cfs_down_write_nested(lock, subclass) down_write_nested(lock, subclass)
 #endif
+#else /* CONFIG_DEBUG_LOCK_ALLOC is defined */
+#define cfs_mutex_lock_nested(mutex, subclass) \
+        mutex_lock_nested(mutex, subclass)
+#define cfs_spin_lock_nested(lock, subclass) spin_lock_nested(lock, subclass)
+#define cfs_down_read_nested(lock, subclass) down_read_nested(lock, subclass)
+#define cfs_down_write_nested(lock, subclass) down_write_nested(lock, subclass)
 #endif /* CONFIG_DEBUG_LOCK_ALLOC */
 
 
-/*
- * spinlock "implementation"
- */
-
-typedef spinlock_t cfs_spinlock_t;
-
-#define cfs_spin_lock_init(lock) spin_lock_init(lock)
-#define cfs_spin_lock(lock)      spin_lock(lock)
-#define cfs_spin_lock_bh(lock)   spin_lock_bh(lock)
-#define cfs_spin_unlock(lock)    spin_unlock(lock)
-#define cfs_spin_unlock_bh(lock) spin_unlock_bh(lock)
-
-/*
- * rwlock "implementation"
- */
-
-typedef rwlock_t cfs_rwlock_t;
-
-#define cfs_rwlock_init(lock)      rwlock_init(lock)
-#define cfs_read_lock(lock)        read_lock(lock)
-#define cfs_read_unlock(lock)      read_unlock(lock)
-#define cfs_write_lock_bh(lock)    write_lock_bh(lock)
-#define cfs_write_unlock_bh(lock)  write_unlock_bh(lock)
-
 #endif /* __LIBCFS_LINUX_CFS_LOCK_H__ */