xref: /freebsd/lib/libthr/thread/thr_umtx.h (revision e220a13ab99559acc56096ccacb22f29c655adfc)
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 
3817ce6063SDavid Xu int _umtx_op_err(void *, int op, u_long, void *, void *) __hidden;
397de1ecefSDavid Xu int __thr_umutex_lock(struct umutex *mtx, uint32_t id) __hidden;
40d1078b0bSDavid Xu int __thr_umutex_lock_spin(struct umutex *mtx, uint32_t id) __hidden;
417de1ecefSDavid Xu int __thr_umutex_timedlock(struct umutex *mtx, uint32_t id,
42cf13ecdaSDavid Xu 	const struct timespec *timeout) __hidden;
437de1ecefSDavid Xu int __thr_umutex_unlock(struct umutex *mtx, uint32_t id) __hidden;
448042f26dSDavid Xu int __thr_umutex_trylock(struct umutex *mtx) __hidden;
45cf13ecdaSDavid Xu int __thr_umutex_set_ceiling(struct umutex *mtx, uint32_t ceiling,
46cf13ecdaSDavid Xu 	uint32_t *oldceiling) __hidden;
47cf13ecdaSDavid Xu 
488042f26dSDavid Xu void _thr_umutex_init(struct umutex *mtx) __hidden;
49ada33a6eSDavid Xu void _thr_urwlock_init(struct urwlock *rwl) __hidden;
50ada33a6eSDavid Xu 
516fdfcacbSDavid Xu int _thr_umtx_wait(volatile long *mtx, long exp,
528429e734SDavid Xu 	const struct timespec *timeout) __hidden;
536fdfcacbSDavid Xu int _thr_umtx_wait_uint(volatile u_int *mtx, u_int exp,
548d6a11a0SDavid Xu 	const struct timespec *timeout, int shared) __hidden;
55d1078b0bSDavid Xu int _thr_umtx_timedwait_uint(volatile u_int *mtx, u_int exp, int clockid,
56d1078b0bSDavid Xu 	const struct timespec *timeout, int shared) __hidden;
578d6a11a0SDavid Xu int _thr_umtx_wake(volatile void *mtx, int count, int shared) __hidden;
582bd2c907SDavid Xu int _thr_ucond_wait(struct ucond *cv, struct umutex *m,
59670b44d6SDavid Xu         const struct timespec *timeout, int check_unpaking) __hidden;
60670b44d6SDavid Xu void _thr_ucond_init(struct ucond *cv) __hidden;
61670b44d6SDavid Xu int _thr_ucond_signal(struct ucond *cv) __hidden;
62670b44d6SDavid Xu int _thr_ucond_broadcast(struct ucond *cv) __hidden;
63cf13ecdaSDavid Xu 
6424c20949SDavid Xu int __thr_rwlock_rdlock(struct urwlock *rwlock, int flags,
6524c20949SDavid Xu 	const struct timespec *tsp) __hidden;
6624c20949SDavid Xu int __thr_rwlock_wrlock(struct urwlock *rwlock,
6724c20949SDavid Xu 	const struct timespec *tsp) __hidden;
688bf1a48cSDavid Xu int __thr_rwlock_unlock(struct urwlock *rwlock) __hidden;
698bf1a48cSDavid Xu 
7002c3c858SDavid Xu /* Internal used only */
7102c3c858SDavid Xu void _thr_rwl_rdlock(struct urwlock *rwlock) __hidden;
7202c3c858SDavid Xu void _thr_rwl_wrlock(struct urwlock *rwlock) __hidden;
7302c3c858SDavid Xu void _thr_rwl_unlock(struct urwlock *rwlock) __hidden;
7402c3c858SDavid Xu 
75cf13ecdaSDavid Xu static inline int
76cf13ecdaSDavid Xu _thr_umutex_trylock(struct umutex *mtx, uint32_t id)
77cf13ecdaSDavid Xu {
78cf13ecdaSDavid Xu     if (atomic_cmpset_acq_32(&mtx->m_owner, UMUTEX_UNOWNED, id))
79cf13ecdaSDavid Xu 	return (0);
80cf13ecdaSDavid Xu     if ((mtx->m_flags & UMUTEX_PRIO_PROTECT) == 0)
81cf13ecdaSDavid Xu     	return (EBUSY);
828042f26dSDavid Xu     return (__thr_umutex_trylock(mtx));
83cf13ecdaSDavid Xu }
84cf13ecdaSDavid Xu 
85cf13ecdaSDavid Xu static inline int
868a8178c0SDavid Xu _thr_umutex_trylock2(struct umutex *mtx, uint32_t id)
878a8178c0SDavid Xu {
887de1ecefSDavid Xu     if (atomic_cmpset_acq_32(&mtx->m_owner, UMUTEX_UNOWNED, id) != 0)
897de1ecefSDavid Xu 	return (0);
907de1ecefSDavid Xu     if ((uint32_t)mtx->m_owner == UMUTEX_CONTESTED &&
917de1ecefSDavid Xu         __predict_true((mtx->m_flags & (UMUTEX_PRIO_PROTECT | UMUTEX_PRIO_INHERIT)) == 0))
927de1ecefSDavid Xu     	if (atomic_cmpset_acq_32(&mtx->m_owner, UMUTEX_CONTESTED, id | UMUTEX_CONTESTED))
938a8178c0SDavid Xu 		return (0);
948a8178c0SDavid Xu     return (EBUSY);
958a8178c0SDavid Xu }
968a8178c0SDavid Xu 
978a8178c0SDavid Xu static inline int
98cf13ecdaSDavid Xu _thr_umutex_lock(struct umutex *mtx, uint32_t id)
99cf13ecdaSDavid Xu {
1007de1ecefSDavid Xu     if (_thr_umutex_trylock2(mtx, id) == 0)
101cf13ecdaSDavid Xu 	return (0);
1027de1ecefSDavid Xu     return (__thr_umutex_lock(mtx, id));
103cf13ecdaSDavid Xu }
104cf13ecdaSDavid Xu 
105cf13ecdaSDavid Xu static inline int
106d1078b0bSDavid Xu _thr_umutex_lock_spin(struct umutex *mtx, uint32_t id)
107d1078b0bSDavid Xu {
108d1078b0bSDavid Xu     if (_thr_umutex_trylock2(mtx, id) == 0)
109d1078b0bSDavid Xu 	return (0);
110d1078b0bSDavid Xu     return (__thr_umutex_lock_spin(mtx, id));
111d1078b0bSDavid Xu }
112d1078b0bSDavid Xu 
113d1078b0bSDavid Xu static inline int
114cf13ecdaSDavid Xu _thr_umutex_timedlock(struct umutex *mtx, uint32_t id,
115cf13ecdaSDavid Xu 	const struct timespec *timeout)
116cf13ecdaSDavid Xu {
1177de1ecefSDavid Xu     if (_thr_umutex_trylock2(mtx, id) == 0)
118cf13ecdaSDavid Xu 	return (0);
1197de1ecefSDavid Xu     return (__thr_umutex_timedlock(mtx, id, timeout));
120cf13ecdaSDavid Xu }
121cf13ecdaSDavid Xu 
122cf13ecdaSDavid Xu static inline int
123*e220a13aSDavid Xu _thr_umutex_unlock2(struct umutex *mtx, uint32_t id, int *defer)
124cf13ecdaSDavid Xu {
12517ce6063SDavid Xu 	uint32_t flags = mtx->m_flags;
12617ce6063SDavid Xu 
12717ce6063SDavid Xu 	if ((flags & (UMUTEX_PRIO_PROTECT | UMUTEX_PRIO_INHERIT)) == 0) {
12817ce6063SDavid Xu 		uint32_t owner;
12917ce6063SDavid Xu 		do {
13017ce6063SDavid Xu 			owner = mtx->m_owner;
13117ce6063SDavid Xu 			if (__predict_false((owner & ~UMUTEX_CONTESTED) != id))
13217ce6063SDavid Xu 				return (EPERM);
13317ce6063SDavid Xu 		} while (__predict_false(!atomic_cmpset_rel_32(&mtx->m_owner,
13417ce6063SDavid Xu 					 owner, UMUTEX_UNOWNED)));
135*e220a13aSDavid Xu 		if ((owner & UMUTEX_CONTESTED)) {
136*e220a13aSDavid Xu 			if (defer == NULL)
13717ce6063SDavid Xu 				(void)_umtx_op_err(mtx, UMTX_OP_MUTEX_WAKE2, flags, 0, 0);
138*e220a13aSDavid Xu 			else
139*e220a13aSDavid Xu 				*defer = 1;
140*e220a13aSDavid Xu 		}
14117ce6063SDavid Xu 		return (0);
14217ce6063SDavid Xu 	}
143cf13ecdaSDavid Xu     	if (atomic_cmpset_rel_32(&mtx->m_owner, id, UMUTEX_UNOWNED))
144cf13ecdaSDavid Xu 		return (0);
1457de1ecefSDavid Xu 	return (__thr_umutex_unlock(mtx, id));
146cf13ecdaSDavid Xu }
147cf13ecdaSDavid Xu 
1488bf1a48cSDavid Xu static inline int
149*e220a13aSDavid Xu _thr_umutex_unlock(struct umutex *mtx, uint32_t id)
150*e220a13aSDavid Xu {
151*e220a13aSDavid Xu 	return _thr_umutex_unlock2(mtx, id, NULL);
152*e220a13aSDavid Xu }
153*e220a13aSDavid Xu 
154*e220a13aSDavid Xu static inline int
1558bf1a48cSDavid Xu _thr_rwlock_tryrdlock(struct urwlock *rwlock, int flags)
1568bf1a48cSDavid Xu {
1578bf1a48cSDavid Xu 	int32_t state;
1588bf1a48cSDavid Xu 	int32_t wrflags;
1598bf1a48cSDavid Xu 
1608bf1a48cSDavid Xu 	if (flags & URWLOCK_PREFER_READER || rwlock->rw_flags & URWLOCK_PREFER_READER)
1618bf1a48cSDavid Xu 		wrflags = URWLOCK_WRITE_OWNER;
1628bf1a48cSDavid Xu 	else
1638bf1a48cSDavid Xu 		wrflags = URWLOCK_WRITE_OWNER | URWLOCK_WRITE_WAITERS;
1648bf1a48cSDavid Xu 	state = rwlock->rw_state;
1658bf1a48cSDavid Xu 	while (!(state & wrflags)) {
1668bf1a48cSDavid Xu 		if (__predict_false(URWLOCK_READER_COUNT(state) == URWLOCK_MAX_READERS))
1678bf1a48cSDavid Xu 			return (EAGAIN);
1688bf1a48cSDavid Xu 		if (atomic_cmpset_acq_32(&rwlock->rw_state, state, state + 1))
1698bf1a48cSDavid Xu 			return (0);
1708bf1a48cSDavid Xu 		state = rwlock->rw_state;
1718bf1a48cSDavid Xu 	}
1728bf1a48cSDavid Xu 
1738bf1a48cSDavid Xu 	return (EBUSY);
1748bf1a48cSDavid Xu }
1758bf1a48cSDavid Xu 
1768bf1a48cSDavid Xu static inline int
1778bf1a48cSDavid Xu _thr_rwlock_trywrlock(struct urwlock *rwlock)
1788bf1a48cSDavid Xu {
1798bf1a48cSDavid Xu 	int32_t state;
1808bf1a48cSDavid Xu 
1818bf1a48cSDavid Xu 	state = rwlock->rw_state;
1828bf1a48cSDavid Xu 	while (!(state & URWLOCK_WRITE_OWNER) && URWLOCK_READER_COUNT(state) == 0) {
1838bf1a48cSDavid Xu 		if (atomic_cmpset_acq_32(&rwlock->rw_state, state, state | URWLOCK_WRITE_OWNER))
1848bf1a48cSDavid Xu 			return (0);
1858bf1a48cSDavid Xu 		state = rwlock->rw_state;
1868bf1a48cSDavid Xu 	}
1878bf1a48cSDavid Xu 
1888bf1a48cSDavid Xu 	return (EBUSY);
1898bf1a48cSDavid Xu }
1908bf1a48cSDavid Xu 
1918bf1a48cSDavid Xu static inline int
1928bf1a48cSDavid Xu _thr_rwlock_rdlock(struct urwlock *rwlock, int flags, struct timespec *tsp)
1938bf1a48cSDavid Xu {
1948bf1a48cSDavid Xu 	if (_thr_rwlock_tryrdlock(rwlock, flags) == 0)
1958bf1a48cSDavid Xu 		return (0);
1968bf1a48cSDavid Xu 	return (__thr_rwlock_rdlock(rwlock, flags, tsp));
1978bf1a48cSDavid Xu }
1988bf1a48cSDavid Xu 
1998bf1a48cSDavid Xu static inline int
2008bf1a48cSDavid Xu _thr_rwlock_wrlock(struct urwlock *rwlock, struct timespec *tsp)
2018bf1a48cSDavid Xu {
2028bf1a48cSDavid Xu 	if (_thr_rwlock_trywrlock(rwlock) == 0)
2038bf1a48cSDavid Xu 		return (0);
2048bf1a48cSDavid Xu 	return (__thr_rwlock_wrlock(rwlock, tsp));
2058bf1a48cSDavid Xu }
2068bf1a48cSDavid Xu 
2078bf1a48cSDavid Xu static inline int
2088bf1a48cSDavid Xu _thr_rwlock_unlock(struct urwlock *rwlock)
2098bf1a48cSDavid Xu {
2108bf1a48cSDavid Xu 	int32_t state;
2118bf1a48cSDavid Xu 
2128bf1a48cSDavid Xu 	state = rwlock->rw_state;
2138bf1a48cSDavid Xu 	if (state & URWLOCK_WRITE_OWNER) {
2148bf1a48cSDavid Xu 		if (atomic_cmpset_rel_32(&rwlock->rw_state, URWLOCK_WRITE_OWNER, 0))
2158bf1a48cSDavid Xu 			return (0);
2168bf1a48cSDavid Xu 	} else {
2178bf1a48cSDavid Xu 		for (;;) {
2188bf1a48cSDavid Xu 			if (__predict_false(URWLOCK_READER_COUNT(state) == 0))
2198bf1a48cSDavid Xu 				return (EPERM);
220b13c5f28SAttilio Rao 			if (!((state & (URWLOCK_WRITE_WAITERS |
221b13c5f28SAttilio Rao 			    URWLOCK_READ_WAITERS)) &&
222b13c5f28SAttilio Rao 			    URWLOCK_READER_COUNT(state) == 1)) {
223b13c5f28SAttilio Rao 				if (atomic_cmpset_rel_32(&rwlock->rw_state,
224b13c5f28SAttilio Rao 				    state, state-1))
2258bf1a48cSDavid Xu 					return (0);
2268bf1a48cSDavid Xu 				state = rwlock->rw_state;
2278bf1a48cSDavid Xu 			} else {
2288bf1a48cSDavid Xu 				break;
2298bf1a48cSDavid Xu 			}
2308bf1a48cSDavid Xu 		}
2318bf1a48cSDavid Xu     	}
2328bf1a48cSDavid Xu     	return (__thr_rwlock_unlock(rwlock));
2338bf1a48cSDavid Xu }
234a091d823SDavid Xu #endif
235