spinlock.h 7.5 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4
#ifndef __LINUX_SPINLOCK_H
#define __LINUX_SPINLOCK_H

/*
I
Ingo Molnar 已提交
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
 * include/linux/spinlock.h - generic spinlock/rwlock declarations
 *
 * here's the role of the various spinlock/rwlock related include files:
 *
 * on SMP builds:
 *
 *  asm/spinlock_types.h: contains the raw_spinlock_t/raw_rwlock_t and the
 *                        initializers
 *
 *  linux/spinlock_types.h:
 *                        defines the generic type and initializers
 *
 *  asm/spinlock.h:       contains the __raw_spin_*()/etc. lowlevel
 *                        implementations, mostly inline assembly code
 *
 *   (also included on UP-debug builds:)
 *
 *  linux/spinlock_api_smp.h:
 *                        contains the prototypes for the _spin_*() APIs.
 *
 *  linux/spinlock.h:     builds the final spin_*() APIs.
 *
 * on UP builds:
 *
 *  linux/spinlock_type_up.h:
 *                        contains the generic, simplified UP spinlock type.
 *                        (which is an empty structure on non-debug builds)
 *
 *  linux/spinlock_types.h:
 *                        defines the generic type and initializers
 *
 *  linux/spinlock_up.h:
 *                        contains the __raw_spin_*()/etc. version of UP
 *                        builds. (which are NOPs on non-debug, non-preempt
 *                        builds)
 *
 *   (included on UP-non-debug builds:)
 *
 *  linux/spinlock_api_up.h:
 *                        builds the _spin_*() APIs.
 *
 *  linux/spinlock.h:     builds the final spin_*() APIs.
L
Linus Torvalds 已提交
47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
 */

#include <linux/config.h>
#include <linux/preempt.h>
#include <linux/linkage.h>
#include <linux/compiler.h>
#include <linux/thread_info.h>
#include <linux/kernel.h>
#include <linux/stringify.h>

#include <asm/system.h>

/*
 * Must define these before including other files, inline functions need them
 */
#define LOCK_SECTION_NAME                       \
        ".text.lock." __stringify(KBUILD_BASENAME)

#define LOCK_SECTION_START(extra)               \
        ".subsection 1\n\t"                     \
        extra                                   \
        ".ifndef " LOCK_SECTION_NAME "\n\t"     \
        LOCK_SECTION_NAME ":\n\t"               \
        ".endif\n"

#define LOCK_SECTION_END                        \
        ".previous\n\t"

#define __lockfunc fastcall __attribute__((section(".spinlock.text")))

/*
I
Ingo Molnar 已提交
78
 * Pull the raw_spinlock_t and raw_rwlock_t definitions:
L
Linus Torvalds 已提交
79
 */
I
Ingo Molnar 已提交
80
#include <linux/spinlock_types.h>
L
Linus Torvalds 已提交
81

I
Ingo Molnar 已提交
82
extern int __lockfunc generic__raw_read_trylock(raw_rwlock_t *lock);
L
Linus Torvalds 已提交
83 84

/*
I
Ingo Molnar 已提交
85
 * Pull the __raw*() functions/declarations (UP-nondebug doesnt need them):
L
Linus Torvalds 已提交
86
 */
I
Ingo Molnar 已提交
87 88
#if defined(CONFIG_SMP)
# include <asm/spinlock.h>
L
Linus Torvalds 已提交
89
#else
I
Ingo Molnar 已提交
90
# include <linux/spinlock_up.h>
L
Linus Torvalds 已提交
91 92
#endif

I
Ingo Molnar 已提交
93 94 95 96 97 98 99 100 101 102 103
#define spin_lock_init(lock)	do { *(lock) = SPIN_LOCK_UNLOCKED; } while (0)
#define rwlock_init(lock)	do { *(lock) = RW_LOCK_UNLOCKED; } while (0)

#define spin_is_locked(lock)	__raw_spin_is_locked(&(lock)->raw_lock)

/**
 * spin_unlock_wait - wait until the spinlock gets unlocked
 * @lock: the spinlock in question.
 */
