2 * Provides a fast serialization facility that will serialize across blocking
3 * conditions. This facility is very similar to a lock but much faster for
4 * the common case. It utilizes the atomic_intr_*() functions to acquire
5 * and release the serializer and token functions to block.
7 * This API is designed to be used whenever low level serialization is
8 * required. Unlike tokens this serialization is not safe from deadlocks
9 * nor is it recursive, and care must be taken when using it.
12 #ifndef _SYS_SERIALIZE_H_
13 #define _SYS_SERIALIZE_H_
15 #include <machine/stdint.h>
19 struct lwkt_serialize {
20 __atomic_intr_t interlock;
21 struct thread *last_td;
24 #define LWKT_SERIALIZE_INITIALIZER { 0, NULL }
28 * Note that last_td is only maintained when INVARIANTS is turned on,
29 * so this check is only useful as part of a [K]KASSERT.
31 #define IS_SERIALIZED(ss) ((ss)->last_td == curthread)
34 #define ASSERT_SERIALIZED(ss) KKASSERT(IS_SERIALIZED((ss)))
35 #define ASSERT_NOT_SERIALIZED(ss) KKASSERT(!IS_SERIALIZED((ss)))
37 typedef struct lwkt_serialize *lwkt_serialize_t;
39 void lwkt_serialize_init(lwkt_serialize_t);
40 void lwkt_serialize_enter(lwkt_serialize_t);
42 void lwkt_serialize_adaptive_enter(lwkt_serialize_t);
44 int lwkt_serialize_try(lwkt_serialize_t);
45 void lwkt_serialize_exit(lwkt_serialize_t);
46 void lwkt_serialize_handler_disable(lwkt_serialize_t);
47 void lwkt_serialize_handler_enable(lwkt_serialize_t);
48 void lwkt_serialize_handler_call(lwkt_serialize_t, void (*)(void *, void *), void *, void *);
49 int lwkt_serialize_handler_try(lwkt_serialize_t, void (*)(void *, void *), void *, void *);
51 #endif /* !_SYS_SERIALIZE_H_ */