1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
24  */
25 
26 #ifndef	_MDB_FINDSTACK_H
27 #define	_MDB_FINDSTACK_H
28 
29 #include <mdb/mdb_modapi.h>
30 #include <sys/param.h>
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 typedef struct findstack_info {
37 	uintptr_t	*fsi_stack;	/* place to record frames */
38 	uintptr_t	fsi_sp;		/* stack pointer */
39 	uintptr_t	fsi_pc;		/* pc */
40 	uintptr_t	fsi_sobj_ops;	/* sobj_ops */
41 	uint_t		fsi_tstate;	/* t_state */
42 	uchar_t		fsi_depth;	/* stack depth */
43 	uchar_t		fsi_failed;	/* search failed */
44 	uchar_t		fsi_overflow;	/* stack was deeper than max_depth */
45 	uchar_t		fsi_panic;	/* thread called panic() */
46 	uchar_t		fsi_max_depth;	/* stack frames available */
47 } findstack_info_t;
48 
49 #define	FSI_FAIL_BADTHREAD	1
50 #define	FSI_FAIL_NOTINMEMORY	2
51 #define	FSI_FAIL_THREADCORRUPT	3
52 #define	FSI_FAIL_STACKNOTFOUND	4
53 
54 typedef struct stacks_module {
55 	char		sm_name[MAXPATHLEN]; /* name of module */
56 	uintptr_t	sm_text;	/* base address of text in module */
57 	size_t		sm_size;	/* size of text in module */
58 } stacks_module_t;
59 
60 extern int findstack(uintptr_t, uint_t, int, const mdb_arg_t *);
61 extern int findstack_debug(uintptr_t, uint_t, int, const mdb_arg_t *);
62 
63 /*
64  * The following routines are implemented in findstack.c, shared across both
65  * genunix and libc.
66  */
67 extern int stacks(uintptr_t, uint_t, int, const mdb_arg_t *);
68 extern void stacks_cleanup(int);
69 
70 /*
71  * The following routines are specific to their context (kernel vs. user-land)
72  * and are therefore implemented in findstack_subr.c (of which each of genunix
73  * and libc have their own copy).
74  */
75 extern void stacks_help(void);
76 extern int stacks_findstack(uintptr_t, findstack_info_t *, uint_t);
77 extern void stacks_findstack_cleanup();
78 extern int stacks_module(stacks_module_t *);
79 
80 extern int findstack_debug_on;
81 
82 #define	fs_dprintf(x)					\
83 	if (findstack_debug_on) {			\
84 		mdb_printf("findstack debug: ");	\
85 		/*CSTYLED*/				\
86 		mdb_printf x ;				\
87 	}
88 
89 #ifdef	__cplusplus
90 }
91 #endif
92 
93 #endif	/* _MDB_FINDSTACK_H */
94