1 /* Copyright (C) 1991-2022 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 Lesser General Public 6 License as published by the Free Software Foundation; either 7 version 2.1 of the 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 Lesser General Public License for more details. 13 14 You should have received a copy of the GNU Lesser General Public 15 License along with the GNU C Library; if not, see 16 <https://www.gnu.org/licenses/>. */ 17 18 /* 19 * ISO C99 Standard: 7.13 Nonlocal jumps <setjmp.h> 20 */ 21 22 #ifndef _SETJMP_H 23 #define _SETJMP_H 1 24 25 #include <features.h> 26 27 __BEGIN_DECLS 28 29 #include <bits/setjmp.h> /* Get `__jmp_buf'. */ 30 #include <bits/types/struct___jmp_buf_tag.h> 31 32 typedef struct __jmp_buf_tag jmp_buf[1]; 33 34 /* Store the calling environment in ENV, also saving the signal mask. 35 Return 0. */ 36 extern int setjmp (jmp_buf __env) __THROWNL; 37 38 /* Store the calling environment in ENV, also saving the 39 signal mask if SAVEMASK is nonzero. Return 0. 40 This is the internal name for `sigsetjmp'. */ 41 extern int __sigsetjmp (struct __jmp_buf_tag __env[1], int __savemask) __THROWNL; 42 43 /* Store the calling environment in ENV, not saving the signal mask. 44 Return 0. */ 45 extern int _setjmp (struct __jmp_buf_tag __env[1]) __THROWNL; 46 47 /* Do not save the signal mask. This is equivalent to the `_setjmp' 48 BSD function. */ 49 #define setjmp(env) _setjmp (env) 50 51 52 /* Jump to the environment saved in ENV, making the 53 `setjmp' call there return VAL, or 1 if VAL is 0. */ 54 extern void longjmp (struct __jmp_buf_tag __env[1], int __val) 55 __THROWNL __attribute__ ((__noreturn__)); 56 57 #if defined __USE_MISC || defined __USE_XOPEN 58 /* Same. Usually `_longjmp' is used with `_setjmp', which does not save 59 the signal mask. But it is how ENV was saved that determines whether 60 `longjmp' restores the mask; `_longjmp' is just an alias. */ 61 extern void _longjmp (struct __jmp_buf_tag __env[1], int __val) 62 __THROWNL __attribute__ ((__noreturn__)); 63 #endif 64 65 66 #ifdef __USE_POSIX 67 /* Use the same type for `jmp_buf' and `sigjmp_buf'. 68 The `__mask_was_saved' flag determines whether 69 or not `longjmp' will restore the signal mask. */ 70 typedef struct __jmp_buf_tag sigjmp_buf[1]; 71 72 /* Store the calling environment in ENV, also saving the 73 signal mask if SAVEMASK is nonzero. Return 0. */ 74 # define sigsetjmp(env, savemask) __sigsetjmp (env, savemask) 75 76 /* Jump to the environment saved in ENV, making the 77 sigsetjmp call there return VAL, or 1 if VAL is 0. 78 Restore the signal mask if that sigsetjmp call saved it. 79 This is just an alias `longjmp'. */ 80 extern void siglongjmp (sigjmp_buf __env, int __val) 81 __THROWNL __attribute__ ((__noreturn__)); 82 #endif /* Use POSIX. */ 83 84 85 /* Define helper functions to catch unsafe code. */ 86 #if __USE_FORTIFY_LEVEL > 0 87 # include <bits/setjmp2.h> 88 #endif 89 90 __END_DECLS 91 92 #endif /* setjmp.h */ 93