xref: /onnv-gate/usr/src/uts/common/io/drm/queue.h (revision 2820:acdcb3b13767)
1*2820Skz151634 /* BEGIN CSTYLED */
2*2820Skz151634 /*-
3*2820Skz151634  * Copyright (c) 1991, 1993
4*2820Skz151634  *	The Regents of the University of California.  All rights reserved.
5*2820Skz151634  *
6*2820Skz151634  * Redistribution and use in source and binary forms, with or without
7*2820Skz151634  * modification, are permitted provided that the following conditions
8*2820Skz151634  * are met:
9*2820Skz151634  * 1. Redistributions of source code must retain the above copyright
10*2820Skz151634  *    notice, this list of conditions and the following disclaimer.
11*2820Skz151634  * 2. Redistributions in binary form must reproduce the above copyright
12*2820Skz151634  *    notice, this list of conditions and the following disclaimer in the
13*2820Skz151634  *    documentation and/or other materials provided with the distribution.
14*2820Skz151634  * 4. Neither the name of the University nor the names of its contributors
15*2820Skz151634  *    may be used to endorse or promote products derived from this software
16*2820Skz151634  *    without specific prior written permission.
17*2820Skz151634  *
18*2820Skz151634  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19*2820Skz151634  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20*2820Skz151634  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21*2820Skz151634  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22*2820Skz151634  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23*2820Skz151634  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24*2820Skz151634  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25*2820Skz151634  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26*2820Skz151634  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27*2820Skz151634  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28*2820Skz151634  * SUCH DAMAGE.
29*2820Skz151634  *
30*2820Skz151634  *	@(#)queue.h	8.5 (Berkeley) 8/20/94
31*2820Skz151634  * $FreeBSD: /repoman/r/ncvs/src/sys/sys/queue.h,v 1.66 2006/05/26 18:17:53 emaste Exp $
32*2820Skz151634  */
33*2820Skz151634 
34*2820Skz151634 #ifndef _SYS_QUEUE_H_
35*2820Skz151634 #define	_SYS_QUEUE_H_
36*2820Skz151634 
37*2820Skz151634 #pragma ident	"%Z%%M%	%I%	%E% SMI"
38*2820Skz151634 
39*2820Skz151634 /*
40*2820Skz151634  * This file defines four types of data structures: singly-linked lists,
41*2820Skz151634  * singly-linked tail queues, lists and tail queues.
42*2820Skz151634  *
43*2820Skz151634  * A singly-linked list is headed by a single forward pointer. The elements
44*2820Skz151634  * are singly linked for minimum space and pointer manipulation overhead at
45*2820Skz151634  * the expense of O(n) removal for arbitrary elements. New elements can be
46*2820Skz151634  * added to the list after an existing element or at the head of the list.
47*2820Skz151634  * Elements being removed from the head of the list should use the explicit
48*2820Skz151634  * macro for this purpose for optimum efficiency. A singly-linked list may
49*2820Skz151634  * only be traversed in the forward direction.  Singly-linked lists are ideal
50*2820Skz151634  * for applications with large datasets and few or no removals or for
51*2820Skz151634  * implementing a LIFO queue.
52*2820Skz151634  *
53*2820Skz151634  * A singly-linked tail queue is headed by a pair of pointers, one to the
54*2820Skz151634  * head of the list and the other to the tail of the list. The elements are
55*2820Skz151634  * singly linked for minimum space and pointer manipulation overhead at the
56*2820Skz151634  * expense of O(n) removal for arbitrary elements. New elements can be added
57*2820Skz151634  * to the list after an existing element, at the head of the list, or at the
58*2820Skz151634  * end of the list. Elements being removed from the head of the tail queue
59*2820Skz151634  * should use the explicit macro for this purpose for optimum efficiency.
60*2820Skz151634  * A singly-linked tail queue may only be traversed in the forward direction.
61*2820Skz151634  * Singly-linked tail queues are ideal for applications with large datasets
62*2820Skz151634  * and few or no removals or for implementing a FIFO queue.
63*2820Skz151634  *
64*2820Skz151634  * A list is headed by a single forward pointer (or an array of forward
65*2820Skz151634  * pointers for a hash table header). The elements are doubly linked
66*2820Skz151634  * so that an arbitrary element can be removed without a need to
67*2820Skz151634  * traverse the list. New elements can be added to the list before
68*2820Skz151634  * or after an existing element or at the head of the list. A list
69*2820Skz151634  * may only be traversed in the forward direction.
70*2820Skz151634  *
71*2820Skz151634  * A tail queue is headed by a pair of pointers, one to the head of the
72*2820Skz151634  * list and the other to the tail of the list. The elements are doubly
73*2820Skz151634  * linked so that an arbitrary element can be removed without a need to
74*2820Skz151634  * traverse the list. New elements can be added to the list before or
75*2820Skz151634  * after an existing element, at the head of the list, or at the end of
76*2820Skz151634  * the list. A tail queue may be traversed in either direction.
77*2820Skz151634  *
78*2820Skz151634  * For details on the use of these macros, see the queue(3) manual page.
79*2820Skz151634  *
80*2820Skz151634  *
81*2820Skz151634  *				SLIST	LIST	STAILQ	TAILQ
82*2820Skz151634  * _HEAD			+	+	+	+
83*2820Skz151634  * _HEAD_INITIALIZER		+	+	+	+
84*2820Skz151634  * _ENTRY			+	+	+	+
85*2820Skz151634  * _INIT			+	+	+	+
86*2820Skz151634  * _EMPTY			+	+	+	+
87*2820Skz151634  * _FIRST			+	+	+	+
88*2820Skz151634  * _NEXT			+	+	+	+
89*2820Skz151634  * _PREV			-	-	-	+
90*2820Skz151634  * _LAST			-	-	+	+
91*2820Skz151634  * _FOREACH			+	+	+	+
92*2820Skz151634  * _FOREACH_SAFE		+	+	+	+
93*2820Skz151634  * _FOREACH_REVERSE		-	-	-	+
94*2820Skz151634  * _FOREACH_REVERSE_SAFE	-	-	-	+
95*2820Skz151634  * _INSERT_HEAD			+	+	+	+
96*2820Skz151634  * _INSERT_BEFORE		-	+	-	+
97*2820Skz151634  * _INSERT_AFTER		+	+	+	+
98*2820Skz151634  * _INSERT_TAIL			-	-	+	+
99*2820Skz151634  * _CONCAT			-	-	+	+
100*2820Skz151634  * _REMOVE_HEAD			+	-	+	-
101*2820Skz151634  * _REMOVE			+	+	+	+
102*2820Skz151634  *
103*2820Skz151634  */
104*2820Skz151634 #ifdef QUEUE_MACRO_DEBUG
105*2820Skz151634 /* Store the last 2 places the queue element or head was altered */
106*2820Skz151634 struct qm_trace {
107*2820Skz151634 	char * lastfile;
108*2820Skz151634 	int lastline;
109*2820Skz151634 	char * prevfile;
110*2820Skz151634 	int prevline;
111*2820Skz151634 };
112*2820Skz151634 
113*2820Skz151634 #define	TRACEBUF	struct qm_trace trace;
114*2820Skz151634 #define	TRASHIT(x)	do {(x) = (void *)-1;} while (*"\0")
115*2820Skz151634 
116*2820Skz151634 #define	QMD_TRACE_HEAD(head) do {					\
117*2820Skz151634 	(head)->trace.prevline = (head)->trace.lastline;		\
118*2820Skz151634 	(head)->trace.prevfile = (head)->trace.lastfile;		\
119*2820Skz151634 	(head)->trace.lastline = __LINE__;				\
120*2820Skz151634 	(head)->trace.lastfile = __FILE__;				\
121*2820Skz151634 } while (*"\0")
122*2820Skz151634 
123*2820Skz151634 #define	QMD_TRACE_ELEM(elem) do {					\
124*2820Skz151634 	(elem)->trace.prevline = (elem)->trace.lastline;		\
125*2820Skz151634 	(elem)->trace.prevfile = (elem)->trace.lastfile;		\
126*2820Skz151634 	(elem)->trace.lastline = __LINE__;				\
127*2820Skz151634 	(elem)->trace.lastfile = __FILE__;				\
128*2820Skz151634 } while (*"\0")
129*2820Skz151634 
130*2820Skz151634 #else
131*2820Skz151634 #define	QMD_TRACE_ELEM(elem)
132*2820Skz151634 #define	QMD_TRACE_HEAD(head)
133*2820Skz151634 #define	TRACEBUF
134*2820Skz151634 #define	TRASHIT(x)
135*2820Skz151634 #endif	/* QUEUE_MACRO_DEBUG */
136*2820Skz151634 
137*2820Skz151634 /*
138*2820Skz151634  * Singly-linked List declarations.
139*2820Skz151634  */
140*2820Skz151634 #define	SLIST_HEAD(name, type)						\
141*2820Skz151634 struct name {								\
142*2820Skz151634 	struct type *slh_first;	/* first element */			\
143*2820Skz151634 }
144*2820Skz151634 
145*2820Skz151634 #define	SLIST_HEAD_INITIALIZER(head)					\
146*2820Skz151634 	{ NULL }
147*2820Skz151634 
148*2820Skz151634 #define	SLIST_ENTRY(type)						\
149*2820Skz151634 struct {								\
150*2820Skz151634 	struct type *sle_next;	/* next element */			\
151*2820Skz151634 }
152*2820Skz151634 
153*2820Skz151634 /*
154*2820Skz151634  * Singly-linked List functions.
155*2820Skz151634  */
156*2820Skz151634 #define	SLIST_EMPTY(head)	((head)->slh_first == NULL)
157*2820Skz151634 
158*2820Skz151634 #define	SLIST_FIRST(head)	((head)->slh_first)
159*2820Skz151634 
160*2820Skz151634 #define	SLIST_FOREACH(var, head, field)					\
161*2820Skz151634 	for ((var) = SLIST_FIRST((head));				\
162*2820Skz151634 	    (var);							\
163*2820Skz151634 	    (var) = SLIST_NEXT((var), field))
164*2820Skz151634 
165*2820Skz151634 #define	SLIST_FOREACH_SAFE(var, head, field, tvar)			\
166*2820Skz151634 	for ((var) = SLIST_FIRST((head));				\
167*2820Skz151634 	    (var) && ((tvar) = SLIST_NEXT((var), field), 1);		\
168*2820Skz151634 	    (var) = (tvar))
169*2820Skz151634 
170*2820Skz151634 #define	SLIST_FOREACH_PREVPTR(var, varp, head, field)			\
171*2820Skz151634 	for ((varp) = &SLIST_FIRST((head));				\
172*2820Skz151634 	    ((var) = *(varp)) != NULL;					\
173*2820Skz151634 	    (varp) = &SLIST_NEXT((var), field))
174*2820Skz151634 
175*2820Skz151634 #define	SLIST_INIT(head) do {						\
176*2820Skz151634 	SLIST_FIRST((head)) = NULL;					\
177*2820Skz151634 } while (*"\0")
178*2820Skz151634 
179*2820Skz151634 #define	SLIST_INSERT_AFTER(slistelm, elm, field) do {			\
180*2820Skz151634 	SLIST_NEXT((elm), field) = SLIST_NEXT((slistelm), field);	\
181*2820Skz151634 	SLIST_NEXT((slistelm), field) = (elm);				\
182*2820Skz151634 } while (*"\0")
183*2820Skz151634 
184*2820Skz151634 #define	SLIST_INSERT_HEAD(head, elm, field) do {			\
185*2820Skz151634 	SLIST_NEXT((elm), field) = SLIST_FIRST((head));			\
186*2820Skz151634 	SLIST_FIRST((head)) = (elm);					\
187*2820Skz151634 } while (*"\0")
188*2820Skz151634 
189*2820Skz151634 #define	SLIST_NEXT(elm, field)	((elm)->field.sle_next)
190*2820Skz151634 
191*2820Skz151634 #define	SLIST_REMOVE(head, elm, type, field) do {			\
192*2820Skz151634 	if (SLIST_FIRST((head)) == (elm)) {				\
193*2820Skz151634 		SLIST_REMOVE_HEAD((head), field);			\
194*2820Skz151634 	}								\
195*2820Skz151634 	else {								\
196*2820Skz151634 		struct type *curelm = SLIST_FIRST((head));		\
197*2820Skz151634 		while (SLIST_NEXT(curelm, field) != (elm))		\
198*2820Skz151634 			curelm = SLIST_NEXT(curelm, field);		\
199*2820Skz151634 		SLIST_NEXT(curelm, field) =				\
200*2820Skz151634 		    SLIST_NEXT(SLIST_NEXT(curelm, field), field);	\
201*2820Skz151634 	}								\
202*2820Skz151634 	TRASHIT((elm)->field.sle_next);					\
203*2820Skz151634 } while (*"\0")
204*2820Skz151634 
205*2820Skz151634 #define	SLIST_REMOVE_HEAD(head, field) do {				\
206*2820Skz151634 	SLIST_FIRST((head)) = SLIST_NEXT(SLIST_FIRST((head)), field);	\
207*2820Skz151634 } while (*"\0")
208*2820Skz151634 
209*2820Skz151634 /*
210*2820Skz151634  * Singly-linked Tail queue declarations.
211*2820Skz151634  */
212*2820Skz151634 #define	STAILQ_HEAD(name, type)						\
213*2820Skz151634 struct name {								\
214*2820Skz151634 	struct type *stqh_first;/* first element */			\
215*2820Skz151634 	struct type **stqh_last;/* addr of last next element */		\
216*2820Skz151634 }
217*2820Skz151634 
218*2820Skz151634 #define	STAILQ_HEAD_INITIALIZER(head)					\
219*2820Skz151634 	{ NULL, &(head).stqh_first }
220*2820Skz151634 
221*2820Skz151634 #define	STAILQ_ENTRY(type)						\
222*2820Skz151634 struct {								\
223*2820Skz151634 	struct type *stqe_next;	/* next element */			\
224*2820Skz151634 }
225*2820Skz151634 
226*2820Skz151634 /*
227*2820Skz151634  * Singly-linked Tail queue functions.
228*2820Skz151634  */
229*2820Skz151634 #define	STAILQ_CONCAT(head1, head2) do {				\
230*2820Skz151634 	if (!STAILQ_EMPTY((head2))) {					\
231*2820Skz151634 		*(head1)->stqh_last = (head2)->stqh_first;		\
232*2820Skz151634 		(head1)->stqh_last = (head2)->stqh_last;		\
233*2820Skz151634 		STAILQ_INIT((head2));					\
234*2820Skz151634 	}								\
235*2820Skz151634 } while (*"\0")
236*2820Skz151634 
237*2820Skz151634 #define	STAILQ_EMPTY(head)	((head)->stqh_first == NULL)
238*2820Skz151634 
239*2820Skz151634 #define	STAILQ_FIRST(head)	((head)->stqh_first)
240*2820Skz151634 
241*2820Skz151634 #define	STAILQ_FOREACH(var, head, field)				\
242*2820Skz151634 	for((var) = STAILQ_FIRST((head));				\
243*2820Skz151634 	   (var);							\
244*2820Skz151634 	   (var) = STAILQ_NEXT((var), field))
245*2820Skz151634 
246*2820Skz151634 
247*2820Skz151634 #define	STAILQ_FOREACH_SAFE(var, head, field, tvar)			\
248*2820Skz151634 	for ((var) = STAILQ_FIRST((head));				\
249*2820Skz151634 	    (var) && ((tvar) = STAILQ_NEXT((var), field), 1);		\
250*2820Skz151634 	    (var) = (tvar))
251*2820Skz151634 
252*2820Skz151634 #define	STAILQ_INIT(head) do {						\
253*2820Skz151634 	STAILQ_FIRST((head)) = NULL;					\
254*2820Skz151634 	(head)->stqh_last = &STAILQ_FIRST((head));			\
255*2820Skz151634 } while (*"\0")
256*2820Skz151634 
257*2820Skz151634 #define	STAILQ_INSERT_AFTER(head, tqelm, elm, field) do {		\
258*2820Skz151634 	if ((STAILQ_NEXT((elm), field) = STAILQ_NEXT((tqelm), field)) == NULL)\
259*2820Skz151634 		(head)->stqh_last = &STAILQ_NEXT((elm), field);		\
260*2820Skz151634 	STAILQ_NEXT((tqelm), field) = (elm);				\
261*2820Skz151634 } while (*"\0")
262*2820Skz151634 
263*2820Skz151634 #define	STAILQ_INSERT_HEAD(head, elm, field) do {			\
264*2820Skz151634 	if ((STAILQ_NEXT((elm), field) = STAILQ_FIRST((head))) == NULL)	\
265*2820Skz151634 		(head)->stqh_last = &STAILQ_NEXT((elm), field);		\
266*2820Skz151634 	STAILQ_FIRST((head)) = (elm);					\
267*2820Skz151634 } while (*"\0")
268*2820Skz151634 
269*2820Skz151634 #define	STAILQ_INSERT_TAIL(head, elm, field) do {			\
270*2820Skz151634 	STAILQ_NEXT((elm), field) = NULL;				\
271*2820Skz151634 	*(head)->stqh_last = (elm);					\
272*2820Skz151634 	(head)->stqh_last = &STAILQ_NEXT((elm), field);			\
273*2820Skz151634 } while (*"\0")
274*2820Skz151634 
275*2820Skz151634 #define	STAILQ_LAST(head, type, field)					\
276*2820Skz151634 	(STAILQ_EMPTY((head)) ?						\
277*2820Skz151634 		NULL :							\
278*2820Skz151634 	        ((struct type *)(void *)				\
279*2820Skz151634 		((char *)((head)->stqh_last) - __offsetof(struct type, field))))
280*2820Skz151634 
281*2820Skz151634 #define	STAILQ_NEXT(elm, field)	((elm)->field.stqe_next)
282*2820Skz151634 
283*2820Skz151634 #define	STAILQ_REMOVE(head, elm, type, field) do {			\
284*2820Skz151634 	if (STAILQ_FIRST((head)) == (elm)) {				\
285*2820Skz151634 		STAILQ_REMOVE_HEAD((head), field);			\
286*2820Skz151634 	}								\
287*2820Skz151634 	else {								\
288*2820Skz151634 		struct type *curelm = STAILQ_FIRST((head));		\
289*2820Skz151634 		while (STAILQ_NEXT(curelm, field) != (elm))		\
290*2820Skz151634 			curelm = STAILQ_NEXT(curelm, field);		\
291*2820Skz151634 		if ((STAILQ_NEXT(curelm, field) =			\
292*2820Skz151634 		     STAILQ_NEXT(STAILQ_NEXT(curelm, field), field)) == NULL)\
293*2820Skz151634 			(head)->stqh_last = &STAILQ_NEXT((curelm), field);\
294*2820Skz151634 	}								\
295*2820Skz151634 	TRASHIT((elm)->field.stqe_next);				\
296*2820Skz151634 } while (*"\0")
297*2820Skz151634 
298*2820Skz151634 #define	STAILQ_REMOVE_HEAD(head, field) do {				\
299*2820Skz151634 	if ((STAILQ_FIRST((head)) =					\
300*2820Skz151634 	     STAILQ_NEXT(STAILQ_FIRST((head)), field)) == NULL)		\
301*2820Skz151634 		(head)->stqh_last = &STAILQ_FIRST((head));		\
302*2820Skz151634 } while (*"\0")
303*2820Skz151634 
304*2820Skz151634 #define	STAILQ_REMOVE_HEAD_UNTIL(head, elm, field) do {			\
305*2820Skz151634 	if ((STAILQ_FIRST((head)) = STAILQ_NEXT((elm), field)) == NULL)	\
306*2820Skz151634 		(head)->stqh_last = &STAILQ_FIRST((head));		\
307*2820Skz151634 } while (*"\0")
308*2820Skz151634 
309*2820Skz151634 /*
310*2820Skz151634  * List declarations.
311*2820Skz151634  */
312*2820Skz151634 #define	LIST_HEAD(name, type)						\
313*2820Skz151634 struct name {								\
314*2820Skz151634 	struct type *lh_first;	/* first element */			\
315*2820Skz151634 }
316*2820Skz151634 
317*2820Skz151634 #define	LIST_HEAD_INITIALIZER(head)					\
318*2820Skz151634 	{ NULL }
319*2820Skz151634 
320*2820Skz151634 #define	LIST_ENTRY(type)						\
321*2820Skz151634 struct {								\
322*2820Skz151634 	struct type *le_next;	/* next element */			\
323*2820Skz151634 	struct type **le_prev;	/* address of previous next element */	\
324*2820Skz151634 }
325*2820Skz151634 
326*2820Skz151634 /*
327*2820Skz151634  * List functions.
328*2820Skz151634  */
329*2820Skz151634 
330*2820Skz151634 #if (defined(_KERNEL) && defined(INVARIANTS))
331*2820Skz151634 #define	QMD_LIST_CHECK_HEAD(head, field) do {				\
332*2820Skz151634 	if (LIST_FIRST((head)) != NULL &&				\
333*2820Skz151634 	    LIST_FIRST((head))->field.le_prev !=			\
334*2820Skz151634 	     &LIST_FIRST((head)))					\
335*2820Skz151634 		panic("Bad list head %p first->prev != head", (head));	\
336*2820Skz151634 } while (*"\0")
337*2820Skz151634 
338*2820Skz151634 #define	QMD_LIST_CHECK_NEXT(elm, field) do {				\
339*2820Skz151634 	if (LIST_NEXT((elm), field) != NULL &&				\
340*2820Skz151634 	    LIST_NEXT((elm), field)->field.le_prev !=			\
341*2820Skz151634 	     &((elm)->field.le_next))					\
342*2820Skz151634 	     	panic("Bad link elm %p next->prev != elm", (elm));	\
343*2820Skz151634 } while (*"\0")
344*2820Skz151634 
345*2820Skz151634 #define	QMD_LIST_CHECK_PREV(elm, field) do {				\
346*2820Skz151634 	if (*(elm)->field.le_prev != (elm))				\
347*2820Skz151634 		panic("Bad link elm %p prev->next != elm", (elm));	\
348*2820Skz151634 } while (*"\0")
349*2820Skz151634 #else
350*2820Skz151634 #define	QMD_LIST_CHECK_HEAD(head, field)
351*2820Skz151634 #define	QMD_LIST_CHECK_NEXT(elm, field)
352*2820Skz151634 #define	QMD_LIST_CHECK_PREV(elm, field)
353*2820Skz151634 #endif /* (_KERNEL && INVARIANTS) */
354*2820Skz151634 
355*2820Skz151634 #define	LIST_EMPTY(head)	((head)->lh_first == NULL)
356*2820Skz151634 
357*2820Skz151634 #define	LIST_FIRST(head)	((head)->lh_first)
358*2820Skz151634 
359*2820Skz151634 #define	LIST_FOREACH(var, head, field)					\
360*2820Skz151634 	for ((var) = LIST_FIRST((head));				\
361*2820Skz151634 	    (var);							\
362*2820Skz151634 	    (var) = LIST_NEXT((var), field))
363*2820Skz151634 
364*2820Skz151634 #define	LIST_FOREACH_SAFE(var, head, field, tvar)			\
365*2820Skz151634 	for ((var) = LIST_FIRST((head));				\
366*2820Skz151634 	    (var) && ((tvar) = LIST_NEXT((var), field), 1);		\
367*2820Skz151634 	    (var) = (tvar))
368*2820Skz151634 
369*2820Skz151634 #define	LIST_INIT(head) do {						\
370*2820Skz151634 	LIST_FIRST((head)) = NULL;					\
371*2820Skz151634 } while (*"\0")
372*2820Skz151634 
373*2820Skz151634 #define	LIST_INSERT_AFTER(listelm, elm, field) do {			\
374*2820Skz151634 	QMD_LIST_CHECK_NEXT(listelm, field);				\
375*2820Skz151634 	if ((LIST_NEXT((elm), field) = LIST_NEXT((listelm), field)) != NULL)\
376*2820Skz151634 		LIST_NEXT((listelm), field)->field.le_prev =		\
377*2820Skz151634 		    &LIST_NEXT((elm), field);				\
378*2820Skz151634 	LIST_NEXT((listelm), field) = (elm);				\
379*2820Skz151634 	(elm)->field.le_prev = &LIST_NEXT((listelm), field);		\
380*2820Skz151634 } while (*"\0")
381*2820Skz151634 
382*2820Skz151634 #define	LIST_INSERT_BEFORE(listelm, elm, field) do {			\
383*2820Skz151634 	QMD_LIST_CHECK_PREV(listelm, field);				\
384*2820Skz151634 	(elm)->field.le_prev = (listelm)->field.le_prev;		\
385*2820Skz151634 	LIST_NEXT((elm), field) = (listelm);				\
386*2820Skz151634 	*(listelm)->field.le_prev = (elm);				\
387*2820Skz151634 	(listelm)->field.le_prev = &LIST_NEXT((elm), field);		\
388*2820Skz151634 } while (*"\0")
389*2820Skz151634 
390*2820Skz151634 #define	LIST_INSERT_HEAD(head, elm, field) do {				\
391*2820Skz151634 	QMD_LIST_CHECK_HEAD((head), field);				\
392*2820Skz151634 	if ((LIST_NEXT((elm), field) = LIST_FIRST((head))) != NULL)	\
393*2820Skz151634 		LIST_FIRST((head))->field.le_prev = &LIST_NEXT((elm), field);\
394*2820Skz151634 	LIST_FIRST((head)) = (elm);					\
395*2820Skz151634 	(elm)->field.le_prev = &LIST_FIRST((head));			\
396*2820Skz151634 } while (*"\0")
397*2820Skz151634 
398*2820Skz151634 #define	LIST_NEXT(elm, field)	((elm)->field.le_next)
399*2820Skz151634 
400*2820Skz151634 #define	LIST_REMOVE(elm, field) do {					\
401*2820Skz151634 	QMD_LIST_CHECK_NEXT(elm, field);				\
402*2820Skz151634 	QMD_LIST_CHECK_PREV(elm, field);				\
403*2820Skz151634 	if (LIST_NEXT((elm), field) != NULL)				\
404*2820Skz151634 		LIST_NEXT((elm), field)->field.le_prev = 		\
405*2820Skz151634 		    (elm)->field.le_prev;				\
406*2820Skz151634 	*(elm)->field.le_prev = LIST_NEXT((elm), field);		\
407*2820Skz151634 	TRASHIT((elm)->field.le_next);					\
408*2820Skz151634 	TRASHIT((elm)->field.le_prev);					\
409*2820Skz151634 } while (*"\0")
410*2820Skz151634 
411*2820Skz151634 /*
412*2820Skz151634  * Tail queue declarations.
413*2820Skz151634  */
414*2820Skz151634 #define	TAILQ_HEAD(name, type)						\
415*2820Skz151634 struct name {								\
416*2820Skz151634 	struct type *tqh_first;	/* first element */			\
417*2820Skz151634 	struct type **tqh_last;	/* addr of last next element */		\
418*2820Skz151634 	TRACEBUF							\
419*2820Skz151634 }
420*2820Skz151634 
421*2820Skz151634 #define	TAILQ_HEAD_INITIALIZER(head)					\
422*2820Skz151634 	{ NULL, &(head).tqh_first }
423*2820Skz151634 
424*2820Skz151634 #define	TAILQ_ENTRY(type)						\
425*2820Skz151634 struct {								\
426*2820Skz151634 	struct type *tqe_next;	/* next element */			\
427*2820Skz151634 	struct type **tqe_prev;	/* address of previous next element */	\
428*2820Skz151634 	TRACEBUF							\
429*2820Skz151634 }
430*2820Skz151634 
431*2820Skz151634 /*
432*2820Skz151634  * Tail queue functions.
433*2820Skz151634  */
434*2820Skz151634 #if (defined(_KERNEL) && defined(INVARIANTS))
435*2820Skz151634 #define	QMD_TAILQ_CHECK_HEAD(head, field) do {				\
436*2820Skz151634 	if (!TAILQ_EMPTY(head) &&					\
437*2820Skz151634 	    TAILQ_FIRST((head))->field.tqe_prev !=			\
438*2820Skz151634 	     &TAILQ_FIRST((head)))					\
439*2820Skz151634 		panic("Bad tailq head %p first->prev != head", (head));	\
440*2820Skz151634 } while (*"\0")
441*2820Skz151634 
442*2820Skz151634 #define	QMD_TAILQ_CHECK_TAIL(head, field) do {				\
443*2820Skz151634 	if (*(head)->tqh_last != NULL)					\
444*2820Skz151634 	    	panic("Bad tailq NEXT(%p->tqh_last) != NULL", (head)); 	\
445*2820Skz151634 } while (*"\0")
446*2820Skz151634 
447*2820Skz151634 #define	QMD_TAILQ_CHECK_NEXT(elm, field) do {				\
448*2820Skz151634 	if (TAILQ_NEXT((elm), field) != NULL &&				\
449*2820Skz151634 	    TAILQ_NEXT((elm), field)->field.tqe_prev !=			\
450*2820Skz151634 	     &((elm)->field.tqe_next))					\
451*2820Skz151634 		panic("Bad link elm %p next->prev != elm", (elm));	\
452*2820Skz151634 } while (*"\0")
453*2820Skz151634 
454*2820Skz151634 #define	QMD_TAILQ_CHECK_PREV(elm, field) do {				\
455*2820Skz151634 	if (*(elm)->field.tqe_prev != (elm))				\
456*2820Skz151634 		panic("Bad link elm %p prev->next != elm", (elm));	\
457*2820Skz151634 } while (*"\0")
458*2820Skz151634 #else
459*2820Skz151634 #define	QMD_TAILQ_CHECK_HEAD(head, field)
460*2820Skz151634 #define	QMD_TAILQ_CHECK_TAIL(head, headname)
461*2820Skz151634 #define	QMD_TAILQ_CHECK_NEXT(elm, field)
462*2820Skz151634 #define	QMD_TAILQ_CHECK_PREV(elm, field)
463*2820Skz151634 #endif /* (_KERNEL && INVARIANTS) */
464*2820Skz151634 
465*2820Skz151634 #define	TAILQ_CONCAT(head1, head2, field) do {				\
466*2820Skz151634 	if (!TAILQ_EMPTY(head2)) {					\
467*2820Skz151634 		*(head1)->tqh_last = (head2)->tqh_first;		\
468*2820Skz151634 		(head2)->tqh_first->field.tqe_prev = (head1)->tqh_last;	\
469*2820Skz151634 		(head1)->tqh_last = (head2)->tqh_last;			\
470*2820Skz151634 		TAILQ_INIT((head2));					\
471*2820Skz151634 		QMD_TRACE_HEAD(head1);					\
472*2820Skz151634 		QMD_TRACE_HEAD(head2);					\
473*2820Skz151634 	}								\
474*2820Skz151634 } while (*"\0")
475*2820Skz151634 
476*2820Skz151634 #define	TAILQ_EMPTY(head)	((head)->tqh_first == NULL)
477*2820Skz151634 
478*2820Skz151634 #define	TAILQ_FIRST(head)	((head)->tqh_first)
479*2820Skz151634 
480*2820Skz151634 #define	TAILQ_FOREACH(var, head, field)					\
481*2820Skz151634 	for ((var) = TAILQ_FIRST((head));				\
482*2820Skz151634 	    (var);							\
483*2820Skz151634 	    (var) = TAILQ_NEXT((var), field))
484*2820Skz151634 
485*2820Skz151634 #define	TAILQ_FOREACH_SAFE(var, head, field, tvar)			\
486*2820Skz151634 	for ((var) = TAILQ_FIRST((head));				\
487*2820Skz151634 	    (var) && ((tvar) = TAILQ_NEXT((var), field), 1);		\
488*2820Skz151634 	    (var) = (tvar))
489*2820Skz151634 
490*2820Skz151634 #define	TAILQ_FOREACH_REVERSE(var, head, headname, field)		\
491*2820Skz151634 	for ((var) = TAILQ_LAST((head), headname);			\
492*2820Skz151634 	    (var);							\
493*2820Skz151634 	    (var) = TAILQ_PREV((var), headname, field))
494*2820Skz151634 
495*2820Skz151634 #define	TAILQ_FOREACH_REVERSE_SAFE(var, head, headname, field, tvar)	\
496*2820Skz151634 	for ((var) = TAILQ_LAST((head), headname);			\
497*2820Skz151634 	    (var) && ((tvar) = TAILQ_PREV((var), headname, field), 1);	\
498*2820Skz151634 	    (var) = (tvar))
499*2820Skz151634 
500*2820Skz151634 #define	TAILQ_INIT(head) do {						\
501*2820Skz151634 	TAILQ_FIRST((head)) = NULL;					\
502*2820Skz151634 	(head)->tqh_last = &TAILQ_FIRST((head));			\
503*2820Skz151634 	QMD_TRACE_HEAD(head);						\
504*2820Skz151634 } while (*"\0")
505*2820Skz151634 
506*2820Skz151634 #define	TAILQ_INSERT_AFTER(head, listelm, elm, field) do {		\
507*2820Skz151634 	QMD_TAILQ_CHECK_NEXT(listelm, field);				\
508*2820Skz151634 	if ((TAILQ_NEXT((elm), field) = TAILQ_NEXT((listelm), field)) != NULL)\
509*2820Skz151634 		TAILQ_NEXT((elm), field)->field.tqe_prev = 		\
510*2820Skz151634 		    &TAILQ_NEXT((elm), field);				\
511*2820Skz151634 	else {								\
512*2820Skz151634 		(head)->tqh_last = &TAILQ_NEXT((elm), field);		\
513*2820Skz151634 		QMD_TRACE_HEAD(head);					\
514*2820Skz151634 	}								\
515*2820Skz151634 	TAILQ_NEXT((listelm), field) = (elm);				\
516*2820Skz151634 	(elm)->field.tqe_prev = &TAILQ_NEXT((listelm), field);		\
517*2820Skz151634 	QMD_TRACE_ELEM(&(elm)->field);					\
518*2820Skz151634 	QMD_TRACE_ELEM(&listelm->field);				\
519*2820Skz151634 } while (*"\0")
520*2820Skz151634 
521*2820Skz151634 #define	TAILQ_INSERT_BEFORE(listelm, elm, field) do {			\
522*2820Skz151634 	QMD_TAILQ_CHECK_PREV(listelm, field);				\
523*2820Skz151634 	(elm)->field.tqe_prev = (listelm)->field.tqe_prev;		\
524*2820Skz151634 	TAILQ_NEXT((elm), field) = (listelm);				\
525*2820Skz151634 	*(listelm)->field.tqe_prev = (elm);				\
526*2820Skz151634 	(listelm)->field.tqe_prev = &TAILQ_NEXT((elm), field);		\
527*2820Skz151634 	QMD_TRACE_ELEM(&(elm)->field);					\
528*2820Skz151634 	QMD_TRACE_ELEM(&listelm->field);				\
529*2820Skz151634 } while (*"\0")
530*2820Skz151634 
531*2820Skz151634 #define	TAILQ_INSERT_HEAD(head, elm, field) do {			\
532*2820Skz151634 	QMD_TAILQ_CHECK_HEAD(head, field);				\
533*2820Skz151634 	if ((TAILQ_NEXT((elm), field) = TAILQ_FIRST((head))) != NULL)	\
534*2820Skz151634 		TAILQ_FIRST((head))->field.tqe_prev =			\
535*2820Skz151634 		    &TAILQ_NEXT((elm), field);				\
536*2820Skz151634 	else								\
537*2820Skz151634 		(head)->tqh_last = &TAILQ_NEXT((elm), field);		\
538*2820Skz151634 	TAILQ_FIRST((head)) = (elm);					\
539*2820Skz151634 	(elm)->field.tqe_prev = &TAILQ_FIRST((head));			\
540*2820Skz151634 	QMD_TRACE_HEAD(head);						\
541*2820Skz151634 	QMD_TRACE_ELEM(&(elm)->field);					\
542*2820Skz151634 } while (*"\0")
543*2820Skz151634 
544*2820Skz151634 #define	TAILQ_INSERT_TAIL(head, elm, field) do {			\
545*2820Skz151634 	QMD_TAILQ_CHECK_TAIL(head, field);				\
546*2820Skz151634 	TAILQ_NEXT((elm), field) = NULL;				\
547*2820Skz151634 	(elm)->field.tqe_prev = (head)->tqh_last;			\
548*2820Skz151634 	*(head)->tqh_last = (elm);					\
549*2820Skz151634 	(head)->tqh_last = &TAILQ_NEXT((elm), field);			\
550*2820Skz151634 	QMD_TRACE_HEAD(head);						\
551*2820Skz151634 	QMD_TRACE_ELEM(&(elm)->field);					\
552*2820Skz151634 } while (*"\0")
553*2820Skz151634 
554*2820Skz151634 #define	TAILQ_LAST(head, headname)					\
555*2820Skz151634 	(*(((struct headname *)((head)->tqh_last))->tqh_last))
556*2820Skz151634 
557*2820Skz151634 #define	TAILQ_NEXT(elm, field) ((elm)->field.tqe_next)
558*2820Skz151634 
559*2820Skz151634 #define	TAILQ_PREV(elm, headname, field)				\
560*2820Skz151634 	(*(((struct headname *)((elm)->field.tqe_prev))->tqh_last))
561*2820Skz151634 
562*2820Skz151634 #define	TAILQ_REMOVE(head, elm, field) do {				\
563*2820Skz151634 	QMD_TAILQ_CHECK_NEXT(elm, field);				\
564*2820Skz151634 	QMD_TAILQ_CHECK_PREV(elm, field);				\
565*2820Skz151634 	if ((TAILQ_NEXT((elm), field)) != NULL)				\
566*2820Skz151634 		TAILQ_NEXT((elm), field)->field.tqe_prev = 		\
567*2820Skz151634 		    (elm)->field.tqe_prev;				\
568*2820Skz151634 	else {								\
569*2820Skz151634 		(head)->tqh_last = (elm)->field.tqe_prev;		\
570*2820Skz151634 		QMD_TRACE_HEAD(head);					\
571*2820Skz151634 	}								\
572*2820Skz151634 	*(elm)->field.tqe_prev = TAILQ_NEXT((elm), field);		\
573*2820Skz151634 	TRASHIT((elm)->field.tqe_next);					\
574*2820Skz151634 	TRASHIT((elm)->field.tqe_prev);					\
575*2820Skz151634 	QMD_TRACE_ELEM(&(elm)->field);					\
576*2820Skz151634 } while (*"\0")
577*2820Skz151634 
578*2820Skz151634 
579*2820Skz151634 #ifdef _KERNEL
580*2820Skz151634 
581*2820Skz151634 #endif /* _KERNEL */
582*2820Skz151634 
583*2820Skz151634 #endif /* !_SYS_QUEUE_H_ */
584*2820Skz151634 
585*2820Skz151634 /* END CSTYLED */
586