xref: /illumos-gate/usr/src/head/ucontext.h (revision 069e6b7e31ba5dcbc5441b98af272714d9a5455c)
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 /*	Copyright (c) 1988 AT&T	*/
22 /*	  All Rights Reserved	*/
23 
24 
25 /*
26  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
27  *
28  * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
29  * Use is subject to license terms.
30  */
31 
32 #ifndef _UCONTEXT_H
33 #define	_UCONTEXT_H
34 
35 #include <sys/ucontext.h>
36 /*
37  * The file sys/regset.h defines indices in the gregset_t array,
38  * such as EIP on i386.  Those defines were historically exposed
39  * via sys/ucontext.h, sys/signal.h, etc. which caused surprises
40  * due to those defines unexpectedly polluting the namespace.
41  * On the other hand, several existing applications assume that
42  * the regset names are defined after an include <ucontext.h>.
43  * To solve both problems at once: <ucontext.h> (this file)
44  * DOES include sys/regset.h for you but <sys/ucontext.h>
45  * does NOT include sys/regset.h anymore.
46  */
47 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
48 #include <sys/regset.h>
49 #include <sys/siginfo.h>
50 #endif
51 
52 #ifdef	__cplusplus
53 extern "C" {
54 #endif
55 
56 #ifdef __sparc
57 #ifdef __PRAGMA_REDEFINE_EXTNAME
58 #pragma	redefine_extname	makecontext	__makecontext_v2
59 #else
60 #define	makecontext	__makecontext_v2
61 #endif
62 #endif
63 
64 extern int getcontext(ucontext_t *) __RETURNS_TWICE;
65 #pragma unknown_control_flow(getcontext)
66 extern int setcontext(const ucontext_t *) __NORETURN;
67 extern int swapcontext(ucontext_t *_RESTRICT_KYWD,
68 		const ucontext_t *_RESTRICT_KYWD);
69 extern void makecontext(ucontext_t *, void(*)(), int, ...);
70 
71 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
72 extern int walkcontext(const ucontext_t *, int (*)(uintptr_t, int, void *),
73     void *);
74 extern int printstack(int);
75 extern int addrtosymstr(void *, char *, int);
76 extern int getustack(stack_t **);
77 extern int setustack(stack_t *);
78 
79 extern int stack_getbounds(stack_t *);
80 extern int stack_setbounds(const stack_t *);
81 extern int stack_inbounds(void *);
82 extern int stack_violation(int, const siginfo_t *, const ucontext_t *);
83 
84 extern void *_stack_grow(void *);
85 #endif	/* !_XPG4_2 || __EXTENSIONS__ */
86 
87 #ifdef	__cplusplus
88 }
89 #endif
90 
91 #endif	/* _UCONTEXT_H */
92