Home | History | Annotate | Line # | Download | only in include
lock.h revision 1.12 
      1 /*	$NetBSD: lock.h,v 1.12 2003/11/09 21:04:44 pk Exp $ */
      2 
      3 /*-
      4  * Copyright (c) 1998, 1999 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Paul Kranenburg.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *        This product includes software developed by the NetBSD
     21  *        Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 #ifndef _MACHINE_LOCK_H
     40 #define _MACHINE_LOCK_H
     41 
     42 /*
     43  * Machine dependent spin lock operations.
     44  */
     45 
     46 /* XXX So we can expose this to userland. */
     47 #ifdef __lint__
     48 #define __ldstub(__addr)	(__addr)
     49 #else /* !__lint__ */
     50 #define	__ldstub(__addr)						\
     51 ({									\
     52 	int __v;							\
     53 									\
     54 	__asm __volatile("ldstub [%1],%0"				\
     55 	    : "=r" (__v)						\
     56 	    : "r" (__addr)						\
     57 	    : "memory");						\
     58 									\
     59 	__v;								\
     60 })
     61 #endif /* __lint__ */
     62 
     63 static __inline void __cpu_simple_lock_init __P((__cpu_simple_lock_t *))
     64 	__attribute__((__unused__));
     65 static __inline void __cpu_simple_lock __P((__cpu_simple_lock_t *))
     66 	__attribute__((__unused__));
     67 static __inline int __cpu_simple_lock_try __P((__cpu_simple_lock_t *))
     68 	__attribute__((__unused__));
     69 static __inline void __cpu_simple_unlock __P((__cpu_simple_lock_t *))
     70 	__attribute__((__unused__));
     71 
     72 #if __SIMPLELOCK_UNLOCKED != 0
     73 #error __SIMPLELOCK_UNLOCKED must be 0 for this implementation
     74 #endif
     75 
     76 static __inline void
     77 __cpu_simple_lock_init(__cpu_simple_lock_t *alp)
     78 {
     79 
     80 	*alp = __SIMPLELOCK_UNLOCKED;
     81 }
     82 
     83 static __inline void
     84 __cpu_simple_lock(__cpu_simple_lock_t *alp)
     85 {
     86 
     87 	/*
     88 	 * If someone else holds the lock use simple reads until it
     89 	 * is released, then retry the atomic operation. This reduces
     90 	 * memory bus contention because the cache-coherency logic
     91 	 * does not have to broadcast invalidates on the lock while
     92 	 * we spin on it.
     93 	 */
     94 	while (__ldstub(alp) != __SIMPLELOCK_UNLOCKED) {
     95 		while (*alp != __SIMPLELOCK_UNLOCKED)
     96 			/* spin */ ;
     97 	}
     98 }
     99 
    100 static __inline int
    101 __cpu_simple_lock_try(__cpu_simple_lock_t *alp)
    102 {
    103 
    104 	return (__ldstub(alp) == __SIMPLELOCK_UNLOCKED);
    105 }
    106 
    107 static __inline void
    108 __cpu_simple_unlock(__cpu_simple_lock_t *alp)
    109 {
    110 
    111 	/*
    112 	 * Do `*alp = __SIMPLELOCK_UNLOCKED;' with a compiler barrier
    113 	 * to prevent instruction re-ordering around the lock release.
    114 	 */
    115 	__asm __volatile("st %%g0,[%0]" : : "r" (alp) : "memory");
    116 }
    117 
    118 #endif /* _MACHINE_LOCK_H */
    119