forked from mirrors/linux
		
	 a7306f3c28
			
		
	
	
		a7306f3c28
		
	
	
	
	
		
			
			Remove the use of contractions and use proper punctuation in #error directive messages that discourage the direct inclusion of header files. Link: https://lkml.kernel.org/r/20241105032231.28833-1-natanielfarzan@gmail.com Signed-off-by: Nataniel Farzan <natanielfarzan@gmail.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
		
			
				
	
	
		
			186 lines
		
	
	
	
		
			5.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			186 lines
		
	
	
	
		
			5.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| #ifndef __LINUX_SPINLOCK_API_SMP_H
 | |
| #define __LINUX_SPINLOCK_API_SMP_H
 | |
| 
 | |
| #ifndef __LINUX_INSIDE_SPINLOCK_H
 | |
| # error "Please do not include this file directly."
 | |
| #endif
 | |
| 
 | |
| /*
 | |
|  * include/linux/spinlock_api_smp.h
 | |
|  *
 | |
|  * spinlock API declarations on SMP (and debug)
 | |
|  * (implemented in kernel/spinlock.c)
 | |
|  *
 | |
|  * portions Copyright 2005, Red Hat, Inc., Ingo Molnar
 | |
|  * Released under the General Public License (GPL).
 | |
|  */
 | |
| 
 | |
| int in_lock_functions(unsigned long addr);
 | |
| 
 | |
| #define assert_raw_spin_locked(x)	BUG_ON(!raw_spin_is_locked(x))
 | |
| 
 | |
| void __lockfunc _raw_spin_lock(raw_spinlock_t *lock)		__acquires(lock);
 | |
| void __lockfunc _raw_spin_lock_nested(raw_spinlock_t *lock, int subclass)
 | |
| 								__acquires(lock);
 | |
| void __lockfunc
 | |
| _raw_spin_lock_nest_lock(raw_spinlock_t *lock, struct lockdep_map *map)
 | |
| 								__acquires(lock);
 | |
| void __lockfunc _raw_spin_lock_bh(raw_spinlock_t *lock)		__acquires(lock);
 | |
| void __lockfunc _raw_spin_lock_irq(raw_spinlock_t *lock)
 | |
| 								__acquires(lock);
 | |
| 
 | |
| unsigned long __lockfunc _raw_spin_lock_irqsave(raw_spinlock_t *lock)
 | |
| 								__acquires(lock);
 | |
| unsigned long __lockfunc
 | |
| _raw_spin_lock_irqsave_nested(raw_spinlock_t *lock, int subclass)
 | |
| 								__acquires(lock);
 | |
| int __lockfunc _raw_spin_trylock(raw_spinlock_t *lock);
 | |
| int __lockfunc _raw_spin_trylock_bh(raw_spinlock_t *lock);
 | |
| void __lockfunc _raw_spin_unlock(raw_spinlock_t *lock)		__releases(lock);
 | |
| void __lockfunc _raw_spin_unlock_bh(raw_spinlock_t *lock)	__releases(lock);
 | |
| void __lockfunc _raw_spin_unlock_irq(raw_spinlock_t *lock)	__releases(lock);
 | |
| void __lockfunc
 | |
| _raw_spin_unlock_irqrestore(raw_spinlock_t *lock, unsigned long flags)
 | |
| 								__releases(lock);
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_LOCK
 | |
| #define _raw_spin_lock(lock) __raw_spin_lock(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_LOCK_BH
 | |
| #define _raw_spin_lock_bh(lock) __raw_spin_lock_bh(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_LOCK_IRQ
 | |
| #define _raw_spin_lock_irq(lock) __raw_spin_lock_irq(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_LOCK_IRQSAVE
 | |
| #define _raw_spin_lock_irqsave(lock) __raw_spin_lock_irqsave(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_TRYLOCK
 | |
| #define _raw_spin_trylock(lock) __raw_spin_trylock(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_TRYLOCK_BH
 | |
| #define _raw_spin_trylock_bh(lock) __raw_spin_trylock_bh(lock)
 | |
| #endif
 | |
| 
 | |
| #ifndef CONFIG_UNINLINE_SPIN_UNLOCK
 | |
| #define _raw_spin_unlock(lock) __raw_spin_unlock(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_UNLOCK_BH
 | |
| #define _raw_spin_unlock_bh(lock) __raw_spin_unlock_bh(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_UNLOCK_IRQ
 | |
| #define _raw_spin_unlock_irq(lock) __raw_spin_unlock_irq(lock)
 | |
| #endif
 | |
| 
 | |
| #ifdef CONFIG_INLINE_SPIN_UNLOCK_IRQRESTORE
 | |
| #define _raw_spin_unlock_irqrestore(lock, flags) __raw_spin_unlock_irqrestore(lock, flags)
 | |
| #endif
 | |
| 
 | |
| static inline int __raw_spin_trylock(raw_spinlock_t *lock)
 | |
