Home | History | Annotate | Line # | Download | only in linux
spinlock.h revision 1.8
      1  1.8  riastrad /*	$NetBSD: spinlock.h,v 1.8 2018/08/27 06:17:30 riastradh Exp $	*/
      2  1.2  riastrad 
      3  1.2  riastrad /*-
      4  1.2  riastrad  * Copyright (c) 2013 The NetBSD Foundation, Inc.
      5  1.2  riastrad  * All rights reserved.
      6  1.2  riastrad  *
      7  1.2  riastrad  * This code is derived from software contributed to The NetBSD Foundation
      8  1.2  riastrad  * by Taylor R. Campbell.
      9  1.2  riastrad  *
     10  1.2  riastrad  * Redistribution and use in source and binary forms, with or without
     11  1.2  riastrad  * modification, are permitted provided that the following conditions
     12  1.2  riastrad  * are met:
     13  1.2  riastrad  * 1. Redistributions of source code must retain the above copyright
     14  1.2  riastrad  *    notice, this list of conditions and the following disclaimer.
     15  1.2  riastrad  * 2. Redistributions in binary form must reproduce the above copyright
     16  1.2  riastrad  *    notice, this list of conditions and the following disclaimer in the
     17  1.2  riastrad  *    documentation and/or other materials provided with the distribution.
     18  1.2  riastrad  *
     19  1.2  riastrad  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  1.2  riastrad  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  1.2  riastrad  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  1.2  riastrad  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  1.2  riastrad  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  1.2  riastrad  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  1.2  riastrad  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  1.2  riastrad  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  1.2  riastrad  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  1.2  riastrad  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  1.2  riastrad  * POSSIBILITY OF SUCH DAMAGE.
     30  1.2  riastrad  */
     31  1.2  riastrad 
     32  1.2  riastrad #ifndef _LINUX_SPINLOCK_H_
     33  1.2  riastrad #define _LINUX_SPINLOCK_H_
     34  1.2  riastrad 
     35  1.2  riastrad #include <sys/cdefs.h>
     36  1.2  riastrad #include <sys/mutex.h>
     37  1.2  riastrad 
     38  1.7  riastrad #include <machine/limits.h>
     39  1.8  riastrad #include <linux/irqflags.h>
     40  1.8  riastrad #include <linux/preempt.h>
     41  1.7  riastrad 
     42  1.4  riastrad #define	__acquires(lock)	/* XXX lockdep stuff */
     43  1.4  riastrad #define	__releases(lock)	/* XXX lockdep stuff */
     44  1.4  riastrad 
     45  1.2  riastrad typedef struct spinlock {
     46  1.2  riastrad 	kmutex_t sl_lock;
     47  1.2  riastrad } spinlock_t;
     48  1.2  riastrad 
     49  1.2  riastrad static inline int
     50  1.2  riastrad spin_is_locked(spinlock_t *spinlock)
     51  1.2  riastrad {
     52  1.2  riastrad 	return mutex_owned(&spinlock->sl_lock);
     53  1.2  riastrad }
     54  1.2  riastrad 
     55  1.2  riastrad static inline void
     56  1.2  riastrad spin_lock(spinlock_t *spinlock)
     57  1.2  riastrad {
     58  1.2  riastrad 	mutex_enter(&spinlock->sl_lock);
     59  1.2  riastrad }
     60  1.2  riastrad 
     61  1.2  riastrad static inline void
     62  1.2  riastrad spin_unlock(spinlock_t *spinlock)
     63  1.2  riastrad {
     64  1.2  riastrad 	mutex_exit(&spinlock->sl_lock);
     65  1.2  riastrad }
     66  1.2  riastrad 
     67  1.2  riastrad static inline void
     68  1.2  riastrad spin_lock_irq(spinlock_t *spinlock)
     69  1.2  riastrad {
     70  1.2  riastrad 	spin_lock(spinlock);
     71  1.2  riastrad }
     72  1.2  riastrad 
     73  1.2  riastrad static inline void
     74  1.2  riastrad spin_unlock_irq(spinlock_t *spinlock)
     75  1.2  riastrad {
     76  1.2  riastrad 	spin_unlock(spinlock);
     77  1.2  riastrad }
     78  1.2  riastrad 
     79  1.2  riastrad /* Must be a macro because the second argument is to be assigned.  */
     80  1.2  riastrad #define	spin_lock_irqsave(SPINLOCK, FLAGS)				\
     81  1.2  riastrad 	do {								\
     82  1.2  riastrad 		(FLAGS) = 0;						\
     83  1.2  riastrad 		mutex_enter(&((spinlock_t *)(SPINLOCK))->sl_lock);	\
     84  1.2  riastrad 	} while (0)
     85  1.2  riastrad 
     86  1.2  riastrad static inline void
     87  1.2  riastrad spin_unlock_irqrestore(spinlock_t *spinlock, unsigned long __unused flags)
     88  1.2  riastrad {
     89  1.2  riastrad 	mutex_exit(&spinlock->sl_lock);
     90  1.2  riastrad }
     91  1.2  riastrad 
     92  1.2  riastrad static inline void
     93  1.2  riastrad spin_lock_init(spinlock_t *spinlock)
     94  1.2  riastrad {
     95  1.6       mrg 	/* XXX What's the right IPL?  IPL_DRM...?  */
     96  1.6       mrg 	mutex_init(&spinlock->sl_lock, MUTEX_DEFAULT, IPL_VM);
     97  1.2  riastrad }
     98  1.2  riastrad 
     99  1.2  riastrad /*
    100  1.2  riastrad  * XXX Linux doesn't ever destroy spin locks, it seems.  We'll have to
    101  1.2  riastrad  * kludge it up.
    102  1.2  riastrad  */
    103  1.2  riastrad 
    104  1.2  riastrad static inline void
    105  1.2  riastrad spin_lock_destroy(spinlock_t *spinlock)
    106  1.2  riastrad {
    107  1.2  riastrad 	mutex_destroy(&spinlock->sl_lock);
    108  1.2  riastrad }
    109  1.2  riastrad 
    110  1.2  riastrad /* This is a macro to make the panic message clearer.  */
    111  1.2  riastrad #define	assert_spin_locked(spinlock)	\
    112  1.2  riastrad 	KASSERT(mutex_owned(&(spinlock)->sl_lock))
    113  1.2  riastrad 
    114  1.3  riastrad /*
    115  1.7  riastrad  * Stupid reader/writer spin locks.  No attempt to avoid writer
    116  1.7  riastrad  * starvation.  Must allow recursive readers.  We use mutex and state
    117  1.7  riastrad  * instead of compare-and-swap for expedience and LOCKDEBUG support.
    118  1.3  riastrad  */
    119  1.3  riastrad 
    120  1.7  riastrad typedef struct linux_rwlock {
    121  1.7  riastrad 	kmutex_t	rw_lock;
    122  1.7  riastrad 	unsigned	rw_nreaders;
    123  1.7  riastrad } rwlock_t;
    124  1.7  riastrad 
    125  1.7  riastrad static inline void
    126  1.7  riastrad rwlock_init(rwlock_t *rw)
    127  1.7  riastrad {
    128  1.7  riastrad 
    129  1.7  riastrad 	mutex_init(&rw->rw_lock, MUTEX_DEFAULT, IPL_VM);
    130  1.7  riastrad 	rw->rw_nreaders = 0;
    131  1.7  riastrad }
    132  1.7  riastrad 
    133  1.7  riastrad static inline void
    134  1.7  riastrad rwlock_destroy(rwlock_t *rw)
    135  1.7  riastrad {
    136  1.7  riastrad 
    137  1.7  riastrad 	KASSERTMSG(rw->rw_nreaders == 0,
    138  1.7  riastrad 	    "rwlock still held by %u readers", rw->rw_nreaders);
    139  1.7  riastrad 	mutex_destroy(&rw->rw_lock);
    140  1.7  riastrad }
    141  1.7  riastrad 
    142  1.7  riastrad static inline void
    143  1.7  riastrad write_lock_irq(rwlock_t *rw)
    144  1.7  riastrad {
    145  1.7  riastrad 
    146  1.7  riastrad 	for (;;) {
    147  1.7  riastrad 		mutex_spin_enter(&rw->rw_lock);
    148  1.7  riastrad 		if (rw->rw_nreaders == 0)
    149  1.7  riastrad 			break;
    150  1.7  riastrad 		mutex_spin_exit(&rw->rw_lock);
    151  1.7  riastrad 	}
    152  1.7  riastrad }
    153  1.7  riastrad 
    154  1.7  riastrad static inline void
    155  1.7  riastrad write_unlock_irq(rwlock_t *rw)
    156  1.7  riastrad {
    157  1.7  riastrad 
    158  1.7  riastrad 	KASSERT(rw->rw_nreaders == 0);
    159  1.7  riastrad 	mutex_spin_exit(&rw->rw_lock);
    160  1.7  riastrad }
    161  1.7  riastrad 
    162  1.7  riastrad static inline void
    163  1.7  riastrad read_lock(rwlock_t *rw)
    164  1.7  riastrad {
    165  1.7  riastrad 
    166  1.7  riastrad 	mutex_spin_enter(&rw->rw_lock);
    167  1.7  riastrad 	KASSERT(rw->rw_nreaders < UINT_MAX);
    168  1.7  riastrad 	rw->rw_nreaders++;
    169  1.7  riastrad 	mutex_spin_exit(&rw->rw_lock);
    170  1.7  riastrad }
    171  1.7  riastrad 
    172  1.7  riastrad static inline void
    173  1.7  riastrad read_unlock(rwlock_t *rw)
    174  1.7  riastrad {
    175  1.7  riastrad 
    176  1.7  riastrad 	mutex_spin_enter(&rw->rw_lock);
    177  1.7  riastrad 	KASSERT(0 < rw->rw_nreaders);
    178  1.7  riastrad 	rw->rw_nreaders--;
    179  1.7  riastrad 	mutex_spin_exit(&rw->rw_lock);
    180  1.7  riastrad }
    181  1.3  riastrad 
    182  1.2  riastrad #endif  /* _LINUX_SPINLOCK_H_ */
    183