#define spin_unlock_wait(lock)	__raw_spin_unlock_wait(&(lock)->raw_lock)

L
Linus Torvalds 已提交
104
/*
I
Ingo Molnar 已提交
105
 * Pull the _spin_*()/_read_*()/_write_*() functions/declarations:
L
Linus Torvalds 已提交
106
 */
I
Ingo Molnar 已提交
107 108
#if defined(CONFIG_SMP) || defined(CONFIG_DEBUG_SPINLOCK)
# include <linux/spinlock_api_smp.h>
L
Linus Torvalds 已提交
109
#else
I
Ingo Molnar 已提交
110
# include <linux/spinlock_api_up.h>
L
Linus Torvalds 已提交
111 112
#endif

I
Ingo Molnar 已提交
113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
#ifdef CONFIG_DEBUG_SPINLOCK
 extern void _raw_spin_lock(spinlock_t *lock);
#define _raw_spin_lock_flags(lock, flags) _raw_spin_lock(lock)
 extern int _raw_spin_trylock(spinlock_t *lock);
 extern void _raw_spin_unlock(spinlock_t *lock);

 extern void _raw_read_lock(rwlock_t *lock);
 extern int _raw_read_trylock(rwlock_t *lock);
 extern void _raw_read_unlock(rwlock_t *lock);
 extern void _raw_write_lock(rwlock_t *lock);
 extern int _raw_write_trylock(rwlock_t *lock);
 extern void _raw_write_unlock(rwlock_t *lock);
#else
# define _raw_spin_unlock(lock)		__raw_spin_unlock(&(lock)->raw_lock)
# define _raw_spin_trylock(lock)	__raw_spin_trylock(&(lock)->raw_lock)
# define _raw_spin_lock(lock)		__raw_spin_lock(&(lock)->raw_lock)
# define _raw_spin_lock_flags(lock, flags) \
		__raw_spin_lock_flags(&(lock)->raw_lock, *(flags))
# define _raw_read_lock(rwlock)		__raw_read_lock(&(rwlock)->raw_lock)
# define _raw_write_lock(rwlock)	__raw_write_lock(&(rwlock)->raw_lock)
# define _raw_read_unlock(rwlock)	__raw_read_unlock(&(rwlock)->raw_lock)
# define _raw_write_unlock(rwlock)	__raw_write_unlock(&(rwlock)->raw_lock)
# define _raw_read_trylock(rwlock)	__raw_read_trylock(&(rwlock)->raw_lock)
# define _raw_write_trylock(rwlock)	__raw_write_trylock(&(rwlock)->raw_lock)
#endif
L
Linus Torvalds 已提交
138

I
Ingo Molnar 已提交
139 140
#define read_can_lock(rwlock)		__raw_read_can_lock(&(rwlock)->raw_lock)
#define write_can_lock(rwlock)		__raw_write_can_lock(&(rwlock)->raw_lock)
L
Linus Torvalds 已提交
141 142 143 144 145 146

/*
 * Define the various spin_lock and rw_lock methods.  Note we define these
 * regardless of whether CONFIG_SMP or CONFIG_PREEMPT are set. The various
 * methods are defined as nops in the case they are not required.
 */
I
Ingo Molnar 已提交
147 148 149
#define spin_trylock(lock)		__cond_lock(_spin_trylock(lock))
#define read_trylock(lock)		__cond_lock(_read_trylock(lock))
#define write_trylock(lock)		__cond_lock(_write_trylock(lock))
L
Linus Torvalds 已提交
150

I
Ingo Molnar 已提交
151 152 153
#define spin_lock(lock)			_spin_lock(lock)
#define write_lock(lock)		_write_lock(lock)
#define read_lock(lock)			_read_lock(lock)
L
Linus Torvalds 已提交
154

I
Ingo Molnar 已提交
155
#if defined(CONFIG_SMP) || defined(CONFIG_DEBUG_SPINLOCK)
L
Linus Torvalds 已提交
156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173
#define spin_lock_irqsave(lock, flags)	flags = _spin_lock_irqsave(lock)
#define read_lock_irqsave(lock, flags)	flags = _read_lock_irqsave(lock)
#define write_lock_irqsave(lock, flags)	flags = _write_lock_irqsave(lock)
#else
#define spin_lock_irqsave(lock, flags)	_spin_lock_irqsave(lock, flags)
#define read_lock_irqsave(lock, flags)	_read_lock_irqsave(lock, flags)
#define write_lock_irqsave(lock, flags)	_write_lock_irqsave(lock, flags)
#endif

