diff options
Diffstat (limited to 'include/linux')
-rw-r--r-- | include/linux/mcs_spinlock.h | 77 | ||||
-rw-r--r-- | include/linux/mutex.h | 5 |
2 files changed, 80 insertions, 2 deletions
diff --git a/include/linux/mcs_spinlock.h b/include/linux/mcs_spinlock.h new file mode 100644 index 000000000000..9578ef81940b --- /dev/null +++ b/include/linux/mcs_spinlock.h | |||
@@ -0,0 +1,77 @@ | |||
1 | /* | ||
2 | * MCS lock defines | ||
3 | * | ||
4 | * This file contains the main data structure and API definitions of MCS lock. | ||
5 | * | ||
6 | * The MCS lock (proposed by Mellor-Crummey and Scott) is a simple spin-lock | ||
7 | * with the desirable properties of being fair, and with each cpu trying | ||
8 | * to acquire the lock spinning on a local variable. | ||
9 | * It avoids expensive cache bouncings that common test-and-set spin-lock | ||
10 | * implementations incur. | ||
11 | */ | ||
12 | #ifndef __LINUX_MCS_SPINLOCK_H | ||
13 | #define __LINUX_MCS_SPINLOCK_H | ||
14 | |||
15 | struct mcs_spinlock { | ||
16 | struct mcs_spinlock *next; | ||
17 | int locked; /* 1 if lock acquired */ | ||
18 | }; | ||
19 | |||
20 | /* | ||
21 | * Note: the smp_load_acquire/smp_store_release pair is not | ||
22 | * sufficient to form a full memory barrier across | ||
23 | * cpus for many architectures (except x86) for mcs_unlock and mcs_lock. | ||
24 | * For applications that need a full barrier across multiple cpus | ||
25 | * with mcs_unlock and mcs_lock pair, smp_mb__after_unlock_lock() should be | ||
26 | * used after mcs_lock. | ||
27 | */ | ||
28 | static inline | ||
29 | void mcs_spin_lock(struct mcs_spinlock **lock, struct mcs_spinlock *node) | ||
30 | { | ||
31 | struct mcs_spinlock *prev; | ||
32 | |||
33 | /* Init node */ | ||
34 | node->locked = 0; | ||
35 | node->next = NULL; | ||
36 | |||
37 | prev = xchg(lock, node); | ||
38 | if (likely(prev == NULL)) { | ||
39 | /* Lock acquired */ | ||
40 | node->locked = 1; | ||
41 | return; | ||
42 | } | ||
43 | ACCESS_ONCE(prev->next) = node; | ||
44 | /* | ||
45 | * Wait until the lock holder passes the lock down. | ||
46 | * Using smp_load_acquire() provides a memory barrier that | ||
47 | * ensures subsequent operations happen after the lock is acquired. | ||
48 | */ | ||
49 | while (!(smp_load_acquire(&node->locked))) | ||
50 | arch_mutex_cpu_relax(); | ||
51 | } | ||
52 | |||
53 | static inline | ||
54 | void mcs_spin_unlock(struct mcs_spinlock **lock, struct mcs_spinlock *node) | ||
55 | { | ||
56 | struct mcs_spinlock *next = ACCESS_ONCE(node->next); | ||
57 | |||
58 | if (likely(!next)) { | ||
59 | /* | ||
60 | * Release the lock by setting it to NULL | ||
61 | */ | ||
62 | if (cmpxchg(lock, node, NULL) == node) | ||
63 | return; | ||
64 | /* Wait until the next pointer is set */ | ||
65 | while (!(next = ACCESS_ONCE(node->next))) | ||
66 | arch_mutex_cpu_relax(); | ||
67 | } | ||
68 | /* | ||
69 | * Pass lock to next waiter. | ||
70 | * smp_store_release() provides a memory barrier to ensure | ||
71 | * all operations in the critical section has been completed | ||
72 | * before unlocking. | ||
73 | */ | ||
74 | smp_store_release(&next->locked, 1); | ||
75 | } | ||
76 | |||
77 | #endif /* __LINUX_MCS_SPINLOCK_H */ | ||
diff --git a/include/linux/mutex.h b/include/linux/mutex.h index d3181936c138..c482e1d2cc49 100644 --- a/include/linux/mutex.h +++ b/include/linux/mutex.h | |||
@@ -46,6 +46,7 @@ | |||
46 | * - detects multi-task circular deadlocks and prints out all affected | 46 | * - detects multi-task circular deadlocks and prints out all affected |
47 | * locks and tasks (and only those tasks) | 47 | * locks and tasks (and only those tasks) |
48 | */ | 48 | */ |
49 | struct mcs_spinlock; | ||
49 | struct mutex { | 50 | struct mutex { |
50 | /* 1: unlocked, 0: locked, negative: locked, possible waiters */ | 51 | /* 1: unlocked, 0: locked, negative: locked, possible waiters */ |
51 | atomic_t count; | 52 | atomic_t count; |
@@ -55,7 +56,7 @@ struct mutex { | |||
55 | struct task_struct *owner; | 56 | struct task_struct *owner; |
56 | #endif | 57 | #endif |
57 | #ifdef CONFIG_MUTEX_SPIN_ON_OWNER | 58 | #ifdef CONFIG_MUTEX_SPIN_ON_OWNER |
58 | void *spin_mlock; /* Spinner MCS lock */ | 59 | struct mcs_spinlock *mcs_lock; /* Spinner MCS lock */ |
59 | #endif | 60 | #endif |
60 | #ifdef CONFIG_DEBUG_MUTEXES | 61 | #ifdef CONFIG_DEBUG_MUTEXES |
61 | const char *name; | 62 | const char *name; |
@@ -179,4 +180,4 @@ extern int atomic_dec_and_mutex_lock(atomic_t *cnt, struct mutex *lock); | |||
179 | # define arch_mutex_cpu_relax() cpu_relax() | 180 | # define arch_mutex_cpu_relax() cpu_relax() |
180 | #endif | 181 | #endif |
181 | 182 | ||
182 | #endif | 183 | #endif /* __LINUX_MUTEX_H */ |