xref: /freebsd/lib/libthr/thread/thr_umtx.h (revision d1078b0b03c0c9b2ab54cdc97ee7e61586c64754)
1a091d823SDavid Xu /*-
2a091d823SDavid Xu  * Copyright (c) 2005 David Xu <davidxu@freebsd.org>
3a091d823SDavid Xu  * All rights reserved.
4a091d823SDavid Xu  *
5a091d823SDavid Xu  * Redistribution and use in source and binary forms, with or without
6a091d823SDavid Xu  * modification, are permitted provided that the following conditions
7a091d823SDavid Xu  * are met:
8a091d823SDavid Xu  * 1. Redistributions of source code must retain the above copyright
9a091d823SDavid Xu  *    notice, this list of conditions and the following disclaimer.
10a091d823SDavid Xu  * 2. Redistributions in binary form must reproduce the above copyright
11a091d823SDavid Xu  *    notice, this list of conditions and the following disclaimer in the
12a091d823SDavid Xu  *    documentation and/or other materials provided with the distribution.
13a091d823SDavid Xu  *
14a091d823SDavid Xu  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15a091d823SDavid Xu  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16a091d823SDavid Xu  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17a091d823SDavid Xu  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18a091d823SDavid Xu  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19a091d823SDavid Xu  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20a091d823SDavid Xu  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21a091d823SDavid Xu  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22a091d823SDavid Xu  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23a091d823SDavid Xu  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24a091d823SDavid Xu  * SUCH DAMAGE.
25a091d823SDavid Xu  *
26a091d823SDavid Xu  * $FreeBSD$
27a091d823SDavid Xu  */
28a091d823SDavid Xu 
29a091d823SDavid Xu #ifndef _THR_FBSD_UMTX_H_
30a091d823SDavid Xu #define _THR_FBSD_UMTX_H_
31a091d823SDavid Xu 
32bddd24cdSDavid Xu #include <strings.h>
33a091d823SDavid Xu #include <sys/umtx.h>
34a091d823SDavid Xu 
356fdfcacbSDavid Xu #define DEFAULT_UMUTEX	{0,0,{0,0},{0,0,0,0}}
36ada33a6eSDavid Xu #define DEFAULT_URWLOCK {0,0,0,0,{0,0,0,0}}
37a091d823SDavid Xu 
387de1ecefSDavid Xu int __thr_umutex_lock(struct umutex *mtx, uint32_t id) __hidden;
39*d1078b0bSDavid Xu int __thr_umutex_lock_spin(struct umutex *mtx, uint32_t id) __hidden;
407de1ecefSDavid Xu int __thr_umutex_timedlock(struct umutex *mtx, uint32_t id,
41cf13ecdaSDavid Xu 	const struct timespec *timeout) __hidden;
427de1ecefSDavid Xu int __thr_umutex_unlock(struct umutex *mtx, uint32_t id) __hidden;
438042f26dSDavid Xu int __thr_umutex_trylock(struct umutex *mtx) __hidden;
44cf13ecdaSDavid Xu int __thr_umutex_set_ceiling(struct umutex *mtx, uint32_t ceiling,
45cf13ecdaSDavid Xu 	uint32_t *oldceiling) __hidden;
46cf13ecdaSDavid Xu 
478042f26dSDavid Xu void _thr_umutex_init(struct umutex *mtx) __hidden;
48ada33a6eSDavid Xu void _thr_urwlock_init(struct urwlock *rwl) __hidden;
49ada33a6eSDavid Xu 
506fdfcacbSDavid Xu int _thr_umtx_wait(volatile long *mtx, long exp,
518429e734SDavid Xu 	const struct timespec *timeout) __hidden;
526fdfcacbSDavid Xu int _thr_umtx_wait_uint(volatile u_int *mtx, u_int exp,
538d6a11a0SDavid Xu 	const struct timespec *timeout, int shared) __hidden;
54*d1078b0bSDavid Xu int _thr_umtx_timedwait_uint(volatile u_int *mtx, u_int exp, int clockid,
55*d1078b0bSDavid Xu 	const struct timespec *timeout, int shared) __hidden;
568d6a11a0SDavid Xu int _thr_umtx_wake(volatile void *mtx, int count, int shared) __hidden;
572bd2c907SDavid Xu int _thr_ucond_wait(struct ucond *cv, struct umutex *m,
58670b44d6SDavid Xu         const struct timespec *timeout, int check_unpaking) __hidden;
59670b44d6SDavid Xu void _thr_ucond_init(struct ucond *cv) __hidden;
60670b44d6SDavid Xu int _thr_ucond_signal(struct ucond *cv) __hidden;
61670b44d6SDavid Xu int _thr_ucond_broadcast(struct ucond *cv) __hidden;
62cf13ecdaSDavid Xu 
638bf1a48cSDavid Xu int __thr_rwlock_rdlock(struct urwlock *rwlock, int flags, struct timespec *tsp) __hidden;
648bf1a48cSDavid Xu int __thr_rwlock_wrlock(struct urwlock *rwlock, struct timespec *tsp) __hidden;
658bf1a48cSDavid Xu int __thr_rwlock_unlock(struct urwlock *rwlock) __hidden;
668bf1a48cSDavid Xu 
6702c3c858SDavid Xu /* Internal used only */
6802c3c858SDavid Xu void _thr_rwl_rdlock(struct urwlock *rwlock) __hidden;
6902c3c858SDavid Xu void _thr_rwl_wrlock(struct urwlock *rwlock) __hidden;
7002c3c858SDavid Xu void _thr_rwl_unlock(struct urwlock *rwlock) __hidden;
7102c3c858SDavid Xu 
72cf13ecdaSDavid Xu static inline int
73cf13ecdaSDavid Xu _thr_umutex_trylock(struct umutex *mtx, uint32_t id)
74cf13ecdaSDavid Xu {
75cf13ecdaSDavid Xu     if (atomic_cmpset_acq_32(&mtx->m_owner, UMUTEX_UNOWNED, id))
76cf13ecdaSDavid Xu 	return (0);
77cf13ecdaSDavid Xu     if ((mtx->m_flags & UMUTEX_PRIO_PROTECT) == 0)
78cf13ecdaSDavid Xu     	return (EBUSY);
798042f26dSDavid Xu     return (__thr_umutex_trylock(mtx));
80cf13ecdaSDavid Xu }
81cf13ecdaSDavid Xu 
82cf13ecdaSDavid Xu static inline int
838a8178c0SDavid Xu _thr_umutex_trylock2(struct umutex *mtx, uint32_t id)
848a8178c0SDavid Xu {
857de1ecefSDavid Xu     if (atomic_cmpset_acq_32(&mtx->m_owner, UMUTEX_UNOWNED, id) != 0)
867de1ecefSDavid Xu 	return (0);
877de1ecefSDavid Xu     if ((uint32_t)mtx->m_owner == UMUTEX_CONTESTED &&
887de1ecefSDavid Xu         __predict_true((mtx->m_flags & (UMUTEX_PRIO_PROTECT | UMUTEX_PRIO_INHERIT)) == 0))
897de1ecefSDavid Xu     	if (atomic_cmpset_acq_32(&mtx->m_owner, UMUTEX_CONTESTED, id | UMUTEX_CONTESTED))
908a8178c0SDavid Xu 		return (0);
918a8178c0SDavid Xu     return (EBUSY);
928a8178c0SDavid Xu }
938a8178c0SDavid Xu 
948a8178c0SDavid Xu static inline int
95cf13ecdaSDavid Xu _thr_umutex_lock(struct umutex *mtx, uint32_t id)
96cf13ecdaSDavid Xu {
977de1ecefSDavid Xu     if (_thr_umutex_trylock2(mtx, id) == 0)
98cf13ecdaSDavid Xu 	return (0);
997de1ecefSDavid Xu     return (__thr_umutex_lock(mtx, id));
100cf13ecdaSDavid Xu }
101cf13ecdaSDavid Xu 
102cf13ecdaSDavid Xu static inline int
103*d1078b0bSDavid Xu _thr_umutex_lock_spin(struct umutex *mtx, uint32_t id)
104*d1078b0bSDavid Xu {
105*d1078b0bSDavid Xu     if (_thr_umutex_trylock2(mtx, id) == 0)
106*d1078b0bSDavid Xu 	return (0);
107*d1078b0bSDavid Xu     return (__thr_umutex_lock_spin(mtx, id));
108*d1078b0bSDavid Xu }
109*d1078b0bSDavid Xu 
110*d1078b0bSDavid Xu static inline int
111cf13ecdaSDavid Xu _thr_umutex_timedlock(struct umutex *mtx, uint32_t id,
112cf13ecdaSDavid Xu 	const struct timespec *timeout)
113cf13ecdaSDavid Xu {
1147de1ecefSDavid Xu     if (_thr_umutex_trylock2(mtx, id) == 0)
115cf13ecdaSDavid Xu 	return (0);
1167de1ecefSDavid Xu     return (__thr_umutex_timedlock(mtx, id, timeout));
117cf13ecdaSDavid Xu }
118cf13ecdaSDavid Xu 
119cf13ecdaSDavid Xu static inline int
120cf13ecdaSDavid Xu _thr_umutex_unlock(struct umutex *mtx, uint32_t id)
121cf13ecdaSDavid Xu {
122cf13ecdaSDavid Xu     if (atomic_cmpset_rel_32(&mtx->m_owner, id, UMUTEX_UNOWNED))
123cf13ecdaSDavid Xu 	return (0);
1247de1ecefSDavid Xu     return (__thr_umutex_unlock(mtx, id));
125cf13ecdaSDavid Xu }
126cf13ecdaSDavid Xu 
1278bf1a48cSDavid Xu static inline int
1288bf1a48cSDavid Xu _thr_rwlock_tryrdlock(struct urwlock *rwlock, int flags)
1298bf1a48cSDavid Xu {
1308bf1a48cSDavid Xu 	int32_t state;
1318bf1a48cSDavid Xu 	int32_t wrflags;
1328bf1a48cSDavid Xu 
1338bf1a48cSDavid Xu 	if (flags & URWLOCK_PREFER_READER || rwlock->rw_flags & URWLOCK_PREFER_READER)
1348bf1a48cSDavid Xu 		wrflags = URWLOCK_WRITE_OWNER;
1358bf1a48cSDavid Xu 	else
1368bf1a48cSDavid Xu 		wrflags = URWLOCK_WRITE_OWNER | URWLOCK_WRITE_WAITERS;
1378bf1a48cSDavid Xu 	state = rwlock->rw_state;
1388bf1a48cSDavid Xu 	while (!(state & wrflags)) {
1398bf1a48cSDavid Xu 		if (__predict_false(URWLOCK_READER_COUNT(state) == URWLOCK_MAX_READERS))
1408bf1a48cSDavid Xu 			return (EAGAIN);
1418bf1a48cSDavid Xu 		if (atomic_cmpset_acq_32(&rwlock->rw_state, state, state + 1))
1428bf1a48cSDavid Xu 			return (0);
1438bf1a48cSDavid Xu 		state = rwlock->rw_state;
1448bf1a48cSDavid Xu 	}
1458bf1a48cSDavid Xu 
1468bf1a48cSDavid Xu 	return (EBUSY);
1478bf1a48cSDavid Xu }
1488bf1a48cSDavid Xu 
1498bf1a48cSDavid Xu static inline int
1508bf1a48cSDavid Xu _thr_rwlock_trywrlock(struct urwlock *rwlock)
1518bf1a48cSDavid Xu {
1528bf1a48cSDavid Xu 	int32_t state;
1538bf1a48cSDavid Xu 
1548bf1a48cSDavid Xu 	state = rwlock->rw_state;
1558bf1a48cSDavid Xu 	while (!(state & URWLOCK_WRITE_OWNER) && URWLOCK_READER_COUNT(state) == 0) {
1568bf1a48cSDavid Xu 		if (atomic_cmpset_acq_32(&rwlock->rw_state, state, state | URWLOCK_WRITE_OWNER))
1578bf1a48cSDavid Xu 			return (0);
1588bf1a48cSDavid Xu 		state = rwlock->rw_state;
1598bf1a48cSDavid Xu 	}
1608bf1a48cSDavid Xu 
1618bf1a48cSDavid Xu 	return (EBUSY);
1628bf1a48cSDavid Xu }
1638bf1a48cSDavid Xu 
1648bf1a48cSDavid Xu static inline int
1658bf1a48cSDavid Xu _thr_rwlock_rdlock(struct urwlock *rwlock, int flags, struct timespec *tsp)
1668bf1a48cSDavid Xu {
1678bf1a48cSDavid Xu 	if (_thr_rwlock_tryrdlock(rwlock, flags) == 0)
1688bf1a48cSDavid Xu 		return (0);
1698bf1a48cSDavid Xu 	return (__thr_rwlock_rdlock(rwlock, flags, tsp));
1708bf1a48cSDavid Xu }
1718bf1a48cSDavid Xu 
1728bf1a48cSDavid Xu static inline int
1738bf1a48cSDavid Xu _thr_rwlock_wrlock(struct urwlock *rwlock, struct timespec *tsp)
1748bf1a48cSDavid Xu {
1758bf1a48cSDavid Xu 	if (_thr_rwlock_trywrlock(rwlock) == 0)
1768bf1a48cSDavid Xu 		return (0);
1778bf1a48cSDavid Xu 	return (__thr_rwlock_wrlock(rwlock, tsp));
1788bf1a48cSDavid Xu }
1798bf1a48cSDavid Xu 
1808bf1a48cSDavid Xu static inline int
1818bf1a48cSDavid Xu _thr_rwlock_unlock(struct urwlock *rwlock)
1828bf1a48cSDavid Xu {
1838bf1a48cSDavid Xu 	int32_t state;
1848bf1a48cSDavid Xu 
1858bf1a48cSDavid Xu 	state = rwlock->rw_state;
1868bf1a48cSDavid Xu 	if (state & URWLOCK_WRITE_OWNER) {
1878bf1a48cSDavid Xu 		if (atomic_cmpset_rel_32(&rwlock->rw_state, URWLOCK_WRITE_OWNER, 0))
1888bf1a48cSDavid Xu 			return (0);
1898bf1a48cSDavid Xu 	} else {
1908bf1a48cSDavid Xu 		for (;;) {
1918bf1a48cSDavid Xu 			if (__predict_false(URWLOCK_READER_COUNT(state) == 0))
1928bf1a48cSDavid Xu 				return (EPERM);
193b13c5f28SAttilio Rao 			if (!((state & (URWLOCK_WRITE_WAITERS |
194b13c5f28SAttilio Rao 			    URWLOCK_READ_WAITERS)) &&
195b13c5f28SAttilio Rao 			    URWLOCK_READER_COUNT(state) == 1)) {
196b13c5f28SAttilio Rao 				if (atomic_cmpset_rel_32(&rwlock->rw_state,
197b13c5f28SAttilio Rao 				    state, state-1))
1988bf1a48cSDavid Xu 					return (0);
1998bf1a48cSDavid Xu 				state = rwlock->rw_state;
2008bf1a48cSDavid Xu 			} else {
2018bf1a48cSDavid Xu 				break;
2028bf1a48cSDavid Xu 			}
2038bf1a48cSDavid Xu 		}
2048bf1a48cSDavid Xu     	}
2058bf1a48cSDavid Xu     	return (__thr_rwlock_unlock(rwlock));
2068bf1a48cSDavid Xu }
207a091d823SDavid Xu #endif
208