#define spin_lock_irq(lock)		_spin_lock_irq(lock)
#define spin_lock_bh(lock)		_spin_lock_bh(lock)

#define read_lock_irq(lock)		_read_lock_irq(lock)
#define read_lock_bh(lock)		_read_lock_bh(lock)

#define write_lock_irq(lock)		_write_lock_irq(lock)
#define write_lock_bh(lock)		_write_lock_bh(lock)

I
Ingo Molnar 已提交
174 175 176
#define spin_unlock(lock)		_spin_unlock(lock)
#define write_unlock(lock)		_write_unlock(lock)
#define read_unlock(lock)		_read_unlock(lock)
L
Linus Torvalds 已提交
177

I
Ingo Molnar 已提交
178 179
#define spin_unlock_irqrestore(lock, flags) \
					_spin_unlock_irqrestore(lock, flags)
L
Linus Torvalds 已提交
180 181 182
#define spin_unlock_irq(lock)		_spin_unlock_irq(lock)
#define spin_unlock_bh(lock)		_spin_unlock_bh(lock)

I
Ingo Molnar 已提交
183 184 185 186
#define read_unlock_irqrestore(lock, flags) \
					_read_unlock_irqrestore(lock, flags)
#define read_unlock_irq(lock)		_read_unlock_irq(lock)
#define read_unlock_bh(lock)		_read_unlock_bh(lock)
L
Linus Torvalds 已提交
187

I
Ingo Molnar 已提交
188 189 190 191
#define write_unlock_irqrestore(lock, flags) \
					_write_unlock_irqrestore(lock, flags)
#define write_unlock_irq(lock)		_write_unlock_irq(lock)
#define write_unlock_bh(lock)		_write_unlock_bh(lock)
L
Linus Torvalds 已提交
192

I
Ingo Molnar 已提交
193
#define spin_trylock_bh(lock)		__cond_lock(_spin_trylock_bh(lock))
L
Linus Torvalds 已提交
194 195 196 197 198

#define spin_trylock_irq(lock) \
({ \
	local_irq_disable(); \
	_spin_trylock(lock) ? \
I
Ingo Molnar 已提交
199
	1 : ({ local_irq_enable(); 0;  }); \
L
Linus Torvalds 已提交
200 201 202 203 204 205
})

#define spin_trylock_irqsave(lock, flags) \
({ \
	local_irq_save(flags); \
	_spin_trylock(lock) ? \
I
Ingo Molnar 已提交
206
	1 : ({ local_irq_restore(flags); 0; }); \
L
Linus Torvalds 已提交
207 208 209
})

/*
I
Ingo Molnar 已提交
210 211
 * Pull the atomic_t declaration:
 * (asm-mips/atomic.h needs above definitions)
L
Linus Torvalds 已提交
212
 */
I
Ingo Molnar 已提交
213 214 215 216 217
#include <asm/atomic.h>
/**
 * atomic_dec_and_lock - lock on reaching reference count zero
 * @atomic: the atomic counter
 * @lock: the spinlock in question
L
Linus Torvalds 已提交
218
 */
I
Ingo Molnar 已提交
219 220 221
extern int _atomic_dec_and_lock(atomic_t *atomic, spinlock_t *lock);
#define atomic_dec_and_lock(atomic, lock) \
		__cond_lock(_atomic_dec_and_lock(atomic, lock))
L
Linus Torvalds 已提交
222 223 224 225 226

/**
 * spin_can_lock - would spin_trylock() succeed?
 * @lock: the spinlock in question.
 */
I
Ingo Molnar 已提交
227
#define spin_can_lock(lock)	(!spin_is_locked(lock))
L
Linus Torvalds 已提交
228 229

#endif /* __LINUX_SPINLOCK_H */