xref: /onnv-gate/usr/src/uts/common/sys/turnstile.h (revision 0:68f95e015346)
1*0Sstevel@tonic-gate /*
2*0Sstevel@tonic-gate  * CDDL HEADER START
3*0Sstevel@tonic-gate  *
4*0Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
5*0Sstevel@tonic-gate  * Common Development and Distribution License, Version 1.0 only
6*0Sstevel@tonic-gate  * (the "License").  You may not use this file except in compliance
7*0Sstevel@tonic-gate  * with the License.
8*0Sstevel@tonic-gate  *
9*0Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*0Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
11*0Sstevel@tonic-gate  * See the License for the specific language governing permissions
12*0Sstevel@tonic-gate  * and limitations under the License.
13*0Sstevel@tonic-gate  *
14*0Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
15*0Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*0Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
17*0Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
18*0Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
19*0Sstevel@tonic-gate  *
20*0Sstevel@tonic-gate  * CDDL HEADER END
21*0Sstevel@tonic-gate  */
22*0Sstevel@tonic-gate /*
23*0Sstevel@tonic-gate  * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
24*0Sstevel@tonic-gate  * Use is subject to license terms.
25*0Sstevel@tonic-gate  */
26*0Sstevel@tonic-gate 
27*0Sstevel@tonic-gate #ifndef _SYS_TURNSTILE_H
28*0Sstevel@tonic-gate #define	_SYS_TURNSTILE_H
29*0Sstevel@tonic-gate 
30*0Sstevel@tonic-gate #pragma ident	"%Z%%M%	%I%	%E% SMI"
31*0Sstevel@tonic-gate 
32*0Sstevel@tonic-gate #include <sys/types.h>
33*0Sstevel@tonic-gate #include <sys/time.h>
34*0Sstevel@tonic-gate #include <sys/param.h>
35*0Sstevel@tonic-gate #include <sys/sleepq.h>
36*0Sstevel@tonic-gate #include <sys/mutex.h>
37*0Sstevel@tonic-gate #include <sys/lwp_timer_impl.h>
38*0Sstevel@tonic-gate 
39*0Sstevel@tonic-gate #ifdef	__cplusplus
40*0Sstevel@tonic-gate extern "C" {
41*0Sstevel@tonic-gate #endif
42*0Sstevel@tonic-gate 
43*0Sstevel@tonic-gate #define	TS_WRITER_Q	0	/* writer sleepq (exclusive access to sobj) */
44*0Sstevel@tonic-gate #define	TS_READER_Q	1	/* reader sleepq (shared access to sobj) */
45*0Sstevel@tonic-gate #define	TS_NUM_Q	2	/* number of sleep queues per turnstile */
46*0Sstevel@tonic-gate 
47*0Sstevel@tonic-gate typedef struct turnstile turnstile_t;
48*0Sstevel@tonic-gate struct _sobj_ops;
49*0Sstevel@tonic-gate 
50*0Sstevel@tonic-gate struct turnstile {
51*0Sstevel@tonic-gate 	turnstile_t	*ts_next;	/* next on hash chain */
52*0Sstevel@tonic-gate 	turnstile_t	*ts_free;	/* next on freelist */
53*0Sstevel@tonic-gate 	void		*ts_sobj;	/* s-object threads are blocking on */
54*0Sstevel@tonic-gate 	int		ts_waiters;	/* number of blocked threads */
55*0Sstevel@tonic-gate 	pri_t		ts_epri;	/* max priority of blocked threads */
56*0Sstevel@tonic-gate 	struct _kthread	*ts_inheritor;	/* thread inheriting priority */
57*0Sstevel@tonic-gate 	turnstile_t	*ts_prioinv;	/* next in inheritor's t_prioinv list */
58*0Sstevel@tonic-gate 	sleepq_t	ts_sleepq[TS_NUM_Q]; /* read/write sleep queues */
59*0Sstevel@tonic-gate };
60*0Sstevel@tonic-gate 
61*0Sstevel@tonic-gate #ifdef	_KERNEL
62*0Sstevel@tonic-gate 
63*0Sstevel@tonic-gate extern turnstile_t *turnstile_lookup(void *);
64*0Sstevel@tonic-gate extern void turnstile_exit(void *);
65*0Sstevel@tonic-gate extern int turnstile_block(turnstile_t *, int, void *, struct _sobj_ops *,
66*0Sstevel@tonic-gate     kmutex_t *, lwp_timer_t *);
67*0Sstevel@tonic-gate extern void turnstile_wakeup(turnstile_t *, int, int, struct _kthread *);
68*0Sstevel@tonic-gate extern void turnstile_change_pri(struct _kthread *, pri_t, pri_t *);
69*0Sstevel@tonic-gate extern void turnstile_unsleep(struct _kthread *);
70*0Sstevel@tonic-gate extern void turnstile_stay_asleep(struct _kthread *);
71*0Sstevel@tonic-gate extern void turnstile_pi_recalc(void);
72*0Sstevel@tonic-gate 
73*0Sstevel@tonic-gate #endif	/* _KERNEL */
74*0Sstevel@tonic-gate 
75*0Sstevel@tonic-gate #ifdef	__cplusplus
76*0Sstevel@tonic-gate }
77*0Sstevel@tonic-gate #endif
78*0Sstevel@tonic-gate 
79*0Sstevel@tonic-gate #endif	/* _SYS_TURNSTILE_H */
80