entered into RCS
[kopensolaris-gnu/glibc.git] / setjmp / setjmp.h
1 /* Copyright (C) 1991, 1992, 1993 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB.  If
16 not, write to the, 1992 Free Software Foundation, Inc., 675 Mass Ave,
17 Cambridge, MA 02139, USA.  */
18
19 /*
20  *      ANSI Standard: 4.6 NON-LOCAL JUMPS <setjmp.h>
21  */
22
23 #ifndef _SETJMP_H
24
25 #define _SETJMP_H       1
26 #include <features.h>
27
28 __BEGIN_DECLS
29
30 /* Get the machine-dependent definition of `__jmp_buf'.  */
31 #include <jmp_buf.h>
32
33
34 #ifdef  __USE_POSIX
35 #define __need_sigset_t
36 #include <signal.h>
37
38 /* Calling environment, plus possibly a saved signal mask.  */
39 typedef struct
40   {
41     __jmp_buf __jmpbuf;         /* Calling environment.  */
42     int __mask_was_saved;       /* Saved the signal mask?  */
43     sigset_t __saved_mask;      /* Saved signal mask.  */
44   } sigjmp_buf[1];
45
46 /* Store the calling environment in ENV, also saving the
47    signal mask if SAVEMASK is nonzero.  Return 0.  */
48 extern void __sigjmp_save __P ((sigjmp_buf __env, int __savemask));
49 #ifdef __GNUC__
50 #define sigsetjmp(env, savemask) \
51   ({ __typeof ((*((sigjmp_buf *) 0))[0]) *__e = (env);                        \
52      __sigjmp_save (__e, (savemask));                                         \
53      __setjmp (__e[0].__jmpbuf); })
54 #else
55 /* Not strictly POSIX-compliant, because it evaluates ENV more than once.  */
56 #define sigsetjmp(env, savemask) \
57   (__sigjmp_save ((env), (savemask)), __setjmp ((env)[0].__jmpbuf))
58 #endif
59
60
61 /* Jump to the environment saved in ENV, making the
62    sigsetjmp call there return VAL, or 1 if VAL is 0.
63    Restore the signal mask if that sigsetjmp call saved it.  */
64 extern __NORETURN void siglongjmp __P ((__const sigjmp_buf __env, int __val));
65 #endif /* Use POSIX.  */
66
67
68 #ifdef  __FAVOR_BSD
69
70 /* BSD defines `setjmp' and `longjmp' to save and restore the set of
71    blocked signals.  For this, `jmp_buf' must be what POSIX calls
72    `sigjmp_buf', which includes that information.  */
73 typedef sigjmp_buf jmp_buf;
74
75 #else /* Don't favor BSD.  */
76
77 /* A `jmp_buf' really is a `jmp_buf'.  Oh boy.  */
78 typedef __jmp_buf jmp_buf;
79
80 #endif /* Favor BSD.  */
81
82
83 /* Jump to the environment saved in ENV, making the
84    setjmp call there return VAL, or 1 if VAL is 0.  */
85 extern __NORETURN void __longjmp __P ((__const __jmp_buf __env, int __val));
86 extern __NORETURN void longjmp __P ((__const jmp_buf __env, int __val));
87
88 #ifdef  __OPTIMIZE__
89 #define longjmp(env, val)       __longjmp ((env), (val))
90 #endif /* Optimizing.  */
91
92 /* Set ENV to the current position and return 0.  */
93 extern int __setjmp __P ((__jmp_buf __env));
94 /* The ANSI C standard says `setjmp' is a macro.  */
95 #define setjmp(env)     __setjmp (env)
96
97
98 #ifdef  __USE_BSD
99 extern __NORETURN void _longjmp __P ((__const jmp_buf __env, int __val));
100 #endif /* Use BSD.  */
101
102 #ifdef  __FAVOR_BSD
103
104 /* We are in the mode in which `setjmp' and `longjmp' save and restore
105    the signal mask, and `jmp_buf' is `sigjmp_buf'.  */
106
107 #undef  setjmp
108 #undef  longjmp
109
110 #define setjmp(env)             sigsetjmp ((env), 1)
111
112 #ifdef  __OPTIMIZE__
113 #define longjmp(env, val)       siglongjmp ((env), (val))
114 #endif /* Optimizing.  */
115
116 #define _setjmp(env)            sigsetjmp ((env), 0)
117
118 #else   /* Don't favor BSD.  */
119
120 /* `setjmp' and `_setjmp' are the same.  */
121 #define _setjmp(env)            setjmp (env)
122
123 /* `longjmp' and `_longjmp' are the same.  */
124 #define _longjmp(env, val)      longjmp ((env), (val))
125
126 #endif /* Favor BSD.  */
127
128
129 __END_DECLS
130
131 #endif /* setjmp.h  */