Formerly setjmp/setjmp.h.~6~
[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
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 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 /* Get the machine-dependent definition of `__jmp_buf'.  */
29 #include <jmp_buf.h>
30
31 #ifndef __NORETURN
32 #ifdef  __GNUC__
33 /* The `volatile' keyword tells GCC that a function never returns.  */
34 #define __NORETURN      __volatile
35 #else   /* Not GCC.  */
36 #define __NORETURN
37 #endif  /* GCC.  */
38 #endif  /* __NORETURN not defined.  */
39
40 /* Jump to the environment saved in ENV, making the
41    setjmp call there return VAL, or 1 if VAL is 0.  */
42 extern __NORETURN void EXFUN(__longjmp, (CONST __jmp_buf __env, int __val));
43 extern __NORETURN void EXFUN(longjmp, (CONST __jmp_buf __env, int __val));
44
45 #ifdef  __OPTIMIZE__
46 #define longjmp(env, val)       __longjmp((env), (val))
47 #endif  /* Optimizing.  */
48
49 /* Set ENV to the current position and return 0.  */
50 extern int EXFUN(__setjmp, (__jmp_buf __env));
51 /* The ANSI standard says `setjmp' is a macro.  */
52 #define setjmp(env)     __setjmp(env)
53
54
55 #ifdef  __USE_POSIX
56 #define __need_sigset_t
57 #include <signal.h>
58
59 /* Calling environment, plus possibly a saved signal mask.  */
60 typedef struct
61   {
62     __jmp_buf __jmpbuf;         /* Calling environment.  */
63     sigset_t __sigmask;         /* Saved signal mask.  */
64     unsigned int __savemask:1;  /* Saved the signal mask?  */
65   } sigjmp_buf[1];
66
67 /* Store the calling environment in ENV, also saving the
68    signal mask if SAVEMASK is nonzero.  Return 0.  */
69 extern int EXFUN(sigsetjmp, (sigjmp_buf __env, int __savemask));
70
71 /* Jump to the environment saved in ENV, making the
72    sigsetjmp call there return VAL, or 1 if VAL is 0.
73    Restore the signal mask if that sigsetjmp call saved it.  */
74 extern __NORETURN void EXFUN(siglongjmp, (CONST sigjmp_buf __env, int __val));
75 #endif  /* Use POSIX.  */
76
77
78 #ifdef  __USE_BSD
79 extern __NORETURN void EXFUN(_longjmp, (CONST __jmp_buf __env, int __val));
80 extern int EXFUN(_setjmp, (__jmp_buf __env));
81
82 #ifdef  __OPTIMIZE__
83 #define _longjmp(env, val)      longjmp((env), (val))
84 #define _setjmp(env)            __setjmp(env)
85 #endif  /* Optimizing.  */
86 #endif  /* Use BSD.  */
87
88 #ifdef  __FAVOR_BSD
89
90 /* BSD defines `setjmp' and `longjmp' to save and restore the set of
91    blocked signals.  For this, `jmp_buf' must be what POSIX calls
92    `sigjmp_buf', which includes that information.  */
93 typedef sigjmp_buf jmp_buf;
94
95 #undef  setjmp
96 #define setjmp(env)             sigsetjmp((env), 1)
97
98 #undef  longjmp
99 #define longjmp(env, val)       siglongjmp((env), (val))
100
101 #else   /* Don't favor BSD.  */
102
103 /* A `jmp_buf' really is a `jmp_buf'.  Oh boy.  */
104 typedef __jmp_buf jmp_buf;
105
106 #endif  /* Favor BSD.  */
107
108 #endif  /* setjmp.h  */