| {
 | |
| 	preempt_disable();
 | |
| 	if (do_raw_spin_trylock(lock)) {
 | |
| 		spin_acquire(&lock->dep_map, 0, 1, _RET_IP_);
 | |
| 		return 1;
 | |
| 	}
 | |
| 	preempt_enable();
 | |
| 	return 0;
 | |
| }
 | |
| 
 | |
| /*
 | |
|  * If lockdep is enabled then we use the non-preemption spin-ops
 | |
|  * even on CONFIG_PREEMPTION, because lockdep assumes that interrupts are
 | |
|  * not re-enabled during lock-acquire (which the preempt-spin-ops do):
 | |
|  */
 | |
| #if !defined(CONFIG_GENERIC_LOCKBREAK) || defined(CONFIG_DEBUG_LOCK_ALLOC)
 | |
| 
 | |
| static inline unsigned long __raw_spin_lock_irqsave(raw_spinlock_t *lock)
 | |
| {
 | |
| 	unsigned long flags;
 | |
| 
 | |
| 	local_irq_save(flags);
 | |
| 	preempt_disable();
 | |
| 	spin_acquire(&lock->dep_map, 0, 0, _RET_IP_);
 | |
| 	LOCK_CONTENDED(lock, do_raw_spin_trylock, do_raw_spin_lock);
 | |
| 	return flags;
 | |
| }
 | |
| 
 | |
| static inline void __raw_spin_lock_irq(raw_spinlock_t *lock)
 | |
| {
 | |
| 	local_irq_disable();
 | |
| 	preempt_disable();
 | |
| 	spin_acquire(&lock->dep_map, 0, 0, _RET_IP_);
 | |
| 	LOCK_CONTENDED(lock, do_raw_spin_trylock, do_raw_spin_lock);
 | |
| }
 | |
| 
 | |
| static inline void __raw_spin_lock_bh(raw_spinlock_t *lock)
 | |
| {
 | |
| 	__local_bh_disable_ip(_RET_IP_, SOFTIRQ_LOCK_OFFSET);
 | |
| 	spin_acquire(&lock->dep_map, 0, 0, _RET_IP_);
 | |
| 	LOCK_CONTENDED(lock, do_raw_spin_trylock, do_raw_spin_lock);
 | |
| }
 | |
| 
 | |
| static inline void __raw_spin_lock(raw_spinlock_t *lock)
 | |
| {
 | |
| 	preempt_disable();
 | |
| 	spin_acquire(&lock->dep_map, 0, 0, _RET_IP_);
 | |
| 	LOCK_CONTENDED(lock, do_raw_spin_trylock, do_raw_spin_lock);
 | |
| }
 | |
| 
 | |
| #endif /* !CONFIG_GENERIC_LOCKBREAK || CONFIG_DEBUG_LOCK_ALLOC */
 | |
| 
 | |
| static inline void __raw_spin_unlock(raw_spinlock_t *lock)
 | |
| {
 | |
| 	spin_release(&lock->dep_map, _RET_IP_);
 | |
| 	do_raw_spin_unlock(lock);
 | |
| 	preempt_enable();
 | |
| }
 | |
| 
 | |
| static inline void __raw_spin_unlock_irqrestore(raw_spinlock_t *lock,
 | |
| 					    unsigned long flags)
 | |
| {
 | |
| 	spin_release(&lock->dep_map, _RET_IP_);
 | |
| 	do_raw_spin_unlock(lock);
 | |
| 	local_irq_restore(flags);
 | |
| 	preempt_enable();
 | |
| }
 | |
| 
 | |
| static inline void __raw_spin_unlock_irq(raw_spinlock_t *lock)
 | |
| {
 | |
| 	spin_release(&lock->dep_map, _RET_IP_);
 | |
| 	do_raw_spin_unlock(lock);
 | |
| 	local_irq_enable();
 | |
| 	preempt_enable();
 | |
| }
 | |
| 
 | |
| static inline void __raw_spin_unlock_bh(raw_spinlock_t *lock)
 | |
| {
 | |
| 	spin_release(&lock->dep_map, _RET_IP_);
 | |
| 	do_raw_spin_unlock(lock);
 | |
| 	__local_bh_enable_ip(_RET_IP_, SOFTIRQ_LOCK_OFFSET);
 | |
| }
 | |
| 
 | |
| static inline int __raw_spin_trylock_bh(raw_spinlock_t *lock)
 | |
| {
 | |
| 	__local_bh_disable_ip(_RET_IP_, SOFTIRQ_LOCK_OFFSET);
 | |
| 	if (do_raw_spin_trylock(lock)) {
 | |
| 		spin_acquire(&lock->dep_map, 0, 1, _RET_IP_);
 | |
| 		return 1;
 | |
| 	}
 | |
| 	__local_bh_enable_ip(_RET_IP_, SOFTIRQ_LOCK_OFFSET);
 | |
| 	return 0;
 | |
| }
 | |
| 
 | |
| /* PREEMPT_RT has its own rwlock implementation */
 | |
| #ifndef CONFIG_PREEMPT_RT
 | |
| #include <linux/rwlock_api_smp.h>
 | |
| #endif
 | |
| 
 | |
| #endif /* __LINUX_SPINLOCK_API_SMP_H */
 |