xref: /freebsd/sys/sys/stack.h (revision dd902d01)
18d511e2aSJeff Roberson /*-
2c4e20cadSPedro F. Giffuni  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3c4e20cadSPedro F. Giffuni  *
48d511e2aSJeff Roberson  * Copyright (c) 2005 Antoine Brodin
58d511e2aSJeff Roberson  * All rights reserved.
68d511e2aSJeff Roberson  *
78d511e2aSJeff Roberson  * Redistribution and use in source and binary forms, with or without
88d511e2aSJeff Roberson  * modification, are permitted provided that the following conditions
98d511e2aSJeff Roberson  * are met:
108d511e2aSJeff Roberson  * 1. Redistributions of source code must retain the above copyright
118d511e2aSJeff Roberson  *    notice, this list of conditions and the following disclaimer.
128d511e2aSJeff Roberson  * 2. Redistributions in binary form must reproduce the above copyright
138d511e2aSJeff Roberson  *    notice, this list of conditions and the following disclaimer in the
148d511e2aSJeff Roberson  *    documentation and/or other materials provided with the distribution.
158d511e2aSJeff Roberson  *
168d511e2aSJeff Roberson  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
178d511e2aSJeff Roberson  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
188d511e2aSJeff Roberson  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
198d511e2aSJeff Roberson  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
208d511e2aSJeff Roberson  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
218d511e2aSJeff Roberson  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
228d511e2aSJeff Roberson  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
238d511e2aSJeff Roberson  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
248d511e2aSJeff Roberson  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
258d511e2aSJeff Roberson  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
268d511e2aSJeff Roberson  * SUCH DAMAGE.
278d511e2aSJeff Roberson  *
288d511e2aSJeff Roberson  * $FreeBSD$
298d511e2aSJeff Roberson  */
308d511e2aSJeff Roberson 
318d511e2aSJeff Roberson #ifndef _SYS_STACK_H_
328d511e2aSJeff Roberson #define	_SYS_STACK_H_
338d511e2aSJeff Roberson 
34047dd67eSAttilio Rao #include <sys/_stack.h>
358d511e2aSJeff Roberson 
36dd902d01SGleb Smirnoff #ifdef _SYS_MALLOC_H_
37dd902d01SGleb Smirnoff MALLOC_DECLARE(M_STACK);
38dd902d01SGleb Smirnoff #endif
39dd902d01SGleb Smirnoff 
408d511e2aSJeff Roberson struct sbuf;
418d511e2aSJeff Roberson 
428d511e2aSJeff Roberson /* MI Routines. */
43f38c0c46SMark Johnston struct stack	*stack_create(int);
448d511e2aSJeff Roberson void		 stack_destroy(struct stack *);
458d511e2aSJeff Roberson int		 stack_put(struct stack *, vm_offset_t);
46a2035830SPawel Jakub Dawidek void		 stack_copy(const struct stack *, struct stack *);
478d511e2aSJeff Roberson void		 stack_zero(struct stack *);
48a2035830SPawel Jakub Dawidek void		 stack_print(const struct stack *);
49a2035830SPawel Jakub Dawidek void		 stack_print_ddb(const struct stack *);
50a2035830SPawel Jakub Dawidek void		 stack_print_short(const struct stack *);
51a2035830SPawel Jakub Dawidek void		 stack_print_short_ddb(const struct stack *);
52a2035830SPawel Jakub Dawidek void		 stack_sbuf_print(struct sbuf *, const struct stack *);
53a2035830SPawel Jakub Dawidek void		 stack_sbuf_print_ddb(struct sbuf *, const struct stack *);
54d158fa4aSConrad Meyer int		 stack_sbuf_print_flags(struct sbuf *, const struct stack *,
55d158fa4aSConrad Meyer 		 int);
568d511e2aSJeff Roberson #ifdef KTR
57a2035830SPawel Jakub Dawidek void		 stack_ktr(u_int, const char *, int, const struct stack *,
5854533f66SConrad Meyer 		    u_int);
5954533f66SConrad Meyer #define	CTRSTACK(m, st, depth) do {					\
608d511e2aSJeff Roberson 	if (KTR_COMPILE & (m))						\
6154533f66SConrad Meyer 		stack_ktr((m), __FILE__, __LINE__, st, depth);		\
628d511e2aSJeff Roberson 	} while(0)
638d511e2aSJeff Roberson #else
6454533f66SConrad Meyer #define	CTRSTACK(m, st, depth)
658d511e2aSJeff Roberson #endif
668d511e2aSJeff Roberson 
67610141ceSMark Johnston /* MD Routines. */
683c90d1eaSRobert Watson struct thread;
698d511e2aSJeff Roberson void		 stack_save(struct stack *);
703c90d1eaSRobert Watson void		 stack_save_td(struct stack *, struct thread *);
71610141ceSMark Johnston int		 stack_save_td_running(struct stack *, struct thread *);
728d511e2aSJeff Roberson 
738d511e2aSJeff Roberson #endif
74