Initial revision
[kopensolaris-gnu/glibc.git] / setjmp / setjmp.h
1 /* Copyright (C) 1991 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 modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 1, or (at your option)
7 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
12 GNU General Public License for more details.
13
14 You should have received a copy of the GNU General Public License
15 along with the GNU C Library; see the file COPYING.  If not, write to
16 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
17
18 /*
19  *      ANSI Standard: 4.6 NON-LOCAL JUMPS <setjmp.h>
20  */
21
22 #ifndef _SETJMP_H
23
24 #define _SETJMP_H       1
25 #include <features.h>
26
27 /* Get the machine-dependent definition of `__jmp_buf'.  */
28 #include <jmp_buf.h>
29
30 #ifndef __NORETURN
31 #ifdef  __GNUC__
32 /* The `volatile' keyword tells GCC that a function never returns.  */
33 #define __NORETURN      __volatile
34 #else   /* Not GCC.  */
35 #define __NORETURN
36 #endif  /* GCC.  */
37 #endif  /* __NORETURN not defined.  */
38
39 /* Jump to the environment saved in ENV, making the
40    setjmp call there return VAL, or 1 if VAL is 0.  */
41 extern __NORETURN void EXFUN(__longjmp, (CONST __jmp_buf __env, int __val));
42 extern __NORETURN void EXFUN(longjmp, (CONST __jmp_buf __env, int __val));
43
44 #ifdef  __OPTIMIZE__
45 #define longjmp(env, val)       __longjmp((env), (val))
46 #endif  /* Optimizing.  */
47
48 /* Set ENV to the current position and return 0.  */
49 extern int EXFUN(__setjmp, (__jmp_buf __env));
50 /* The ANSI standard says `setjmp' is a macro.  */
51 #define setjmp(env)     __setjmp(env)
52
53
54 #ifdef  __USE_POSIX
55 #define __need_sigset_t
56 #include <signal.h>
57
58 /* Calling environment, plus possibly a saved signal mask.  */
59 typedef struct
60   {
61     __jmp_buf __jmpbuf;         /* Calling environment.  */
62     sigset_t __sigmask;         /* Saved signal mask.  */
63     unsigned int __savemask:1;  /* Saved the signal mask?  */
64   } sigjmp_buf[1];
65
66 /* Store the calling environment in ENV, also saving the
67    signal mask if SAVEMASK is nonzero.  Return 0.  */
68 extern int EXFUN(sigsetjmp, (sigjmp_buf __env, int __savemask));
69
70 /* Jump to the environment saved in ENV, making the
71    sigsetjmp call there return VAL, or 1 if VAL is 0.
72    Restore the signal mask if that sigsetjmp call saved it.  */
73 extern __NORETURN void EXFUN(siglongjmp, (CONST sigjmp_buf __env, int __val));
74 #endif  /* Use POSIX.  */
75
76
77 #ifdef  __USE_BSD
78 extern __NORETURN void EXFUN(_longjmp, (CONST __jmp_buf __env, int __val));
79 extern int EXFUN(_setjmp, (__jmp_buf __env));
80
81 #ifdef  __OPTIMIZE__
82 #define _longjmp(env, val)      longjmp((env), (val))
83 #define _setjmp(env)            __setjmp(env)
84 #endif  /* Optimizing.  */
85 #endif  /* Use BSD.  */
86
87 #ifdef  __FAVOR_BSD
88
89 /* BSD defines `setjmp' and `longjmp' to save and restore the set of
90    blocked signals.  For this, `jmp_buf' must be what POSIX calls
91    `sigjmp_buf', which includes that information.  */
92 typedef sigjmp_buf jmp_buf;
93
94 #undef  setjmp
95 #define setjmp(env)             sigsetjmp((env), 1)
96
97 #undef  longjmp
98 #define longjmp(env, val)       siglongjmp((env), (val))
99
100 #else   /* Don't favor BSD.  */
101
102 /* A `jmp_buf' really is a `jmp_buf'.  Oh boy.  */
103 typedef __jmp_buf jmp_buf;
104
105 #endif  /* Favor BSD.  */
106
107 #endif  /* setjmp.h  */